diff --git a/.codex/hooks.json b/.codex/hooks.json index 9468d875a..8976a14aa 100644 --- a/.codex/hooks.json +++ b/.codex/hooks.json @@ -26,33 +26,21 @@ ] } ], - "PostToolUse": [ - { - "id": "posttooluse-detected-npm-run-lint", - "command": "npm run lint", - "description": "Run lightweight repository validation after edits (Node.js)", - "blocking": false, - "timeout": 120000, - "sdks": [ - "*" - ] - } - ], "PrePush": [ { - "id": "prepush-git-diff-check", - "command": "git diff --check", - "description": "Check tracked changes for whitespace and conflict-marker issues before push", + "id": "prepush-go-vet", + "command": "go vet ./...", + "description": "Run go vet before push", "blocking": true, - "timeout": 30000, + "timeout": 120000, "sdks": [ "*" ] }, { - "id": "prepush-detected-npm-run-prepush-check", - "command": "npm run prepush:check", - "description": "Run detected repository quality gate before push (Node.js)", + "id": "prepush-go-build", + "command": "go build ./...", + "description": "Verify Go build succeeds before push", "blocking": true, "timeout": 300000, "sdks": [ @@ -76,6 +64,6 @@ "meta": { "profile": "balanced", "generatedBy": "bosun setup", - "generatedAt": "2026-03-28T22:29:00.000Z" + "generatedAt": "2026-03-27T06:21:21.749Z" } } diff --git a/.continue/environments.json b/.continue/environments.json deleted file mode 100644 index 9e10eea8c..000000000 --- a/.continue/environments.json +++ /dev/null @@ -1,7 +0,0 @@ -[ - { - "install": "npm install", - "start": "npm start", - "resourceSize": "medium" - } -] diff --git a/.env.example b/.env.example index 258099243..4f1292894 100644 --- a/.env.example +++ b/.env.example @@ -91,8 +91,6 @@ TELEGRAM_MINIAPP_ENABLED=false # BOSUN_UI_BROWSER_OPEN_MODE=manual # Legacy auto-open toggle for UI server (requires BOSUN_UI_BROWSER_OPEN_MODE=auto) # BOSUN_UI_AUTO_OPEN_BROWSER=false -# Daemon startup keeps browser auto-open disabled unless this is explicitly true. -# BOSUN_UI_AUTO_OPEN_ON_DAEMON=false # Show full /?token=... browser URL in logs (default: false; token is hidden) # BOSUN_UI_LOG_TOKENIZED_BROWSER_URL=false # Setup wizard browser auto-open (default: true when mode=auto) @@ -1020,17 +1018,6 @@ COPILOT_CLOUD_DISABLED=true # WORKFLOW_RECOVERY_BACKOFF_MAX_MS=60000 # Random jitter ratio (0.0-0.9) applied to backoff to prevent retry storms. # WORKFLOW_RECOVERY_BACKOFF_JITTER_RATIO=0.2 -# Delay startup workflow recovery actions so the daemon can settle before -# resuming interrupted runs or firing schedule/task-poll recovery. -# WORKFLOW_RECOVERY_STARTUP_GRACE_MS=30000 -# Additional delay inserted between each startup recovery action. -# WORKFLOW_RECOVERY_STARTUP_STEP_DELAY_MS=15000 - -# Bosun MCP policy: by default Bosun-launched agents only receive validated -# library-managed MCP servers, with required auth pulled from environment. -# BOSUN_MCP_REQUIRE_AUTH=true -# BOSUN_MCP_ALLOW_EXTERNAL_SOURCES=false -# BOSUN_MCP_ALLOW_DEFAULT_SERVERS=false # ─── GitHub Issue Reconciler ───────────────────────────────────────────────── # Periodically reconciles open GitHub issues against open/merged PRs. diff --git a/.githooks/pre-commit b/.githooks/pre-commit index bf4d3c585..7ead0d021 100755 --- a/.githooks/pre-commit +++ b/.githooks/pre-commit @@ -22,7 +22,6 @@ cd "$ROOT" echo "[hooks] bosun pre-commit checks" npm run syntax:check npm run prompt:lint -node tools/prepublish-check.mjs MISSING_SUMMARIES="$(node --input-type=module -e "import { scanRepository } from './lib/codebase-audit.mjs'; const scan = scanRepository(process.cwd(), { staged: true, dryRun: true }); const missing = scan.files.filter((file) => !file.hasSummary).map((file) => file.path); if (missing.length > 0) { console.log(missing.join('\\n')); }" 2>/dev/null || true)" if [ -n "$MISSING_SUMMARIES" ]; then diff --git a/.githooks/pre-push b/.githooks/pre-push index d95c31e59..e485e4a8e 100755 --- a/.githooks/pre-push +++ b/.githooks/pre-push @@ -63,12 +63,12 @@ npm run smoke:packed-cli # Format: "source_prefix|test_glob_1|test_glob_2|..." # Globs are matched against tests/*.test.mjs filenames (basename only). ADJACENCY_MAP=( - "workflow/|workflow-*|workflow-task-lifecycle*|workflow-write-file-encoding*|workflow-pipeline-primitives*|manual-flows*|mcp-workflow-adapter*|bosun-native-workflow-nodes*|meeting-workflow*|run-evaluator*|webhook-gateway*|credential-store*|cron-scheduler*" + "workflow/|workflow-*|workflow-task-lifecycle*|workflow-pipeline-primitives*|manual-flows*|mcp-workflow-adapter*|bosun-native-workflow-nodes*|meeting-workflow*|run-evaluator*|webhook-gateway*|credential-store*|cron-scheduler*" "workflow-templates/|workflow-templates*|workflow-new-templates*|workflow-engine*|manual-flows*" "task/|task-*|workflow-task-lifecycle*|kanban-*|ve-orchestrator*|vk-api*|ve-kanban*" "kanban/|kanban-*|task-store*|task-claims*|ve-kanban*|ve-orchestrator*|vk-api*" - "workspace/|workspace-*|shared-state*|worktree-*|worktree-recovery-regression*|sync-engine*" - "infra/|monitor-*|heartbeat-monitor*|daemon-*|restart-*|startup-*|maintenance-*|anomaly-*|preflight*|tracing*|tui-bridge*|windows-hidden-child-processes*|weekly-agent-work-report*|workflow-task-lifecycle*|workflow-engine*" + "workspace/|workspace-*|shared-state*|worktree-*|sync-engine*" + "infra/|monitor-*|daemon-*|restart-*|startup-*|maintenance-*|anomaly-*|preflight*|tracing*|tui-bridge*|weekly-agent-work-report*|workflow-task-lifecycle*|workflow-engine*" "agent/|agent-*|primary-agent*|fleet-*|review-agent*|analyze-agent*|autofix*|streaming-agent*|hook-library*|weekly-agent-work-report*" "bench/|bench-swebench*|benchmark-*|task-*" "config/|config-*|workspace-health*|bosun-skills*|codex-config*" @@ -77,7 +77,7 @@ ADJACENCY_MAP=( "tui/|tui-*|task-*|tui-events*|tui-bridge*|ui-server-tui-events*" "ui/|ui-*|tui-*|stream-timeline*|workflow-canvas-utils*|static-relative*|mui-theme*|tab-swipe*|session-theme*|session-history*|demo-*|fleet-tab*|portal-ui-smoke*" "site/|ui-*|stream-timeline*|static-relative*|demo-*|portal-ui-smoke*" - "server/|ui-server*|setup-web*|bosun-mcp-server*|tunnel-*|ui-realtime*|presence*|portal-ui-smoke*|guardrails*" + "server/|ui-server*|setup-web*|bosun-mcp-server*|tunnel-*|ui-realtime*|presence*|portal-ui-smoke*" "github/|github-*|hook-profiles*" "git/|git-*|branch-*|diff-stats*|conflict-*" "shell/|*-shell*|codex-shell*|gemini-shell*|opencode-shell*|sdk-shell*|continue-detection*" diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md deleted file mode 100644 index f2fd9b595..000000000 --- a/.github/copilot-instructions.md +++ /dev/null @@ -1,106 +0,0 @@ -# Bosun Copilot Instructions - -Bosun is a Node.js ESM control plane for autonomous software engineering. It ships a CLI, setup wizard, long-running monitor, workflow engine, task/workspace orchestration, GitHub/Jira integrations, Telegram and WhatsApp channels, a browser Mini App, an Electron desktop shell, and a static docs/marketing site. The repo is large and multi-surface; most changes should stay inside one module plus its direct tests. - -## Start Here - -- Always read `AGENTS.md` at the repo root first, then the closest module `AGENTS.md` before editing. -- Prefer Node 24 locally to match CI. Docs say Node 18+ works; this repo was validated here with Node `v24.11.1` and npm `11.6.2` on Windows. -- Always run `npm install` before any build or test command. `postinstall.mjs` applies compatibility checks/shims, may install `desktop/` dependencies, and auto-installs `.githooks` when possible. -- Keep the worktree clean before trusting failures. This repo has string/snapshot-style guard tests, so unrelated local edits can make `npm test` fail in ways that do not reflect your change. -- On Windows, prefer PowerShell for npm/node commands. If you must run `.githooks/pre-push` directly in a worktree, use Git for Windows bash instead of WSL bash. - -## Verified Command Order - -Bootstrap: - -- `npm install` - Verified success. Always do this first. - -Fast local validation: - -- `npm run syntax:check` - Verified success in ~2s. This uses `tools/syntax-check.mjs`, rejects browser-served modules with top-level `await`, and validates local import/export bindings for browser `.js` and `.mjs` files under `ui/` and `site/ui/`. -- `npm run prompt:lint` - Verified success in <1s. Run this whenever you touch prompts, hooks, agent instructions, or `.bosun/agents` content. -- `node cli.mjs --help` - Verified success. Use this for a cheap CLI sanity check. - -Build and packaging validation: - -- `node tools/prepublish-check.mjs` or `npm run prepublishOnly` - Verified via `npm run prepublishOnly` in ~26s. This is important: if you add a new published runtime file imported by shipped code, you must also add it to `package.json` `files`, or this check fails. -- `npm run build` - Verified success in <1s. This is a vendor sync/build step, not a TypeScript compile. -- `npm run build:docs` - Verified success in <1s. Run this when changing `_docs/`, docs generation, or the site docs pipeline. - -Tests: - -- `npm test` - Runs Vitest only, and `pretest` already runs `npm run syntax:check` first. In this workspace it took ~185s but failed because the worktree already contained unrelated edits under `infra/monitor.mjs`; do not assume that specific failure is caused by your change. -- `npm run test:node` - Verified success in ~17s. Run this for `*.node.test.mjs`, portal smoke, and Node-runtime behaviors. -- `npm run test:all` - Use this when your change can affect both Vitest suites and Node test suites. -- Focused example that passed here: - `npm test -- tests/config-validation.test.mjs tests/workflow-templates-e2e.test.mjs -- -t "template-bosun-pr-watchdog installs, executes, and returns valid context"` - Took ~170s. Some workflow-template tests print expected stderr when external creds like `GITHUB_PERSONAL_ACCESS_TOKEN` or `EXA_API_KEY` are absent. -- `npm run check:native-call-parity` - Verified success in ~4s. CI runs this separately; do not skip it for voice/native-call changes. -- `npm run audit:ci` - Verified success but expensive here (~16 min). Run it when touching codebase-audit behavior, CLAUDE summaries/manifests, or when CI has `BOSUN_AUDIT_CI=1` enabled. - -Run commands: - -- `npm run site:serve` - Verified success; served the site locally at `http://127.0.0.1:4173`. -- `npm run setup` starts the web setup wizard. `npm start` runs `node cli.mjs --config-dir .bosun --repo-root . --no-update-check` and expects repo-local config/state. - -## CI / Hook Gates To Mirror - -- Main CI is `.github/workflows/ci.yaml` on Node 24. It runs: `npm ci`, `node tools/prepublish-check.mjs`, `npm run prompt:lint`, `npm run smoke:packed-cli`, `npm run build`, optional `npm run audit:ci`, `npm run check:native-call-parity`, then `npm test`. -- Local pre-commit runs `npm run syntax:check` and `npm run prompt:lint`, then warns if staged source files are missing `CLAUDE:SUMMARY` annotations. -- Local pre-push always runs syntax, prepublish check, and packed CLI smoke, then chooses targeted tests or the full suite based on changed files. -- If you add a new module or test file, update `ADJACENCY_MAP` in `.githooks/pre-push` so smart pre-push routing can still find the right tests. -- Site deploy uses Node 20 and resolves the local `site/ui` symlink into a real copy before publishing; remember that GitHub Pages will not follow symlinks. -- Hosted demo fixes often require touching both `ui/` and `site/ui/`. If a site tab imports a helper from `site/ui/tabs/`, make sure the file actually exists there rather than only in `ui/tabs/`. - -## High-Signal Layout - -- `cli.mjs`: main CLI/router and first-run behavior. -- `setup.mjs`: interactive/non-interactive setup, env/config generation, hook scaffolding. -- `infra/`: monitor loop, restart/recovery, runtime services. -- `workflow/`: engine, node registry, migration, workflow APIs. -- `workflow-templates/`: built-in reusable templates and pipeline helpers. -- `task/`: task execution, claims, archiving, CLI. -- `workspace/`: workspaces, worktrees, shared state, context indexing. -- `agent/`: agent pool, prompts, hooks, reports, fleet coordination. -- `shell/`: Codex/Copilot/Claude/OpenCode executor integrations. -- `server/` and `ui/`: Mini App backend/frontend and setup UI. -- `github/`, `kanban/`, `telegram/`, `voice/`: integrations. -- `site/`: public website and generated docs output. -- `tools/`: syntax, docs build, prepublish, vendor sync, hook utilities. -- `tests/`: Vitest and Node suites; `vitest.config.mjs` excludes `*.node.test.mjs` from `npm test`. - -Important config files: - -- `package.json`: scripts, exports, publishable `files` list. -- `.env.example`: required/optional environment variables and security-sensitive defaults. -- `bosun.config.example.json` and `bosun.schema.json`: config shape references. -- `vitest.config.mjs`, `playwright.config.mjs`, `stryker.config.mjs`: test tooling. -- `.github/workflows/*.yml`: CI, publish, Docker, site deploy, mutation testing, PR automation. -- `.github/hooks/bosun.hooks.json`: Copilot hook bridge integration. - -## Change Routing - -- Config/setup changes: run `npm test -- tests/*config*.test.mjs tests/*setup*.test.mjs`. -- Workflow engine/template changes: run `npm test -- tests/workflow-*.test.mjs tests/workflow-templates*.test.mjs`. -- Workspace/shared-state changes: run `npm test -- tests/workspace-*.test.mjs tests/worktree-*.test.mjs tests/shared-state*.test.mjs`. -- Task changes: run `npm test -- tests/task-*.test.mjs tests/*task*.test.mjs`. -- Server/UI/setup changes: run `npm test -- tests/*ui*.test.mjs tests/*setup*.test.mjs` and `npm run test:node` when portal smoke/runtime is involved. -- Infra/monitor/restart changes: run `npm test -- tests/*monitor*.test.mjs tests/*restart*.test.mjs`. - -## Do Not Re-discover This - -- Trust this file first. Only search the repo when these instructions are incomplete, contradicted by the nearest `AGENTS.md`, or proven wrong by a command/result in the current worktree. diff --git a/.github/hooks/bosun.hooks.json b/.github/hooks/bosun.hooks.json index 9cb1365be..c644cd61b 100644 --- a/.github/hooks/bosun.hooks.json +++ b/.github/hooks/bosun.hooks.json @@ -5,7 +5,7 @@ "type": "command", "command": [ "node", - "agent/agent-hook-bridge.mjs", + "C:\\Users\\jON\\Documents\\source\\repos\\virtengine-gh\\bosun\\agent\\agent-hook-bridge.mjs", "--agent", "copilot", "--event", @@ -19,7 +19,7 @@ "type": "command", "command": [ "node", - "agent/agent-hook-bridge.mjs", + "C:\\Users\\jON\\Documents\\source\\repos\\virtengine-gh\\bosun\\agent\\agent-hook-bridge.mjs", "--agent", "copilot", "--event", @@ -34,7 +34,7 @@ "type": "command", "command": [ "node", - "agent/agent-hook-bridge.mjs", + "C:\\Users\\jON\\Documents\\source\\repos\\virtengine-gh\\bosun\\agent\\agent-hook-bridge.mjs", "--agent", "copilot", "--event", @@ -50,7 +50,7 @@ "type": "command", "command": [ "node", - "agent/agent-hook-bridge.mjs", + "C:\\Users\\jON\\Documents\\source\\repos\\virtengine-gh\\bosun\\agent\\agent-hook-bridge.mjs", "--agent", "copilot", "--event", diff --git a/.gitignore b/.gitignore index 83ad90035..d68c17fdc 100644 --- a/.gitignore +++ b/.gitignore @@ -63,13 +63,4 @@ reports/mutation/ .tmp-* .bosun-monitor/backups/* -tmp/* - -node-compile-cache/* -*/*.tmp -*/*.log -*.log -*.tmp -{{*}} -*tmp* -*null* +tmp/* \ No newline at end of file diff --git a/.vscode/launch.json b/.vscode/launch.json index ea5d0a052..91f47fcd3 100644 --- a/.vscode/launch.json +++ b/.vscode/launch.json @@ -16,108 +16,6 @@ "uriFormat": "%s", "action": "openExternally" } - }, - { - "name": "Debug Bosun CLI", - "type": "node", - "request": "launch", - "program": "${workspaceFolder}/cli.mjs", - "cwd": "${workspaceFolder}", - "args": [ - "--config-dir", - "${workspaceFolder}/.bosun", - "--repo-root", - "${workspaceFolder}", - "--no-update-check", - "--no-auto-update" - ], - "env": { - "BOSUN_DIR": "${workspaceFolder}/.bosun", - "REPO_ROOT": "${workspaceFolder}", - "BOSUN_SKIP_UPDATE_CHECK": "1", - "BOSUN_SKIP_AUTO_UPDATE": "1" - }, - "console": "integratedTerminal", - "internalConsoleOptions": "neverOpen", - "smartStep": true, - "autoAttachChildProcesses": true, - "skipFiles": [ - "/**" - ] - }, - { - "name": "Debug Bosun Monitor Direct", - "type": "node", - "request": "launch", - "program": "${workspaceFolder}/infra/monitor.mjs", - "cwd": "${workspaceFolder}", - "env": { - "BOSUN_DIR": "${workspaceFolder}/.bosun", - "REPO_ROOT": "${workspaceFolder}", - "BOSUN_SKIP_UPDATE_CHECK": "1", - "BOSUN_SKIP_AUTO_UPDATE": "1" - }, - "console": "integratedTerminal", - "internalConsoleOptions": "neverOpen", - "smartStep": true, - "skipFiles": [ - "/**" - ] - }, - { - "name": "Debug Bosun Daemon Child (foreground)", - "type": "node", - "request": "launch", - "program": "${workspaceFolder}/cli.mjs", - "cwd": "${workspaceFolder}", - "args": [ - "--daemon-child", - "--config-dir", - "${workspaceFolder}/.bosun", - "--repo-root", - "${workspaceFolder}", - "--no-update-check", - "--no-auto-update" - ], - "env": { - "BOSUN_DAEMON": "1", - "BOSUN_DIR": "${workspaceFolder}/.bosun", - "REPO_ROOT": "${workspaceFolder}", - "BOSUN_SKIP_UPDATE_CHECK": "1", - "BOSUN_SKIP_AUTO_UPDATE": "1", - "BOSUN_UI_AUTO_OPEN_ON_DAEMON": "false" - }, - "console": "integratedTerminal", - "internalConsoleOptions": "neverOpen", - "smartStep": true, - "autoAttachChildProcesses": true, - "skipFiles": [ - "/**" - ] - }, - { - "name": "Attach to Bosun CLI Startup (9229)", - "type": "node", - "request": "attach", - "address": "127.0.0.1", - "port": 9229, - "restart": true, - "preLaunchTask": "Bosun: Start CLI with Inspector (9229)", - "skipFiles": [ - "/**" - ] - }, - { - "name": "Attach to Bosun Monitor Startup (9230)", - "type": "node", - "request": "attach", - "address": "127.0.0.1", - "port": 9230, - "restart": true, - "preLaunchTask": "Bosun: Start Monitor with Inspector (9230)", - "skipFiles": [ - "/**" - ] } ] } diff --git a/.vscode/mcp.json b/.vscode/mcp.json index da39e4ffa..3df453335 100644 --- a/.vscode/mcp.json +++ b/.vscode/mcp.json @@ -1,3 +1,31 @@ { - "mcpServers": {} + "mcpServers": { + "context7": { + "command": "npx", + "args": [ + "-y", + "@upstash/context7-mcp" + ], + "startup_timeout_sec": 120 + }, + "sequential-thinking": { + "command": "npx", + "args": [ + "-y", + "@modelcontextprotocol/server-sequential-thinking" + ], + "startup_timeout_sec": 120 + }, + "playwright": { + "command": "npx", + "args": [ + "-y", + "@playwright/mcp@latest" + ], + "startup_timeout_sec": 120 + }, + "microsoft-docs": { + "url": "https://learn.microsoft.com/api/mcp" + } + } } diff --git a/.vscode/tasks.json b/.vscode/tasks.json index fe5118a6e..df348902e 100644 --- a/.vscode/tasks.json +++ b/.vscode/tasks.json @@ -26,84 +26,6 @@ } } }, - { - "label": "Bosun: Start CLI with Inspector (9229)", - "type": "shell", - "command": "node --inspect-brk=9229 cli.mjs --config-dir .bosun --repo-root . --no-update-check --no-auto-update", - "options": { - "cwd": "${workspaceFolder}" - }, - "isBackground": true, - "presentation": { - "reveal": "always", - "panel": "dedicated", - "clear": true - }, - "problemMatcher": { - "owner": "custom", - "pattern": { - "regexp": ".+" - }, - "background": { - "activeOnStart": true, - "beginsPattern": ".", - "endsPattern": "^Debugger listening on ws://127\\.0\\.0\\.1:9229/" - } - } - }, - { - "label": "Bosun: Start Monitor with Inspector (9230)", - "type": "shell", - "command": "node --inspect-brk=9230 infra/monitor.mjs", - "options": { - "cwd": "${workspaceFolder}" - }, - "isBackground": true, - "presentation": { - "reveal": "always", - "panel": "dedicated", - "clear": true - }, - "problemMatcher": { - "owner": "custom", - "pattern": { - "regexp": ".+" - }, - "background": { - "activeOnStart": true, - "beginsPattern": ".", - "endsPattern": "^Debugger listening on ws://127\\.0\\.0\\.1:9230/" - } - } - }, - { - "label": "Bosun: Terminate Runtime", - "type": "shell", - "command": "node cli.mjs --terminate", - "options": { - "cwd": "${workspaceFolder}" - }, - "presentation": { - "reveal": "always", - "panel": "shared", - "clear": true - }, - "problemMatcher": [] - }, - { - "label": "Bosun: Daemon Status", - "type": "shell", - "command": "node cli.mjs --daemon-status", - "options": { - "cwd": "${workspaceFolder}" - }, - "presentation": { - "reveal": "always", - "panel": "shared", - "clear": true - }, - "problemMatcher": [] - }, { "label": "Bump Patch Version", "type": "shell", diff --git a/AGENTS.md b/AGENTS.md index a27856443..3ab03a0e4 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -10,11 +10,6 @@ Open the closest module `AGENTS.md` before editing. 3. Edit only that module plus directly impacted callers/tests. 4. Run targeted tests, then `npm test`, then `npm run build`. -## Pre-Push Pitfalls -- Run `npm run syntax:check` after touching any browser-served module under `ui/` or `site/ui/`. It now validates both syntax and local import/export bindings for `.js` and `.mjs` browser modules. -- If you mirror helpers between `ui/` and `site/ui/`, update both copies in the same change. The hosted demo does not inherit files from `ui/` automatically. -- If you add a new shipped runtime file, run `node tools/prepublish-check.mjs` and update `package.json#files` when needed. - ## Core Entry Points - CLI: `cli.mjs` - Setup: `setup.mjs` diff --git a/README.md b/README.md index c314f26bc..d3c76bdae 100644 --- a/README.md +++ b/README.md @@ -144,16 +144,6 @@ Set `primaryAgent` in `.bosun/bosun.config.json` or choose an executor preset du - `bosun --daemon --sentinel` starts daemon + sentinel together (recommended for unattended operation). - `bosun --terminate` is the clean reset command when you suspect stale/ghost processes. -## VS Code debugging - -Bosun now includes workspace debug entries in `.vscode/launch.json` and helper tasks in `.vscode/tasks.json`. - -- `Debug Bosun CLI` launches `cli.mjs` with the repo-local `.bosun` config and attaches the debugger to the real CLI entry path. -- `Debug Bosun Monitor Direct` launches `infra/monitor.mjs` directly when you want to debug monitor logic without stepping through the CLI worker bootstrap. -- `Debug Bosun Daemon Child (foreground)` runs the daemon-child path without detaching, which is useful for restart-loop and daemon-specific behavior. -- `Attach to Bosun CLI Startup (9229)` and `Attach to Bosun Monitor Startup (9230)` start Bosun under `--inspect-brk` so you can catch startup failures before normal breakpoints would bind. -- `Bosun: Terminate Runtime` is the cleanup task to use if a stale monitor/daemon is holding the lock before a debug session. - Telegram operators can pull the weekly agent work summary with `/weekly [days]` or `/report weekly [days]`. To post it automatically once per week, set `TELEGRAM_WEEKLY_REPORT_ENABLED=true` together with `TELEGRAM_WEEKLY_REPORT_DAY`, `TELEGRAM_WEEKLY_REPORT_HOUR`, and optional `TELEGRAM_WEEKLY_REPORT_DAYS`. ## Documentation diff --git a/_docs/AZURE_AGENTIC_INFRAOPS_BACKPORT_ANALYSIS.md b/_docs/AZURE_AGENTIC_INFRAOPS_BACKPORT_ANALYSIS.md deleted file mode 100644 index c5ccf5ccd..000000000 --- a/_docs/AZURE_AGENTIC_INFRAOPS_BACKPORT_ANALYSIS.md +++ /dev/null @@ -1,345 +0,0 @@ -# Azure Agentic InfraOps Back-Port Analysis - -## Purpose - -This document compares Bosun with the concepts published in the Azure Agentic InfraOps project and identifies which ideas are already present in Bosun, which are only partially present, and which would materially improve Bosun if promoted into first-class features. - -The key conclusion is straightforward: - -- Bosun already provides many of the runtime primitives that Azure Agentic InfraOps cites as inspiration. -- The main opportunity is not feature parity. -- The main opportunity is to make Bosun more opinionated by turning existing scattered patterns into an explicit operating model. - -## What Azure Agentic InfraOps Adds Conceptually - -From the public docs, the Azure project is organized around a stricter orchestration model with: - -- a conductor pattern that maintains the evolving execution plan -- explicit approval gates at critical transitions -- invariant validators between steps, not just at the end -- a repository-first memory model for durable state -- typed session state and resumable checkpoints -- challenger reviews as a built-in maker-checker loop -- stronger cost governance and model-tier routing -- deterministic stop conditions for long-running agent workflows - -Azure Agentic InfraOps is best understood as Bosun-style engineering patterns wrapped in a more prescriptive control framework. - -## What Bosun Already Has - -Bosun already contains strong first-class implementations for many of the underlying primitives: - -- multi-agent orchestration and supervision -- workflow DAG execution -- distributed shared state and claim-based locking -- context shredding and compression -- anomaly detection and circuit breakers -- PR automation and review gating -- prompt registries and skill loading -- workflow evidence collection and validation nodes - -High-signal existing areas: - -- `infra/monitor.mjs` -- `agent/agent-supervisor.mjs` -- `agent/agent-pool.mjs` -- `workflow/workflow-engine.mjs` -- `workflow/workflow-nodes.mjs` -- `task/task-claims.mjs` -- `workspace/shared-state-manager.mjs` -- `infra/anomaly-detector.mjs` -- `config/context-shredding-config.mjs` - -This matters because the recommendations below are largely architectural surfacing and unification work, not ground-up invention. - -## Where Bosun Is Partial Today - -Bosun has the pieces, but several of the Azure concepts are not yet expressed as a single explicit contract. - -### 1. Supervisor Without A True Conductor Ledger - -Bosun has orchestration and supervision, but the plan is not treated as a durable, mutable ledger that is continuously updated as subagents report back. - -Current state: - -- supervision is strong -- replanning is possible -- the plan itself is not a first-class persisted state object - -Impact: - -- less transparent progress across long-running tasks -- weaker resume semantics after interruption -- harder to reason about what changed between iterations - -### 2. Approval Is Present But Too Coarse - -Bosun already has review gates, but approval is not consistently expressed as typed gates on classes of actions. - -Current state: - -- merge and review gates exist -- workflow `action.ask_user` exists -- agent runtime often defaults to coarse approval policies - -Gap: - -- no first-class policy like `approvalRequired: ["deploy", "merge", "secrets", "prod-write"]` -- no unified pause-and-resume contract at those exact boundaries - -### 3. Validation Happens Too Late - -Bosun has strong quality gates, but many checks happen near push, review, or failure recovery time instead of between agent handoffs. - -Gap: - -- no general transition-level invariant validator layer in the workflow engine -- downstream steps can receive outputs that are structurally valid enough to continue, but not semantically trustworthy enough to compound safely - -### 4. Session State Is Not Yet A Canonical Envelope - -Bosun has task state, workflow state, session tracking, and shared state. What it does not yet have is one canonical typed session envelope that describes the current objective, current phase, approvals, retry counts, checkpoints, and completion predicates for a run. - -Gap: - -- harder crash recovery for long multi-step tasks -- weaker auditability for why a run resumed where it did -- harder interoperability between monitor, workflow, and review flows - -### 5. No Built-In Challenger Loop - -Bosun supports review, but it does not consistently use a built-in maker-checker cycle where one agent produces and a second agent challenges against explicit criteria before promotion. - -Gap: - -- quality control is partly reactive -- autofix and remediation loops can remain single-perspective -- review criteria are not always converted into repeated structured evaluation - -### 6. Cost Governance Is Observed More Than Enforced - -Bosun tracks budgets and timeouts, but model-tiering and spend-aware orchestration are not yet a strong first-class control surface. - -Gap: - -- limited per-run token accounting -- limited per-role model routing based on task complexity and cost -- no explicit budget-triggered compaction, downgrade, or halt policy across a whole orchestration run - -### 7. Stop Conditions Are Not Formal Enough - -Bosun has retries, cooldowns, anomaly detection, and circuit breakers. That is not the same thing as deterministic completion logic. - -Gap: - -- no general `goalSatisfied()` contract for long-running orchestration steps -- limited stall detection based on lack of meaningful state change -- limited typed fallback outcomes when iteration caps are reached - -## Highest-Leverage Improvements For Bosun - -These are the changes most worth back-porting from the Azure style of operation. - -### Priority 1: Add A First-Class Run Ledger - -Introduce a durable run ledger for complex tasks and workflows. - -Suggested contents: - -- objective -- current phase -- plan steps -- completed steps -- blocked steps -- approvals granted -- checkpoints -- retry counters -- evidence references -- completion predicate status - -Likely Bosun touchpoints: - -- `infra/monitor.mjs` -- `workflow/workflow-engine.mjs` -- `task/` -- `workspace/shared-state-manager.mjs` - -Outcome: - -- better crash recovery -- more reliable replanning -- clearer operator visibility -- easier subagent coordination - -### Priority 2: Add Typed Approval Gates - -Add policy-driven gates by action class instead of broad runtime approval settings. - -Examples: - -- `merge` -- `prod-deploy` -- `external-write` -- `secret-use` -- `destructive-git` - -Likely Bosun touchpoints: - -- `agent/agent-hooks.mjs` -- `workflow/workflow-nodes/actions.mjs` -- `infra/monitor.mjs` -- configuration schema and runtime config - -Outcome: - -- tighter operator control -- less friction for low-risk automation -- resumable pauses at the right boundaries - -### Priority 3: Add Handoff Validators In The Workflow Engine - -Add an explicit validation layer between agent-producing nodes and downstream consumer nodes. - -Validator types could include: - -- schema validity -- confidence threshold -- required evidence presence -- policy compliance -- semantic completeness -- contradiction or drift detection - -Likely Bosun touchpoints: - -- `workflow/workflow-engine.mjs` -- `workflow/workflow-nodes/validation.mjs` -- `workflow/workflow-contract.mjs` - -Outcome: - -- fewer error cascades -- safer multi-step automation -- better recovery semantics when a step is low quality but not technically failed - -### Priority 4: Add A Built-In Challenger Pattern - -Make maker-checker loops a reusable Bosun workflow and runtime primitive. - -Pattern: - -- maker agent produces output -- challenger agent reviews against explicit criteria -- result is approve, changes requested, or escalate -- iteration cap and fallback policy are mandatory - -Likely Bosun touchpoints: - -- `agent/review-agent.mjs` -- `agent/agent-supervisor.mjs` -- `agent/autofix.mjs` -- `workflow-templates/` - -Outcome: - -- stronger code review automation -- better remediation quality -- less self-confirming single-agent behavior - -### Priority 5: Formalize Deterministic Stop Conditions - -Add explicit completion and stall contracts for long-running flows. - -Examples: - -- `maxIterations` -- `goalSatisfied` -- `noStateChangeForNRounds` -- `budgetExceeded` -- `approvalTimeout` -- `escalateAfter` - -Likely Bosun touchpoints: - -- `infra/monitor.mjs` -- `agent/agent-supervisor.mjs` -- `workflow/workflow-engine.mjs` - -Outcome: - -- fewer ambiguous loops -- better operator trust -- clearer escalation behavior - -### Priority 6: Promote Cost Governance To A First-Class Policy Surface - -Extend Bosun from budget awareness into budget-based orchestration policy. - -Examples: - -- route summarization and cleanup work to cheaper models -- reserve premium models for planning, review, and high-risk tasks -- cap spend per run or per task family -- auto-compact context or downgrade model tiers when thresholds are crossed - -Likely Bosun touchpoints: - -- `agent/agent-pool.mjs` -- `agent/fleet-coordinator.mjs` -- `agent/agent-work-analyzer.mjs` -- config schema - -Outcome: - -- lower operating cost -- more predictable scaling -- better fleet-level scheduling decisions - -## Recommended Implementation Order - -If this becomes an actual Bosun improvement track, the order should be: - -1. Run ledger and resumable session envelope -2. Typed approval gates -3. Handoff validators -4. Challenger workflow template and runtime support -5. Deterministic stop conditions -6. Cost governance policy surface - -That sequence improves reliability first, then quality, then economics. - -## What Not To Copy Blindly - -Some Azure Agentic InfraOps patterns are domain-specific to Azure infrastructure generation and should not be copied into Bosun wholesale. - -Examples: - -- Azure-specific governance terminology -- IaC-specific approval stage count -- AVM and Well-Architected checks as Bosun core concepts - -Bosun should copy the orchestration pattern, not the infrastructure domain framing. - -## Recommended Bosun Positioning - -The clearest framing after this comparison is: - -> Azure Agentic InfraOps operationalizes several Bosun patterns for one domain. -> Bosun can improve in return by making those same patterns more explicit, durable, and policy-driven at the platform level. - -In other words, the best inspiration to take back is: - -- stronger state contracts -- stronger gate contracts -- stronger handoff validation -- stronger maker-checker loops -- stronger deterministic completion rules - -## Proposed Follow-Up Work - -If we decide to implement this, the next useful artifacts would be: - -1. a Bosun RFC for `run-ledger.json` -2. a config proposal for typed approval gates -3. a workflow-engine proposal for transition validators -4. a reusable challenger template for maker-checker flows -5. a stop-condition spec shared by monitor and workflow runtime diff --git a/agent/agent-event-bus.mjs b/agent/agent-event-bus.mjs index 5f7d10d47..91ffe491b 100644 --- a/agent/agent-event-bus.mjs +++ b/agent/agent-event-bus.mjs @@ -385,11 +385,6 @@ export class AgentEventBus { * @param {object} body — { hasCommits, branch, prUrl, prNumber, output } */ onAgentComplete(taskId, body = {}) { - const task = this._resolveTask(taskId); - const reviewStatus = String(task?.reviewStatus || "").trim().toLowerCase(); - const reviewIssueCount = Array.isArray(task?.reviewIssues) - ? task.reviewIssues.length - : 0; this.emit(AGENT_EVENT.AGENT_COMPLETE, taskId, { hasCommits: !!body.hasCommits, branch: body.branch || null, @@ -403,34 +398,8 @@ export class AgentEventBus { } catch { /* best-effort */ } } - if ( - body.hasCommits && - reviewStatus === "changes_requested" && - typeof this._sendTelegram === "function" - ) { - const branch = String(body.branch || task?.branchName || "").trim(); - const prNumber = Number.isFinite(Number(body.prNumber)) - ? Number(body.prNumber) - : null; - const prUrl = String(body.prUrl || task?.prUrl || "").trim(); - const title = task?.title || taskId; - const lines = [ - ":check: Review changes implemented", - `Task: ${title}`, - "Summary: Bosun completed a remediation pass and moved the task back into review.", - reviewIssueCount ? `Issues addressed: ${reviewIssueCount}` : "", - branch ? `Branch: ${branch}` : "", - prNumber ? `PR: #${prNumber}` : prUrl ? `PR: ${prUrl}` : "", - ] - .filter(Boolean) - .join("\n"); - this._sendTelegram(lines, { - dedupKey: `review-fix-complete|${taskId}|${prNumber || prUrl || branch || "unknown"}`, - exactDedup: true, - }); - } - if (this._reviewAgent) { + const task = this._resolveTask(taskId); if (task) this._triggerAutoReview(task, body); } } diff --git a/agent/agent-hooks.mjs b/agent/agent-hooks.mjs index 68497b529..50791744f 100644 --- a/agent/agent-hooks.mjs +++ b/agent/agent-hooks.mjs @@ -51,9 +51,6 @@ const MAX_OUTPUT_BYTES = 64 * 1024; /** Whether we're running on Windows */ const IS_WINDOWS = process.platform === "win32"; -/** Preferred Windows shell for hook execution. */ -const WINDOWS_SHELL = process.env.ComSpec || "cmd.exe"; - /** Default max retries for retryable hooks */ const DEFAULT_MAX_RETRIES = 2; @@ -844,42 +841,6 @@ function _buildEnv(ctx) { return env; } -function _getSpawnCommand(command) { - const trimmed = String(command ?? "").trim(); - - if (IS_WINDOWS) { - const lower = trimmed.toLowerCase(); - if (lower.startsWith("powershell ") || lower.startsWith("powershell.exe ")) { - const inlineCommand = trimmed - .replace(/^powershell(?:\.exe)?\s+-NoProfile\s+-Command\s+/i, "") - .replace(/^powershell(?:\.exe)?\s+-Command\s+/i, "") - .replace(/^"|"$/g, ""); - return { - file: "powershell.exe", - args: ["-NoProfile", "-Command", inlineCommand], - }; - } - if (lower.startsWith("cmd ") || lower.startsWith("cmd.exe ")) { - const inlineCommand = trimmed - .replace(/^cmd(?:\.exe)?\s+\/d\s+\/s\s+\/c\s+/i, "") - .replace(/^cmd(?:\.exe)?\s+\/c\s+/i, ""); - return { - file: WINDOWS_SHELL, - args: ["/d", "/s", "/c", inlineCommand], - }; - } - return { - file: WINDOWS_SHELL, - args: ["/d", "/s", "/c", trimmed], - }; - } - - return { - file: "/bin/sh", - args: ["-c", trimmed], - }; -} - // ── Internal: Synchronous Hook Execution ──────────────────────────────────── /** @@ -931,13 +892,12 @@ function _executeHookSync(hook, ctx, env) { }; try { - const spawnTarget = _getSpawnCommand(hook.command); - const result = spawnSync(spawnTarget.file, spawnTarget.args, { + const result = spawnSync(hook.command, { cwd, env: hookEnv, encoding: "utf8", timeout, - shell: false, + shell: true, windowsHide: true, maxBuffer: MAX_OUTPUT_BYTES, }); @@ -1039,11 +999,10 @@ function _executeHookAsyncOnce(hook, ctx, env, attempt) { let child; try { - const spawnTarget = _getSpawnCommand(hook.command); - child = spawn(spawnTarget.file, spawnTarget.args, { + child = spawn(hook.command, { cwd, env: hookEnv, - shell: false, + shell: true, windowsHide: true, stdio: ["ignore", "pipe", "pipe"], }); @@ -1294,10 +1253,3 @@ export function registerLibraryHooks(hooksByEvent) { } return { registered, skipped }; } - - - - - - - diff --git a/agent/agent-pool.mjs b/agent/agent-pool.mjs index 0fa9285aa..06e53f00f 100644 --- a/agent/agent-pool.mjs +++ b/agent/agent-pool.mjs @@ -1,8 +1,3 @@ -// CLAUDE:SUMMARY — agent-pool -// Resolves SDK selection and fallback order for ephemeral agent threads, -// including env/config-driven failover and launch orchestration across Codex, -// Copilot, Claude, and compatible adapters. - /** * agent-pool.mjs — Universal SDK-Aware Ephemeral Agent Pool * @@ -44,15 +39,12 @@ * getAvailableSdks() → returns list of non-disabled SDKs */ -import { randomUUID } from "node:crypto"; import { resolve, dirname } from "node:path"; import { existsSync, readFileSync } from "node:fs"; import { homedir } from "node:os"; import { fileURLToPath } from "node:url"; import { createRequire } from "node:module"; -import "../infra/windows-hidden-child-processes.mjs"; import { loadConfig } from "../config/config.mjs"; -import { resolveAgentSdkModuleEntry, resolveCodexSdkInstall } from "./agent-sdk.mjs"; import { resolveRepoRoot, resolveAgentRepoRoot } from "../config/repo-root.mjs"; import { resolveCodexProfileRuntime, readCodexConfigRuntimeDefaults } from "../shell/codex-model-profiles.mjs"; import { buildTaskWritableRoots } from "../shell/codex-config.mjs"; @@ -106,390 +98,35 @@ const HARD_TIMEOUT_BUFFER_MS = 5 * 60_000; // 5 minutes /** Tag for console logging */ const TAG = "[agent-pool]"; -const DEFAULT_AGENT_EXECUTION_MAX_PARALLEL = 3; const require = createRequire(import.meta.url); -const CODEX_SDK_SPECIFIER = "@openai/codex-sdk"; const MODULE_PRESENCE_CACHE = new Map(); -const activeAgentExecutionSlots = new Map(); -const queuedAgentExecutionSlots = []; - -function resolveCodexWindowsRuntime() { - if (process.platform !== "win32") { - return { supported: false, packageName: null, binaryPath: null }; - } - - const runtimeMap = { - x64: { - packageName: "@openai/codex-win32-x64", - binaryParts: ["vendor", "x86_64-pc-windows-msvc", "codex", "codex.exe"], - }, - arm64: { - packageName: "@openai/codex-win32-arm64", - binaryParts: ["vendor", "aarch64-pc-windows-msvc", "codex", "codex.exe"], - }, - }; - - const runtimeInfo = runtimeMap[process.arch]; - if (!runtimeInfo) { - return { supported: false, packageName: null, binaryPath: null }; - } - - try { - const runtimePkgJson = require.resolve(`${runtimeInfo.packageName}/package.json`); - return { - supported: true, - packageName: runtimeInfo.packageName, - binaryPath: resolve(dirname(runtimePkgJson), ...runtimeInfo.binaryParts), - }; - } catch { - return { - supported: true, - packageName: runtimeInfo.packageName, - binaryPath: null, - }; - } -} - -function getCodexRuntimePrerequisiteFailure() { - const runtime = resolveCodexWindowsRuntime(); - if (!runtime.supported) return null; - if (!runtime.binaryPath) { - return `${runtime.packageName} not installed`; - } - if (!existsSync(runtime.binaryPath)) { - return `Codex SDK runtime missing at ${runtime.binaryPath}`; - } - return null; -} - -function isDeterministicSdkFailure(errorValue) { - const message = String(errorValue || "").toLowerCase(); - if (!message) return false; - if (message.includes("failed to list models") && message.includes("400")) { - return true; - } - if (message.includes("enoent")) return true; - if (message.includes("sdk runtime missing")) return true; - if (message.includes("sdk not available")) return true; - if (message.includes("not installed")) return true; - return false; -} - -function parsePositiveInt(value) { - const parsed = Number(value); - if (!Number.isFinite(parsed) || parsed <= 0) return null; - return Math.max(1, Math.trunc(parsed)); -} - -function resolveAgentExecutionMaxParallel(explicit = null) { - const direct = parsePositiveInt(explicit); - if (direct) return direct; - const envValue = - parsePositiveInt(process.env.AGENT_POOL_MAX_PARALLEL) || - parsePositiveInt(process.env.WORKFLOW_AGENT_MAX_PARALLEL); - if (envValue) return envValue; - try { - const cfg = loadConfig(); - const configValue = - parsePositiveInt(cfg?.agentPool?.maxParallel) || - parsePositiveInt(cfg?.internalExecutor?.maxParallel); - if (configValue) return configValue; - } catch { - // Best-effort only; fall back to a safe default. - } - return DEFAULT_AGENT_EXECUTION_MAX_PARALLEL; -} - -function summarizeAgentSlotMeta(meta = {}) { - if (!meta || typeof meta !== "object") return {}; - const summary = {}; - const scalarKeys = [ - "taskKey", - "taskId", - "taskTitle", - "workflowRunId", - "workflowId", - "workflowName", - "workflowNodeId", - "workflowNodeLabel", - "cwd", - "sdk", - "model", - "sessionType", - ]; - for (const key of scalarKeys) { - const value = meta[key]; - if (value == null) continue; - const normalized = String(value).trim(); - if (normalized) summary[key] = normalized; - } - return summary; -} - -function emitAgentSlotHook(hook, payload) { - if (typeof hook !== "function") return; - try { - hook(payload); - } catch { - // Slot telemetry must never break agent execution. - } -} - -function buildAgentSlotSnapshot(overrides = {}) { - const maxParallel = resolveAgentExecutionMaxParallel(overrides.maxParallel); - return { - maxParallel, - activeSlots: activeAgentExecutionSlots.size, - queuedSlots: queuedAgentExecutionSlots.length, - ...overrides, - }; -} - -function grantQueuedAgentExecutionSlot(request) { - const grantedAt = Date.now(); - const lease = { - slotId: request.slotId, - ownerKey: request.ownerKey, - requestedAt: request.requestedAt, - queuedAt: request.queuedAt, - acquiredAt: grantedAt, - waitedMs: Math.max(0, grantedAt - request.requestedAt), - maxParallel: request.maxParallel, - meta: request.meta, - onReleased: request.onReleased, - }; - activeAgentExecutionSlots.set(lease.slotId, lease); - const payload = buildAgentSlotSnapshot({ - slotId: lease.slotId, - ownerKey: lease.ownerKey, - queuedAt: lease.queuedAt, - acquiredAt: lease.acquiredAt, - requestedAt: lease.requestedAt, - waitedMs: lease.waitedMs, - maxParallel: lease.maxParallel, - meta: lease.meta, - }); - emitAgentSlotHook(request.onAcquired, payload); - request.resolve(lease); -} - -function pumpQueuedAgentExecutionSlots() { - while (queuedAgentExecutionSlots.length > 0) { - const next = queuedAgentExecutionSlots[0]; - const maxParallel = resolveAgentExecutionMaxParallel(next.maxParallel); - if (activeAgentExecutionSlots.size >= maxParallel) break; - queuedAgentExecutionSlots.shift(); - grantQueuedAgentExecutionSlot(next); - } -} - -export function getAvailableSlots(maxParallel = null) { - return Math.max( - 0, - resolveAgentExecutionMaxParallel(maxParallel) - activeAgentExecutionSlots.size, - ); -} - -export function getAgentExecutionSlotStatus() { - return { - maxParallel: resolveAgentExecutionMaxParallel(), - activeSlots: activeAgentExecutionSlots.size, - queuedSlots: queuedAgentExecutionSlots.length, - active: Array.from(activeAgentExecutionSlots.values()).map((lease) => ({ - slotId: lease.slotId, - ownerKey: lease.ownerKey, - requestedAt: lease.requestedAt, - queuedAt: lease.queuedAt, - acquiredAt: lease.acquiredAt, - waitedMs: lease.waitedMs, - maxParallel: lease.maxParallel, - meta: { ...lease.meta }, - })), - queued: queuedAgentExecutionSlots.map((request) => ({ - slotId: request.slotId, - ownerKey: request.ownerKey, - requestedAt: request.requestedAt, - queuedAt: request.queuedAt, - maxParallel: request.maxParallel, - meta: { ...request.meta }, - })), - }; -} - -export async function allocateSlot(ownerKey = "", options = {}) { - const normalizedOwnerKey = - String( - ownerKey || - options.taskKey || - options.taskId || - options.workflowRunId || - options.workflowId || - "", - ).trim() || `agent-slot:${randomUUID()}`; - const slotId = `agent-slot-${randomUUID().slice(0, 8)}`; - const requestedAt = Date.now(); - const maxParallel = resolveAgentExecutionMaxParallel(options.maxParallel); - const meta = summarizeAgentSlotMeta({ - ...options.meta, - taskKey: options.taskKey, - taskId: options.taskId, - taskTitle: options.taskTitle, - workflowRunId: options.workflowRunId, - workflowId: options.workflowId, - workflowName: options.workflowName, - workflowNodeId: options.workflowNodeId, - workflowNodeLabel: options.workflowNodeLabel, - cwd: options.cwd, - sdk: options.sdk, - model: options.model, - sessionType: options.sessionType, - }); - const request = { - slotId, - ownerKey: normalizedOwnerKey, - requestedAt, - queuedAt: null, - maxParallel, - meta, - onAcquired: options.onAcquired, - onReleased: options.onReleased, - resolve: null, - reject: null, - }; - - if (activeAgentExecutionSlots.size < maxParallel) { - return await new Promise((resolve) => { - request.resolve = resolve; - grantQueuedAgentExecutionSlot(request); - }); - } - - request.queuedAt = Date.now(); - emitAgentSlotHook( - options.onQueued, - buildAgentSlotSnapshot({ - slotId, - ownerKey: normalizedOwnerKey, - requestedAt, - queuedAt: request.queuedAt, - maxParallel, - queuedSlots: queuedAgentExecutionSlots.length + 1, - meta, - queueDepth: queuedAgentExecutionSlots.length + 1, - }), - ); - return await new Promise((resolve, reject) => { - request.resolve = resolve; - request.reject = reject; - queuedAgentExecutionSlots.push(request); - }); -} - -export async function releaseSlot(slotRef = null) { - const slotId = - typeof slotRef === "string" - ? slotRef - : String(slotRef?.slotId || "").trim(); - if (!slotId) { - return buildAgentSlotSnapshot({ released: false, reason: "missing_slot_id" }); - } - const lease = activeAgentExecutionSlots.get(slotId); - if (!lease) { - return buildAgentSlotSnapshot({ released: false, slotId, reason: "slot_not_found" }); - } - activeAgentExecutionSlots.delete(slotId); - const releasedAt = Date.now(); - const payload = buildAgentSlotSnapshot({ - slotId, - ownerKey: lease.ownerKey, - requestedAt: lease.requestedAt, - queuedAt: lease.queuedAt, - acquiredAt: lease.acquiredAt, - releasedAt, - waitedMs: lease.waitedMs, - runDurationMs: Math.max(0, releasedAt - lease.acquiredAt), - maxParallel: lease.maxParallel, - meta: lease.meta, - released: true, - }); - emitAgentSlotHook(lease.onReleased, payload); - pumpQueuedAgentExecutionSlots(); - return payload; -} - -async function withAgentExecutionSlot(cwd, extra = {}, runner) { - if (extra?.slotLease) { - return await runner(extra.slotLease); - } - const slotOwnerKey = - String( - extra?.slotOwnerKey || - extra?.taskKey || - extra?.taskId || - extra?.workflowRunId || - extra?.workflowId || - "", - ).trim() || `agent-slot:${randomUUID()}`; - let slotLease = null; - try { - slotLease = await allocateSlot(slotOwnerKey, { - taskKey: extra?.taskKey, - taskId: extra?.taskId, - taskTitle: extra?.taskTitle, - workflowRunId: extra?.workflowRunId, - workflowId: extra?.workflowId, - workflowName: extra?.workflowName, - workflowNodeId: extra?.workflowNodeId, - workflowNodeLabel: extra?.workflowNodeLabel, - cwd, - sdk: extra?.sdk, - model: extra?.model, - sessionType: extra?.sessionType, - meta: extra?.slotMeta, - maxParallel: extra?.slotMaxParallel, - onQueued: extra?.onSlotQueued, - onAcquired: extra?.onSlotAcquired, - onReleased: extra?.onSlotReleased, - }); - return await runner(slotLease); - } finally { - if (slotLease?.slotId) { - await releaseSlot(slotLease); - } - } -} function hasOptionalModule(specifier) { if (MODULE_PRESENCE_CACHE.has(specifier)) { return MODULE_PRESENCE_CACHE.get(specifier); } let ok = false; - if (specifier === CODEX_SDK_SPECIFIER) { - ok = Boolean(resolveCodexSdkInstall({ extraRoots: [getAgentRepoRoot(), process.cwd()] })); - } else { + try { + require.resolve(specifier); + ok = true; + } catch { + // ESM-only packages have no CJS "require" export so require.resolve + // throws even when the package is installed. Fall back to checking + // whether the package directory exists on disk. try { - require.resolve(specifier); - ok = true; + const pkgDir = resolve(__dirname, "..", "node_modules", ...specifier.split("/")); + ok = existsSync(resolve(pkgDir, "package.json")); } catch { - ok = Boolean( - resolveAgentSdkModuleEntry(specifier, { extraRoots: [getAgentRepoRoot(), process.cwd()] }), - ); + ok = false; } } MODULE_PRESENCE_CACHE.set(specifier, ok); return ok; } - -async function importCodexSdkModule() { - return import(CODEX_SDK_SPECIFIER); -} const MAX_PROMPT_BYTES = 180_000; const MAX_SET_TIMEOUT_MS = 2_147_483_647; // Node.js setTimeout 32-bit signed max let timeoutClampWarningKey = ""; -const MIN_SILENT_STREAM_FRACTION = 0.25; -const MAX_SILENT_STREAM_GRACE_MS = 30_000; const DEFAULT_FIRST_EVENT_TIMEOUT_MS = 120_000; -const COPILOT_IDLE_TIMEOUT_GRACE_MS = 1_000; const DEFAULT_MAX_ITEMS_PER_TURN = 600; const DEFAULT_MAX_ITEM_CHARS = 12_000; const TOOL_OUTPUT_GUARDRAIL = String.raw` @@ -624,14 +261,6 @@ async function maybeCompressResultItems( } function resolveCodexStreamSafety(totalTimeoutMs) { - const minSilentStreamFraction = - typeof MIN_SILENT_STREAM_FRACTION === "number" && Number.isFinite(MIN_SILENT_STREAM_FRACTION) - ? MIN_SILENT_STREAM_FRACTION - : 0.25; - const maxSilentStreamGraceMs = - typeof MAX_SILENT_STREAM_GRACE_MS === "number" && Number.isFinite(MAX_SILENT_STREAM_GRACE_MS) - ? MAX_SILENT_STREAM_GRACE_MS - : 30_000; const streamCfg = getInternalExecutorStreamConfig(); const firstEventRaw = process.env.INTERNAL_EXECUTOR_STREAM_FIRST_EVENT_TIMEOUT_MS || @@ -657,17 +286,10 @@ function resolveCodexStreamSafety(totalTimeoutMs) { let firstEventTimeoutMs = null; if (Number.isFinite(budgetMs) && budgetMs > 2_000) { const maxAllowed = Math.max(1_000, budgetMs - 1_000); - const silentBudgetFloor = Math.min( - maxAllowed, - Math.max( - configuredFirstEventMs, - Math.min( - Math.trunc(budgetMs * minSilentStreamFraction), - maxSilentStreamGraceMs, - ), - ), + firstEventTimeoutMs = clampTimerDelayMs( + Math.min(configuredFirstEventMs, maxAllowed), + "first-event-timeout", ); - firstEventTimeoutMs = clampTimerDelayMs(silentBudgetFloor, "first-event-timeout"); } return { @@ -722,11 +344,6 @@ function envFlagEnabled(value) { return ["1", "true", "yes", "on", "y"].includes(raw); } -function normalizeRequestedMcpServerIds(value) { - if (!Array.isArray(value)) return []; - return [...new Set(value.map((item) => String(item || "").trim()).filter(Boolean))]; -} - function applyNodeWarningSuppressionEnv(runtimeEnv) { const nextEnv = { ...(runtimeEnv || {}) }; if (String(process.env.BOSUN_SUPPRESS_NODE_WARNINGS ?? "").trim() === "0") { @@ -910,9 +527,6 @@ function shouldFallbackForSdkError(error) { if (!error) return false; const message = String(error).toLowerCase(); if (!message) return false; - if (message.includes("failed to list models") && (message.includes("400") || message.includes("bad request"))) { - return true; - } if (message.includes("protocol version mismatch")) return true; if (message.includes("sdk expects version") && message.includes("server reports version")) { return true; @@ -953,7 +567,6 @@ function shouldFallbackForSdkError(error) { if (message.includes("connection refused")) return true; if (message.includes("connection reset")) return true; if (message.includes("etimedout")) return true; - if (message.includes("failed to list models")) return true; // Runtime/provider instability: fail over to next SDK immediately. if (message.includes("timeout")) return true; if (message.includes("rate limit") || message.includes("429")) return true; @@ -993,10 +606,6 @@ function hasSdkPrerequisites(name, runtimeEnv = process.env) { if (!hasOptionalModule("@openai/codex-sdk")) { return { ok: false, reason: "@openai/codex-sdk not installed" }; } - const runtimeFailure = getCodexRuntimePrerequisiteFailure(); - if (runtimeFailure) { - return { ok: false, reason: runtimeFailure }; - } // Codex auth can come from env vars, config env_key mappings, or persisted // CLI login state (for example ~/.codex/auth.json). Because login-based // auth is valid and hard to validate exhaustively, avoid false negatives. @@ -1190,22 +799,6 @@ function buildCodexSdkOptions(envInput = process.env, options = {}) { return false; } }; - const getAzureProviderEndpointEnvKeys = (sectionName) => { - const normalizedName = String(sectionName || "").trim().toUpperCase().replace(/[^A-Z0-9]+/g, "_"); - const keys = ["AZURE_OPENAI_ENDPOINT"]; - if (normalizedName) { - keys.push(`${normalizedName}_ENDPOINT`); - keys.push(`${normalizedName}_BASE_URL`); - if (normalizedName.startsWith("AZURE_")) { - const suffix = normalizedName.slice("AZURE_".length); - if (suffix) { - keys.push(`AZURE_${suffix}_ENDPOINT`); - keys.push(`AZURE_${suffix}_BASE_URL`); - } - } - } - return [...new Set(keys)]; - }; const isAzure = isAzureOpenAIBaseUrl(baseUrl); const env = { ...resolvedEnv }; const unsetEnvKeys = []; @@ -1249,22 +842,11 @@ function buildCodexSdkOptions(envInput = process.env, options = {}) { if (!otherEnvKey || otherEnvKey === providerEnvKey) continue; delete env[otherEnvKey]; if (!unsetEnvKeys.includes(otherEnvKey)) unsetEnvKeys.push(otherEnvKey); - for (const endpointKey of getAzureProviderEndpointEnvKeys(sectionName)) { - if (endpointKey === "AZURE_OPENAI_ENDPOINT") continue; - delete env[endpointKey]; - if (!unsetEnvKeys.includes(endpointKey)) unsetEnvKeys.push(endpointKey); - } } } catch { // best effort — if config reading fails, don't block execution } - for (const key of Object.keys(env)) { - if (!key.startsWith("AZURE_OPENAI_API_KEY") || key === providerEnvKey) continue; - delete env[key]; - if (!unsetEnvKeys.includes(key)) unsetEnvKeys.push(key); - } - return { env, unsetEnvKeys, @@ -1333,18 +915,6 @@ const SDK_ADAPTERS = { */ let SDK_FALLBACK_ORDER = ["codex", "copilot", "claude"]; -function getSdkFallbackOrder() { - const envOrder = String(process.env.BOSUN_AGENT_POOL_FALLBACK_ORDER || "").trim(); - if (envOrder) { - const parsed = envOrder - .split(",") - .map((value) => String(value || "").trim().toLowerCase()) - .filter((value, index, arr) => SDK_ADAPTERS[value] && arr.indexOf(value) === index); - if (parsed.length > 0) return parsed; - } - return SDK_FALLBACK_ORDER; -} - // Attempt to load custom fallback order from config try { const cfg = loadConfig(); @@ -1405,21 +975,6 @@ function shouldApplySdkCooldown(error) { if (!error) return false; const message = String(error).toLowerCase(); if (!message) return false; - - if ( - message.includes("failed to list models") - && ( - message.includes("400") - || - message.includes("bad request") - || message.includes("invalid url") - || message.includes("deployment") - || message.includes("api version") - || message.includes("/models") - ) - ) { - return false; - } if (message.includes("failed to list models")) return true; if (message.includes("protocol version mismatch")) return true; if (message.includes("sdk expects version") && message.includes("server reports version")) { @@ -1589,7 +1144,7 @@ function resolvePoolSdkName() { } // 4. Fallback chain: first non-disabled SDK - for (const name of getSdkFallbackOrder()) { + for (const name of SDK_FALLBACK_ORDER) { if (!isDisabled(name)) { resolvedSdkName = name; logResolution(name, "fallback chain"); @@ -1705,7 +1260,7 @@ async function launchCodexThread(prompt, cwd, timeoutMs, extra = {}) { // ── 1. Load the SDK ────────────────────────────────────────────────────── let CodexClass; try { - const mod = await importCodexSdkModule(); + const mod = await import("@openai/codex-sdk"); CodexClass = mod.Codex; if (!CodexClass) throw new Error("Codex export not found in SDK module"); } catch (err) { @@ -1816,17 +1371,9 @@ async function launchCodexThread(prompt, cwd, timeoutMs, extra = {}) { ? `${String(systemPrompt).trim()}\n\n---\n\n${prompt}` : prompt; const safePrompt = sanitizeAndBoundPrompt(`${anchoredPrompt}${TOOL_OUTPUT_GUARDRAIL}`); - const turn = await Promise.race([ - thread.runStreamed(safePrompt, { - signal: controller.signal, - }), - new Promise((_, reject) => { - hardTimer = setTimeout( - () => reject(new Error("hard_timeout")), - clampTimerDelayMs(timeoutMs + HARD_TIMEOUT_BUFFER_MS, "codex-hard-timeout"), - ); - }), - ]); + const turn = await thread.runStreamed(safePrompt, { + signal: controller.signal, + }); let finalResponse = ""; const allItems = []; @@ -1835,7 +1382,6 @@ async function launchCodexThread(prompt, cwd, timeoutMs, extra = {}) { // The soft timeout fires controller.abort() which the SDK should honor. // The hard timeout is a safety net in case the SDK iterator ignores the abort. const hardTimeoutPromise = new Promise((_, reject) => { - if (hardTimer) return; hardTimer = setTimeout( () => reject(new Error("hard_timeout")), clampTimerDelayMs(timeoutMs + HARD_TIMEOUT_BUFFER_MS, "codex-hard-timeout"), @@ -2929,7 +2475,6 @@ export async function launchEphemeralThread( timeoutMs = DEFAULT_TIMEOUT_MS, extra = {}, ) { - return await withAgentExecutionSlot(cwd, extra, async (slotLease) => { const resolvedGithubToken = await resolveGithubSessionToken(); const baseRuntimeEnv = extra?.envOverrides && typeof extra.envOverrides === "object" @@ -2939,7 +2484,6 @@ export async function launchEphemeralThread( const launchExtra = { ...extra, envOverrides: sessionEnv, - slotLease, }; // ── Resolve MCP servers for this launch ────────────────────────────────── @@ -2948,26 +2492,19 @@ export async function launchEphemeralThread( const cfg = loadConfig(); const mcpCfg = cfg.mcpServers || {}; if (mcpCfg.enabled !== false) { - const hasExplicitMcpSelection = Array.isArray(launchExtra.mcpServers); - const requestedIds = normalizeRequestedMcpServerIds(launchExtra.mcpServers); - const defaultIds = !hasExplicitMcpSelection && mcpCfg.allowDefaultServers === true - ? mcpCfg.defaultServers || [] - : []; + const requestedIds = launchExtra.mcpServers || []; + const defaultIds = mcpCfg.defaultServers || []; const registry = await getMcpRegistry(); let resolved = []; if (requestedIds.length || defaultIds.length) { resolved = await registry.resolveMcpServersForAgent( cwd, requestedIds, - { - defaultServers: defaultIds, - catalogOverrides: mcpCfg.catalogOverrides || {}, - requireAuth: mcpCfg.requireAuth !== false, - }, + { defaultServers: defaultIds, catalogOverrides: mcpCfg.catalogOverrides || {} }, ); } - if (resolved.length && typeof registry.wrapServersWithDiscoveryProxy === "function") { - resolved = await registry.wrapServersWithDiscoveryProxy(cwd, resolved, { + if (typeof registry.wrapServersWithDiscoveryProxy === "function") { + resolved = registry.wrapServersWithDiscoveryProxy(cwd, resolved, { enabled: mcpCfg.useDiscoveryProxy !== false, includeCustomTools: mcpCfg.includeCustomToolsInDiscoveryProxy !== false, cacheTtlMs: mcpCfg.discoveryProxyCacheTtlMs, @@ -2981,8 +2518,7 @@ export async function launchEphemeralThread( launchExtra._mcpResolved = true; } } catch (mcpErr) { - launchExtra._resolvedMcpServers = []; - console.warn(`${TAG} MCP server resolution failed (servers skipped): ${mcpErr.message}`); + console.warn(`${TAG} MCP server resolution failed (non-fatal): ${mcpErr.message}`); } // Determine the primary SDK to try @@ -2999,7 +2535,7 @@ export async function launchEphemeralThread( ? [primaryName] : [ primaryName, - ...getSdkFallbackOrder().filter((name) => name !== primaryName), + ...SDK_FALLBACK_ORDER.filter((name) => name !== primaryName), ]; let lastAttemptResult = null; @@ -3273,7 +2809,6 @@ export async function launchEphemeralThread( sdk: primaryName, threadId: null, }; - }); } // --------------------------------------------------------------------------- @@ -3312,7 +2847,6 @@ export async function execPooledPrompt(userMessage, options = {}) { cwd = REPO_ROOT, sdk, model, - mcpServers, sessionType = "ephemeral", forceContextShredding = false, skipContextShredding = false, @@ -3326,7 +2860,6 @@ export async function execPooledPrompt(userMessage, options = {}) { abortController, sdk, model, - mcpServers, }); if (!result.success) { @@ -3681,7 +3214,7 @@ async function resumeCodexThread(threadId, prompt, cwd, timeoutMs, extra = {}) { let CodexClass; try { - const mod = await importCodexSdkModule(); + const mod = await import("@openai/codex-sdk"); CodexClass = mod.Codex; if (!CodexClass) throw new Error("Codex export not found"); } catch (err) { @@ -3768,23 +3301,14 @@ async function resumeCodexThread(threadId, prompt, cwd, timeoutMs, extra = {}) { try { const safePrompt = sanitizeAndBoundPrompt(prompt); - const turn = await Promise.race([ - thread.runStreamed(safePrompt, { - signal: controller.signal, - }), - new Promise((_, reject) => { - hardTimer = setTimeout( - () => reject(new Error("hard_timeout")), - clampTimerDelayMs(timeoutMs + HARD_TIMEOUT_BUFFER_MS, "codex-resume-hard-timeout"), - ); - }), - ]); + const turn = await thread.runStreamed(safePrompt, { + signal: controller.signal, + }); let finalResponse = ""; const allItems = []; // Hard timeout safety net (same as launchCodexThread) const hardTimeoutPromise = new Promise((_, reject) => { - if (hardTimer) return; hardTimer = setTimeout( () => reject(new Error("hard_timeout")), clampTimerDelayMs(timeoutMs + HARD_TIMEOUT_BUFFER_MS, "codex-resume-hard-timeout"), @@ -3930,7 +3454,6 @@ export async function launchOrResumeThread( timeoutMs = DEFAULT_TIMEOUT_MS, extra = {}, ) { - return await withAgentExecutionSlot(cwd, extra, async (slotLease) => { await ensureThreadRegistryLoaded(); const { taskKey, ...restExtra } = extra; const resolvedGithubToken = await resolveGithubSessionToken(); @@ -3943,7 +3466,6 @@ export async function launchOrResumeThread( resolvedGithubToken, ); restExtra.envOverrides = applyNodeWarningSuppressionEnv(restExtra.envOverrides); - restExtra.slotLease = slotLease; // Pass taskKey through as steer key so SDK launchers can register active sessions restExtra.taskKey = taskKey; if (restExtra.sdk && restExtra.pinSdk === true) { @@ -4250,105 +3772,12 @@ export async function launchOrResumeThread( } return { ...result, threadId: finalThreadId, resumed: false }; - }); } // --------------------------------------------------------------------------- // Error Recovery Wrapper // --------------------------------------------------------------------------- -const RETRY_OUTPUT_PLACEHOLDERS = new Set([ - "", - "(agent completed with no text output)", - "continued", - "model response continued", -]); - -const RETRY_RECONNECT_PATTERNS = [ - /session\.idle/i, - /no events received/i, - /first_event_timeout/i, - /timeout_no_events/i, - /stream disconnection/i, - /transient stream error/i, - /transport/i, - /network/i, - /econnreset/i, - /socket hang up/i, - /connection.*closed/i, - /connection.*reset/i, - /reconnect/i, -]; - -function hasMeaningfulRetryResult(result = {}) { - const output = String(result?.output || "").replace(/\s+/g, " ").trim().toLowerCase(); - if (!RETRY_OUTPUT_PLACEHOLDERS.has(output)) return true; - if (Array.isArray(result?.items) && result.items.length > 0) return true; - return false; -} - -function normalizeRetryFailureFingerprint(result = {}) { - const errorText = String(result?.error || "").replace(/\s+/g, " ").trim().toLowerCase(); - if (!errorText) return ""; - if (RETRY_RECONNECT_PATTERNS.some((pattern) => pattern.test(errorText))) { - return errorText - .replace(/\bafter \d+ms\b/g, "after ") - .replace(/attempt \d+\/\d+/g, "attempt /") - .replace(/[a-f0-9]{8,}/g, "") - .slice(0, 160); - } - return ""; -} - -function classifyRetryCircuitBreak(result = {}, state = {}) { - if (result?.success) { - return { - fingerprint: "", - repeatedFingerprint: false, - noOutputFailure: false, - shouldBreak: false, - blockedReason: null, - error: null, - }; - } - - const fingerprint = normalizeRetryFailureFingerprint(result); - const repeatedFingerprint = Boolean(fingerprint) && Number(state.failureFingerprints?.get(fingerprint) || 0) >= 1; - const noOutputFailure = !hasMeaningfulRetryResult(result); - const repeatedNoOutput = noOutputFailure && Number(state.consecutiveNoOutputFailures || 0) >= 1; - - if (repeatedFingerprint) { - return { - fingerprint, - repeatedFingerprint: true, - noOutputFailure, - shouldBreak: true, - blockedReason: "blocked_by_env", - error: `Repeated reconnect fingerprint detected: ${fingerprint}`, - }; - } - - if (repeatedNoOutput) { - return { - fingerprint, - repeatedFingerprint: false, - noOutputFailure: true, - shouldBreak: true, - blockedReason: "no_output", - error: "Repeated no-output agent starts detected; stopping retries", - }; - } - - return { - fingerprint, - repeatedFingerprint: false, - noOutputFailure, - shouldBreak: false, - blockedReason: null, - error: null, - }; -} - /** * Execute a prompt with automatic error recovery via thread resume. * @@ -4391,16 +3820,9 @@ export async function execWithRetry(prompt, options = {}) { buildContinuePrompt, sdk, model, - mcpServers, sessionType = "task", onEvent, onAbortControllerReplaced, - slotOwnerKey, - slotMeta, - slotMaxParallel, - onSlotQueued, - onSlotAcquired, - onSlotReleased, } = options; // AbortController can be replaced on idle_continue, so track it mutably @@ -4416,8 +3838,6 @@ export async function execWithRetry(prompt, options = {}) { const totalAttempts = 1 + maxRetries; let continuesUsed = 0; let attempt = 0; - const failureFingerprints = new Map(); - let consecutiveNoOutputFailures = 0; while (attempt < totalAttempts + continuesUsed) { attempt++; @@ -4487,17 +3907,10 @@ export async function execWithRetry(prompt, options = {}) { taskKey, sdk, model, - mcpServers, sessionType, onEvent, abortController, ignoreSdkCooldown: attempt > 1, - slotOwnerKey, - slotMeta, - slotMaxParallel, - onSlotQueued, - onSlotAcquired, - onSlotReleased, }); // Check post-launch if aborted with idle_continue (race: abort fired during execution) @@ -4525,33 +3938,6 @@ export async function execWithRetry(prompt, options = {}) { continue; } - const retryCircuit = classifyRetryCircuitBreak(lastResult, { - failureFingerprints, - consecutiveNoOutputFailures, - }); - if (retryCircuit.fingerprint) { - failureFingerprints.set( - retryCircuit.fingerprint, - Number(failureFingerprints.get(retryCircuit.fingerprint) || 0) + 1, - ); - } - consecutiveNoOutputFailures = retryCircuit.noOutputFailure - ? consecutiveNoOutputFailures + 1 - : 0; - - if (retryCircuit.shouldBreak) { - console.warn(`${TAG} execWithRetry circuit breaker tripped for "${taskKey}": ${retryCircuit.error}`); - return { - ...lastResult, - error: retryCircuit.error, - blockedReason: retryCircuit.blockedReason, - retryCircuitBroken: true, - failureFingerprint: retryCircuit.fingerprint || null, - attempts: attempt, - continues: continuesUsed, - }; - } - // Check if we should retry if (lastResult.success) { // If caller has custom shouldRetry (e.g. "output must contain 'PASS'"), check it @@ -4566,12 +3952,6 @@ export async function execWithRetry(prompt, options = {}) { // Failed — should we retry? const retriesLeft = totalAttempts + continuesUsed - attempt; - if (isDeterministicSdkFailure(lastResult.error)) { - console.warn( - `${TAG} attempt ${attempt} hit deterministic SDK failure; retry suppressed: ${lastResult.error}`, - ); - return { ...lastResult, attempts: attempt, continues: continuesUsed }; - } if (retriesLeft > 0) { if (typeof shouldRetry === "function" && !shouldRetry(lastResult)) { // Custom predicate says don't retry @@ -4722,17 +4102,3 @@ export function getActiveThreads() { return result; } - - -export const __testables = { - shouldApplySdkCooldown, - shouldFallbackForSdkError, - hasMeaningfulRetryResult, - normalizeRetryFailureFingerprint, - classifyRetryCircuitBreak, -}; - - - - - diff --git a/agent/agent-prompt-catalog.mjs b/agent/agent-prompt-catalog.mjs index 192cf0643..5e3c8b623 100644 --- a/agent/agent-prompt-catalog.mjs +++ b/agent/agent-prompt-catalog.mjs @@ -442,19 +442,18 @@ You are running as a **Bosun-managed task agent**. Environment variables **After committing:** - If a precommit hook auto-applies additional formatting changes, add those - to a follow-up commit before finishing. + to a follow-up commit before pushing. - Merge any upstream changes — BOTH from the base (module) branch AND from main: \`git fetch origin && git merge origin/ --no-edit && git merge origin/main --no-edit\` - Resolve any conflicts that arise before handing off. -- Run local validation, including the repository pre-push quality gate, before handing off. -- Do not push directly. Bosun workflow automation will perform the validated push and PR lifecycle handoff. + Resolve any conflicts that arise before pushing. +- Push: \`git push --set-upstream origin {{BRANCH}}\` +- After a successful push, hand off PR lifecycle to Bosun management. - Do not run direct PR commands. {{COAUTHOR_INSTRUCTION}} **Do NOT:** -- Push branches directly from the agent session. - Bypass pre-push hooks (\`git push --no-verify\` is forbidden). - Use \`git add .\` — stage files individually. -- Wait for user confirmation before handing off lifecycle state. +- Wait for user confirmation before pushing or handing off lifecycle state. ## Agent Status Endpoint - URL: http://127.0.0.1:{{ENDPOINT_PORT}}/api/tasks/{{TASK_ID}} diff --git a/agent/agent-sdk.mjs b/agent/agent-sdk.mjs index 5b4e8b1d6..0c24ac607 100644 --- a/agent/agent-sdk.mjs +++ b/agent/agent-sdk.mjs @@ -8,11 +8,6 @@ * Capability flags: steering, subagents, vscode_tools */ -import { existsSync, readFileSync } from "node:fs"; -import { createRequire } from "node:module"; -import { dirname, resolve } from "node:path"; -import { fileURLToPath } from "node:url"; -import { resolveAgentRepoRoot, resolveRepoRoot } from "../config/repo-root.mjs"; import { readCodexConfig } from "../shell/codex-config.mjs"; const SUPPORTED_PRIMARY = new Set([ @@ -59,34 +54,6 @@ const DEFAULT_CAPABILITIES = { }; let cachedConfig = null; -const __dirname = dirname(fileURLToPath(import.meta.url)); - -const CODEX_PLATFORM_PACKAGE_MAP = Object.freeze({ - "darwin-arm64": { - packageDir: "@openai/codex-darwin-arm64", - binaryPath: "vendor/aarch64-apple-darwin/codex/codex", - }, - "darwin-x64": { - packageDir: "@openai/codex-darwin-x64", - binaryPath: "vendor/x86_64-apple-darwin/codex/codex", - }, - "linux-arm64": { - packageDir: "@openai/codex-linux-arm64", - binaryPath: "vendor/aarch64-unknown-linux-musl/codex/codex", - }, - "linux-x64": { - packageDir: "@openai/codex-linux-x64", - binaryPath: "vendor/x86_64-unknown-linux-musl/codex/codex", - }, - "win32-arm64": { - packageDir: "@openai/codex-win32-arm64", - binaryPath: "vendor/aarch64-pc-windows-msvc/codex/codex.exe", - }, - "win32-x64": { - packageDir: "@openai/codex-win32-x64", - binaryPath: "vendor/x86_64-pc-windows-msvc/codex/codex.exe", - }, -}); function normalizePrimary(value) { const primary = String(value || "").trim().toLowerCase(); @@ -145,106 +112,6 @@ function parseCapabilities(section) { }; } -function normalizeRootCandidate(rootDir) { - const raw = String(rootDir || "").trim(); - if (!raw) return null; - try { - const resolved = resolve(raw); - return existsSync(resolved) ? resolved : null; - } catch { - return null; - } -} - -function uniqueRoots(roots) { - const seen = new Set(); - const ordered = []; - for (const root of roots) { - const normalized = normalizeRootCandidate(root); - if (!normalized || seen.has(normalized)) continue; - seen.add(normalized); - ordered.push(normalized); - } - return ordered; -} - -function createRequireForRoot(rootDir) { - const packageJson = resolve(rootDir, "package.json"); - if (existsSync(packageJson)) { - return createRequire(packageJson); - } - return createRequire(resolve(rootDir, "__bosun_agent_sdk__.cjs")); -} - -function resolveModuleEntryFromPackageDir(packageDir) { - const packageJsonPath = resolve(packageDir, "package.json"); - if (!existsSync(packageJsonPath)) return null; - try { - const pkg = JSON.parse(readFileSync(packageJsonPath, "utf8")); - const exportRoot = pkg?.exports?.["."] ?? pkg?.exports; - const candidate = - (typeof exportRoot === "string" && exportRoot) || - (exportRoot && typeof exportRoot.import === "string" && exportRoot.import) || - (typeof pkg?.module === "string" && pkg.module) || - (typeof pkg?.main === "string" && pkg.main) || - null; - return candidate ? resolve(packageDir, candidate) : packageJsonPath; - } catch { - return null; - } -} - -function resolveModuleEntryFromRoot(specifier, rootDir) { - try { - return createRequireForRoot(rootDir).resolve(specifier); - } catch { - const packageDir = resolve(rootDir, "node_modules", ...specifier.split("/")); - return resolveModuleEntryFromPackageDir(packageDir); - } -} - -export function getAgentSdkModuleRoots(options = {}) { - const extraRoots = Array.isArray(options.extraRoots) ? options.extraRoots : []; - return uniqueRoots([ - ...extraRoots, - options.rootDir, - process.env.BOSUN_AGENT_REPO_ROOT, - resolveAgentRepoRoot(), - resolveRepoRoot({ cwd: process.cwd() }), - process.cwd(), - resolve(__dirname, ".."), - ]); -} - -export function resolveAgentSdkModuleEntry(specifier, options = {}) { - for (const rootDir of getAgentSdkModuleRoots(options)) { - const entryPath = resolveModuleEntryFromRoot(specifier, rootDir); - if (entryPath && existsSync(entryPath)) { - return { entryPath, rootDir }; - } - } - return null; -} - -export function hasCodexCliBinary(rootDir, options = {}) { - const platform = String(options.platform || process.platform).trim().toLowerCase(); - const arch = String(options.arch || process.arch).trim().toLowerCase(); - const platformEntry = CODEX_PLATFORM_PACKAGE_MAP[`${platform}-${arch}`]; - if (!platformEntry) return true; - const packageRoot = resolve(rootDir, "node_modules", ...platformEntry.packageDir.split("/")); - return existsSync(resolve(packageRoot, platformEntry.binaryPath)); -} - -export function resolveCodexSdkInstall(options = {}) { - for (const rootDir of getAgentSdkModuleRoots(options)) { - const entryPath = resolveModuleEntryFromRoot("@openai/codex-sdk", rootDir); - if (!entryPath || !existsSync(entryPath)) continue; - if (!hasCodexCliBinary(rootDir, options)) continue; - return { entryPath, rootDir }; - } - return null; -} - export function parseAgentSdkConfig(toml) { const agentSection = parseTomlSection(toml, "[agent_sdk]"); const capsSection = parseTomlSection(toml, "[agent_sdk.capabilities]"); diff --git a/agent/agent-supervisor.mjs b/agent/agent-supervisor.mjs index a6831d52a..174a83a8d 100644 --- a/agent/agent-supervisor.mjs +++ b/agent/agent-supervisor.mjs @@ -1,5 +1,3 @@ -import { addSpanEvent, recordIntervention } from "../infra/tracing.mjs"; -import { shouldBlockAgentPushes } from "../infra/guardrails.mjs"; /** * agent-supervisor.mjs — Unified Agent Health Scoring & Intervention Engine * @@ -30,6 +28,9 @@ import { shouldBlockAgentPushes } from "../infra/guardrails.mjs"; * * @module agent-supervisor */ + +import { addSpanEvent, recordIntervention } from "../infra/tracing.mjs"; + const TAG = "[agent-supervisor]"; const API_ERROR_CONTINUE_COOLDOWNS_MS = Object.freeze([ 3 * 60_000, @@ -38,15 +39,6 @@ const API_ERROR_CONTINUE_COOLDOWNS_MS = Object.freeze([ ]); const API_ERROR_RECOVERY_RESET_MS = 15 * 60_000; -function workflowOwnsPushLifecycle(context = {}) { - const repoRoot = String(context.repoRoot || context.worktreePath || process.cwd()).trim(); - try { - return shouldBlockAgentPushes(repoRoot); - } catch { - return true; - } -} - // ── Situation Types (30+ edge cases) ──────────────────────────────────────── /** @@ -184,7 +176,7 @@ const RECOVERY_PROMPTS = { [SITUATION.PLAN_STUCK]: (ctx) => `CRITICAL: You created a plan for "${ctx.taskTitle}" but stopped before implementing. ` + `This is autonomous execution — NO ONE will respond to "ready to implement?" questions. ` + - `IMPLEMENT NOW: edit files, run tests, commit with conventional commits, and hand off for workflow push. ` + + `IMPLEMENT NOW: edit files, run tests, commit with conventional commits, and push. ` + `Do NOT create another plan. Do NOT ask for permission. Start coding immediately.`, [SITUATION.FALSE_COMPLETION]: (ctx) => @@ -193,21 +185,19 @@ const RECOVERY_PROMPTS = { `1. Make the actual code changes (edit files)\n` + `2. Run tests: go test ./...\n` + `3. Commit: git add -A && git commit -s -m "feat(scope): description"\n` + - `4. Stop after local validation and mark the run ready for Bosun-managed workflow push handoff\n` + + `4. Push: git push --set-upstream origin ${ctx.branch || ""}\n` + `Verify each step succeeded before claiming completion.`, [SITUATION.NO_COMMITS]: (ctx) => `Task "${ctx.taskTitle}" completed ${ctx.attemptCount || 0} time(s) with zero commits. ` + `Check existing progress: git log --oneline -5 && git status\n` + - `If changes exist but aren't committed, commit them and prepare workflow handoff.\n` + + `If changes exist but aren't committed, commit and push them.\n` + `If no changes exist, implement the task requirements fully before completing.`, [SITUATION.COMMITS_NOT_PUSHED]: (ctx) => - `You made commits for "${ctx.taskTitle}" and direct agent pushes are disabled.\n` + - `Do NOT run git push. Instead:\n` + - `1. Run the local validation expected by the repository, including the pre-push quality gate\n` + - `2. Resolve any failures locally\n` + - `3. Mark the run ready for Bosun-managed workflow push and PR lifecycle handoff.`, + `You made commits for "${ctx.taskTitle}" but never pushed them. Run:\n` + + `git push --set-upstream origin ${ctx.branch || "$(git branch --show-current)"}\n` + + `If push fails due to pre-push hooks, fix the issues and push again.`, [SITUATION.PR_NOT_CREATED]: (ctx) => `You pushed commits for "${ctx.taskTitle}" but no PR is visible yet.\n` + @@ -460,7 +450,7 @@ export class AgentSupervisor { assess(taskId, context = {}) { const state = this._ensureTaskState(taskId); const signals = this._gatherSignals(taskId, context); - const situation = this._diagnose(signals, context) ?? SITUATION.HEALTHY; + const situation = this._diagnose(signals, context); const healthScore = this._computeHealthScore(signals); const recoveryOverride = this._selectRecoveryIntervention(taskId, situation, context, state); const attemptIndex = Math.min( @@ -607,52 +597,11 @@ export class AgentSupervisor { case INTERVENTION.DISPATCH_FIX: { const state = this._getTaskState(taskId); - const issueCount = Array.isArray(state?.reviewIssues) - ? state.reviewIssues.length - : 0; - let dispatchResult = null; if (this._dispatchFixTask && state?.reviewIssues?.length) { - dispatchResult = this._dispatchFixTask(taskId, state.reviewIssues); - if (!dispatchResult || typeof dispatchResult !== "object") { - dispatchResult = { - dispatched: true, - mode: "dispatch_fix_task", - issueCount, - }; - } + this._dispatchFixTask(taskId, state.reviewIssues); } else if (this._injectPrompt && prompt) { // Fallback: inject fix prompt into current session this._injectPrompt(taskId, prompt); - dispatchResult = { - dispatched: true, - mode: "inject_prompt", - issueCount, - }; - } - if (dispatchResult?.dispatched && this._sendTelegram) { - const task = this._resolveTask(taskId); - const title = task?.title || taskId; - const modeLabel = - dispatchResult.mode === "active_session" - ? "active session" - : dispatchResult.mode === "redispatch" - ? "new remediation session" - : dispatchResult.mode === "inject_prompt" - ? "prompt injection" - : "review remediation"; - const message = [ - ":construction: Review follow-up started", - `Task: ${title}`, - "Summary: Bosun is implementing the requested review changes.", - issueCount ? `Issues: ${issueCount}` : "", - `Mode: ${modeLabel}`, - ] - .filter(Boolean) - .join("\n"); - this._sendTelegram(message, { - dedupKey: `review-fix-start|${taskId}|${dispatchResult.mode || "unknown"}|${issueCount}`, - exactDedup: true, - }); } break; } @@ -1282,7 +1231,6 @@ export class AgentSupervisor { if (context.hasCommits && !context.prUrl && !context.prNumber) { // Has commits but no PR const isPushed = context.isPushed ?? true; // assume pushed unless told otherwise - if (!isPushed && workflowOwnsPushLifecycle(context)) return null; if (!isPushed) return SITUATION.COMMITS_NOT_PUSHED; return SITUATION.PR_NOT_CREATED; } diff --git a/agent/agent-tool-config.mjs b/agent/agent-tool-config.mjs index d440f06dd..888f041c1 100644 --- a/agent/agent-tool-config.mjs +++ b/agent/agent-tool-config.mjs @@ -17,16 +17,6 @@ * "defaults": { * "builtinTools": [...], // default tool list for all agents * "updatedAt": "..." - * }, - * "toolOverhead": { - * "": { - * "total": 12345, // total serialized chars across tool defs - * "bySource": { - * "builtin": 3456, - * "github": 8889 - * }, - * "updatedAt": "2026-01-01T00:00:00.000Z" - * } * } * } * @@ -38,12 +28,10 @@ * setAgentToolConfig(rootDir, agentId, config) — update config for one agent * getEffectiveTools(rootDir, agentId) — compute final enabled tools list * listAvailableTools(rootDir) — list all available tools (builtin + MCP) - * measureToolDefinitionChars(toolDefs) — char counts for serialized tool defs - * getToolOverheadReport(rootDir, agentId) — persisted/runtime overhead summary */ import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs"; -import { basename, resolve } from "node:path"; +import { resolve } from "node:path"; import { homedir } from "node:os"; // ── Constants ───────────────────────────────────────────────────────────────── @@ -63,36 +51,6 @@ function getBosunHome() { * Default built-in tools available to all voice agents and executors. * Maps to common capabilities that voice/agent sessions can invoke. */ -function measureToolDefinitionCharsInternal(toolDefs = []) { - const tools = Array.isArray(toolDefs) - ? toolDefs.map((toolDef, index) => { - const serialized = JSON.stringify(toolDef ?? null); - const fallbackId = `tool-${index + 1}`; - return { - id: String(toolDef?.id || toolDef?.name || toolDef?.tool_name || fallbackId), - chars: serialized.length, - }; - }) - : []; - - return { - total: tools.reduce((sum, tool) => sum + tool.chars, 0), - tools, - }; -} - -export function measureToolDefinitionChars(toolDefs = []) { - return measureToolDefinitionCharsInternal(toolDefs); -} - -function normalizeSourceCharMap(bySource = {}) { - return Object.fromEntries( - Object.entries(bySource) - .map(([source, chars]) => [String(source), Math.max(0, Number(chars) || 0)]) - .sort((left, right) => right[1] - left[1] || left[0].localeCompare(right[0])), - ); -} - export const DEFAULT_BUILTIN_TOOLS = Object.freeze([ { id: "search-files", @@ -219,11 +177,7 @@ export const DEFAULT_BUILTIN_TOOLS = Object.freeze([ // ── Config File I/O ─────────────────────────────────────────────────────────── function getConfigPath(rootDir) { - const baseDir = rootDir || getBosunHome(); - const configDir = basename(resolve(baseDir)) === ".bosun" - ? resolve(baseDir) - : resolve(baseDir, ".bosun"); - return resolve(configDir, CONFIG_FILE); + return resolve(rootDir || getBosunHome(), ".bosun", CONFIG_FILE); } /** @@ -240,7 +194,6 @@ export function loadToolConfig(rootDir) { builtinTools: DEFAULT_BUILTIN_TOOLS.filter((t) => t.default).map((t) => t.id), updatedAt: new Date().toISOString(), }, - toolOverhead: {}, }; } try { @@ -252,7 +205,6 @@ export function loadToolConfig(rootDir) { builtinTools: DEFAULT_BUILTIN_TOOLS.filter((t) => t.default).map((t) => t.id), updatedAt: new Date().toISOString(), }, - toolOverhead: parsed.toolOverhead || {}, }; } catch { return { @@ -261,7 +213,6 @@ export function loadToolConfig(rootDir) { builtinTools: DEFAULT_BUILTIN_TOOLS.filter((t) => t.default).map((t) => t.id), updatedAt: new Date().toISOString(), }, - toolOverhead: {}, }; } } @@ -269,7 +220,7 @@ export function loadToolConfig(rootDir) { /** * Save the full tool configuration. * @param {string} rootDir - * @param {{ agents: Object, defaults: Object, toolOverhead?: Object }} config + * @param {{ agents: Object, defaults: Object }} config */ export function saveToolConfig(rootDir, config) { const configPath = getConfigPath(rootDir); @@ -385,66 +336,3 @@ export async function listAvailableTools(rootDir) { })), }; } - -function persistToolOverheadReport(rootDir, agentId, report) { - if (!rootDir || !agentId || !report) return report; - const cfg = loadToolConfig(rootDir); - cfg.toolOverhead ||= {}; - cfg.toolOverhead[agentId] = { - total: Math.max(0, Number(report.total) || 0), - bySource: normalizeSourceCharMap(report.bySource), - updatedAt: new Date().toISOString(), - }; - saveToolConfig(rootDir, cfg); - return cfg.toolOverhead[agentId]; -} - -export function getToolOverheadReport(rootDir, agentId) { - const cfg = loadToolConfig(rootDir); - const stored = cfg.toolOverhead?.[agentId] || null; - if (!stored) return { total: 0, bySource: {} }; - return { - total: Math.max(0, Number(stored.total) || 0), - bySource: normalizeSourceCharMap(stored.bySource), - }; -} - -export async function refreshToolOverheadReport(rootDir, agentId, options = {}) { - const builtinMeasurement = measureToolDefinitionChars(DEFAULT_BUILTIN_TOOLS); - const report = { - total: builtinMeasurement.total, - bySource: { builtin: builtinMeasurement.total }, - }; - - const agentConfig = agentId ? getAgentToolConfig(rootDir, agentId) : { enabledMcpServers: [] }; - const enabledServerIds = Array.isArray(options.serverIds) - ? options.serverIds - : Array.isArray(agentConfig.enabledMcpServers) - ? agentConfig.enabledMcpServers - : []; - - if (enabledServerIds.length > 0) { - try { - const { resolveMcpServersForAgent } = await import("../workflow/mcp-registry.mjs"); - const servers = await resolveMcpServersForAgent(rootDir, enabledServerIds); - for (const server of servers) { - const serverDefs = Array.isArray(server?.tools) ? server.tools : []; - const measurement = measureToolDefinitionChars(serverDefs); - report.bySource[server.id || server.name || "unknown-mcp"] = measurement.total; - report.total += measurement.total; - } - } catch { - for (const serverId of enabledServerIds) report.bySource[serverId] ||= 0; - } - } - - const persisted = persistToolOverheadReport(rootDir, agentId, report); - if (process.env.BOSUN_LOG_TOOL_OVERHEAD === "1") { - console.log(TAG + " tool definition overhead for " + (agentId || "agent") + ":"); - for (const [source, chars] of Object.entries(persisted.bySource)) { - console.log(TAG + " " + source + ": " + chars + " chars"); - } - console.log(TAG + " total: " + persisted.total + " chars"); - } - return persisted; -} diff --git a/agent/autofix.mjs b/agent/autofix.mjs index 101276fd6..0158a08cd 100644 --- a/agent/autofix.mjs +++ b/agent/autofix.mjs @@ -585,7 +585,6 @@ export function runCodexExec( child = spawn(codexBin, args, { ...spawnOptions, shell: false, - windowsHide: true, }); } catch (err) { return promiseResolve({ diff --git a/agent/bosun-skills.mjs b/agent/bosun-skills.mjs index 36e35c9bf..027bd8a23 100644 --- a/agent/bosun-skills.mjs +++ b/agent/bosun-skills.mjs @@ -1,3 +1,4 @@ +#!/usr/bin/env node /** * bosun-skills — Agent Skills Knowledge-Base * diff --git a/agent/hook-library.mjs b/agent/hook-library.mjs index 34416277b..5b816177a 100644 --- a/agent/hook-library.mjs +++ b/agent/hook-library.mjs @@ -204,7 +204,7 @@ const BUILTIN_HOOKS = [ events: "PostToolUse", command: shellCmd( `bash -c 'mkdir -p .bosun && echo "{\\"ts\\":$(date +%s),\\"sdk\\":\\"$VE_SDK\\",\\"task\\":\\"$VE_TASK_ID\\"}" > .bosun/session-heartbeat.json'`, - `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; @{ts=[int](Get-Date -UFormat %s);sdk=$env:VE_SDK;task=$env:VE_TASK_ID} | ConvertTo-Json | Set-Content -Encoding UTF8 .bosun/session-heartbeat.json"`, + `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; @{ts=[int](Get-Date -UFormat %s);sdk=$env:VE_SDK;task=$env:VE_TASK_ID} | ConvertTo-Json | Set-Content .bosun/session-heartbeat.json"`, ), blocking: false, timeout: 5_000, @@ -224,7 +224,7 @@ const BUILTIN_HOOKS = [ events: "SessionStart", command: shellCmd( `bash -c 'mkdir -p .bosun && echo "{\\"started\\":$(date +%s),\\"sdk\\":\\"$VE_SDK\\",\\"task\\":\\"$VE_TASK_ID\\",\\"branch\\":\\"$VE_BRANCH_NAME\\",\\"status\\":\\"active\\"}" > .bosun/session-state.json'`, - `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; @{started=[int](Get-Date -UFormat %s);sdk=$env:VE_SDK;task=$env:VE_TASK_ID;branch=$env:VE_BRANCH_NAME;status='active'} | ConvertTo-Json | Set-Content -Encoding UTF8 .bosun/session-state.json"`, + `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; @{started=[int](Get-Date -UFormat %s);sdk=$env:VE_SDK;task=$env:VE_TASK_ID;branch=$env:VE_BRANCH_NAME;status='active'} | ConvertTo-Json | Set-Content .bosun/session-state.json"`, ), blocking: false, timeout: 5_000, @@ -245,7 +245,7 @@ const BUILTIN_HOOKS = [ events: "SessionStop", command: shellCmd( `bash -c 'if [ -f .bosun/session-state.json ]; then TMP=$(cat .bosun/session-state.json); echo "$TMP" | sed "s/\\"status\\":\\"active\\"/\\"status\\":\\"completed\\"/" > .bosun/session-state.json; fi'`, - `powershell -NoProfile -Command "if (Test-Path .bosun/session-state.json) { $j = Get-Content .bosun/session-state.json | ConvertFrom-Json; $j.status = 'completed'; $j | ConvertTo-Json | Set-Content -Encoding UTF8 .bosun/session-state.json }"`, + `powershell -NoProfile -Command "if (Test-Path .bosun/session-state.json) { $j = Get-Content .bosun/session-state.json | ConvertFrom-Json; $j.status = 'completed'; $j | ConvertTo-Json | Set-Content .bosun/session-state.json }"`, ), blocking: false, timeout: 5_000, @@ -266,7 +266,7 @@ const BUILTIN_HOOKS = [ events: "PostToolUse", command: shellCmd( `bash -c 'mkdir -p .bosun && echo "{\\"ts\\":$(date +%s),\\"tool\\":\\"$VE_HOOK_TOOL_NAME\\",\\"sdk\\":\\"$VE_SDK\\",\\"task\\":\\"$VE_TASK_ID\\"}" >> .bosun/tool-activity.jsonl'`, - `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; @{ts=[int](Get-Date -UFormat %s);tool=$env:VE_HOOK_TOOL_NAME;sdk=$env:VE_SDK;task=$env:VE_TASK_ID} | ConvertTo-Json -Compress | Add-Content -Encoding UTF8 .bosun/tool-activity.jsonl"`, + `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; @{ts=[int](Get-Date -UFormat %s);tool=$env:VE_HOOK_TOOL_NAME;sdk=$env:VE_SDK;task=$env:VE_TASK_ID} | ConvertTo-Json -Compress | Add-Content .bosun/tool-activity.jsonl"`, ), blocking: false, timeout: 3_000, @@ -307,7 +307,7 @@ const BUILTIN_HOOKS = [ events: "TaskComplete", command: shellCmd( `bash -c 'mkdir -p .bosun && echo "{\\"task\\":\\"$VE_TASK_ID\\",\\"status\\":\\"completed\\",\\"ts\\":$(date +%s),\\"branch\\":\\"$VE_BRANCH_NAME\\"}" > .bosun/task-result.json && echo "OK: task result recorded"'`, - `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; @{task=$env:VE_TASK_ID;status='completed';ts=[int](Get-Date -UFormat %s);branch=$env:VE_BRANCH_NAME} | ConvertTo-Json | Set-Content -Encoding UTF8 .bosun/task-result.json; Write-Host 'OK: task result recorded'"`, + `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; @{task=$env:VE_TASK_ID;status='completed';ts=[int](Get-Date -UFormat %s);branch=$env:VE_BRANCH_NAME} | ConvertTo-Json | Set-Content .bosun/task-result.json; Write-Host 'OK: task result recorded'"`, ), blocking: false, timeout: 5_000, @@ -362,25 +362,6 @@ const BUILTIN_HOOKS = [ tags: ["safety", "git", "branch-protection", "blocking"], }, - { - id: "safety-block-agent-direct-push", - name: "Block Agent Direct Push", - description: "Prevents agents from running git push directly when Bosun guardrails require workflow-owned push handoff.", - category: "safety", - events: "PreToolUse", - command: shellCmd( - `bash -c 'CMD="$VE_HOOK_COMMAND"; if echo "$CMD" | grep -qiE "git\\s+push\\b"; then node -e "const fs=require(\"fs\");const path=require(\"path\");let block=true;try{const policyPath=path.join(process.cwd(),\".bosun\",\"guardrails.json\");if(fs.existsSync(policyPath)){const policy=JSON.parse(fs.readFileSync(policyPath,\"utf8\"));block=policy?.push?.blockAgentPushes!==false;}}catch{} if(block){console.error(\"BLOCKED: Direct agent pushes are disabled. Commit your changes and let Bosun workflow automation perform the validated push.\");process.exit(1);}"; fi'`, - `powershell -NoProfile -Command "if ($env:VE_HOOK_COMMAND -match 'git\\s+push\\b') { node -e 'const fs=require(\"fs\");const path=require(\"path\");let block=true;try{const policyPath=path.join(process.cwd(),\".bosun\",\"guardrails.json\");if(fs.existsSync(policyPath)){const policy=JSON.parse(fs.readFileSync(policyPath,\"utf8\"));block=policy?.push?.blockAgentPushes!==false;}}catch{} if(block){console.error(\"BLOCKED: Direct agent pushes are disabled. Commit your changes and let Bosun workflow automation perform the validated push.\");process.exit(1);}' ; if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE } }"`, - ), - blocking: true, - timeout: 5_000, - sdks: ["*"], - core: false, - defaultEnabled: true, - retryable: false, - tags: ["safety", "git", "push", "workflow-only", "blocking"], - }, - { id: "safety-block-destructive-commands", name: "Block Destructive Commands", @@ -609,7 +590,7 @@ const BUILTIN_HOOKS = [ events: "SessionStart", command: shellCmd( `bash -c 'mkdir -p .bosun && echo "{\\"event\\":\\"session_start\\",\\"ts\\":$(date +%s),\\"sdk\\":\\"$VE_SDK\\",\\"task\\":\\"$VE_TASK_ID\\",\\"branch\\":\\"$VE_BRANCH_NAME\\"}" >> .bosun/audit.jsonl'`, - `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; @{event='session_start';ts=[int](Get-Date -UFormat %s);sdk=$env:VE_SDK;task=$env:VE_TASK_ID;branch=$env:VE_BRANCH_NAME} | ConvertTo-Json -Compress | Add-Content -Encoding UTF8 .bosun/audit.jsonl"`, + `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; @{event='session_start';ts=[int](Get-Date -UFormat %s);sdk=$env:VE_SDK;task=$env:VE_TASK_ID;branch=$env:VE_BRANCH_NAME} | ConvertTo-Json -Compress | Add-Content .bosun/audit.jsonl"`, ), blocking: false, timeout: 5_000, @@ -628,7 +609,7 @@ const BUILTIN_HOOKS = [ events: "SessionStop", command: shellCmd( `bash -c 'mkdir -p .bosun && echo "{\\"event\\":\\"session_stop\\",\\"ts\\":$(date +%s),\\"sdk\\":\\"$VE_SDK\\",\\"task\\":\\"$VE_TASK_ID\\"}" >> .bosun/audit.jsonl'`, - `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; @{event='session_stop';ts=[int](Get-Date -UFormat %s);sdk=$env:VE_SDK;task=$env:VE_TASK_ID} | ConvertTo-Json -Compress | Add-Content -Encoding UTF8 .bosun/audit.jsonl"`, + `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; @{event='session_stop';ts=[int](Get-Date -UFormat %s);sdk=$env:VE_SDK;task=$env:VE_TASK_ID} | ConvertTo-Json -Compress | Add-Content .bosun/audit.jsonl"`, ), blocking: false, timeout: 5_000, @@ -647,7 +628,7 @@ const BUILTIN_HOOKS = [ events: "PreToolUse", command: shellCmd( `bash -c 'if [ -f .bosun/session-heartbeat.json ]; then LAST=$(cat .bosun/session-heartbeat.json | grep -o "\\"ts\\":[0-9]*" | grep -o "[0-9]*"); NOW=$(date +%s); DIFF=$((NOW - LAST)); if [ "$DIFF" -gt 300 ]; then echo "{\\"event\\":\\"idle_detected\\",\\"idle_seconds\\":$DIFF,\\"ts\\":$NOW}" >> .bosun/audit.jsonl; echo "WARNING: Agent idle for \${DIFF}s" >&2; fi; fi'`, - `powershell -NoProfile -Command "if (Test-Path .bosun/session-heartbeat.json) { $j = Get-Content .bosun/session-heartbeat.json | ConvertFrom-Json; $diff = [int](Get-Date -UFormat %s) - $j.ts; if ($diff -gt 300) { @{event='idle_detected';idle_seconds=$diff;ts=[int](Get-Date -UFormat %s)} | ConvertTo-Json -Compress | Add-Content -Encoding UTF8 .bosun/audit.jsonl; Write-Warning \\"Agent idle for \${diff}s\\" } }"`, + `powershell -NoProfile -Command "if (Test-Path .bosun/session-heartbeat.json) { $j = Get-Content .bosun/session-heartbeat.json | ConvertFrom-Json; $diff = [int](Get-Date -UFormat %s) - $j.ts; if ($diff -gt 300) { @{event='idle_detected';idle_seconds=$diff;ts=[int](Get-Date -UFormat %s)} | ConvertTo-Json -Compress | Add-Content .bosun/audit.jsonl; Write-Warning \\"Agent idle for \${diff}s\\" } }"`, ), blocking: false, timeout: 5_000, @@ -666,7 +647,7 @@ const BUILTIN_HOOKS = [ events: ["SessionStart", "SessionStop"], command: shellCmd( `bash -c 'mkdir -p .bosun && git diff --stat HEAD > .bosun/git-status-snapshot.txt 2>/dev/null && echo "OK: git snapshot saved"'`, - `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; git diff --stat HEAD 2>$null | Set-Content -Encoding UTF8 .bosun/git-status-snapshot.txt; Write-Host 'OK: git snapshot saved'"`, + `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; git diff --stat HEAD 2>$null | Set-Content .bosun/git-status-snapshot.txt; Write-Host 'OK: git snapshot saved'"`, ), blocking: false, timeout: 10_000, @@ -685,7 +666,7 @@ const BUILTIN_HOOKS = [ events: "PostCommit", command: shellCmd( `bash -c 'mkdir -p .bosun; F=.bosun/session-metrics.json; if [ -f "$F" ]; then N=$(cat "$F" | grep -o "\\"commits\\":[0-9]*" | grep -o "[0-9]*" || echo 0); else N=0; fi; N=$((N + 1)); echo "{\\"commits\\":$N,\\"last_commit_ts\\":$(date +%s)}" > "$F"'`, - `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; $f = '.bosun/session-metrics.json'; $n = 0; if (Test-Path $f) { try { $n = (Get-Content $f | ConvertFrom-Json).commits } catch {} }; $n++; @{commits=$n;last_commit_ts=[int](Get-Date -UFormat %s)} | ConvertTo-Json | Set-Content -Encoding UTF8 $f"`, + `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; $f = '.bosun/session-metrics.json'; $n = 0; if (Test-Path $f) { try { $n = (Get-Content $f | ConvertFrom-Json).commits } catch {} }; $n++; @{commits=$n;last_commit_ts=[int](Get-Date -UFormat %s)} | ConvertTo-Json | Set-Content $f"`, ), blocking: false, timeout: 5_000, @@ -708,7 +689,7 @@ const BUILTIN_HOOKS = [ events: "PostToolUse", command: shellCmd( `bash -c 'mkdir -p .bosun && CMD="$VE_HOOK_COMMAND"; FILES=$(echo "$CMD" | grep -oE "[a-zA-Z0-9_./-]+\\.(js|mjs|ts|tsx|py|go|rs|java|rb|md|json|yaml|yml|toml)" | head -5 | tr "\\n" ","); if [ -n "$FILES" ]; then echo "{\\"ts\\":$(date +%s),\\"files\\":\\"$FILES\\",\\"tool\\":\\"$VE_HOOK_TOOL_NAME\\"}" >> .bosun/file-access.jsonl; fi'`, - `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; $files = [regex]::Matches($env:VE_HOOK_COMMAND, '[a-zA-Z0-9_.\\\\/-]+\\.(js|mjs|ts|tsx|py|go|rs|java|rb|md|json|yaml|yml|toml)') | Select-Object -First 5 -ExpandProperty Value; if ($files) { @{ts=[int](Get-Date -UFormat %s);files=($files -join ',');tool=$env:VE_HOOK_TOOL_NAME} | ConvertTo-Json -Compress | Add-Content -Encoding UTF8 .bosun/file-access.jsonl }"`, + `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; $files = [regex]::Matches($env:VE_HOOK_COMMAND, '[a-zA-Z0-9_.\\\\/-]+\\.(js|mjs|ts|tsx|py|go|rs|java|rb|md|json|yaml|yml|toml)') | Select-Object -First 5 -ExpandProperty Value; if ($files) { @{ts=[int](Get-Date -UFormat %s);files=($files -join ',');tool=$env:VE_HOOK_TOOL_NAME} | ConvertTo-Json -Compress | Add-Content .bosun/file-access.jsonl }"`, ), blocking: false, timeout: 3_000, @@ -727,7 +708,7 @@ const BUILTIN_HOOKS = [ events: "SessionStart", command: shellCmd( `bash -c 'mkdir -p .bosun && echo "{\\"modified\\":$(git diff --name-only 2>/dev/null | wc -l),\\"staged\\":$(git diff --cached --name-only 2>/dev/null | wc -l),\\"recent_commits\\":[$(git log --oneline -5 --format="\\\"%h: %s\\\"" 2>/dev/null | tr "\\n" "," | sed "s/,$//")],\\"branch\\":\\"$(git rev-parse --abbrev-ref HEAD 2>/dev/null)\\"}" > .bosun/working-set.json'`, - `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; $mod = (git diff --name-only 2>$null | Measure-Object).Count; $staged = (git diff --cached --name-only 2>$null | Measure-Object).Count; $commits = git log --oneline -5 2>$null; $branch = git rev-parse --abbrev-ref HEAD 2>$null; @{modified=$mod;staged=$staged;recent_commits=@($commits);branch=$branch} | ConvertTo-Json | Set-Content -Encoding UTF8 .bosun/working-set.json"`, + `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; $mod = (git diff --name-only 2>$null | Measure-Object).Count; $staged = (git diff --cached --name-only 2>$null | Measure-Object).Count; $commits = git log --oneline -5 2>$null; $branch = git rev-parse --abbrev-ref HEAD 2>$null; @{modified=$mod;staged=$staged;recent_commits=@($commits);branch=$branch} | ConvertTo-Json | Set-Content .bosun/working-set.json"`, ), blocking: false, timeout: 10_000, @@ -950,7 +931,7 @@ const BUILTIN_HOOKS = [ events: "TaskComplete", command: shellCmd( `bash -c 'mkdir -p .bosun && AHEAD=$(git rev-list --count $(git merge-base HEAD origin/main 2>/dev/null || echo HEAD)..HEAD 2>/dev/null || echo 0) && echo "{\\"event\\":\\"task_complete\\",\\"task\\":\\"$VE_TASK_ID\\",\\"commits\\":$AHEAD,\\"ts\\":$(date +%s),\\"branch\\":\\"$VE_BRANCH_NAME\\"}" >> .bosun/completions.jsonl'`, - `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; $mb = git merge-base HEAD origin/main 2>$null; $ahead = if ($mb) { [int](git rev-list --count \"$mb..HEAD\" 2>$null) } else { 0 }; @{event='task_complete';task=$env:VE_TASK_ID;commits=$ahead;ts=[int](Get-Date -UFormat %s);branch=$env:VE_BRANCH_NAME} | ConvertTo-Json -Compress | Add-Content -Encoding UTF8 .bosun/completions.jsonl"`, + `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; $mb = git merge-base HEAD origin/main 2>$null; $ahead = if ($mb) { [int](git rev-list --count \"$mb..HEAD\" 2>$null) } else { 0 }; @{event='task_complete';task=$env:VE_TASK_ID;commits=$ahead;ts=[int](Get-Date -UFormat %s);branch=$env:VE_BRANCH_NAME} | ConvertTo-Json -Compress | Add-Content .bosun/completions.jsonl"`, ), blocking: false, timeout: 10_000, @@ -988,7 +969,7 @@ const BUILTIN_HOOKS = [ events: "PostPR", command: shellCmd( `bash -c 'mkdir -p .bosun && echo "{\\"event\\":\\"pr_created\\",\\"task\\":\\"$VE_TASK_ID\\",\\"branch\\":\\"$VE_BRANCH_NAME\\",\\"ts\\":$(date +%s)}" >> .bosun/audit.jsonl'`, - `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; @{event='pr_created';task=$env:VE_TASK_ID;branch=$env:VE_BRANCH_NAME;ts=[int](Get-Date -UFormat %s)} | ConvertTo-Json -Compress | Add-Content -Encoding UTF8 .bosun/audit.jsonl"`, + `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; @{event='pr_created';task=$env:VE_TASK_ID;branch=$env:VE_BRANCH_NAME;ts=[int](Get-Date -UFormat %s)} | ConvertTo-Json -Compress | Add-Content .bosun/audit.jsonl"`, ), blocking: false, timeout: 5_000, @@ -1011,7 +992,7 @@ const BUILTIN_HOOKS = [ events: ["SessionStart", "SessionStop"], command: shellCmd( `bash -c 'mkdir -p .bosun/events && echo "{\\"event\\":\\"agent.$VE_HOOK_EVENT\\",\\"sdk\\":\\"$VE_SDK\\",\\"task\\":\\"$VE_TASK_ID\\",\\"ts\\":$(date +%s)}" > .bosun/events/$(date +%s)-$VE_HOOK_EVENT.json'`, - `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun/events | Out-Null; $ts = [int](Get-Date -UFormat %s); @{event=\"agent.$($env:VE_HOOK_EVENT)\";sdk=$env:VE_SDK;task=$env:VE_TASK_ID;ts=$ts} | ConvertTo-Json | Set-Content -Encoding UTF8 \".bosun/events/$ts-$($env:VE_HOOK_EVENT).json\""`, + `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun/events | Out-Null; $ts = [int](Get-Date -UFormat %s); @{event=\"agent.$($env:VE_HOOK_EVENT)\";sdk=$env:VE_SDK;task=$env:VE_TASK_ID;ts=$ts} | ConvertTo-Json | Set-Content \".bosun/events/$ts-$($env:VE_HOOK_EVENT).json\""`, ), blocking: false, timeout: 5_000, @@ -1052,7 +1033,7 @@ const BUILTIN_HOOKS = [ events: ["SubagentStart", "SubagentStop"], command: shellCmd( `bash -c 'mkdir -p .bosun && echo "{\\"event\\":\\"$VE_HOOK_EVENT\\",\\"sdk\\":\\"$VE_SDK\\",\\"task\\":\\"$VE_TASK_ID\\",\\"ts\\":$(date +%s)}" >> .bosun/subagent-log.jsonl'`, - `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; @{event=$env:VE_HOOK_EVENT;sdk=$env:VE_SDK;task=$env:VE_TASK_ID;ts=[int](Get-Date -UFormat %s)} | ConvertTo-Json -Compress | Add-Content -Encoding UTF8 .bosun/subagent-log.jsonl"`, + `powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path .bosun | Out-Null; @{event=$env:VE_HOOK_EVENT;sdk=$env:VE_SDK;task=$env:VE_TASK_ID;ts=[int](Get-Date -UFormat %s)} | ConvertTo-Json -Compress | Add-Content .bosun/subagent-log.jsonl"`, ), blocking: false, timeout: 5_000, diff --git a/agent/hook-profiles.mjs b/agent/hook-profiles.mjs index e5c820588..d7bc8d6d7 100644 --- a/agent/hook-profiles.mjs +++ b/agent/hook-profiles.mjs @@ -1,7 +1,6 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs"; import { resolve, dirname, relative } from "node:path"; import { fileURLToPath } from "node:url"; -import { detectProjectStack } from "../workflow/project-detection.mjs"; const __filename = fileURLToPath(import.meta.url); const __dirname = dirname(__filename); @@ -9,7 +8,7 @@ const __dirname = dirname(__filename); const DEFAULT_TIMEOUT_MS = 60_000; const DEFAULT_HOOK_SCHEMA = "https://json-schema.org/draft/2020-12/schema"; const LEGACY_BRIDGE_SNIPPET = "scripts/bosun/agent-hook-bridge.mjs"; -const DEFAULT_BRIDGE_SCRIPT_PATH = "agent/agent-hook-bridge.mjs"; +const DEFAULT_BRIDGE_SCRIPT_PATH = resolve(__dirname, "agent-hook-bridge.mjs"); function getHookNodeBinary() { const configured = String(process.env.BOSUN_HOOK_NODE_BIN || "").trim(); @@ -33,28 +32,24 @@ export const HOOK_PROFILES = Object.freeze([ const PRESET_FLAGS = Object.freeze({ strict: { includeSessionHooks: true, - includePostToolUse: true, includePreCommit: true, includePrePush: true, includeTaskComplete: true, }, balanced: { includeSessionHooks: true, - includePostToolUse: true, includePreCommit: false, includePrePush: true, includeTaskComplete: true, }, lightweight: { includeSessionHooks: true, - includePostToolUse: false, includePreCommit: false, includePrePush: false, includeTaskComplete: false, }, none: { includeSessionHooks: false, - includePostToolUse: false, includePreCommit: false, includePrePush: false, includeTaskComplete: false, @@ -82,43 +77,38 @@ const PRESET_COMMANDS = Object.freeze({ timeout: 10_000, }, ]), - PostToolUse: Object.freeze([ + PrePush: Object.freeze([ { - id: "post-tool-use-validation", - command: "", - description: "Run lightweight repository validation after edit tools complete", - blocking: false, + id: "prepush-go-vet", + command: "go vet ./...", + description: "Run go vet before push", + blocking: true, timeout: 120_000, }, - ]), - TaskComplete: Object.freeze([ { - id: "task-complete-audit", - command: 'echo "[hook] Task completed: ${VE_TASK_ID} — ${VE_TASK_TITLE}"', - description: "Audit log for task completion", - blocking: false, - timeout: 10_000, + id: "prepush-go-build", + command: "go build ./...", + description: "Verify Go build succeeds before push", + blocking: true, + timeout: 300_000, }, ]), -}); - -const PORTABLE_VALIDATION_COMMANDS = Object.freeze({ - PrePush: Object.freeze([ + PreCommit: Object.freeze([ { - id: "prepush-git-diff-check", - command: "git diff --check", - description: "Check tracked changes for whitespace and conflict-marker issues before push", - blocking: true, + id: "precommit-gofmt", + command: "gofmt -l .", + description: "Check Go formatting before commit", + blocking: false, timeout: 30_000, }, ]), - PreCommit: Object.freeze([ + TaskComplete: Object.freeze([ { - id: "precommit-git-staged-diff-check", - command: "git diff --cached --check", - description: "Check staged changes for whitespace and conflict-marker issues before commit", + id: "task-complete-audit", + command: 'echo "[hook] Task completed: ${VE_TASK_ID} — ${VE_TASK_TITLE}"', + description: "Audit log for task completion", blocking: false, - timeout: 30_000, + timeout: 10_000, }, ]), }); @@ -163,8 +153,8 @@ function isPortableNodeCommandToken(token) { } function isPortableBridgeScriptToken(token) { - const raw = String(token || "").trim().replace(/\\/g, "/"); - return raw === DEFAULT_BRIDGE_SCRIPT_PATH || raw === `./${DEFAULT_BRIDGE_SCRIPT_PATH}`; + const raw = String(token || ""); + return raw === DEFAULT_BRIDGE_SCRIPT_PATH || raw === LEGACY_BRIDGE_SNIPPET; } function isCopilotBridgeCommandPortable(commandTokens) { @@ -180,98 +170,6 @@ function deepClone(value) { return JSON.parse(JSON.stringify(value)); } -function slugifyHookId(value) { - return String(value || "") - .trim() - .toLowerCase() - .replace(/[^a-z0-9]+/g, "-") - .replace(/^-+|-+$/g, "") || "hook"; -} - -function createHookEntry({ - id, - command, - description, - blocking = false, - timeout = DEFAULT_TIMEOUT_MS, -}) { - return { - id, - command, - description, - blocking, - timeout, - sdks: ["*"], - }; -} - -function buildDetectedValidationCommands(rootDir) { - const detected = detectProjectStack(rootDir); - const qualityGate = String(detected?.commands?.qualityGate || "").trim(); - const postEdit = String(detected?.commands?.postEdit || "").trim(); - const lint = String(detected?.commands?.lint || "").trim(); - const syntaxCheck = String(detected?.commands?.syntaxCheck || "").trim(); - - return { - PostToolUse: (postEdit || lint || syntaxCheck) - ? [ - createHookEntry({ - id: `posttooluse-detected-${slugifyHookId(postEdit || lint || syntaxCheck)}`, - command: postEdit || lint || syntaxCheck, - description: `Run lightweight repository validation after edits (${detected?.primary?.label || "project"})`, - blocking: false, - timeout: 120_000, - }), - ] - : [], - PrePush: qualityGate - ? [ - createHookEntry({ - id: `prepush-detected-${slugifyHookId(qualityGate)}`, - command: qualityGate, - description: `Run detected repository quality gate before push (${detected?.primary?.label || "project"})`, - blocking: true, - timeout: 300_000, - }), - ] - : [], - PreCommit: (lint || syntaxCheck) - ? [ - createHookEntry({ - id: `precommit-detected-${slugifyHookId(lint || syntaxCheck)}`, - command: lint || syntaxCheck, - description: `Run detected repository validation before commit (${detected?.primary?.label || "project"})`, - blocking: false, - timeout: 120_000, - }), - ] - : [], - }; -} - -function buildDefaultHooksForEvent(event, rootDir) { - const defaults = [ - ...deepClone(PORTABLE_VALIDATION_COMMANDS[event] || []), - ]; - - if (rootDir && existsSync(rootDir)) { - defaults.push(...buildDetectedValidationCommands(rootDir)[event]); - } - - const seen = new Set(); - return defaults - .filter((entry) => { - const command = String(entry?.command || "").trim(); - if (!command || seen.has(command)) return false; - seen.add(command); - return true; - }) - .map((entry) => ({ - ...entry, - sdks: ["*"], - })); -} - function normalizeProfile(profile) { const raw = String(profile || "") .trim() @@ -358,9 +256,6 @@ export function buildHookScaffoldOptionsFromEnv(env = process.env) { SessionStop: normalizeOverrideCommands( env.BOSUN_HOOK_SESSION_STOP, ), - PostToolUse: normalizeOverrideCommands( - env.BOSUN_HOOK_POST_TOOL_USE ?? env.BOSUN_HOOK_POSTEDIT, - ), PrePush: normalizeOverrideCommands(env.BOSUN_HOOK_PREPUSH), PreCommit: normalizeOverrideCommands(env.BOSUN_HOOK_PRECOMMIT), TaskComplete: normalizeOverrideCommands( @@ -374,7 +269,6 @@ export function buildCanonicalHookConfig(options = {}) { const profile = normalizeProfile(options.profile); const flags = { ...PRESET_FLAGS[profile] }; const commandOverrides = options.commands || {}; - const rootDir = options.repoRoot ? resolve(options.repoRoot) : ""; const hooks = {}; @@ -390,14 +284,17 @@ export function buildCanonicalHookConfig(options = {}) { sdks: ["*"], })); } - if (flags.includePostToolUse) { - hooks.PostToolUse = buildDefaultHooksForEvent("PostToolUse", rootDir); - } if (flags.includePrePush) { - hooks.PrePush = buildDefaultHooksForEvent("PrePush", rootDir); + hooks.PrePush = deepClone(PRESET_COMMANDS.PrePush).map((item) => ({ + ...item, + sdks: ["*"], + })); } if (flags.includePreCommit) { - hooks.PreCommit = buildDefaultHooksForEvent("PreCommit", rootDir); + hooks.PreCommit = deepClone(PRESET_COMMANDS.PreCommit).map((item) => ({ + ...item, + sdks: ["*"], + })); } if (flags.includeTaskComplete) { hooks.TaskComplete = deepClone(PRESET_COMMANDS.TaskComplete).map( @@ -411,7 +308,6 @@ export function buildCanonicalHookConfig(options = {}) { for (const event of [ "SessionStart", "SessionStop", - "PostToolUse", "PrePush", "PreCommit", "TaskComplete", @@ -687,10 +583,7 @@ export function scaffoldAgentHookFiles(repoRoot, options = {}) { return result; } - const codexHookConfig = buildCanonicalHookConfig({ - ...options, - repoRoot: root, - }); + const codexHookConfig = buildCanonicalHookConfig(options); result.env = buildDisableEnv(codexHookConfig); if (targets.includes("codex")) { @@ -764,10 +657,10 @@ export function scaffoldAgentHookFiles(repoRoot, options = {}) { const geminiPath = resolve(root, ".gemini", "settings.json"); const geminiConfig = { hooks: { - SessionStart: [{ command: buildShellCommand(makeBridgeCommandTokens("gemini", "SessionStart")) }], - SessionStop: [{ command: buildShellCommand(makeBridgeCommandTokens("gemini", "SessionStop")) }], - PreToolUse: [{ command: buildShellCommand(makeBridgeCommandTokens("gemini", "PreToolUse")) }], - PostToolUse: [{ command: buildShellCommand(makeBridgeCommandTokens("gemini", "PostToolUse")) }], + SessionStart: [{ command: "node agent-hook-bridge.mjs --agent gemini --event SessionStart" }], + SessionStop: [{ command: "node agent-hook-bridge.mjs --agent gemini --event SessionStop" }], + PreToolUse: [{ command: "node agent-hook-bridge.mjs --agent gemini --event PreToolUse" }], + PostToolUse: [{ command: "node agent-hook-bridge.mjs --agent gemini --event PostToolUse" }], }, _bosun: { managed: true, profile: result.profile, generated: new Date().toISOString() }, }; @@ -789,11 +682,11 @@ export function scaffoldAgentHookFiles(repoRoot, options = {}) { const opencodePath = resolve(root, ".opencode", "hooks.json"); const opencodeConfig = { hooks: { - SessionStart: [{ command: buildShellCommand(makeBridgeCommandTokens("opencode", "SessionStart")) }], - SessionStop: [{ command: buildShellCommand(makeBridgeCommandTokens("opencode", "SessionStop")) }], - PreToolUse: [{ command: buildShellCommand(makeBridgeCommandTokens("opencode", "PreToolUse")) }], - PostToolUse: [{ command: buildShellCommand(makeBridgeCommandTokens("opencode", "PostToolUse")) }], - TaskComplete: [{ command: buildShellCommand(makeBridgeCommandTokens("opencode", "TaskComplete")) }], + SessionStart: [{ command: "node agent-hook-bridge.mjs --agent opencode --event SessionStart" }], + SessionStop: [{ command: "node agent-hook-bridge.mjs --agent opencode --event SessionStop" }], + PreToolUse: [{ command: "node agent-hook-bridge.mjs --agent opencode --event PreToolUse" }], + PostToolUse: [{ command: "node agent-hook-bridge.mjs --agent opencode --event PostToolUse" }], + TaskComplete: [{ command: "node agent-hook-bridge.mjs --agent opencode --event TaskComplete" }], }, _bosun: { managed: true, profile: result.profile, generated: new Date().toISOString() }, }; diff --git a/agent/primary-agent.mjs b/agent/primary-agent.mjs index 335a7282b..e0afdbe56 100644 --- a/agent/primary-agent.mjs +++ b/agent/primary-agent.mjs @@ -10,7 +10,7 @@ import { ensureCodexConfig, printConfigSummary } from "../shell/codex-config.mjs import { ensureRepoConfigs, printRepoConfigSummary } from "../config/repo-config.mjs"; import { resolveRepoRoot } from "../config/repo-root.mjs"; import { buildArchitectEditorFrame } from "../lib/repo-map.mjs"; -import { getAgentToolConfig, getEffectiveTools, refreshToolOverheadReport } from "./agent-tool-config.mjs"; +import { getAgentToolConfig, getEffectiveTools } from "./agent-tool-config.mjs"; import { getSessionTracker } from "../infra/session-tracker.mjs"; import { buildContextEnvelope } from "../workspace/context-cache.mjs"; import { getEntry, getEntryContent, resolveAgentProfileLibraryMetadata } from "../infra/library-manager.mjs"; @@ -69,25 +69,6 @@ import { } from "../shell/gemini-shell.mjs"; import { getModelsForExecutor, normalizeExecutorKey } from "../task/task-complexity.mjs"; -const toolOverheadRefreshCache = new Map(); - -function scheduleToolOverheadRefresh(rootDir, agentProfileId, enabledMcpServers = []) { - if (!agentProfileId) return; - const normalizedServerIds = Array.from(new Set( - enabledMcpServers.map((id) => String(id || "").trim()).filter(Boolean), - )).sort(); - const cacheKey = [rootDir, agentProfileId].join("::"); - const signature = JSON.stringify(normalizedServerIds); - const cached = toolOverheadRefreshCache.get(cacheKey); - if (cached?.signature === signature) return; - const promise = refreshToolOverheadReport(rootDir, agentProfileId, { serverIds: normalizedServerIds }) - .catch((error) => { - toolOverheadRefreshCache.delete(cacheKey); - console.warn("[primary-agent] failed to refresh tool overhead report:", error?.message || error); - }); - toolOverheadRefreshCache.set(cacheKey, { signature, promise }); -} - /** Valid agent interaction modes */ const CORE_MODES = ["ask", "agent", "plan", "web", "instant"]; /** Custom modes loaded from library */ @@ -253,9 +234,6 @@ function buildPrimaryToolCapabilityContract(options = {}) { const enabledMcpServers = Array.isArray(rawCfg?.enabledMcpServers) ? rawCfg.enabledMcpServers.map((id) => String(id || "").trim()).filter(Boolean) : []; - if (agentProfileId) { - scheduleToolOverheadRefresh(rootDir, agentProfileId, enabledMcpServers); - } const manifest = { agentProfileId: agentProfileId || null, enabledBuiltinTools, @@ -1040,17 +1018,6 @@ export async function execPrimaryPrompt(userMessage, options = {}) { : userMessage; const architectEditorFrame = buildArchitectEditorFrame(options, effectiveMode); const toolContract = buildPrimaryToolCapabilityContract(options); - const selectedAgentToolConfig = options.agentProfileId - ? getAgentToolConfig(rootDir, options.agentProfileId) - : null; - const selectedMcpServers = Array.isArray(selectedAgentToolConfig?.enabledMcpServers) - ? selectedAgentToolConfig.enabledMcpServers - .map((id) => String(id || "").trim()) - .filter(Boolean) - : []; - const selectedMcpServerSelection = selectedAgentToolConfig - ? selectedMcpServers - : undefined; const messageWithToolContract = [selectedProfile.block, architectEditorFrame, toolContract, messageWithAttachments] .filter(Boolean) .join("\n\n"); @@ -1074,7 +1041,6 @@ export async function execPrimaryPrompt(userMessage, options = {}) { cwd: options.cwd, model: effectiveModel, sdk: mapAdapterToPoolSdk(activeAdapter.name), - mcpServers: selectedMcpServerSelection, sessionType, }); const pooledText = @@ -1163,13 +1129,7 @@ export async function execPrimaryPrompt(userMessage, options = {}) { } } const result = await withTimeout( - adapter.exec(framedMessage, { - ...options, - sessionId, - model: effectiveModel, - abortController: timeoutAbort, - mcpServers: selectedMcpServerSelection, - }), + adapter.exec(framedMessage, { ...options, sessionId, model: effectiveModel, abortController: timeoutAbort }), timeoutMs, `${adapterName}.exec`, timeoutAbort, @@ -1238,13 +1198,7 @@ export async function execPrimaryPrompt(userMessage, options = {}) { } } const retryResult = await withTimeout( - adapter.exec(framedMessage, { - ...options, - sessionId, - model: effectiveModel, - abortController: timeoutAbort, - mcpServers: selectedMcpServerSelection, - }), + adapter.exec(framedMessage, { ...options, sessionId, model: effectiveModel, abortController: timeoutAbort }), timeoutMs, `${adapterName}.exec.retry`, timeoutAbort, @@ -1553,3 +1507,5 @@ export async function execSdkCommand(command, args = "", adapterName, options = } + + diff --git a/agent/review-agent.mjs b/agent/review-agent.mjs index 6104ac605..fb4a37fb2 100644 --- a/agent/review-agent.mjs +++ b/agent/review-agent.mjs @@ -24,44 +24,6 @@ const DEFAULT_REVIEW_TIMEOUT_MS = 5 * 60 * 1000; /** Default max concurrent reviews. */ const DEFAULT_MAX_CONCURRENT = 2; -function normalizeReviewDedupFragment(value) { - return String(value || "") - .trim() - .replaceAll(/\s+/g, " ") - .slice(0, 240); -} - -function buildReviewNotificationDedupKey(taskId, result) { - const issues = Array.isArray(result?.issues) ? result.issues : []; - const issueFingerprint = issues - .map((issue) => ({ - severity: normalizeReviewDedupFragment(issue?.severity), - category: normalizeReviewDedupFragment(issue?.category), - file: normalizeReviewDedupFragment(issue?.file), - line: Number.isFinite(Number(issue?.line)) ? Number(issue.line) : "", - })) - .sort((left, right) => - `${left.file}:${left.line}:${left.category}:${left.severity}`.localeCompare( - `${right.file}:${right.line}:${right.category}:${right.severity}`, - ), - ) - .map((issue) => - [ - issue.severity, - issue.category, - issue.file, - issue.line, - ].join(":"), - ) - .join("|"); - return [ - "review", - normalizeReviewDedupFragment(taskId), - result?.approved ? "approved" : "changes_requested", - issueFingerprint, - ].join("|"); -} - // --------------------------------------------------------------------------- // Review Prompt // --------------------------------------------------------------------------- @@ -664,23 +626,7 @@ export class ReviewAgent { .join("\n"); try { - this.#sendTelegram(message, { - dedupKey: buildReviewNotificationDedupKey(taskId, result), - exactDedup: true, - }); - } catch { - /* best effort */ - } - } - - // Send Telegram for approved reviews - if (result.approved && typeof this.#sendTelegram === "function") { - const message = `:check: Review: approved\nTask: ${taskId}\nSummary: ${result.summary || "No critical issues found"}`; - try { - this.#sendTelegram(message, { - dedupKey: buildReviewNotificationDedupKey(taskId, result), - exactDedup: true, - }); + this.#sendTelegram(message); } catch { /* best effort */ } diff --git a/bench/eval-framework.mjs b/bench/eval-framework.mjs deleted file mode 100644 index d2c314576..000000000 --- a/bench/eval-framework.mjs +++ /dev/null @@ -1,783 +0,0 @@ -import { mkdirSync, readFileSync, writeFileSync, readdirSync, existsSync } from "node:fs"; -import { basename, resolve } from "node:path"; -import { randomUUID } from "node:crypto"; - -const TASK_TYPES = Object.freeze([ - "code-generation", - "bug-fix", - "refactor", - "test-writing", - "code-review", -]); - -const BUILTIN_TASK_METRICS = Object.freeze({ - "code-generation": ["TaskSuccess", "TokenEfficiency", "TimeToComplete", "ContextUtilization"], - "bug-fix": ["TaskSuccess", "TokenEfficiency", "TimeToComplete", "TestPassRate"], - refactor: ["TaskSuccess", "TokenEfficiency", "TimeToComplete", "FalsePositiveRate"], - "test-writing": ["TaskSuccess", "TokenEfficiency", "TimeToComplete", "TestPassRate"], - "code-review": ["TaskSuccess", "TokenEfficiency", "TimeToComplete", "FalsePositiveRate"], -}); - -const BUILTIN_METRICS = Object.freeze([ - "TaskSuccess", - "TokenEfficiency", - "TimeToComplete", - "TestPassRate", - "FalsePositiveRate", - "ContextUtilization", -]); - -const DEFAULT_RESULTS_DIR = ".cache/eval-results"; -const DEFAULT_BENCHMARKS_DIR = "bench/benchmarks"; - -function mean(values = []) { - if (!Array.isArray(values) || values.length === 0) return 0; - return values.reduce((sum, value) => sum + Number(value || 0), 0) / values.length; -} - -function percentile(values = [], p = 95) { - if (!Array.isArray(values) || values.length === 0) return 0; - const sorted = values.map((value) => Number(value || 0)).sort((a, b) => a - b); - const index = Math.min(sorted.length - 1, Math.max(0, Math.ceil((p / 100) * sorted.length) - 1)); - return sorted[index] ?? 0; -} - -function ensureArray(value) { - return Array.isArray(value) ? value : value == null ? [] : [value]; -} - -function toNumber(value, fallback = 0) { - const numeric = Number(value); - return Number.isFinite(numeric) ? numeric : fallback; -} - -function normalizeTaskType(type) { - const normalized = String(type || "").trim().toLowerCase(); - if (TASK_TYPES.includes(normalized)) return normalized; - return "code-generation"; -} - -function defaultMetricsForTask(type) { - return [...(BUILTIN_TASK_METRICS[normalizeTaskType(type)] || BUILTIN_METRICS)]; -} - -function parseJsonFile(filePath) { - return JSON.parse(readFileSync(resolve(filePath), "utf8")); -} - -function dedupeStrings(values = []) { - const output = []; - for (const value of ensureArray(values)) { - const normalized = String(value || "").trim(); - if (!normalized || output.includes(normalized)) continue; - output.push(normalized); - } - return output; -} - -function escapeRegex(text) { - return String(text || "").replace(/[.*+?^${}()|[\]\\]/g, "\\$&"); -} - -function normalCdf(value) { - const x = Number(value || 0); - const sign = x < 0 ? -1 : 1; - const abs = Math.abs(x) / Math.sqrt(2); - const t = 1 / (1 + 0.3275911 * abs); - const a1 = 0.254829592; - const a2 = -0.284496736; - const a3 = 1.421413741; - const a4 = -1.453152027; - const a5 = 1.061405429; - const erf = 1 - (((((a5 * t) + a4) * t + a3) * t + a2) * t + a1) * t * Math.exp(-(abs * abs)); - return 0.5 * (1 + sign * erf); -} - -function zScoreToPValue(score) { - const normalized = Math.abs(Number(score || 0)); - return Math.max(0, Math.min(1, 2 * (1 - normalCdf(normalized)))); -} - -function computeSignificance(baseValues = [], candidateValues = []) { - const baseline = ensureArray(baseValues).map((value) => toNumber(value)).filter((value) => Number.isFinite(value)); - const candidate = ensureArray(candidateValues).map((value) => toNumber(value)).filter((value) => Number.isFinite(value)); - if (baseline.length === 0 || candidate.length === 0) { - return { score: 0, pValue: 1, method: "insufficient-data" }; - } - const baselineMean = mean(baseline); - const candidateMean = mean(candidate); - const baselineVariance = mean(baseline.map((value) => (value - baselineMean) ** 2)); - const candidateVariance = mean(candidate.map((value) => (value - candidateMean) ** 2)); - const denominator = Math.sqrt( - (baselineVariance / Math.max(1, baseline.length)) + - (candidateVariance / Math.max(1, candidate.length)), - ); - if (!Number.isFinite(denominator) || denominator === 0) { - return { - score: candidateMean === baselineMean ? 0 : Number.POSITIVE_INFINITY, - pValue: candidateMean === baselineMean ? 1 : 0, - method: "welch-z", - }; - } - const score = (candidateMean - baselineMean) / denominator; - return { - score, - pValue: zScoreToPValue(score), - method: "welch-z", - }; -} - -function normalizeMetricName(value) { - return String(value || "").trim(); -} - -function calculateCostFromOutcome(outcome = {}, strategy = {}) { - const totalTokens = toNumber(outcome.totalTokens, toNumber(outcome.tokensInput) + toNumber(outcome.tokensOutput)); - const rate = toNumber( - strategy.costPerMillionTokens ?? strategy.costRatePerMillion ?? strategy.tokenCostPerMillion, - 0, - ); - if (!rate || totalTokens <= 0) return 0; - return (totalTokens / 1_000_000) * rate; -} - -export class Task { - constructor(raw = {}) { - this.id = String(raw.id || "").trim() || `task-${randomUUID()}`; - this.type = normalizeTaskType(raw.type); - this.input = raw.input && typeof raw.input === "object" ? { ...raw.input } : { prompt: "", repoState: {} }; - this.groundTruth = raw.groundTruth && typeof raw.groundTruth === "object" ? { ...raw.groundTruth } : {}; - this.metrics = ensureArray(raw.metrics).length > 0 - ? dedupeStrings(ensureArray(raw.metrics).map((metric) => normalizeMetricName(metric))) - : defaultMetricsForTask(this.type); - this.tags = raw.tags && typeof raw.tags === "object" && !Array.isArray(raw.tags) ? { ...raw.tags } : {}; - } -} - -export class Benchmark { - constructor(raw = {}) { - this.id = String(raw.id || raw.name || "benchmark").trim() || "benchmark"; - this.name = String(raw.name || raw.id || "benchmark").trim() || "benchmark"; - this.description = String(raw.description || "").trim(); - this.tasks = ensureArray(raw.tasks).map((task) => task instanceof Task ? task : new Task(task)); - this.tags = raw.tags && typeof raw.tags === "object" && !Array.isArray(raw.tags) ? { ...raw.tags } : {}; - this.sourcePath = String(raw.sourcePath || "").trim(); - } -} - -export class Metric { - constructor(name, evaluator, options = {}) { - this.name = normalizeMetricName(name); - this.evaluator = typeof evaluator === "function" ? evaluator : (() => null); - this.kind = String(options.kind || "metric"); - this.description = String(options.description || "").trim(); - } - - evaluate(context) { - return this.evaluator(context); - } -} - -export class CategoryMetric extends Metric { - constructor(name, evaluator, options = {}) { - super(name, evaluator, { ...options, kind: "category" }); - } -} - -export class NumericalMetric extends Metric { - constructor(name, evaluator, options = {}) { - super(name, evaluator, { ...options, kind: "numerical" }); - } -} - -function defaultRunner() { - return async () => ({ - success: false, - durationMs: 0, - tokensInput: 0, - tokensOutput: 0, - filesChanged: 0, - testsPassed: 0, - testsTotal: 0, - falsePositives: 0, - contextBytes: 0, - contextBudgetBytes: 0, - costUsd: 0, - }); -} - -export function builtInMetricInstances() { - return [ - new CategoryMetric("TaskSuccess", ({ outcome }) => outcome.success ? "pass" : "fail"), - new NumericalMetric("TokenEfficiency", ({ outcome }) => { - const totalTokens = toNumber(outcome.totalTokens, toNumber(outcome.tokensInput) + toNumber(outcome.tokensOutput)); - return totalTokens / Math.max(1, toNumber(outcome.filesChanged, 1)); - }), - new NumericalMetric("TimeToComplete", ({ outcome }) => toNumber(outcome.durationMs)), - new NumericalMetric("TestPassRate", ({ outcome }) => { - const total = Math.max(0, toNumber(outcome.testsTotal)); - if (total === 0) return outcome.success ? 1 : 0; - return toNumber(outcome.testsPassed) / total; - }), - new NumericalMetric("FalsePositiveRate", ({ outcome }) => { - const reviewedCount = Math.max(1, toNumber(outcome.findingsTotal, toNumber(outcome.filesChanged, 1))); - return toNumber(outcome.falsePositives) / reviewedCount; - }), - new NumericalMetric("ContextUtilization", ({ outcome }) => { - const budget = Math.max(0, toNumber(outcome.contextBudgetBytes)); - if (budget === 0) return 0; - return toNumber(outcome.contextBytes) / budget; - }), - ]; -} - -function mapMetrics(metrics = []) { - const metricMap = new Map(); - for (const metric of [...builtInMetricInstances(), ...metrics]) { - if (!metric?.name) continue; - metricMap.set(metric.name, metric); - } - return metricMap; -} - -function buildTaskSummaryEntries(results = []) { - const byTask = new Map(); - for (const result of ensureArray(results)) { - const taskId = String(result?.taskId || "").trim(); - if (!taskId) continue; - if (!byTask.has(taskId)) { - byTask.set(taskId, { - taskId, - taskType: result.taskType || "code-generation", - repeats: 0, - passCount: 0, - tokenValues: [], - timeValues: [], - costValues: [], - resultIndexes: [], - }); - } - const entry = byTask.get(taskId); - entry.repeats += 1; - if (result.metrics?.TaskSuccess === "pass") entry.passCount += 1; - entry.tokenValues.push(toNumber(result.outcome?.totalTokens, toNumber(result.outcome?.tokensInput) + toNumber(result.outcome?.tokensOutput))); - entry.timeValues.push(toNumber(result.outcome?.durationMs)); - entry.costValues.push(toNumber(result.outcome?.costUsd)); - entry.resultIndexes.push(result.resultIndex); - } - return [...byTask.values()].map((entry) => ({ - taskId: entry.taskId, - taskType: entry.taskType, - repeats: entry.repeats, - passRate: entry.repeats > 0 ? entry.passCount / entry.repeats : 0, - avgTokens: mean(entry.tokenValues), - avgTimeMs: mean(entry.timeValues), - avgCostUsd: mean(entry.costValues), - })); -} - -function summarizeRun(run) { - const results = ensureArray(run.results); - const timeValues = []; - const tokenValues = []; - const costValues = []; - let passCount = 0; - for (const result of results) { - const metrics = result.metrics || {}; - const totalTokens = toNumber(result.outcome?.totalTokens, toNumber(result.outcome?.tokensInput) + toNumber(result.outcome?.tokensOutput)); - const totalCost = toNumber(result.outcome?.costUsd); - if (metrics.TaskSuccess === "pass") passCount += 1; - timeValues.push(toNumber(metrics.TimeToComplete, result.outcome?.durationMs)); - tokenValues.push(totalTokens); - costValues.push(totalCost); - } - return { - totalTasks: results.length, - passRate: results.length > 0 ? passCount / results.length : 0, - avgTokens: mean(tokenValues), - p95Tokens: percentile(tokenValues, 95), - avgTimeMs: mean(timeValues), - p95TimeMs: percentile(timeValues, 95), - totalCostUsd: costValues.reduce((sum, value) => sum + value, 0), - avgCostUsd: mean(costValues), - perTask: buildTaskSummaryEntries(results), - }; -} - -function normalizeStrategy(raw = {}, index = 0) { - const strategy = raw && typeof raw === "object" ? { ...raw } : { id: String(raw || "") }; - const id = String(strategy.id || strategy.name || `strategy-${index + 1}`).trim() || `strategy-${index + 1}`; - return { - id, - label: String(strategy.label || strategy.name || id).trim() || id, - sdk: String(strategy.sdk || "").trim(), - model: String(strategy.model || "").trim(), - promptStrategy: String(strategy.promptStrategy || strategy.prompt || "").trim(), - codebaseProfile: String(strategy.codebaseProfile || strategy.repoProfile || "").trim(), - annotated: strategy.annotated === true, - unannotated: strategy.unannotated === true, - config: strategy.config && typeof strategy.config === "object" ? { ...strategy.config } : {}, - costPerMillionTokens: toNumber(strategy.costPerMillionTokens ?? strategy.costRatePerMillion, 0), - metadata: strategy.metadata && typeof strategy.metadata === "object" ? { ...strategy.metadata } : {}, - }; -} - -function loadRunFromFile(runPath) { - return parseJsonFile(runPath); -} - -function readRunById(resultsDir, runId) { - return loadRunFromFile(resolveEvalResultPath(resultsDir, runId)); -} - -export class Evaluator { - constructor(options = {}) { - this.resultsDir = resolve(options.resultsDir || DEFAULT_RESULTS_DIR); - this.metrics = ensureArray(options.metrics); - this.runner = options.runner || defaultRunner(); - this.parallelism = Math.max(1, toNumber(options.parallelism, 1)); - this.storageAdapter = options.storageAdapter || null; - } - - async evaluate({ benchmark, repeats = 1, strategies = [] } = {}) { - const normalizedBenchmark = benchmark instanceof Benchmark ? benchmark : new Benchmark(benchmark || {}); - const normalizedStrategies = ensureArray(strategies).length > 0 - ? ensureArray(strategies).map((strategy, index) => normalizeStrategy(strategy, index)) - : [normalizeStrategy({ id: "default", label: "Default" })]; - const metricMap = mapMetrics(this.metrics); - const runId = `eval-${Date.now()}-${randomUUID()}`; - const results = []; - let resultIndex = 0; - - for (const strategy of normalizedStrategies) { - for (const task of normalizedBenchmark.tasks) { - for (let repeatIndex = 0; repeatIndex < Math.max(1, repeats); repeatIndex += 1) { - const outcome = { - ...(await this.runner({ benchmark: normalizedBenchmark, task, strategy, repeatIndex })), - }; - outcome.totalTokens = toNumber( - outcome.totalTokens, - toNumber(outcome.tokensInput) + toNumber(outcome.tokensOutput), - ); - outcome.costUsd = toNumber( - outcome.costUsd, - calculateCostFromOutcome(outcome, strategy), - ); - const metricResults = {}; - for (const metricName of task.metrics) { - const metric = metricMap.get(metricName); - if (!metric) continue; - metricResults[metricName] = metric.evaluate({ - benchmark: normalizedBenchmark, - task, - strategy, - repeatIndex, - outcome, - }); - } - results.push({ - resultIndex: resultIndex++, - strategyId: strategy.id, - strategyLabel: strategy.label, - strategy, - taskId: task.id, - taskType: task.type, - repeatIndex, - metrics: metricResults, - outcome, - }); - } - } - } - - const summary = summarizeRun({ results }); - const run = { - runId, - benchmarkId: normalizedBenchmark.id, - benchmark: normalizedBenchmark.name, - benchmarkDescription: normalizedBenchmark.description, - repeats: Math.max(1, repeats), - strategyIds: normalizedStrategies.map((strategy) => strategy.id), - strategies: normalizedStrategies, - parallelism: this.parallelism, - createdAt: new Date().toISOString(), - results, - summary, - }; - - mkdirSync(this.resultsDir, { recursive: true }); - const resultPath = resolve(this.resultsDir, `${runId}.json`); - writeFileSync(resultPath, JSON.stringify(run, null, 2) + "\n", "utf8"); - if (this.storageAdapter && typeof this.storageAdapter.writeRun === "function") { - await this.storageAdapter.writeRun(run, resultPath); - } - return { ...run, resultPath }; - } -} - -export async function importBenchmarkFromFile(filePath) { - const raw = parseJsonFile(filePath); - return new Benchmark({ ...raw, sourcePath: resolve(filePath) }); -} - -export function compareEvaluationRuns(baseline, candidate) { - const metricKeys = ["passRate", "avgTokens", "p95Tokens", "avgTimeMs", "p95TimeMs", "avgCostUsd", "totalCostUsd"]; - const metricDeltas = {}; - for (const key of metricKeys) { - const baseValue = toNumber(baseline?.summary?.[key]); - const candidateValue = toNumber(candidate?.summary?.[key]); - const delta = candidateValue - baseValue; - const baselineTaskValues = ensureArray(baseline?.summary?.perTask).map((entry) => toNumber(entry?.[key])); - const candidateTaskValues = ensureArray(candidate?.summary?.perTask).map((entry) => toNumber(entry?.[key])); - metricDeltas[key] = { - baseline: baseValue, - candidate: candidateValue, - delta, - significance: computeSignificance(baselineTaskValues, candidateTaskValues), - }; - } - - const baselineMap = new Map(ensureArray(baseline?.summary?.perTask).map((entry) => [entry.taskId, entry])); - const candidateMap = new Map(ensureArray(candidate?.summary?.perTask).map((entry) => [entry.taskId, entry])); - const improved = []; - const regressed = []; - const unchanged = []; - - for (const [taskId, baselineResult] of baselineMap.entries()) { - const candidateResult = candidateMap.get(taskId); - if (!candidateResult) continue; - const passDelta = toNumber(candidateResult.passRate) - toNumber(baselineResult.passRate); - const tokenDelta = toNumber(candidateResult.avgTokens) - toNumber(baselineResult.avgTokens); - const timeDelta = toNumber(candidateResult.avgTimeMs) - toNumber(baselineResult.avgTimeMs); - const record = { - taskId, - baseline: baselineResult, - candidate: candidateResult, - passRateDelta: passDelta, - avgTokensDelta: tokenDelta, - avgTimeMsDelta: timeDelta, - }; - if (passDelta > 0) improved.push(record); - else if (passDelta < 0) regressed.push(record); - else unchanged.push(record); - } - - return { - baselineRunId: baseline?.runId || "", - candidateRunId: candidate?.runId || "", - metricDeltas, - perTask: { improved, regressed, unchanged }, - }; -} - -export function summarizeMatrix(runs = []) { - const rows = ensureArray(runs).map((run) => ({ - config: ensureArray(run.strategyIds)[0] || run.strategyId || "default", - passRate: toNumber(run.summary?.passRate), - avgTokens: toNumber(run.summary?.avgTokens), - p95Tokens: toNumber(run.summary?.p95Tokens), - avgTimeMs: toNumber(run.summary?.avgTimeMs), - p95TimeMs: toNumber(run.summary?.p95TimeMs), - cost: toNumber(run.summary?.totalCostUsd, toNumber(run.summary?.avgCostUsd)), - })); - return { rows }; -} - -export function compareAuditImpactRuns(withAnnotations, withoutAnnotations) { - const comparison = compareEvaluationRuns(withoutAnnotations, withAnnotations); - const rows = [ - ["Pass Rate", withAnnotations?.summary?.passRate, withoutAnnotations?.summary?.passRate], - ["Avg Tokens", withAnnotations?.summary?.avgTokens, withoutAnnotations?.summary?.avgTokens], - ["Avg Time (ms)", withAnnotations?.summary?.avgTimeMs, withoutAnnotations?.summary?.avgTimeMs], - ["False Positive Rate", mean(ensureArray(withAnnotations?.results).map((entry) => toNumber(entry?.metrics?.FalsePositiveRate))), mean(ensureArray(withoutAnnotations?.results).map((entry) => toNumber(entry?.metrics?.FalsePositiveRate)))], - ].map(([metric, withValue, withoutValue]) => ({ - metric, - withAnnotations: toNumber(withValue), - withoutAnnotations: toNumber(withoutValue), - delta: toNumber(withValue) - toNumber(withoutValue), - })); - return { - comparison, - rows, - }; -} - -export function resolveEvalResultPath(resultsDir, runId) { - return resolve(resultsDir || DEFAULT_RESULTS_DIR, `${basename(String(runId || "").replace(/\.json$/i, ""))}.json`); -} - -export function listStoredEvaluationRuns(resultsDir = DEFAULT_RESULTS_DIR) { - const dir = resolve(resultsDir); - if (!existsSync(dir)) return []; - return readdirSync(dir) - .filter((name) => name.startsWith("eval-") && name.endsWith(".json")) - .sort() - .map((name) => ({ - runId: name.replace(/\.json$/i, ""), - path: resolve(dir, name), - })); -} - -export function detectRegression(currentRun, baselineRun, thresholds = {}) { - const maxTokenRegression = toNumber(thresholds.maxTokenRegression, Infinity); - const minPassRate = thresholds.minPassRate == null ? -Infinity : toNumber(thresholds.minPassRate); - const tokenRegression = toNumber(currentRun?.summary?.avgTokens) - toNumber(baselineRun?.summary?.avgTokens); - const tokenRegressionRatio = toNumber(baselineRun?.summary?.avgTokens) === 0 - ? (tokenRegression > 0 ? Infinity : 0) - : tokenRegression / Math.max(1e-9, toNumber(baselineRun?.summary?.avgTokens)); - const passRate = toNumber(currentRun?.summary?.passRate); - const failures = []; - if (Number.isFinite(maxTokenRegression) && tokenRegressionRatio > maxTokenRegression) { - failures.push({ - metric: "avgTokens", - actual: tokenRegressionRatio, - threshold: maxTokenRegression, - message: `Average token regression ${tokenRegressionRatio.toFixed(4)} exceeds ${maxTokenRegression.toFixed(4)}`, - }); - } - if (passRate < minPassRate) { - failures.push({ - metric: "passRate", - actual: passRate, - threshold: minPassRate, - message: `Pass rate ${passRate.toFixed(4)} is below ${minPassRate.toFixed(4)}`, - }); - } - return { - ok: failures.length === 0, - failures, - }; -} - -export function summarizeHistory(runs = []) { - const ordered = ensureArray(runs) - .map((run) => ({ - runId: run.runId, - createdAt: run.createdAt || "", - benchmark: run.benchmark || run.benchmarkId || "", - passRate: toNumber(run.summary?.passRate), - avgTokens: toNumber(run.summary?.avgTokens), - avgTimeMs: toNumber(run.summary?.avgTimeMs), - totalCostUsd: toNumber(run.summary?.totalCostUsd), - })) - .sort((a, b) => String(a.createdAt).localeCompare(String(b.createdAt))); - const regressions = []; - for (let index = 1; index < ordered.length; index += 1) { - const previous = ordered[index - 1]; - const current = ordered[index]; - if (current.passRate < previous.passRate || current.avgTokens > previous.avgTokens) { - regressions.push({ - fromRunId: previous.runId, - toRunId: current.runId, - passRateDelta: current.passRate - previous.passRate, - avgTokensDelta: current.avgTokens - previous.avgTokens, - }); - } - } - return { runs: ordered, regressions }; -} - -function renderMatrixTable(rows = []) { - const header = ["Config", "Pass Rate", "Avg Tokens", "Avg Time", "Cost"]; - const tableRows = ensureArray(rows).map((row) => [ - row.config, - `${(toNumber(row.passRate) * 100).toFixed(1)}%`, - Math.round(toNumber(row.avgTokens)).toString(), - `${(toNumber(row.avgTimeMs) / 1000).toFixed(1)}s`, - `$${toNumber(row.cost).toFixed(4)}`, - ]); - return [header, ...tableRows].map((cells) => `| ${cells.join(" | ")} |`).join("\n"); -} - -function printUsage() { - console.log(`Bosun evaluation framework\n\nUsage:\n bosun eval import \n bosun eval run --benchmark [--repeats N] [--config id] [--results-dir dir]\n bosun eval compare [--results-dir dir]\n bosun eval matrix --benchmark [--repeats N] [--configs a,b] [--results-dir dir]\n bosun eval audit-impact --with --without [--results-dir dir]\n bosun eval ci --baseline --candidate [--max-token-regression 0.10] [--min-pass-rate 0.85]\n bosun eval history [--results-dir dir]\n`); -} - -function getArgValue(args, flag) { - const inline = args.find((entry) => entry.startsWith(`${flag}=`)); - if (inline) return inline.slice(flag.length + 1); - const index = args.indexOf(flag); - return index >= 0 ? args[index + 1] : ""; -} - -function hasFlag(args, flag) { - return args.includes(flag); -} - -function parseConfigList(rawValue) { - return String(rawValue || "") - .split(",") - .map((value) => value.trim()) - .filter(Boolean); -} - -function resolveBenchmarkPath(input = "", options = {}) { - const value = String(input || "").trim(); - if (!value) return ""; - if (existsSync(resolve(value))) return resolve(value); - const benchmarksDir = resolve(options.benchmarksDir || DEFAULT_BENCHMARKS_DIR); - const candidates = [ - resolve(benchmarksDir, value), - resolve(benchmarksDir, `${value}.json`), - ]; - return candidates.find((candidate) => existsSync(candidate)) || resolve(value); -} - -function resolveRunInput(input, resultsDir) { - const value = String(input || "").trim(); - if (!value) throw new Error("Run identifier is required"); - if (existsSync(resolve(value))) return loadRunFromFile(resolve(value)); - return readRunById(resultsDir, value); -} - -function createSyntheticRunner() { - return async ({ task, strategy, repeatIndex }) => { - const promptLength = String(task?.input?.prompt || "").length; - const taskWeight = TASK_TYPES.indexOf(task?.type) + 1; - const strategyWeight = Math.max(1, String(strategy?.id || "default").length % 7); - const success = !String(strategy?.id || "").toLowerCase().includes("fail"); - return { - success, - durationMs: 1000 + (repeatIndex * 125) + (taskWeight * 200) + (strategyWeight * 50), - tokensInput: 800 + promptLength + (taskWeight * 75), - tokensOutput: 300 + (repeatIndex * 20) + (strategyWeight * 15), - filesChanged: Math.max(1, taskWeight - 1), - testsPassed: success ? Math.max(1, taskWeight) : Math.max(0, taskWeight - 1), - testsTotal: Math.max(1, taskWeight), - falsePositives: task?.type === "code-review" && success ? 0 : (task?.type === "code-review" ? 1 : 0), - contextBytes: 2048 + promptLength, - contextBudgetBytes: 8192, - }; - }; -} - -export async function runEvalCli(args = []) { - const [command, ...rest] = args; - if (!command || command === "--help" || command === "-h") { - printUsage(); - return { exitCode: 0 }; - } - - if (command === "import") { - const filePath = rest[0]; - if (!filePath) { - console.error("Usage: bosun eval import "); - return { exitCode: 1 }; - } - const benchmark = await importBenchmarkFromFile(filePath); - console.log(`Imported benchmark ${benchmark.name}: tasks=${benchmark.tasks.length}`); - return { exitCode: 0, benchmark }; - } - - if (command === "run") { - const resultsDir = getArgValue(rest, "--results-dir") || DEFAULT_RESULTS_DIR; - const benchmarkPath = resolveBenchmarkPath(getArgValue(rest, "--benchmark"), { - benchmarksDir: getArgValue(rest, "--benchmarks-dir") || DEFAULT_BENCHMARKS_DIR, - }); - const repeats = Math.max(1, toNumber(getArgValue(rest, "--repeats"), 1)); - const configId = getArgValue(rest, "--config") || "default"; - if (!benchmarkPath) { - console.error("Usage: bosun eval run --benchmark [--repeats N] [--config id]"); - return { exitCode: 1 }; - } - const benchmark = await importBenchmarkFromFile(benchmarkPath); - const evaluator = new Evaluator({ resultsDir, runner: createSyntheticRunner() }); - const run = await evaluator.evaluate({ - benchmark, - repeats, - strategies: [{ id: configId, label: configId }], - }); - console.log(JSON.stringify({ runId: run.runId, resultPath: run.resultPath, summary: run.summary }, null, 2)); - return { exitCode: 0, run }; - } - - if (command === "compare") { - const resultsDir = getArgValue(rest, "--results-dir") || DEFAULT_RESULTS_DIR; - const [runAPath, runBPath] = rest.filter((entry) => !/^--/.test(entry)); - if (!runAPath || !runBPath) { - console.error("Usage: bosun eval compare "); - return { exitCode: 1 }; - } - const baseline = resolveRunInput(runAPath, resultsDir); - const candidate = resolveRunInput(runBPath, resultsDir); - const comparison = compareEvaluationRuns(baseline, candidate); - console.log(JSON.stringify(comparison, null, 2)); - return { exitCode: 0, comparison }; - } - - if (command === "matrix") { - const resultsDir = getArgValue(rest, "--results-dir") || DEFAULT_RESULTS_DIR; - const benchmarkPath = resolveBenchmarkPath(getArgValue(rest, "--benchmark"), { - benchmarksDir: getArgValue(rest, "--benchmarks-dir") || DEFAULT_BENCHMARKS_DIR, - }); - const repeats = Math.max(1, toNumber(getArgValue(rest, "--repeats"), 1)); - const configs = parseConfigList(getArgValue(rest, "--configs") || "default"); - if (!benchmarkPath) { - console.error("Usage: bosun eval matrix --benchmark [--repeats N] [--configs a,b]"); - return { exitCode: 1 }; - } - const benchmark = await importBenchmarkFromFile(benchmarkPath); - const evaluator = new Evaluator({ resultsDir, runner: createSyntheticRunner() }); - const runs = []; - for (const configId of configs) { - const run = await evaluator.evaluate({ - benchmark, - repeats, - strategies: [{ id: configId, label: configId }], - }); - runs.push(run); - } - const matrix = summarizeMatrix(runs); - console.log(renderMatrixTable(matrix.rows)); - return { exitCode: 0, runs, matrix }; - } - - if (command === "audit-impact") { - const resultsDir = getArgValue(rest, "--results-dir") || DEFAULT_RESULTS_DIR; - const withInput = getArgValue(rest, "--with"); - const withoutInput = getArgValue(rest, "--without"); - if (!withInput || !withoutInput) { - console.error("Usage: bosun eval audit-impact --with --without "); - return { exitCode: 1 }; - } - const withAnnotations = resolveRunInput(withInput, resultsDir); - const withoutAnnotations = resolveRunInput(withoutInput, resultsDir); - const impact = compareAuditImpactRuns(withAnnotations, withoutAnnotations); - console.log(JSON.stringify(impact, null, 2)); - return { exitCode: 0, impact }; - } - - if (command === "ci") { - const resultsDir = getArgValue(rest, "--results-dir") || DEFAULT_RESULTS_DIR; - const baselineInput = getArgValue(rest, "--baseline"); - const candidateInput = getArgValue(rest, "--candidate"); - if (!baselineInput || !candidateInput) { - console.error("Usage: bosun eval ci --baseline --candidate "); - return { exitCode: 1 }; - } - const baseline = resolveRunInput(baselineInput, resultsDir); - const candidate = resolveRunInput(candidateInput, resultsDir); - const regression = detectRegression(candidate, baseline, { - maxTokenRegression: toNumber(getArgValue(rest, "--max-token-regression"), 0.1), - minPassRate: toNumber(getArgValue(rest, "--min-pass-rate"), 0.85), - }); - if (!regression.ok) { - console.error(JSON.stringify(regression, null, 2)); - return { exitCode: 1, regression }; - } - console.log(JSON.stringify(regression, null, 2)); - return { exitCode: 0, regression }; - } - - if (command === "history") { - const resultsDir = getArgValue(rest, "--results-dir") || DEFAULT_RESULTS_DIR; - const runs = listStoredEvaluationRuns(resultsDir).map((entry) => loadRunFromFile(entry.path)); - const history = summarizeHistory(runs); - console.log(JSON.stringify(history, null, 2)); - return { exitCode: 0, history }; - } - - console.error(`Unknown eval command: ${command}`); - printUsage(); - return { exitCode: 1 }; -} diff --git a/bosun.schema.json b/bosun.schema.json index 5ead04190..288a546fa 100644 --- a/bosun.schema.json +++ b/bosun.schema.json @@ -108,10 +108,6 @@ ] }, "description": "Override reusable relative paths to link from the repo root into a managed worktree for each detected ecosystem." - }, - "worktreeSetupScript": { - "type": "string", - "description": "Global shell command (or commands joined with &&) run once in every new managed worktree across all repos, before per-repo environment commands. Per-repo environment.worktreeSetupScript overrides this." } } }, @@ -1700,51 +1696,6 @@ }, "telegramPollLockPath": { "type": "string" - }, - "environment": { - "type": "object", - "description": "Per-repo environment configuration for worktree setup and agent operations. Overrides global worktreeBootstrap settings for this repository.", - "additionalProperties": true, - "properties": { - "template": { - "type": "string", - "description": "Environment template identifier (e.g. 'node-ts', 'python-poetry', 'rust', 'dotnet-csharp'). Used to populate defaults." - }, - "installCommands": { - "type": "array", - "items": { "type": "string" }, - "description": "Ordered commands to install dependencies in a fresh worktree. Supports 'auto' as a single-element array to auto-detect." - }, - "startCommand": { - "type": "string", - "description": "Command to start the development server or main process." - }, - "buildCommand": { - "type": "string", - "description": "Command to produce build artifacts. Supports 'auto'." - }, - "testCommand": { - "type": "string", - "description": "Command to run the test suite. Supports 'auto'." - }, - "lintCommand": { - "type": "string", - "description": "Command to lint and style-check the codebase. Supports 'auto'." - }, - "debugCommand": { - "type": "string", - "description": "Command to start a debug session." - }, - "worktreeSetupScript": { - "type": "string", - "description": "Shell command (or commands joined with &&) run once in every new managed worktree before install commands." - }, - "sharedPaths": { - "type": "array", - "items": { "type": "string" }, - "description": "Relative paths to symlink from the repo root into each managed worktree (e.g. node_modules, vendor)." - } - } } } }, diff --git a/ci-job-69313532999.zip b/ci-job-69313532999.zip new file mode 100644 index 000000000..d322d2ed8 --- /dev/null +++ b/ci-job-69313532999.zip @@ -0,0 +1,210 @@ +2026-03-31T08:12:08.4575442Z Current runner version: '2.333.1' +2026-03-31T08:12:08.4599605Z ##[group]Runner Image Provisioner +2026-03-31T08:12:08.4600458Z Hosted Compute Agent +2026-03-31T08:12:08.4600994Z Version: 20260213.493 +2026-03-31T08:12:08.4601659Z Commit: 5c115507f6dd24b8de37d8bbe0bb4509d0cc0fa3 +2026-03-31T08:12:08.4602713Z Build Date: 2026-02-13T00:28:41Z +2026-03-31T08:12:08.4603397Z Worker ID: {182b776f-e7ef-4259-b14d-df52dbeda612} +2026-03-31T08:12:08.4604194Z Azure Region: westus2 +2026-03-31T08:12:08.4604745Z ##[endgroup] +2026-03-31T08:12:08.4606193Z ##[group]Operating System +2026-03-31T08:12:08.4606770Z Ubuntu +2026-03-31T08:12:08.4607567Z 24.04.4 +2026-03-31T08:12:08.4608047Z LTS +2026-03-31T08:12:08.4608575Z ##[endgroup] +2026-03-31T08:12:08.4609146Z ##[group]Runner Image +2026-03-31T08:12:08.4609708Z Image: ubuntu-24.04 +2026-03-31T08:12:08.4610219Z Version: 20260323.65.1 +2026-03-31T08:12:08.4611430Z Included Software: https://github.com/actions/runner-images/blob/ubuntu24/20260323.65/images/ubuntu/Ubuntu2404-Readme.md +2026-03-31T08:12:08.4613154Z Image Release: https://github.com/actions/runner-images/releases/tag/ubuntu24%2F20260323.65 +2026-03-31T08:12:08.4614151Z ##[endgroup] +2026-03-31T08:12:08.4615163Z ##[group]GITHUB_TOKEN Permissions +2026-03-31T08:12:08.4617066Z Contents: read +2026-03-31T08:12:08.4617608Z Metadata: read +2026-03-31T08:12:08.4618183Z ##[endgroup] +2026-03-31T08:12:08.4620186Z Secret source: Actions +2026-03-31T08:12:08.4620936Z Prepare workflow directory +2026-03-31T08:12:08.4947407Z Prepare all required actions +2026-03-31T08:12:08.4985382Z Getting action download info +2026-03-31T08:12:08.9687692Z Download action repository 'actions/checkout@v4' (SHA:34e114876b0b11c390a56381ad16ebd13914f8d5) +2026-03-31T08:12:09.0876793Z Download action repository 'actions/setup-node@v4' (SHA:49933ea5288caeca8642d1e84afbd3f7d6820020) +2026-03-31T08:12:09.3616121Z Complete job name: Build + Tests +2026-03-31T08:12:09.4337813Z ##[group]Run actions/checkout@v4 +2026-03-31T08:12:09.4338634Z with: +2026-03-31T08:12:09.4339038Z repository: virtengine/bosun +2026-03-31T08:12:09.4339686Z token: *** +2026-03-31T08:12:09.4340075Z ssh-strict: true +2026-03-31T08:12:09.4340503Z ssh-user: git +2026-03-31T08:12:09.4340908Z persist-credentials: true +2026-03-31T08:12:09.4341349Z clean: true +2026-03-31T08:12:09.4341747Z sparse-checkout-cone-mode: true +2026-03-31T08:12:09.4342542Z fetch-depth: 1 +2026-03-31T08:12:09.4342932Z fetch-tags: false +2026-03-31T08:12:09.4343321Z show-progress: true +2026-03-31T08:12:09.4343713Z lfs: false +2026-03-31T08:12:09.4344083Z submodules: false +2026-03-31T08:12:09.4344475Z set-safe-directory: true +2026-03-31T08:12:09.4345209Z ##[endgroup] +2026-03-31T08:12:09.5447704Z Syncing repository: virtengine/bosun +2026-03-31T08:12:09.5449411Z ##[group]Getting Git version info +2026-03-31T08:12:09.5450071Z Working directory is '/home/runner/work/bosun/bosun' +2026-03-31T08:12:09.5451073Z [command]/usr/bin/git version +2026-03-31T08:12:09.5487284Z git version 2.53.0 +2026-03-31T08:12:09.5515730Z ##[endgroup] +2026-03-31T08:12:09.5531109Z Temporarily overriding HOME='/home/runner/work/_temp/d64d0500-892f-42a3-bbf0-bc662c36db8d' before making global git config changes +2026-03-31T08:12:09.5533824Z Adding repository directory to the temporary git global config as a safe directory +2026-03-31T08:12:09.5536005Z [command]/usr/bin/git config --global --add safe.directory /home/runner/work/bosun/bosun +2026-03-31T08:12:09.5568111Z Deleting the contents of '/home/runner/work/bosun/bosun' +2026-03-31T08:12:09.5571966Z ##[group]Initializing the repository +2026-03-31T08:12:09.5576162Z [command]/usr/bin/git init /home/runner/work/bosun/bosun +2026-03-31T08:12:09.5649597Z hint: Using 'master' as the name for the initial branch. This default branch name +2026-03-31T08:12:09.5651278Z hint: will change to "main" in Git 3.0. To configure the initial branch name +2026-03-31T08:12:09.5654293Z hint: to use in all of your new repositories, which will suppress this warning, +2026-03-31T08:12:09.5655656Z hint: call: +2026-03-31T08:12:09.5656438Z hint: +2026-03-31T08:12:09.5657676Z hint: git config --global init.defaultBranch +2026-03-31T08:12:09.5658723Z hint: +2026-03-31T08:12:09.5659678Z hint: Names commonly chosen instead of 'master' are 'main', 'trunk' and +2026-03-31T08:12:09.5661313Z hint: 'development'. The just-created branch can be renamed via this command: +2026-03-31T08:12:09.5663277Z hint: +2026-03-31T08:12:09.5664000Z hint: git branch -m +2026-03-31T08:12:09.5664798Z hint: +2026-03-31T08:12:09.5665875Z hint: Disable this message with "git config set advice.defaultBranchName false" +2026-03-31T08:12:09.5667561Z Initialized empty Git repository in /home/runner/work/bosun/bosun/.git/ +2026-03-31T08:12:09.5670303Z [command]/usr/bin/git remote add origin https://github.com/virtengine/bosun +2026-03-31T08:12:09.5688771Z ##[endgroup] +2026-03-31T08:12:09.5690322Z ##[group]Disabling automatic garbage collection +2026-03-31T08:12:09.5693493Z [command]/usr/bin/git config --local gc.auto 0 +2026-03-31T08:12:09.5725737Z ##[endgroup] +2026-03-31T08:12:09.5727523Z ##[group]Setting up auth +2026-03-31T08:12:09.5732757Z [command]/usr/bin/git config --local --name-only --get-regexp core\.sshCommand +2026-03-31T08:12:09.5766915Z [command]/usr/bin/git submodule foreach --recursive sh -c "git config --local --name-only --get-regexp 'core\.sshCommand' && git config --local --unset-all 'core.sshCommand' || :" +2026-03-31T08:12:09.6070882Z [command]/usr/bin/git config --local --name-only --get-regexp http\.https\:\/\/github\.com\/\.extraheader +2026-03-31T08:12:09.6099212Z [command]/usr/bin/git submodule foreach --recursive sh -c "git config --local --name-only --get-regexp 'http\.https\:\/\/github\.com\/\.extraheader' && git config --local --unset-all 'http.https://github.com/.extraheader' || :" +2026-03-31T08:12:09.6315060Z [command]/usr/bin/git config --local --name-only --get-regexp ^includeIf\.gitdir: +2026-03-31T08:12:09.6344907Z [command]/usr/bin/git submodule foreach --recursive git config --local --show-origin --name-only --get-regexp remote.origin.url +2026-03-31T08:12:09.6565425Z [command]/usr/bin/git config --local http.https://github.com/.extraheader AUTHORIZATION: basic *** +2026-03-31T08:12:09.6598867Z ##[endgroup] +2026-03-31T08:12:09.6599843Z ##[group]Fetching the repository +2026-03-31T08:12:09.6607025Z [command]/usr/bin/git -c protocol.version=2 fetch --no-tags --prune --no-recurse-submodules --depth=1 origin +543c25292a12f88977efc9bfa17079cec051e390:refs/remotes/pull/437/merge +2026-03-31T08:12:10.7984052Z From https://github.com/virtengine/bosun +2026-03-31T08:12:10.7985901Z * [new ref] 543c25292a12f88977efc9bfa17079cec051e390 -> pull/437/merge +2026-03-31T08:12:10.8014904Z ##[endgroup] +2026-03-31T08:12:10.8016264Z ##[group]Determining the checkout info +2026-03-31T08:12:10.8017814Z ##[endgroup] +2026-03-31T08:12:10.8023063Z [command]/usr/bin/git sparse-checkout disable +2026-03-31T08:12:10.8061174Z [command]/usr/bin/git config --local --unset-all extensions.worktreeConfig +2026-03-31T08:12:10.8088130Z ##[group]Checking out the ref +2026-03-31T08:12:10.8092963Z [command]/usr/bin/git checkout --progress --force refs/remotes/pull/437/merge +2026-03-31T08:12:10.9353869Z Note: switching to 'refs/remotes/pull/437/merge'. +2026-03-31T08:12:10.9354672Z +2026-03-31T08:12:10.9355278Z You are in 'detached HEAD' state. You can look around, make experimental +2026-03-31T08:12:10.9356611Z changes and commit them, and you can discard any commits you make in this +2026-03-31T08:12:10.9357937Z state without impacting any branches by switching back to a branch. +2026-03-31T08:12:10.9358713Z +2026-03-31T08:12:10.9359240Z If you want to create a new branch to retain commits you create, you may +2026-03-31T08:12:10.9360544Z do so (now or later) by using -c with the switch command. Example: +2026-03-31T08:12:10.9361326Z +2026-03-31T08:12:10.9361655Z git switch -c +2026-03-31T08:12:10.9362533Z +2026-03-31T08:12:10.9362916Z Or undo this operation with: +2026-03-31T08:12:10.9363417Z +2026-03-31T08:12:10.9363889Z git switch - +2026-03-31T08:12:10.9364647Z +2026-03-31T08:12:10.9365649Z Turn off this advice by setting config variable advice.detachedHead to false +2026-03-31T08:12:10.9366724Z +2026-03-31T08:12:10.9367868Z HEAD is now at 543c252 Merge d5665d1854745adf838443c2b0162cc67673514e into 66f9a9e4fbb9b3e822f4d36a49e0d6537379e769 +2026-03-31T08:12:10.9371466Z ##[endgroup] +2026-03-31T08:12:10.9402998Z [command]/usr/bin/git log -1 --format=%H +2026-03-31T08:12:10.9423936Z 543c25292a12f88977efc9bfa17079cec051e390 +2026-03-31T08:12:10.9762391Z ##[group]Run actions/setup-node@v4 +2026-03-31T08:12:10.9763579Z with: +2026-03-31T08:12:10.9764407Z node-version: 24 +2026-03-31T08:12:10.9765295Z cache: npm +2026-03-31T08:12:10.9766252Z cache-dependency-path: package-lock.json +2026-03-31T08:12:10.9767520Z always-auth: false +2026-03-31T08:12:10.9768472Z check-latest: false +2026-03-31T08:12:10.9769741Z token: *** +2026-03-31T08:12:10.9770611Z ##[endgroup] +2026-03-31T08:12:11.1666438Z Found in cache @ /opt/hostedtoolcache/node/24.14.0/x64 +2026-03-31T08:12:11.1672677Z ##[group]Environment details +2026-03-31T08:12:14.0311664Z node: v24.14.0 +2026-03-31T08:12:14.0313142Z npm: 11.9.0 +2026-03-31T08:12:14.0313526Z yarn: 1.22.22 +2026-03-31T08:12:14.0314849Z ##[endgroup] +2026-03-31T08:12:14.0333939Z [command]/opt/hostedtoolcache/node/24.14.0/x64/bin/npm config get cache +2026-03-31T08:12:14.2385682Z /home/runner/.npm +2026-03-31T08:12:14.5738325Z Cache hit for: node-cache-Linux-x64-npm-a4608dccb002348567ca67ca7fbaf89f2377543f3855fd295b180ae8cd05f22a +2026-03-31T08:12:15.8836801Z Received 4194304 of 469488352 (0.9%), 4.0 MBs/sec +2026-03-31T08:12:16.8847347Z Received 92274688 of 469488352 (19.7%), 44.0 MBs/sec +2026-03-31T08:12:17.8842506Z Received 239075328 of 469488352 (50.9%), 76.0 MBs/sec +2026-03-31T08:12:18.8840424Z Received 390070272 of 469488352 (83.1%), 93.0 MBs/sec +2026-03-31T08:12:19.6795226Z Received 469488352 of 469488352 (100.0%), 93.3 MBs/sec +2026-03-31T08:12:19.6796556Z Cache Size: ~448 MB (469488352 B) +2026-03-31T08:12:19.6837895Z [command]/usr/bin/tar -xf /home/runner/work/_temp/53b2b0ee-e3b8-4c12-a2b4-314fe5d2c1b3/cache.tzst -P -C /home/runner/work/bosun/bosun --use-compress-program unzstd +2026-03-31T08:12:20.5315683Z Cache restored successfully +2026-03-31T08:12:20.5535097Z Cache restored from key: node-cache-Linux-x64-npm-a4608dccb002348567ca67ca7fbaf89f2377543f3855fd295b180ae8cd05f22a +2026-03-31T08:12:20.5735170Z ##[group]Run npm ci +2026-03-31T08:12:20.5735456Z npm ci +2026-03-31T08:12:20.6929401Z shell: /usr/bin/bash -e {0} +2026-03-31T08:12:20.6929678Z ##[endgroup] +2026-03-31T08:12:26.2340834Z npm warn deprecated node-domexception@1.0.0: Use your platform's native DOMException instead +2026-03-31T08:12:31.7581361Z +2026-03-31T08:12:31.7581937Z > bosun@0.42.5 preinstall +2026-03-31T08:12:31.7586657Z > node -e "try{var r=require('child_process').execSync('npm ls -g codex-monitor --json --depth=0',{encoding:'utf8',stdio:['pipe','pipe','pipe']});var d=JSON.parse(r).dependencies;if(d&&d['codex-monitor']){console.log('\n Removing old codex-monitor package...');require('child_process').execSync('npm uninstall -g codex-monitor',{stdio:'inherit',timeout:30000});console.log(' \u2705 Migrated to bosun. codex-monitor aliases still work.\n')}}catch(e){}" +2026-03-31T08:12:31.7589495Z +2026-03-31T08:12:32.2983466Z +2026-03-31T08:12:32.2984165Z > bosun@0.42.5 postinstall +2026-03-31T08:12:32.2984824Z > node postinstall.mjs +2026-03-31T08:12:32.2985074Z +2026-03-31T08:12:32.3562572Z +2026-03-31T08:12:32.3563212Z > bosun@0.42.5 prepare +2026-03-31T08:12:32.3563747Z > node tools/vendor-sync.mjs +2026-03-31T08:12:32.3564035Z +2026-03-31T08:12:32.4074105Z [vendor-sync] Syncing vendor files to ui/vendor/ … +2026-03-31T08:12:32.4116197Z [vendor-sync] ✓ node_modules → preact.js +2026-03-31T08:12:32.4125956Z [vendor-sync] ✓ node_modules → preact-hooks.js +2026-03-31T08:12:32.4132263Z [vendor-sync] ✓ node_modules → preact-compat.js +2026-03-31T08:12:32.4139036Z [vendor-sync] ✓ node_modules → htm.js +2026-03-31T08:12:32.4145444Z [vendor-sync] ✓ node_modules → preact-signals-core.js +2026-03-31T08:12:32.4151867Z [vendor-sync] ✓ node_modules → preact-signals.js +2026-03-31T08:12:32.4158737Z [vendor-sync] ✓ node_modules → es-module-shims.js +2026-03-31T08:12:32.4161599Z [vendor-sync] Done — 7 vendor files ready in ui/vendor/ +2026-03-31T08:12:32.4327295Z +2026-03-31T08:12:32.4327846Z added 391 packages, and audited 392 packages in 12s +2026-03-31T08:12:32.4328282Z +2026-03-31T08:12:32.4329634Z 108 packages are looking for funding +2026-03-31T08:12:32.4331033Z run `npm fund` for details +2026-03-31T08:12:32.4366689Z +2026-03-31T08:12:32.4367130Z 2 vulnerabilities (1 moderate, 1 high) +2026-03-31T08:12:32.4367470Z +2026-03-31T08:12:32.4367620Z To address all issues, run: +2026-03-31T08:12:32.4367915Z npm audit fix +2026-03-31T08:12:32.4368054Z +2026-03-31T08:12:32.4368212Z Run `npm audit` for details. +2026-03-31T08:12:32.5692860Z ##[group]Run node tools/prepublish-check.mjs +2026-03-31T08:12:32.5693262Z node tools/prepublish-check.mjs +2026-03-31T08:12:32.5721515Z shell: /usr/bin/bash -e {0} +2026-03-31T08:12:32.5721752Z ##[endgroup] +2026-03-31T08:12:32.9446678Z :close: Published local imports missing from package.json files array: +2026-03-31T08:12:32.9448762Z workflow/mcp-discovery-proxy.mjs -> ../infra/windows-hidden-child-processes.mjs (infra/windows-hidden-child-processes.mjs) +2026-03-31T08:12:32.9450974Z workflow/mcp-registry.mjs -> ../infra/windows-hidden-child-processes.mjs (infra/windows-hidden-child-processes.mjs) +2026-03-31T08:12:32.9452428Z +2026-03-31T08:12:32.9453130Z Add the resolved targets to the 'files' array in package.json. +2026-03-31T08:12:32.9520563Z ##[error]Process completed with exit code 1. +2026-03-31T08:12:32.9654164Z Post job cleanup. +2026-03-31T08:12:33.0591186Z [command]/usr/bin/git version +2026-03-31T08:12:33.0626911Z git version 2.53.0 +2026-03-31T08:12:33.0670828Z Temporarily overriding HOME='/home/runner/work/_temp/e93284f7-796c-4965-a717-4cff07902629' before making global git config changes +2026-03-31T08:12:33.0672738Z Adding repository directory to the temporary git global config as a safe directory +2026-03-31T08:12:33.0684143Z [command]/usr/bin/git config --global --add safe.directory /home/runner/work/bosun/bosun +2026-03-31T08:12:33.0716596Z [command]/usr/bin/git config --local --name-only --get-regexp core\.sshCommand +2026-03-31T08:12:33.0747736Z [command]/usr/bin/git submodule foreach --recursive sh -c "git config --local --name-only --get-regexp 'core\.sshCommand' && git config --local --unset-all 'core.sshCommand' || :" +2026-03-31T08:12:33.0966113Z [command]/usr/bin/git config --local --name-only --get-regexp http\.https\:\/\/github\.com\/\.extraheader +2026-03-31T08:12:33.0986125Z http.https://github.com/.extraheader +2026-03-31T08:12:33.0998635Z [command]/usr/bin/git config --local --unset-all http.https://github.com/.extraheader +2026-03-31T08:12:33.1029099Z [command]/usr/bin/git submodule foreach --recursive sh -c "git config --local --name-only --get-regexp 'http\.https\:\/\/github\.com\/\.extraheader' && git config --local --unset-all 'http.https://github.com/.extraheader' || :" +2026-03-31T08:12:33.1243130Z [command]/usr/bin/git config --local --name-only --get-regexp ^includeIf\.gitdir: +2026-03-31T08:12:33.1273387Z [command]/usr/bin/git submodule foreach --recursive git config --local --show-origin --name-only --get-regexp remote.origin.url +2026-03-31T08:12:33.1593290Z Cleaning up orphan processes +2026-03-31T08:12:33.1895738Z ##[warning]Node.js 20 actions are deprecated. The following actions are running on Node.js 20 and may not work as expected: actions/checkout@v4, actions/setup-node@v4. Actions will be forced to run with Node.js 24 by default starting June 2nd, 2026. Node.js 20 will be removed from the runner on September 16th, 2026. Please check if updated versions of these actions are available that support Node.js 24. To opt into Node.js 24 now, set the FORCE_JAVASCRIPT_ACTIONS_TO_NODE24=true environment variable on the runner or in your workflow file. Once Node.js 24 becomes the default, you can temporarily opt out by setting ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION=true. For more information see: https://github.blog/changelog/2025-09-19-deprecation-of-node-20-on-github-actions-runners/ diff --git a/ci-job-69313533034.log b/ci-job-69313533034.log new file mode 100644 index 000000000..89da944f3 --- /dev/null +++ b/ci-job-69313533034.log @@ -0,0 +1,364 @@ +2026-03-31T08:12:08.7635919Z Current runner version: '2.333.1' +2026-03-31T08:12:08.7671200Z ##[group]Runner Image Provisioner +2026-03-31T08:12:08.7672694Z Hosted Compute Agent +2026-03-31T08:12:08.7673638Z Version: 20260213.493 +2026-03-31T08:12:08.7674578Z Commit: 5c115507f6dd24b8de37d8bbe0bb4509d0cc0fa3 +2026-03-31T08:12:08.7675762Z Build Date: 2026-02-13T00:28:41Z +2026-03-31T08:12:08.7676710Z Worker ID: {d0d7f692-3925-4ee4-9d83-cbe3f08b228f} +2026-03-31T08:12:08.7677835Z Azure Region: centralus +2026-03-31T08:12:08.7678828Z ##[endgroup] +2026-03-31T08:12:08.7681764Z ##[group]Operating System +2026-03-31T08:12:08.7682711Z Ubuntu +2026-03-31T08:12:08.7683547Z 24.04.4 +2026-03-31T08:12:08.7684308Z LTS +2026-03-31T08:12:08.7684995Z ##[endgroup] +2026-03-31T08:12:08.7686001Z ##[group]Runner Image +2026-03-31T08:12:08.7687016Z Image: ubuntu-24.04 +2026-03-31T08:12:08.7687938Z Version: 20260323.65.1 +2026-03-31T08:12:08.7690082Z Included Software: https://github.com/actions/runner-images/blob/ubuntu24/20260323.65/images/ubuntu/Ubuntu2404-Readme.md +2026-03-31T08:12:08.7692789Z Image Release: https://github.com/actions/runner-images/releases/tag/ubuntu24%2F20260323.65 +2026-03-31T08:12:08.7694411Z ##[endgroup] +2026-03-31T08:12:08.7696019Z ##[group]GITHUB_TOKEN Permissions +2026-03-31T08:12:08.7698765Z Contents: read +2026-03-31T08:12:08.7699697Z Metadata: read +2026-03-31T08:12:08.7701250Z ##[endgroup] +2026-03-31T08:12:08.7704098Z Secret source: Actions +2026-03-31T08:12:08.7705832Z Prepare workflow directory +2026-03-31T08:12:08.8076240Z Prepare all required actions +2026-03-31T08:12:08.8115858Z Getting action download info +2026-03-31T08:12:09.2126029Z Download action repository 'actions/checkout@v4' (SHA:34e114876b0b11c390a56381ad16ebd13914f8d5) +2026-03-31T08:12:09.3683029Z Download action repository 'actions/setup-node@v4' (SHA:49933ea5288caeca8642d1e84afbd3f7d6820020) +2026-03-31T08:12:09.5526638Z Complete job name: 📋 Template Integrity +2026-03-31T08:12:09.6244453Z ##[group]Run actions/checkout@v4 +2026-03-31T08:12:09.6245388Z with: +2026-03-31T08:12:09.6245773Z repository: virtengine/bosun +2026-03-31T08:12:09.6246451Z token: *** +2026-03-31T08:12:09.6246826Z ssh-strict: true +2026-03-31T08:12:09.6247210Z ssh-user: git +2026-03-31T08:12:09.6247603Z persist-credentials: true +2026-03-31T08:12:09.6248043Z clean: true +2026-03-31T08:12:09.6248428Z sparse-checkout-cone-mode: true +2026-03-31T08:12:09.6248900Z fetch-depth: 1 +2026-03-31T08:12:09.6249271Z fetch-tags: false +2026-03-31T08:12:09.6249659Z show-progress: true +2026-03-31T08:12:09.6250062Z lfs: false +2026-03-31T08:12:09.6250425Z submodules: false +2026-03-31T08:12:09.6251027Z set-safe-directory: true +2026-03-31T08:12:09.6251737Z ##[endgroup] +2026-03-31T08:12:09.7367292Z Syncing repository: virtengine/bosun +2026-03-31T08:12:09.7369040Z ##[group]Getting Git version info +2026-03-31T08:12:09.7369709Z Working directory is '/home/runner/work/bosun/bosun' +2026-03-31T08:12:09.7371039Z [command]/usr/bin/git version +2026-03-31T08:12:09.7419451Z git version 2.53.0 +2026-03-31T08:12:09.7447910Z ##[endgroup] +2026-03-31T08:12:09.7464710Z Temporarily overriding HOME='/home/runner/work/_temp/25cbb6fc-3adb-49fd-b50d-49c157cab713' before making global git config changes +2026-03-31T08:12:09.7467090Z Adding repository directory to the temporary git global config as a safe directory +2026-03-31T08:12:09.7471641Z [command]/usr/bin/git config --global --add safe.directory /home/runner/work/bosun/bosun +2026-03-31T08:12:09.7506362Z Deleting the contents of '/home/runner/work/bosun/bosun' +2026-03-31T08:12:09.7510784Z ##[group]Initializing the repository +2026-03-31T08:12:09.7515648Z [command]/usr/bin/git init /home/runner/work/bosun/bosun +2026-03-31T08:12:09.7605487Z hint: Using 'master' as the name for the initial branch. This default branch name +2026-03-31T08:12:09.7607076Z hint: will change to "main" in Git 3.0. To configure the initial branch name +2026-03-31T08:12:09.7608018Z hint: to use in all of your new repositories, which will suppress this warning, +2026-03-31T08:12:09.7608751Z hint: call: +2026-03-31T08:12:09.7609311Z hint: +2026-03-31T08:12:09.7610073Z hint: git config --global init.defaultBranch +2026-03-31T08:12:09.7610934Z hint: +2026-03-31T08:12:09.7611516Z hint: Names commonly chosen instead of 'master' are 'main', 'trunk' and +2026-03-31T08:12:09.7612880Z hint: 'development'. The just-created branch can be renamed via this command: +2026-03-31T08:12:09.7613572Z hint: +2026-03-31T08:12:09.7613944Z hint: git branch -m +2026-03-31T08:12:09.7614364Z hint: +2026-03-31T08:12:09.7614945Z hint: Disable this message with "git config set advice.defaultBranchName false" +2026-03-31T08:12:09.7616046Z Initialized empty Git repository in /home/runner/work/bosun/bosun/.git/ +2026-03-31T08:12:09.7617948Z [command]/usr/bin/git remote add origin https://github.com/virtengine/bosun +2026-03-31T08:12:09.7649051Z ##[endgroup] +2026-03-31T08:12:09.7649772Z ##[group]Disabling automatic garbage collection +2026-03-31T08:12:09.7653702Z [command]/usr/bin/git config --local gc.auto 0 +2026-03-31T08:12:09.7681842Z ##[endgroup] +2026-03-31T08:12:09.7682524Z ##[group]Setting up auth +2026-03-31T08:12:09.7688862Z [command]/usr/bin/git config --local --name-only --get-regexp core\.sshCommand +2026-03-31T08:12:09.7717680Z [command]/usr/bin/git submodule foreach --recursive sh -c "git config --local --name-only --get-regexp 'core\.sshCommand' && git config --local --unset-all 'core.sshCommand' || :" +2026-03-31T08:12:09.8029205Z [command]/usr/bin/git config --local --name-only --get-regexp http\.https\:\/\/github\.com\/\.extraheader +2026-03-31T08:12:09.8064494Z [command]/usr/bin/git submodule foreach --recursive sh -c "git config --local --name-only --get-regexp 'http\.https\:\/\/github\.com\/\.extraheader' && git config --local --unset-all 'http.https://github.com/.extraheader' || :" +2026-03-31T08:12:09.8305684Z [command]/usr/bin/git config --local --name-only --get-regexp ^includeIf\.gitdir: +2026-03-31T08:12:09.8355840Z [command]/usr/bin/git submodule foreach --recursive git config --local --show-origin --name-only --get-regexp remote.origin.url +2026-03-31T08:12:09.8584890Z [command]/usr/bin/git config --local http.https://github.com/.extraheader AUTHORIZATION: basic *** +2026-03-31T08:12:09.8618305Z ##[endgroup] +2026-03-31T08:12:09.8619569Z ##[group]Fetching the repository +2026-03-31T08:12:09.8628032Z [command]/usr/bin/git -c protocol.version=2 fetch --no-tags --prune --no-recurse-submodules --depth=1 origin +543c25292a12f88977efc9bfa17079cec051e390:refs/remotes/pull/437/merge +2026-03-31T08:12:11.1701723Z From https://github.com/virtengine/bosun +2026-03-31T08:12:11.1704885Z * [new ref] 543c25292a12f88977efc9bfa17079cec051e390 -> pull/437/merge +2026-03-31T08:12:11.1732244Z ##[endgroup] +2026-03-31T08:12:11.1734327Z ##[group]Determining the checkout info +2026-03-31T08:12:11.1736343Z ##[endgroup] +2026-03-31T08:12:11.1740758Z [command]/usr/bin/git sparse-checkout disable +2026-03-31T08:12:11.1778612Z [command]/usr/bin/git config --local --unset-all extensions.worktreeConfig +2026-03-31T08:12:11.1804995Z ##[group]Checking out the ref +2026-03-31T08:12:11.1808904Z [command]/usr/bin/git checkout --progress --force refs/remotes/pull/437/merge +2026-03-31T08:12:11.3085252Z Note: switching to 'refs/remotes/pull/437/merge'. +2026-03-31T08:12:11.3086221Z +2026-03-31T08:12:11.3086921Z You are in 'detached HEAD' state. You can look around, make experimental +2026-03-31T08:12:11.3088582Z changes and commit them, and you can discard any commits you make in this +2026-03-31T08:12:11.3090192Z state without impacting any branches by switching back to a branch. +2026-03-31T08:12:11.3092097Z +2026-03-31T08:12:11.3093189Z If you want to create a new branch to retain commits you create, you may +2026-03-31T08:12:11.3095531Z do so (now or later) by using -c with the switch command. Example: +2026-03-31T08:12:11.3096859Z +2026-03-31T08:12:11.3097399Z git switch -c +2026-03-31T08:12:11.3098337Z +2026-03-31T08:12:11.3098942Z Or undo this operation with: +2026-03-31T08:12:11.3099840Z +2026-03-31T08:12:11.3100378Z git switch - +2026-03-31T08:12:11.3101485Z +2026-03-31T08:12:11.3102996Z Turn off this advice by setting config variable advice.detachedHead to false +2026-03-31T08:12:11.3104858Z +2026-03-31T08:12:11.3106817Z HEAD is now at 543c252 Merge d5665d1854745adf838443c2b0162cc67673514e into 66f9a9e4fbb9b3e822f4d36a49e0d6537379e769 +2026-03-31T08:12:11.3112988Z ##[endgroup] +2026-03-31T08:12:11.3141208Z [command]/usr/bin/git log -1 --format=%H +2026-03-31T08:12:11.3166052Z 543c25292a12f88977efc9bfa17079cec051e390 +2026-03-31T08:12:11.3507670Z ##[group]Run actions/setup-node@v4 +2026-03-31T08:12:11.3508868Z with: +2026-03-31T08:12:11.3509677Z node-version: 24 +2026-03-31T08:12:11.3510797Z cache: npm +2026-03-31T08:12:11.3511812Z cache-dependency-path: package-lock.json +2026-03-31T08:12:11.3513049Z always-auth: false +2026-03-31T08:12:11.3513964Z check-latest: false +2026-03-31T08:12:11.3515213Z token: *** +2026-03-31T08:12:11.3516033Z ##[endgroup] +2026-03-31T08:12:11.5321303Z Found in cache @ /opt/hostedtoolcache/node/24.14.0/x64 +2026-03-31T08:12:11.5328475Z ##[group]Environment details +2026-03-31T08:12:14.9034761Z node: v24.14.0 +2026-03-31T08:12:14.9035286Z npm: 11.9.0 +2026-03-31T08:12:14.9035519Z yarn: 1.22.22 +2026-03-31T08:12:14.9036356Z ##[endgroup] +2026-03-31T08:12:14.9062084Z [command]/opt/hostedtoolcache/node/24.14.0/x64/bin/npm config get cache +2026-03-31T08:12:15.1207183Z /home/runner/.npm +2026-03-31T08:12:15.2761741Z Cache hit for: node-cache-Linux-x64-npm-a4608dccb002348567ca67ca7fbaf89f2377543f3855fd295b180ae8cd05f22a +2026-03-31T08:12:16.4463466Z Received 62914560 of 469488352 (13.4%), 60.0 MBs/sec +2026-03-31T08:12:17.4442171Z Received 243269632 of 469488352 (51.8%), 115.9 MBs/sec +2026-03-31T08:12:18.4449787Z Received 381681664 of 469488352 (81.3%), 121.3 MBs/sec +2026-03-31T08:12:19.2565859Z Received 469488352 of 469488352 (100.0%), 117.4 MBs/sec +2026-03-31T08:12:19.2573098Z Cache Size: ~448 MB (469488352 B) +2026-03-31T08:12:19.2705841Z [command]/usr/bin/tar -xf /home/runner/work/_temp/1f237839-d261-4c2b-a79c-3fed6d12f91d/cache.tzst -P -C /home/runner/work/bosun/bosun --use-compress-program unzstd +2026-03-31T08:12:20.4083715Z Cache restored successfully +2026-03-31T08:12:20.4315921Z Cache restored from key: node-cache-Linux-x64-npm-a4608dccb002348567ca67ca7fbaf89f2377543f3855fd295b180ae8cd05f22a +2026-03-31T08:12:20.4544981Z ##[group]Run npm ci +2026-03-31T08:12:20.4545419Z npm ci +2026-03-31T08:12:20.4593325Z shell: /usr/bin/bash -e {0} +2026-03-31T08:12:20.4593751Z ##[endgroup] +2026-03-31T08:12:26.3879045Z npm warn deprecated node-domexception@1.0.0: Use your platform's native DOMException instead +2026-03-31T08:12:31.7905958Z +2026-03-31T08:12:31.7906607Z > bosun@0.42.5 preinstall +2026-03-31T08:12:31.7911009Z > node -e "try{var r=require('child_process').execSync('npm ls -g codex-monitor --json --depth=0',{encoding:'utf8',stdio:['pipe','pipe','pipe']});var d=JSON.parse(r).dependencies;if(d&&d['codex-monitor']){console.log('\n Removing old codex-monitor package...');require('child_process').execSync('npm uninstall -g codex-monitor',{stdio:'inherit',timeout:30000});console.log(' \u2705 Migrated to bosun. codex-monitor aliases still work.\n')}}catch(e){}" +2026-03-31T08:12:31.7913981Z +2026-03-31T08:12:32.3120339Z +2026-03-31T08:12:32.3123383Z > bosun@0.42.5 postinstall +2026-03-31T08:12:32.3125136Z > node postinstall.mjs +2026-03-31T08:12:32.3125472Z +2026-03-31T08:12:32.3738332Z +2026-03-31T08:12:32.3739462Z > bosun@0.42.5 prepare +2026-03-31T08:12:32.3740027Z > node tools/vendor-sync.mjs +2026-03-31T08:12:32.3740342Z +2026-03-31T08:12:32.4290097Z [vendor-sync] Syncing vendor files to ui/vendor/ … +2026-03-31T08:12:32.4329604Z [vendor-sync] ✓ node_modules → preact.js +2026-03-31T08:12:32.4341038Z [vendor-sync] ✓ node_modules → preact-hooks.js +2026-03-31T08:12:32.4347003Z [vendor-sync] ✓ node_modules → preact-compat.js +2026-03-31T08:12:32.4353199Z [vendor-sync] ✓ node_modules → htm.js +2026-03-31T08:12:32.4359694Z [vendor-sync] ✓ node_modules → preact-signals-core.js +2026-03-31T08:12:32.4367506Z [vendor-sync] ✓ node_modules → preact-signals.js +2026-03-31T08:12:32.4372753Z [vendor-sync] ✓ node_modules → es-module-shims.js +2026-03-31T08:12:32.4375905Z [vendor-sync] Done — 7 vendor files ready in ui/vendor/ +2026-03-31T08:12:32.4554380Z +2026-03-31T08:12:32.4555245Z added 391 packages, and audited 392 packages in 12s +2026-03-31T08:12:32.4555735Z +2026-03-31T08:12:32.4556160Z 108 packages are looking for funding +2026-03-31T08:12:32.4557004Z run `npm fund` for details +2026-03-31T08:12:32.4591999Z +2026-03-31T08:12:32.4592383Z 2 vulnerabilities (1 moderate, 1 high) +2026-03-31T08:12:32.4592735Z +2026-03-31T08:12:32.4592877Z To address all issues, run: +2026-03-31T08:12:32.4593164Z npm audit fix +2026-03-31T08:12:32.4593300Z +2026-03-31T08:12:32.4593431Z Run `npm audit` for details. +2026-03-31T08:12:32.5833747Z ##[group]Run node --input-type=module <<'EOF' +2026-03-31T08:12:32.5834125Z node --input-type=module <<'EOF' +2026-03-31T08:12:32.5834539Z import { WORKFLOW_TEMPLATES } from "./workflow/workflow-templates.mjs"; +2026-03-31T08:12:32.5835053Z console.log(`✅ Loaded ${WORKFLOW_TEMPLATES.length} templates`); +2026-03-31T08:12:32.5835524Z if (!WORKFLOW_TEMPLATES.length) process.exit(1); +2026-03-31T08:12:32.5835818Z EOF +2026-03-31T08:12:32.5864148Z shell: /usr/bin/bash -e {0} +2026-03-31T08:12:32.5864392Z ##[endgroup] +2026-03-31T08:12:32.6468330Z ✅ Loaded 63 templates +2026-03-31T08:12:32.6557364Z ##[group]Run node tests/sandbox/validate-template-nodes.mjs +2026-03-31T08:12:32.6557799Z node tests/sandbox/validate-template-nodes.mjs +2026-03-31T08:12:32.6586251Z shell: /usr/bin/bash -e {0} +2026-03-31T08:12:32.6586493Z ##[endgroup] +2026-03-31T08:12:32.7847480Z +2026-03-31T08:12:32.7848388Z 📋 Template Integrity Report +2026-03-31T08:12:32.7849841Z Templates : 63 +2026-03-31T08:12:32.7850272Z Nodes : 675 +2026-03-31T08:12:32.7850928Z Edges : 699 +2026-03-31T08:12:32.7851149Z +2026-03-31T08:12:32.7851481Z ⚠️ Warnings (133): +2026-03-31T08:12:32.7852661Z [template-release-drafter] Node "draft-notes" references "{{prList}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7855344Z [template-release-drafter] Node "draft-notes" references "{{commitLog}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7857279Z [template-release-drafter] Node "draft-notes" references "{{lastTag}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7859112Z [template-release-drafter] Node "save-draft" references "{{releaseNotes}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7861220Z [template-sdk-conflict-resolver] Node "launch-agent" references "{{manualFiles}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7863060Z [template-backend-agent] Node "write-tests" references "{{plan}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7864314Z [template-backend-agent] Node "create-pr" references "{{plan}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7865348Z [template-backend-agent] Node "auto-fix" references "{{plan}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7866222Z [template-backend-agent] Node "create-pr-retry" references "{{plan}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7867238Z [template-meeting-subworkflow-chain] Node "execute-child-workflow" references "{{_workflowId}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7868398Z [template-meeting-subworkflow-chain] Node "execute-child-workflow" references "{{_workflowRunId}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7869491Z [template-nightly-report] Node "generate-report" references "{{taskStats}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7870719Z [template-nightly-report] Node "generate-report" references "{{prStats}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7871961Z [template-nightly-report] Node "generate-report" references "{{agentStats}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7873343Z [template-nightly-report] Node "send-report" references "{{reportOutput}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7874364Z [template-sprint-retrospective] Node "generate-retro" references "{{taskMetrics}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7875417Z [template-sprint-retrospective] Node "generate-retro" references "{{prMetrics}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7876693Z [template-sprint-retrospective] Node "generate-retro" references "{{errorAnalysis}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7877780Z [template-sprint-retrospective] Node "generate-retro" references "{{agentStats}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7878837Z [template-sprint-retrospective] Node "send-report" references "{{retroOutput}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7879880Z [template-error-recovery] Node "analyze-error" references "{{lastError}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7881461Z [template-error-recovery] Node "retry-task" references "{{taskExecutorRetryPrompt}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7882613Z [template-error-recovery] Node "retry-task" references "{{lastError}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7883580Z [template-error-recovery] Node "escalate" references "{{lastError}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7884592Z [template-anomaly-watchdog] Node "log-intervention" references "{{anomalyType}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7885641Z [template-anomaly-watchdog] Node "alert-telegram" references "{{anomalyType}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7886693Z [template-task-finalization-guard] Node "mark-inreview" references "{{prUrl}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7887826Z [template-task-status-transition-manager] Node "unknown-status" references "{{targetStatus}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7888935Z [template-incident-response] Node "classify-incident" references "{{evidence}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7890031Z [template-incident-response] Node "create-incident-task" references "{{incidentCategory}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7891359Z [template-incident-response] Node "create-incident-task" references "{{evidence}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7892462Z [template-incident-response] Node "create-incident-task" references "{{classification}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7893578Z [template-incident-response] Node "assign-agent" references "{{classification}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7894630Z [template-incident-response] Node "assign-agent" references "{{evidence}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7895728Z [template-incident-response] Node "alert-critical" references "{{incidentCategory}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7896726Z [template-incident-response] Node "alert-critical" references "{{rootCause}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7898024Z [template-incident-response] Node "alert-standard" references "{{incidentCategory}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7899968Z [template-task-archiver] Node "archive-to-file" references "{{taskJson}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7901531Z [template-task-archiver] Node "cleanup-sessions" references "{{attemptId}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7902458Z [template-sync-engine] Node "pull-external" references "{{projectId}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7903356Z [template-sync-engine] Node "push-internal" references "{{projectId}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7904278Z [template-sync-engine] Node "alert-failures" references "{{lastSyncErrors}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7905181Z [template-sync-engine] Node "log-success" references "{{pullCount}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7906563Z [template-sync-engine] Node "log-success" references "{{pushCount}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7908200Z [template-sync-engine] Node "log-success" references "{{conflictCount}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7910064Z [template-sync-engine] Node "log-partial" references "{{lastSyncErrors}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7911997Z [template-dependency-audit] Node "create-fix-pr" references "{{_runId}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7913697Z [template-secret-scanner] Node "classify-secret" references "{{scanOutput}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7915600Z [template-task-fullstack] Node "plan-architecture" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7917368Z [template-task-fullstack] Node "plan-architecture" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7919335Z [template-task-fullstack] Node "plan-architecture" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7921261Z [template-task-fullstack] Node "implement-backend" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7923145Z [template-task-fullstack] Node "implement-backend" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7924804Z [template-task-fullstack] Node "implement-backend" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7926497Z [template-task-fullstack] Node "implement-frontend" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7928370Z [template-task-fullstack] Node "implement-frontend" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7930203Z [template-task-fullstack] Node "implement-frontend" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7932220Z [template-task-fullstack] Node "integration-test" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7933671Z [template-task-fullstack] Node "integration-test" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7934660Z [template-task-fullstack] Node "integration-test" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7935560Z [template-task-backend] Node "plan" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7937307Z [template-task-backend] Node "plan" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7938784Z [template-task-backend] Node "plan" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7939858Z [template-task-backend] Node "implement-tdd" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7941081Z [template-task-backend] Node "implement-tdd" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7942058Z [template-task-backend] Node "implement-tdd" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7942994Z [template-task-backend] Node "verify" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7943877Z [template-task-backend] Node "verify" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7944765Z [template-task-backend] Node "verify" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7945677Z [template-task-frontend] Node "analyse-design" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7946750Z [template-task-frontend] Node "analyse-design" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7947716Z [template-task-frontend] Node "analyse-design" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7948647Z [template-task-frontend] Node "implement-ui" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7949560Z [template-task-frontend] Node "implement-ui" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7950702Z [template-task-frontend] Node "implement-ui" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7951860Z [template-task-frontend] Node "verify-visual" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7952950Z [template-task-frontend] Node "verify-visual" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7953907Z [template-task-frontend] Node "verify-visual" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7954804Z [template-task-debug] Node "reproduce" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7955690Z [template-task-debug] Node "reproduce" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7956563Z [template-task-debug] Node "reproduce" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7957437Z [template-task-debug] Node "fix-and-test" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7958591Z [template-task-debug] Node "fix-and-test" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7959493Z [template-task-debug] Node "fix-and-test" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7960362Z [template-task-debug] Node "verify" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7961498Z [template-task-debug] Node "verify" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7962348Z [template-task-debug] Node "verify" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7963233Z [template-task-cicd] Node "plan-pipeline" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7964332Z [template-task-cicd] Node "plan-pipeline" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7965232Z [template-task-cicd] Node "plan-pipeline" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7966152Z [template-task-cicd] Node "implement-pipeline" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7967092Z [template-task-cicd] Node "implement-pipeline" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7968030Z [template-task-cicd] Node "implement-pipeline" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7968951Z [template-task-cicd] Node "verify-pipeline" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7969859Z [template-task-cicd] Node "verify-pipeline" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7971021Z [template-task-cicd] Node "verify-pipeline" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7972112Z [template-task-design] Node "analyse-requirements" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7973113Z [template-task-design] Node "analyse-requirements" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7974088Z [template-task-design] Node "analyse-requirements" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7975034Z [template-task-design] Node "implement-design" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7975972Z [template-task-design] Node "implement-design" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7976919Z [template-task-design] Node "implement-design" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7977849Z [template-task-design] Node "verify-design" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7978754Z [template-task-design] Node "verify-design" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7979664Z [template-task-design] Node "verify-design" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7980883Z [template-task-lifecycle] Node "acquire-worktree" references "{{repoRoot}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7981969Z [template-task-lifecycle] Node "resolve-executor" references "{{repoRoot}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7982925Z [template-task-lifecycle] Node "resolve-executor" references "{{workspace}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7983902Z [template-task-lifecycle] Node "read-workflow-contract" references "{{repoRoot}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7984922Z [template-task-lifecycle] Node "workflow-contract-validation" references "{{repoRoot}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7985892Z [template-task-lifecycle] Node "build-prompt" references "{{repoRoot}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7986785Z [template-task-lifecycle] Node "build-prompt" references "{{repoSlug}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7987689Z [template-task-lifecycle] Node "build-prompt" references "{{workspace}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7988741Z [template-task-lifecycle] Node "build-prompt" references "{{repository}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7989662Z [template-task-lifecycle] Node "build-prompt" references "{{repositories}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7990858Z [template-task-lifecycle] Node "run-agent-plan" references "{{_taskPrompt}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7991833Z [template-task-lifecycle] Node "run-agent-plan" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7992778Z [template-task-lifecycle] Node "run-agent-plan" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7993730Z [template-task-lifecycle] Node "run-agent-plan" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7994687Z [template-task-lifecycle] Node "run-agent-tests" references "{{_taskPrompt}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7995622Z [template-task-lifecycle] Node "run-agent-tests" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7996746Z [template-task-lifecycle] Node "run-agent-tests" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7997710Z [template-task-lifecycle] Node "run-agent-tests" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7998675Z [template-task-lifecycle] Node "run-agent-implement" references "{{_taskPrompt}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.7999647Z [template-task-lifecycle] Node "run-agent-implement" references "{{resolvedSdk}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.8000832Z [template-task-lifecycle] Node "run-agent-implement" references "{{resolvedModel}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.8001842Z [template-task-lifecycle] Node "run-agent-implement" references "{{agentProfile}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.8002803Z [template-task-lifecycle] Node "release-worktree" references "{{repoRoot}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.8003729Z [template-task-lifecycle] Node "recover-worktree" references "{{repoRoot}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.8004641Z [template-task-lifecycle] Node "retry-acquire-wt" references "{{repoRoot}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.8005555Z [template-task-lifecycle] Node "sweep-task-wts" references "{{repoRoot}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.8006482Z [template-research-agent] Node "generator" references "{{_previousFeedback}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.8007419Z [template-mcp-iterative-research] Node "research" references "{{topic}}" which is not in template.variables or well-known inputs +2026-03-31T08:12:32.8007893Z +2026-03-31T08:12:32.8008317Z ✅ All integrity checks passed — 63 templates are well-formed. +2026-03-31T08:12:32.8034640Z ##[group]Run node tools/prepublish-check.mjs +2026-03-31T08:12:32.8034993Z node tools/prepublish-check.mjs +2026-03-31T08:12:32.8062261Z shell: /usr/bin/bash -e {0} +2026-03-31T08:12:32.8062505Z ##[endgroup] +2026-03-31T08:12:33.2224505Z :close: Published local imports missing from package.json files array: +2026-03-31T08:12:33.2226615Z workflow/mcp-discovery-proxy.mjs -> ../infra/windows-hidden-child-processes.mjs (infra/windows-hidden-child-processes.mjs) +2026-03-31T08:12:33.2228312Z workflow/mcp-registry.mjs -> ../infra/windows-hidden-child-processes.mjs (infra/windows-hidden-child-processes.mjs) +2026-03-31T08:12:33.2229376Z +2026-03-31T08:12:33.2229722Z Add the resolved targets to the 'files' array in package.json. +2026-03-31T08:12:33.2303212Z ##[error]Process completed with exit code 1. +2026-03-31T08:12:33.2428187Z Post job cleanup. +2026-03-31T08:12:33.3398613Z [command]/usr/bin/git version +2026-03-31T08:12:33.3435700Z git version 2.53.0 +2026-03-31T08:12:33.3488520Z Temporarily overriding HOME='/home/runner/work/_temp/397ed9d9-2487-4844-8a86-8fa8bb3f07d9' before making global git config changes +2026-03-31T08:12:33.3490110Z Adding repository directory to the temporary git global config as a safe directory +2026-03-31T08:12:33.3495149Z [command]/usr/bin/git config --global --add safe.directory /home/runner/work/bosun/bosun +2026-03-31T08:12:33.3531427Z [command]/usr/bin/git config --local --name-only --get-regexp core\.sshCommand +2026-03-31T08:12:33.3564667Z [command]/usr/bin/git submodule foreach --recursive sh -c "git config --local --name-only --get-regexp 'core\.sshCommand' && git config --local --unset-all 'core.sshCommand' || :" +2026-03-31T08:12:33.3795280Z [command]/usr/bin/git config --local --name-only --get-regexp http\.https\:\/\/github\.com\/\.extraheader +2026-03-31T08:12:33.3817424Z http.https://github.com/.extraheader +2026-03-31T08:12:33.3830243Z [command]/usr/bin/git config --local --unset-all http.https://github.com/.extraheader +2026-03-31T08:12:33.3861748Z [command]/usr/bin/git submodule foreach --recursive sh -c "git config --local --name-only --get-regexp 'http\.https\:\/\/github\.com\/\.extraheader' && git config --local --unset-all 'http.https://github.com/.extraheader' || :" +2026-03-31T08:12:33.4081848Z [command]/usr/bin/git config --local --name-only --get-regexp ^includeIf\.gitdir: +2026-03-31T08:12:33.4113545Z [command]/usr/bin/git submodule foreach --recursive git config --local --show-origin --name-only --get-regexp remote.origin.url +2026-03-31T08:12:33.4485684Z Cleaning up orphan processes +2026-03-31T08:12:33.4896334Z ##[warning]Node.js 20 actions are deprecated. The following actions are running on Node.js 20 and may not work as expected: actions/checkout@v4, actions/setup-node@v4. Actions will be forced to run with Node.js 24 by default starting June 2nd, 2026. Node.js 20 will be removed from the runner on September 16th, 2026. Please check if updated versions of these actions are available that support Node.js 24. To opt into Node.js 24 now, set the FORCE_JAVASCRIPT_ACTIONS_TO_NODE24=true environment variable on the runner or in your workflow file. Once Node.js 24 becomes the default, you can temporarily opt out by setting ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION=true. For more information see: https://github.blog/changelog/2025-09-19-deprecation-of-node-20-on-github-actions-runners/ diff --git a/cli.mjs b/cli.mjs index 15c84cfec..32ed20823 100755 --- a/cli.mjs +++ b/cli.mjs @@ -28,7 +28,6 @@ import { fileURLToPath, pathToFileURL } from "node:url"; import { execFileSync, execSync, spawn } from "node:child_process"; import os from "node:os"; import { Worker } from "node:worker_threads"; -import "./infra/windows-hidden-child-processes.mjs"; import { createDaemonCrashTracker } from "./infra/daemon-restart-policy.mjs"; import { ensureTestRuntimeSandbox } from "./infra/test-runtime.mjs"; import { @@ -86,7 +85,6 @@ function showHelp() { workflow list List declarative pipeline workflows workflow run Run a declarative pipeline workflow workflow nodes Inspect custom workflow node plugin health - eval Run agent evaluation and benchmarking tools tui Launch the terminal UI audit Run codebase annotation audit tools (scan|generate|warn|manifest|index|trim|conformity|migrate) --setup Launch the web-based setup wizard (default) @@ -111,7 +109,6 @@ function showHelp() { --no-auto-update Disable background auto-update polling --daemon, -d Run as a background daemon (detached, with PID file) --stop-daemon Stop a running daemon process - --restart Request a code reload from the running bosun instance --terminate Hard-stop all bosun processes (daemon + monitor + companions) --daemon-status Check if daemon is running @@ -177,7 +174,6 @@ function showHelp() { workflow run Run a declarative fresh-context workflow Run 'bosun workflow --help' for workflow CLI examples. - Run 'bosun eval --help' for evaluation CLI examples. Run 'bosun tui' to launch the terminal UI. STARTUP SERVICE @@ -332,7 +328,6 @@ const LEGACY_MONITOR_PID_FILE = resolve(__dirname, ".cache", "bosun.pid"); const DAEMON_PID_FILE = resolve(runtimeCacheDir, "bosun-daemon.pid"); const LEGACY_DAEMON_PID_FILE = resolve(__dirname, ".cache", "bosun-daemon.pid"); const DAEMON_LOG = resolve(__dirname, "logs", "daemon.log"); -const RESTART_REQUEST_FILE_NAME = "bosun-restart-request.json"; const SENTINEL_PID_FILE = resolve( runtimeCacheDir, "telegram-sentinel.pid", @@ -432,11 +427,8 @@ async function getConfiguredRuntimeCacheDirs() { try { const { loadConfig } = await import("./config/config.mjs"); const config = loadConfig(); - const configuredCacheDir = String(config?.cacheDir || "").trim() || null; - return uniqueResolvedPaths([ - runtimeCacheDir, - configuredCacheDir, - ...getRuntimeCacheDirCandidates(), + return getRuntimeCacheDirCandidates([ + String(config?.cacheDir || "").trim() || null, ]); } catch { return getRuntimeCacheDirCandidates(); @@ -504,22 +496,6 @@ function isProcessAlive(pid) { return true; } catch (err) { if (err && (err.code === "EPERM" || err.code === "EACCES")) { - if (process.platform === "win32") { - try { - const output = execFileSync( - "powershell", - [ - "-NoProfile", - "-Command", - `Get-CimInstance Win32_Process -Filter "ProcessId = ${Number(pid)}" -ErrorAction SilentlyContinue | Select-Object -ExpandProperty ProcessId`, - ], - { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"], timeout: 3000, windowsHide: true }, - ).trim(); - return output === String(Number(pid)); - } catch { - return false; - } - } return true; } return false; @@ -950,7 +926,7 @@ function stopDaemon() { } } -async function daemonStatus() { +function daemonStatus() { const pid = getDaemonPid(); if (pid) { console.log(` bosun daemon is running (PID ${pid})`); @@ -966,8 +942,7 @@ async function daemonStatus() { } console.log(` Run --terminate to stop restart owners, then --daemon to restart.`); } else { - const configuredCacheDirs = await getConfiguredRuntimeCacheDirs(); - const existingMonitorOwner = detectExistingMonitorLockOwner(null, configuredCacheDirs); + const existingMonitorOwner = detectExistingMonitorLockOwner(); if (existingMonitorOwner) { console.log( ` bosun daemon is not running in daemon mode, but bosun monitor is active (PID ${existingMonitorOwner.pid}).`, @@ -1010,12 +985,7 @@ function findAllBosunProcessPids() { ]; const joined = patterns.join("|"); if (process.platform === "win32") { - let cmdPids = []; try { - // Primary: CommandLine-based scan. - // NOTE: Win32_Process.CommandLine can be null/empty under WMI race conditions - // for long-running processes. We re-verify null-CommandLine node.exe PIDs by - // querying them individually below to work around the WMI race. const out = execFileSync( "powershell", [ @@ -1034,51 +1004,14 @@ function findAllBosunProcessPids() { ], { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"], timeout: 4000 }, ).trim(); - if (out) { - cmdPids = out - .split(/\r?\n/) - .map((s) => Number.parseInt(String(s).trim(), 10)) - .filter((pid) => Number.isFinite(pid) && pid > 0 && pid !== process.pid); - } - } catch { - // fall through to port-based fallback - } - - // Fallback: find node.exe PIDs listening on known Bosun ports (4400, 3080). - // This catches processes whose CommandLine was null in the WMI general scan. - let portPids = []; - try { - const netOut = execFileSync( - "powershell", - [ - "-NoProfile", - "-Command", - `$bosunPorts = @(4400,3080,4401,3081) - $listeners = Get-NetTCPConnection -State Listen -ErrorAction SilentlyContinue | - Where-Object { $bosunPorts -contains $_.LocalPort } | - Select-Object -ExpandProperty OwningProcess -Unique - $listeners | Where-Object { - $pid = [int]$_ - if ($pid -le 0 -or $pid -eq ${process.pid}) { return $false } - $proc = Get-CimInstance Win32_Process -Filter "ProcessId=$pid" -ErrorAction SilentlyContinue - $name = [string]$proc.Name - $name -match '^(node|electron|bosun)(\\.exe)?$' - }`, - ], - { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"], timeout: 5000 }, - ).trim(); - if (netOut) { - portPids = netOut - .split(/\r?\n/) - .map((s) => Number.parseInt(String(s).trim(), 10)) - .filter((pid) => Number.isFinite(pid) && pid > 0 && pid !== process.pid); - } + if (!out) return []; + return out + .split(/\r?\n/) + .map((s) => Number.parseInt(String(s).trim(), 10)) + .filter((pid) => Number.isFinite(pid) && pid > 0 && pid !== process.pid); } catch { - // port scan unavailable — cmdPids is still used + return []; } - - // Merge both sets, deduplicating - return Array.from(new Set([...cmdPids, ...portPids])); } try { const out = execFileSync("pgrep", ["-f", joined], { @@ -1203,7 +1136,7 @@ function taskkillPidsElevated(pids, { force = false } = {}) { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"], timeout: 30000, - windowsHide: true, + windowsHide: false, }, ); } catch { @@ -1471,8 +1404,6 @@ async function main() { console.error(` Error: ${err.message}`); process.exit(1); } - - process.exit(0); } @@ -1515,18 +1446,6 @@ async function main() { process.exit(exitCode ?? 0); } - const evalFlagIndex = args.indexOf("--eval"); - const evalCommandIndex = args.indexOf("eval"); - if (evalFlagIndex >= 0 || evalCommandIndex >= 0) { - const commandStartIndex = - evalFlagIndex >= 0 && evalCommandIndex >= 0 - ? Math.min(evalFlagIndex, evalCommandIndex) - : (evalCommandIndex >= 0 ? evalCommandIndex : evalFlagIndex); - const evalArgs = args.slice(commandStartIndex + 1); - const { runEvalCli } = await import("./bench/eval-framework.mjs"); - const { exitCode } = await runEvalCli(evalArgs); - process.exit(exitCode ?? 0); - } // Handle --help if (args.includes("--help") || args.includes("-h")) { showHelp(); @@ -1759,26 +1678,7 @@ async function main() { return; } if (args.includes("--daemon-status")) { - await daemonStatus(); - return; - } - if (args.includes("--restart")) { - try { - const result = await requestRunningBosunRestart("cli-restart"); - const modeLabel = result.daemon ? "daemon" : "monitor"; - console.log( - ` Requested Bosun code reload from the running ${modeLabel} instance (PID ${result.targetPid}).`, - ); - console.log( - " The live instance will restart itself with fresh modules using its current launch path.", - ); - console.log( - " If internal agent slots are busy, the reload stays queued until restart protection clears.\n", - ); - } catch (err) { - console.error(` --restart failed: ${err?.message || err}`); - process.exit(1); - } + daemonStatus(); return; } @@ -2192,12 +2092,9 @@ async function main() { // Handle --workspace-status if (args.includes("--workspace-status") || args.includes("workspace-status")) { const { getWorkspaceStateSummary } = await import("./workspace/workspace-manager.mjs"); - const { getToolOverheadReport } = await import("./agent/agent-tool-config.mjs"); const configDirArg = getArgValue("--config-dir"); const configDir = configDirArg || process.env.BOSUN_DIR || resolveConfigDirForCli(); const summary = getWorkspaceStateSummary(configDir); - const toolOverhead = getToolOverheadReport(configDir, "primary"); - const overheadSources = Object.entries(toolOverhead.bySource || {}); if (summary.length === 0) { console.log("\n No workspaces configured.\n"); } else { @@ -2215,16 +2112,8 @@ async function main() { console.log(` enabled workflows: ${ws.enabledWorkflows.join(", ")}`); } } + console.log(""); } - if (toolOverhead.total > 0 || overheadSources.length > 0) { - console.log(" Tool Overhead:"); - console.log(` Total tool chars: ${toolOverhead.total.toLocaleString("en-US")}`); - for (const [source, chars] of overheadSources) { - const warning = Number(chars) > 10000 ? " WARNING: high overhead" : ""; - console.log(` ${source}: ${Number(chars).toLocaleString("en-US")} chars${warning}`); - } - } - console.log(""); process.exit(0); } @@ -2425,8 +2314,7 @@ async function main() { process.exit(0); } - const configuredCacheDirs = await getConfiguredRuntimeCacheDirs(); - const existingOwner = detectExistingMonitorLockOwner(null, configuredCacheDirs); + const existingOwner = detectExistingMonitorLockOwner(); if (existingOwner) { console.log( `\n bosun is already running (PID ${existingOwner.pid}); exiting duplicate start.\n`, @@ -2522,19 +2410,13 @@ async function sendCrashNotification(exitCode, signal, options = {}) { // ── Self-restart exit code (must match monitor.mjs SELF_RESTART_EXIT_CODE) ─── const SELF_RESTART_EXIT_CODE = 75; +let monitorChild = null; function getMonitorPidFileCandidates(extraCacheDirs = []) { - return getPidFileCandidates("bosun.pid", extraCacheDirs); -} - -function getRestartRequestFileCandidates(extraCacheDirs = []) { - const cacheDirs = - Array.isArray(extraCacheDirs) && extraCacheDirs.length > 0 - ? uniqueResolvedPaths(extraCacheDirs) - : getRuntimeCacheDirCandidates(); - return cacheDirs.map((cacheDir) => - resolve(cacheDir, RESTART_REQUEST_FILE_NAME), - ); + return uniqueResolvedPaths([ + ...getPidFileCandidates("bosun.pid", extraCacheDirs), + resolve(__dirname, "..", ".cache", "bosun.pid"), + ]); } function tailLinesFromFile(filePath, maxLines = 200) { @@ -2608,9 +2490,9 @@ function shouldPauseDaemonRestartStorm(options) { return { pause: true, reasons: signals.reasons }; } -function detectExistingMonitorLockOwner(excludePid = null, extraCacheDirs = []) { +function detectExistingMonitorLockOwner(excludePid = null) { try { - for (const pidFile of getMonitorPidFileCandidates(extraCacheDirs)) { + for (const pidFile of getMonitorPidFileCandidates()) { let ownerPid = null; try { ownerPid = readAlivePid(pidFile); @@ -2635,56 +2517,6 @@ function detectExistingMonitorLockOwner(excludePid = null, extraCacheDirs = []) return null; } -async function requestRunningBosunRestart(reason = "cli-restart") { - const configuredCacheDirs = await getConfiguredRuntimeCacheDirs(); - const monitorOwner = detectExistingMonitorLockOwner(null, configuredCacheDirs); - const daemonPid = getDaemonPid(); - const targetPid = Number(monitorOwner?.pid || daemonPid || 0); - if (!targetPid) { - throw new Error("no running bosun instance found"); - } - - const targetCacheDirs = monitorOwner?.pidFile - ? [dirname(monitorOwner.pidFile)] - : configuredCacheDirs; - const requestPaths = getRestartRequestFileCandidates(targetCacheDirs); - const payload = { - id: `restart-${Date.now()}-${process.pid}`, - type: "code-reload", - reason: String(reason || "cli-restart"), - requestedAt: new Date().toISOString(), - requesterPid: process.pid, - targetPid, - argv: process.argv.slice(1), - }; - - let primaryPath = ""; - const failures = []; - for (const requestPath of requestPaths) { - try { - mkdirSync(dirname(requestPath), { recursive: true }); - writeFileSync(requestPath, JSON.stringify(payload, null, 2), "utf8"); - if (!primaryPath) primaryPath = requestPath; - } catch (err) { - failures.push(`${requestPath}: ${err?.message || err}`); - } - } - - if (!primaryPath) { - throw new Error( - `failed to write restart request (${failures.join("; ") || "unknown error"})`, - ); - } - - return { - targetPid, - requestPath: primaryPath, - requestPaths, - monitorOwner, - daemon: Boolean(daemonPid), - }; -} - function getRequiredMonitorRuntimeFiles(monitorPath) { const required = [monitorPath]; const copilotDir = resolve( @@ -2789,7 +2621,7 @@ function runMonitor({ restartReason = "" } = {}) { const exitCode = code ?? (signal ? 1 : 0); const existingOwner = !gracefulShutdown && exitCode === 1 - ? detectExistingMonitorLockOwner(childPid, [runtimeCacheDir]) + ? detectExistingMonitorLockOwner(childPid) : null; if (existingOwner) { console.log( @@ -2909,7 +2741,6 @@ function runMonitor({ restartReason = "" } = {}) { } // Let forked monitor handle signal cleanup — prevent parent from dying first -let monitorChild = null; let gracefulShutdown = false; process.on("SIGINT", () => { gracefulShutdown = true; diff --git a/compat.mjs b/compat.mjs index 740310c24..1f8780629 100644 --- a/compat.mjs +++ b/compat.mjs @@ -1,3 +1,4 @@ +#!/usr/bin/env node /** * compat.mjs — Backward compatibility for users migrating from codex-monitor * diff --git a/config/config.mjs b/config/config.mjs index 2eb174c6e..52c0ab13e 100644 --- a/config/config.mjs +++ b/config/config.mjs @@ -1,3 +1,5 @@ +#!/usr/bin/env node + /** * bosun — Configuration System * @@ -1732,65 +1734,6 @@ export function loadConfig(argv = process.argv, options = {}) { 0.2, { min: 0, max: 0.9 }, ), - startupGraceMs: parseBoundedInteger( - process.env.WORKFLOW_RECOVERY_STARTUP_GRACE_MS ?? - workflowRecoveryConfig.startupGraceMs, - 30_000, - { min: 0, max: 10 * 60 * 1000 }, - ), - startupStepDelayMs: parseBoundedInteger( - process.env.WORKFLOW_RECOVERY_STARTUP_STEP_DELAY_MS ?? - workflowRecoveryConfig.startupStepDelayMs, - 15_000, - { min: 0, max: 5 * 60 * 1000 }, - ), - }); - const rawMcpServersConfig = - configData.mcpServers && typeof configData.mcpServers === "object" - ? configData.mcpServers - : {}; - const mcpServers = Object.freeze({ - enabled: rawMcpServersConfig.enabled !== false, - defaultServers: Object.freeze( - Array.isArray(rawMcpServersConfig.defaultServers) - ? rawMcpServersConfig.defaultServers - .map((value) => String(value || "").trim()) - .filter(Boolean) - : [], - ), - catalogOverrides: - rawMcpServersConfig.catalogOverrides && - typeof rawMcpServersConfig.catalogOverrides === "object" - ? Object.freeze({ ...rawMcpServersConfig.catalogOverrides }) - : Object.freeze({}), - useDiscoveryProxy: rawMcpServersConfig.useDiscoveryProxy !== false, - includeCustomToolsInDiscoveryProxy: - rawMcpServersConfig.includeCustomToolsInDiscoveryProxy !== false, - discoveryProxyCacheTtlMs: parseBoundedInteger( - rawMcpServersConfig.discoveryProxyCacheTtlMs, - 60_000, - { min: 1000, max: 60 * 60 * 1000 }, - ), - discoveryProxyExecuteTimeoutMs: parseBoundedInteger( - rawMcpServersConfig.discoveryProxyExecuteTimeoutMs, - 10_000, - { min: 1000, max: 10 * 60 * 1000 }, - ), - autoInstallDefaults: rawMcpServersConfig.autoInstallDefaults === true, - allowExternalSources: isEnvEnabled( - process.env.BOSUN_MCP_ALLOW_EXTERNAL_SOURCES ?? - rawMcpServersConfig.allowExternalSources, - false, - ), - allowDefaultServers: isEnvEnabled( - process.env.BOSUN_MCP_ALLOW_DEFAULT_SERVERS ?? - rawMcpServersConfig.allowDefaultServers, - false, - ), - requireAuth: isEnvEnabled( - process.env.BOSUN_MCP_REQUIRE_AUTH ?? rawMcpServersConfig.requireAuth, - true, - ), }); const internalExecutor = { mode: ["internal", "hybrid"].includes(executorMode) @@ -1910,9 +1853,7 @@ export function loadConfig(argv = process.argv, options = {}) { // ── Tracing ────────────────────────────────────────────── const tracingEndpoint = process.env.BOSUN_OTEL_ENDPOINT || configData?.tracing?.endpoint || null; - const tracingEnabled = process.env.BOSUN_OTEL_ENDPOINT - ? true - : (configData?.tracing?.enabled ?? Boolean(tracingEndpoint)); + const tracingEnabled = configData?.tracing?.enabled ?? Boolean(tracingEndpoint); const tracingSampleRate = Number(configData?.tracing?.sampleRate ?? 1); // ── Telegram ───────────────────────────────────────────── @@ -2319,14 +2260,10 @@ export function loadConfig(argv = process.argv, options = {}) { }); // ── Status file ────────────────────────────────────────── - const configuredCacheDir = - String(configData.cacheDir || selectedRepository?.cacheDir || ".cache").trim() || - ".cache"; - const cacheDirBase = - hasExplicitConfigDir && !selectedRepository?.cacheDir && !configData.cacheDir - ? configDir - : repoRoot; - const cacheDir = resolve(cacheDirBase, configuredCacheDir); + const cacheDir = resolve( + repoRoot, + configData.cacheDir || selectedRepository?.cacheDir || ".cache", + ); const statusPath = process.env.STATUS_FILE || configData.statusPath || @@ -2396,7 +2333,6 @@ export function loadConfig(argv = process.argv, options = {}) { // Internal Executor internalExecutor, workflowRecovery, - mcpServers, executorMode: internalExecutor.mode, kanban, kanbanSource, diff --git a/config/repo-config.mjs b/config/repo-config.mjs index 7316d5eda..05df67463 100644 --- a/config/repo-config.mjs +++ b/config/repo-config.mjs @@ -33,13 +33,6 @@ import { const __filename = fileURLToPath(import.meta.url); const __dirname = dirname(__filename); const _missingCodexHelpersWarned = new Set(); -const COMMON_DEFAULT_MCP_SERVER_IDS = new Set([ - "context7", - "sequential-thinking", - "playwright", - "microsoft-docs", - "microsoft_docs", -]); function warnMissingCodexHelper(name) { if (_missingCodexHelpersWarned.has(name)) return; @@ -163,47 +156,15 @@ function fallbackBuildCommonMcpBlocks() { return [ "", "[mcp_servers.context7]", - "startup_timeout_sec = 120", 'command = "npx"', 'args = ["-y", "@upstash/context7-mcp"]', "", - "[mcp_servers.sequential-thinking]", - "startup_timeout_sec = 120", - 'command = "npx"', - 'args = ["-y", "@modelcontextprotocol/server-sequential-thinking"]', - "", - "[mcp_servers.playwright]", - "startup_timeout_sec = 120", - 'command = "npx"', - 'args = ["-y", "@playwright/mcp@latest"]', - "", "[mcp_servers.microsoft-docs]", 'url = "https://learn.microsoft.com/api/mcp"', "", ].join("\n"); } -function shouldIncludeInstalledMcpRepoBlocks(env = process.env) { - const raw = String(env?.BOSUN_MCP_INCLUDE_INSTALLED_REPO_CONFIG || "") - .trim() - .toLowerCase(); - return ["1", "true", "yes", "on", "y"].includes(raw); -} - -function listInstalledMcpServerIds(repoRoot) { - try { - const manifestPath = resolve(repoRoot, ".bosun", "library.json"); - if (!existsSync(manifestPath)) return []; - const manifest = JSON.parse(readFileSync(manifestPath, "utf8")); - return (manifest.entries || []) - .filter((entry) => entry?.type === "mcp") - .map((entry) => String(entry?.id || "").replace(/[^a-zA-Z0-9_-]/g, "_")) - .filter(Boolean); - } catch { - return []; - } -} - /** * Build TOML blocks for all installed MCP servers in the library. * Falls back to empty string if the library is not initialized or has no MCP entries. @@ -212,8 +173,7 @@ function listInstalledMcpServerIds(repoRoot) { * @param {string} repoRoot — workspace root directory * @returns {string} — TOML blocks for installed MCP servers */ -function buildInstalledMcpBlocks(repoRoot, options = {}) { - const { skipServerIds = new Set() } = options; +function buildInstalledMcpBlocks(repoRoot) { try { const manifestPath = resolve(repoRoot, ".bosun", "library.json"); if (!existsSync(manifestPath)) return ""; @@ -227,7 +187,7 @@ function buildInstalledMcpBlocks(repoRoot, options = {}) { const safeId = String(entry.id).replace(/[^a-zA-Z0-9_-]/g, "_"); // Skip entries that are already covered by common blocks - if (skipServerIds.has(safeId)) { + if (safeId === "context7" || safeId === "microsoft-docs") { continue; } @@ -264,49 +224,6 @@ function buildInstalledMcpBlocks(repoRoot, options = {}) { } } -function stripTomlSectionByName(toml, name) { - const header = `[mcp_servers.${name}]`; - const headerIdx = toml.indexOf(header); - if (headerIdx === -1) { - return { toml, changed: false }; - } - const removeFrom = (() => { - const lineStart = toml.lastIndexOf("\n", headerIdx); - return lineStart === -1 ? 0 : lineStart + 1; - })(); - const afterHeader = headerIdx + header.length; - const nextSection = toml.indexOf("\n[", afterHeader); - const sectionEnd = nextSection === -1 ? toml.length : nextSection + 1; - const nextToml = `${toml.slice(0, removeFrom)}${toml.slice(sectionEnd)}`.replace(/\n{3,}/g, "\n\n"); - return { toml: nextToml, changed: nextToml !== toml }; -} - -function stripManagedRepoCodexMcpSections(toml, repoRoot, env = process.env) { - let nextToml = String(toml || ""); - if (typeof codexConfig?.stripCommonMcpServerBlocks === "function") { - nextToml = codexConfig.stripCommonMcpServerBlocks(nextToml).toml; - } - if (shouldIncludeInstalledMcpRepoBlocks(env) || !repoRoot) { - return nextToml; - } - for (const id of listInstalledMcpServerIds(repoRoot)) { - while (true) { - const stripped = stripTomlSectionByName(nextToml, id); - if (!stripped.changed) break; - nextToml = stripped.toml; - } - } - return nextToml; -} - -function stripManagedVsCodeMcpServers(existingServers = {}) { - const next = { ...(existingServers || {}) }; - for (const id of COMMON_DEFAULT_MCP_SERVER_IDS) { - delete next[id]; - } - return next; -} - function fallbackBuildAgentSdkBlock({ primary = "codex" } = {}) { const normalized = String(primary || "codex").trim().toLowerCase(); const resolved = ["codex", "copilot", "claude"].includes(normalized) @@ -436,25 +353,6 @@ function mergeArrayUnique(existing, additions) { return result; } -function normalizeClaudePermissionsAllow(values) { - const normalized = []; - const seen = new Set(); - - for (const rawValue of values || []) { - let value = String(rawValue || "").trim(); - if (!value) continue; - - if (value === "computer:*") value = "Computer:*"; - if (value === "go *") continue; - - if (seen.has(value)) continue; - seen.add(value); - normalized.push(value); - } - - return normalized; -} - /** * Check whether a TOML string contains a given section header. * @param {string} toml @@ -487,30 +385,6 @@ function stripDeprecatedSandboxPermissions(toml) { ); } -function stripUnsupportedMicrosoftDocsToolsConfig(toml) { - let nextToml = String(toml || ""); - for (const name of ["microsoft-docs", "microsoft_docs"]) { - const header = `[mcp_servers.${name}]`; - const headerIdx = nextToml.indexOf(header); - if (headerIdx === -1) continue; - - const afterHeader = headerIdx + header.length; - const nextSection = nextToml.indexOf("\n[", afterHeader); - const resolvedSectionEnd = nextSection === -1 ? nextToml.length : nextSection; - const section = nextToml.substring(afterHeader, resolvedSectionEnd); - const cleaned = section.replace( - /^\s*tools\s*=\s*\[[^\n]*\]\s*(?:\r?\n)?/gm, - "", - ); - - if (cleaned !== section) { - nextToml = - nextToml.substring(0, afterHeader) + cleaned + nextToml.substring(resolvedSectionEnd); - } - } - return nextToml; -} - function ensureMcpStartupTimeout(toml, name, timeoutSec = 120) { const header = `[mcp_servers.${name}]`; const headerIdx = toml.indexOf(header); @@ -538,7 +412,7 @@ function ensureMcpStartupTimeout(toml, name, timeoutSec = 120) { */ function resolveBridgePath(explicit) { if (explicit) return explicit; - return "agent/agent-hook-bridge.mjs"; + return resolve(__dirname, "agent-hook-bridge.mjs"); } // ── 1. Codex project-level config.toml ────────────────────────────────────── @@ -620,17 +494,12 @@ export function buildRepoCodexConfig(options = {}) { parts.push(""); // ── MCP servers ── - const commonMcpBlocks = buildCommonMcpBlocks(env).trim(); - if (commonMcpBlocks) { - parts.push(commonMcpBlocks); - parts.push(""); - } + parts.push(buildCommonMcpBlocks().trim()); + parts.push(""); // ── Installed library MCP servers ── - if (repoRoot && shouldIncludeInstalledMcpRepoBlocks(env)) { - const installedBlocks = buildInstalledMcpBlocks(repoRoot, { - skipServerIds: commonMcpBlocks ? COMMON_DEFAULT_MCP_SERVER_IDS : new Set(), - }).trim(); + if (repoRoot) { + const installedBlocks = buildInstalledMcpBlocks(repoRoot).trim(); if (installedBlocks) { parts.push(installedBlocks); parts.push(""); @@ -652,8 +521,7 @@ export function buildRepoCodexConfig(options = {}) { * @param {string} generated Full generated content * @returns {string} Merged content */ -function mergeCodexToml(existing, generated, options = {}) { - const { repoRoot = "", env = process.env } = options; +function mergeCodexToml(existing, generated) { // Extract sections from generated content // A section starts with a line matching /^\[.+\]/ and runs until the next // section header or EOF. @@ -675,13 +543,7 @@ function mergeCodexToml(existing, generated, options = {}) { if (keyMatch) topLevelKeys.push(keyMatch[1]); } - let result = stripManagedRepoCodexMcpSections( - stripUnsupportedMicrosoftDocsToolsConfig( - stripDeprecatedSandboxPermissions(existing.trimEnd()), - ), - repoRoot, - env, - ); + let result = stripDeprecatedSandboxPermissions(existing.trimEnd()); // Add missing top-level keys for (const key of topLevelKeys) { @@ -712,9 +574,7 @@ function mergeCodexToml(existing, generated, options = {}) { result = ensureMcpStartupTimeout(result, "sequential-thinking", 120); result = ensureMcpStartupTimeout(result, "playwright", 120); - return stripUnsupportedMicrosoftDocsToolsConfig( - stripDeprecatedSandboxPermissions(result), - ).trimEnd() + "\n"; + return stripDeprecatedSandboxPermissions(result).trimEnd() + "\n"; } // ── 2. Claude settings.local.json ─────────────────────────────────────────── @@ -739,6 +599,8 @@ const CLAUDE_PERMISSIONS_ALLOW = [ // Web access (trusted domains) "WebFetch(domain:github.com)", "WebFetch(domain:bosun.ai)", + // Go toolchain + "go *", // File editing "Edit", "MultiEdit", @@ -746,7 +608,7 @@ const CLAUDE_PERMISSIONS_ALLOW = [ "Read", "Write", // Computer tool - "Computer:*", + "computer:*", ]; /** Claude Code permission deny list (empty — we trust managed repos). */ @@ -754,7 +616,7 @@ const CLAUDE_PERMISSIONS_DENY = []; /** * Build the Claude hooks object using the bosun bridge. - * @param {string} bridgePath Repo-relative or absolute path to agent-hook-bridge.mjs + * @param {string} bridgePath Absolute path to agent-hook-bridge.mjs * @returns {object} Hooks section for settings.local.json */ function buildClaudeHooks(bridgePath) { @@ -798,7 +660,7 @@ function buildClaudeHooks(bridgePath) { * * @param {object} options * @param {string} options.repoRoot Absolute path to the repo - * @param {string} [options.bosunBridgePath] Repo-relative or absolute path to agent-hook-bridge.mjs + * @param {string} [options.bosunBridgePath] Path to agent-hook-bridge.mjs * @returns {object} JSON-serializable settings object */ export function buildRepoClaudeSettings(options = {}) { @@ -838,9 +700,7 @@ function mergeClaudeSettings(existing, generated) { const genPerms = generated.permissions || {}; base.permissions = { - allow: normalizeClaudePermissionsAllow( - mergeArrayUnique(existingPerms.allow, genPerms.allow), - ), + allow: mergeArrayUnique(existingPerms.allow, genPerms.allow), deny: genPerms.deny || [], }; @@ -877,11 +737,7 @@ export function buildRepoVsCodeSettings(options = {}) { * * @returns {object} JSON-serializable MCP config */ -export function buildRepoVsCodeMcpConfig(options = {}) { - const { env = process.env } = options; - if (!buildCommonMcpBlocks(env).trim()) { - return { mcpServers: {} }; - } +export function buildRepoVsCodeMcpConfig() { return { mcpServers: { context7: { @@ -936,7 +792,7 @@ export function buildRepoVsCodeMcpConfig(options = {}) { * @param {string} repoRoot Absolute path to the repo directory * @param {object} [options] * @param {string} [options.primarySdk] "codex" | "copilot" | "claude" (default: "codex") - * @param {string} [options.bosunBridgePath] Repo-relative or absolute path to agent-hook-bridge.mjs + * @param {string} [options.bosunBridgePath] Path to agent-hook-bridge.mjs * @param {object} [options.env] Environment overrides * @param {boolean} [options.dryRun] If true, return results without writing files * @returns {RepoConfigResult} @@ -969,7 +825,7 @@ export function ensureRepoConfigs(repoRoot, options = {}) { if (existsSync(configPath)) { const existing = readFileSync(configPath, "utf8"); - const merged = mergeCodexToml(existing, generated, { repoRoot: root, env }); + const merged = mergeCodexToml(existing, generated); if (merged.trimEnd() === existing.trimEnd()) { result.codexConfig.skipped = true; } else if (!dryRun) { @@ -1068,7 +924,7 @@ export function ensureRepoConfigs(repoRoot, options = {}) { const mcpPath = resolve(root, ".vscode", "mcp.json"); result.vsCodeMcp.path = mcpPath; - const generated = buildRepoVsCodeMcpConfig({ env }); + const generated = buildRepoVsCodeMcpConfig(); if (existsSync(mcpPath)) { let existing = {}; @@ -1082,14 +938,11 @@ export function ensureRepoConfigs(repoRoot, options = {}) { existing.mcpServers || existing["github.copilot.mcpServers"] || (typeof existing === "object" && !existing.mcpServers ? existing : {}); - const normalizedExistingServers = buildCommonMcpBlocks(env).trim() - ? existingServers - : stripManagedVsCodeMcpServers(existingServers); // Existing servers take priority; add missing from generated const mergedServers = { ...generated.mcpServers, - ...(typeof normalizedExistingServers === "object" ? normalizedExistingServers : {}), + ...(typeof existingServers === "object" ? existingServers : {}), }; const next = { mcpServers: mergedServers }; diff --git a/full-node-test.log b/full-node-test.log deleted file mode 100644 index 7ac0f32dc..000000000 --- a/full-node-test.log +++ /dev/null @@ -1,959 +0,0 @@ -✔ infra\test-runtime-guards.mjs (988.1373ms) -✔ infra\test-runtime.mjs (932.4403ms) -✔ tests\agent-custom-tools.test.mjs (955.7957ms) -▶ agent endpoint stale-pid handling - ✔ treats process-not-found taskkill output as already exited (1.0102ms) - ✔ uses spawnSync taskkill with piped stdio (0.2841ms) - ✔ skips forced kill when port owner is not a bosun process (0.1855ms) - ✔ throttles access-denied cooldown warning spam per port (0.1841ms) - ✔ skips forced kill unless conflict reaping is explicitly enabled (1.7901ms) -✔ agent endpoint stale-pid handling (4.4074ms) -▶ agent-event-bus tracing integration - ✔ records agent errors as tracing metrics (942.5773ms) -✔ agent-event-bus tracing integration (943.4846ms) -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] started (stale-check=2000ms, log-cap=20) -[agent-event-bus] stopped -[agent-event-bus] started (stale-check=2000ms, log-cap=20) -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] started (stale-check=2000ms, log-cap=20) -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] auto-review queued for task-1 -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] auto-retry #1/3 for task-1 (build_failure) -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] listener error: listener boom -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] auto-retry #1/3 for task-1 (build_failure) -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] started (stale-check=2000ms, log-cap=20) -[agent-event-bus] stopped -[agent-event-bus] started (stale-check=2000ms, log-cap=20) -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] auto-retry #1/3 for task-1 (build_failure) -[agent-event-bus] stopped -[agent-event-bus] stopped -[agent-event-bus] auto-retry #1/5 for task-1 (build_failure) -[agent-event-bus] auto-retry #2/5 for task-1 (build_failure) -[agent-event-bus] task-1 reached retry threshold (2); routed to review workflow -[agent-event-bus] stopped -[agent-event-bus] cooldown 60000ms for task-1 (rate_limit) -[agent-event-bus] stopped -[agent-event-bus] auto-retry #1/3 for task-1 (build_failure) -[agent-event-bus] auto-retry #2/3 for task-1 (build_failure) -[agent-event-bus] auto-retry #3/3 for task-1 (build_failure) -[agent-event-bus] task-1 exhausted retries (3) -[agent-event-bus] auto-blocked task-1: threshold -[agent-event-bus] stopped -[agent-event-bus] auto-blocked task-1: too many errors -[agent-event-bus] stopped -[agent-event-bus] cooldown 60000ms for task-1 (rate_limit) -[agent-event-bus] auto-retry #1/3 for task-1 (build_failure) -[agent-event-bus] stopped -[agent-event-bus] manual review needed for task-1: build error 0 -[agent-event-bus] manual review needed for task-1: build error 1 -[agent-event-bus] manual review needed for task-1: build error 2 -[agent-event-bus] manual review needed for task-1: build error 3 -[agent-event-bus] stopped -▶ agent-event-bus - ▶ createAgentEventBus - ✔ returns an AgentEventBus instance (3.6959ms) - ✔ has correct AGENT_EVENT constants (0.7267ms) - ✔ createAgentEventBus (5.0235ms) - ▶ start / stop - ✔ starts and reports status (0.887ms) - ✔ stops cleanly (0.4672ms) - ✔ is idempotent — double start (0.3857ms) - ✔ start / stop (1.9146ms) - ▶ emit - ✔ records events in the log (1.4226ms) - ✔ broadcasts to UI via broadcastUiEvent (1.3061ms) - ✔ skips broadcast when opts.skipBroadcast is true (0.5364ms) - ✔ deduplicates events within the dedup window (0.5949ms) - ✔ allows same event type after dedup window expires (0.686ms) - ✔ enforces ring buffer max size (0.7016ms) - ✔ emit (5.5301ms) - ▶ addListener - ✔ notifies external listeners (0.6094ms) - ✔ allows unsubscribing (0.3874ms) - ✔ handles listener errors gracefully (0.9161ms) - ✔ addListener (2.0336ms) - ▶ onTaskStarted - ✔ emits TASK_STARTED with task details (0.7125ms) - ✔ onTaskStarted (0.7896ms) - ▶ onTaskCompleted - ✔ emits TASK_COMPLETED (0.47ms) - ✔ triggers auto-review when review agent is available (1.4829ms) - ✔ does not trigger review on failure (0.3714ms) - ✔ onTaskCompleted (2.4619ms) - ▶ onTaskFailed - ✔ emits TASK_FAILED with error message (1.5642ms) - ✔ classifies errors when errorDetector is available (1.534ms) - ✔ onTaskFailed (3.2047ms) - ▶ onAgentComplete - ✔ emits AGENT_COMPLETE (0.4911ms) - ✔ sets task status to inreview when hasCommits (0.9148ms) - ✔ onAgentComplete (1.4912ms) - ▶ onAgentError - ✔ emits AGENT_ERROR (0.4467ms) - ✔ onAgentError (0.4998ms) - ▶ onAgentHeartbeat - ✔ emits AGENT_HEARTBEAT and updates heartbeats map (0.6142ms) - ✔ onAgentHeartbeat (0.7074ms) - ▶ onStatusChange - ✔ emits TASK_STATUS_CHANGE (0.398ms) - ✔ sends telegram on blocked status (0.6139ms) - ✔ onStatusChange (1.0978ms) - ▶ onExecutorPaused / onExecutorResumed - ✔ emits EXECUTOR_PAUSED (37.7158ms) - ✔ emits EXECUTOR_RESUMED (0.3561ms) - ✔ onExecutorPaused / onExecutorResumed (38.1616ms) - ▶ onHookResult - ✔ emits HOOK_PASSED for passed hooks (0.3976ms) - ✔ emits HOOK_FAILED for failed hooks (0.3058ms) - ✔ onHookResult (0.784ms) - ▶ getEventLog - ✔ returns all events with no filter (0.303ms) - ✔ filters by taskId (0.3302ms) - ✔ filters by type (1.0632ms) - ✔ limits results (0.3672ms) - ✔ getEventLog (2.2147ms) - ▶ getErrorHistory - ✔ returns empty array for unknown task (0.4125ms) - ✔ records error history via classification (0.6756ms) - ✔ getErrorHistory (1.1655ms) - ▶ getErrorPatternSummary - ✔ returns empty when no errors (0.3541ms) - ✔ getErrorPatternSummary (0.4043ms) - ▶ getAgentLiveness - ✔ returns empty when no heartbeats (0.3093ms) - ✔ reports alive agents (0.3277ms) - ✔ reports stale agents after threshold (0.6985ms) - ✔ getAgentLiveness (1.4793ms) - ▶ getStatus - ✔ returns full system status (0.3851ms) - ✔ getStatus (0.4378ms) - ▶ stale agent detection - ✔ emits AGENT_STALE when heartbeat is overdue (0.6318ms) - ✔ does not emit retry queue updates when expire check makes no changes (0.4351ms) - ✔ emits retry queue updates when expire check removes queued tasks (0.5083ms) - ✔ stale agent detection (1.6811ms) - ▶ auto-actions - ✔ emits AUTO_RETRY when action is retry_with_prompt (0.7072ms) - ✔ invokes threshold hook instead of retry when threshold is reached (1.1732ms) - ✔ emits AUTO_COOLDOWN when action is cooldown (0.5272ms) - ✔ escalates to block after max retries exhausted (0.8503ms) - ✔ sends telegram on auto-block (0.6506ms) - ✔ clears cooldown on manual retry queue clear (0.7591ms) - ✔ auto-actions (4.8782ms) - ▶ pattern trend detection - ✔ detects repeated error patterns (0.8177ms) - ✔ pattern trend detection (0.8817ms) -✔ agent-event-bus (78.3085ms) -[agent-hooks] registered hook "test-prepush-1" for event "PrePush" (blocking) -[agent-hooks] registered hook "hook-f29fa43f" for event "SessionStart" -[agent-hooks] registered hook "dedup-test" for event "PrePush" -[agent-hooks] updated hook "dedup-test" for event "PrePush" -[agent-hooks] registered hook "sdk-wildcard" for event "SessionStart" -[agent-hooks] registered hook "remove-me" for event "PrePush" -[agent-hooks] unregistered hook "remove-me" from event "PrePush" -[agent-hooks] registered hook "pp-1" for event "PostPush" -[agent-hooks] registered hook "pp-2" for event "PostPush" -[agent-hooks] registered hook "ss-1" for event "SessionStart" -[agent-hooks] registered hook "push-1" for event "PrePush" -[agent-hooks] registered hook "exec-test" for event "SessionStart" -▶ agent-hooks - ▶ HOOK_EVENTS - ✔ should export the correct list of hook events (6.1277ms) - ✔ should be frozen (0.8084ms) - ✔ HOOK_EVENTS (7.9241ms) - ▶ TAG - ✔ should export a TAG constant (0.7168ms) - ✔ TAG (0.8961ms) - ▶ registerHook - ✔ should register a hook and return its ID (2.5782ms) - ✔ should auto-generate an ID if not provided (0.9341ms) - ✔ should throw on invalid event name (1.2303ms) - ✔ should deduplicate by ID (update instead of add) (2.3396ms) - ✔ should normalize SDK wildcards (1.0926ms) - ✔ registerHook (8.557ms) - ▶ unregisterHook - ✔ should remove a registered hook (0.7869ms) - ✔ should return false for non-existent hook (0.5828ms) - ✔ unregisterHook (1.4885ms) - ▶ getRegisteredHooks - ✔ should return hooks for a specific event (0.7259ms) - ✔ should return all hooks when no event specified (0.7701ms) - ✔ should throw on invalid event (1.0226ms) - ✔ getRegisteredHooks (2.6569ms) -[agent-hooks] registered hook "codex-only" for event "SessionStart" -[agent-hooks] registered hook "claude-only" for event "SessionStart" - ▶ executeHooks - ✔ should execute a non-blocking hook successfully (912.4453ms) -[agent-hooks] executeHooks called with unknown event: "UnknownEvent" -[agent-hooks] registered hook "fail-nonblock" for event "PostPush" - ✔ should filter hooks by SDK (787.5154ms) - ✔ should return empty array for unknown event (0.7365ms) -[agent-hooks] non-blocking hook "fail-nonblock" failed for event "PostPush" (exit 1) -[agent-hooks] registered hook "block-pass-1" for event "PrePush" (blocking) -[agent-hooks] registered hook "block-pass-2" for event "PrePush" (blocking) -[agent-hooks] blocking hook "block-pass-1" passed (593ms) -[agent-hooks] blocking hook "block-pass-2" passed (932ms) -[agent-hooks] all 2 blocking hook(s) passed for "PrePush" -[agent-hooks] registered hook "block-fail" for event "PreCommit" (blocking) -[agent-hooks] BLOCKING FAILURE: hook "block-fail" for event "PreCommit" — exit 42 (438ms) -[agent-hooks] 1/1 blocking hook(s) FAILED for "PreCommit" -[agent-hooks] registered hook "non-block-skip" for event "PrePR" -[agent-hooks] executeBlockingHooks called with unknown event: "NoSuchEvent" -[agent-hooks] registered hook "builtin-prepush-preflight" for event "PrePush" (blocking) -[agent-hooks] registered hook "builtin-task-complete-validation" for event "TaskComplete" (blocking) -[agent-hooks] registered hook "builtin-session-health-check" for event "SessionStart" -[agent-hooks] registered hook "builtin-prepush-fetch" for event "PrePush" -[agent-hooks] built-in hooks registered -[agent-hooks] registered hook "builtin-prepush-preflight" for event "PrePush" (blocking) -[agent-hooks] registered hook "builtin-task-complete-validation" for event "TaskComplete" (blocking) -[agent-hooks] registered hook "builtin-session-health-check" for event "SessionStart" -[agent-hooks] registered hook "builtin-prepush-fetch" for event "PrePush" -[agent-hooks] built-in hooks registered -[agent-hooks] registered hook "builtin-prepush-preflight" for event "PrePush" (blocking) -[agent-hooks] registered hook "builtin-task-complete-validation" for event "TaskComplete" (blocking) -[agent-hooks] registered hook "builtin-session-health-check" for event "SessionStart" -[agent-hooks] registered hook "builtin-prepush-fetch" for event "PrePush" -[agent-hooks] built-in hooks registered -[agent-hooks] updated hook "builtin-prepush-preflight" for event "PrePush" -[agent-hooks] updated hook "builtin-task-complete-validation" for event "TaskComplete" -[agent-hooks] updated hook "builtin-session-health-check" for event "SessionStart" -[agent-hooks] updated hook "builtin-prepush-fetch" for event "PrePush" -[agent-hooks] built-in hooks registered -[agent-hooks] built-in hooks disabled (mode=off) -[agent-hooks] registered hook "custom-prepush" for event "PrePush" (blocking) -[agent-hooks] skipped built-in PrePush hook (mode=auto) -[agent-hooks] registered hook "builtin-task-complete-validation" for event "TaskComplete" (blocking) -[agent-hooks] registered hook "builtin-session-health-check" for event "SessionStart" -[agent-hooks] built-in hooks registered -[agent-hooks] registered hook "custom-prepush" for event "PrePush" (blocking) -[agent-hooks] registered hook "builtin-prepush-preflight" for event "PrePush" (blocking) -[agent-hooks] registered hook "builtin-task-complete-validation" for event "TaskComplete" (blocking) -[agent-hooks] registered hook "builtin-session-health-check" for event "SessionStart" -[agent-hooks] registered hook "builtin-prepush-fetch" for event "PrePush" -[agent-hooks] built-in hooks registered -[agent-hooks] registered hook "from-file-1" for event "SessionStart" -[agent-hooks] registered hook "from-file-push" for event "PrePush" (blocking) -[agent-hooks] loaded 2 hook(s) from C:\Users\jON\Documents\source\repos\virtengine-gh\bosun\.cache\test-hooks\hooks.json -[agent-hooks] registered hook "alt-key" for event "PostPR" -[agent-hooks] loaded 1 hook(s) from C:\Users\jON\Documents\source\repos\virtengine-gh\bosun\.cache\test-hooks\hooks.json -[agent-hooks] config file not found: C:\nonexistent\path.json -[agent-hooks] invalid JSON in config file: C:\Users\jON\Documents\source\repos\virtengine-gh\bosun\.cache\test-hooks\bad.json Unexpected token 'o', "not json {{{" is not valid JSON -[agent-hooks] ignoring unknown hook event "FakeEvent" in config -[agent-hooks] registered hook "real" for event "PrePush" -[agent-hooks] loaded 1 hook(s) from C:\Users\jON\Documents\source\repos\virtengine-gh\bosun\.cache\test-hooks\hooks.json -[agent-hooks] registered hook "env-check" for event "PostCommit" (blocking) -[agent-hooks] blocking hook "env-check" passed for event "PostCommit" (3014ms) -[agent-hooks] registered hook "will-reset" for event "PrePush" -[agent-hooks] registered hook "also-reset" for event "SessionStart" - ✔ should handle failing non-blocking hooks gracefully (832.2375ms) - ✔ executeHooks (2533.2789ms) - ▶ executeBlockingHooks - ✔ should pass when all blocking hooks succeed (1527.1384ms) - ✔ should fail when a blocking hook returns non-zero (440.2841ms) - ✔ should skip non-blocking hooks (0.6195ms) - ✔ should return passed for unknown events (0.5155ms) - ✔ executeBlockingHooks (1968.7649ms) - ▶ registerBuiltinHooks - ✔ should register built-in PrePush and TaskComplete hooks (1.0428ms) - ✔ should register builtins with blocking=true (0.7369ms) - ✔ should be idempotent (no duplicates on re-call) (0.7369ms) - ✔ should skip builtins when mode=off (0.6354ms) - ✔ should auto-skip prepush builtin when custom prepush exists (1.0542ms) - ✔ should force builtins when mode=force even with custom hooks (0.7493ms) - ✔ registerBuiltinHooks (5.1837ms) - ▶ loadHooks - ✔ should load hooks from a config file (11.8135ms) - ✔ should return 0 for missing config file (0.6574ms) - ✔ should return 0 for invalid JSON (6.4683ms) - ✔ should support 'agentHooks' key as alternative (1.948ms) - ✔ should ignore unknown event names in config (7.9941ms) - ✔ loadHooks (29.1363ms) - ▶ environment variables - ✔ should pass VE_ env vars to hook processes (3015.4439ms) - ✔ environment variables (3015.7453ms) - ▶ resetHooks - ✔ should clear all registered hooks (0.7789ms) - ✔ resetHooks (0.8853ms) -✔ agent-hooks (7575.7348ms) -▶ agent-pool monitor-monitor thread refresh clamp - ✔ defines MONITOR_MONITOR_THREAD_REFRESH_TURNS_REMAINING constant (0.6714ms) - ✔ defaults refresh turns remaining to 5 (1.1021ms) - ✔ supports DEVMODE_MONITOR_MONITOR_THREAD_REFRESH_TURNS_REMAINING env override (0.1604ms) - ✔ proactively force-refreshes monitor-monitor thread when turns remaining reaches threshold (0.1881ms) - ✔ only applies refresh logic for monitor-monitor task key (0.4076ms) -✔ agent-pool monitor-monitor thread refresh clamp (4.1199ms) -▶ agent-pool node warning suppression - ✔ defines applyNodeWarningSuppressionEnv function (0.7787ms) - ✔ injects NODE_NO_WARNINGS=1 into spawned process env (1.6089ms) - ✔ supports opt-out via BOSUN_SUPPRESS_NODE_WARNINGS=0 (0.1273ms) - ✔ applies suppression to Codex/Copilot spawned processes (0.1196ms) - ✔ does not suppress warnings when BOSUN_SUPPRESS_NODE_WARNINGS is 0 (0.3252ms) -✔ agent-pool node warning suppression (3.9826ms) -✔ tests\agent-pool.test.mjs (690.0047ms) -▶ agent-prompts workspace - ✔ uses explicit prompt workspace override (7.5245ms) -[agent-prompts] prompt workspace fallback enabled: C:\Users\jON\AppData\Local\Temp\prompts-home-QKchTF\.bosun\agents (primary path failed: ENOTDIR) - ✔ falls back to HOME when primary prompt directory cannot be created (57.1335ms) - ✔ creates files with metadata hash in ensureAgentPromptWorkspace (29.3901ms) - ✔ detects missing files as updateAvailable (4.8895ms) - ✔ detects user-modified file as needsReview and not updateAvailable (21.8132ms) - 02:52:09 [markdown-safety] [audit] unsafe-orchestrator.md blocked: ignore-instructions directive, download-and-execute pipeline, website url - ✔ falls back to builtin prompts when a configured template file is blocked (764.8695ms) - ✔ applyPromptDefaultUpdates updates missing and outdated-unmodified files and skips needsReview (479.9408ms) - ✔ strips unresolved template placeholders passed as values (0.6113ms) - ✔ strips inline unresolved template placeholders inside larger values (0.2931ms) - ✔ skips custom tools context when no custom tools are registered (5.006ms) - ✔ renders custom tools context when a custom tool is registered (13.6864ms) -✔ agent-prompts workspace (1386.9168ms) -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] started (assess every 60s) -[agent-supervisor] stopped -[agent-supervisor] started (assess every 60s) -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] started (assess every 60s) -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] intervening on task-api: api_error → continue_signal (reason: Transient API failure — continue the current thread and back off for 3 minute(s) if it repeats.) -[agent-supervisor] intervening on task-api: api_error → continue_signal (reason: Transient API failure — continue the current thread and back off for 5 minute(s) if it repeats.) -[agent-supervisor] intervening on task-api: api_error → continue_signal (reason: Transient API failure — continue the current thread and back off for 5 minute(s) if it repeats.) -[agent-supervisor] stopped -[agent-supervisor] intervening on task-api-reset: api_error → continue_signal (reason: Transient API failure — continue the current thread and back off for 3 minute(s) if it repeats.) -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] intervening on task-1: poor_quality → dispatch_fix (reason: poor_quality) -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] intervening on task-1: idle_hard → continue_signal (reason: idle) -[agent-supervisor] stopped -[agent-supervisor] intervening on task-api-intervene: api_error → continue_signal (reason: Transient API failure — continue the current thread and back off for 3 minute(s) if it repeats.) -[agent-supervisor] stopped -[agent-supervisor] intervening on task-1: build_failure → inject_prompt (reason: build failure) -[agent-supervisor] stopped -[agent-supervisor] intervening on task-1: token_overflow → force_new_thread (reason: token overflow) -[agent-supervisor] stopped -[agent-supervisor] intervening on task-1: agent_dead → redispatch_task (reason: agent dead) -[agent-supervisor] stopped -[agent-supervisor] intervening on task-1: error_loop → block_and_notify (reason: max retries) -[agent-supervisor] stopped -[agent-supervisor] intervening on task-1: rate_limit_flood → pause_executor (reason: rate limit flood) -[agent-supervisor] stopped -[agent-supervisor] intervening on task-1: poor_quality → dispatch_fix (reason: poor_quality) -[agent-supervisor] intervening on task-1: poor_quality → dispatch_fix (reason: review rejected) -[agent-supervisor] stopped -[agent-supervisor] intervening on task-1: healthy → none (reason: healthy) -[agent-supervisor] stopped -[agent-supervisor] intervening on task-1: idle_hard → continue_signal (reason: test) -[agent-supervisor] stopped -[agent-supervisor] intervening on task-1: plan_stuck → inject_prompt (reason: plan_stuck) -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] review approved for task-1 -[agent-supervisor] stopped -[agent-supervisor] intervening on task-1: poor_quality → dispatch_fix (reason: poor_quality) -[agent-supervisor] stopped -[agent-supervisor] intervening on task-1: poor_quality → dispatch_fix (reason: poor_quality) -[agent-supervisor] stopped -[agent-supervisor] review approved for task-1 -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] started (assess every 60s) -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] intervening on task-1: plan_stuck → inject_prompt (reason: test) -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] intervening on task-1: idle_hard → continue_signal (reason: idle) -[agent-supervisor] stopped -[agent-supervisor] intervening on task-1: poor_quality → dispatch_fix (reason: poor quality) -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] review REJECTED for task-1: 1 critical, 0 major issues (quality: 70) -[agent-supervisor] review REJECTED for task-1: 1 critical, 0 major issues (quality: 70) -[agent-supervisor] intervention failed for task-1: connection lost -[agent-supervisor] review REJECTED for task-1: 1 critical, 1 major issues (quality: 55) -[agent-supervisor] review REJECTED for task-1: 1 critical, 0 major issues (quality: 70) -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -[agent-supervisor] stopped -▶ agent-supervisor - ▶ createAgentSupervisor - ✔ returns an AgentSupervisor instance (3.405ms) - ✔ exposes SITUATION and INTERVENTION enums (1.2016ms) - ✔ createAgentSupervisor (5.5863ms) - ▶ start / stop - ✔ starts without error (0.9823ms) - ✔ stops without error (0.628ms) - ✔ is idempotent on start (0.5653ms) - ✔ start / stop (2.4332ms) - ▶ assess - ✔ returns HEALTHY for no signals (1.5915ms) - ✔ detects rate_limited from error text (0.4885ms) - ✔ detects rate_limit_flood when 3+ rate limits in sequence (0.732ms) - ✔ detects api_error from ECONNREFUSED (29.5728ms) - ✔ detects token_overflow (0.9943ms) - ✔ detects session_expired (0.7321ms) - ✔ detects model_error (0.5442ms) - ✔ detects build_failure (1.0467ms) - ✔ detects test_failure (0.5758ms) - ✔ detects git_conflict (0.5721ms) - ✔ detects push_failure (0.4298ms) - ✔ detects pre_push_failure (0.9577ms) - ✔ detects no_commits from context (2.6117ms) - ✔ detects poor_quality from review result (0.8298ms) - ✔ respects situation override from context (0.4548ms) - ✔ assess (42.8573ms) - ▶ health score - ✔ returns 0-100 range (0.4474ms) - ✔ scores higher with no signals than with errors (0.3262ms) - ✔ health score (0.8543ms) - ▶ intervention escalation - ✔ escalates through the ladder for plan_stuck (0.4323ms) - ✔ escalates for idle_hard from continue to inject to new thread to block (0.3575ms) - ✔ does not escalate for HEALTHY (0.3199ms) - ✔ uses continue-first recovery with cooldowns for repeated api_error (2.012ms) - ✔ resets api_error recovery when the error signature changes (0.4367ms) - ✔ intervention escalation (3.7038ms) - ▶ recovery prompts - ✔ generates plan_stuck prompt mentioning task title (0.5193ms) - ✔ generates false_completion prompt (0.3887ms) - ✔ generates no_commits prompt (0.401ms) - ✔ generates commits_not_pushed prompt with branch (0.3776ms) - ✖ does not diagnose commits_not_pushed when workflow owns push lifecycle (141.3565ms) - ✔ generates tool_loop prompt (0.7111ms) - ✔ generates error_loop prompt (0.4593ms) - ✔ generates poor_quality prompt with review issues (0.7177ms) - ✔ returns null for HEALTHY (no prompt needed) (0.399ms) - ✖ recovery prompts (145.8784ms) - ▶ intervene - ✔ dispatches CONTINUE_SIGNAL (0.5794ms) - ✔ records api_error continue cooldown state (0.6836ms) - ✔ dispatches INJECT_PROMPT (0.4805ms) - ✔ dispatches FORCE_NEW_THREAD (0.436ms) - ✔ dispatches REDISPATCH_TASK (0.4112ms) - ✔ dispatches BLOCK_AND_NOTIFY with telegram (0.5625ms) - ✔ dispatches PAUSE_EXECUTOR (2.7221ms) - ✔ dispatches DISPATCH_FIX with review issues (0.9674ms) - ✔ NONE does nothing (0.9648ms) - ✔ handles errors gracefully (0.9778ms) - ✔ intervene (9.34ms) - ▶ assessAndIntervene - ✔ assesses and dispatches in one call (0.5442ms) - ✔ does not dispatch for HEALTHY (0.329ms) - ✔ assessAndIntervene (0.9548ms) - ▶ review enforcement - ✔ records approved review (0.4169ms) - ✔ records rejected review and dispatches fix (0.4048ms) - ✔ canComplete returns false when review rejected (0.4493ms) - ✔ canComplete returns true when review approved (0.3135ms) - ✔ canComplete returns true for untracked tasks (0.375ms) - ✔ review enforcement (2.1511ms) - ▶ verifyCompletion - ✔ returns HEALTHY for good completion (1.5764ms) - ✔ detects no commits (0.8705ms) - ✔ detects no PR (0.9399ms) - ✔ detects plan_stuck from output (1.0124ms) - ✔ detects false completion from output without commits (0.3969ms) - ✔ verifyCompletion (4.968ms) - ▶ diagnostics - ✔ getTaskDiagnostics returns null for unknown task (0.4781ms) - ✔ getTaskDiagnostics returns data after assessment (0.6857ms) - ✔ getAllDiagnostics returns all tracked tasks (1.7206ms) - ✔ getSystemHealth returns expected shape (0.6191ms) - ✔ diagnostics (3.6325ms) - ▶ resetTask - ✔ clears all state for a task (0.6008ms) - ✔ resetTask (0.6619ms) - ▶ edge cases - ✔ handles missing dispatch functions gracefully (0.6026ms) - ✔ handles missing getTask gracefully (0.3533ms) - ✔ caps situation history to 50 entries (0.445ms) - ✔ caps health scores to 20 entries (1.5836ms) - ✔ emits supervisor-intervention event to event bus (0.8249ms) - ✔ DISPATCH_FIX falls back to inject_prompt if no review issues (4.5706ms) - ✔ edge cases (8.8601ms) - ▶ situation coverage - ✔ detects rate_limited from "429 rate limit exceeded" (0.4269ms) - ✔ detects api_error from "ETIMEDOUT connecting to api" (0.6479ms) - ✔ detects token_overflow from "context too long maximum exceeded" (0.6253ms) - ✔ detects session_expired from "session expired please login" (0.3469ms) - ✔ detects model_error from "model not supported claude-x" (0.278ms) - ✔ detects api_error from "ECONNREFUSED localhost:8080" (0.2834ms) - ✔ detects api_error from "500 Internal Server Error" (0.7382ms) - ✔ detects api_error from "502 Bad Gateway" (0.3141ms) - ✔ detects api_error from "fetch failed network error" (0.8371ms) - ✔ detects rate_limited from "quota exceeded" (0.6256ms) - ✔ detects session_expired from "thread not found" (0.7538ms) - ✔ detects token_overflow from "max token exceeded" (1.9899ms) - ✔ detects pre_push_failure from "pre-push hook failed exit code 1" (1.1682ms) - ✔ detects push_failure from "git push failed rejected" (1.0099ms) - ✔ detects build_failure from "go build failed compilation error" (0.3142ms) - ✔ detects test_failure from "FAIL github.com/pkg/test 1.2s" (0.5224ms) - ✔ detects lint_failure from "golangci-lint error found" (4.6519ms) - ✔ detects git_conflict from "merge conflict in README.md" (0.8128ms) - ✔ situation coverage (151.652ms) - ▶ auth/config/policy/sandbox situation detection - ✔ detects AUTH_FAILURE from "invalid api key" (0.8489ms) - ✔ detects AUTH_FAILURE from "authentication_error from Anthropic" (0.5506ms) - ✔ detects AUTH_FAILURE from "401 Unauthorized on /v1/chat" (0.4935ms) - ✔ detects AUTH_FAILURE from "403 Forbidden: access denied" (0.3474ms) - ✔ detects AUTH_FAILURE from "billing_hard_limit reached" (0.4479ms) - ✔ detects AUTH_FAILURE from "insufficient_quota for org" (0.3235ms) - ✔ detects AUTH_FAILURE from "invalid credentials supplied" (0.3307ms) - ✔ detects AUTH_FAILURE from "not authorized to access this model" (0.3617ms) - ✔ detects AUTH_FAILURE from "permission_error on resource" (0.7419ms) - ✔ detects CONTENT_POLICY from "content_policy_violation in response" (0.5919ms) - ✔ detects CONTENT_POLICY from "content filter blocked the output" (0.6359ms) - ✔ detects CONTENT_POLICY from "safety_system rejected request" (0.3778ms) - ✔ detects CONTENT_POLICY from "flagged content detected in prompt" (0.424ms) - ✔ detects CONTENT_POLICY from "output blocked by safety filter" (0.3429ms) - ✔ detects CODEX_SANDBOX from "sandbox failed to initialize" (0.9203ms) - ✔ detects CODEX_SANDBOX from "bwrap error: permission denied" (0.4059ms) - ✔ detects CODEX_SANDBOX from "bubblewrap failed with EPERM" (0.5839ms) - ✔ detects CODEX_SANDBOX from "EPERM: operation not permitted on /tmp" (0.2997ms) - ✔ detects CODEX_SANDBOX from "writable_roots paths not configured" (0.3512ms) - ✔ detects CODEX_SANDBOX from "codex segfault during execution" (0.3142ms) - ✔ detects CODEX_SANDBOX from "namespace error in sandbox" (0.3074ms) - ✔ detects INVALID_CONFIG from "config invalid: missing EXECUTOR field" (0.4709ms) - ✔ detects INVALID_CONFIG from "config missing for agent pool" (0.3044ms) - ✔ detects INVALID_CONFIG from "misconfigured agent settings detected" (0.336ms) - ✔ detects INVALID_CONFIG from "OPENAI_API_KEY not set in environment" (0.3133ms) - ✔ detects INVALID_CONFIG from "ANTHROPIC_API_KEY not set for claude exe" (0.2783ms) - ✔ AUTH_FAILURE intervention is immediate BLOCK_AND_NOTIFY (0.5384ms) - ✔ CONTENT_POLICY intervention is immediate BLOCK_AND_NOTIFY (0.8407ms) - ✔ CODEX_SANDBOX first escalation is INJECT_PROMPT (1.6019ms) - ✔ MODEL_ERROR intervention is immediate BLOCK_AND_NOTIFY (0.4198ms) - ✔ INVALID_CONFIG intervention is immediate BLOCK_AND_NOTIFY (0.3878ms) - ✔ auth/config/policy/sandbox situation detection (16.674ms) -✖ agent-supervisor (401.5623ms) -▶ agent-work-analyzer alert throttle improvements - ✔ defines FAILED_SESSION_ALERT_MIN_COOLDOWN_MS constant at 1 hour (1.9744ms) - ✔ defines FAILED_SESSION_TRANSIENT_ALERT_MIN_COOLDOWN_MS constant at 2 hours (0.2317ms) - ✔ detects transient-only sessions separately from high-error sessions (0.1534ms) - ✔ applies separate cooldown for transient error alerts (0.1162ms) - ✔ classifies transport/reconnect storms as transient-only sessions (0.266ms) -✔ agent-work-analyzer alert throttle improvements (4.141ms) -✔ failed-session alerts use task-scoped cooldown key and 1h cooldown floor (0.7939ms) -✔ emitAlert uses cooldown key builder and per-alert cooldown window (1.6102ms) -✔ cooldowns hydrate from alert log on startup to survive restarts (0.4141ms) -✔ stale alert cooldown entries are periodically pruned to bound memory (0.285ms) -✔ processLogFile resets offset when stream log is truncated (0.8187ms) -▶ agent-work-analyzer replay window normalization - ✔ defines normalizeReplayMaxBytes function (1.8638ms) - ✔ reads AGENT_ALERT_COOLDOWN_REPLAY_MAX_BYTES from env (0.118ms) - ✔ defaults replay max bytes to 8MB (0.1563ms) - ✔ enforces minimum of 256KB (0.1497ms) - ✔ enforces maximum of 64MB (0.1334ms) - ✔ uses normalizeReplayMaxBytes result for cooldown hydration (0.1995ms) -✔ agent-work-analyzer replay window normalization (3.9019ms) -✔ agent-work-analyzer defaults to tailing startup log from EOF (2.5576ms) -✔ startup tail mode clears replayed in-memory sessions (1.2929ms) -✔ analyzer ignores events that do not include an attempt_id (0.185ms) -✔ alert logging uses a stable fallback scope identifier (0.1352ms) -▶ analyze-agent-work helpers - ✔ filters records by date window while preserving invalid timestamps (1.3953ms) - ✔ builds error clusters and ranks by count (0.9721ms) - ✔ builds correlation summaries with grouped attributes (5.691ms) - ✔ marks complexity as unknown when task_description is missing (1.9478ms) - ✔ produces a stable JSON payload shape for correlations (1.2463ms) -✔ analyze-agent-work helpers (12.5414ms) -▶ analyze-agent-work JSONL fixture determinism - ✔ agent-errors-sample.jsonl contains 15 records (0.3071ms) - ✔ agent-metrics-sample.jsonl contains 20 records (0.1573ms) - ✔ all JSONL error records have required fields (1.9422ms) - ✔ all JSONL metric records have required fields (1.812ms) - ✔ filterRecordsByWindow filters JSONL errors to a 7-day window (1.8203ms) - ✔ filterRecordsByWindow filters JSONL metrics to a 7-day window (0.4574ms) - ✔ buildErrorClusters from JSONL data ranks timeout as top cluster (0.6225ms) - ✔ buildErrorClusters produces at least 3 distinct fingerprints from JSONL sample (0.265ms) - ✔ buildErrorCorrelationJsonPayload returns stable shape from JSONL fixtures (15.1119ms) - ✔ each correlation entry has the expected key set (1.582ms) - ✔ clusters are sorted descending by count (0.3607ms) - ✔ normalizeErrorFingerprint extracts a stable fingerprint from similar messages (0.23ms) -✔ analyze-agent-work JSONL fixture determinism (25.5558ms) -▶ analyze-agent-work CLI - ✔ prints a ranked correlation report with executor and size breakdowns (886.5894ms) - ✔ emits valid JSON and applies days/top filters (572.1029ms) - ✔ exits cleanly with a no-data message when the log directory is empty (363.2489ms) -✔ analyze-agent-work CLI (1822.1778ms) -▶ AnomalyDetector - ▶ Token Overflow (P0) - ✔ detects token overflow and marks process dead (26.171ms) - ✔ stops processing lines after token overflow (dead process) (0.8296ms) - ✔ Token Overflow (P0) (27.6287ms) - ▶ Model Not Supported (P0) - ✔ warns on first failure at medium severity, kills at threshold (0.7907ms) - ✔ Model Not Supported (P0) (0.9206ms) - ▶ Stream Death (P1) - ✔ detects stream completion error (0.6952ms) - ✔ Stream Death (P1) (0.7966ms) - ▶ Tool Call Loop (P2) - ✔ detects consecutive identical tool calls (0.9076ms) - ✔ resets counter when different tool is called (0.3836ms) - ✔ escalates to HIGH at kill threshold (0.4022ms) - ✔ does NOT false-positive on different edits to the same file (0.5086ms) - ✔ DOES detect truly identical edits to the same file (real death loop) (0.5207ms) - ✔ applies elevated thresholds for iterative tools (Editing, Reading) (0.5267ms) - ✔ ignores toolCallId differences when fingerprinting (0.2585ms) - ✔ Tool Call Loop (P2) (3.8877ms) - ▶ Rebase Spiral (P1) - ✔ detects repeated rebase --continue (0.5191ms) - ✔ counts rebase --abort separately (0.2756ms) - ✔ Rebase Spiral (P1) (0.8866ms) - ▶ Git Push Loop (P2) - ✔ detects repeated git push (0.2769ms) - ✔ Git Push Loop (P2) (0.362ms) - ▶ Subagent Waste (P2) - ✔ detects excessive subagent spawning (0.277ms) - ✔ Subagent Waste (P2) (0.3534ms) - ▶ Tool Failures (P3) - ✔ detects cascading tool failures (0.4217ms) - ✔ Tool Failures (P3) (0.4813ms) - ▶ Thought Spinning (P3) - ✔ detects repeated identical thoughts (0.7936ms) - ✔ ignores short thoughts (single tokens) (0.3709ms) - ✔ ignores short streaming token fragments (portal, trust) (13.7836ms) - ✔ Thought Spinning (P3) (15.0878ms) - ▶ Session Completion - ✔ marks process dead on Done event (0.3508ms) - ✔ marks process dead on task_complete event (0.2947ms) - ✔ Session Completion (0.7618ms) - ▶ getStats() - ✔ returns correct statistics (0.4991ms) - ✔ tracks dead processes separately (0.2192ms) - ✔ getStats() (0.8035ms) - ▶ getStatusReport() - ✔ returns formatted HTML report (0.4869ms) - ✔ getStatusReport() (0.5352ms) - ▶ Dedup protection - ✔ does not emit duplicate anomalies within dedup window (0.3769ms) - ✔ Dedup protection (0.4303ms) - ▶ Notifications - ✔ sends Telegram notification for CRITICAL anomalies (0.2632ms) - ✔ does not send notifications for LOW severity (0.2372ms) - ✔ Notifications (0.5718ms) - ▶ Meta enrichment - ✔ captures taskTitle from metadata (0.5536ms) - ✔ Meta enrichment (1.0305ms) - ▶ resetProcess() - ✔ clears tracking state for a process (0.2522ms) - ✔ resetProcess() (0.3093ms) - ▶ Command Failure Rate (P3) - ✔ detects high command failure rate (0.7306ms) - ✔ Command Failure Rate (P3) (0.8666ms) - ▶ Kill action escalation - ✔ emits kill action for subagent waste at kill threshold (1.8024ms) - ✔ emits kill action for tool failure cascade at kill threshold (0.2943ms) - ✔ emits kill action for git push loop at kill threshold (0.219ms) - ✔ Kill action escalation (2.5493ms) - ▶ Thought spinning exclusions - ✔ excludes operational test-running thoughts from spinning detection (0.2817ms) - ✔ excludes 'waiting for' thoughts from spinning detection (0.2598ms) - ✔ still detects genuine thought spinning (non-operational) (0.2806ms) - ✔ Thought spinning exclusions (0.9065ms) -✔ AnomalyDetector (60.4294ms) -▶ createAnomalyDetector factory - ✔ creates and starts a detector (0.2652ms) -✔ createAnomalyDetector factory (0.3162ms) -▶ Circuit breaker escalation - ✔ escalates warn-only anomalies to kill after 3 dedup cycles (402.0247ms) -[anomaly-detector] circuit breaker: GIT_PUSH_LOOP fired 3x for gitpush- — escalating to KILL -[anomaly-detector] circuit breaker: GIT_PUSH_LOOP fired 4x for gitpush- — escalating to KILL - ✔ escalates git push warn to kill after repeated warnings (330.5557ms) -✔ Circuit breaker escalation (732.8442ms) -▶ MODEL_NOT_SUPPORTED kill at threshold - ✔ emits kill action when model failures hit kill threshold (2.6721ms) -✔ MODEL_NOT_SUPPORTED kill at threshold (2.8129ms) -▶ apply-pr-suggestions - ▶ parseSuggestions - ✔ extracts single-line suggestion from comment body (3.4492ms) - ✔ extracts multi-line suggestion (0.3098ms) - ✔ filters by author when specified (0.2651ms) - ✔ ignores comments without suggestion blocks (0.2371ms) - ✔ handles multiple suggestions in one comment (0.4184ms) - ✔ parseSuggestions (8.7536ms) - ▶ removeOverlaps - ✔ keeps non-overlapping suggestions (0.4819ms) - ✔ removes overlapping suggestions (0.2713ms) - ✔ removeOverlaps (1.5693ms) - ▶ applyToContent - ✔ applies single-line replacement (0.2726ms) - ✔ applies multi-line replacement (0.1594ms) - ✔ applies multiple non-overlapping replacements bottom-to-top (0.2027ms) - ✔ handles replacement that changes line count (0.1441ms) - ✔ applyToContent (0.9861ms) -✔ apply-pr-suggestions (12.5158ms) -▶ async safety guards - ✔ handles monitor failure promises with explicit catch guards (1.6391ms) - ✔ guards detached monitor scheduler/notifier dispatches (0.7736ms) - ✔ guards agent-work-analyzer stuck sweep interval (0.1925ms) - ✔ guards agent-pool fire-and-forget registry operations (0.2357ms) - ✔ guards auto-update poll scheduling (0.21ms) -✔ async safety guards (4.0932ms) -▶ extractErrors - ✔ parses PowerShell error format with column and Line block (27.7198ms) - ✔ parses ParserError without column and uses last pipe message (0.4048ms) - ✔ parses At-line stack traces with plus blocks (0.3832ms) - ✔ parses generic error types like ParameterBindingException (0.3078ms) - ✔ deduplicates signatures and ignores terminating errors without file info (0.3203ms) - ✔ returns empty array for empty input or warning-only logs (0.2276ms) - ✔ fails on raw ANSI logs but succeeds after stripping ANSI codes (0.3349ms) -✔ extractErrors (30.7096ms) -▶ extractFallbackContext - ✔ handles empty logs (0.4238ms) - ✔ returns full tail for short logs (0.9058ms) - ✔ extracts tail and error indicators from long logs (0.9484ms) -✔ extractFallbackContext (2.4792ms) -▶ isDevMode + resetDevModeCache - ✔ returns true for AUTOFIX_MODE=dev (0.7016ms) - ✔ returns false for AUTOFIX_MODE=npm (analyze-only) (0.1675ms) - ✔ falls back to repo detection when mode is missing (14.4128ms) - ✔ returns false for explicit analyze-only modes (0.3388ms) - ✔ resets cached value (0.3335ms) -✔ isDevMode + resetDevModeCache (16.2123ms) -[autofix] npm mode — loop fix: analysis only -[autofix] npm mode — loop fix: analysis only -▶ getFixAttemptCount - ✔ increments per signature (29.0278ms) -[autofix] npm mode — loop fix: analysis only -[autofix] npm mode — loop fix: analysis only - ✔ keeps counts isolated per signature (7.3874ms) -✔ getFixAttemptCount (36.6251ms) -▶ bosun SWE-bench bridge - ✔ prints usage when invoked without a command (857.1137ms) - ✔ imports SWE-bench instances into the internal task store (1264.3324ms) -✔ bosun SWE-bench bridge (2122.6478ms) -▶ benchmark mode state - ✔ persists normalized repo-local benchmark mode state (15.356ms) - ✔ matches benchmark tasks by workspace path and generic benchmark metadata (6.9342ms) -✔ benchmark mode state (23.4898ms) -▶ bosun MCP server - ✖ lists the Bosun MCP tool surface over stdio (1434.9594ms) - ✖ supports creating and reading sessions through MCP tools (1395.2434ms) -✖ bosun MCP server (2832.3186ms) -▶ action.bosun_tool - ✔ is registered with correct schema (2.1075ms) - ✔ throws when toolId is missing (2.5052ms) - ✔ returns error output when tool not found (18.5146ms) - ✔ resolves toolId from template variables (3.1487ms) - ✔ stores result in outputVariable when configured (4.4084ms) -[workflow-engine] trigger:fired trigger (trigger.manual) [Start] wf=Test Workflow -[workflow-engine] node:start invoke (action.invoke_workflow) [Invoke Child] wf=Test Workflow -[workflow-engine] trigger:fired child-trigger (trigger.manual) [Start] wf=Child -[workflow-engine] node:complete invoke (action.invoke_workflow) [Invoke Child] -[workflow-engine] trigger:fired trigger (trigger.manual) [Start] wf=Test Workflow -[workflow-engine] node:start invoke (action.invoke_workflow) [Invoke] wf=Test Workflow -[workflow-engine] trigger:fired child-trigger (trigger.manual) [Start] wf=Test Workflow -[workflow-engine] node:start child-set-var (action.set_variable) [Set Var] wf=Test Workflow -[workflow-engine] node:complete child-set-var (action.set_variable) [Set Var] -[workflow-engine] node:complete invoke (action.invoke_workflow) [Invoke] -[workflow-engine] node:start log (notify.log) [Log] wf=Test Workflow -[workflow-nodes] Child ran: child-integration-wf -[workflow-engine] node:complete log (notify.log) [Log] -[workflow-engine] trigger:fired trigger (trigger.manual) [Start] wf=Test Workflow -[workflow-engine] node:start git-info (action.bosun_function) [Git Info] wf=Test Workflow -[workflow-engine] node:complete git-info (action.bosun_function) [Git Info] -[workflow-engine] node:start log (notify.log) [Log] wf=Test Workflow -[workflow-nodes] Branch: codex/site-demo-sync -[workflow-engine] node:complete log (notify.log) [Log] -[workflow-engine] trigger:fired trigger (trigger.manual) [Start] wf=Test Workflow -[workflow-engine] node:start fn (action.bosun_function) [Get Branch] wf=Test Workflow -[workflow-engine] node:complete fn (action.bosun_function) [Get Branch] -[workflow-engine] node:start log (notify.log) [Log Branch] wf=Test Workflow -[workflow-nodes] Branch: codex/site-demo-sync, Count: 34 -[workflow-engine] node:complete log (notify.log) [Log Branch] -[workflow-engine] trigger:fired trigger (trigger.manual) [Start] wf=Test Workflow -[workflow-engine] node:start get-branch (action.bosun_function) [Get Branch] wf=Test Workflow -[workflow-engine] node:complete get-branch (action.bosun_function) [Get Branch] -[workflow-engine] node:start invoke-child (action.invoke_workflow) [Invoke Child] wf=Test Workflow -[workflow-engine] trigger:fired child-trigger (trigger.manual) [Start] wf=Test Workflow -[workflow-engine] node:start child-action (action.set_variable) [Set Child Data] wf=Test Workflow -[workflow-engine] node:complete child-action (action.set_variable) [Set Child Data] -[workflow-engine] node:complete invoke-child (action.invoke_workflow) [Invoke Child] -[workflow-engine] node:start log (notify.log) [Final Log] wf=Test Workflow -[workflow-nodes] Branch: codex/site-demo-sync, Child: true -[workflow-engine] node:complete log (notify.log) [Final Log] - ✔ can invoke a builtin tool (list-todos) on a real workspace (545.6401ms) - ✔ resolves args with template interpolation (2.9723ms) - ✔ records Bosun tool execution in the execution ledger when engine hook exists (6.4512ms) -✔ action.bosun_tool (586.9636ms) -▶ action.build_task_prompt - ✔ splits user/system prompts and keeps system prompt stable across tasks (7.9687ms) - ✔ falls back to the task ID when the title is the default placeholder (2.5034ms) - ✔ injects workflow continuation guidance from issue advisor into task prompts (2.2112ms) -✔ action.build_task_prompt (12.9097ms) -▶ action.continue_session - ✔ prepends issue-advisor guidance to continuation prompts (0.5429ms) -✔ action.continue_session (0.6256ms) -▶ action.invoke_workflow - ✔ is registered with correct schema (2.8415ms) - ✔ throws when workflowId is empty (1.3957ms) - ✔ throws when engine is not available (1.275ms) - ✔ soft-fails when workflow not found and failOnError is false (default) (3.7343ms) - ✔ throws when workflow not found and failOnError is true (2.809ms) - ✔ sync mode executes child and forwards output (390.567ms) - ✔ dispatch mode returns immediately without waiting (4.344ms) - ✔ dispatch mode accepts synchronous engine return values (2.1863ms) - ✔ handles child workflow failure gracefully (failOnError=false) (2.7051ms) - ✔ throws on child failure when failOnError=true (1.7892ms) - ✔ forwards child workflow node outputs to parent (4.8569ms) - ✔ extracts from specific child nodes via extractFromNodes (1.2828ms) - ✔ filters forwarded fields via forwardFields (2.7749ms) - ✔ pipes parent context when pipeContext=true (1.3511ms) - ✔ resolves workflowId from template variables (1.8929ms) - ✔ integrates in a real workflow engine execution (353.8226ms) -✔ action.invoke_workflow (780.4235ms) -▶ action.bosun_function - ✔ is registered with correct schema (1.2409ms) - ✔ throws when function name is missing (0.8165ms) - ✔ throws for unknown function name (0.3952ms) - ✔ calls tools.builtin and returns builtin tool list (0.5065ms) - ✔ calls git.status and returns structured git info (708.4661ms) - ✔ calls git.branch and returns branch info (390.9952ms) - ✔ calls git.log and returns commit list (889.7763ms) - ✔ calls workflows.list with engine (0.6053ms) - ✔ calls config.show and returns config data (0.8279ms) - ✔ handles service unavailability gracefully (0.4218ms) - ✔ resolves function name from template variables (0.2739ms) - ✔ resolves args from template variables (652.1136ms) - ✔ supports extract config for field extraction (2.3357ms) - ✔ supports outputMap for field renaming (436.182ms) - ✔ integrates in a real workflow engine execution (385.5582ms) -✔ action.bosun_function (3471.1751ms) -▶ Bosun native templates - ✔ BOSUN_TOOL_PIPELINE_TEMPLATE has valid structure (0.9549ms) - ✔ WORKFLOW_COMPOSITION_TEMPLATE has valid structure (0.3678ms) - ✔ INLINE_WORKFLOW_COMPOSITION_TEMPLATE has valid structure (0.3203ms) - ✔ MCP_TO_BOSUN_BRIDGE_TEMPLATE has valid structure (0.2975ms) - ✔ GIT_HEALTH_PIPELINE_TEMPLATE has valid structure (0.3075ms) - ✔ all templates are registered in WORKFLOW_TEMPLATES (0.431ms) - ✔ all template nodes reference valid registered node types (0.6572ms) -✔ Bosun native templates (3.5625ms) -▶ cross-node data piping - ✔ pipes data from bosun_function to notify.log via templates (498.979ms) - ✔ chains bosun_function → invoke_workflow → notify.log (796.8455ms) -✔ cross-node data piping (1295.9598ms) diff --git a/github/github-app-auth.mjs b/github/github-app-auth.mjs index 31106746e..f10f61033 100644 --- a/github/github-app-auth.mjs +++ b/github/github-app-auth.mjs @@ -1,3 +1,4 @@ +#!/usr/bin/env node /** * github-app-auth.mjs — GitHub App JWT + Installation Token helpers * diff --git a/github/github-auth-manager.mjs b/github/github-auth-manager.mjs index 6e79790af..fa7e7895f 100644 --- a/github/github-auth-manager.mjs +++ b/github/github-auth-manager.mjs @@ -17,33 +17,6 @@ import { getInstallationTokenForRepo, } from "./github-app-auth.mjs"; -// Lazy vault import — avoids circular dependency at startup -let _vaultModule = null; -async function tryVaultGitHubToken() { - try { - if (!_vaultModule) _vaultModule = await import("../lib/vault.mjs"); - const { VaultStore } = _vaultModule; - const { keychainRead } = await import("../lib/vault-keychain.mjs"); - const v = new VaultStore(); - if (!v.isInitialized()) return null; - const key = keychainRead(); - if (!key) return null; - v.open(key); - // Look for a GitHub integration secret - const secrets = v.listSecrets().filter((s) => s.integration === "github"); - for (const s of secrets) { - const full = v.getSecret(s.id); - const t = full.fields?.token || full.fields?.apiKey || ""; - if (t) return t; - } - // Fallback: check vault env for GH_TOKEN - const envToken = v.getEnv("GH_TOKEN") || v.getEnv("GITHUB_TOKEN") || ""; - return envToken || null; - } catch { - return null; - } -} - // ── Constants ───────────────────────────────────────────────────────────────── const BOSUN_AUTH_STATE_PATH = join(homedir(), ".bosun", "github-auth-state.json"); @@ -114,7 +87,6 @@ async function getGhCliToken() { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"], timeout: 5000, - windowsHide: process.platform === "win32", }).trim(); return token || null; } catch { @@ -211,14 +183,6 @@ export async function getGitHubToken(options = {}) { } } - // ── 5. Bosun vault fallback ─────────────────────────────────────────────── - if (!isSkipped("vault")) { - const vaultToken = await tryVaultGitHubToken(); - if (vaultToken) { - return { token: vaultToken, type: "vault" }; - } - } - throw new Error( "No GitHub auth available. Set GITHUB_TOKEN, run `gh auth login`, " + "or configure the Bosun GitHub App (BOSUN_GITHUB_APP_ID + BOSUN_GITHUB_PRIVATE_KEY_PATH).", diff --git a/infra/container-runner.mjs b/infra/container-runner.mjs index 340b016b8..afc96215a 100644 --- a/infra/container-runner.mjs +++ b/infra/container-runner.mjs @@ -20,23 +20,6 @@ import { spawn, spawnSync, execSync } from "node:child_process"; import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs"; import { resolve, basename, join } from "node:path"; -function resolveProcessCommand(command) { - const normalizedCommand = String(command || "").trim(); - if (!normalizedCommand || process.platform !== "win32") { - return { command: normalizedCommand, needsShell: false }; - } - - if (/^[A-Za-z]:[\\/]|^[\\/]{2}|[\\/]/.test(normalizedCommand)) { - return { command: normalizedCommand, needsShell: false }; - } - - if (/\.(?:cmd|bat|exe|com)$/i.test(normalizedCommand)) { - return { command: normalizedCommand, needsShell: false }; - } - - return { command: `${normalizedCommand}.cmd`, needsShell: true }; -} - // ── Configuration ──────────────────────────────────────────────────────────── const containerEnabled = ["1", "true", "yes"].includes( @@ -344,17 +327,15 @@ async function runIsolatedProcess(options = {}) { } = options; return new Promise((resolvePromise) => { - const { command: resolvedCommand, needsShell } = resolveProcessCommand(command); const useArgv = Array.isArray(args) && args.length > 0; const proc = useArgv - ? spawn(String(resolvedCommand || ""), args.map((arg) => String(arg)), { + ? spawn(String(command || ""), args.map((arg) => String(arg)), { cwd, env: { ...process.env, ...env }, stdio: ["ignore", "pipe", "pipe"], windowsHide: true, - shell: needsShell, }) - : spawn(String(resolvedCommand || ""), { + : spawn(String(command || ""), { cwd, env: { ...process.env, ...env }, stdio: ["ignore", "pipe", "pipe"], diff --git a/infra/guardrails.mjs b/infra/guardrails.mjs deleted file mode 100644 index 05cdb793a..000000000 --- a/infra/guardrails.mjs +++ /dev/null @@ -1,314 +0,0 @@ -import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs"; -import { resolve } from "node:path"; - -export const DEFAULT_INPUT_POLICY = Object.freeze({ - enabled: true, - warnThreshold: 60, - blockThreshold: 35, - minTitleLength: 8, - minDescriptionLength: 24, - minContextFields: 1, - minCombinedTokens: 10, -}); - -export const DEFAULT_PUSH_POLICY = Object.freeze({ - workflowOnly: true, - blockAgentPushes: true, - requireManagedPrePush: true, -}); - -const GENERIC_TEXT_PATTERNS = [ - /\b(?:asdf|placeholder|tbd|todo|unknown|misc|thing|stuff|whatever)\b/i, - /^(?:fix|test|tmp|wip|na|n\/a|none|help)$/i, - /^\W+$/, -]; - -function parseBooleanLike(value, fallback) { - if (value === undefined || value === null || value === "") return fallback; - const normalized = String(value).trim().toLowerCase(); - if (["1", "true", "yes", "on"].includes(normalized)) return true; - if (["0", "false", "no", "off"].includes(normalized)) return false; - return fallback; -} - -function clampNumber(value, min, max, fallback) { - const numeric = Number(value); - if (!Number.isFinite(numeric)) return fallback; - return Math.min(max, Math.max(min, numeric)); -} - -function normalizeText(value) { - return String(value || "").replace(/\s+/g, " ").trim(); -} - -function collectTextValues(value, bucket = []) { - if (value == null) return bucket; - if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") { - const normalized = normalizeText(value); - if (normalized) bucket.push(normalized); - return bucket; - } - if (Array.isArray(value)) { - for (const entry of value) collectTextValues(entry, bucket); - return bucket; - } - if (typeof value === "object") { - for (const [key, entry] of Object.entries(value)) { - if (["guardrailsOverride", "overrideGuardrails", "INPUTOverride"].includes(key)) continue; - collectTextValues(entry, bucket); - } - } - return bucket; -} - -function tokenize(text) { - return normalizeText(text) - .toLowerCase() - .split(/[^a-z0-9]+/i) - .filter(Boolean); -} - -function addFinding(findings, id, penalty, message) { - findings.push({ - id, - penalty, - message, - severity: penalty >= 25 ? "high" : penalty >= 15 ? "medium" : "low", - }); -} - -function readPolicyFile(policyPath) { - if (!existsSync(policyPath)) return {}; - try { - return JSON.parse(readFileSync(policyPath, "utf8")); - } catch { - return {}; - } -} - -function normalizeScriptEntries(scripts, matcher) { - return Object.entries(scripts) - .filter(([name]) => matcher.test(String(name || ""))) - .map(([name, command]) => ({ name, command: String(command || "") })); -} - -export function normalizeINPUTPolicy(raw = {}) { - return { - enabled: parseBooleanLike(raw?.enabled, DEFAULT_INPUT_POLICY.enabled), - warnThreshold: clampNumber(raw?.warnThreshold, 1, 100, DEFAULT_INPUT_POLICY.warnThreshold), - blockThreshold: clampNumber(raw?.blockThreshold, 0, 100, DEFAULT_INPUT_POLICY.blockThreshold), - minTitleLength: clampNumber(raw?.minTitleLength, 0, 200, DEFAULT_INPUT_POLICY.minTitleLength), - minDescriptionLength: clampNumber(raw?.minDescriptionLength, 0, 2000, DEFAULT_INPUT_POLICY.minDescriptionLength), - minContextFields: clampNumber(raw?.minContextFields, 0, 50, DEFAULT_INPUT_POLICY.minContextFields), - minCombinedTokens: clampNumber(raw?.minCombinedTokens, 0, 200, DEFAULT_INPUT_POLICY.minCombinedTokens), - }; -} - -export function normalizePushPolicy(raw = {}) { - return { - workflowOnly: parseBooleanLike(raw?.workflowOnly, DEFAULT_PUSH_POLICY.workflowOnly), - blockAgentPushes: parseBooleanLike(raw?.blockAgentPushes, DEFAULT_PUSH_POLICY.blockAgentPushes), - requireManagedPrePush: parseBooleanLike(raw?.requireManagedPrePush, DEFAULT_PUSH_POLICY.requireManagedPrePush), - }; -} - -export function normalizeGuardrailsPolicy(raw = {}) { - const source = raw && typeof raw === "object" ? raw : {}; - return { - INPUT: normalizeINPUTPolicy(source?.INPUT && typeof source.INPUT === "object" ? source.INPUT : {}), - push: normalizePushPolicy(source?.push && typeof source.push === "object" ? source.push : {}), - }; -} - -export function getGuardrailsPolicyPath(rootDir) { - return resolve(rootDir, ".bosun", "guardrails.json"); -} - -export function loadGuardrailsPolicy(rootDir) { - const policyPath = getGuardrailsPolicyPath(rootDir); - return normalizeGuardrailsPolicy(readPolicyFile(policyPath)); -} - -export function saveGuardrailsPolicy(rootDir, raw = {}) { - const normalized = normalizeGuardrailsPolicy(raw); - const policyPath = getGuardrailsPolicyPath(rootDir); - mkdirSync(resolve(rootDir, ".bosun"), { recursive: true }); - writeFileSync(policyPath, JSON.stringify(normalized, null, 2) + "\n", "utf8"); - return normalized; -} - -export function ensureGuardrailsPolicy(rootDir) { - const policyPath = getGuardrailsPolicyPath(rootDir); - if (!existsSync(policyPath)) { - return saveGuardrailsPolicy(rootDir, { INPUT: DEFAULT_INPUT_POLICY, push: DEFAULT_PUSH_POLICY }); - } - const normalized = loadGuardrailsPolicy(rootDir); - writeFileSync(policyPath, JSON.stringify(normalized, null, 2) + "\n", "utf8"); - return normalized; -} - -export function shouldBlockAgentPushes(rootDir) { - return loadGuardrailsPolicy(rootDir).push.blockAgentPushes !== false; -} - -export function shouldRequireManagedPrePush(rootDir) { - return loadGuardrailsPolicy(rootDir).push.requireManagedPrePush !== false; -} - -export function detectRepoGuardrails(rootDir) { - const packageJsonPath = resolve(rootDir, "package.json"); - let packageJson = null; - try { - packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8")); - } catch { - packageJson = null; - } - - const scripts = packageJson?.scripts && typeof packageJson.scripts === "object" - ? packageJson.scripts - : {}; - const prepushScripts = normalizeScriptEntries(scripts, /^(?:prepush(?::|$)|pre-push$|check:prepush$)/i); - const prepublishScripts = normalizeScriptEntries(scripts, /^(?:prepublish(?:only)?(?::|$)|pre-publish$)/i); - const ciScripts = normalizeScriptEntries( - scripts, - /^(?:ci(?::|$)|test(?::|$)|build(?::|$)|lint(?::|$)|check(?::|$)|verify(?::|$)|release(?::|$))/i, - ).filter((entry) => !prepushScripts.some((candidate) => candidate.name === entry.name)); - - const categories = { - prepush: { - detected: prepushScripts.length > 0, - enforced: prepushScripts.length > 0, - scripts: prepushScripts, - }, - prepublish: { - detected: prepublishScripts.length > 0, - enforced: prepublishScripts.length > 0, - scripts: prepublishScripts, - }, - ci: { - detected: ciScripts.length > 0, - enforced: ciScripts.length > 0, - scripts: ciScripts, - }, - }; - - return { - rootDir, - packageJsonPath, - hasPackageJson: packageJson != null, - packageName: typeof packageJson?.name === "string" ? packageJson.name : "", - categories, - detectedCount: Object.values(categories).filter((entry) => entry.detected).length, - }; -} - -export function assessInputQuality(input = {}, policy = DEFAULT_INPUT_POLICY) { - const normalizedPolicy = normalizeINPUTPolicy(policy); - const title = normalizeText(input?.title); - const description = normalizeText(input?.description); - const metadataValues = collectTextValues(input?.metadata || {}); - const formValues = collectTextValues(input?.formValues || {}); - const contextValues = [...metadataValues, ...formValues]; - const combinedText = [title, description, ...contextValues].filter(Boolean).join(" "); - const tokens = tokenize(combinedText); - const uniqueTokens = new Set(tokens); - const uniqueTokenRatio = tokens.length > 0 ? uniqueTokens.size / tokens.length : 0; - const genericHits = [title, description, ...contextValues].filter(Boolean).filter((value) => - GENERIC_TEXT_PATTERNS.some((pattern) => pattern.test(value)), - ); - - const findings = []; - let score = 100; - - if (normalizedPolicy.enabled !== true) { - return { - policy: normalizedPolicy, - score, - status: "disabled", - blocked: false, - summary: "INPUT guardrails are disabled.", - findings, - metrics: { - titleLength: title.length, - descriptionLength: description.length, - contextFieldCount: contextValues.length, - tokenCount: tokens.length, - uniqueTokenRatio, - }, - }; - } - - if (!title) { - score -= 45; - addFinding(findings, "missing-title", 45, "A clear title is required."); - } else if (title.length < normalizedPolicy.minTitleLength) { - const penalty = 30; - score -= penalty; - addFinding(findings, "short-title", penalty, `Title should be at least ${normalizedPolicy.minTitleLength} characters.`); - } - - if (!description) { - score -= 35; - addFinding(findings, "missing-description", 35, "Add a description with enough implementation context."); - } else if (description.length < normalizedPolicy.minDescriptionLength) { - const penalty = 15; - score -= penalty; - addFinding(findings, "thin-description", penalty, `Description should be at least ${normalizedPolicy.minDescriptionLength} characters.`); - } - - if (contextValues.length < normalizedPolicy.minContextFields) { - const penalty = 15; - score -= penalty; - addFinding(findings, "missing-context", penalty, `Provide at least ${normalizedPolicy.minContextFields} populated context field(s).`); - } - - if (tokens.length < normalizedPolicy.minCombinedTokens) { - const penalty = 20; - score -= penalty; - addFinding(findings, "low-signal", penalty, `Input should contain at least ${normalizedPolicy.minCombinedTokens} meaningful tokens.`); - } - - if (uniqueTokenRatio > 0 && uniqueTokenRatio < 0.45) { - const penalty = 10; - score -= penalty; - addFinding(findings, "repetitive-input", penalty, "Input is too repetitive to be reliable."); - } - - if (title && description && title.toLowerCase() === description.toLowerCase()) { - const penalty = 10; - score -= penalty; - addFinding(findings, "duplicated-summary", penalty, "Title and description should not repeat the same text."); - } - - if (genericHits.length > 0) { - const penalty = Math.min(30, genericHits.length * 10); - score -= penalty; - addFinding(findings, "generic-language", penalty, "Replace placeholder or generic text with concrete intent."); - } - - score = Math.max(0, Math.min(100, score)); - const status = score < normalizedPolicy.blockThreshold - ? "block" - : score < normalizedPolicy.warnThreshold - ? "warn" - : "pass"; - - return { - policy: normalizedPolicy, - score, - status, - blocked: status === "block", - summary: - findings[0]?.message || - (status === "pass" ? "Input quality passed INPUT guardrails." : "Input quality needs more detail."), - findings, - metrics: { - titleLength: title.length, - descriptionLength: description.length, - contextFieldCount: contextValues.length, - tokenCount: tokens.length, - uniqueTokenRatio: Number(uniqueTokenRatio.toFixed(3)), - genericHitCount: genericHits.length, - }, - }; -} diff --git a/infra/heartbeat-monitor.mjs b/infra/heartbeat-monitor.mjs deleted file mode 100644 index 3bcaf5613..000000000 --- a/infra/heartbeat-monitor.mjs +++ /dev/null @@ -1,432 +0,0 @@ -import { request as httpRequest } from "node:http"; -import { existsSync, mkdirSync, readFileSync, appendFileSync } from "node:fs"; -import { open } from "node:fs/promises"; -import { request as httpsRequest } from "node:https"; -import { monitorEventLoopDelay } from "node:perf_hooks"; -import { dirname, resolve } from "node:path"; - -const DEFAULT_INTERVAL_MS = 30_000; -const DEFAULT_TIMEOUT_MS = 5_000; -const DEFAULT_SUCCESS_LOG_INTERVAL_MS = 10 * 60_000; -const DEFAULT_EVENT_LOOP_WARN_MS = 1_000; -const DEFAULT_TAIL_LINES = 40; -const DEFAULT_TAIL_BYTES = 16 * 1024; -const HEARTBEAT_LOG_FILE = "heartbeat-monitor.log"; -const UI_LAST_PORT_FILE = "ui-last-port.json"; - -function clampPositiveNumber(value, fallback, min = 1) { - const numeric = Number(value); - if (!Number.isFinite(numeric) || numeric < min) return fallback; - return Math.trunc(numeric); -} - -function summarizeEventLoopDelay(histogram) { - if (!histogram) { - return { meanMs: 0, maxMs: 0, p99Ms: 0 }; - } - return { - meanMs: Number((histogram.mean / 1e6).toFixed(3)) || 0, - maxMs: Number((histogram.max / 1e6).toFixed(3)) || 0, - p99Ms: Number((histogram.percentile(99) / 1e6).toFixed(3)) || 0, - }; -} - -function isAbortTimeoutError(error) { - const name = String(error?.name || "").trim().toLowerCase(); - const message = String(error?.message || "").trim().toLowerCase(); - return name === "aborterror" || message.includes("aborted"); -} - -function resolveHeartbeatLogPath(logDir) { - return resolve(String(logDir || process.cwd()), HEARTBEAT_LOG_FILE); -} - -function resolveUiLastPortPath(configDir) { - return resolve(String(configDir || process.cwd()), ".cache", UI_LAST_PORT_FILE); -} - -function normalizeUiProbeHost(host) { - const normalized = String(host || "").trim().toLowerCase(); - if ( - !normalized || - normalized === "0.0.0.0" || - normalized === "::" || - normalized === "[::]" || - normalized === "::0" - ) { - return "127.0.0.1"; - } - return normalized === "localhost" ? "127.0.0.1" : normalized; -} - -function buildProbeUrl({ protocol = "http", host = "127.0.0.1", port = 0, healthPath = "/healthz" } = {}) { - const safeProtocol = String(protocol || "").trim().toLowerCase() === "https" ? "https" : "http"; - const safeHost = normalizeUiProbeHost(host); - const safePort = Number(port); - if (!Number.isFinite(safePort) || safePort <= 0 || safePort > 65535) return null; - const safeHealthPath = String(healthPath || "/healthz").startsWith("/") - ? String(healthPath || "/healthz") - : `/${String(healthPath || "healthz")}`; - return `${safeProtocol}://${safeHost}:${Math.trunc(safePort)}${safeHealthPath}`; -} - -function readUiProbeTarget(configDir, fallbackHost = "127.0.0.1", healthPath = "/healthz") { - try { - const portPath = resolveUiLastPortPath(configDir); - if (!existsSync(portPath)) { - return { - port: 0, - host: normalizeUiProbeHost(fallbackHost), - protocol: "http", - url: null, - }; - } - const payload = JSON.parse(readFileSync(portPath, "utf8")); - const port = Number(payload?.port || 0); - if (!Number.isFinite(port) || port <= 0 || port > 65535) { - return { - port: 0, - host: normalizeUiProbeHost(fallbackHost), - protocol: "http", - url: null, - }; - } - let protocol = String(payload?.protocol || "").trim().toLowerCase() === "https" ? "https" : "http"; - let host = normalizeUiProbeHost(payload?.host || fallbackHost); - const rawUrl = String(payload?.url || "").trim(); - if (rawUrl) { - try { - const parsed = new URL(rawUrl); - if (parsed.port) { - const parsedPort = Number(parsed.port); - if (Number.isFinite(parsedPort) && parsedPort > 0 && parsedPort <= 65535) { - host = normalizeUiProbeHost(parsed.hostname || host); - protocol = parsed.protocol === "https:" ? "https" : "http"; - } - } - } catch { - // Fall back to discrete metadata fields. - } - } - return { - port: Math.trunc(port), - host, - protocol, - url: buildProbeUrl({ protocol, host, port, healthPath }), - }; - } catch { - return { - port: 0, - host: normalizeUiProbeHost(fallbackHost), - protocol: "http", - url: null, - }; - } -} - -async function probeWithNodeRequest(target, timeoutMs) { - const requestImpl = target.protocol === "https" ? httpsRequest : httpRequest; - return await new Promise((resolveProbe, rejectProbe) => { - const req = requestImpl( - { - protocol: target.protocol === "https" ? "https:" : "http:", - host: target.host, - port: target.port, - path: target.path, - method: "GET", - timeout: timeoutMs, - headers: { accept: "application/json" }, - }, - (res) => { - const chunks = []; - res.on("data", (chunk) => chunks.push(chunk)); - res.on("end", () => { - const text = Buffer.concat(chunks).toString("utf8"); - let payload = null; - try { - payload = text ? JSON.parse(text) : null; - } catch { - payload = text ? { raw: text } : null; - } - resolveProbe({ - ok: Number(res.statusCode || 0) >= 200 && Number(res.statusCode || 0) < 300, - status: Number(res.statusCode || 0), - text: async () => text, - payload, - }); - }); - }, - ); - req.on("error", rejectProbe); - req.on("timeout", () => { - const error = new Error("aborted"); - error.name = "AbortError"; - try { req.destroy(error); } catch { /* best effort */ } - }); - req.end(); - }); -} - -async function readTail(filePath, { maxLines = DEFAULT_TAIL_LINES, maxBytes = DEFAULT_TAIL_BYTES } = {}) { - try { - if (!existsSync(filePath)) return ""; - const handle = await open(filePath, "r"); - try { - const info = await handle.stat(); - const size = Number(info?.size || 0); - if (!Number.isFinite(size) || size <= 0) return ""; - const length = Math.max(1, Math.min(size, clampPositiveNumber(maxBytes, DEFAULT_TAIL_BYTES))); - const offset = Math.max(0, size - length); - const buffer = Buffer.alloc(length); - await handle.read(buffer, 0, length, offset); - let text = buffer.toString("utf8"); - if (offset > 0) { - const firstNewline = text.indexOf("\n"); - if (firstNewline >= 0) text = text.slice(firstNewline + 1); - } - const lines = text.split(/\r?\n/).filter(Boolean); - return lines.slice(-Math.max(1, clampPositiveNumber(maxLines, DEFAULT_TAIL_LINES))).join("\n"); - } finally { - await handle.close().catch(() => {}); - } - } catch { - return ""; - } -} - -async function readCorrelatedLogContext(logDir, options = {}) { - const monitorLogTail = await readTail(resolve(String(logDir || process.cwd()), "monitor.log"), options); - const monitorErrorLogTail = await readTail(resolve(String(logDir || process.cwd()), "monitor-error.log"), options); - return { - monitorLogTail, - monitorErrorLogTail, - }; -} - -export function createHeartbeatMonitor(options = {}) { - const configDir = String(options.configDir || process.cwd()); - const logDir = String(options.logDir || process.cwd()); - const fetchImpl = typeof options.fetchImpl === "function" ? options.fetchImpl : null; - const logger = options.logger && typeof options.logger === "object" ? options.logger : console; - const host = String(options.host || "127.0.0.1"); - const healthPath = String(options.healthPath || "/healthz"); - const intervalMs = clampPositiveNumber(options.intervalMs, DEFAULT_INTERVAL_MS, 1000); - const timeoutMs = clampPositiveNumber(options.timeoutMs, DEFAULT_TIMEOUT_MS, 100); - const successLogIntervalMs = clampPositiveNumber( - options.successLogIntervalMs, - DEFAULT_SUCCESS_LOG_INTERVAL_MS, - 1000, - ); - const eventLoopWarnMs = clampPositiveNumber( - options.eventLoopWarnMs, - DEFAULT_EVENT_LOOP_WARN_MS, - 1, - ); - const correlationOptions = { - maxLines: clampPositiveNumber(options.correlationMaxLines, DEFAULT_TAIL_LINES, 1), - maxBytes: clampPositiveNumber(options.correlationMaxBytes, DEFAULT_TAIL_BYTES, 1024), - }; - - let timer = null; - let running = false; - let inflight = null; - let lastOutcome = ""; - let lastSuccessLogAt = 0; - const histogram = monitorEventLoopDelay({ resolution: 20 }); - const state = { - lastProbeAt: 0, - lastSuccessAt: 0, - lastFailureAt: 0, - lastOutcome: "not_started", - lastError: "", - }; - - const logPath = resolveHeartbeatLogPath(logDir); - - function appendLog(entry) { - try { - mkdirSync(dirname(logPath), { recursive: true }); - appendFileSync(logPath, `${JSON.stringify(entry)}\n`, "utf8"); - } catch { - // best effort - } - } - - async function probeNow(trigger = "interval") { - if (inflight) return inflight; - inflight = (async () => { - const startedAt = Date.now(); - const eventLoop = summarizeEventLoopDelay(histogram); - histogram.reset(); - const target = readUiProbeTarget(configDir, options.host || host, healthPath); - const port = Number(target?.port || 0); - const baseEntry = { - ts: new Date(startedAt).toISOString(), - trigger, - port, - url: target?.url || null, - timeoutMs, - eventLoop, - }; - - if (!port) { - state.lastProbeAt = startedAt; - state.lastFailureAt = startedAt; - state.lastOutcome = "port_missing"; - state.lastError = "ui_last_port_missing"; - const outcome = "port_missing"; - if (outcome !== lastOutcome) { - appendLog({ - ...baseEntry, - level: "warn", - outcome, - error: "No persisted UI port found for heartbeat probe", - }); - lastOutcome = outcome; - } - return { ok: false, outcome }; - } - - const controller = new AbortController(); - const timeout = setTimeout(() => controller.abort(), timeoutMs); - if (typeof timeout.unref === "function") timeout.unref(); - - let outcome = "ok"; - let level = "info"; - let statusCode = 0; - let payload = null; - let errorMessage = ""; - try { - const response = typeof fetchImpl === "function" - ? await fetchImpl(target.url, { - signal: controller.signal, - headers: { accept: "application/json" }, - }) - : await probeWithNodeRequest( - { - protocol: target.protocol, - host: target.host, - port: target.port, - path: String(healthPath || "/healthz").startsWith("/") - ? String(healthPath || "/healthz") - : `/${String(healthPath || "healthz")}`, - }, - timeoutMs, - ); - statusCode = Number(response?.status || 0); - if (response?.payload !== undefined) { - payload = response.payload; - } else { - const text = await response.text(); - try { - payload = text ? JSON.parse(text) : null; - } catch { - payload = text ? { raw: text } : null; - } - } - if (!response.ok) { - outcome = "http_error"; - level = "warn"; - } else if (String(payload?.status || "").trim().toLowerCase() === "degraded") { - outcome = "degraded"; - level = "warn"; - } - } catch (error) { - errorMessage = String(error?.message || error || ""); - outcome = isAbortTimeoutError(error) ? "timeout" : "fetch_error"; - level = "error"; - } finally { - clearTimeout(timeout); - } - - const durationMs = Date.now() - startedAt; - const lagWarning = eventLoop.maxMs >= eventLoopWarnMs || eventLoop.p99Ms >= eventLoopWarnMs; - const needsCorrelation = outcome !== "ok" || lagWarning; - const correlatedLogs = needsCorrelation - ? await readCorrelatedLogContext(logDir, correlationOptions) - : null; - const recovered = outcome === "ok" && lastOutcome && lastOutcome !== "ok"; - const shouldLogSuccess = - outcome === "ok" && - (recovered || startedAt - lastSuccessLogAt >= successLogIntervalMs || lagWarning); - const shouldLog = outcome !== "ok" || shouldLogSuccess || outcome !== lastOutcome; - - state.lastProbeAt = startedAt; - state.lastOutcome = outcome; - state.lastError = errorMessage; - if (outcome === "ok") { - state.lastSuccessAt = startedAt; - lastSuccessLogAt = startedAt; - } else { - state.lastFailureAt = startedAt; - } - - if (shouldLog) { - appendLog({ - ...baseEntry, - durationMs, - level, - outcome: recovered ? "recovered" : outcome, - previousOutcome: lastOutcome || null, - statusCode: statusCode || null, - payload, - error: errorMessage || null, - lagWarning, - correlatedLogs, - }); - } - lastOutcome = outcome; - - if (outcome !== "ok" && typeof logger?.warn === "function") { - logger.warn( - `[heartbeat] ${outcome} ${baseEntry.url || "(missing url)"} after ${durationMs}ms`, - ); - } - - return { - ok: outcome === "ok", - outcome, - durationMs, - statusCode, - payload, - error: errorMessage || null, - lagWarning, - }; - })().finally(() => { - inflight = null; - }); - - return inflight; - } - - return { - start() { - if (running) return; - running = true; - histogram.enable(); - timer = setInterval(() => { - void probeNow("interval"); - }, intervalMs); - if (typeof timer.unref === "function") timer.unref(); - void probeNow("startup"); - }, - stop() { - running = false; - if (timer) { - clearInterval(timer); - timer = null; - } - histogram.disable(); - }, - probeNow, - getSnapshot() { - return { - ...state, - running, - intervalMs, - timeoutMs, - logPath, - }; - }, - }; -} diff --git a/infra/library-manager.mjs b/infra/library-manager.mjs index 7e40c19df..42afabcbd 100644 --- a/infra/library-manager.mjs +++ b/infra/library-manager.mjs @@ -313,21 +313,6 @@ export function getBosunHomeDir() { return resolve(homedir(), ".bosun"); } -const UNRESOLVED_TEMPLATE_TOKEN_RE = /\{\{[^{}]+\}\}/; - -export function hasUnresolvedTemplateTokens(value) { - return UNRESOLVED_TEMPLATE_TOKEN_RE.test(String(value || "")); -} - -function resolveLibraryRootDir(rootDir) { - const raw = String(rootDir || "").trim(); - if (!raw) return getBosunHomeDir(); - if (hasUnresolvedTemplateTokens(raw)) { - throw new Error(`Invalid library root path \"${raw}\": unresolved template token detected`); - } - return resolve(raw); -} - function ensureDir(dir) { mkdirSync(dir, { recursive: true }); return dir; @@ -587,7 +572,7 @@ function buildSkillIndexRevision(manifest) { } function updateIndexCache(cache, rootDir, index, manifestMtimeMs = 0) { - const cacheKey = resolveLibraryRootDir(rootDir); + const cacheKey = resolve(rootDir || getBosunHomeDir()); const payload = { ...index, count: Array.isArray(index?.profiles) @@ -1027,19 +1012,19 @@ function resolveToolSelection(rootDir, best) { } export function getLibraryIndexDir(rootDir) { - return resolve(resolveLibraryRootDir(rootDir), LIBRARY_INDEX_DIR); + return resolve(rootDir || getBosunHomeDir(), LIBRARY_INDEX_DIR); } export function getAgentProfileIndexPath(rootDir) { - return resolve(resolveLibraryRootDir(rootDir), LIBRARY_INDEX_DIR, AGENT_PROFILE_INDEX); + return resolve(rootDir || getBosunHomeDir(), LIBRARY_INDEX_DIR, AGENT_PROFILE_INDEX); } export function getSkillEntryIndexPath(rootDir) { - return resolve(resolveLibraryRootDir(rootDir), LIBRARY_INDEX_DIR, SKILL_ENTRY_INDEX); + return resolve(rootDir || getBosunHomeDir(), LIBRARY_INDEX_DIR, SKILL_ENTRY_INDEX); } export function rebuildAgentProfileIndex(rootDir, manifest = loadManifest(rootDir)) { - const normalizedRoot = resolveLibraryRootDir(rootDir); + const normalizedRoot = resolve(rootDir || getBosunHomeDir()); const profiles = (manifest?.entries || []) .filter((entry) => entry?.type === "agent") .map((entry) => buildIndexedAgentProfile(normalizedRoot, entry)) @@ -1056,7 +1041,7 @@ export function rebuildAgentProfileIndex(rootDir, manifest = loadManifest(rootDi } export function loadAgentProfileIndex(rootDir, options = {}) { - const normalizedRoot = resolveLibraryRootDir(rootDir); + const normalizedRoot = resolve(rootDir || getBosunHomeDir()); const manifestPath = getManifestPath(normalizedRoot); const manifestMtimeMs = getFileMtimeMs(manifestPath); const cacheEntry = agentProfileIndexCache.get(normalizedRoot); @@ -1097,7 +1082,7 @@ export function listIndexedAgentProfiles(rootDir, options = {}) { } export function rebuildSkillEntryIndex(rootDir, manifest = loadManifest(rootDir)) { - const normalizedRoot = resolveLibraryRootDir(rootDir); + const normalizedRoot = resolve(rootDir || getBosunHomeDir()); const skills = (manifest?.entries || []) .filter((entry) => entry?.type === "skill") .map((entry) => buildIndexedSkillEntry(entry)); @@ -1127,7 +1112,7 @@ export function rebuildSkillEntryIndex(rootDir, manifest = loadManifest(rootDir) } export function loadSkillEntryIndex(rootDir, options = {}) { - const normalizedRoot = resolveLibraryRootDir(rootDir); + const normalizedRoot = resolve(rootDir || getBosunHomeDir()); const manifestPath = getManifestPath(normalizedRoot); const manifestMtimeMs = getFileMtimeMs(manifestPath); const cacheEntry = skillEntryIndexCache.get(normalizedRoot); @@ -1257,7 +1242,7 @@ export function resolveLibraryPlan(rootDir, criteria = {}, opts = {}) { * Get the manifest path for a workspace (or global). */ export function getManifestPath(rootDir) { - return resolve(resolveLibraryRootDir(rootDir), ".bosun", LIBRARY_MANIFEST); + return resolve(rootDir || getBosunHomeDir(), ".bosun", LIBRARY_MANIFEST); } /** @@ -1285,7 +1270,7 @@ export function saveManifest(rootDir, manifest) { // ── CRUD operations ────────────────────────────────────────────────────────── function dirForType(rootDir, type) { - const root = resolveLibraryRootDir(rootDir); + const root = rootDir || getBosunHomeDir(); switch (type) { case "prompt": return resolve(root, PROMPT_DIR); case "skill": return resolve(root, SKILL_DIR); @@ -2170,7 +2155,7 @@ function discoverMcpServersFromCodexConfig(rootDir) { * them into the library manifest/filesystem. */ export function syncAutoDiscoveredLibraryEntries(rootDir) { - const root = resolveLibraryRootDir(rootDir); + const root = rootDir || getBosunHomeDir(); const manifestSnapshot = loadManifest(root); const existingEntries = Array.isArray(manifestSnapshot?.entries) ? manifestSnapshot.entries diff --git a/infra/maintenance.mjs b/infra/maintenance.mjs index 572b4390a..2ee2e01d1 100644 --- a/infra/maintenance.mjs +++ b/infra/maintenance.mjs @@ -476,19 +476,12 @@ export function cleanupStaleBranches(repoRoot, opts = {}) { // 3. List all local branches let localBranches; try { - let r = spawnSync( + const r = spawnSync( "git", - ["for-each-ref", "refs/heads/", "--format=%(refname:short)"], + ["for-each-ref", "--format=%(refname:short)", "refs/heads/"], { cwd: repoRoot, encoding: "utf8", timeout: 10000, windowsHide: true }, ); - if (!r || typeof r.status === "undefined") { - r = spawnSync( - "git", - ["for-each-ref"], - { cwd: repoRoot, encoding: "utf8", timeout: 10000, windowsHide: true }, - ); - } - if (!r || r.status !== 0 || !r.stdout) return result; + if (r.status !== 0 || !r.stdout) return result; localBranches = r.stdout.trim().split("\n").filter(Boolean); } catch (e) { result.errors.push(`Failed to list branches: ${e.message}`); @@ -549,7 +542,7 @@ export function cleanupStaleBranches(repoRoot, opts = {}) { const remoteExists = spawnSync( "git", ["rev-parse", "--verify", `refs/remotes/${remoteRef}`], - { cwd: repoRoot, encoding: "utf8", timeout: 5000, windowsHide: true }, + { cwd: repoRoot, timeout: 5000, windowsHide: true }, ); if (remoteExists.status === 0) { @@ -1052,7 +1045,7 @@ export function syncLocalTrackingBranches(repoRoot, branches) { const refCheck = spawnSync( "git", ["rev-parse", "--verify", `refs/heads/${branch}`], - { cwd: repoRoot, encoding: "utf8", timeout: 5000, windowsHide: true }, + { cwd: repoRoot, timeout: 5000, windowsHide: true }, ); if (refCheck.status !== 0) { // Local branch doesn't exist — nothing to sync @@ -1064,7 +1057,7 @@ export function syncLocalTrackingBranches(repoRoot, branches) { const remoteCheck = spawnSync( "git", ["rev-parse", "--verify", `refs/remotes/${remoteRef}`], - { cwd: repoRoot, encoding: "utf8", timeout: 5000, windowsHide: true }, + { cwd: repoRoot, timeout: 5000, windowsHide: true }, ); if (remoteCheck.status !== 0) continue; @@ -1114,7 +1107,7 @@ export function syncLocalTrackingBranches(repoRoot, branches) { const update = spawnSync( "git", ["update-ref", `refs/heads/${branch}`, `refs/remotes/${remoteRef}`], - { cwd: repoRoot, encoding: "utf8", timeout: 5000, windowsHide: true }, + { cwd: repoRoot, timeout: 5000, windowsHide: true }, ); if (update.status === 0) { logThrottledBranchSync( @@ -1265,7 +1258,7 @@ export function syncLocalTrackingBranches(repoRoot, branches) { const update = spawnSync( "git", ["update-ref", `refs/heads/${branch}`, `refs/remotes/${remoteRef}`], - { cwd: repoRoot, encoding: "utf8", timeout: 5000, windowsHide: true }, + { cwd: repoRoot, timeout: 5000, windowsHide: true }, ); if (update.status === 0) { logThrottledBranchSync( @@ -1415,6 +1408,3 @@ export async function runMaintenanceSweep(opts = {}) { return result; } - - - diff --git a/infra/monitor.mjs b/infra/monitor.mjs index 5c7f672b5..29ccd77fc 100644 --- a/infra/monitor.mjs +++ b/infra/monitor.mjs @@ -1,4 +1,4 @@ -import { execSync, spawn, spawnSync, exec } from "node:child_process"; +import { execSync, spawn, spawnSync } from "node:child_process"; import { createHash, randomUUID } from "node:crypto"; import { existsSync, @@ -35,33 +35,6 @@ if (typeof net.setDefaultAutoSelectFamilyAttemptTimeout === "function") { net.setDefaultAutoSelectFamilyAttemptTimeout(2000); } -const heartbeatRuntimeState = { - current: null, -}; - -/** - * Non-blocking async shell exec — avoids blocking the HTTP server event loop. - * Use instead of execSync/spawnSync in timer callbacks and request handlers. - * @param {string} cmd - Shell command string - * @param {{ cwd?: string, timeout?: number, encoding?: string }} [opts] - * @returns {Promise} stdout on success, rejects with Error on non-zero exit - */ -function execAsync(cmd, { cwd, timeout = 30_000, encoding = "utf8" } = {}) { - return new Promise((resolve, reject) => { - const child = exec(cmd, { cwd, timeout, encoding, windowsHide: true }); - let stdout = ""; - let stderr = ""; - child.stdout?.on("data", (d) => { stdout += d; }); - child.stderr?.on("data", (d) => { stderr += d; }); - child.on("close", (code) => { - if (code === 0 || code === null) resolve(stdout); - else reject(Object.assign(new Error(`exec failed (${code}): ${cmd}`), { stdout, stderr, exitCode: code })); - }); - child.on("error", reject); - }); -} - - import { acquireMonitorLock } from "./maintenance.mjs"; import { @@ -112,7 +85,6 @@ import { import { loadConfig } from "../config/config.mjs"; import { formatPreflightReport, runPreflightChecks } from "./preflight.mjs"; import { startAutoUpdateLoop, stopAutoUpdateLoop } from "./update-check.mjs"; -import { createHeartbeatMonitor } from "./heartbeat-monitor.mjs"; import { isWhatsAppEnabled, startWhatsAppChannel, @@ -279,7 +251,6 @@ import { import { resolvePromptTemplate } from "../agent/agent-prompts.mjs"; import { resolveCodexProfileRuntime } from "../shell/codex-model-profiles.mjs"; import { sanitizeMonitorTailForPrompt as sanitizeMonitorTailForPromptShared } from "../monitor-tail-sanitizer.mjs"; -import { webhookEvents as _githubWebhookEvents } from "../github/github-oauth-portal.mjs"; const __dirname = resolve(fileURLToPath(new URL(".", import.meta.url))); // ── Anomaly signal file path (shared with orchestrator) ────────────────────── @@ -1011,11 +982,7 @@ async function ensureWorkflowAutomationEngine() { "template-task-lifecycle", "template-task-finalization-guard", "template-agent-session-monitor", - "template-bosun-pr-watchdog", - "template-bosun-pr-progressor", "template-github-kanban-sync", - "template-recover-blocked-task", - "template-recover-blocked-worktrees", ], }); if (Number(reconcile?.autoUpdated || 0) > 0) { @@ -1087,6 +1054,12 @@ async function ensureWorkflowAutomationEngine() { } } + // Resume runs paused by a previous monitor shutdown after services are wired. + if (typeof engine.resumeInterruptedRuns === "function") { + engine.resumeInterruptedRuns().catch((err) => { + console.warn(`[workflows] Failed to resume interrupted runs: ${err?.message || err}`); + }); + } workflowAutomationInitDone = true; return engine; } catch (err) { @@ -1108,13 +1081,13 @@ async function ensureWorkflowAutomationEngine() { async function dispatchWorkflowEvent(eventType, eventData = {}, opts = {}) { try { - if (!workflowAutomationEnabled && !opts?.engine) return false; + if (!workflowAutomationEnabled) return false; const dedupKey = String(opts?.dedupKey || "").trim(); if (dedupKey && !allowWorkflowEvent(dedupKey)) { return false; } - const engine = opts?.engine || await ensureWorkflowAutomationEngine(); + const engine = await ensureWorkflowAutomationEngine(); if (!engine?.evaluateTriggers || !engine?.execute) return false; const payload = buildWorkflowEventPayload(eventType, eventData); @@ -1131,8 +1104,7 @@ async function dispatchWorkflowEvent(eventType, eventData = {}, opts = {}) { if (!Array.isArray(triggered) || triggered.length === 0) { return false; } - const awaitRuns = opts?.awaitRuns === true; - const runPromises = []; + for (const match of triggered) { const workflowId = String(match?.workflowId || "").trim(); if (!workflowId) continue; @@ -1140,7 +1112,7 @@ async function dispatchWorkflowEvent(eventType, eventData = {}, opts = {}) { ...payload, _triggeredBy: match?.triggeredBy || null, }; - const runPromise = engine + void engine .execute(workflowId, runPayload) .then((ctx) => { const runId = ctx?.id || "unknown"; @@ -1151,34 +1123,17 @@ async function dispatchWorkflowEvent(eventType, eventData = {}, opts = {}) { console.log( `[workflows] auto-run ${runStatus} workflow=${workflowId} runId=${runId} event=${eventType}`, ); - return { workflowId, runId, runStatus, ctx }; }) .catch((err) => { console.warn( `[workflows] auto-run failed workflow=${workflowId} event=${eventType}: ${err?.message || err}`, ); - if (awaitRuns) { - throw err; - } - return null; }); - if (awaitRuns) { - runPromises.push(runPromise); - } else { - void runPromise; - } } console.log( `[workflows] event "${eventType}" triggered ${triggered.length} workflow run(s)`, ); - if (awaitRuns) { - return { - triggered: true, - triggeredCount: triggered.length, - runs: (await Promise.all(runPromises)).filter(Boolean), - }; - } return true; } catch (err) { console.warn(`[workflows] dispatchWorkflowEvent error for ${eventType}: ${err?.message || err}`); @@ -1190,67 +1145,6 @@ function queueWorkflowEvent(eventType, eventData = {}, opts = {}) { dispatchWorkflowEvent(eventType, eventData, opts).catch(() => {}); } -// ── GitHub webhook → workflow-engine bridge ────────────────────────────────── -// Forwards GitHub App webhook events from the OAuth portal's EventEmitter into -// the workflow trigger engine so that trigger.event nodes with -// eventType: "github:*" fire in real-time instead of requiring polling. - -const _GITHUB_BRIDGE_EVENTS = [ - "github:pull_request", - "github:pull_request_review", - "github:pull_request_review_comment", - "github:check_run", - "github:check_suite", - "github:push", - "github:issue_comment", - "github:status", - "github:workflow_run", - "github:workflow_job", - "github:installation", - "github:installation_repositories", -]; - -let _githubWebhookBridgeSetup = false; - -function setupGitHubWebhookBridge() { - if (_githubWebhookBridgeSetup) return; - _githubWebhookBridgeSetup = true; - try { - for (const eventType of _GITHUB_BRIDGE_EVENTS) { - _githubWebhookEvents.on(eventType, ({ action, payload } = {}) => { - const pr = payload?.pull_request; - const cr = payload?.check_run; - queueWorkflowEvent(eventType, { - eventType, - action: action ?? null, - repo: payload?.repository?.full_name ?? null, - // PR fields (available in pull_request, review, and review_comment events) - prNumber: pr?.number ?? payload?.number ?? cr?.pull_requests?.[0]?.number ?? null, - prTitle: pr?.title ?? null, - prBranch: pr?.head?.ref ?? cr?.head_branch ?? null, - prBaseBranch: pr?.base?.ref ?? null, - prAuthor: pr?.user?.login ?? null, - prUrl: pr?.html_url ?? null, - // Check run fields - checkName: cr?.name ?? null, - checkConclusion: cr?.conclusion ?? null, - checkStatus: cr?.status ?? null, - // Review fields - reviewState: payload?.review?.state ?? null, - // Push / ref fields - ref: payload?.ref ?? null, - commitSha: payload?.after ?? payload?.head_commit?.id ?? null, - // Full payload available for complex filter expressions - payload, - }); - }); - } - console.log("[workflows] GitHub webhook bridge active — forwarding " + _GITHUB_BRIDGE_EVENTS.length + " event type(s)"); - } catch (err) { - console.warn(`[workflows] GitHub webhook bridge setup failed: ${err?.message || err}`); - } -} - function normalizePromptBody(value) { return typeof value === "string" ? value.trim() : ""; } @@ -2213,10 +2107,6 @@ workflowAutomationEnabled = parseEnvBoolean( ? dedupMs : 15_000; } -// Wire real-time GitHub webhook events into the workflow trigger engine. -// queueWorkflowEvent is a no-op when automation is disabled, so this is safe -// to call unconditionally at module init time. -if (!process.env.VITEST) setupGitHubWebhookBridge(); // Initialize runtime accumulator for persistent stats across restarts const runtimeStats = initRuntimeAccumulator(); @@ -3254,10 +3144,6 @@ const SELF_RESTART_FORCE_ACTIVE_SLOT_MIN_AGE_MS = Math.max( String(SELF_RESTART_MAX_DEFER_MS), ) || SELF_RESTART_MAX_DEFER_MS, ); -const RUNTIME_RESTART_REQUEST_POLL_MS = Math.max( - 1_000, - Number(process.env.BOSUN_RESTART_REQUEST_POLL_MS || "2000") || 2000, -); let selfWatcher = null; let selfWatcherLib = null; let selfWatcherExtra = []; // watchers for sibling source dirs (task/, workspace/, etc.) @@ -3332,15 +3218,10 @@ function buildCodexSdkOptionsForMonitor() { } // ── Self-restart marker: detect if this process was spawned by a code-change restart -const runtimeRestartRequestPath = resolve( - config.cacheDir || resolve(config.repoRoot, ".cache"), - "bosun-restart-request.json", -); const selfRestartMarkerPath = resolve( config.cacheDir || resolve(config.repoRoot, ".cache"), "ve-self-restart.marker", ); -let lastHandledRuntimeRestartRequestId = ""; let isSelfRestart = false; try { if (existsSync(selfRestartMarkerPath)) { @@ -3380,13 +3261,9 @@ function getTelegramBotStartOptions() { const restartReason = isSelfRestart ? "self-restart" : monitorRestartReason; - const allowDaemonPortalAutoOpen = isTruthyFlag( - process.env.BOSUN_UI_AUTO_OPEN_ON_DAEMON, - ); return { restartReason, - suppressPortalAutoOpen: - restartReason.length > 0 || !allowDaemonPortalAutoOpen, + suppressPortalAutoOpen: restartReason.length > 0, }; } @@ -3590,83 +3467,6 @@ async function ensurePreflightReady(reason) { return true; } -function maybeHandleQueuedRuntimeRestartRequest(trigger = "interval") { - if (shuttingDown) return false; - if (!existsSync(runtimeRestartRequestPath)) return false; - - let payload = null; - try { - payload = JSON.parse(readFileSync(runtimeRestartRequestPath, "utf8")); - } catch (err) { - console.warn( - `[monitor] invalid runtime restart request at ${runtimeRestartRequestPath}: ${err?.message || err}`, - ); - try { - unlinkSync(runtimeRestartRequestPath); - } catch { - /* best effort */ - } - return false; - } - - const requestId = String( - payload?.id || - `${payload?.requestedAt || ""}:${payload?.requesterPid || ""}:${payload?.reason || ""}:${payload?.targetPid || ""}`, - ).trim(); - const requestType = String(payload?.type || "code-reload").trim().toLowerCase(); - const targetPid = Number(payload?.targetPid || 0); - - if (requestId && requestId === lastHandledRuntimeRestartRequestId) { - try { - unlinkSync(runtimeRestartRequestPath); - } catch { - /* best effort */ - } - return false; - } - - if (requestType !== "code-reload") { - console.warn( - `[monitor] ignoring runtime restart request with unsupported type "${requestType}"`, - ); - try { - unlinkSync(runtimeRestartRequestPath); - } catch { - /* best effort */ - } - return false; - } - - if (targetPid > 0 && targetPid !== process.pid) { - console.warn( - `[monitor] ignoring runtime restart request for pid ${targetPid} (current pid ${process.pid})`, - ); - try { - unlinkSync(runtimeRestartRequestPath); - } catch { - /* best effort */ - } - return false; - } - - try { - unlinkSync(runtimeRestartRequestPath); - } catch { - /* best effort */ - } - lastHandledRuntimeRestartRequestId = requestId || `restart-${Date.now()}`; - - const reason = String(payload?.reason || "external-restart-request").trim() || - "external-restart-request"; - const requesterPid = Number(payload?.requesterPid || 0); - const requesterLabel = requesterPid > 0 ? ` from pid ${requesterPid}` : ""; - console.warn( - `[monitor] queued runtime reload requested (${reason})${requesterLabel} via ${trigger}; preserving current launch provenance.`, - ); - restartSelf(`queued-runtime-restart:${reason}`); - return true; -} - function restartSelf(reason) { if (shuttingDown) return; const protection = getRuntimeRestartProtection(); @@ -3710,7 +3510,6 @@ function restartSelf(reason) { ), ); } - stopHeartbeatMonitor(); stopAutoUpdateLoop(); stopAgentAlertTailer(); stopAgentWorkAnalyzer(); @@ -4114,27 +3913,7 @@ function safeSetInterval(reason, fn, ms) { `[monitor] timer delay clamped for interval:${reason} (${normalized}ms -> ${clamped}ms)`, ); } - let inFlight = false; - return setInterval(() => { - if (inFlight) return; - inFlight = true; - runGuarded(`interval:${reason}`, () => { - let result; - try { - result = fn(); - } catch (err) { - inFlight = false; - throw err; - } - if (result && typeof result.then === "function") { - return Promise.resolve(result).finally(() => { - inFlight = false; - }); - } - inFlight = false; - return result; - }); - }, clamped); + return setInterval(() => runGuarded(`interval:${reason}`, fn), clamped); } function safeSetTimeout(reason, fn, ms) { @@ -6122,21 +5901,9 @@ async function checkMergedPRsAndUpdateTasks() { const taskStatus = String(task?.status || "").trim().toLowerCase(); const allowsMergedRecovery = taskStatus === "todo" || taskStatus === "inprogress"; - const reviewStatus = String(task?.reviewStatus || "").trim().toLowerCase(); - const nowMs = Date.now(); - const updatedAt = Date.parse(task?.updatedAt || task?.updated_at || ""); - const ageMs = Number.isFinite(updatedAt) ? nowMs - updatedAt : Infinity; - const reviewVerdictCurrent = hasCurrentReviewVerdict(task); - const shouldRedispatchRejectedReview = - taskStatus === "inreview" && - reviewStatus === "changes_requested" && - reviewVerdictCurrent && - ageMs > 2 * 60 * 1000 && - !hasActiveSession(taskId) && - !isReviewRedispatchCoolingDown(taskId, nowMs); const approved = - reviewStatus === "approved" || + String(task?.reviewStatus || "").trim().toLowerCase() === "approved" || isTaskReviewApprovedForFlow(taskId); // inreview tasks must always be checked — their PR may have merged even if // the review-approval flag was never set (e.g. FLOW_REQUIRE_REVIEW=false or @@ -6178,19 +5945,9 @@ async function checkMergedPRsAndUpdateTasks() { // bouncing them back to todo. Allow a grace period to avoid racing a // freshly created PR that is not discoverable yet. if (allowsInreviewMergeCheck) { - if (shouldRedispatchRejectedReview) { - console.warn( - `[monitor] review reconcile: inreview task ${taskId} still has current changes_requested findings — re-dispatching remediation`, - ); - redispatchInReviewTask(task, "review-reconcile-changes-requested", { - workflowEvent: "task.review_fix_requested", - }); - summary.redispatchedReviewFix = (summary.redispatchedReviewFix || 0) + 1; - } else if ( - ageMs > 2 * 60 * 1000 && - !reviewVerdictCurrent && - !isReviewRedispatchCoolingDown(taskId, nowMs) - ) { + const updatedAt = Date.parse(task?.updatedAt || task?.updated_at || ""); + const ageMs = Number.isFinite(updatedAt) ? Date.now() - updatedAt : Infinity; + if (ageMs > 2 * 60 * 1000) { console.warn( `[monitor] review reconcile: inreview task ${taskId} has no discoverable PR — re-dispatching inreview repair`, ); @@ -6209,20 +5966,7 @@ async function checkMergedPRsAndUpdateTasks() { const prState = String(prInfo?.state || "").trim().toUpperCase(); const mergedAt = String(prInfo?.mergedAt || prInfo?.merged_at || "").trim(); const isMerged = prState === "MERGED" || Boolean(mergedAt); - if (!isMerged) { - if (shouldRedispatchRejectedReview) { - console.warn( - `[monitor] review reconcile: inreview task ${taskId} still has current changes_requested findings — re-dispatching remediation`, - ); - redispatchInReviewTask(task, "review-reconcile-changes-requested", { - prNumber, - prUrl, - workflowEvent: "task.review_fix_requested", - }); - summary.redispatchedReviewFix = (summary.redispatchedReviewFix || 0) + 1; - } - continue; - } + if (!isMerged) continue; const recoverySuffix = allowsMergedRecovery ? ` (status=${taskStatus || "unknown"})` @@ -6423,26 +6167,30 @@ function parseGhJsonResult(raw, fallback = []) { } } -async function readEpicPrInfo(headBranch, baseBranch) { +function readEpicPrInfo(headBranch, baseBranch) { const slug = getRepoSlugForEpic(); if (!slug || !ghAvailable()) return null; const { headInfo, baseInfo } = summarizeEpicBranch(headBranch, baseBranch); try { const listCmd = `gh pr list --repo ${slug} --head "${headInfo.name}" --base "${baseInfo.name}" --state all --json number,state,url,mergedAt`; - const listResult = (await execAsync(listCmd, { + const listResult = execSync(listCmd, { cwd: repoRoot, + encoding: "utf8", timeout: 20_000, - })).trim(); + stdio: ["pipe", "pipe", "ignore"], + }).trim(); const entries = parseGhJsonResult(listResult, []); if (!entries.length) return null; const pr = entries[0]; let detail = {}; try { const viewCmd = `gh pr view ${pr.number} --repo ${slug} --json number,state,url,mergeable,mergeable_state,mergeStateStatus,baseRefName,headRefName`; - const viewResult = (await execAsync(viewCmd, { + const viewResult = execSync(viewCmd, { cwd: repoRoot, + encoding: "utf8", timeout: 20_000, - })).trim(); + stdio: ["pipe", "pipe", "ignore"], + }).trim(); detail = parseGhJsonResult(viewResult, {}); } catch { /* best-effort */ @@ -6484,10 +6232,12 @@ async function readRequiredChecks(prNumber) { if (!slug || !ghAvailable() || !prNumber) return []; try { const checksCmd = `gh pr checks ${prNumber} --repo ${slug} --json name,state --required`; - const checksResult = (await execAsync(checksCmd, { + const checksResult = execSync(checksCmd, { cwd: repoRoot, + encoding: "utf8", timeout: 20_000, - })).trim(); + stdio: ["pipe", "pipe", "ignore"], + }).trim(); return parseGhJsonResult(checksResult, []); } catch { return []; @@ -6879,7 +6629,7 @@ async function checkEpicBranches(reason = "interval") { continue; } - let prInfo = await readEpicPrInfo(epicBranch, DEFAULT_TARGET_BRANCH); + let prInfo = readEpicPrInfo(epicBranch, DEFAULT_TARGET_BRANCH); if (!prInfo || prInfo.state === "CLOSED") { const created = await createEpicMergePr( epicBranch, @@ -7194,15 +6944,6 @@ function getReviewGateSnapshot(taskId) { } } -function hasCurrentReviewVerdict(task) { - const reviewStatus = String(task?.reviewStatus || "").trim().toLowerCase(); - if (!["approved", "changes_requested"].includes(reviewStatus)) { - return false; - } - const reviewedAtMs = Date.parse(String(task?.reviewedAt || "")); - return Number.isFinite(reviewedAtMs); -} - function isTaskReviewApprovedForFlow(taskId) { const snapshot = getReviewGateSnapshot(taskId); return snapshot?.approved === true; @@ -7268,17 +7009,6 @@ async function queueFlowReview(taskId, ctx, reason = "") { function redispatchInReviewTask(task, reason, extra = {}) { const taskId = String(task?.id || "").trim(); if (!taskId) return false; - const normalizedReason = String(reason || "inreview_redispatch").trim() || "inreview_redispatch"; - const eventType = String(extra.workflowEvent || "task.assigned").trim() || "task.assigned"; - const now = Date.now(); - const existing = reviewRedispatchCooldownByTask.get(taskId); - if (existing && now - existing.at < REVIEW_REDISPATCH_COOLDOWN_MS) { - return false; - } - reviewRedispatchCooldownByTask.set(taskId, { - at: now, - reason: normalizedReason, - }); const taskTitle = String(task?.title || taskId).trim() || taskId; const branch = String(task?.branchName || task?.branch || extra.branch || "").trim() || null; const worktreePath = String(task?.worktreePath || task?.meta?.worktreePath || extra.worktreePath || "").trim() || null; @@ -7288,11 +7018,8 @@ function redispatchInReviewTask(task, reason, extra = {}) { parsePositivePrNumber(task?.pr_number) || null; const prUrl = String(extra.prUrl || task?.prUrl || task?.pr_url || "").trim() || null; - const reviewIssues = Array.isArray(extra.reviewIssues) - ? extra.reviewIssues - : (Array.isArray(task?.reviewIssues) ? task.reviewIssues : []); queueWorkflowEvent( - eventType, + "task.assigned", { taskId, taskTitle, @@ -7301,28 +7028,14 @@ function redispatchInReviewTask(task, reason, extra = {}) { worktreePath, prNumber, prUrl, - reviewStatus: String(task?.reviewStatus || "").trim() || null, - reviewIssues, - reviewIssueCount: reviewIssues.length, - reviewRedispatchReason: normalizedReason, + reviewRedispatchReason: String(reason || "inreview_redispatch").trim() || "inreview_redispatch", ...extra, }, - { dedupKey: `workflow-event:${eventType}:${taskId}:inreview:${normalizedReason}` }, + { dedupKey: `workflow-event:task.assigned:${taskId}:inreview:${String(reason || "inreview_redispatch").trim() || "inreview_redispatch"}` }, ); return true; } -function isReviewRedispatchCoolingDown(taskId, now = Date.now()) { - const normalizedTaskId = String(taskId || "").trim(); - if (!normalizedTaskId) return false; - const existing = reviewRedispatchCooldownByTask.get(normalizedTaskId); - return Boolean( - existing && - Number.isFinite(existing.at) && - now - existing.at < REVIEW_REDISPATCH_COOLDOWN_MS - ); -} - function parsePositivePrNumber(value) { const parsed = Number(String(value || "").trim()); return Number.isFinite(parsed) && parsed > 0 ? parsed : null; @@ -10750,7 +10463,7 @@ async function loadCodexSdk() { async function tryImportCodex() { try { - const mod = await import("@openai/" + "codex-sdk"); + const mod = await import("@openai/codex-sdk"); return mod.Codex; } catch (err) { return null; @@ -10774,8 +10487,7 @@ function installDependencies() { return res.status === 0; } - const npmCommand = process.platform === "win32" ? "npm.cmd" : "npm"; - const npm = spawnSync(npmCommand, ["install"], { cwd, stdio: "inherit" }); + const npm = spawnSync("npm", ["install"], { cwd, stdio: "inherit" }); return npm.status === 0; } @@ -12389,42 +12101,6 @@ function stopMonitorMonitorSupervisor({ preserveRunning = false } = {}) { } } -function isHeartbeatMonitorEnabled() { - if (isMonitorTestRuntime) return false; - const raw = String(process.env.BOSUN_HEARTBEAT_MONITOR_ENABLED || "true") - .trim() - .toLowerCase(); - return !["0", "false", "no", "off"].includes(raw); -} - -function restartHeartbeatMonitor() { - heartbeatRuntimeState.current?.stop?.(); - heartbeatRuntimeState.current = null; - - if (!isHeartbeatMonitorEnabled()) return; - const configDir = String(config?.configDir || "").trim(); - if (!configDir) return; - - heartbeatRuntimeState.current = createHeartbeatMonitor({ - configDir, - logDir, - intervalMs: Number(process.env.BOSUN_HEARTBEAT_INTERVAL_MS || 30_000), - timeoutMs: Number(process.env.BOSUN_HEARTBEAT_TIMEOUT_MS || 5_000), - successLogIntervalMs: Number( - process.env.BOSUN_HEARTBEAT_SUCCESS_LOG_INTERVAL_MS || 10 * 60_000, - ), - eventLoopWarnMs: Number(process.env.BOSUN_HEARTBEAT_LAG_WARN_MS || 1000), - logger: console, - }); - heartbeatRuntimeState.current.start(); - console.log("[monitor] heartbeat monitor started"); -} - -function stopHeartbeatMonitor() { - heartbeatRuntimeState.current?.stop?.(); - heartbeatRuntimeState.current = null; -} - /** * Called when a Live Digest window is sealed. * This provides fresh high-priority context and triggers an immediate run. @@ -12634,7 +12310,6 @@ async function startProcess() { const child = spawn(orchestratorCmd, orchestratorArgs, { stdio: ["ignore", "pipe", "pipe"], - windowsHide: true, }); currentChild = child; @@ -13593,7 +13268,6 @@ function applyConfig(nextConfig, options = {}) { } else { stopMonitorMonitorSupervisor(); } - restartHeartbeatMonitor(); restartGitHubReconciler(); const nextArgs = scriptArgs?.join(" ") || ""; @@ -13631,7 +13305,6 @@ const stopTuiConfigReloadListener = onConfigReload((payload = {}) => { process.on("SIGINT", async () => { shuttingDown = true; stopWorkspaceSyncTimers(); - stopHeartbeatMonitor(); stopAutoUpdateLoop(); stopAgentAlertTailer(); stopAgentWorkAnalyzer(); @@ -13680,7 +13353,6 @@ process.on("exit", () => { try { stopTuiConfigReloadListener?.(); } catch { /* best effort */ } shuttingDown = true; stopWorkspaceSyncTimers(); - stopHeartbeatMonitor(); stopAgentAlertTailer(); stopAgentWorkAnalyzer(); runDetachedDuringShutdown("workspace-monitor-shutdown:exit", () => @@ -13694,7 +13366,6 @@ process.on("exit", () => { process.on("SIGTERM", async () => { shuttingDown = true; stopWorkspaceSyncTimers(); - stopHeartbeatMonitor(); stopAutoUpdateLoop(); stopAgentAlertTailer(); stopAgentWorkAnalyzer(); @@ -13839,22 +13510,6 @@ process.on("exit", (code) => { appendMonitorCrashBreadcrumb(line); }); -const workflowStartupRecoveryGraceMs = Math.max( - 0, - Number(configWorkflowRecovery?.startupGraceMs || 0), -); -const workflowStartupRecoveryStepDelayMs = Math.max( - 0, - Number(configWorkflowRecovery?.startupStepDelayMs || 0), -); - -function scheduleStartupWorkflowRecovery(name, handler, step = 0) { - const delayMs = - workflowStartupRecoveryGraceMs + - Math.max(0, step) * workflowStartupRecoveryStepDelayMs; - safeSetTimeout(name, handler, delayMs); -} - if (!isMonitorTestRuntime) { const DUPLICATE_START_EXIT_STATE_FILE = "monitor-duplicate-start-exit-state.json"; @@ -13996,10 +13651,6 @@ console.log("[monitor] legacy maintenance sweep removed — use workflow schedul safeSetInterval("flush-error-queue", () => flushErrorQueue(), 60 * 1000); -safeSetInterval("queued-runtime-restart-request", () => { - maybeHandleQueuedRuntimeRestartRequest("interval"); -}, RUNTIME_RESTART_REQUEST_POLL_MS); - // Legacy periodic maintenance sweep removed (workflow-only control). // ── Workflow schedule trigger polling ─────────────────────────────────────── @@ -14021,7 +13672,6 @@ pollWorkflowSchedulesOnce = async function pollWorkflowSchedulesOnce( return; } const includeTaskPoll = opts?.includeTaskPoll !== false; - const includeScheduled = opts?.includeScheduled !== false; const triggered = engine.evaluateScheduleTriggers({ configDir: repoRoot }); if (!Array.isArray(triggered) || triggered.length === 0) return; @@ -14029,18 +13679,14 @@ pollWorkflowSchedulesOnce = async function pollWorkflowSchedulesOnce( for (const match of triggered) { const workflowId = String(match?.workflowId || "").trim(); if (!workflowId) continue; - const workflow = typeof engine.get === "function" ? engine.get(workflowId) : null; - const triggerNode = Array.isArray(workflow?.nodes) - ? workflow.nodes.find((node) => node?.id === match?.triggeredBy) - : null; - const isTaskPollTrigger = - triggerNode?.type === "trigger.task_available" || - triggerNode?.type === "trigger.task_low"; - if (!includeTaskPoll && isTaskPollTrigger) { - continue; - } - if (!includeScheduled && !isTaskPollTrigger) { - continue; + if (!includeTaskPoll) { + const workflow = typeof engine.get === "function" ? engine.get(workflowId) : null; + const triggerNode = Array.isArray(workflow?.nodes) + ? workflow.nodes.find((node) => node?.id === match?.triggeredBy) + : null; + if (triggerNode?.type === "trigger.task_available" || triggerNode?.type === "trigger.task_low") { + continue; + } } void engine .execute(workflowId, { @@ -14085,22 +13731,6 @@ safeSetInterval("workflow-schedule-check", async () => { await pollWorkflowSchedulesOnce(); }, scheduleCheckIntervalMs); -// ── Periodic workflow run file pruning: once per day ───────────────────── -// Deletes run detail files beyond MAX_PERSISTED_RUNS to keep the workflow-runs -// directory bounded and prevent O(n) dir-scan slowdown on history API calls. -safeSetInterval("workflow-run-file-prune", async () => { - try { - const engine = await ensureWorkflowAutomationEngine(); - if (typeof engine?.pruneOldRunFiles !== "function") return; - const result = engine.pruneOldRunFiles(); - if (result.deleted > 0) { - console.log(`[workflows] pruned ${result.deleted} old run file(s), kept ${result.kept}`); - } - } catch (err) { - console.warn(`[workflows] run-file prune error: ${err?.message || err}`); - } -}, 24 * 60 * 60 * 1000); - safeSetInterval("workflow-review-merge-reconcile", async () => { const result = await checkMergedPRsAndUpdateTasks(); if ((result?.movedDone || 0) > 0) { @@ -14129,16 +13759,16 @@ async function syncDivergedWorktrees() { try { // Fetch remote to update tracking refs - await execAsync("git fetch origin --no-tags", { - cwd: wtPath, timeout: 30_000, + execSync("git fetch origin --no-tags", { + cwd: wtPath, timeout: 30_000, stdio: ["ignore", "pipe", "pipe"], }); // Check ahead/behind vs remote tracking ref const remoteRef = `origin/${branch}`; let remoteExists = false; try { - await execAsync(`git rev-parse --verify ${remoteRef}`, { - cwd: wtPath, timeout: 5_000, + execSync(`git rev-parse --verify ${remoteRef}`, { + cwd: wtPath, timeout: 5_000, stdio: ["ignore", "pipe", "pipe"], }); remoteExists = true; } catch { /* branch not yet pushed — nothing to sync */ } @@ -14146,13 +13776,13 @@ async function syncDivergedWorktrees() { if (!remoteExists) continue; const ahead = parseInt( - (await execAsync(`git rev-list --count ${remoteRef}..HEAD`, { - cwd: wtPath, timeout: 10_000, - })).trim(), 10); + execSync(`git rev-list --count ${remoteRef}..HEAD`, { + cwd: wtPath, encoding: "utf8", timeout: 10_000, stdio: ["ignore", "pipe", "pipe"], + }).trim(), 10); const behind = parseInt( - (await execAsync(`git rev-list --count HEAD..${remoteRef}`, { - cwd: wtPath, timeout: 10_000, - })).trim(), 10); + execSync(`git rev-list --count HEAD..${remoteRef}`, { + cwd: wtPath, encoding: "utf8", timeout: 10_000, stdio: ["ignore", "pipe", "pipe"], + }).trim(), 10); // Only act on diverged worktrees (behind > 0 AND ahead > 0) if (ahead === 0 || behind === 0) continue; @@ -14164,12 +13794,12 @@ async function syncDivergedWorktrees() { // Rebase local onto remote tracking ref to incorporate remote commits let rebased = false; try { - await execAsync(`git rebase ${remoteRef}`, { - cwd: wtPath, timeout: 60_000, + execSync(`git rebase ${remoteRef}`, { + cwd: wtPath, encoding: "utf8", timeout: 60_000, stdio: ["ignore", "pipe", "pipe"], }); rebased = true; } catch (rebaseErr) { - try { await execAsync("git rebase --abort", { cwd: wtPath, timeout: 10_000 }); } catch { /* ok */ } + try { execSync("git rebase --abort", { cwd: wtPath, timeout: 10_000, stdio: ["ignore", "pipe", "pipe"] }); } catch { /* ok */ } console.warn( `[monitor:worktree-sync] ${branch} rebase conflict — skipping push: ${rebaseErr.message?.slice(0, 200)}`, ); @@ -14179,8 +13809,8 @@ async function syncDivergedWorktrees() { // Safety: refuse to push if HEAD now equals origin/main (would wipe PR changes) try { - const headSha = (await execAsync("git rev-parse HEAD", { cwd: wtPath, timeout: 5_000 })).trim(); - const mainSha = (await execAsync("git rev-parse origin/main", { cwd: wtPath, timeout: 5_000 })).trim(); + const headSha = execSync("git rev-parse HEAD", { cwd: wtPath, encoding: "utf8", timeout: 5_000, stdio: ["pipe", "pipe", "pipe"] }).trim(); + const mainSha = execSync("git rev-parse origin/main", { cwd: wtPath, encoding: "utf8", timeout: 5_000, stdio: ["pipe", "pipe", "pipe"] }).trim(); if (headSha === mainSha) { console.warn(`[monitor:worktree-sync] ${branch} HEAD matches origin/main after rebase — aborting push to prevent PR wipe`); failed++; @@ -14190,8 +13820,8 @@ async function syncDivergedWorktrees() { // Push with --force-with-lease (safe: we just fetched fresh remote refs) try { - await execAsync(`git push --force-with-lease --set-upstream origin HEAD`, { - cwd: wtPath, timeout: 30_000, + execSync(`git push --force-with-lease --set-upstream origin HEAD`, { + cwd: wtPath, encoding: "utf8", timeout: 30_000, stdio: ["ignore", "pipe", "pipe"], }); console.log(`[monitor:worktree-sync] ${branch} sync-pushed successfully`); synced++; @@ -14236,21 +13866,11 @@ if (logMaxSizeMb > 0) { } } -const STARTUP_EPIC_CHECK_DELAY_MS = parseEnvInteger( - process.env.BOSUN_STARTUP_EPIC_CHECK_DELAY_MS, - 2 * 60 * 1000, - { min: 30 * 1000, max: 30 * 60 * 1000 }, -); -const STARTUP_DEPENDABOT_CHECK_DELAY_MS = parseEnvInteger( - process.env.BOSUN_STARTUP_DEPENDABOT_CHECK_DELAY_MS, - STARTUP_EPIC_CHECK_DELAY_MS + 30 * 1000, - { min: STARTUP_EPIC_CHECK_DELAY_MS, max: 30 * 60 * 1000 }, -); - -// Stagger the heaviest git/gh maintenance away from initial startup so the UI -// server can answer readiness probes before long-running repo checks begin. -safeSetTimeout("startup-epic-check", () => checkEpicBranches("startup"), STARTUP_EPIC_CHECK_DELAY_MS); -safeSetTimeout("startup-dependabot-auto-merge", () => checkAndMergeDependabotPRs(), STARTUP_DEPENDABOT_CHECK_DELAY_MS); +// Run once immediately after startup (delayed by 30s to let things settle) +safeSetTimeout("startup-health-checks", () => { + checkEpicBranches("startup"); + return checkAndMergeDependabotPRs(); +}, 30 * 1000); // ── Fleet Coordination ─────────────────────────────────────────────────────── if (fleetConfig?.enabled) { @@ -14447,8 +14067,6 @@ let reviewAgent = null; /** @type {Map} */ const reviewGateResults = new Map(); const pendingMergeStrategyByTask = new Map(); -const reviewRedispatchCooldownByTask = new Map(); -const REVIEW_REDISPATCH_COOLDOWN_MS = 5 * 60 * 1000; /** @type {null} Sync engine lifecycle now managed by workflow template */ let syncEngine = null; /** @type {import("./error-detector.mjs").ErrorDetector|null} */ @@ -14459,43 +14077,33 @@ let agentSupervisor = null; if (!isMonitorTestRuntime) { if (workflowAutomationEnabled) { await ensureWorkflowAutomationEngine().catch(() => {}); - scheduleStartupWorkflowRecovery( - "startup-stale-dispatch-unstick", + runWorkflowRecoveryWithPolicy( + "stale-dispatch-unstick", () => - void runWorkflowRecoveryWithPolicy( - "stale-dispatch-unstick", - () => - pollWorkflowSchedulesOnce("startup", { - includeTaskPoll: false, - requireEngine: true, - throwOnError: true, - }), - { - trigger: "startup", - operationType: "stale-dispatch-unstick", - includeTaskPoll: false, - }, - ), - 0, + pollWorkflowSchedulesOnce("startup", { + includeTaskPoll: false, + requireEngine: true, + throwOnError: true, + }), + { + trigger: "startup", + operationType: "stale-dispatch-unstick", + includeTaskPoll: false, + }, ); - scheduleStartupWorkflowRecovery( - "startup-workflow-history-unstick", - () => - void runWorkflowRecoveryWithPolicy( - "workflow-history-unstick", - async () => { - const engine = await ensureWorkflowAutomationEngine(); - if (!engine?.resumeInterruptedRuns) { - throw new Error("workflow engine resumeInterruptedRuns unavailable"); - } - await engine.resumeInterruptedRuns(); - }, - { - trigger: "startup", - operationType: "workflow-history-unstick", - }, - ), - 1, + runWorkflowRecoveryWithPolicy( + "workflow-history-unstick", + async () => { + const engine = await ensureWorkflowAutomationEngine(); + if (!engine?.resumeInterruptedRuns) { + throw new Error("workflow engine resumeInterruptedRuns unavailable"); + } + await engine.resumeInterruptedRuns(); + }, + { + trigger: "startup", + operationType: "workflow-history-unstick", + }, ); } else { console.log( @@ -14752,24 +14360,18 @@ if (isExecutorDisabled()) { internalTaskExecutor = getTaskExecutor(execOpts); internalTaskExecutor.start(); if (workflowOwnsTaskExecutorLifecycle) { - scheduleStartupWorkflowRecovery( - "startup-stale-dispatch-task-poll-unstick", + runWorkflowRecoveryWithPolicy( + "stale-dispatch-task-poll-unstick", () => - void runWorkflowRecoveryWithPolicy( - "stale-dispatch-task-poll-unstick", - () => - pollWorkflowSchedulesOnce("startup", { - includeScheduled: false, - requireEngine: true, - throwOnError: true, - }), - { - trigger: "startup", - operationType: "stale-dispatch-task-poll-unstick", - includeTaskPoll: true, - }, - ), - 2, + pollWorkflowSchedulesOnce("startup", { + requireEngine: true, + throwOnError: true, + }), + { + trigger: "startup", + operationType: "stale-dispatch-task-poll-unstick", + includeTaskPoll: true, + }, ); } @@ -14910,24 +14512,13 @@ if (isExecutorDisabled()) { errorDetector: errorDetector || undefined, sendTelegram: telegramToken && telegramChatId - ? (msg, options) => void sendTelegramMessage(msg, options) + ? (msg) => void sendTelegramMessage(msg) : null, getTask: (taskId) => getInternalTask(taskId), setTaskStatus: (taskId, status, source) => setInternalTaskStatus(taskId, status, source), updateTask: (taskId, updates) => updateInternalTask(taskId, updates), - retryReviewThreshold: Number(internalExecutorConfig?.retryReviewThreshold || 0), - retryDelayMs: Number(internalExecutorConfig?.retryDelayMs || 15_000), - onRetryThresholdExceeded: ({ taskId }) => { - const normalizedTaskId = String(taskId || "").trim(); - if (!normalizedTaskId) return; - const task = getInternalTask(normalizedTaskId); - if (!task) return; - redispatchInReviewTask(task, "retry-threshold-review-fix", { - workflowEvent: "task.review_fix_requested", - }); - }, // broadcastUiEvent is wired later when UI server starts via // injectUiDependencies → setBroadcastFn pattern }); @@ -14948,7 +14539,7 @@ if (isExecutorDisabled()) { eventBus: agentEventBus || undefined, sendTelegram: telegramToken && telegramChatId - ? (msg, options) => void sendTelegramMessage(msg, options) + ? (msg) => void sendTelegramMessage(msg) : null, getTask: (taskId) => getInternalTask(taskId), setTaskStatus: (taskId, status, source) => @@ -14979,12 +14570,7 @@ if (isExecutorDisabled()) { }, dispatchFixTask: (taskId, issues) => { const normalizedTaskId = String(taskId || "").trim(); - if (!normalizedTaskId) { - return { - dispatched: false, - reason: "missing_task_id", - }; - } + if (!normalizedTaskId) return; const task = getInternalTask(normalizedTaskId); const issueList = Array.isArray(issues) ? issues : []; const issueCount = issueList.length; @@ -14994,14 +14580,7 @@ if (isExecutorDisabled()) { console.warn( `[monitor] supervisor dispatch-fix skipped for ${normalizedTaskId}: status=${status}`, ); - return { - dispatched: false, - reason: "status_not_inreview", - status, - issueCount, - taskId: normalizedTaskId, - taskTitle: task?.title || normalizedTaskId, - }; + return; } if (hasActiveSession(normalizedTaskId)) { @@ -15029,13 +14608,7 @@ if (isExecutorDisabled()) { `[monitor] supervisor dispatch-fix steering active session for ${normalizedTaskId}`, ); steerActiveThread(normalizedTaskId, prompt); - return { - dispatched: true, - mode: "active_session", - issueCount, - taskId: normalizedTaskId, - taskTitle: task?.title || normalizedTaskId, - }; + return; } console.warn( @@ -15043,16 +14616,8 @@ if (isExecutorDisabled()) { ); redispatchInReviewTask(task || { id: normalizedTaskId, title: normalizedTaskId }, "review-fix-redispatch", { reviewIssueCount: issueCount, - reviewIssues: issueList, workflowEvent: "task.review_fix_requested", }); - return { - dispatched: true, - mode: "redispatch", - issueCount, - taskId: normalizedTaskId, - taskTitle: task?.title || normalizedTaskId, - }; }, }); agentSupervisor.start(); @@ -15082,7 +14647,7 @@ if (isExecutorDisabled()) { ), sendTelegram: telegramToken && telegramChatId - ? (msg, options) => void sendTelegramMessage(msg, options) + ? (msg) => void sendTelegramMessage(msg) : null, promptTemplate: agentPrompts?.reviewer, onReviewComplete: (taskId, result) => { @@ -15167,26 +14732,9 @@ if (isExecutorDisabled()) { if (Array.isArray(pending) && pending.length > 0) { let requeued = 0; let redispatchedMissingRefs = 0; - let skippedReviewed = 0; for (const task of pending) { const taskId = String(task?.id || "").trim(); if (!taskId) continue; - const reviewStatus = String(task?.reviewStatus || "").trim().toLowerCase(); - if (hasCurrentReviewVerdict(task)) { - if ( - reviewStatus === "changes_requested" && - !hasActiveSession(taskId) && - !isReviewRedispatchCoolingDown(taskId) - ) { - redispatchInReviewTask(task, "review-agent-rehydrate-review-fix", { - workflowEvent: "task.review_fix_requested", - }); - redispatchedMissingRefs += 1; - continue; - } - skippedReviewed += 1; - continue; - } const branchName = String(task?.branchName || "").trim(); let prUrl = String(task?.prUrl || "").trim(); let prNumber = String(task?.prNumber || "").trim(); @@ -15259,11 +14807,6 @@ if (isExecutorDisabled()) { `[monitor] review agent redispatched ${redispatchedMissingRefs} inreview task(s) with missing review references`, ); } - if (skippedReviewed > 0) { - console.log( - `[monitor] review agent skipped ${skippedReviewed} already-reviewed inreview task(s) during rehydrate`, - ); - } } } catch (err) { console.warn( @@ -15506,7 +15049,8 @@ export { // Container runner re-exports getContainerStatus, isContainerEnabled, - dispatchWorkflowEvent, // Workflow event bridge — for fleet/kanban modules to emit events queueWorkflowEvent, }; + + diff --git a/infra/preflight.mjs b/infra/preflight.mjs index 8551a5c31..498fd90fd 100644 --- a/infra/preflight.mjs +++ b/infra/preflight.mjs @@ -3,10 +3,7 @@ import { existsSync } from "node:fs"; import { resolve } from "node:path"; import os from "node:os"; import { resolvePwshRuntime } from "../shell/pwsh-runtime.mjs"; -import { - ensureGitHooksPath, - inspectWorktreeRuntimeSetup, -} from "../workspace/worktree-setup.mjs"; +import { inspectWorktreeRuntimeSetup } from "../workspace/worktree-setup.mjs"; const isWindows = process.platform === "win32"; const MIN_FREE_GB = Number(process.env.BOSUN_MIN_FREE_GB || "10"); @@ -95,35 +92,9 @@ function checkWorktreeClean(repoRoot) { function checkWorktreeRuntimeSetup(repoRoot) { if (!existsSync(resolve(repoRoot, ".githooks"))) { - return { - ok: true, - issues: [], - hooksPath: "", - missingFiles: [], - repairedHooksPath: false, - repairError: "", - }; + return { ok: true, issues: [], hooksPath: "", missingFiles: [] }; } - const initial = inspectWorktreeRuntimeSetup(repoRoot, repoRoot); - const needsHooksPathRepair = initial.issues.some((issue) => - /core\.hooksPath/i.test(String(issue || "")), - ); - - if (!needsHooksPathRepair) { - return { - ...initial, - repairedHooksPath: false, - repairError: "", - }; - } - - const repair = ensureGitHooksPath(repoRoot); - const final = inspectWorktreeRuntimeSetup(repoRoot, repoRoot); - return { - ...final, - repairedHooksPath: repair.changed === true, - repairError: repair.error || "", - }; + return inspectWorktreeRuntimeSetup(repoRoot, repoRoot); } /** @@ -219,42 +190,6 @@ function checkToolVersion(label, command, args, hint) { return { label, ok: true, version }; } -function checkHookShell(repoRoot) { - if (!isWindows || !existsSync(resolve(repoRoot, ".githooks"))) { - return { ok: true, issue: null, resolvedPath: null, allPaths: [] }; - } - - const res = runCommand("where", ["bash"]); - if (res.error || res.status !== 0) { - return { - ok: false, - issue: "missing_bash", - resolvedPath: null, - allPaths: [], - message: "bash is not on PATH; Git hook execution may fail on Windows.", - }; - } - - const allPaths = readOutput(res) - .split(/\r?\n/) - .map((entry) => entry.trim()) - .filter(Boolean); - const resolvedPath = allPaths[0] || null; - const normalizedPath = String(resolvedPath || "").replace(/\\/g, "/").toLowerCase(); - if (normalizedPath.includes("/windows/system32/bash.exe")) { - return { - ok: false, - issue: "wsl_bash_first", - resolvedPath, - allPaths, - message: - "PATH resolves bash to WSL first. Git hooks in Windows worktrees should use Git for Windows bash (for example C:/Program Files/Git/bin/bash.exe).", - }; - } - - return { ok: true, issue: null, resolvedPath, allPaths }; -} - function parseEnvBool(value, fallback = false) { if (value === undefined || value === null || value === "") return fallback; const raw = String(value).trim().toLowerCase(); @@ -279,8 +214,6 @@ function checkToolchain() { "git", "gh", "node", - "npm", - "rg", shellMode ? "shell" : "pwsh", ]); const pwshRuntime = resolvePwshRuntime({ preferBundled: true }); @@ -304,24 +237,12 @@ function checkToolchain() { ["--version"], "Install Node.js 18+ and ensure it is on PATH.", ), - checkToolVersion( - "npm", - "npm", - ["--version"], - "Install npm and ensure it is on PATH. On Windows, verify npm commands can be spawned from PowerShell.", - ), checkToolVersion( "pnpm", "pnpm", ["--version"], "Install pnpm (npm install -g pnpm) and ensure it is on PATH.", ), - checkToolVersion( - "rg", - "rg", - ["--version"], - "Install ripgrep (rg) and ensure it is on PATH.", - ), checkToolVersion( "go", "go", @@ -427,34 +348,17 @@ export function runPreflightChecks(options = {}) { } const runtimeSetup = checkWorktreeRuntimeSetup(repoRoot); - if (runtimeSetup.repairedHooksPath) { - warnings.push({ - title: "Git hooks path auto-repaired", - message: 'Reset git core.hooksPath to ".githooks" during preflight.', - }); - } if (!runtimeSetup.ok) { errors.push({ title: "Worktree runtime setup is incomplete", message: runtimeSetup.issues.join(os.EOL) + - (runtimeSetup.repairError - ? `${os.EOL}Repair attempt failed: ${runtimeSetup.repairError}` - : "") + (runtimeSetup.missingFiles.length > 0 ? `${os.EOL}Run Bosun setup or bootstrap the repo so worktrees include the required hook/config files.` : ""), }); } - const hookShell = checkHookShell(repoRoot); - if (!hookShell.ok) { - warnings.push({ - title: "Windows hook shell may be misconfigured", - message: hookShell.message, - }); - } - if (toolchain.ok) { ghAuth = checkGhAuth(); if (!ghAuth.ok) { @@ -482,10 +386,8 @@ export function runPreflightChecks(options = {}) { toolchain, gitConfig, worktree, - hookShell, ghAuth, disk, - runtimeSetup, minFreeBytes: MIN_FREE_BYTES, }, }; @@ -532,11 +434,6 @@ export function formatPreflightReport(result, options = {}) { ); } - const hookShell = result.details?.hookShell; - if (hookShell?.resolvedPath) { - lines.push(`Hook shell: ${hookShell.resolvedPath}`); - } - if (result.errors.length) { lines.push("Errors:"); for (const err of result.errors) { diff --git a/infra/runtime-accumulator.mjs b/infra/runtime-accumulator.mjs index b6d330631..051b063e2 100644 --- a/infra/runtime-accumulator.mjs +++ b/infra/runtime-accumulator.mjs @@ -123,10 +123,6 @@ function normalizeCompletedSession(session = {}) { const sessionKey = String( session.sessionKey || `${taskId || "task"}:${stableId}:${startedAt}:${endedAt}`, ).trim(); - const turnCount = Math.max(0, toFiniteNumber(session.turnCount, 0)); - const turns = Array.isArray(session.turns) - ? session.turns.map((turn) => ({ ...turn })) - : []; return { type: "completed_session", @@ -143,8 +139,6 @@ function normalizeCompletedSession(session = {}) { tokenCount, inputTokens, outputTokens, - turnCount, - turns, costUsd, recordedAt: String(session.recordedAt || new Date().toISOString()), }; @@ -363,7 +357,6 @@ export function getRuntimeStats() { runtimeMs: _state.runtimeMs, totalCostUsd: _state.totalCostUsd, sessionCount: _state.completedSessions.length, - completedSessions: _state.completedSessions.map((entry) => ({ ...entry })), startedAt: _state.startedAt, lastUpdated: _state.lastUpdated, }; @@ -504,11 +497,7 @@ export function getSessionAccumulatorLogPath() { } export function _resetRuntimeAccumulatorForTests(options = {}) { - // When no explicit cacheDir is given, prefer the test-sandbox dir set by - // bootstrapTestRuntime() so that bare reset calls (e.g. in finally blocks) - // never redirect writes back to the real workspace .cache folder. - const fallback = process.env.BOSUN_TEST_CACHE_DIR || DEFAULT_CACHE_DIR; - configureCachePaths(options.cacheDir || fallback); + configureCachePaths(options.cacheDir || DEFAULT_CACHE_DIR); _state = cloneDefaultState(); _initialized = false; _lastSaveTime = 0; diff --git a/infra/session-tracker.mjs b/infra/session-tracker.mjs index 82baf4a16..3be44362c 100644 --- a/infra/session-tracker.mjs +++ b/infra/session-tracker.mjs @@ -11,7 +11,7 @@ * @module session-tracker */ -import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync, unlinkSync } from "node:fs"; +import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, unlinkSync } from "node:fs"; import { resolve, dirname, sep } from "node:path"; import { randomBytes } from "node:crypto"; import { fileURLToPath } from "node:url"; @@ -52,71 +52,7 @@ const MAX_MESSAGE_CHARS = 100_000; /** Maximum total sessions to keep in memory. */ const MAX_SESSIONS = 100; -const TERMINAL_SESSION_STATUSES = new Set([ - "completed", - "failed", - "idle", - "archived", - "stalled", - "blocked_by_repo", - "blocked_by_env", - "no_output", - "implementation_done_commit_blocked", -]); - -const SESSION_PLACEHOLDER_OUTPUTS = new Set([ - "continued", - "model response continued", - "turn completed", - "session completed", - "agent is composing a response...", - "agent is composing a response…", -]); - -const REPO_BLOCK_PATTERNS = [ - /merge conflict/i, - /unmerged files/i, - /protected branch/i, - /non-fast-forward/i, - /failed to push/i, - /push rejected/i, - /cannot rebase/i, - /pre-push hook/i, - /hook declined/i, - /working tree has changes/i, - /index contains uncommitted changes/i, -]; - -const ENV_BLOCK_PATTERNS = [ - /prompt quality/i, - /missing task (description|url)/i, - /missing tool/i, - /not recognized as an internal or external command/i, - /command not found/i, - /spawn .*enoent/i, - /enoent/i, - /permission denied/i, - /access is denied/i, - /authentication failed/i, - /not authenticated/i, - /missing credentials/i, - /token/i, - /connection refused/i, - /connection reset/i, - /network/i, - /timeout/i, - /sdk unavailable/i, - /failed to list models/i, -]; - -const COMMIT_BLOCK_PATTERNS = [ - /commit blocked/i, - /implementation_done_commit_blocked/i, - /git commit/i, - /git push/i, - /pre-push hook/i, - /hook/i, -]; +const TERMINAL_SESSION_STATUSES = new Set(["completed", "failed", "idle", "archived"]); function isTerminalSessionStatus(status) { return TERMINAL_SESSION_STATUSES.has(String(status || "").trim().toLowerCase()); @@ -136,85 +72,8 @@ function resolveSessionTrackerPersistDir(options = {}) { export const _test = Object.freeze({ resolveSessionTrackerSourceRepoRoot, resolveSessionTrackerPersistDir, - deriveTerminalSessionStatus, }); -function normalizeSessionStatus(status, fallback = "completed") { - const normalized = String(status || "").trim().toLowerCase(); - return normalized || fallback; -} - -function getSessionMessageText(message) { - return String(message?.content || message?.summary || "").trim(); -} - -function hasMeaningfulSessionOutput(session) { - const messages = Array.isArray(session?.messages) ? session.messages : []; - return messages.some((message) => { - const text = getSessionMessageText(message); - if (!text) return false; - const normalized = text.replace(/\s+/g, " ").trim().toLowerCase(); - if (!normalized || SESSION_PLACEHOLDER_OUTPUTS.has(normalized)) return false; - const messageType = String(message?.type || "").trim().toLowerCase(); - const messageRole = String(message?.role || "").trim().toLowerCase(); - if (messageType === "agent_message" || messageType === "assistant" || messageRole === "assistant") { - return true; - } - if (message?.type === "tool_call" || message?.type === "tool_result") return true; - if (message?.type === "error") return true; - return /edit|write|create|patch|commit|push|search|diff|test/i.test(text); - }); -} - -function classifyBlockedSessionText(text) { - const normalized = String(text || "").replace(/\s+/g, " ").trim(); - if (!normalized) return null; - if (COMMIT_BLOCK_PATTERNS.some((pattern) => pattern.test(normalized))) { - return "implementation_done_commit_blocked"; - } - if (REPO_BLOCK_PATTERNS.some((pattern) => pattern.test(normalized))) { - return "blocked_by_repo"; - } - if (ENV_BLOCK_PATTERNS.some((pattern) => pattern.test(normalized))) { - return "blocked_by_env"; - } - return null; -} - -function deriveIdleTerminalSessionStatus(session) { - return hasMeaningfulSessionOutput(session) ? "stalled" : "no_output"; -} - -function deriveTerminalSessionStatus(session, requestedStatus = "completed") { - const normalizedRequested = normalizeSessionStatus(requestedStatus); - if ( - normalizedRequested !== "completed" && - normalizedRequested !== "idle" && - normalizedRequested !== "active" - ) { - return normalizedRequested; - } - - if (normalizedRequested === "idle" || normalizedRequested === "active") { - return deriveIdleTerminalSessionStatus(session); - } - - const messages = Array.isArray(session?.messages) ? session.messages : []; - if (!messages.length || !hasMeaningfulSessionOutput(session)) { - return "no_output"; - } - - const recentText = messages - .slice(-8) - .map((message) => getSessionMessageText(message)) - .filter(Boolean) - .join("\n"); - const blockedStatus = classifyBlockedSessionText(recentText); - if (blockedStatus) return blockedStatus; - - return "completed"; -} - function resolveSessionMaxMessages(type, metadata, explicitMax, fallbackMax) { if (Number.isFinite(explicitMax)) { return explicitMax > 0 ? explicitMax : 0; @@ -229,52 +88,6 @@ function resolveSessionMaxMessages(type, metadata, explicitMax, fallbackMax) { return fallbackMax; } -function buildSessionRecordFromPersistedData(data, idleThresholdMs) { - if (!data || typeof data !== "object") return null; - const id = String(data.id || data.taskId || "").trim(); - if (!id) return null; - - const createdAt = String(data.createdAt || "").trim() || new Date().toISOString(); - const lastActiveAt = String(data.lastActiveAt || data.updatedAt || "").trim() || createdAt; - const lastActiveMs = Date.parse(lastActiveAt) || Date.parse(createdAt) || Date.now(); - - let status = normalizeSessionStatus(data.status || "completed"); - let endedAt = data.endedAt || null; - if (status === "active" && lastActiveMs > 0) { - const ageMs = Date.now() - lastActiveMs; - if (ageMs > idleThresholdMs) { - status = deriveIdleTerminalSessionStatus(data); - endedAt = endedAt || lastActiveMs; - } - } - - const messages = Array.isArray(data.messages) ? data.messages : []; - return { - id, - taskId: data.taskId || id, - taskTitle: data.taskTitle || data.title || data.metadata?.title || id, - sessionKey: - String(data.sessionKey || "").trim() || - `${data.taskId || id}:${data.startedAt || lastActiveMs}:${endedAt || data.startedAt || lastActiveMs}`, - type: data.type || "task", - status, - createdAt, - lastActiveAt, - startedAt: data.startedAt || (createdAt ? new Date(createdAt).getTime() : lastActiveMs), - endedAt, - messages, - totalEvents: messages.length, - turnCount: data.turnCount || 0, - turns: Array.isArray(data.turns) ? data.turns : [], - accumulatedAt: data.accumulatedAt || null, - lastActivityAt: lastActiveMs, - metadata: data.metadata || {}, - insights: data.insights || buildSessionInsights({ messages }), - trajectory: data.trajectory || { version: 1, replayable: true, steps: [] }, - summary: data.summary || null, - }; -} - // ── Message Types ─────────────────────────────────────────────────────────── /** @@ -293,125 +106,12 @@ function buildSessionRecordFromPersistedData(data, idleThresholdMs) { * @property {number|null} endedAt * @property {SessionMessage[]} messages * @property {number} totalEvents - Total events received (before truncation) - * @property {Array} [turns] - Per-turn rollup timeline * @property {string} status - "active"|"completed"|"idle"|"failed" * @property {number} lastActivityAt - Timestamp of last event */ -function parseTimestampMs(value, fallback = Date.now()) { - const parsed = Date.parse(String(value || "")); - return Number.isFinite(parsed) ? parsed : fallback; -} - -function normalizeTokenNumber(value) { - const num = Number(value); - return Number.isFinite(num) && num >= 0 ? Math.round(num) : 0; -} - -function extractUsageFromMeta(meta) { - if (!meta || typeof meta !== "object") return null; - const usage = meta.usage && typeof meta.usage === "object" ? meta.usage : meta; - const inputTokens = normalizeTokenNumber( - usage.inputTokens ?? usage.prompt_tokens ?? usage.promptTokens ?? usage.input_tokens, - ); - const outputTokens = normalizeTokenNumber( - usage.outputTokens ?? usage.completion_tokens ?? usage.completionTokens ?? usage.output_tokens, - ); - const totalTokens = normalizeTokenNumber( - usage.totalTokens ?? usage.total_tokens ?? (inputTokens + outputTokens), - ); - if (inputTokens <= 0 && outputTokens <= 0 && totalTokens <= 0) return null; - return { inputTokens, outputTokens, totalTokens }; -} - -function ensureSessionTurns(session) { - if (!Array.isArray(session.turns)) session.turns = []; - return session.turns; -} - -function getOrCreateTurnEntry(session, turnIndex, timestamp) { - const turns = ensureSessionTurns(session); - const safeTurnIndex = Number.isFinite(Number(turnIndex)) ? Number(turnIndex) : Math.max(0, turns.length); - let entry = turns.find((turn) => turn?.turnIndex === safeTurnIndex); - if (!entry) { - entry = { - turnIndex: safeTurnIndex, - startedAt: timestamp, - endedAt: timestamp, - durationMs: 0, - inputTokens: 0, - outputTokens: 0, - totalTokens: 0, - userMessageId: null, - assistantMessageId: null, - status: "pending", - }; - turns.push(entry); - turns.sort((a, b) => Number(a?.turnIndex || 0) - Number(b?.turnIndex || 0)); - } - return entry; -} - -function updateTurnTimeline(session, msg) { - if (!session || !msg) return; - const timestampMs = parseTimestampMs(msg.timestamp, session.lastActivityAt || Date.now()); - const derivedTurnIndex = Number.isFinite(Number(msg.turnIndex)) - ? Number(msg.turnIndex) - : Math.max(0, Number(session.turnCount || 0) - (String(msg.role || "").toLowerCase() === "assistant" ? 1 : 0)); - const turnIndex = derivedTurnIndex; - const turn = getOrCreateTurnEntry(session, turnIndex, timestampMs); - turn.startedAt = Math.min(Number(turn.startedAt || timestampMs), timestampMs); - turn.endedAt = Math.max(Number(turn.endedAt || timestampMs), timestampMs); - - const role = String(msg.role || "").toLowerCase(); - if (role === "user") { - turn.userMessageId = msg.id || turn.userMessageId; - turn.startedAt = timestampMs; - if (turn.status === "pending") turn.status = "in_progress"; - } - if (role === "assistant") { - turn.assistantMessageId = msg.id || turn.assistantMessageId; - turn.endedAt = timestampMs; - turn.status = "completed"; - } - - const usage = extractUsageFromMeta(msg.meta); - if (usage) { - turn.inputTokens = Math.max(turn.inputTokens || 0, usage.inputTokens || 0); - turn.outputTokens = Math.max(turn.outputTokens || 0, usage.outputTokens || 0); - turn.totalTokens = Math.max(turn.totalTokens || 0, usage.totalTokens || 0); - if (!session.insights || typeof session.insights !== "object") { - session.insights = {}; - } - const priorUsage = extractUsageFromMeta(session.insights.tokenUsage) || { - inputTokens: 0, - outputTokens: 0, - totalTokens: 0, - }; - session.insights.tokenUsage = { - inputTokens: Math.max(priorUsage.inputTokens, usage.inputTokens || 0), - outputTokens: Math.max(priorUsage.outputTokens, usage.outputTokens || 0), - totalTokens: Math.max(priorUsage.totalTokens, usage.totalTokens || 0), - }; - } - turn.durationMs = Math.max(0, Number(turn.endedAt || timestampMs) - Number(turn.startedAt || timestampMs)); - const derivedInsights = buildSessionInsights({ - ...session, - insights: null, - messages: Array.isArray(session.messages) ? session.messages : [], - }); - session.insights = { - ...(session.insights && typeof session.insights === "object" ? session.insights : {}), - ...derivedInsights, - turnTimeline: derivedInsights.turnTimeline, - turns: derivedInsights.turns, - }; -} - /** Debounce interval for disk writes (ms). */ const FLUSH_INTERVAL_MS = 2000; -const DERIVED_STATE_REFRESH_MS = 250; -const PERSISTED_SESSION_LIST_CACHE_TTL_MS = 5000; const SESSION_EVENT_LISTENERS = new Set(); const SESSION_STATE_LISTENERS = new Set(); @@ -441,9 +141,6 @@ function emitSessionEvent(session, message) { status: session.status || "active", lastActiveAt: session.lastActiveAt || new Date().toISOString(), turnCount: session.turnCount || 0, - turns: Array.isArray(session.turns) - ? session.turns.map((turn) => ({ ...turn })) - : [], }, }; for (const listener of SESSION_EVENT_LISTENERS) { @@ -469,9 +166,6 @@ function emitSessionStateEvent(session, reason, extra = {}) { status: session.status || "active", lastActiveAt: session.lastActiveAt || new Date().toISOString(), turnCount: session.turnCount || 0, - turns: Array.isArray(session.turns) - ? session.turns.map((turn) => ({ ...turn })) - : [], title: session.taskTitle || session.title || null, }, event: { @@ -507,18 +201,12 @@ export class SessionTracker { /** @type {Set} session IDs with pending disk writes */ #dirty = new Set(); - /** @type {{ loadedAt: number, sessions: Array }} */ - #persistedSummaryCache = { loadedAt: 0, sessions: [] }; - /** @type {ReturnType|null} */ #flushTimer = null; /** @type {ReturnType|null} */ #reaperTimer = null; - /** @type {Map>} */ - #derivedRefreshTimers = new Map(); - /** * @param {Object} [options] * @param {number} [options.maxMessages=10] @@ -533,6 +221,7 @@ export class SessionTracker { if (this.#persistDir) { this.#ensureDir(); this.#loadFromDisk(); + this.#purgeExcessFiles(); this.#flushTimer = setInterval(() => this.#flushDirty(), FLUSH_INTERVAL_MS); if (this.#flushTimer.unref) this.#flushTimer.unref(); } @@ -570,7 +259,6 @@ export class SessionTracker { messages: [], totalEvents: 0, turnCount: 0, - turns: [], status: "active", accumulatedAt: null, lastActivityAt: Date.now(), @@ -630,12 +318,11 @@ export class SessionTracker { timestamp: new Date().toISOString(), }; session.messages.push(msg); - updateTurnTimeline(session, msg); if (Number.isFinite(maxMessages) && maxMessages > 0) { while (session.messages.length > maxMessages) session.messages.shift(); } this.#appendTrajectoryStep(session, event); - this.#scheduleDerivedStateRefresh(session); + this.#refreshDerivedState(session); this.#markDirty(taskId); emitSessionEvent(session, msg); return; @@ -644,8 +331,6 @@ export class SessionTracker { // Direct message format (role/content) if (event && event.role && event.content !== undefined) { markActivity(); - const role = String(event.role || "").toLowerCase(); - const isAssistantTurn = role === "assistant"; const msg = { id: event.id || `msg-${Date.now()}-${randomToken(6)}`, type: event.type || undefined, @@ -665,25 +350,19 @@ export class SessionTracker { : undefined, _cachedLogId: event._cachedLogId || undefined, }; - if (isAssistantTurn) { - session.turnCount += 1; - } + session.turnCount++; session.messages.push(msg); - updateTurnTimeline(session, msg); if (Number.isFinite(maxMessages) && maxMessages > 0) { while (session.messages.length > maxMessages) session.messages.shift(); } this.#appendTrajectoryStep(session, event); - this.#scheduleDerivedStateRefresh(session); + this.#refreshDerivedState(session); this.#markDirty(taskId); emitSessionEvent(session, msg); return; } const msg = this.#normalizeEvent(event); - if (msg && !Number.isFinite(Number(msg.turnIndex))) { - msg.turnIndex = session.turnCount || 0; - } if (!msg) { return; // Ignore low-signal events that should not mask idle/stalled sessions } @@ -691,40 +370,30 @@ export class SessionTracker { markActivity(); // Push to ring buffer (keep only last N) session.messages.push(msg); - updateTurnTimeline(session, msg); if (Number.isFinite(maxMessages) && maxMessages > 0) { while (session.messages.length > maxMessages) session.messages.shift(); } this.#appendTrajectoryStep(session, event); - this.#scheduleDerivedStateRefresh(session); + this.#refreshDerivedState(session); this.#markDirty(taskId); emitSessionEvent(session, msg); } - /** - * Backward-compatible alias for older callers/tests. - * @param {string} taskId - * @param {Object|string} event - */ - appendEvent(taskId, event) { - return this.recordEvent(taskId, event); - } - /** * Mark a session as completed. * @param {string} taskId - * @param {string} [status="completed"] + * @param {"completed"|"failed"|"idle"} [status="completed"] */ endSession(taskId, status = "completed") { const session = this.#sessions.get(taskId); if (!session) return; session.endedAt = Date.now(); - session.status = deriveTerminalSessionStatus(session, status); - this.#scheduleDerivedStateRefresh(session, { force: true }); + session.status = status; + this.#refreshDerivedState(session); this.#accumulateCompletedSession(session, taskId); this.#markDirty(taskId); - emitSessionStateEvent(session, "session-ended", { status: session.status }); + emitSessionStateEvent(session, "session-ended", { status }); } /** @@ -892,7 +561,6 @@ export class SessionTracker { this.#accumulateCompletedSession(session, taskId); this.#sessions.delete(taskId); this.#dirty.delete(taskId); - this.#invalidatePersistedSummaryCache(); // Remove persisted session file if it exists if (this.#persistDir) { try { @@ -951,7 +619,6 @@ export class SessionTracker { messages: [], totalEvents: 0, turnCount: 0, - turns: [], lastActivityAt: Date.now(), accumulatedAt: null, metadata, @@ -970,44 +637,20 @@ export class SessionTracker { /** * List all sessions (metadata only, no full messages). * Sorted by lastActiveAt descending. - * @param {{ includePersisted?: boolean }} [options] * @returns {Array} */ - listAllSessions(options = {}) { - const includePersisted = options.includePersisted !== false; - const byId = new Map(); - const addSummary = (s, options = {}) => { - if (!s) return; - const sessionId = s.id || s.taskId; - const includeRuntimeProgress = options.includeRuntimeProgress !== false; - const progress = includeRuntimeProgress && s.status === "active" - ? this.getProgressStatus(sessionId) + listAllSessions() { + const list = []; + for (const s of this.#sessions.values()) { + const progress = s.status === "active" + ? this.getProgressStatus(s.id || s.taskId) : null; const derivedStatus = progress?.status === "ended" ? "completed" : (progress?.status || s.status); const lastActiveAt = s.lastActiveAt || new Date(s.lastActivityAt).toISOString(); - const turns = Array.isArray(s.turns) - ? s.turns.map((turn) => ({ ...turn })) - : (Array.isArray(s.insights?.turnTimeline) - ? s.insights.turnTimeline.map((turn) => ({ ...turn })) - : []); - const turnTokenUsage = turns.reduce((acc, turn) => ({ - inputTokens: acc.inputTokens + (Number(turn?.inputTokens) || 0), - outputTokens: acc.outputTokens + (Number(turn?.outputTokens) || 0), - totalTokens: acc.totalTokens + (Number(turn?.totalTokens) || 0), - }), { inputTokens: 0, outputTokens: 0, totalTokens: 0 }); - const tokenUsage = s.insights?.tokenUsage - || (turnTokenUsage.totalTokens > 0 || turnTokenUsage.inputTokens > 0 || turnTokenUsage.outputTokens > 0 - ? turnTokenUsage - : null); - const effectiveTokenUsage = extractUsageFromMeta(tokenUsage) || { - inputTokens: 0, - outputTokens: 0, - totalTokens: 0, - }; - byId.set(sessionId, { - id: sessionId, + list.push({ + id: s.id || s.taskId, taskId: s.taskId, title: s.taskTitle || s.title || null, type: s.type || "task", @@ -1020,11 +663,6 @@ export class SessionTracker { workspaceDir: String(s?.metadata?.workspaceDir || "").trim() || null, branch: String(s?.metadata?.branch || "").trim() || null, turnCount: s.turnCount || 0, - turns, - tokenCount: effectiveTokenUsage?.totalTokens || 0, - inputTokens: effectiveTokenUsage?.inputTokens || 0, - outputTokens: effectiveTokenUsage?.outputTokens || 0, - tokenUsage: effectiveTokenUsage, createdAt: s.createdAt || new Date(s.startedAt).toISOString(), lastActiveAt, idleMs: progress?.idleMs ?? 0, @@ -1032,32 +670,9 @@ export class SessionTracker { recommendation: progress?.recommendation || "none", preview: this.#lastMessagePreview(s), lastMessage: this.#lastMessagePreview(s), - totalTokens: Number(tokenUsage?.totalTokens || 0), - inputTokens: Number(tokenUsage?.inputTokens || 0), - outputTokens: Number(tokenUsage?.outputTokens || 0), insights: s.insights || null, }); - }; - - for (const s of this.#sessions.values()) { - addSummary(s); - } - - if (includePersisted) { - for (const persisted of this.#readPersistedSessionSummaries()) { - if (!persisted) continue; - const sessionId = persisted.id || persisted.taskId; - if (!sessionId || byId.has(sessionId)) continue; - byId.set(sessionId, { - ...persisted, - turns: Array.isArray(persisted.turns) - ? persisted.turns.map((turn) => ({ ...turn })) - : [], - }); - } } - - const list = [...byId.values()]; list.sort((a, b) => (b.lastActiveAt || "").localeCompare(a.lastActiveAt || "")); return list; } @@ -1068,25 +683,7 @@ export class SessionTracker { * @returns {Object|null} */ getSessionMessages(sessionId) { - let session = this.#sessions.get(sessionId); - if (!session && this.#persistDir) { - try { - const filePath = this.#sessionFilePath(sessionId); - if (existsSync(filePath)) { - const raw = readFileSync(filePath, "utf8"); - const restored = buildSessionRecordFromPersistedData(JSON.parse(raw || "{}"), this.#idleThresholdMs); - if (restored) { - if (this.#sessions.size >= MAX_SESSIONS && !this.#sessions.has(restored.id)) { - this.#evictOldest(); - } - this.#sessions.set(restored.id, restored); - session = restored; - } - } - } catch { - session = null; - } - } + const session = this.#sessions.get(sessionId); if (!session) return null; return { ...session }; } @@ -1108,16 +705,14 @@ export class SessionTracker { updateSessionStatus(sessionId, status) { const session = this.#sessions.get(sessionId); if (!session) return; - session.status = isTerminalSessionStatus(status) - ? deriveTerminalSessionStatus(session, status) - : normalizeSessionStatus(status, "active"); - if (isTerminalSessionStatus(session.status)) { + session.status = status; + if (status === "completed" || status === "archived" || status === "failed" || status === "idle") { session.endedAt = Date.now(); } - this.#scheduleDerivedStateRefresh(session, { force: true }); + this.#refreshDerivedState(session); this.#accumulateCompletedSession(session, sessionId); this.#markDirty(sessionId); - emitSessionStateEvent(session, "session-status", { status: session.status }); + emitSessionStateEvent(session, "session-status", { status }); } /** @@ -1196,7 +791,7 @@ export class SessionTracker { target.editedAt = new Date().toISOString(); session.lastActivityAt = Date.now(); session.lastActiveAt = new Date().toISOString(); - this.#scheduleDerivedStateRefresh(session, { force: true }); + this.#refreshDerivedState(session); this.#markDirty(sessionId); return { ok: true, message: { ...target }, index: idx }; @@ -1228,12 +823,6 @@ export class SessionTracker { clearInterval(this.#reaperTimer); this.#reaperTimer = null; } - for (const [sessionId, timer] of this.#derivedRefreshTimers.entries()) { - clearTimeout(timer); - this.#derivedRefreshTimers.delete(sessionId); - const session = this.#sessions.get(sessionId); - if (session) this.#refreshDerivedState(session); - } this.#flushDirty(); } @@ -1245,7 +834,6 @@ export class SessionTracker { refreshFromDisk() { if (!this.#persistDir) return; this.#ensureDir(); - this.#invalidatePersistedSummaryCache(); let files = []; try { files = readdirSync(this.#persistDir).filter((f) => f.endsWith(".json")); @@ -1285,10 +873,35 @@ export class SessionTracker { const available = MAX_SESSIONS - this.#sessions.size; const toLoad = parsed.slice(0, Math.max(0, available)); - for (const { data } of toLoad) { - const restored = buildSessionRecordFromPersistedData(data, this.#idleThresholdMs); - if (!restored) continue; - this.#sessions.set(restored.id, restored); + for (const { data, lastActive } of toLoad) { + const sessionId = String(data.id || data.taskId || "").trim(); + // Heal stale "active" sessions + let status = data.status || "completed"; + let endedAt = data.endedAt || null; + if (status === "active" && lastActive > 0) { + const ageMs = Date.now() - lastActive; + if (ageMs > this.#idleThresholdMs) { + status = "completed"; + endedAt = endedAt || lastActive; + } + } + this.#sessions.set(sessionId, { + taskId: data.taskId || sessionId, + taskTitle: data.title || data.taskTitle || null, + id: sessionId, + type: data.type || "task", + startedAt: Date.parse(data.createdAt || "") || Date.now(), + createdAt: data.createdAt || new Date().toISOString(), + lastActiveAt: data.lastActiveAt || data.updatedAt || new Date().toISOString(), + endedAt, + messages: Array.isArray(data.messages) ? data.messages : [], + totalEvents: Array.isArray(data.messages) ? data.messages.length : 0, + turnCount: data.turnCount || 0, + status, + lastActivityAt: lastActive || Date.now(), + metadata: data.metadata || {}, + insights: data.insights || buildSessionInsights({ messages: data.messages || [] }), + }); } } @@ -1339,7 +952,7 @@ export class SessionTracker { if (session.status !== "active") continue; const idleMs = now - (session.lastActivityAt || session.startedAt || now); if (idleMs > this.#idleThresholdMs) { - session.status = deriveIdleTerminalSessionStatus(session); + session.status = "completed"; session.endedAt = now; this.#refreshDerivedState(session); this.#accumulateCompletedSession(session, id); @@ -1380,16 +993,7 @@ export class SessionTracker { const startedAt = Number.isFinite(Number(session.startedAt)) ? Number(session.startedAt) : endedAt; - const turns = Array.isArray(session.turns) ? session.turns : []; - const turnTokenUsage = turns.reduce((acc, turn) => ({ - inputTokens: acc.inputTokens + (Number(turn?.inputTokens) || 0), - outputTokens: acc.outputTokens + (Number(turn?.outputTokens) || 0), - totalTokens: acc.totalTokens + (Number(turn?.totalTokens) || 0), - }), { inputTokens: 0, outputTokens: 0, totalTokens: 0 }); - const tokenUsage = session.insights?.tokenUsage - || (turnTokenUsage.totalTokens > 0 || turnTokenUsage.inputTokens > 0 || turnTokenUsage.outputTokens > 0 - ? turnTokenUsage - : null); + const tokenUsage = session.insights?.tokenUsage || null; addCompletedSession({ id: session.id || taskId, @@ -1402,8 +1006,6 @@ export class SessionTracker { startedAt, endedAt, durationMs: Math.max(0, endedAt - startedAt), - turnCount: session.turnCount || 0, - turns: turns.map((turn) => ({ ...turn })), tokenCount: tokenUsage?.totalTokens || 0, inputTokens: tokenUsage?.inputTokens || 0, outputTokens: tokenUsage?.outputTokens || 0, @@ -1428,7 +1030,6 @@ export class SessionTracker { #extractTrajectoryStep(event, session) { const ts = new Date().toISOString(); - const eventTimestamp = String(event?.timestamp || event?.item?.timestamp || "").trim() || ts; const id = `step-${Date.now()}-${randomToken(6)}`; // String event @@ -1449,13 +1050,13 @@ export class SessionTracker { if (event?.type === "item.started" && event?.item) { const item = event.item; if (item.type === "command_execution") { - return { id, kind: "tool_call", summary: `Ran ${item.command || "unknown"}`, timestamp: eventTimestamp }; + return { id, kind: "tool_call", summary: `Ran ${item.command || "unknown"}`, timestamp: ts }; } if (item.type === "reasoning") { - return { id, kind: "reasoning", summary: item.text || "", timestamp: eventTimestamp }; + return { id, kind: "reasoning", summary: item.text || "", timestamp: ts }; } if (item.type === "function_call" || item.type === "mcp_tool_call") { - return { id, kind: "tool_call", summary: `${item.name || "call"} ${item.arguments || ""}`.trim(), timestamp: eventTimestamp }; + return { id, kind: "tool_call", summary: `${item.name || "call"} ${item.arguments || ""}`.trim(), timestamp: ts }; } return null; } @@ -1464,10 +1065,10 @@ export class SessionTracker { if (event?.type === "item.completed" && event?.item) { const item = event.item; if (item.type === "reasoning") { - return { id, kind: "reasoning", summary: item.text || "", timestamp: eventTimestamp }; + return { id, kind: "reasoning", summary: item.text || "", timestamp: ts }; } if (item.type === "function_call" || item.type === "mcp_tool_call") { - return { id, kind: "tool_call", summary: `${item.name || "call"} ${item.arguments || ""}`.trim(), timestamp: eventTimestamp }; + return { id, kind: "tool_call", summary: `${item.name || "call"} ${item.arguments || ""}`.trim(), timestamp: ts }; } if (item.type === "command_execution") { const cmd = item.command || ""; @@ -1475,12 +1076,12 @@ export class SessionTracker { (s) => s.kind === "tool_call" && s.summary === `Ran ${cmd}`, ); if (hasPriorStart) { - return { id, kind: "tool_result", summary: `${cmd} (exit ${item.exit_code ?? "?"})`, timestamp: eventTimestamp }; + return { id, kind: "tool_result", summary: `${cmd} (exit ${item.exit_code ?? "?"})`, timestamp: ts }; } - return { id, kind: "command", summary: cmd, timestamp: eventTimestamp }; + return { id, kind: "command", summary: cmd, timestamp: ts }; } if (item.type === "agent_message") { - return { id, kind: "assistant", summary: item.text || "", timestamp: eventTimestamp }; + return { id, kind: "assistant", summary: item.text || "", timestamp: ts }; } return null; } @@ -1488,7 +1089,7 @@ export class SessionTracker { // Assistant message events if (event?.type === "assistant.message") { const content = event?.data?.content || event?.content || ""; - return { id, kind: "agent_message", summary: content.slice(0, 200), timestamp: eventTimestamp }; + return { id, kind: "agent_message", summary: content.slice(0, 200), timestamp: ts }; } return null; @@ -1501,37 +1102,6 @@ export class SessionTracker { ...session, insights: null, }); - const priorTurns = Array.isArray(session.turns) ? session.turns : []; - const priorTurnsByIndex = new Map( - priorTurns.map((turn) => [Number(turn?.turnIndex || 0), turn]), - ); - session.turns = Array.isArray(session.insights?.turnTimeline) - ? session.insights.turnTimeline.map((turn) => { - const turnIndex = Number(turn?.turnIndex || 0); - const priorTurn = priorTurnsByIndex.get(turnIndex) || {}; - return { - turnIndex, - startedAt: turn?.startedAt ? parseTimestampMs(turn.startedAt) : (priorTurn.startedAt ?? null), - endedAt: turn?.endedAt ? parseTimestampMs(turn.endedAt) : (priorTurn.endedAt ?? null), - durationMs: Math.max(0, Number(turn?.durationMs || priorTurn.durationMs || 0)), - inputTokens: Math.max( - normalizeTokenNumber(turn?.inputTokens), - normalizeTokenNumber(priorTurn.inputTokens), - ), - outputTokens: Math.max( - normalizeTokenNumber(turn?.outputTokens), - normalizeTokenNumber(priorTurn.outputTokens), - ), - totalTokens: Math.max( - normalizeTokenNumber(turn?.totalTokens), - normalizeTokenNumber(priorTurn.totalTokens), - ), - userMessageId: priorTurn.userMessageId || null, - assistantMessageId: priorTurn.assistantMessageId || null, - status: priorTurn.status || (turn?.endedAt ? "completed" : "in_progress"), - }; - }) - : priorTurns; } catch { // Inspector insights are best-effort only. } @@ -1553,58 +1123,12 @@ export class SessionTracker { } } - #scheduleDerivedStateRefresh(session, options = {}) { - if (!session) return; - const sessionId = String(session.id || session.taskId || "").trim(); - if (!sessionId) { - this.#refreshDerivedState(session); - return; - } - const force = options.force === true; - const existingTimer = this.#derivedRefreshTimers.get(sessionId); - if (existingTimer) { - clearTimeout(existingTimer); - this.#derivedRefreshTimers.delete(sessionId); - } - if (force) { - this.#refreshDerivedState(session); - session._derivedStateRefreshedAt = Date.now(); - return; - } - const now = Date.now(); - const lastRefreshedAt = Number(session._derivedStateRefreshedAt || 0); - const elapsedMs = now - lastRefreshedAt; - if (elapsedMs >= DERIVED_STATE_REFRESH_MS) { - this.#refreshDerivedState(session); - session._derivedStateRefreshedAt = now; - return; - } - const delayMs = Math.max(0, DERIVED_STATE_REFRESH_MS - elapsedMs); - const timer = setTimeout(() => { - this.#derivedRefreshTimers.delete(sessionId); - const currentSession = this.#sessions.get(sessionId); - if (!currentSession) return; - this.#refreshDerivedState(currentSession); - currentSession._derivedStateRefreshedAt = Date.now(); - }, delayMs); - if (timer.unref) timer.unref(); - this.#derivedRefreshTimers.set(sessionId, timer); - } - #ensureDir() { if (this.#persistDir && !existsSync(this.#persistDir)) { mkdirSync(this.#persistDir, { recursive: true }); } } - #safeSessionFileMtime(file) { - try { - return statSync(resolve(this.#persistDir, file)).mtimeMs; - } catch { - return 0; - } - } - #sessionFilePath(sessionId) { // Sanitize sessionId for filesystem safety const safe = String(sessionId).replace(/[^a-zA-Z0-9_\-\.]/g, "_"); @@ -1618,8 +1142,6 @@ export class SessionTracker { const session = this.#sessions.get(sessionId); if (!session) continue; try { - this.#refreshDerivedState(session); - session._derivedStateRefreshedAt = Date.now(); const filePath = this.#sessionFilePath(sessionId); const data = { id: session.id || session.taskId, @@ -1635,7 +1157,6 @@ export class SessionTracker { endedAt: session.endedAt || null, accumulatedAt: session.accumulatedAt || null, turnCount: session.turnCount || 0, - turns: Array.isArray(session.turns) ? session.turns : [], messages: session.messages || [], metadata: session.metadata || {}, insights: session.insights || null, @@ -1648,7 +1169,6 @@ export class SessionTracker { } } this.#dirty.clear(); - this.#invalidatePersistedSummaryCache(); } /** @type {Set} filenames loaded during #loadFromDisk (for purge) */ @@ -1659,129 +1179,81 @@ export class SessionTracker { try { const files = readdirSync(this.#persistDir).filter((f) => f.endsWith(".json")); - // Keep startup bounded by loading only the newest session files into memory. - // Older sessions remain on disk and are listed/lazy-loaded on demand. - const recentFiles = files - .map((file) => ({ file, mtimeMs: Number(this.#safeSessionFileMtime(file)) || 0 })) - .sort((a, b) => b.mtimeMs - a.mtimeMs) - .slice(0, MAX_SESSIONS); - - for (const { file } of recentFiles) { + // Pre-parse all session files with their timestamps for sorting + /** @type {Array<{file: string, data: Object, lastActive: number}>} */ + const parsed = []; + for (const file of files) { try { const raw = readFileSync(resolve(this.#persistDir, file), "utf8"); const data = JSON.parse(raw); if (!data.id && !data.taskId) continue; - const restored = buildSessionRecordFromPersistedData(data, this.#idleThresholdMs); - if (!restored) continue; - const id = restored.id; - if (this.#sessions.has(id)) continue; - this.#sessions.set(id, restored); - // Skip completed-session accumulation during startup hydration to keep disk-backed reloads fast. - // Sessions are still available for listing and lazy message reads from disk. + const id = data.id || data.taskId; + if (this.#sessions.has(id)) continue; // don't overwrite in-memory + const lastActive = data.lastActiveAt + ? new Date(data.lastActiveAt).getTime() + : data.createdAt + ? new Date(data.createdAt).getTime() + : 0; + parsed.push({ file, data, lastActive }); } catch { // Skip corrupt files } } - } catch { - // Directory read failed — proceed without disk data - } - this.#invalidatePersistedSummaryCache(); - } - - #invalidatePersistedSummaryCache() { - this.#persistedSummaryCache = { loadedAt: 0, sessions: [] }; - } - - #readPersistedSessionSummaries() { - if (!this.#persistDir || !existsSync(this.#persistDir)) { - return []; - } - const now = Date.now(); - if ( - Array.isArray(this.#persistedSummaryCache.sessions) && - now - Number(this.#persistedSummaryCache.loadedAt || 0) < - PERSISTED_SESSION_LIST_CACHE_TTL_MS - ) { - return this.#persistedSummaryCache.sessions; - } + // Sort by lastActive descending (newest first) and keep only MAX_SESSIONS + parsed.sort((a, b) => b.lastActive - a.lastActive); + const toLoad = parsed.slice(0, MAX_SESSIONS); + + // Track which files were loaded so #purgeExcessFiles can remove the rest + this.#loadedFiles = new Set(toLoad.map((p) => p.file)); + + for (const { data, lastActive } of toLoad) { + const id = data.id || data.taskId; + // Heal stale "active" sessions — if restored from disk and the last + // activity was more than idleThresholdMs ago, mark as completed. + let status = data.status || "completed"; + let endedAt = data.endedAt || null; + if (status === "active" && lastActive > 0) { + const ageMs = Date.now() - lastActive; + if (ageMs > this.#idleThresholdMs) { + status = "completed"; + endedAt = endedAt || lastActive; + } + } - const sessions = []; - try { - const files = readdirSync(this.#persistDir).filter((f) => f.endsWith(".json")); - for (const file of files) { - try { - const raw = readFileSync(resolve(this.#persistDir, file), "utf8"); - const restored = buildSessionRecordFromPersistedData( - JSON.parse(raw || "{}"), - this.#idleThresholdMs, - ); - if (!restored) continue; - const sessionId = restored.id || restored.taskId; - const lastActiveAt = - restored.lastActiveAt || new Date(restored.lastActivityAt).toISOString(); - const turns = Array.isArray(restored.turns) - ? restored.turns.map((turn) => ({ ...turn })) - : []; - const turnTokenUsage = turns.reduce((acc, turn) => ({ - inputTokens: acc.inputTokens + (Number(turn?.inputTokens) || 0), - outputTokens: acc.outputTokens + (Number(turn?.outputTokens) || 0), - totalTokens: acc.totalTokens + (Number(turn?.totalTokens) || 0), - }), { inputTokens: 0, outputTokens: 0, totalTokens: 0 }); - const tokenUsage = restored.insights?.tokenUsage - || (turnTokenUsage.totalTokens > 0 || turnTokenUsage.inputTokens > 0 || turnTokenUsage.outputTokens > 0 - ? turnTokenUsage - : null); - const effectiveTokenUsage = extractUsageFromMeta(tokenUsage) || { - inputTokens: 0, - outputTokens: 0, - totalTokens: 0, - }; - sessions.push({ - id: sessionId, - taskId: restored.taskId, - title: restored.taskTitle || restored.title || null, - type: restored.type || "task", - status: restored.status || "completed", - lifecycleStatus: restored.status || "completed", - runtimeState: null, - runtimeUpdatedAt: lastActiveAt, - runtimeIsLive: false, - workspaceId: String(restored?.metadata?.workspaceId || "").trim() || null, - workspaceDir: String(restored?.metadata?.workspaceDir || "").trim() || null, - branch: String(restored?.metadata?.branch || "").trim() || null, - turnCount: restored.turnCount || 0, - turns, - tokenCount: effectiveTokenUsage.totalTokens || 0, - inputTokens: effectiveTokenUsage.inputTokens || 0, - outputTokens: effectiveTokenUsage.outputTokens || 0, - tokenUsage: effectiveTokenUsage, - createdAt: restored.createdAt || new Date(restored.startedAt).toISOString(), - lastActiveAt, - idleMs: 0, - elapsedMs: Math.max( - 0, - Number(restored.endedAt || Date.now()) - Number(restored.startedAt || Date.now()), - ), - recommendation: "none", - preview: this.#lastMessagePreview(restored), - lastMessage: this.#lastMessagePreview(restored), - insights: restored.insights || null, - }); - } catch { - // Ignore corrupt session files in summary listing + this.#sessions.set(id, { + id, + taskId: data.taskId || id, + taskTitle: data.taskTitle || data.title || data.metadata?.title || id, + sessionKey: + String(data.sessionKey || "").trim() || + `${data.taskId || id}:${data.startedAt || Date.now()}:${endedAt || data.startedAt || Date.now()}`, + type: data.type || "task", + status, + createdAt: data.createdAt || new Date().toISOString(), + lastActiveAt: data.lastActiveAt || new Date().toISOString(), + startedAt: data.startedAt || (data.createdAt ? new Date(data.createdAt).getTime() : Date.now()), + endedAt, + messages: data.messages || [], + totalEvents: (data.messages || []).length, + turnCount: data.turnCount || 0, + accumulatedAt: data.accumulatedAt || null, + lastActivityAt: lastActive || Date.now(), + metadata: data.metadata || {}, + insights: data.insights || buildSessionInsights({ messages: data.messages || [] }), + trajectory: data.trajectory || { version: 1, replayable: true, steps: [] }, + summary: data.summary || null, + }); + const restored = this.#sessions.get(id); + if (restored && isTerminalSessionStatus(restored.status) && !restored.accumulatedAt) { + if (this.#accumulateCompletedSession(restored, id)) { + this.#markDirty(id); + } } } } catch { - // Best-effort disk-backed listing only + // Directory read failed — proceed without disk data } - - sessions.sort((a, b) => (b.lastActiveAt || "").localeCompare(a.lastActiveAt || "")); - this.#persistedSummaryCache = { - loadedAt: now, - sessions, - }; - return sessions; } /** @@ -1789,7 +1261,28 @@ export class SessionTracker { * This runs once at startup to clean up historical bloat. */ #purgeExcessFiles() { - this.#loadedFiles.clear(); + if (!this.#persistDir || !existsSync(this.#persistDir)) return; + try { + const files = readdirSync(this.#persistDir).filter((f) => f.endsWith(".json")); + let purged = 0; + for (const file of files) { + if (!this.#loadedFiles.has(file)) { + try { + unlinkSync(resolve(this.#persistDir, file)); + purged++; + } catch { + // best-effort cleanup + } + } + } + if (purged > 0) { + console.log(`${TAG} purged ${purged} excess session file(s) from disk`); + } + // Free the reference — only needed once at startup + this.#loadedFiles.clear(); + } catch { + // best-effort + } } /** @@ -1804,7 +1297,6 @@ export class SessionTracker { if (!event || !event.type) return null; const ts = new Date().toISOString(); - const eventTimestamp = String(event.timestamp || "").trim() || ts; const toText = (value) => { if (value == null) return ""; if (typeof value === "string") return value; @@ -2064,7 +1556,7 @@ ${items.join("\n")}` : "todo updated"; return { type: "system", content: "Turn completed", - timestamp: eventTimestamp, + timestamp: ts, meta: { lifecycle: "turn_completed" }, }; } @@ -2073,7 +1565,7 @@ ${items.join("\n")}` : "todo updated"; return { type: "system", content: "Session completed", - timestamp: eventTimestamp, + timestamp: ts, meta: { lifecycle: "session_completed" }, }; } @@ -2083,7 +1575,7 @@ ${items.join("\n")}` : "todo updated"; return { type: "error", content: `Turn failed: ${detail}`.slice(0, MAX_MESSAGE_CHARS), - timestamp: eventTimestamp, + timestamp: ts, }; } @@ -2091,7 +1583,7 @@ ${items.join("\n")}` : "todo updated"; return { type: "agent_message", content: toText(event.data.content).slice(0, MAX_MESSAGE_CHARS), - timestamp: eventTimestamp, + timestamp: ts, }; } @@ -2099,7 +1591,7 @@ ${items.join("\n")}` : "todo updated"; return { type: "agent_message", content: toText(event.data.deltaContent).slice(0, MAX_MESSAGE_CHARS), - timestamp: eventTimestamp, + timestamp: ts, }; } @@ -2109,7 +1601,7 @@ ${items.join("\n")}` : "todo updated"; type: "agent_message", content: (typeof event.content === "string" ? event.content : JSON.stringify(event.content)) .slice(0, MAX_MESSAGE_CHARS), - timestamp: eventTimestamp, + timestamp: ts, }; } @@ -2117,7 +1609,7 @@ ${items.join("\n")}` : "todo updated"; return { type: "tool_call", content: `${event.name || event.tool || "tool"}(${(event.arguments || event.input || "").slice(0, 500)})`, - timestamp: eventTimestamp, + timestamp: ts, meta: { toolName: event.name || event.tool }, }; } @@ -2126,7 +1618,7 @@ ${items.join("\n")}` : "todo updated"; return { type: "tool_result", content: (event.output || event.result || "").slice(0, MAX_MESSAGE_CHARS), - timestamp: eventTimestamp, + timestamp: ts, }; } @@ -2135,7 +1627,7 @@ ${items.join("\n")}` : "todo updated"; return { type: "agent_message", content: event.delta.text.slice(0, MAX_MESSAGE_CHARS), - timestamp: eventTimestamp, + timestamp: ts, }; } @@ -2144,7 +1636,7 @@ ${items.join("\n")}` : "todo updated"; return { type: "system", content: `${event.type}${event.delta?.stop_reason ? ` (${event.delta.stop_reason})` : ""}`, - timestamp: eventTimestamp, + timestamp: ts, ...(lifecycle ? { meta: { lifecycle } } : {}), }; } @@ -2154,7 +1646,7 @@ ${items.join("\n")}` : "todo updated"; return { type: "error", content: (event.error?.message || event.message || JSON.stringify(event)).slice(0, MAX_MESSAGE_CHARS), - timestamp: eventTimestamp, + timestamp: ts, }; } @@ -2163,7 +1655,7 @@ ${items.join("\n")}` : "todo updated"; return { type: "system", content: `Voice session started (provider: ${event.provider || "unknown"}, tier: ${event.tier || "?"})`, - timestamp: eventTimestamp, + timestamp: ts, meta: { voiceEvent: "start", provider: event.provider, tier: event.tier }, }; } @@ -2171,7 +1663,7 @@ ${items.join("\n")}` : "todo updated"; return { type: "system", content: `Voice session ended (duration: ${event.duration || 0}s)`, - timestamp: eventTimestamp, + timestamp: ts, meta: { voiceEvent: "end", duration: event.duration }, }; } @@ -2179,7 +1671,7 @@ ${items.join("\n")}` : "todo updated"; return { type: "user", content: (event.text || event.transcript || "").slice(0, MAX_MESSAGE_CHARS), - timestamp: eventTimestamp, + timestamp: ts, meta: { voiceEvent: "transcript" }, }; } @@ -2187,7 +1679,7 @@ ${items.join("\n")}` : "todo updated"; return { type: "agent_message", content: (event.text || event.response || "").slice(0, MAX_MESSAGE_CHARS), - timestamp: eventTimestamp, + timestamp: ts, meta: { voiceEvent: "response" }, }; } @@ -2195,7 +1687,7 @@ ${items.join("\n")}` : "todo updated"; return { type: "tool_call", content: `voice:${event.name || "tool"}(${(event.arguments || "").slice(0, 500)})`, - timestamp: eventTimestamp, + timestamp: ts, meta: { voiceEvent: "tool_call", toolName: event.name }, }; } @@ -2203,7 +1695,7 @@ ${items.join("\n")}` : "todo updated"; return { type: "system", content: `Voice delegated to ${event.executor || "agent"}: ${(event.message || "").slice(0, 500)}`, - timestamp: eventTimestamp, + timestamp: ts, meta: { voiceEvent: "delegate", executor: event.executor }, }; } @@ -2236,11 +1728,10 @@ ${items.join("\n")}` : "todo updated"; /** * List all sessions (metadata only). - * @param {{ includePersisted?: boolean }} [options] * @returns {Array} */ -export function listAllSessions(options) { - return getSessionTracker().listAllSessions(options); +export function listAllSessions() { + return getSessionTracker().listAllSessions(); } /** @@ -2261,15 +1752,6 @@ export async function createSession(opts) { return getSessionTracker().createSession(opts); } -/** - * Append an event/message to an existing session. - * @param {string} sessionId - * @param {Object|string} event - */ -export function appendEvent(sessionId, event) { - return getSessionTracker().appendEvent(sessionId, event); -} - /** * Update session status. * @param {string} sessionId diff --git a/infra/tracing.mjs b/infra/tracing.mjs index 3db3839ad..f73bc3738 100644 --- a/infra/tracing.mjs +++ b/infra/tracing.mjs @@ -115,7 +115,6 @@ function createNoopState() { spanKind: null, activeSpans: new Map(), finishedSpans: [], - testSpans: [], }; } @@ -163,9 +162,6 @@ function createLocalSpan(name, attributes = {}, parent = null) { name, traceId, spanId, - traceFlags: Number.isFinite(Number(activeParent?.traceFlags)) - ? Number(activeParent.traceFlags) - : 1, parentSpanId: activeParent?.spanId || null, startTime: nowHrTime(), endTime: null, @@ -190,25 +186,22 @@ function attachOtelAttributes(otelSpan, attributes = {}) { function syncSpanContext(span) { const spanContext = span?.otelSpan?.spanContext?.(); if (!spanContext) return; - if (Number.isFinite(Number(spanContext.traceFlags))) { - span.traceFlags = Number(spanContext.traceFlags); - } + span.traceId = spanContext.traceId || span.traceId; + span.spanId = spanContext.spanId || span.spanId; } function finalizeLocalSpan(span) { span.endTime = nowHrTime(); span.durationMs = durationMs(span.startTime); tracingState.activeSpans.delete(span.spanId); - const finishedSpan = { + tracingState.finishedSpans.push({ ...span, attributes: { ...span.attributes }, events: [...span.events], exceptions: [...span.exceptions], links: [...span.links], status: { ...span.status }, - }; - tracingState.finishedSpans.push(finishedSpan); - tracingState.testSpans.push(finishedSpan); + }); } async function loadOtelBindings() { @@ -247,8 +240,8 @@ export async function setupTracing(endpointOrConfig = null) { ? { endpoint: endpointOrConfig } : (endpointOrConfig ?? {}); - const endpoint = process.env.BOSUN_OTEL_ENDPOINT || inputConfig.endpoint || null; - const enabled = endpoint ? true : (inputConfig.enabled ?? false); + const endpoint = inputConfig.endpoint || process.env.BOSUN_OTEL_ENDPOINT || null; + const enabled = inputConfig.enabled ?? Boolean(endpoint); const sampleRate = Number(inputConfig.sampleRate ?? 1); const exportTimeoutMillis = Math.max( 1, @@ -260,20 +253,7 @@ export async function setupTracing(endpointOrConfig = null) { if (!enabled || !endpoint) { tracingState = createNoopState(); ensureMetricInstruments(); - return { - enabled: false, - endpoint: null, - sampleRate: 0, - serviceName: DEFAULT_SERVICE_NAME, - serviceVersion: DEFAULT_SERVICE_VERSION, - config: { - enabled: false, - endpoint: null, - sampleRate: 0, - serviceName: DEFAULT_SERVICE_NAME, - serviceVersion: DEFAULT_SERVICE_VERSION, - }, - }; + return { enabled: false, endpoint: null, sampleRate: 0 }; } const serviceName = inputConfig.serviceName || DEFAULT_SERVICE_NAME; @@ -328,23 +308,7 @@ export async function setupTracing(endpointOrConfig = null) { tracer = otel.api.trace.getTracer(serviceName, serviceVersion); } catch { sdk = null; - tracer = { - startSpan(name, options = {}) { - const attributes = options?.attributes || {}; - return { - setAttributes() {}, - addEvent() {}, - recordException() {}, - setStatus() {}, - end() {}, - spanContext() { - return { traceId: randomId(TRACE_ID_BYTES), spanId: randomId(SPAN_ID_BYTES) }; - }, - attributes, - name, - }; - }, - }; + tracer = null; api = null; statusCodes = null; spanKind = null; @@ -367,7 +331,6 @@ export async function setupTracing(endpointOrConfig = null) { spanKind, activeSpans: new Map(), finishedSpans: [], - testSpans: [], }; ensureMetricInstruments(); @@ -378,35 +341,10 @@ export async function setupTracing(endpointOrConfig = null) { serviceName, serviceVersion, exporter, - config: { - enabled: true, - endpoint, - sampleRate: resolvedSampleRate, - serviceName, - serviceVersion, - }, }; } export function getTracingState() { - const activeSessions = (tracingState.metrics.gauges.get("bosun.agent.sessions.active") || []).reduce( - (total, entry) => total + Number(entry?.value || 0), - 0, - ); - const taskTokensTotal = (tracingState.metrics.counters.get("bosun.task.tokens.total") || []).reduce( - (total, entry) => total + Number(entry?.value || 0), - 0, - ); - const taskCostUsd = (tracingState.metrics.counters.get("bosun.task.cost.usd") || []).reduce( - (total, entry) => total + Number(entry?.value || 0), - 0, - ); - const errorsByType = {}; - for (const entry of tracingState.metrics.counters.get("bosun.agent.errors") || []) { - const type = entry?.attributes?.["bosun.error.type"] || "Error"; - errorsByType[type] = (errorsByType[type] || 0) + Number(entry?.value || 0); - } - return { enabled: tracingState.enabled, endpoint: tracingState.endpoint, @@ -414,35 +352,11 @@ export function getTracingState() { serviceName: tracingState.serviceName, serviceVersion: tracingState.serviceVersion, exporter: tracingState.exporter, - config: { - enabled: tracingState.enabled, - endpoint: tracingState.endpoint, - sampleRate: tracingState.sampleRate, - serviceName: tracingState.serviceName, - serviceVersion: tracingState.serviceVersion, - }, - tracer: tracingState.tracer, - testSpans: [...tracingState.testSpans], - metrics: { - activeSessions, - taskTokensTotal, - taskCostUsd, - errorsByType, - }, }; } export function getFinishedSpans() { - return tracingState.finishedSpans.flatMap((span) => { - if (span?.name !== "bosun.task.execution") { - return [{ ...span }]; - } - // Preserve the canonical span name while keeping legacy read paths stable. - return [ - { ...span }, - { ...span, name: "bosun.task.execute" }, - ]; - }); + return [...tracingState.finishedSpans]; } export function getMetricSnapshot() { @@ -460,8 +374,7 @@ export async function shutdownTracing() { ensureMetricInstruments(); } -export async function resetTracingForTests() { - await shutdownSdk(tracingState.sdk); +export function resetTracingForTests() { tracingState = createNoopState(); metricInstruments = null; ensureMetricInstruments(); @@ -477,19 +390,6 @@ export function addSpanEvent(name, attributes = {}) { } } -export function recordAgentEvent(event = {}) { - if (!event || typeof event !== "object") { - return; - } - const eventName = typeof event.type === "string" && event.type.trim() ? event.type.trim() : "agent:event"; - addSpanEvent(eventName, { - "bosun.task.id": event.taskId, - "bosun.agent.id": event.agentId, - "bosun.event.ts": event.ts, - ...omitUndefined(event.payload || {}), - }); -} - export function recordIntervention(type, attributes = {}) { recordMetric("agentInterventions", "counter", 1, { "bosun.intervention.type": type, @@ -600,7 +500,6 @@ export function getCurrentTraceContext() { name: current.name, traceId: current.traceId, spanId: current.spanId, - traceFlags: current.traceFlags, parentSpanId: current.parentSpanId, attributes: { ...current.attributes }, }; @@ -690,13 +589,6 @@ async function withSpan(name, attributes, fn, hooks = {}, options = {}) { }); } hooks.onError?.(span, error); - if (!hooks.onError) { - recordMetric("agentErrors", "counter", 1, { - "bosun.error.type": error?.name || "Error", - "trace.span_id": span.spanId, - "trace.trace_id": span.traceId, - }); - } throw error; } finally { hooks.onFinally?.(span); @@ -758,7 +650,7 @@ export async function traceWorkflowNode(node = {}, fn) { export async function traceTaskExecution(task = {}, fn) { const remoteParent = buildRemoteParentContext(task?.carrier || task?.headers || null); return withSpan( - "bosun.task.execution", + "bosun.task.execute", { ...resolveSpanAttributes(task), "bosun.task.title": task.title, @@ -849,7 +741,6 @@ export async function traceToolCall(tool = {}, fn) { return withSpan( "bosun.tool.call", { - ...resolveSpanAttributes(tool), "bosun.tool.name": tool.toolName, "bosun.tool.tokens_used": tool.tokensUsed, }, @@ -875,7 +766,7 @@ export async function traceLLMCall(call = {}, fn) { "llm.input_tokens": call.inputTokens, "llm.output_tokens": call.outputTokens, "llm.cost_usd": call.costUsd, - "llm.latency_ms": call.latencyMs ?? call.latency, + "llm.latency_ms": call.latency, }, async (span) => { const startedAt = nowHrTime(); @@ -886,24 +777,12 @@ export async function traceLLMCall(call = {}, fn) { span.attributes["llm.input_tokens"] = inputTokens; span.attributes["llm.output_tokens"] = outputTokens; span.attributes["llm.cost_usd"] = costUsd; - span.attributes["llm.latency_ms"] = Number(result?.latencyMs ?? result?.latency ?? call.latencyMs ?? call.latency ?? durationMs(startedAt)); - const totalTokens = inputTokens + outputTokens; - const currentTaskId = call.taskId || span.attributes["bosun.task.id"]; - const metricAttributes = { - "bosun.task.id": currentTaskId, - "llm.model": call.model, - "trace.span_id": span.spanId, - "trace.trace_id": span.traceId, - }; - if (totalTokens > 0) { - recordMetric("taskTokensTotal", "counter", totalTokens, metricAttributes); - } - if (costUsd > 0) { - recordMetric("taskCostUsd", "counter", costUsd, metricAttributes); - } + span.attributes["llm.latency_ms"] = Number(result?.latency ?? call.latency ?? durationMs(startedAt)); return result; }, ); } ensureMetricInstruments(); + + diff --git a/infra/tui-bridge.mjs b/infra/tui-bridge.mjs index 78518bf58..7149528b0 100644 --- a/infra/tui-bridge.mjs +++ b/infra/tui-bridge.mjs @@ -271,35 +271,17 @@ export function buildMonitorStatsPayload({ agentPool, runtimeStats = {}, uptimeM } export function buildSessionsUpdatePayload(sessions = []) { - return Array.isArray(sessions) - ? sessions.map((session) => { - const normalized = session && typeof session === "object" ? { ...session } : {}; - const tokenUsage = normalized?.insights?.tokenUsage || null; - const inputTokens = Number(normalized.inputTokens ?? tokenUsage?.inputTokens ?? 0); - const outputTokens = Number(normalized.outputTokens ?? tokenUsage?.outputTokens ?? 0); - const totalTokens = Number( - normalized.totalTokens ?? normalized.tokenCount ?? tokenUsage?.totalTokens ?? (inputTokens + outputTokens), - ); - normalized.inputTokens = Number.isFinite(inputTokens) ? Math.max(0, Math.round(inputTokens)) : 0; - normalized.outputTokens = Number.isFinite(outputTokens) ? Math.max(0, Math.round(outputTokens)) : 0; - normalized.totalTokens = Number.isFinite(totalTokens) ? Math.max(0, Math.round(totalTokens)) : (normalized.inputTokens + normalized.outputTokens); - normalized.tokenCount = normalized.totalTokens; - return normalized; - }) - : []; + return Array.isArray(sessions) ? sessions.map((session) => ({ ...session })) : []; } export function buildSessionEventPayload(payload = {}) { const event = payload?.event && typeof payload.event === "object" ? { ...payload.event } : { kind: "message", ...(payload?.message ? { message: payload.message } : {}) }; - const session = payload?.session && typeof payload.session === "object" - ? buildSessionsUpdatePayload([payload.session])[0] - : {}; return { - sessionId: String(payload?.sessionId || session?.id || payload?.session?.id || "").trim(), - taskId: String(payload?.taskId || session?.taskId || payload?.session?.taskId || "").trim(), - session, + sessionId: String(payload?.sessionId || payload?.session?.id || "").trim(), + taskId: String(payload?.taskId || payload?.session?.taskId || "").trim(), + session: payload?.session && typeof payload.session === "object" ? { ...payload.session } : {}, event, }; } diff --git a/infra/update-check.mjs b/infra/update-check.mjs index 4db04fde2..577014184 100644 --- a/infra/update-check.mjs +++ b/infra/update-check.mjs @@ -49,31 +49,6 @@ const NPM_LAUNCH_ERROR_CODES = new Set([ "EPERM", "ETXTBSY", ]); -const BUILTIN_AGENT_SKILL_FILES = [ - "agent-coordination.md", - "background-task-execution.md", - "bosun-agent-api.md", - "code-quality-anti-patterns.md", - "commit-conventions.md", - "custom-tool-creation.md", - "error-recovery.md", - "pr-workflow.md", - "skill-codebase-audit.md", - "tdd-pattern.md", -]; - -function isUpdateCheckTestRuntime() { - return Boolean(process.env.VITEST) || - process.env.NODE_ENV === "test" || - Boolean(process.env.JEST_WORKER_ID); -} - -function isSourceCheckoutRuntime(opts = {}) { - if (opts.allowSourceCheckoutAutoUpdate === true) return false; - if (process.env.BOSUN_FORCE_AUTO_UPDATE === "1") return false; - if (isUpdateCheckTestRuntime()) return false; - return existsSync(resolve(__dirname, "..", ".git")); -} function sanitizeNpmEnv(baseEnv = process.env) { const env = { ...baseEnv }; @@ -125,11 +100,7 @@ function quoteCmdArg(arg) { function runWindowsCmd(candidate, args, options) { const cmdLine = [`"${candidate}"`, ...args.map(quoteCmdArg)].join(" "); - const cmdExe = - process.env.ComSpec || - process.env.COMSPEC || - join(process.env.SystemRoot || "C:\\Windows", "System32", "cmd.exe"); - return execFileSync(cmdExe, ["/d", "/s", "/c", cmdLine], options); + return execFileSync("cmd.exe", ["/d", "/s", "/c", cmdLine], options); } function runNpmCommand(args, options = {}) { @@ -519,12 +490,7 @@ export function getCurrentVersion() { } function getRequiredRuntimeFiles() { - const required = [ - resolve(__dirname, "monitor.mjs"), - resolve(__dirname, "..", "agent", "bosun-skills.mjs"), - ...BUILTIN_AGENT_SKILL_FILES.map((file) => - resolve(__dirname, "..", "agent", "skills", file)), - ]; + const required = [resolve(__dirname, "monitor.mjs")]; const copilotDir = resolve(__dirname, "..", "node_modules", "@github", "copilot"); if (process.platform === "win32" && existsSync(copilotDir)) { required.push(resolve(copilotDir, "conpty_console_list_agent.js")); @@ -595,12 +561,6 @@ export function startAutoUpdateLoop(opts = {}) { console.log("[auto-update] Disabled via BOSUN_SKIP_AUTO_UPDATE=1"); return; } - if (isSourceCheckoutRuntime(opts)) { - console.log( - "[auto-update] Disabled in source checkout (set BOSUN_FORCE_AUTO_UPDATE=1 to override)", - ); - return; - } const intervalMs = Number(process.env.BOSUN_UPDATE_INTERVAL_MS) || @@ -932,11 +892,8 @@ export const __autoUpdateTestHooks = { resetAutoUpdateState, recordAutoUpdateFailure, isAutoUpdateDisabled, - isSourceCheckoutRuntime, - getRequiredRuntimeFiles, classifyInstallError, buildDisableNotice, - runWindowsCmd, AUTO_UPDATE_STATE_FILE, AUTO_UPDATE_FAILURE_LIMIT, AUTO_UPDATE_DISABLE_WINDOW_MS, diff --git a/infra/worktree-recovery-state.mjs b/infra/worktree-recovery-state.mjs index bb78bd046..df55d4a2f 100644 --- a/infra/worktree-recovery-state.mjs +++ b/infra/worktree-recovery-state.mjs @@ -96,7 +96,10 @@ function buildNextWorktreeRecoveryState(currentState, event) { if (normalizedEvent.outcome === "healthy_noop") { return { ...nextState, - health: state.health === "healthy" ? "healthy" : state.health, + health: + state.health === "recovered" + ? "recovered" + : (state.failureStreak > 0 ? state.health : "healthy"), lastHealthyAt: normalizedEvent.timestamp, }; } diff --git a/lib/integrations-registry.mjs b/lib/integrations-registry.mjs deleted file mode 100644 index bb509148a..000000000 --- a/lib/integrations-registry.mjs +++ /dev/null @@ -1,294 +0,0 @@ -/** - * Integrations Registry — catalog of supported integration types and their field schemas. - * - * Each integration definition has: - * id — unique string key - * name — display name - * description — short description - * icon — emoji icon for UI - * fields — array of field descriptors for the secrets form - * docsUrl — optional documentation link - */ - -/** @typedef {{ id: string, label: string, type: "text"|"password"|"url"|"select", required?: boolean, placeholder?: string, options?: string[], helpText?: string }} FieldDef */ -/** @typedef {{ id: string, name: string, description: string, icon: string, fields: FieldDef[], docsUrl?: string }} IntegrationDef */ - -/** @type {IntegrationDef[]} */ -export const INTEGRATIONS = [ - { - id: "github", - name: "GitHub", - description: "GitHub personal access tokens and App credentials", - icon: "🐙", - fields: [ - { - id: "token", - label: "Personal Access Token", - type: "password", - required: false, - placeholder: "ghp_...", - helpText: "Classic or fine-grained PAT with repo scope", - }, - { - id: "appId", - label: "App ID", - type: "text", - required: false, - placeholder: "123456", - helpText: "GitHub App ID (optional, for App-based auth)", - }, - { - id: "privateKey", - label: "App Private Key (PEM)", - type: "password", - required: false, - placeholder: "-----BEGIN RSA PRIVATE KEY-----", - helpText: "GitHub App private key for JWT signing", - }, - { - id: "installationId", - label: "Installation ID", - type: "text", - required: false, - placeholder: "45678901", - helpText: "GitHub App installation ID", - }, - ], - docsUrl: "https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens", - }, - { - id: "telegram", - name: "Telegram", - description: "Telegram Bot API token", - icon: "✈️", - fields: [ - { - id: "botToken", - label: "Bot Token", - type: "password", - required: true, - placeholder: "1234567890:ABCdef...", - helpText: "From @BotFather — used for sending notifications", - }, - { - id: "chatId", - label: "Default Chat ID", - type: "text", - required: false, - placeholder: "-100123456789", - helpText: "Default channel or group chat ID", - }, - ], - docsUrl: "https://core.telegram.org/bots#how-do-i-create-a-bot", - }, - { - id: "azure", - name: "Azure", - description: "Azure service principal or OpenAI endpoint credentials", - icon: "☁️", - fields: [ - { - id: "tenantId", - label: "Tenant ID", - type: "text", - required: false, - placeholder: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", - }, - { - id: "clientId", - label: "Client ID", - type: "text", - required: false, - placeholder: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", - }, - { - id: "clientSecret", - label: "Client Secret", - type: "password", - required: false, - placeholder: "~xxxxxxxx", - }, - { - id: "openAiEndpoint", - label: "Azure OpenAI Endpoint", - type: "url", - required: false, - placeholder: "https://my-resource.openai.azure.com/", - }, - { - id: "openAiApiKey", - label: "Azure OpenAI API Key", - type: "password", - required: false, - placeholder: "xxxxxxxx...", - }, - ], - docsUrl: "https://learn.microsoft.com/en-us/azure/active-directory/develop/quickstart-register-app", - }, - { - id: "slack", - name: "Slack", - description: "Slack bot or webhook token", - icon: "💬", - fields: [ - { - id: "botToken", - label: "Bot Token", - type: "password", - required: false, - placeholder: "xoxb-...", - helpText: "OAuth bot token with chat:write scope", - }, - { - id: "webhookUrl", - label: "Incoming Webhook URL", - type: "url", - required: false, - placeholder: "https://hooks.slack.com/services/...", - helpText: "Alternative to bot token for simple notifications", - }, - ], - docsUrl: "https://api.slack.com/authentication/token-types", - }, - { - id: "linear", - name: "Linear", - description: "Linear API key for issue tracking", - icon: "📐", - fields: [ - { - id: "apiKey", - label: "API Key", - type: "password", - required: true, - placeholder: "lin_api_...", - helpText: "Personal API key from Linear settings", - }, - ], - docsUrl: "https://developers.linear.app/docs/graphql/working-with-the-graphql-api#personal-api-keys", - }, - { - id: "jira", - name: "Jira", - description: "Jira Cloud API token", - icon: "🔷", - fields: [ - { - id: "baseUrl", - label: "Base URL", - type: "url", - required: true, - placeholder: "https://your-org.atlassian.net", - }, - { - id: "email", - label: "Account Email", - type: "text", - required: true, - placeholder: "you@example.com", - }, - { - id: "apiToken", - label: "API Token", - type: "password", - required: true, - placeholder: "ATATT3x...", - helpText: "Generate at id.atlassian.com/manage-profile/security/api-tokens", - }, - ], - docsUrl: "https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/", - }, - { - id: "openai", - name: "OpenAI", - description: "OpenAI API key", - icon: "🤖", - fields: [ - { - id: "apiKey", - label: "API Key", - type: "password", - required: true, - placeholder: "sk-...", - }, - { - id: "organization", - label: "Organization ID", - type: "text", - required: false, - placeholder: "org-...", - }, - ], - docsUrl: "https://platform.openai.com/api-keys", - }, - { - id: "anthropic", - name: "Anthropic", - description: "Anthropic Claude API key", - icon: "🧠", - fields: [ - { - id: "apiKey", - label: "API Key", - type: "password", - required: true, - placeholder: "sk-ant-...", - }, - ], - docsUrl: "https://docs.anthropic.com/en/api/getting-started", - }, - { - id: "env", - name: "Environment Variable", - description: "Generic environment variable secret", - icon: "🔑", - fields: [ - { - id: "key", - label: "Variable Name", - type: "text", - required: true, - placeholder: "MY_API_KEY", - }, - { - id: "value", - label: "Value", - type: "password", - required: true, - placeholder: "secret-value", - }, - ], - }, - { - id: "custom", - name: "Custom", - description: "Custom key-value credential set", - icon: "🛠️", - fields: [ - { - id: "key", - label: "Key", - type: "text", - required: true, - placeholder: "field-name", - }, - { - id: "value", - label: "Value", - type: "password", - required: true, - placeholder: "secret-value", - }, - ], - }, -]; - -/** @returns {IntegrationDef | undefined} */ -export function getIntegration(id) { - return INTEGRATIONS.find((i) => i.id === id); -} - -/** @returns {string[]} */ -export function getIntegrationIds() { - return INTEGRATIONS.map((i) => i.id); -} diff --git a/lib/mojibake-repair.mjs b/lib/mojibake-repair.mjs deleted file mode 100644 index 31087b5e4..000000000 --- a/lib/mojibake-repair.mjs +++ /dev/null @@ -1,40 +0,0 @@ -const MOJIBAKE_REPLACEMENTS = Object.freeze([ - ["ÔÇö", "—"], - ["ÔåÆ", "→"], - ["ÔǪ", "…"], - ["ÔÇ£", "“"], - ["ÔÇ¥", "”"], - ["ÔÇÖ", "’"], - ["Ôǘ", "‘"], - ["ÔÇ¢", "•"], - ["ÔöÇ", "✓"], - ["—", "—"], - ["–", "–"], - ["…", "…"], - ["“", "“"], - ["â€\u009d", "”"], - ["‘", "‘"], - ["’", "’"], - ["•", "•"], - ["→", "→"], - ["✓", "✓"], -]); - -function repairCommonMojibake(value = "") { - let repaired = String(value ?? ""); - for (const [broken, fixed] of MOJIBAKE_REPLACEMENTS) { - if (!repaired.includes(broken)) continue; - repaired = repaired.split(broken).join(fixed); - } - return repaired; -} - -function detectCommonMojibake(value = "") { - const text = String(value ?? ""); - return MOJIBAKE_REPLACEMENTS.some(([broken]) => text.includes(broken)); -} - -export { - detectCommonMojibake, - repairCommonMojibake, -}; diff --git a/lib/session-insights.mjs b/lib/session-insights.mjs index 835f87738..2673fa076 100644 --- a/lib/session-insights.mjs +++ b/lib/session-insights.mjs @@ -225,110 +225,14 @@ function parseContextBreakdown(text) { function normalizeUsage(value) { if (!value || typeof value !== "object") return null; const input = - Number(value.inputTokens ?? value.input_tokens ?? value.promptTokens ?? value.prompt_tokens ?? value.input ?? value.prompt ?? 0) || 0; + Number(value.input_tokens ?? value.prompt_tokens ?? value.input ?? value.prompt ?? 0) || 0; const output = - Number(value.outputTokens ?? value.output_tokens ?? value.completionTokens ?? value.completion_tokens ?? value.output ?? value.completion ?? 0) || 0; - const total = Number(value.totalTokens ?? value.total_tokens ?? value.total ?? input + output) || 0; + Number(value.output_tokens ?? value.completion_tokens ?? value.output ?? value.completion ?? 0) || 0; + const total = Number(value.total_tokens ?? value.total ?? input + output) || 0; if (input <= 0 && output <= 0 && total <= 0) return null; return { input, output, total }; } -function normalizeTokenUsageMeta(meta) { - if (!meta || typeof meta !== "object") return null; - return normalizeUsage( - meta.tokenUsage - || meta.usage - || meta.tokens - || (meta.inputTokens != null || meta.outputTokens != null || meta.totalTokens != null ? meta : null), - ); -} - -function toTimestampMs(value) { - if (value === null || value === undefined || value === "") return null; - const ms = new Date(value).getTime(); - return Number.isFinite(ms) ? ms : null; -} - -function buildTurnTimeline(messages = []) { - const turns = new Map(); - for (const msg of Array.isArray(messages) ? messages : []) { - if (!msg || !Number.isFinite(Number(msg.turnIndex))) continue; - const turnIndex = Number(msg.turnIndex); - const timestamp = String(msg.timestamp || ""); - const tsMs = toTimestampMs(timestamp); - const entry = turns.get(turnIndex) || { - turn: turnIndex + 1, - index: turnIndex + 1, - turnIndex, - startedAt: null, - endedAt: null, - durationMs: 0, - inputTokens: 0, - outputTokens: 0, - totalTokens: 0, - tokenCount: 0, - toolCalls: 0, - toolResults: 0, - assistantMessages: 0, - errors: 0, - assistantPreview: "", - preview: "", - }; - if (tsMs !== null) { - const startedMs = toTimestampMs(entry.startedAt); - const endedMs = toTimestampMs(entry.endedAt); - if (startedMs === null || tsMs < startedMs) entry.startedAt = timestamp; - if (endedMs === null || tsMs > endedMs) entry.endedAt = timestamp; - } - const type = String(msg.type || "").toLowerCase(); - const role = String(msg.role || "").toLowerCase(); - if (type === "tool_call" && String(msg?.meta?.lifecycle || "").toLowerCase() !== "started") { - entry.toolCalls += 1; - } - if (type === "tool_result" || type === "tool_output") { - entry.toolResults += 1; - } - if (type === "error" || type === "stream_error") { - entry.errors += 1; - } - const usage = normalizeUsage(msg?.meta?.usage) || normalizeUsage(msg?.usage) || null; - if (usage) { - entry.inputTokens += usage.input; - entry.outputTokens += usage.output; - entry.totalTokens += usage.total; - } - const content = toText(msg.content).replace(/\s+/g, " ").trim(); - if (role === "assistant" || type === "agent_message" || type === "assistant_message") { - entry.assistantMessages += 1; - if (!entry.assistantPreview) { - entry.assistantPreview = content.slice(0, 180); - } - if (!entry.preview) { - entry.preview = content.slice(0, 140); - } - } else if ((type === "error" || type === "stream_error") && !entry.preview) { - entry.preview = content.slice(0, 140); - } - turns.set(turnIndex, entry); - } - return Array.from(turns.values()) - .sort((a, b) => a.turnIndex - b.turnIndex) - .map((entry) => { - const startedMs = toTimestampMs(entry.startedAt); - const endedMs = toTimestampMs(entry.endedAt); - return { - ...entry, - durationMs: startedMs !== null && endedMs !== null ? Math.max(0, endedMs - startedMs) : 0, - tokenCount: entry.totalTokens, - tokenUsage: { - inputTokens: entry.inputTokens, - outputTokens: entry.outputTokens, - totalTokens: entry.totalTokens, - }, - preview: entry.preview || entry.assistantPreview || `Turn ${entry.turn}`, - }; - }); -} export function formatCompactCount(value) { const n = Number(value || 0); if (!Number.isFinite(n)) return "0"; @@ -384,7 +288,7 @@ export function buildSessionInsights(fullSession = null) { }); } - const usage = normalizeTokenUsageMeta(msg?.meta) || normalizeUsage(msg?.usage) || null; + const usage = normalizeUsage(msg?.meta?.usage) || normalizeUsage(msg?.usage) || null; if (usage) { tokenUsage.inputTokens += usage.input; tokenUsage.outputTokens += usage.output; @@ -454,7 +358,6 @@ export function buildSessionInsights(fullSession = null) { }; } - const turnTimeline = buildTurnTimeline(messages); const derived = { totals: { messages: messages.length, @@ -486,8 +389,6 @@ export function buildSessionInsights(fullSession = null) { contextWindow, contextBreakdown, tokenUsage, - turnTimeline, - turns: turnTimeline, activityDiff: { files: edited.map((entry) => ({ path: entry.path, @@ -516,15 +417,7 @@ export function buildSessionInsights(fullSession = null) { ? persisted.contextBreakdown : derived.contextBreakdown, tokenUsage: persisted.tokenUsage || derived.tokenUsage, - turnTimeline: Array.isArray(persisted.turnTimeline) - ? persisted.turnTimeline - : (Array.isArray(persisted.turns) ? persisted.turns : derived.turnTimeline), - turns: Array.isArray(persisted.turns) - ? persisted.turns - : (Array.isArray(persisted.turnTimeline) ? persisted.turnTimeline : derived.turns), activityDiff: persisted.activityDiff || derived.activityDiff, generatedAt: persisted.generatedAt || derived.generatedAt, }; } - - diff --git a/lib/vault-keychain.mjs b/lib/vault-keychain.mjs deleted file mode 100644 index 80fb4b292..000000000 --- a/lib/vault-keychain.mjs +++ /dev/null @@ -1,259 +0,0 @@ -/** - * Vault Keychain Adapter — OS-native secret storage for the vault master key. - * - * Storage precedence: - * 1. BOSUN_VAULT_KEY env var (hex string, 32 bytes) — CI / container override - * 2. Windows Credential Manager (via PowerShell) - * 3. macOS Keychain (via `security` CLI) - * 4. Linux Secret Service (via `secret-tool` CLI) - * - * All operations are synchronous (execSync) to keep callers simple. - */ - -import { execFileSync } from "node:child_process"; -import { randomBytes } from "node:crypto"; - -const SERVICE_NAME = "bosun-vault"; -const ACCOUNT_NAME = "master-key"; - -// ─── Platform detection ──────────────────────────────────────────────────────── - -function platform() { - return process.platform; // "win32" | "darwin" | "linux" -} - -// ─── Windows Credential Manager ─────────────────────────────────────────────── - -function winRead() { - try { - const ps = ` -[Net.ServicePointManager]::SecurityProtocol = 'Tls12' -$cred = Get-StoredCredential -Target '${SERVICE_NAME}' -ErrorAction SilentlyContinue -if ($cred) { $cred.GetNetworkCredential().Password } else { '' } -`.trim(); - // Try CredentialManager module first (may not be installed) - const result = execFileSync( - "powershell", - ["-NoProfile", "-NonInteractive", "-Command", ps], - { encoding: "utf8", timeout: 10_000 } - ).trim(); - return result || null; - } catch { - return winReadFallback(); - } -} - -function winReadFallback() { - try { - // Use Windows Credential Manager via DPAPI directly - const ps = ` -Add-Type -AssemblyName System.Security -$cm = [System.Security.Cryptography.ProtectedData] -try { - $target = '${SERVICE_NAME}/${ACCOUNT_NAME}' - $cred = [System.Net.CredentialCache]::DefaultNetworkCredentials - # Fall back: read from generic credential store - $sig = @' -[DllImport("advapi32.dll", EntryPoint="CredReadW", CharSet=CharSet.Unicode, SetLastError=true)] -public static extern bool CredRead(string target, uint type, int reservedFlag, out IntPtr credentialPtr); -[DllImport("advapi32.dll")] -public static extern void CredFree([In] IntPtr cred); -'@ - $WinCred = Add-Type -MemberDefinition $sig -Namespace "WinCred" -Name "NativeMethods" -PassThru - $credPtr = [IntPtr]::Zero - if ($WinCred::CredRead($target, 1, 0, [ref]$credPtr)) { - $cred = [System.Runtime.InteropServices.Marshal]::PtrToStructure($credPtr, [type][System.Net.NetworkCredential]) - Write-Output $cred.Password - $WinCred::CredFree($credPtr) - } -} catch { } -`.trim(); - const result = execFileSync( - "powershell", - ["-NoProfile", "-NonInteractive", "-Command", ps], - { encoding: "utf8", timeout: 10_000 } - ).trim(); - return result || null; - } catch { - return null; - } -} - -function winWrite(hexKey) { - try { - const ps = ` -$target = '${SERVICE_NAME}/${ACCOUNT_NAME}' -$pass = ConvertTo-SecureString $env:BOSUN_VAULT_HEXKEY -AsPlainText -Force -$cred = New-Object System.Management.Automation.PSCredential ($target, $pass) -Add-Type -AssemblyName System.Security -$sig = @' -[DllImport("advapi32.dll", EntryPoint="CredWriteW", CharSet=CharSet.Unicode, SetLastError=true)] -public static extern bool CredWrite([In] ref CREDENTIAL userCredential, [In] uint flags); -[StructLayout(LayoutKind.Sequential, CharSet=CharSet.Unicode)] -public struct CREDENTIAL { - public uint Flags; public uint Type; public string TargetName; - public string Comment; public System.Runtime.InteropServices.ComTypes.FILETIME LastWritten; - public uint CredentialBlobSize; public IntPtr CredentialBlob; public uint Persist; - public uint AttributeCount; public IntPtr Attributes; public string TargetAlias; public string UserName; -} -'@ -$WinCred = Add-Type -MemberDefinition $sig -Namespace "WinCred2" -Name "NativeMethods" -PassThru -$blob = [System.Text.Encoding]::Unicode.GetBytes($env:BOSUN_VAULT_HEXKEY) -$blobPtr = [System.Runtime.InteropServices.Marshal]::AllocHGlobal($blob.Length) -[System.Runtime.InteropServices.Marshal]::Copy($blob, 0, $blobPtr, $blob.Length) -$credential = New-Object WinCred2.NativeMethods+CREDENTIAL -$credential.TargetName = $target; $credential.UserName = 'bosun'; $credential.Type = 1 -$credential.Persist = 2; $credential.CredentialBlob = $blobPtr; $credential.CredentialBlobSize = $blob.Length -$WinCred::CredWrite([ref]$credential, 0) | Out-Null -[System.Runtime.InteropServices.Marshal]::FreeHGlobal($blobPtr) -`.trim(); - execFileSync( - "powershell", - ["-NoProfile", "-NonInteractive", "-Command", ps], - { - encoding: "utf8", - timeout: 10_000, - stdio: ["ignore", "ignore", "ignore"], - env: { ...process.env, BOSUN_VAULT_HEXKEY: hexKey }, - } - ); - return true; - } catch { - return false; - } -} - -// ─── macOS Keychain ──────────────────────────────────────────────────────────── - -function macRead() { - try { - const result = execFileSync( - "security", - ["find-generic-password", "-s", SERVICE_NAME, "-a", ACCOUNT_NAME, "-w"], - { encoding: "utf8", timeout: 10_000, stdio: ["ignore", "pipe", "ignore"] } - ).trim(); - return result || null; - } catch { - return null; - } -} - -function macWrite(hexKey) { - try { - // Delete existing first to avoid duplicate errors - try { - execFileSync( - "security", - ["delete-generic-password", "-s", SERVICE_NAME, "-a", ACCOUNT_NAME], - { timeout: 5_000, stdio: "ignore" } - ); - } catch { /* not found — ok */ } - execFileSync( - "security", - ["add-generic-password", "-s", SERVICE_NAME, "-a", ACCOUNT_NAME, "-w", hexKey], - { encoding: "utf8", timeout: 10_000, stdio: "ignore" } - ); - return true; - } catch { - return false; - } -} - -// ─── Linux Secret Service (secret-tool) ─────────────────────────────────────── - -function linuxRead() { - try { - const result = execFileSync( - "secret-tool", - ["lookup", "service", SERVICE_NAME, "account", ACCOUNT_NAME], - { encoding: "utf8", timeout: 10_000, stdio: ["ignore", "pipe", "ignore"] } - ).trim(); - return result || null; - } catch { - return null; - } -} - -function linuxWrite(hexKey) { - try { - execFileSync( - "secret-tool", - ["store", "--label=Bosun Vault Master Key", "service", SERVICE_NAME, "account", ACCOUNT_NAME], - { - input: hexKey, - encoding: "utf8", - timeout: 10_000, - stdio: ["pipe", "ignore", "ignore"], - } - ); - return true; - } catch { - return false; - } -} - -// ─── Public API ──────────────────────────────────────────────────────────────── - -/** - * Read the vault master key from the OS keychain (or env var). - * Returns a 32-byte Buffer or null if not found. - */ -export function keychainRead() { - // Highest-priority override: env var - if (process.env.BOSUN_VAULT_KEY) { - const buf = Buffer.from(process.env.BOSUN_VAULT_KEY, "hex"); - if (buf.length === 32) return buf; - } - - let hex = null; - if (platform() === "win32") hex = winRead(); - else if (platform() === "darwin") hex = macRead(); - else hex = linuxRead(); - - if (!hex || hex.length !== 64) return null; - return Buffer.from(hex, "hex"); -} - -/** - * Write the vault master key to the OS keychain. - * @param {Buffer} key — 32-byte key - * @returns {boolean} true on success - */ -export function keychainWrite(key) { - if (!Buffer.isBuffer(key) || key.length !== 32) { - throw new Error("Key must be a 32-byte Buffer"); - } - const hex = key.toString("hex"); - if (platform() === "win32") return winWrite(hex); - if (platform() === "darwin") return macWrite(hex); - return linuxWrite(hex); -} - -/** - * Generate a new random 32-byte master key and store it in the OS keychain. - * @returns {Buffer} the new key - */ -export function keychainGenerateAndStore() { - const key = randomBytes(32); - const ok = keychainWrite(key); - if (!ok) { - throw new Error( - "Failed to store vault key in OS keychain. " + - "Set BOSUN_VAULT_KEY env var (64-char hex) as a fallback." - ); - } - return key; -} - -/** - * Attempt to read the key; generate and store a new one if not found. - * Useful for first-run setup. - * @returns {{ key: Buffer, created: boolean }} - */ -export function keychainGetOrCreate() { - const existing = keychainRead(); - if (existing) return { key: existing, created: false }; - const key = keychainGenerateAndStore(); - return { key, created: true }; -} - diff --git a/lib/vault.mjs b/lib/vault.mjs deleted file mode 100644 index e1e36dbb4..000000000 --- a/lib/vault.mjs +++ /dev/null @@ -1,374 +0,0 @@ -/** - * Bosun Vault — AES-256-GCM encrypted credential store. - * - * Storage: ~/.bosun-vault/vault.enc - * Envelope: { v: 1, iv: "", tag: "", data: "" } - * Plaintext: { secrets: {...}, env: {...}, mcpRefs: {...} } - * - * The master key is managed by lib/vault-keychain.mjs. - */ - -import { createCipheriv, createDecipheriv, randomBytes } from "node:crypto"; -import { - existsSync, - mkdirSync, - readFileSync, - writeFileSync, -} from "node:fs"; -import { homedir } from "node:os"; -import { join } from "node:path"; -import { randomUUID } from "node:crypto"; - -const VAULT_VERSION = 1; -const VAULT_DIR = join(homedir(), ".bosun-vault"); -const VAULT_PATH = join(VAULT_DIR, "vault.enc"); -const KEY_BYTES = 32; // 256-bit -const IV_BYTES = 12; // 96-bit GCM nonce -const TAG_BYTES = 16; - -// ─── Encryption helpers ──────────────────────────────────────────────────────── - -function encrypt(key, plaintext) { - const iv = randomBytes(IV_BYTES); - const cipher = createCipheriv("aes-256-gcm", key, iv); - const enc = Buffer.concat([cipher.update(plaintext, "utf8"), cipher.final()]); - const tag = cipher.getAuthTag(); - return { - iv: iv.toString("hex"), - tag: tag.toString("hex"), - data: enc.toString("hex"), - }; -} - -function decrypt(key, iv, tag, data) { - const decipher = createDecipheriv( - "aes-256-gcm", - key, - Buffer.from(iv, "hex") - ); - decipher.setAuthTag(Buffer.from(tag, "hex")); - const dec = Buffer.concat([ - decipher.update(Buffer.from(data, "hex")), - decipher.final(), - ]); - return dec.toString("utf8"); -} - -// ─── Persistence helpers ─────────────────────────────────────────────────────── - -function readEnvelope() { - if (!existsSync(VAULT_PATH)) return null; - return JSON.parse(readFileSync(VAULT_PATH, "utf8")); -} - -function writeEnvelope(envelope) { - if (!existsSync(VAULT_DIR)) mkdirSync(VAULT_DIR, { recursive: true }); - writeFileSync(VAULT_PATH, JSON.stringify(envelope), "utf8"); -} - -// ─── Empty vault payload ─────────────────────────────────────────────────────── - -function emptyPayload() { - return { secrets: {}, env: {}, mcpRefs: {} }; -} - -// ─── VaultStore class ────────────────────────────────────────────────────────── - -export class VaultStore { - constructor() { - this._key = null; // Buffer(32) when unlocked - this._data = null; // decrypted payload object - } - - // ── Lifecycle ──────────────────────────────────────────────────────────────── - - /** Returns true when the vault file exists. */ - isInitialized() { - return existsSync(VAULT_PATH); - } - - /** Returns true when the vault is unlocked (key loaded in memory). */ - isUnlocked() { - return this._key !== null && this._data !== null; - } - - /** - * Initialize a brand-new vault with the given 32-byte key. - * Throws if vault already exists. - */ - init(key) { - if (this.isInitialized()) { - throw new Error("Vault already initialized. Use open() to unlock it."); - } - this._key = this._validateKey(key); - this._data = emptyPayload(); - this._flush(); - return this; - } - - /** - * Open (unlock) an existing vault with the given key. - * Throws if vault does not exist or key is wrong. - */ - open(key) { - const envelope = readEnvelope(); - if (!envelope) { - throw new Error("Vault not initialized. Call init() first."); - } - if (envelope.v !== VAULT_VERSION) { - throw new Error(`Unsupported vault version: ${envelope.v}`); - } - this._key = this._validateKey(key); - const plaintext = decrypt(this._key, envelope.iv, envelope.tag, envelope.data); - this._data = JSON.parse(plaintext); - return this; - } - - /** Lock the vault — clears the key and decrypted data from memory. */ - seal() { - if (this._key) this._key.fill(0); - this._key = null; - this._data = null; - } - - // ── Secrets ────────────────────────────────────────────────────────────────── - - /** - * List all secrets (without field values). - * @returns {{ id, name, integration, label, permissions, createdAt, updatedAt }[]} - */ - listSecrets() { - this._requireUnlocked(); - return Object.values(this._data.secrets).map((s) => ({ - id: s.id, - name: s.name, - integration: s.integration, - label: s.label, - permissions: s.permissions, - createdAt: s.createdAt, - updatedAt: s.updatedAt, - })); - } - - /** - * Get a secret including its decrypted field values. - */ - getSecret(id) { - this._requireUnlocked(); - const s = this._data.secrets[id]; - if (!s) throw new Error(`Secret not found: ${id}`); - return { ...s }; - } - - /** - * Create a new secret. - * @param {{ name, integration, label, fields, permissions }} opts - * @returns {string} new secret id - */ - createSecret({ name, integration, label, fields, permissions } = {}) { - this._requireUnlocked(); - const id = randomUUID(); - const now = new Date().toISOString(); - this._data.secrets[id] = { - id, - name: name ?? "Unnamed", - integration: integration ?? "custom", - label: label ?? "", - fields: fields ?? {}, - permissions: permissions ?? { agents: ["*"], workflows: ["*"], deny: [] }, - createdAt: now, - updatedAt: now, - }; - this._flush(); - return id; - } - - /** - * Update an existing secret's name/label/fields. - */ - updateSecret(id, { name, label, fields, permissions } = {}) { - this._requireUnlocked(); - const s = this._data.secrets[id]; - if (!s) throw new Error(`Secret not found: ${id}`); - if (name !== undefined) s.name = name; - if (label !== undefined) s.label = label; - if (fields !== undefined) s.fields = { ...s.fields, ...fields }; - if (permissions !== undefined) s.permissions = permissions; - s.updatedAt = new Date().toISOString(); - this._flush(); - } - - /** - * Delete a secret by id. - */ - deleteSecret(id) { - this._requireUnlocked(); - if (!this._data.secrets[id]) throw new Error(`Secret not found: ${id}`); - delete this._data.secrets[id]; - // Remove any mcpRefs pointing to this secret - for (const [k, v] of Object.entries(this._data.mcpRefs)) { - if (v === id) delete this._data.mcpRefs[k]; - } - this._flush(); - } - - /** - * Update RBAC permissions for a secret. - * @param {string} id - * @param {{ agents?: string[], workflows?: string[], deny?: string[] }} permissions - */ - setPermissions(id, permissions) { - this._requireUnlocked(); - const s = this._data.secrets[id]; - if (!s) throw new Error(`Secret not found: ${id}`); - s.permissions = { agents: ["*"], workflows: ["*"], deny: [], ...permissions }; - s.updatedAt = new Date().toISOString(); - this._flush(); - } - - // ── Env vars ───────────────────────────────────────────────────────────────── - - /** - * List all env var keys stored in the vault (no values). - */ - listEnvKeys() { - this._requireUnlocked(); - return Object.keys(this._data.env); - } - - /** - * Get an env var value. - */ - getEnv(key) { - this._requireUnlocked(); - return this._data.env[key]; - } - - /** - * Set (create or update) an env var. - */ - setEnv(key, value) { - this._requireUnlocked(); - this._data.env[key] = value; - this._flush(); - } - - /** - * Delete an env var. - */ - deleteEnv(key) { - this._requireUnlocked(); - delete this._data.env[key]; - this._flush(); - } - - // ── RBAC helpers ───────────────────────────────────────────────────────────── - - /** - * Check whether an agent is allowed to access a secret. - * @param {string} secretId - * @param {string} agentId - */ - canAgentAccess(secretId, agentId) { - const s = this._data?.secrets?.[secretId]; - if (!s) return false; - const { agents = ["*"], deny = [] } = s.permissions ?? {}; - if (deny.includes(agentId) || deny.includes("*")) return false; - return agents.includes("*") || agents.includes(agentId); - } - - /** - * Check whether a workflow is allowed to access a secret. - */ - canWorkflowAccess(secretId, workflowId) { - const s = this._data?.secrets?.[secretId]; - if (!s) return false; - const { workflows = ["*"], deny = [] } = s.permissions ?? {}; - if (deny.includes(workflowId) || deny.includes("*")) return false; - return workflows.includes("*") || workflows.includes(workflowId); - } - - // ── Process env injection ───────────────────────────────────────────────────── - - /** - * Merge vault env vars into a plain object suitable for process.env injection. - * Only includes keys not already present in the provided base env. - * @param {Record} [baseEnv] — defaults to {} - * @returns {Record} - */ - resolveEnv(baseEnv = {}) { - if (!this.isUnlocked()) return {}; - const out = {}; - for (const [k, v] of Object.entries(this._data.env)) { - if (!(k in baseEnv)) out[k] = v; - } - return out; - } - - /** - * Resolve env vars that the given agentId is allowed to access. - * Right now env vars are not RBAC-scoped (unlike secrets), but - * this method is exposed for future scoping. - */ - resolveEnvForAgent(_agentId, baseEnv = {}) { - return this.resolveEnv(baseEnv); - } - - // ── MCP refs ────────────────────────────────────────────────────────────────── - - /** - * Link an MCP env key to a secret id. - * e.g. "github.GITHUB_PERSONAL_ACCESS_TOKEN" → "" - */ - setMcpRef(mcpKey, secretId) { - this._requireUnlocked(); - this._data.mcpRefs[mcpKey] = secretId; - this._flush(); - } - - getMcpRef(mcpKey) { - this._requireUnlocked(); - return this._data.mcpRefs[mcpKey] ?? null; - } - - // ── Status ──────────────────────────────────────────────────────────────────── - - status() { - return { - initialized: this.isInitialized(), - unlocked: this.isUnlocked(), - secretCount: this.isUnlocked() ? Object.keys(this._data.secrets).length : null, - envCount: this.isUnlocked() ? Object.keys(this._data.env).length : null, - }; - } - - // ── Internal ────────────────────────────────────────────────────────────────── - - _requireUnlocked() { - if (!this.isUnlocked()) throw new Error("Vault is locked. Call open(key) first."); - } - - _validateKey(key) { - if (Buffer.isBuffer(key) && key.length === KEY_BYTES) return key; - if (typeof key === "string") { - const buf = Buffer.from(key, "hex"); - if (buf.length === KEY_BYTES) return buf; - } - throw new Error(`Vault key must be a 32-byte Buffer or 64-char hex string (got ${typeof key}).`); - } - - _flush() { - const plaintext = JSON.stringify(this._data); - const { iv, tag, data } = encrypt(this._key, plaintext); - writeEnvelope({ v: VAULT_VERSION, iv, tag, data }); - } -} - -// Shared singleton for use in server-side code -let _defaultVault = null; -export function getDefaultVault() { - if (!_defaultVault) _defaultVault = new VaultStore(); - return _defaultVault; -} - -export { VAULT_PATH, VAULT_DIR, KEY_BYTES }; diff --git a/package-lock.json b/package-lock.json index 4e92bd1fb..f4206912d 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,19 +1,18 @@ { "name": "bosun", - "version": "0.42.6", + "version": "0.42.5", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "bosun", - "version": "0.42.6", + "version": "0.42.5", "hasInstallScript": true, "license": "Apache-2.0", "dependencies": { "@anthropic-ai/claude-agent-sdk": "latest", "@github/copilot-sdk": "latest", "@google/genai": "^1.44.0", - "@jridgewell/sourcemap-codec": "^1.5.5", "@modelcontextprotocol/sdk": "^1.26.0", "@openai/agents": "^0.5.2", "@openai/codex-sdk": "latest", @@ -57,7 +56,6 @@ "telegram-sentinel": "telegram/telegram-sentinel.mjs" }, "devDependencies": { - "@alcalzone/ansi-tokenize": "^0.1.3", "@emotion/react": "^11.14.0", "@emotion/styled": "^11.14.1", "@mui/material": "^5.18.0", @@ -1589,6 +1587,7 @@ "version": "1.5.5", "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz", "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==", + "dev": true, "license": "MIT" }, "node_modules/@jridgewell/trace-mapping": { @@ -3593,9 +3592,9 @@ } }, "node_modules/cosmiconfig/node_modules/yaml": { - "version": "1.10.3", - "resolved": "https://registry.npmjs.org/yaml/-/yaml-1.10.3.tgz", - "integrity": "sha512-vIYeF1u3CjlhAFekPPAk2h/Kv4T3mAkMox5OymRiJQB0spDP10LHvt+K7G9Ny6NuuMAb25/6n1qyUjAcGNf/AA==", + "version": "1.10.2", + "resolved": "https://registry.npmjs.org/yaml/-/yaml-1.10.2.tgz", + "integrity": "sha512-r3vXyErRCYJ7wg28yvBY5VSoAF8ZvlcW9/BwUzEtUsjvX/DKs24dIkuwjtuprwJJHsbyUbLApepYTR1BN4uHrg==", "dev": true, "license": "ISC", "engines": { @@ -5167,9 +5166,9 @@ "license": "MIT" }, "node_modules/path-to-regexp": { - "version": "8.4.0", - "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-8.4.0.tgz", - "integrity": "sha512-PuseHIvAnz3bjrM2rGJtSgo1zjgxapTLZ7x2pjhzWwlp4SJQgK3f3iZIQwkpEnBaKz6seKBADpM4B4ySkuYypg==", + "version": "8.3.0", + "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-8.3.0.tgz", + "integrity": "sha512-7jdwVIRtsP8MYpdXSwOS0YdD0Du+qOoF/AEPIt88PcCFrZCzx41oxku1jD88hZBwbNUIEfpqvuhjFaMAqMTWnA==", "license": "MIT", "funding": { "type": "opencollective", diff --git a/package.json b/package.json index cd7c16c0c..98b140c7d 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "bosun", - "version": "0.42.6", + "version": "0.42.5", "description": "Bosun Autonomous Engineering — manages AI agent executors with failover, extremely powerful workflow builder, and a massive amount of included default workflow templates for autonomous engineering, creates PRs via GitHub/Jira APIs, and sends Telegram notifications. Supports N executors with weighted distribution, multi-repo projects, and auto-setup.", "type": "module", "license": "Apache-2.0", @@ -149,8 +149,7 @@ "mutate": "npx stryker run", "mutate:incremental": "npx stryker run --incremental", "mutate:report": "node scripts/mutation-report.mjs", - "mutate:scoped": "npx stryker run --mutate", - "lint": "npm run syntax:check && npm run prompt:lint" + "mutate:scoped": "npx stryker run --mutate" }, "files": [ ".env.example", @@ -181,10 +180,9 @@ "agent/primary-agent.mjs", "agent/retry-queue.mjs", "agent/review-agent.mjs", - "agent/skills/", + "agent/skills/skill-codebase-audit.md", "bench/benchmark-mode.mjs", "bench/benchmark-registry.mjs", - "bench/eval-framework.mjs", "bench/swebench/bosun-swebench.mjs", "bosun-tui.mjs", "bosun.config.example.json", @@ -225,9 +223,7 @@ "infra/desktop-shortcut.mjs", "infra/error-detector.mjs", "infra/fetch-runtime.mjs", - "infra/guardrails.mjs", "infra/health-status.mjs", - "infra/heartbeat-monitor.mjs", "infra/library-manager-utils.mjs", "infra/library-manager-well-known-sources.mjs", "infra/library-manager.mjs", @@ -250,12 +246,8 @@ "kanban/kanban-adapter.mjs", "lib/codebase-audit-manifests.mjs", "lib/codebase-audit.mjs", - "lib/integrations-registry.mjs", "lib/logger.mjs", - "lib/mojibake-repair.mjs", "lib/session-insights.mjs", - "lib/vault-keychain.mjs", - "lib/vault.mjs", "merge-strategy.mjs", "monitor-tail-sanitizer.mjs", "postinstall.mjs", @@ -369,38 +361,36 @@ "@anthropic-ai/claude-agent-sdk": "latest", "@github/copilot-sdk": "latest", "@google/genai": "^1.44.0", - "@jridgewell/sourcemap-codec": "^1.5.5", "@modelcontextprotocol/sdk": "^1.26.0", "@openai/agents": "^0.5.2", "@openai/codex-sdk": "latest", "@opencode-ai/sdk": "latest", - "@opentelemetry/api": "^1.9.0", - "@opentelemetry/exporter-trace-otlp-http": "^0.206.0", - "@opentelemetry/resources": "^2.1.0", - "@opentelemetry/sdk-metrics": "^2.1.0", - "@opentelemetry/sdk-trace-base": "^2.1.0", - "@opentelemetry/semantic-conventions": "^1.37.0", "@preact/signals": "1.3.1", "@whiskeysockets/baileys": "^7.0.0-rc.9", "ajv": "^8.18.0", "es-module-shims": "^2.8.0", "express": "^5.1.0", "express-rate-limit": "^8.0.0", - "figures": "^6.1.0", "hono": "^4.12.7", "htm": "3.1.1", "ink": "^5.0.0", "ink-text-input": "^6.0.0", "preact": "10.25.4", "qrcode-terminal": "^0.12.0", + "ws": "^8.19.0", + "@opentelemetry/api": "^1.9.0", + "@opentelemetry/exporter-trace-otlp-http": "^0.206.0", + "@opentelemetry/resources": "^2.1.0", + "@opentelemetry/sdk-metrics": "^2.1.0", + "@opentelemetry/sdk-trace-base": "^2.1.0", + "@opentelemetry/semantic-conventions": "^1.37.0", + "figures": "^6.1.0", "react": "^18.3.1", - "react-dom": "^18.3.1", - "ws": "^8.19.0" + "react-dom": "^18.3.1" }, "devDependencies": { "@emotion/react": "^11.14.0", "@emotion/styled": "^11.14.1", - "@alcalzone/ansi-tokenize": "^0.1.3", "@mui/material": "^5.18.0", "@playwright/test": "^1.58.2", "playwright": "^1.58.2", diff --git a/playwright.config.mjs b/playwright.config.mjs index c814b991b..84a4d290f 100644 --- a/playwright.config.mjs +++ b/playwright.config.mjs @@ -1,9 +1,4 @@ -import * as playwrightTest from "@playwright/test"; - -const defineConfig = - playwrightTest.defineConfig ?? - playwrightTest.default?.defineConfig ?? - ((config) => config); +import { defineConfig } from "@playwright/test"; export default defineConfig({ testDir: "server", diff --git a/postinstall.mjs b/postinstall.mjs index 3d2dfb713..604ec9c53 100644 --- a/postinstall.mjs +++ b/postinstall.mjs @@ -36,10 +36,6 @@ const BUNDLED_PWSH_PATH = resolve(BUNDLED_PWSH_DIR, "pwsh"); const FALLBACK_PWSH_VERSION = "7.4.6"; const require = createRequire(import.meta.url); -function resolveNpmCommand() { - return process.platform === "win32" ? "npm.cmd" : "npm"; -} - // ── Helpers ────────────────────────────────────────────────────────────────── function commandExists(cmd) { @@ -377,7 +373,7 @@ async function main() { console.log(""); console.log(" ▸ Installing desktop dependencies (Electron)..."); try { - execSync(`${resolveNpmCommand()} install`, { + execSync("npm install", { cwd: desktopDir, stdio: "inherit", timeout: 0, @@ -448,7 +444,3 @@ async function main() { main().catch((err) => { console.error(` :alert: postinstall failed: ${err.message}`); }); - - - - diff --git a/prs-open.json b/prs-open.json deleted file mode 100644 index 78b4e35bf..000000000 --- a/prs-open.json +++ /dev/null @@ -1 +0,0 @@ -[{"headRefName":"guardrails","isDraft":false,"number":457,"state":"OPEN","title":"feat(Guardrails): add guardrails feature to Bosun","url":"https://github.com/virtengine/bosun/pull/457"},{"headRefName":"repair/pr437","isDraft":false,"number":456,"state":"OPEN","title":"Repair/pr437","url":"https://github.com/virtengine/bosun/pull/456"},{"headRefName":"task/a5787873546b-m-reliability-auto-update-failure-circuit-breake","isDraft":false,"number":455,"state":"OPEN","title":"[m] reliability: auto-update failure circuit breaker","url":"https://github.com/virtengine/bosun/pull/455"},{"headRefName":"task/ac13245d3271-feat-agents-copy-to-clipboard-session-id-pill-bu","isDraft":false,"number":454,"state":"OPEN","title":"feat(agents): copy-to-clipboard session ID pill button in agents table","url":"https://github.com/virtengine/bosun/pull/454"},{"headRefName":"task/eb0893c6b815-feat-tui-help-screen-and-keyboard-shortcut-refer","isDraft":false,"number":453,"state":"OPEN","title":"feat(tui): Help screen and keyboard shortcut reference overlay","url":"https://github.com/virtengine/bosun/pull/453"},{"headRefName":"pr-443-fix","isDraft":false,"number":452,"state":"OPEN","title":"fix/pr 443 ci/cd failures","url":"https://github.com/virtengine/bosun/pull/452"},{"headRefName":"task/bc219832c3a1-feat-eval-agent-evaluation-benchmarking-framewor","isDraft":false,"number":451,"state":"OPEN","title":"feat(eval): Agent Evaluation & Benchmarking Framework ÔÇö data-driven agent optimization","url":"https://github.com/virtengine/bosun/pull/451"},{"headRefName":"task/493ae5e42027-feat-css-tabular-numerals-on-all-numeric-portal-","isDraft":false,"number":450,"state":"OPEN","title":"feat(css): tabular numerals on all numeric portal outputs","url":"https://github.com/virtengine/bosun/pull/450"},{"headRefName":"task/b3364eceda27-feat-portal-live-websocket-connection-badge-in-p","isDraft":false,"number":449,"state":"OPEN","title":"feat(portal): live WebSocket connection badge in portal header","url":"https://github.com/virtengine/bosun/pull/449"},{"headRefName":"task/e69d47108981-feat-agents-input-output-token-split-display-per","isDraft":false,"number":448,"state":"OPEN","title":"feat(agents): input/output token split display per active session row","url":"https://github.com/virtengine/bosun/pull/448"},{"headRefName":"task/f8180f1d37de-feat-agents-live-session-turn-counter-alongside-","isDraft":false,"number":446,"state":"OPEN","title":"feat(agents): live session turn counter alongside runtime timer","url":"https://github.com/virtengine/bosun/pull/446"},{"headRefName":"task/cfd631a87666-feat-tui-session-detail-modal-full-session-drill","isDraft":false,"number":445,"state":"OPEN","title":"feat(tui): Session Detail modal ÔÇö full session drill-down with turn timeline and diff","url":"https://github.com/virtengine/bosun/pull/445"},{"headRefName":"task/56b361530b9c-feat-agent-add-mcp-tool-overhead-visibility-and-","isDraft":false,"number":443,"state":"OPEN","title":"feat(agent): add MCP tool overhead visibility and logging","url":"https://github.com/virtengine/bosun/pull/443"},{"headRefName":"task/3cc669aec7e8-feat-tui-telemetry-screen-ascii-sparklines-provi","isDraft":false,"number":441,"state":"OPEN","title":"feat(tui): Telemetry screen ÔÇö ASCII sparklines, provider stats, rate-limit heatmap, cost tracker","url":"https://github.com/virtengine/bosun/pull/441"},{"headRefName":"task/4567dec9f7e3-feat-tui-workflows-screen-list-trigger-inspect-a","isDraft":false,"number":440,"state":"OPEN","title":"feat(tui): Workflows screen list, trigger, inspect, and cancel workflow runs from terminal","url":"https://github.com/virtengine/bosun/pull/440"},{"headRefName":"task/3ad658101698-feat-tui-settings-screen-read-edit-bosun-config-","isDraft":false,"number":439,"state":"OPEN","title":"feat(tui): Settings screen read/edit bosun.config.json fields inline with validation","url":"https://github.com/virtengine/bosun/pull/439"},{"headRefName":"task/2316d3215b65-feat-tui-command-palette-fuzzy-find-any-action-w","isDraft":false,"number":438,"state":"OPEN","title":"feat(tui): Command palette fuzzy-find any action with Ctrl+P or : prefix","url":"https://github.com/virtengine/bosun/pull/438"},{"headRefName":"task/76cc7f25b5f2-m-feat-workflow-add-delegation-watchdog-to-auto-","isDraft":false,"number":437,"state":"OPEN","title":"[m] feat(workflow): add delegation watchdog to auto-recover stalled non-task nodes","url":"https://github.com/virtengine/bosun/pull/437"},{"headRefName":"task/3142f12b27d3-m-feat-workflow-add-delegation-audit-trail-and-r","isDraft":false,"number":436,"state":"OPEN","title":"[m] feat(workflow): add delegation audit trail and replay-safe state transitions","url":"https://github.com/virtengine/bosun/pull/436"},{"headRefName":"task/cc3da1b76df6-m-feat-task-enforce-task-batch-payload-schema-va","isDraft":false,"number":435,"state":"OPEN","title":"[m] feat(task): enforce task-batch payload schema validation at runtime boundaries","url":"https://github.com/virtengine/bosun/pull/435"}] diff --git a/prs.json b/prs.json deleted file mode 100644 index bade33fa2..000000000 --- a/prs.json +++ /dev/null @@ -1 +0,0 @@ -[{"baseRefName":"main","headRefName":"dependabot/npm_and_yarn/npm_and_yarn-7fa4943c34","isDraft":false,"mergedAt":"2026-03-28T21:56:53Z","number":464,"state":"MERGED","title":"chore(deps): bump path-to-regexp from 8.3.0 to 8.4.0 in the npm_and_yarn group across 1 directory","url":"https://github.com/virtengine/bosun/pull/464"},{"baseRefName":"main","headRefName":"repair/pr457-cwd-fallback","isDraft":false,"mergedAt":null,"number":463,"state":"CLOSED","title":"Repair/pr457 cwd fallback","url":"https://github.com/virtengine/bosun/pull/463"},{"baseRefName":"main","headRefName":"continue/add-continue-env-config","isDraft":false,"mergedAt":"2026-03-28T17:09:10Z","number":462,"state":"MERGED","title":"chore: add Continue environment configuration","url":"https://github.com/virtengine/bosun/pull/462"},{"baseRefName":"main","headRefName":"codex/site-demo-sync","isDraft":false,"mergedAt":"2026-03-27T19:34:04Z","number":461,"state":"MERGED","title":"Codex/site demo sync","url":"https://github.com/virtengine/bosun/pull/461"},{"baseRefName":"main","headRefName":"codex/site-demo-sync","isDraft":false,"mergedAt":null,"number":460,"state":"CLOSED","title":"Codex/site demo sync","url":"https://github.com/virtengine/bosun/pull/460"},{"baseRefName":"main","headRefName":"task/93cd6f915fef-s-preflight-detect-interactive-git-editor-and-gu","isDraft":false,"mergedAt":"2026-03-27T06:41:14Z","number":459,"state":"MERGED","title":"[s] preflight: detect interactive git editor and guide remediation","url":"https://github.com/virtengine/bosun/pull/459"},{"baseRefName":"main","headRefName":"codex/site-demo-sync","isDraft":false,"mergedAt":"2026-03-26T16:24:35Z","number":458,"state":"MERGED","title":"fix(site): demo site UI CSS resolution","url":"https://github.com/virtengine/bosun/pull/458"},{"baseRefName":"main","headRefName":"guardrails","isDraft":false,"mergedAt":null,"number":457,"state":"OPEN","title":"feat(Guardrails): add guardrails feature to Bosun","url":"https://github.com/virtengine/bosun/pull/457"},{"baseRefName":"main","headRefName":"repair/pr437","isDraft":false,"mergedAt":null,"number":456,"state":"OPEN","title":"Repair/pr437","url":"https://github.com/virtengine/bosun/pull/456"},{"baseRefName":"main","headRefName":"task/a5787873546b-m-reliability-auto-update-failure-circuit-breake","isDraft":false,"mergedAt":null,"number":455,"state":"OPEN","title":"[m] reliability: auto-update failure circuit breaker","url":"https://github.com/virtengine/bosun/pull/455"},{"baseRefName":"main","headRefName":"task/ac13245d3271-feat-agents-copy-to-clipboard-session-id-pill-bu","isDraft":false,"mergedAt":null,"number":454,"state":"OPEN","title":"feat(agents): copy-to-clipboard session ID pill button in agents table","url":"https://github.com/virtengine/bosun/pull/454"},{"baseRefName":"main","headRefName":"task/eb0893c6b815-feat-tui-help-screen-and-keyboard-shortcut-refer","isDraft":false,"mergedAt":null,"number":453,"state":"OPEN","title":"feat(tui): Help screen and keyboard shortcut reference overlay","url":"https://github.com/virtengine/bosun/pull/453"},{"baseRefName":"main","headRefName":"pr-443-fix","isDraft":false,"mergedAt":null,"number":452,"state":"OPEN","title":"fix/pr 443 ci/cd failures","url":"https://github.com/virtengine/bosun/pull/452"},{"baseRefName":"main","headRefName":"task/bc219832c3a1-feat-eval-agent-evaluation-benchmarking-framewor","isDraft":false,"mergedAt":null,"number":451,"state":"OPEN","title":"feat(eval): Agent Evaluation & Benchmarking Framework ÔÇö data-driven agent optimization","url":"https://github.com/virtengine/bosun/pull/451"},{"baseRefName":"main","headRefName":"task/493ae5e42027-feat-css-tabular-numerals-on-all-numeric-portal-","isDraft":false,"mergedAt":null,"number":450,"state":"OPEN","title":"feat(css): tabular numerals on all numeric portal outputs","url":"https://github.com/virtengine/bosun/pull/450"},{"baseRefName":"main","headRefName":"task/b3364eceda27-feat-portal-live-websocket-connection-badge-in-p","isDraft":false,"mergedAt":null,"number":449,"state":"OPEN","title":"feat(portal): live WebSocket connection badge in portal header","url":"https://github.com/virtengine/bosun/pull/449"},{"baseRefName":"main","headRefName":"task/e69d47108981-feat-agents-input-output-token-split-display-per","isDraft":false,"mergedAt":null,"number":448,"state":"OPEN","title":"feat(agents): input/output token split display per active session row","url":"https://github.com/virtengine/bosun/pull/448"},{"baseRefName":"main","headRefName":"task/24acc4022620-feat-skills-enforce-lazy-conditional-skill-injec","isDraft":false,"mergedAt":"2026-03-26T14:50:34Z","number":447,"state":"MERGED","title":"feat(skills): enforce lazy/conditional skill injection with char budget cap","url":"https://github.com/virtengine/bosun/pull/447"},{"baseRefName":"main","headRefName":"task/f8180f1d37de-feat-agents-live-session-turn-counter-alongside-","isDraft":false,"mergedAt":null,"number":446,"state":"OPEN","title":"feat(agents): live session turn counter alongside runtime timer","url":"https://github.com/virtengine/bosun/pull/446"},{"baseRefName":"main","headRefName":"task/cfd631a87666-feat-tui-session-detail-modal-full-session-drill","isDraft":false,"mergedAt":null,"number":445,"state":"OPEN","title":"feat(tui): Session Detail modal ÔÇö full session drill-down with turn timeline and diff","url":"https://github.com/virtengine/bosun/pull/445"},{"baseRefName":"main","headRefName":"task/3f0091bff149-feat-tui-logs-screen-streaming-multi-source-log-","isDraft":false,"mergedAt":"2026-03-26T19:18:18Z","number":444,"state":"MERGED","title":"feat(tui): Logs screen ÔÇö streaming multi-source log viewer with session filter and search","url":"https://github.com/virtengine/bosun/pull/444"},{"baseRefName":"main","headRefName":"task/56b361530b9c-feat-agent-add-mcp-tool-overhead-visibility-and-","isDraft":false,"mergedAt":null,"number":443,"state":"OPEN","title":"feat(agent): add MCP tool overhead visibility and logging","url":"https://github.com/virtengine/bosun/pull/443"},{"baseRefName":"main","headRefName":"dependabot/npm_and_yarn/npm_and_yarn-d633397f06","isDraft":false,"mergedAt":"2026-03-26T11:51:38Z","number":442,"state":"MERGED","title":"chore(deps-dev): bump the npm_and_yarn group across 2 directories with 1 update","url":"https://github.com/virtengine/bosun/pull/442"},{"baseRefName":"main","headRefName":"task/3cc669aec7e8-feat-tui-telemetry-screen-ascii-sparklines-provi","isDraft":false,"mergedAt":null,"number":441,"state":"OPEN","title":"feat(tui): Telemetry screen ÔÇö ASCII sparklines, provider stats, rate-limit heatmap, cost tracker","url":"https://github.com/virtengine/bosun/pull/441"},{"baseRefName":"main","headRefName":"task/4567dec9f7e3-feat-tui-workflows-screen-list-trigger-inspect-a","isDraft":false,"mergedAt":null,"number":440,"state":"OPEN","title":"feat(tui): Workflows screen list, trigger, inspect, and cancel workflow runs from terminal","url":"https://github.com/virtengine/bosun/pull/440"},{"baseRefName":"main","headRefName":"task/3ad658101698-feat-tui-settings-screen-read-edit-bosun-config-","isDraft":false,"mergedAt":null,"number":439,"state":"OPEN","title":"feat(tui): Settings screen read/edit bosun.config.json fields inline with validation","url":"https://github.com/virtengine/bosun/pull/439"},{"baseRefName":"main","headRefName":"task/2316d3215b65-feat-tui-command-palette-fuzzy-find-any-action-w","isDraft":false,"mergedAt":null,"number":438,"state":"OPEN","title":"feat(tui): Command palette fuzzy-find any action with Ctrl+P or : prefix","url":"https://github.com/virtengine/bosun/pull/438"},{"baseRefName":"main","headRefName":"task/76cc7f25b5f2-m-feat-workflow-add-delegation-watchdog-to-auto-","isDraft":false,"mergedAt":null,"number":437,"state":"OPEN","title":"[m] feat(workflow): add delegation watchdog to auto-recover stalled non-task nodes","url":"https://github.com/virtengine/bosun/pull/437"},{"baseRefName":"main","headRefName":"task/3142f12b27d3-m-feat-workflow-add-delegation-audit-trail-and-r","isDraft":false,"mergedAt":null,"number":436,"state":"OPEN","title":"[m] feat(workflow): add delegation audit trail and replay-safe state transitions","url":"https://github.com/virtengine/bosun/pull/436"},{"baseRefName":"main","headRefName":"task/cc3da1b76df6-m-feat-task-enforce-task-batch-payload-schema-va","isDraft":false,"mergedAt":null,"number":435,"state":"OPEN","title":"[m] feat(task): enforce task-batch payload schema validation at runtime boundaries","url":"https://github.com/virtengine/bosun/pull/435"},{"baseRefName":"main","headRefName":"task/0e58fe1ea0fd-s-feat-task-harden-taskstats-contract-and-fixtur","isDraft":false,"mergedAt":"2026-03-26T10:09:32Z","number":434,"state":"MERGED","title":"[s] feat(task): harden taskStats contract and fixture realism in task CLI tests","url":"https://github.com/virtengine/bosun/pull/434"},{"baseRefName":"main","headRefName":"merge/feat-enhance-command-diagnostics","isDraft":false,"mergedAt":"2026-03-25T04:39:08Z","number":433,"state":"MERGED","title":"merge: feat/enhance-command-diagnostics","url":"https://github.com/virtengine/bosun/pull/433"},{"baseRefName":"main","headRefName":"repair-pr-431","isDraft":false,"mergedAt":"2026-03-25T04:35:01Z","number":432,"state":"MERGED","title":"Repair pr 431","url":"https://github.com/virtengine/bosun/pull/432"},{"baseRefName":"main","headRefName":"task/7c489b80e31b-s-feat-task-surface-repo-area-lock-contention-te","isDraft":false,"mergedAt":"2026-03-25T03:04:05Z","number":431,"state":"MERGED","title":"[s] feat(task): surface repo-area lock contention telemetry in operator views","url":"https://github.com/virtengine/bosun/pull/431"},{"baseRefName":"main","headRefName":"release/v0.42.5","isDraft":false,"mergedAt":"2026-03-24T16:58:41Z","number":430,"state":"MERGED","title":"chore(release): v0.42.5 — skill externalization, provider context fix","url":"https://github.com/virtengine/bosun/pull/430"},{"baseRefName":"main","headRefName":"bosun/fix-pr425","isDraft":false,"mergedAt":"2026-03-24T15:34:04Z","number":429,"state":"MERGED","title":"Fix workflow template node command args","url":"https://github.com/virtengine/bosun/pull/429"},{"baseRefName":"main","headRefName":"task/0003889d6381-feat-tui-tasks-screen-full-kanban-crud-in-termin","isDraft":false,"mergedAt":null,"number":428,"state":"CLOSED","title":"feat(tui): Tasks screen ÔÇö full kanban CRUD in terminal with column view and filters","url":"https://github.com/virtengine/bosun/pull/428"},{"baseRefName":"main","headRefName":"task/0d255b09eec1-feat-tui-ws-bridge-expose-monitor-stats-and-sess","isDraft":false,"mergedAt":"2026-03-24T13:33:42Z","number":427,"state":"MERGED","title":"feat(tui): WS bridge ÔÇö expose monitor stats and session events over the local bosun WS bus for TUI consumption","url":"https://github.com/virtengine/bosun/pull/427"},{"baseRefName":"main","headRefName":"task/0d255b09eec1-feat-tui-ws-bridge-expose-monitor-stats-and-sess-retry2","isDraft":false,"mergedAt":"2026-03-24T15:38:30Z","number":426,"state":"MERGED","title":"feat(tui): expose canonical ws session snapshots for TUI bridge","url":"https://github.com/virtengine/bosun/pull/426"},{"baseRefName":"main","headRefName":"task/9c7d7ce37efe-m-feat-workflow-add-canvas-support-for-explicit-","isDraft":false,"mergedAt":"2026-03-24T06:37:58Z","number":425,"state":"MERGED","title":"[m] feat(workflow): add canvas support for explicit edge port mapping","url":"https://github.com/virtengine/bosun/pull/425"},{"baseRefName":"main","headRefName":"task/45dde7fb42db-feat-tui-create-task-from-terminal-form","isDraft":false,"mergedAt":"2026-03-24T14:58:14Z","number":424,"state":"MERGED","title":"feat(tui): Create task from terminal form","url":"https://github.com/virtengine/bosun/pull/424"},{"baseRefName":"main","headRefName":"task/3e64f3186954-m-feat-infra-expose-poisoned-worktree-auto-repai","isDraft":false,"mergedAt":"2026-03-24T07:23:41Z","number":423,"state":"MERGED","title":"[m] feat(infra): expose poisoned worktree auto-repair events and recovery status","url":"https://github.com/virtengine/bosun/pull/423"},{"baseRefName":"main","headRefName":"task/8b2f4eb852ae-m-feat-voice-add-turn-trace-replay-and-mismatch-","isDraft":false,"mergedAt":"2026-03-24T05:06:15Z","number":422,"state":"MERGED","title":"[m] feat(voice): add turn-trace replay and mismatch diagnostics for voice actions","url":"https://github.com/virtengine/bosun/pull/422"},{"baseRefName":"main","headRefName":"task/2962c1fe050e-m-feat-workflow-add-custom-node-plugin-health-ch","isDraft":false,"mergedAt":"2026-03-24T04:50:26Z","number":421,"state":"MERGED","title":"[m] feat(workflow): add custom node plugin health checks and scaffold validation","url":"https://github.com/virtengine/bosun/pull/421"},{"baseRefName":"main","headRefName":"task/c0606b76d46a-feat-tui-tui-test-suite-unit-and-integration-tes","isDraft":false,"mergedAt":"2026-03-24T05:48:37Z","number":420,"state":"MERGED","title":"feat(tui): TUI test suite unit and integration tests for all screens and the WS bridge","url":"https://github.com/virtengine/bosun/pull/420"},{"baseRefName":"main","headRefName":"task/adad2e42e32d-feat-workflow-canvas-node-groups-sub-workflow-ex","isDraft":false,"mergedAt":"2026-03-24T15:43:56Z","number":419,"state":"MERGED","title":"feat(workflow-canvas): node groups, sub-workflow extraction, and workflow import/export","url":"https://github.com/virtengine/bosun/pull/419"},{"baseRefName":"main","headRefName":"task/7343fecc3731-chore-prompts-audit-and-remove-verbose-narration","isDraft":false,"mergedAt":"2026-03-24T14:55:34Z","number":418,"state":"MERGED","title":"chore(prompts): audit and remove verbose narration patterns from agent prompt templates","url":"https://github.com/virtengine/bosun/pull/418"},{"baseRefName":"main","headRefName":"task/2cd5daa54fc9-m-feat-ui-harden-session-recovery-across-all-min","isDraft":false,"mergedAt":"2026-03-23T23:15:46Z","number":417,"state":"MERGED","title":"[m] feat(ui): harden session recovery across all Mini App data surfaces","url":"https://github.com/virtengine/bosun/pull/417"},{"baseRefName":"main","headRefName":"task/0003889d6381-feat-tui-tasks-screen-full-kanban-crud-in-termin","isDraft":false,"mergedAt":"2026-03-23T20:33:46Z","number":416,"state":"MERGED","title":"feat(tui): Tasks screen ÔÇö full kanban CRUD in terminal with column view and filters","url":"https://github.com/virtengine/bosun/pull/416"},{"baseRefName":"main","headRefName":"task/349f9f0d324d-feat-tui-tui-architecture-scaffold-bosun-tui-mjs","isDraft":false,"mergedAt":"2026-03-23T20:54:12Z","number":415,"state":"MERGED","title":"feat(tui): TUI architecture ÔÇö scaffold bosun-tui.mjs with ink, entry point, and screen router","url":"https://github.com/virtengine/bosun/pull/415"},{"baseRefName":"main","headRefName":"task/ba795c04e248-feat-tui-status-header-panel-system-wide-metrics","isDraft":false,"mergedAt":"2026-03-23T21:20:45Z","number":414,"state":"MERGED","title":"feat(tui): Status Header panel ÔÇö system-wide metrics bar pinned at top of every screen","url":"https://github.com/virtengine/bosun/pull/414"},{"baseRefName":"main","headRefName":"task/62e528af296f-m-feat-workflow-classify-and-surface-validation-","isDraft":false,"mergedAt":"2026-03-23T20:10:49Z","number":413,"state":"MERGED","title":"[m] feat(workflow): classify and surface validation-runner failure modes","url":"https://github.com/virtengine/bosun/pull/413"},{"baseRefName":"main","headRefName":"task/T1-test-task","isDraft":false,"mergedAt":null,"number":412,"state":"CLOSED","title":"Test task","url":"https://github.com/virtengine/bosun/pull/412"},{"baseRefName":"main","headRefName":"task/d9765e1b4f84-l-feat-tracing-propagate-workflow-and-task-span-","isDraft":false,"mergedAt":"2026-03-24T13:47:02Z","number":411,"state":"MERGED","title":"[l] feat(tracing): propagate workflow and task span context end-to-end","url":"https://github.com/virtengine/bosun/pull/411"},{"baseRefName":"main","headRefName":"task/70ca0aa8fa25-m-feat-task-extend-path-normalization-to-attachm","isDraft":false,"mergedAt":"2026-03-23T18:22:04Z","number":410,"state":"MERGED","title":"[m] feat(task): extend path normalization to attachments and archive workflows","url":"https://github.com/virtengine/bosun/pull/410"},{"baseRefName":"main","headRefName":"task/bb067c3685ad-l-feat-workflow-inject-repo-map-context-into-pla","isDraft":false,"mergedAt":"2026-03-23T22:59:14Z","number":409,"state":"MERGED","title":"feat(workflow): inject repo-map context into planner and execution nodes","url":"https://github.com/virtengine/bosun/pull/409"},{"baseRefName":"main","headRefName":"task/431107973873-agentfield-style-durable-execution-ledger-for-wo","isDraft":false,"mergedAt":"2026-03-24T13:08:12Z","number":408,"state":"MERGED","title":"AgentField-style durable execution ledger for workflow and autonomous runs","url":"https://github.com/virtengine/bosun/pull/408"},{"baseRefName":"main","headRefName":"task/bbe2f02ec1b5-m-feat-task-harden-task-store-path-normalization","isDraft":false,"mergedAt":null,"number":407,"state":"CLOSED","title":"[m] feat(task): harden task-store path normalization and collision safeguards","url":"https://github.com/virtengine/bosun/pull/407"},{"baseRefName":"main","headRefName":"task/0bc4b6cdcf09-feat-tracing-opentelemetry-tracing-industry-stan","isDraft":false,"mergedAt":"2026-03-23T12:43:03Z","number":406,"state":"MERGED","title":"task/0bc4b6cdcf09 feat tracing opentelemetry tracing industry stan","url":"https://github.com/virtengine/bosun/pull/406"},{"baseRefName":"main","headRefName":"task/67e0e1c84306-m-feat-ui-unify-session-list-resilience-paths-fo","isDraft":false,"mergedAt":"2026-03-23T12:45:15Z","number":405,"state":"MERGED","title":"[m] feat(ui): unify session-list resilience paths for load-error, 404 fallback, and retry","url":"https://github.com/virtengine/bosun/pull/405"},{"baseRefName":"main","headRefName":"task/e7b6f2bbc629-l-feat-kanban-propagate-pr-linkage-integrity-fro","isDraft":false,"mergedAt":"2026-03-23T02:02:38Z","number":404,"state":"MERGED","title":"feat(kanban): propagate PR linkage integrity from status updates through board refresh","url":"https://github.com/virtengine/bosun/pull/404"},{"baseRefName":"main","headRefName":"monitor/bosun-env-stability","isDraft":false,"mergedAt":null,"number":403,"state":"CLOSED","title":"fix: prefer explicit repo-root task store","url":"https://github.com/virtengine/bosun/pull/403"},{"baseRefName":"main","headRefName":"task/bbe2f02ec1b5-m-feat-task-harden-task-store-path-normalization","isDraft":false,"mergedAt":null,"number":402,"state":"CLOSED","title":"feat(task): harden task-store path normalization and collision safeguards","url":"https://github.com/virtengine/bosun/pull/402"},{"baseRefName":"main","headRefName":"monitor/bosun-env-stability","isDraft":false,"mergedAt":null,"number":401,"state":"CLOSED","title":"fix: pin task batch to source backlog store","url":"https://github.com/virtengine/bosun/pull/401"},{"baseRefName":"main","headRefName":"task/c04d09d454fa-isolated-heavy-runner-pool-for-build-test-and-va","isDraft":false,"mergedAt":"2026-03-23T10:12:48Z","number":400,"state":"MERGED","title":"Add isolated heavy runner pool for validation workflows","url":"https://github.com/virtengine/bosun/pull/400"},{"baseRefName":"main","headRefName":"task/b6e576b28f97-m-feat-testing-build-cross-module-regression-sui","isDraft":false,"mergedAt":"2026-03-23T01:46:29Z","number":399,"state":"MERGED","title":"feat(testing): build cross-module regression suite for monitor-workflow-task handoff invariants","url":"https://github.com/virtengine/bosun/pull/399"},{"baseRefName":"main","headRefName":"monitor/bosun-env-stability","isDraft":false,"mergedAt":null,"number":398,"state":"CLOSED","title":"fix: prefer explicit repo-root task store","url":"https://github.com/virtengine/bosun/pull/398"},{"baseRefName":"main","headRefName":"task/c8067759906a-sift-style-semantic-command-router-and-context-b","isDraft":false,"mergedAt":"2026-03-23T15:20:48Z","number":397,"state":"MERGED","title":"Sift-style semantic command router and context budget policies","url":"https://github.com/virtengine/bosun/pull/397"},{"baseRefName":"main","headRefName":"monitor/bosun-env-stability","isDraft":false,"mergedAt":null,"number":396,"state":"CLOSED","title":"fix: honor explicit repo-root task store","url":"https://github.com/virtengine/bosun/pull/396"},{"baseRefName":"main","headRefName":"task/ab1c4446fbe8-swe-af-style-dagstate-replanning-and-issue-advis","isDraft":false,"mergedAt":"2026-03-23T01:56:19Z","number":395,"state":"MERGED","title":"feat: SWE-AF DAGState replanning and issue-advisor loop","url":"https://github.com/virtengine/bosun/pull/395"},{"baseRefName":"main","headRefName":"task/a3056106c65c-repo-map-and-architect-editor-execution-mode","isDraft":false,"mergedAt":"2026-03-22T21:18:46Z","number":394,"state":"MERGED","title":"Repo map and architect-editor execution mode","url":"https://github.com/virtengine/bosun/pull/394"},{"baseRefName":"main","headRefName":"task/bbe2f02ec1b5-m-feat-task-harden-task-store-path-normalization","isDraft":false,"mergedAt":"2026-03-22T20:55:47Z","number":393,"state":"MERGED","title":"feat(task): harden task-store path normalization","url":"https://github.com/virtengine/bosun/pull/393"},{"baseRefName":"main","headRefName":"task/6da44dbcd6f3-m-feat-agent-enforce-executor-repo-area-lock-fai","isDraft":false,"mergedAt":"2026-03-22T20:32:18Z","number":392,"state":"MERGED","title":"feat(agent): enforce executor repo-area lock fairness","url":"https://github.com/virtengine/bosun/pull/392"},{"baseRefName":"main","headRefName":"task/15266997314a-m-feat-infra-add-monitor-self-healing-backoff-po","isDraft":false,"mergedAt":"2026-03-22T20:28:35Z","number":391,"state":"MERGED","title":"feat(infra): add bounded monitor recovery policy","url":"https://github.com/virtengine/bosun/pull/391"},{"baseRefName":"main","headRefName":"monitor/bosun-env-stability","isDraft":false,"mergedAt":"2026-03-22T20:21:58Z","number":390,"state":"MERGED","title":"fix: dispatch task batch lifecycle fan-out","url":"https://github.com/virtengine/bosun/pull/390"},{"baseRefName":"repair/pr-377-fallback","headRefName":"copilot/sub-pr-388","isDraft":true,"mergedAt":null,"number":389,"state":"CLOSED","title":"Fix all failing tests and CI workflow checks","url":"https://github.com/virtengine/bosun/pull/389"},{"baseRefName":"main","headRefName":"repair/pr-377-fallback","isDraft":false,"mergedAt":null,"number":388,"state":"CLOSED","title":"Repair/pr 377 fallback","url":"https://github.com/virtengine/bosun/pull/388"},{"baseRefName":"main","headRefName":"repair/pr-377-fallback","isDraft":false,"mergedAt":null,"number":387,"state":"CLOSED","title":"Repair/pr 377 fallback","url":"https://github.com/virtengine/bosun/pull/387"},{"baseRefName":"main","headRefName":"task/bbe2f02ec1b5-m-feat-task-harden-task-store-path-normalization","isDraft":false,"mergedAt":null,"number":386,"state":"CLOSED","title":"[m] feat(task): harden task-store path normalization and collision safeguards","url":"https://github.com/virtengine/bosun/pull/386"},{"baseRefName":"main","headRefName":"task/6da44dbcd6f3-m-feat-agent-enforce-executor-repo-area-lock-fai","isDraft":false,"mergedAt":null,"number":385,"state":"CLOSED","title":"[m] feat(agent): enforce executor repo-area lock fairness and starvation telemetry","url":"https://github.com/virtengine/bosun/pull/385"},{"baseRefName":"main","headRefName":"task/15266997314a-m-feat-infra-add-monitor-self-healing-backoff-po","isDraft":false,"mergedAt":null,"number":384,"state":"CLOSED","title":"[m] feat(infra): add monitor self-healing backoff policy for stale dispatch recovery","url":"https://github.com/virtengine/bosun/pull/384"},{"baseRefName":"main","headRefName":"repair/pr-377-fallback","isDraft":false,"mergedAt":"2026-03-22T16:38:06Z","number":383,"state":"MERGED","title":"Repair/pr 377 fallback","url":"https://github.com/virtengine/bosun/pull/383"},{"baseRefName":"main","headRefName":"task/0d255b09eec1-feat-tui-ws-bridge-expose-monitor-stats-and-sess","isDraft":false,"mergedAt":null,"number":382,"state":"CLOSED","title":"Task/0d255b09eec1 feat tui ws bridge expose monitor stats and sess","url":"https://github.com/virtengine/bosun/pull/382"},{"baseRefName":"main","headRefName":"task/a1731dc43e95-trajectory-replay-and-lakeview-style-run-summari","isDraft":false,"mergedAt":"2026-03-22T20:36:42Z","number":381,"state":"MERGED","title":"Add replayable trajectories and run summaries","url":"https://github.com/virtengine/bosun/pull/381"},{"baseRefName":"task/a3056106c65c-repo-map-and-architect-editor-execution-mode","headRefName":"copilot/sub-pr-377","isDraft":false,"mergedAt":"2026-03-22T15:40:06Z","number":380,"state":"MERGED","title":"fix(agent): eliminate inferExecutionRole duplication, add allowlist validation, sanitize changedFiles paths, add prompt-framing tests","url":"https://github.com/virtengine/bosun/pull/380"},{"baseRefName":"recovery/staged-work-20260323","headRefName":"copilot/sub-pr-378","isDraft":false,"mergedAt":"2026-03-22T15:39:58Z","number":379,"state":"MERGED","title":"fix(ci): align workspace mirror paths, API limits, and stale claim filtering","url":"https://github.com/virtengine/bosun/pull/379"},{"baseRefName":"main","headRefName":"recovery/staged-work-20260323","isDraft":false,"mergedAt":null,"number":378,"state":"CLOSED","title":"chore(recovery): preserve 98 files of staged work from task branches","url":"https://github.com/virtengine/bosun/pull/378"},{"baseRefName":"main","headRefName":"task/a3056106c65c-repo-map-and-architect-editor-execution-mode","isDraft":false,"mergedAt":null,"number":377,"state":"CLOSED","title":"Repo map and architect-editor execution mode","url":"https://github.com/virtengine/bosun/pull/377"},{"baseRefName":"main","headRefName":"task/e8b43644d7cc-untitled-task","isDraft":false,"mergedAt":"2026-03-22T14:26:47Z","number":376,"state":"MERGED","title":"Fix task recovery and OAuth env normalization","url":"https://github.com/virtengine/bosun/pull/376"},{"baseRefName":"main","headRefName":"live-pr-349","isDraft":false,"mergedAt":"2026-03-22T13:15:18Z","number":375,"state":"MERGED","title":"Live pr 349","url":"https://github.com/virtengine/bosun/pull/375"},{"baseRefName":"main","headRefName":"live-pr-355","isDraft":false,"mergedAt":"2026-03-22T12:52:23Z","number":374,"state":"MERGED","title":"Live pr 355","url":"https://github.com/virtengine/bosun/pull/374"},{"baseRefName":"main","headRefName":"fix/diff-review-merge-sweep","isDraft":false,"mergedAt":"2026-03-22T11:33:30Z","number":373,"state":"MERGED","title":"feat: improve task diff review UX","url":"https://github.com/virtengine/bosun/pull/373"},{"baseRefName":"main","headRefName":"task/9651aef2d46e-scoped-persistent-memory-for-teams-workspaces-se","isDraft":false,"mergedAt":"2026-03-22T10:24:25Z","number":372,"state":"MERGED","title":"Add scoped persistent memory support","url":"https://github.com/virtengine/bosun/pull/372"},{"baseRefName":"main","headRefName":"monitor/bosun-env-stability","isDraft":false,"mergedAt":null,"number":371,"state":"CLOSED","title":"fix: restore task batch fan-out dispatch","url":"https://github.com/virtengine/bosun/pull/371"},{"baseRefName":"main","headRefName":"monitor/bosun-env-stability","isDraft":false,"mergedAt":null,"number":370,"state":"CLOSED","title":"fix: restore task batch coordinator gate","url":"https://github.com/virtengine/bosun/pull/370"},{"baseRefName":"main","headRefName":"task/ba93577e35ec-untitled-task","isDraft":false,"mergedAt":null,"number":369,"state":"CLOSED","title":"fix(ui): normalize Windows stream timeline paths","url":"https://github.com/virtengine/bosun/pull/369"},{"baseRefName":"main","headRefName":"fix/watchdog-update-behind-branches","isDraft":false,"mergedAt":null,"number":368,"state":"CLOSED","title":"fix(watchdog): auto-update behind branches before merge attempt","url":"https://github.com/virtengine/bosun/pull/368"},{"baseRefName":"main","headRefName":"task/f3c301092b60-untitled-task","isDraft":false,"mergedAt":null,"number":367,"state":"CLOSED","title":"Untitled task","url":"https://github.com/virtengine/bosun/pull/367"},{"baseRefName":"main","headRefName":"fix/f3c30109-stream-timeline-file-change","isDraft":false,"mergedAt":"2026-03-22T03:08:55Z","number":366,"state":"MERGED","title":"fix(ui): keep file change timeline blocks separate","url":"https://github.com/virtengine/bosun/pull/366"},{"baseRefName":"main","headRefName":"task/f3c301092b60-untitled-task","isDraft":false,"mergedAt":null,"number":365,"state":"CLOSED","title":"fix(ui): keep file change timeline blocks separate","url":"https://github.com/virtengine/bosun/pull/365"}] diff --git a/server/bosun-mcp-server.mjs b/server/bosun-mcp-server.mjs index 3be7688cf..62860c1f0 100644 --- a/server/bosun-mcp-server.mjs +++ b/server/bosun-mcp-server.mjs @@ -1,34 +1,15 @@ #!/usr/bin/env node -import { - existsSync, - mkdirSync, - readdirSync, - readFileSync, - statSync, - writeFileSync, -} from "node:fs"; -import { dirname, join, resolve } from "node:path"; import { fileURLToPath } from "node:url"; +import { resolve } from "node:path"; import { format } from "node:util"; -import * as mcpServer from "@modelcontextprotocol/sdk/server/index.js"; -import * as mcpStdio from "@modelcontextprotocol/sdk/server/stdio.js"; -import * as mcpTypes from "@modelcontextprotocol/sdk/types.js"; -import { repairCommonMojibake } from "../lib/mojibake-repair.mjs"; - -const Server = mcpServer.Server ?? mcpServer.default?.Server; -const StdioServerTransport = - mcpStdio.StdioServerTransport ?? - mcpStdio.default?.StdioServerTransport; -const CallToolRequestSchema = - mcpTypes.CallToolRequestSchema ?? - mcpTypes.default?.CallToolRequestSchema; -const ListToolsRequestSchema = - mcpTypes.ListToolsRequestSchema ?? - mcpTypes.default?.ListToolsRequestSchema; +import { Server } from "@modelcontextprotocol/sdk/server/index.js"; +import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"; +import { + CallToolRequestSchema, + ListToolsRequestSchema, +} from "@modelcontextprotocol/sdk/types.js"; const TAG = "[bosun-mcp]"; -const ResolvedCallToolRequestSchema = CallToolRequestSchema; -const ResolvedListToolsRequestSchema = ListToolsRequestSchema; const DEFAULT_DISCOVERY_PORTS = [3080, 4400]; const DEFAULT_REQUEST_TIMEOUT_MS = 10_000; const ENV_KEYS_FOR_EMBEDDED = [ @@ -626,125 +607,9 @@ export function listBosunMcpTools() { required: ["toolName"], }, }, - // ── File tools ───────────────────────────────────────────────────────── - { - name: "str_replace_editor", - description: - "Make a surgical edit to a file by replacing an exact string. " + - "Safer than full rewrites — preserves encoding, only changes what's specified. " + - "Prefer this over shell-based patching. " + - "The old_str must match exactly (whitespace included). " + - "Call read_file first if you need to verify the exact text.", - inputSchema: { - type: "object", - properties: { - path: { type: "string", description: "Absolute or workspace-relative file path." }, - old_str: { type: "string", description: "Exact string to find and replace (must be unique in the file)." }, - new_str: { type: "string", description: "Replacement string." }, - workspace_path: { type: "string", description: "Workspace root for resolving relative paths." }, - }, - required: ["path", "old_str", "new_str"], - }, - }, - { - name: "write_file", - description: - "Write content to a file, creating it and any missing parent directories if needed. " + - "Use for new files or when a complete rewrite is necessary. " + - "For editing existing files prefer str_replace_editor.", - inputSchema: { - type: "object", - properties: { - path: { type: "string", description: "Absolute or workspace-relative file path." }, - content: { type: "string", description: "Full file content to write." }, - workspace_path: { type: "string", description: "Workspace root for resolving relative paths." }, - }, - required: ["path", "content"], - }, - }, - { - name: "read_file", - description: - "Read a file's content with line numbers. Use start_line and end_line to focus on a range. " + - "Always call this before str_replace_editor to confirm the exact text you want to replace.", - inputSchema: { - type: "object", - properties: { - path: { type: "string", description: "Absolute or workspace-relative file path." }, - start_line: { type: "number", description: "First line to read (1-indexed, inclusive)." }, - end_line: { type: "number", description: "Last line to read (1-indexed, inclusive)." }, - workspace_path: { type: "string", description: "Workspace root for resolving relative paths." }, - }, - required: ["path"], - }, - }, - { - name: "grep_search", - description: - "Search for text or regex patterns across files. Returns matching lines with file paths and line numbers. " + - "Use this to locate code before editing rather than guessing paths.", - inputSchema: { - type: "object", - properties: { - pattern: { type: "string", description: "Text or regex pattern to search for." }, - path: { type: "string", description: "Directory or file to search in (defaults to workspace root)." }, - glob: { type: "string", description: "Glob pattern to filter files, e.g. '**/*.mjs' or '*.ts'." }, - case_insensitive: { type: "boolean", description: "Case-insensitive search. Default: false." }, - max_results: { type: "number", description: "Maximum number of matching lines to return. Default: 50." }, - workspace_path: { type: "string", description: "Workspace root for resolving relative paths." }, - }, - required: ["pattern"], - }, - }, ]; } -// ── File tool helpers ────────────────────────────────────────────────────── - -function resolveFilePath(filePath, workspacePath) { - const p = String(filePath ?? "").trim(); - if (!p) throw new Error("path is required"); - if (p.match(/^([A-Za-z]:\\|\/)/)) return p; // already absolute - const base = workspacePath ? resolve(String(workspacePath).trim()) : process.cwd(); - return join(base, p); -} - -function countOccurrences(haystack, needle) { - let count = 0; - let pos = 0; - while ((pos = haystack.indexOf(needle, pos)) !== -1) { count++; pos += needle.length; } - return count; -} - -const GREP_SKIP_DIRS = new Set(["node_modules", ".git", ".bosun", "dist", "build", ".next", "coverage"]); - -function matchGlob(filePath, pattern) { - if (!pattern || pattern === "**/*") return true; - // Simple glob: supports *.ext and **/*.ext patterns only - let ext = ""; - if (pattern.startsWith("*.")) { - ext = pattern.slice(2); - } else if (pattern.startsWith("**/*.")) { - ext = pattern.slice(5); - } - if (ext && !pattern.includes("/")) return filePath.endsWith(`.${ext}`); - return true; -} - -function walkForGrep(dir, glob, callback) { - try { - const entries = readdirSync(dir, { withFileTypes: true }); - for (const entry of entries) { - const full = join(dir, entry.name); - if (entry.isDirectory()) { - if (!GREP_SKIP_DIRS.has(entry.name)) walkForGrep(full, glob, callback); - } else if (entry.isFile() && matchGlob(entry.name, glob)) { - if (callback(full) === false) return; - } - } - } catch { /* skip inaccessible dirs */ } -} - const BOSUN_TOOL_HANDLERS = { async bosun_status(runtime) { const backend = await runtime.ensureBackend(); @@ -1055,112 +920,6 @@ const BOSUN_TOOL_HANDLERS = { }); return response.data; }, - - // ── File system tools ────────────────────────────────────────────────────── - // These are implemented as local fs operations (not Bosun HTTP API calls) - // so they work reliably with correct encoding regardless of shell/platform. - - str_replace_editor(_runtime, args) { - const absPath = resolveFilePath(args.path, args.workspace_path); - if (!existsSync(absPath)) throw new Error(`File not found: ${absPath}`); - const original = readFileSync(absPath, "utf8"); - const oldStr = String(args.old_str ?? ""); - const newStr = repairCommonMojibake(String(args.new_str ?? "")); - if (!oldStr) throw new Error("old_str must not be empty"); - const idx = original.indexOf(oldStr); - if (idx === -1) { - throw new Error( - `str_replace_editor: old_str not found in ${absPath}.\n` + - `Verify the exact text including whitespace. ` + - `Tip: read_file the target first, then copy the exact text to old_str.`, - ); - } - const occurrences = countOccurrences(original, oldStr); - if (occurrences > 1) { - throw new Error( - `str_replace_editor: old_str matched ${occurrences} times in ${absPath}. ` + - `Add more surrounding context to make it unique.`, - ); - } - const updated = original.slice(0, idx) + newStr + original.slice(idx + oldStr.length); - writeFileSync(absPath, updated, "utf8"); - const lineNum = original.slice(0, idx).split("\n").length; - return { - success: true, - path: absPath, - replaced_at_line: lineNum, - occurrences_checked: occurrences, - repairedMojibake: newStr !== String(args.new_str ?? ""), - }; - }, - - write_file(_runtime, args) { - const absPath = resolveFilePath(args.path, args.workspace_path); - const rawContent = String(args.content ?? ""); - const content = repairCommonMojibake(rawContent); - const dir = dirname(absPath); - if (!existsSync(dir)) mkdirSync(dir, { recursive: true }); - writeFileSync(absPath, content, "utf8"); - const lineCount = content.split("\n").length; - return { - success: true, - path: absPath, - bytes_written: Buffer.byteLength(content, "utf8"), - lines: lineCount, - repairedMojibake: content !== rawContent, - }; - }, - - read_file(_runtime, args) { - const absPath = resolveFilePath(args.path, args.workspace_path); - if (!existsSync(absPath)) throw new Error(`File not found: ${absPath}`); - const raw = readFileSync(absPath, "utf8"); - const lines = raw.split("\n"); - const startLine = args.start_line ? Math.max(1, Number(args.start_line)) : 1; - const endLine = args.end_line ? Math.min(lines.length, Number(args.end_line)) : lines.length; - const sliced = lines.slice(startLine - 1, endLine); - const content = sliced - .map((line, i) => `${String(startLine + i).padStart(6)} | ${line}`) - .join("\n"); - return { path: absPath, start_line: startLine, end_line: startLine + sliced.length - 1, total_lines: lines.length, content }; - }, - - grep_search(_runtime, args) { - const pattern = String(args.pattern ?? ""); - if (!pattern) throw new Error("pattern is required"); - const base = args.workspace_path - ? resolve(args.workspace_path) - : process.cwd(); - const searchRoot = args.path - ? resolveFilePath(args.path, args.workspace_path) - : base; - const glob = String(args.glob ?? "**/*"); - const caseInsensitive = Boolean(args.case_insensitive); - const maxResults = Math.min(Number(args.max_results ?? 50), 500); - const flags = caseInsensitive ? "gi" : "g"; - let regex; - try { - regex = new RegExp(pattern, flags); - } catch { - regex = new RegExp(pattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), flags); - } - const matches = []; - walkForGrep(searchRoot, glob, (filePath) => { - if (matches.length >= maxResults) return false; - try { - const text = readFileSync(filePath, "utf8"); - const fileLines = text.split("\n"); - for (let i = 0; i < fileLines.length; i++) { - if (matches.length >= maxResults) break; - if (regex.test(fileLines[i])) { - matches.push({ file: filePath, line: i + 1, text: fileLines[i].trim() }); - } - } - } catch { /* skip unreadable files */ } - return true; - }); - return { pattern, results: matches, total: matches.length, truncated: matches.length >= maxResults }; - }, }; async function callBosunTool(runtime, name, rawArgs = {}) { @@ -1193,8 +952,8 @@ export async function startBosunMcpServer(options = {}) { { capabilities: { tools: {} } }, ); - server.setRequestHandler(ResolvedListToolsRequestSchema, async () => handlers.listTools()); - server.setRequestHandler(ResolvedCallToolRequestSchema, async (request) => { + server.setRequestHandler(ListToolsRequestSchema, async () => handlers.listTools()); + server.setRequestHandler(CallToolRequestSchema, async (request) => { const name = String(request.params?.name || "").trim(); return handlers.callTool(name, request.params?.arguments || {}); }); @@ -1242,4 +1001,4 @@ if (isMainModule()) { console.error(`${TAG} failed to start: ${error?.stack || error?.message || error}`); process.exit(1); } -} +} \ No newline at end of file diff --git a/server/playwright-ui-e2e.mjs b/server/playwright-ui-e2e.mjs index 3c1e8891c..e57a2c2be 100644 --- a/server/playwright-ui-e2e.mjs +++ b/server/playwright-ui-e2e.mjs @@ -24,10 +24,7 @@ */ import { readFileSync } from "node:fs"; import { resolve } from "node:path"; -import * as playwrightTest from "@playwright/test"; - -const test = playwrightTest.test ?? playwrightTest.default?.test; -const expect = playwrightTest.expect ?? playwrightTest.default?.expect; +import { test, expect } from "@playwright/test"; const ROUTER_SOURCE = readFileSync(resolve(process.cwd(), "ui/modules/router.js"), "utf8"); diff --git a/server/playwright-ui-inspect.mjs b/server/playwright-ui-inspect.mjs index 0a3f21caa..224a56336 100644 --- a/server/playwright-ui-inspect.mjs +++ b/server/playwright-ui-inspect.mjs @@ -5,14 +5,11 @@ * 1. Start the mock UI server: node playwright-ui-server.mjs * 2. Run this: npx playwright test playwright-ui-inspect.mjs --headed */ -import * as playwrightTest from "@playwright/test"; +import { test, expect } from "@playwright/test"; import { resolve, dirname } from "node:path"; import { mkdirSync } from "node:fs"; import { fileURLToPath } from "node:url"; -const test = playwrightTest.test ?? playwrightTest.default?.test; -const expect = playwrightTest.expect ?? playwrightTest.default?.expect; - const __dirname = dirname(fileURLToPath(import.meta.url)); const SCREENSHOTS_DIR = resolve(__dirname, "playwright-screenshots"); mkdirSync(SCREENSHOTS_DIR, { recursive: true }); diff --git a/server/playwright-ui-server.mjs b/server/playwright-ui-server.mjs index 54192a7d0..dc2304ca3 100644 --- a/server/playwright-ui-server.mjs +++ b/server/playwright-ui-server.mjs @@ -10,12 +10,7 @@ import { readFile, writeFile, mkdir } from "node:fs/promises"; import { existsSync } from "node:fs"; import { resolve, extname, dirname } from "node:path"; import { fileURLToPath } from "node:url"; -import * as wsModule from "ws"; - -const WebSocketServer = - wsModule.WebSocketServer ?? - wsModule.default?.WebSocketServer ?? - wsModule.default?.Server; +import { WebSocketServer } from "ws"; const __dirname = dirname(fileURLToPath(import.meta.url)); const uiRoot = resolve(__dirname, "..", "ui"); diff --git a/server/playwright-ui-smoke.mjs b/server/playwright-ui-smoke.mjs index 2209cc525..fa447f6c0 100644 --- a/server/playwright-ui-smoke.mjs +++ b/server/playwright-ui-smoke.mjs @@ -1,7 +1,4 @@ -import * as playwrightTest from "@playwright/test"; - -const test = playwrightTest.test ?? playwrightTest.default?.test; -const expect = playwrightTest.expect ?? playwrightTest.default?.expect; +import { test, expect } from "@playwright/test"; const CRITICAL_ROUTES = [ { path: "/", label: "portal home" }, @@ -72,4 +69,4 @@ test.describe("Portal UI smoke", () => { } }); } -}); +}); \ No newline at end of file diff --git a/server/setup-web-server.mjs b/server/setup-web-server.mjs index 580ad3579..027c71048 100644 --- a/server/setup-web-server.mjs +++ b/server/setup-web-server.mjs @@ -17,7 +17,7 @@ import { readFile } from "node:fs/promises"; import { resolve, dirname, extname } from "node:path"; import { fileURLToPath } from "node:url"; import { createRequire } from "node:module"; -import { execSync as nodeExecSync } from "node:child_process"; +import { execSync } from "node:child_process"; import { homedir } from "node:os"; import { ensureTestRuntimeSandbox } from "../infra/test-runtime.mjs"; import { scaffoldSkills } from "../agent/bosun-skills.mjs"; @@ -33,13 +33,6 @@ import { discoverTelegramChats } from "../telegram/get-telegram-chat-id.mjs"; const __dirname = dirname(fileURLToPath(import.meta.url)); -function execSync(command, options = {}) { - return nodeExecSync(command, { - ...options, - windowsHide: options.windowsHide ?? (process.platform === "win32"), - }); -} - function trimTrailingSlashes(value) { let out = String(value || ""); while (out.endsWith("/")) out = out.slice(0, -1); @@ -95,11 +88,7 @@ function buildModelsProbeRequest({ apiKey = "", baseUrl = "" } = {}) { return { endpoint: parsed.toString(), headers }; } - if ( - (isAzure && !(lowerPath === "/openai/v1" || lowerPath.startsWith("/openai/v1/"))) - || lowerPath === "/openai" - || lowerPath.startsWith("/openai/") - ) { + if (isAzure || lowerPath === "/openai" || lowerPath.startsWith("/openai/")) { parsed.pathname = "/openai/models"; parsed.search = ""; parsed.searchParams.set("api-version", "2024-10-21"); diff --git a/server/ui-server.mjs b/server/ui-server.mjs index 8af5f3119..38b232467 100644 --- a/server/ui-server.mjs +++ b/server/ui-server.mjs @@ -1,11 +1,9 @@ -import { execSync as nodeExecSync, spawn, spawnSync, exec } from "node:child_process"; -import { Worker } from "node:worker_threads"; -import { randomUUID as _genCallId } from "node:crypto"; +import { execSync, spawn, spawnSync } from "node:child_process"; import * as nodeCrypto from "node:crypto"; import { existsSync, mkdirSync, readFileSync, chmodSync, createWriteStream, createReadStream, writeFileSync, unlinkSync, watchFile, unwatchFile, readdirSync, statSync } from "node:fs"; import { open, readFile, readdir, stat, writeFile } from "node:fs/promises"; -import { createServer, request as httpRequest } from "node:http"; -import { get as httpsGet, request as httpsRequest } from "node:https"; +import { createServer } from "node:http"; +import { get as httpsGet } from "node:https"; import { createServer as createHttpsServer } from "node:https"; import { networkInterfaces, homedir, userInfo as getOsUserInfo } from "node:os"; import { connect as netConnect } from "node:net"; @@ -15,18 +13,10 @@ import { createRequire } from "node:module"; import { arch as osArch, platform as osPlatform } from "node:os"; import { gzip as zlibGzip } from "node:zlib"; import { promisify } from "node:util"; -import * as wsModule from "ws"; import Ajv2020 from "ajv/dist/2020.js"; const gzipAsync = promisify(zlibGzip); -function execSync(command, options = {}) { - return nodeExecSync(command, { - ...options, - windowsHide: options.windowsHide ?? (process.platform === "win32"), - }); -} - const { createHash, createHmac, @@ -64,7 +54,6 @@ async function compressAndSend(req, res, statusCode, headers, body) { // Lightweight TTL cache for expensive API responses const _apiCache = new Map(); -const _apiInflight = new Map(); function getCachedApiResponse(key, ttlMs) { const entry = _apiCache.get(key); if (!entry) return undefined; @@ -82,38 +71,12 @@ function invalidateApiCache(prefix) { for (const key of _apiCache.keys()) { if (key.startsWith(prefix)) _apiCache.delete(key); } - for (const key of _apiInflight.keys()) { - if (key.startsWith(prefix)) _apiInflight.delete(key); - } -} -async function getOrComputeCachedApiResponse(key, ttlMs, producer) { - const cached = getCachedApiResponse(key, ttlMs); - if (cached !== undefined) return cached; - - const inflight = _apiInflight.get(key); - if (inflight) return inflight; - - const pending = Promise.resolve() - .then(producer) - .then((value) => { - setCachedApiResponse(key, value); - return value; - }) - .finally(() => { - _apiInflight.delete(key); - }); - - _apiInflight.set(key, pending); - return pending; } // Static file ETag + cache header helper function cacheControlForPath(pathname) { if (pathname.endsWith(".html")) return "no-cache"; - if (/\.(js|mjs|css)$/i.test(pathname)) { - return "no-cache"; - } - if (/\.(svg|png|jpg|jpeg|gif|webp|ico|woff2?)$/i.test(pathname)) { + if (/\.(js|mjs|css|svg|png|jpg|jpeg|gif|webp|ico|woff2?)$/i.test(pathname)) { return "public, max-age=3600, stale-while-revalidate=86400"; } return "public, max-age=300"; @@ -133,10 +96,7 @@ function getLocalLanIp() { } return "localhost"; } -const WebSocketServer = - wsModule.WebSocketServer ?? - wsModule.default?.WebSocketServer ?? - wsModule.default?.Server; +import { WebSocketServer } from "ws"; import { getKanbanAdapter, getKanbanBackendName, @@ -182,7 +142,6 @@ import { getManifestPath, scaffoldAgentProfiles, getBosunHomeDir, - hasUnresolvedTemplateTokens, syncAutoDiscoveredLibraryEntries, resolveAgentProfileLibraryMetadata, } from "../infra/library-manager.mjs"; @@ -201,14 +160,6 @@ import { getEnabledHookIds, getHooksAsLibraryEntries, } from "../agent/hook-library.mjs"; -import { - assessInputQuality, - detectRepoGuardrails, - ensureGuardrailsPolicy, - getGuardrailsPolicyPath, - loadGuardrailsPolicy, - saveGuardrailsPolicy, -} from "../infra/guardrails.mjs"; import { listCatalog, getCatalogEntry, @@ -337,9 +288,6 @@ import { resolveTuiAuthToken, } from "../infra/tui-bridge.mjs"; import { setComponentStatus } from "../infra/health-status.mjs"; -import { VaultStore } from "../lib/vault.mjs"; -import { keychainGetOrCreate } from "../lib/vault-keychain.mjs"; -import { INTEGRATIONS } from "../lib/integrations-registry.mjs"; const TASK_STORE_MODULE_PATH = "../task/task-store.mjs"; const TASK_STORE_START_GUARD_EXPORTS = [ @@ -1301,210 +1249,6 @@ function evaluateVoiceToolPolicy({ return { allow: true, statusCode: 200, message: "ok" }; } -// ── Workflow engine Worker-thread proxy ──────────────────────────────────────── -/** - * WorkflowEngineProxy hosts the WorkflowEngine in a dedicated Worker thread so - * that heavy node execution (execFileSync replacements, agent launches, etc.) - * can never block the HTTP / WebSocket event loop in the UI server process. - * - * The proxy mirrors the WorkflowEngine EventEmitter interface so that - * attachWorkflowEngineLiveBridge() works without modification. - */ -class WorkflowEngineProxy { - isWorkflowEngineProxy = true; - - constructor() { - this._worker = null; - this._pending = new Map(); // callId → { resolve, reject } - this._listeners = new Map(); // eventName → Set - this._ready = false; - this._initPromise = null; - } - - /** Start the Worker thread and wait for "ready". */ - _start(cfg = {}) { - if (this._initPromise !== null) return this._initPromise; - this._initPromise = new Promise((resolve, reject) => { - const workerPath = fileURLToPath(new URL("./workflow-engine-worker.mjs", import.meta.url)); - this._worker = new Worker(workerPath, { - workerData: cfg, - /* stdout/stderr inherit so worker logs appear in the same console */ - }); - - const failStart = (err) => { - if (!this._worker) { - reject(err); - return; - } - this._worker.off("message", onReady); - this._worker.off("message", onInitError); - reject(err); - }; - - const onReady = (msg) => { - if (!msg || msg.type !== "ready") return; - this._worker.off("message", onReady); - this._worker.off("message", onInitError); - this._ready = true; - resolve(); - }; - const onInitError = (msg) => { - if (!msg || msg.type !== "error" || msg.callId != null) return; - const err = new Error(msg.error || "workflow engine worker failed to initialize"); - if (msg.stack) err.stack = msg.stack; - failStart(err); - }; - this._worker.on("message", onReady); - this._worker.on("message", onInitError); - this._worker.once("error", failStart); - - this._worker.on("message", (msg) => this._onMessage(msg)); - this._worker.on("error", (err) => { - console.error("[wf-worker] worker thread error:", err.message); - }); - this._worker.on("exit", (code) => { - if (code !== 0) console.warn(`[wf-worker] worker exited with code ${code}`); - this._ready = false; - }); - - /* Send init after attaching all listeners */ - this._worker.postMessage({ type: "init", workerData: cfg }); - }); - return this._initPromise; - } - - _onMessage(msg) { - if (!msg || typeof msg.type !== "string") return; - - if (msg.type === "result" || msg.type === "error") { - const p = this._pending.get(msg.callId); - if (!p) return; - this._pending.delete(msg.callId); - if (msg.type === "error") { - const err = new Error(msg.error || "workflow engine error"); - if (msg.stack) err.stack = msg.stack; - p.reject(err); - } else { - p.resolve(msg.result); - } - return; - } - - if (msg.type === "event") { - const handlers = this._listeners.get(msg.eventName); - if (handlers) { - for (const h of handlers) { - try { h(msg.payload); } catch { /* best-effort */ } - } - } - return; - } - - if (msg.type === "svc-call") { - /* Service call from worker → execute in main thread and respond */ - this._dispatchServiceCall(msg.callId, msg.method, msg.args || []); - } - } - - async _dispatchServiceCall(callId, method, args) { - try { - const result = await this._executeService(method, args); - this._worker.postMessage({ type: "svc-res", callId, result }); - } catch (err) { - this._worker.postMessage({ type: "svc-res", callId, error: err.message, code: err.code }); - } - } - - async _executeService(method, args) { - /* Dispatch to in-process service functions */ - const [svc, fn] = method.split("."); - switch (svc) { - case "agentPool": { - if (fn === "launchEphemeralThread") return launchEphemeralThread(...args); - if (fn === "launchOrResumeThread") return launchOrResumeThread(...args); - if (fn === "execWithRetry") return execWithRetry(args[0], () => Promise.resolve(), args[2] || {}); - if (fn === "continueSession") { - const [sessionId, prompt, opts = {}] = args; - return launchEphemeralThread(prompt, opts.cwd || process.cwd(), opts.timeout || 3600000, { resumeThreadId: sessionId, sdk: opts.sdk }); - } - if (fn === "killSession") { - try { invalidateThread(args[0]); return true; } catch { return false; } - } - break; - } - case "telegram": { - if (fn === "sendMessage") return sendWorkflowTelegramMessage(args[0], args[1], args[2] || {}); - break; - } - case "kanban": { - const adapter = getKanbanAdapter(); - if (!adapter) throw new Error("Kanban adapter not available"); - if (fn === "createTask") return adapter.createTask?.(...args); - if (fn === "updateTaskStatus") return adapter.updateTaskStatus?.(...args); - if (fn === "listTasks") return adapter.listTasks?.(...args); - if (fn === "getTask") return adapter.getTask?.(...args); - break; - } - case "meeting": { - const meetMod = await import("../workflow/meeting-workflow-service.mjs").catch(() => null); - const svc_ = meetMod?.createMeetingWorkflowService?.(); - if (svc_ && typeof svc_[fn] === "function") return svc_[fn](...args); - break; - } - } - throw new Error(`Unknown service call: ${method}`); - } - - /** Proxy a method call to the worker and return a Promise of the result. */ - _call(method, args) { - return new Promise((resolve, reject) => { - if (!this._ready || !this._worker) { - return reject(new Error("Workflow engine worker not ready")); - } - const callId = _genCallId(); - this._pending.set(callId, { resolve, reject }); - this._worker.postMessage({ type: "call", callId, method, args }); - }); - } - - /* ── EventEmitter interface (subset used by attachWorkflowEngineLiveBridge) ── */ - on(eventName, handler) { - let handlers = this._listeners.get(eventName); - if (!handlers) { handlers = new Set(); this._listeners.set(eventName, handlers); } - handlers.add(handler); - return this; - } - off(eventName, handler) { - this._listeners.get(eventName)?.delete(handler); - return this; - } - - /* ── WorkflowEngine API surface ── */ - execute(workflowId, input, opts) { return this._call("execute", [workflowId, input, opts]); } - evaluateTriggers(eventType, payload) { return this._call("evaluateTriggers", [eventType, payload]); } - get(workflowId) { return this._call("get", [workflowId]); } - list(opts) { return this._call("list", [opts]); } - getRunHistory(workflowId, opts) { return this._call("getRunHistory", [workflowId, opts]); } - getRunHistoryPage(workflowId, opts) { return this._call("getRunHistoryPage", [workflowId, opts]); } - getRunDetail(runId, opts) { return this._call("getRunDetail", [runId, opts]); } - getRunForensics(runId) { return this._call("getRunForensics", [runId]); } - getNodeForensics(runId, nodeId) { return this._call("getNodeForensics", [runId, nodeId]); } - getRetryOptions(runId) { return this._call("getRetryOptions", [runId]); } - retryRun(runId, opts) { return this._call("retryRun", [runId, opts]); } - restoreFromSnapshot(runId, opts) { return this._call("restoreFromSnapshot", [runId, opts]); } - cancelRun(runId) { return this._call("cancelRun", [runId]); } - createRunSnapshot(runId, opts) { return this._call("createRunSnapshot", [runId, opts]); } - listSnapshots(workflowId) { return this._call("listSnapshots", [workflowId]); } - save(workflow) { return this._call("save", [workflow]); } - import(workflow) { return this._call("import", [workflow]); } - delete(workflowId) { return this._call("delete", [workflowId]); } - getConcurrencyStats() { return this._call("getConcurrencyStats", []); } - getTaskTraceEvents(opts) { return this._call("getTaskTraceEvents", [opts]); } - load() { return this._call("load", []); } - resumeInterruptedRuns() { return this._call("resumeInterruptedRuns", []); } - registerTaskTraceHook() { return null; /* hooks cannot cross thread boundary */ } -} - // ── Workflow engine lazy-loader (module-scope cache) ────────────────────────── let _wfEngine; let _wfNodes; @@ -1851,43 +1595,23 @@ async function getWorkflowEngineModule() { _wfServicesReady = true; if (shouldBootstrapDefaultWorkflowSingleton()) { - /* ── Start the workflow engine Worker thread (complete process decoupling) ── */ - const defaultPaths = getWorkflowStoragePaths(repoRoot); - const proxy = new WorkflowEngineProxy(); - try { - await proxy._start({ - repoRoot, - workflowDir: defaultPaths.workflowDir, - runsDir: defaultPaths.runsDir, + const engine = _wfEngine.getWorkflowEngine({ services }); + attachWorkflowEngineLiveBridge(engine); + if (!_wfTaskTraceHookRegistered && typeof engine?.registerTaskTraceHook === "function") { + engine.registerTaskTraceHook((event) => { + handleTaskWorkflowTraceEvent(event); }); - const defaultKey = getWorkflowWorkspaceKey(defaultPaths.workspaceRoot); - _wfEngineByWorkspace.set(defaultKey, proxy); - attachWorkflowEngineLiveBridge(proxy); - console.log("[workflows] Workflow engine Worker thread started"); + _wfTaskTraceHookRegistered = true; + } + // Resume any runs that were interrupted by a previous shutdown. + // This must happen AFTER services are wired so node executors work. + if (typeof engine.resumeInterruptedRuns === "function") { setTimeout(() => { - proxy.resumeInterruptedRuns().catch((err) => { + engine.resumeInterruptedRuns().catch((err) => { console.warn("[workflows] Failed to resume interrupted runs:", err.message); }); }, 0); - } catch (err) { - console.warn("[workflows] Worker thread start failed, falling back to in-process engine:", err.message); - /* Fall back: create engine in-process */ - const engine = _wfEngine.getWorkflowEngine({ services }); - attachWorkflowEngineLiveBridge(engine); - if (!_wfTaskTraceHookRegistered && typeof engine?.registerTaskTraceHook === "function") { - engine.registerTaskTraceHook((event) => { - handleTaskWorkflowTraceEvent(event); - }); - _wfTaskTraceHookRegistered = true; - } - if (typeof engine.resumeInterruptedRuns === "function") { - setTimeout(() => { - engine.resumeInterruptedRuns().catch((err) => { - console.warn("[workflows] Failed to resume interrupted runs:", err.message); - }); - }, 0); - } } } else { _wfRecommendedInstalled = true; @@ -1899,13 +1623,7 @@ async function getWorkflowEngineModule() { if (!_wfRecommendedInstalled && _wfTemplates && shouldBootstrapDefaultWorkflowSingleton()) { try { - const defaultPaths = getWorkflowStoragePaths(repoRoot); - const defaultKey = getWorkflowWorkspaceKey(defaultPaths.workspaceRoot); - const engine = _wfEngineByWorkspace.get(defaultKey) || _wfEngine.getWorkflowEngine(); - if (engine?.isWorkflowEngineProxy) { - _wfRecommendedInstalled = true; - return; - } + const engine = _wfEngine.getWorkflowEngine(); attachWorkflowEngineLiveBridge(engine); const selection = resolveWorkflowBootstrapSelection(_wfTemplates); let result = { installed: [], skipped: [], errors: [] }; @@ -2171,34 +1889,17 @@ async function collectWorkflowRunsForTask(taskId, reqUrl, limit = 40) { const out = []; for (const summary of summaries) { if (!summary?.runId) continue; - const summaryTaskIds = Array.isArray(summary?.taskIds) - ? summary.taskIds.map((value) => String(value || "").trim()).filter(Boolean) - : []; - const primaryTaskId = String(summary?.taskId || "").trim(); - let matches = primaryTaskId === normalizedTaskId || summaryTaskIds.includes(normalizedTaskId); - let data = {}; - let traceEvents = []; - if (!matches && engine.getRunDetail) { - const detail = engine.getRunDetail(summary.runId); - if (!detail?.detail) continue; - data = detail.detail?.data || {}; - const detailTaskId = String(data.taskId || data.activeTaskId || data?.task?.id || "").trim(); - matches = detailTaskId === normalizedTaskId; - } + const detail = engine.getRunDetail ? engine.getRunDetail(summary.runId) : null; + if (!detail?.detail) continue; + const data = detail.detail?.data || {}; + const primaryTaskId = String(data.taskId || data.activeTaskId || data?.task?.id || "").trim(); + let matches = primaryTaskId === normalizedTaskId; if (!matches && typeof engine.getTaskTraceEvents === "function") { - traceEvents = engine.getTaskTraceEvents(summary.runId) || []; + const traceEvents = engine.getTaskTraceEvents(summary.runId) || []; matches = traceEvents.some((event) => String(event?.taskId || "").trim() === normalizedTaskId); } if (!matches) continue; const primarySessionId = (() => { - for (const value of [ - summary?.primarySessionId, - summary?.sessionId, - ...(Array.isArray(summary?.sessionIds) ? summary.sessionIds : []), - ]) { - const normalized = String(value || "").trim(); - if (normalized) return normalized; - } for (const value of [ data.sessionId, data.threadId, @@ -2208,6 +1909,9 @@ async function collectWorkflowRunsForTask(taskId, reqUrl, limit = 40) { const normalized = String(value || "").trim(); if (normalized) return normalized; } + const traceEvents = typeof engine.getTaskTraceEvents === "function" + ? engine.getTaskTraceEvents(summary.runId) || [] + : []; for (let index = traceEvents.length - 1; index >= 0; index -= 1) { const event = traceEvents[index]; for (const value of [ @@ -2223,17 +1927,17 @@ async function collectWorkflowRunsForTask(taskId, reqUrl, limit = 40) { return null; })(); out.push({ - runId: summary.runId, - workflowId: summary.workflowId, - workflowName: summary.workflowName, - status: summary.status, - outcome: summary.status, - summary: summary.status === "failed" - ? `Workflow run failed (${summary.workflowName || summary.workflowId || summary.runId})` - : `Workflow run ${summary.status || "completed"} (${summary.workflowName || summary.workflowId || summary.runId})`, - startedAt: summary.startedAt || null, - endedAt: summary.endedAt || null, - duration: summary.duration || null, + runId: detail.runId, + workflowId: detail.workflowId, + workflowName: detail.workflowName, + status: detail.status, + outcome: detail.status, + summary: detail.status === "failed" + ? `Workflow run failed (${detail.workflowName || detail.workflowId || detail.runId})` + : `Workflow run ${detail.status || "completed"} (${detail.workflowName || detail.workflowId || detail.runId})`, + startedAt: detail.startedAt || null, + endedAt: detail.endedAt || null, + duration: detail.duration || null, sessionId: null, primarySessionId, source: "workflow", @@ -2257,48 +1961,6 @@ function sanitizeTaskDiagnosticText(value, maxLength = 240) { return `${normalized.slice(0, Math.max(0, maxLength - 1)).trimEnd()}…`; } -const TASK_LOG_DIAGNOSTICS_TAIL_BYTES = 256 * 1024; -const TASK_LOG_DIAGNOSTICS_CACHE_MS = 5000; - -function createEmptyTaskLogDiagnostics() { - return { - counts: { - prePrValidationFailed: 0, - worktreeFailed: 0, - blockedTransitions: 0, - createPrFailed: 0, - }, - entries: [], - }; -} - -async function readLogTailChunk(filePath, maxBytes = TASK_LOG_DIAGNOSTICS_TAIL_BYTES) { - const handle = await open(filePath, "r"); - try { - const info = await handle.stat(); - const size = Number(info?.size || 0); - if (!Number.isFinite(size) || size <= 0) return ""; - const length = Math.max(1, Math.min(size, Math.max(1, Math.trunc(maxBytes)))); - const offset = Math.max(0, size - length); - const buffer = Buffer.alloc(length); - await handle.read(buffer, 0, length, offset); - let text = buffer.toString("utf8"); - if (offset > 0) { - const firstNewline = text.indexOf("\n"); - if (firstNewline >= 0) { - text = text.slice(firstNewline + 1); - } - } - return text; - } finally { - try { - await handle.close(); - } catch { - // best effort - } - } -} - function collectTaskTimelineDiagnostics(task, limit = 8) { const timeline = Array.isArray(task?.timeline) ? task.timeline : []; const relevant = []; @@ -2332,17 +1994,22 @@ function collectTaskTimelineDiagnostics(task, limit = 8) { return relevant.slice(-Math.max(1, limit)); } -async function collectTaskLogDiagnostics(task, workspaceDir = "", limit = 8) { +function collectTaskLogDiagnostics(task, workspaceDir = "", limit = 8) { const taskId = String(task?.id || task?.taskId || "").trim(); if (!taskId) { - return createEmptyTaskLogDiagnostics(); + return { + counts: { + prePrValidationFailed: 0, + worktreeFailed: 0, + blockedTransitions: 0, + createPrFailed: 0, + }, + entries: [], + }; } const taskBranch = String(task?.branch || task?.branchName || "").trim(); const needles = [taskId, taskBranch].filter((value) => value && value.length >= 8); - if (needles.length === 0) { - return createEmptyTaskLogDiagnostics(); - } const logPaths = []; const pushLogPath = (candidate) => { if (!candidate || !existsSync(candidate) || logPaths.includes(candidate)) return; @@ -2355,69 +2022,57 @@ async function collectTaskLogDiagnostics(task, workspaceDir = "", limit = 8) { pushLogPath(resolve(repoRoot, ".bosun", "logs", "monitor-error.log")); pushLogPath(resolve(repoRoot, ".bosun", "logs", "monitor.log")); - const cacheKey = `task-log-diagnostics:${taskId}:${taskBranch}:${normalizeCandidatePath(workspaceDir) || repoRoot}`; - return getOrComputeCachedApiResponse(cacheKey, TASK_LOG_DIAGNOSTICS_CACHE_MS, async () => { - const counts = { - prePrValidationFailed: 0, - worktreeFailed: 0, - blockedTransitions: 0, - createPrFailed: 0, - }; - const entries = []; - const logChunks = await Promise.all( - logPaths.map(async (logPath) => { - try { - return { - logPath, - raw: await readLogTailChunk(logPath), - }; - } catch { - return null; - } - }), - ); + const counts = { + prePrValidationFailed: 0, + worktreeFailed: 0, + blockedTransitions: 0, + createPrFailed: 0, + }; + const entries = []; - for (const chunk of logChunks) { - if (!chunk?.raw) continue; - const logName = /monitor-error\.log$/i.test(chunk.logPath) - ? "monitor-error.log" - : "monitor.log"; - for (const line of chunk.raw.split(/\r?\n/)) { - if (!line) continue; - if (!needles.some((needle) => line.includes(needle))) continue; - const text = sanitizeTaskDiagnosticText(line, 320); - let matched = false; - if (/pre-PR validation failed/i.test(text)) { - counts.prePrValidationFailed += 1; - matched = true; - } - if (/Worktree failed for/i.test(text) || /Worktree acquisition failed/i.test(text)) { - counts.worktreeFailed += 1; - matched = true; - } - if (/-> blocked/i.test(text) || /status: .*blocked/i.test(text)) { - counts.blockedTransitions += 1; - matched = true; - } - if (/create-pr FAILED/i.test(text)) { - counts.createPrFailed += 1; - matched = true; - } - if (!matched) continue; - entries.push({ - source: logName, - message: text, - kind: "log", - }); - if (entries.length > limit) entries.shift(); - } + for (const logPath of logPaths) { + let raw = ""; + try { + raw = readFileSync(logPath, "utf8"); + } catch { + continue; } + const logName = /monitor-error\.log$/i.test(logPath) ? "monitor-error.log" : "monitor.log"; + for (const line of raw.split(/\r?\n/)) { + if (!line) continue; + if (!needles.some((needle) => line.includes(needle))) continue; + const text = sanitizeTaskDiagnosticText(line, 320); + let matched = false; + if (/pre-PR validation failed/i.test(text)) { + counts.prePrValidationFailed += 1; + matched = true; + } + if (/Worktree failed for/i.test(text) || /Worktree acquisition failed/i.test(text)) { + counts.worktreeFailed += 1; + matched = true; + } + if (/-> blocked/i.test(text) || /status: .*blocked/i.test(text)) { + counts.blockedTransitions += 1; + matched = true; + } + if (/create-pr FAILED/i.test(text)) { + counts.createPrFailed += 1; + matched = true; + } + if (!matched) continue; + entries.push({ + source: logName, + message: text, + kind: "log", + }); + if (entries.length > limit) entries.shift(); + } + } - return { counts, entries }; - }); + return { counts, entries }; } -async function buildTaskBlockedContext(task, options = {}) { +function buildTaskBlockedContext(task, options = {}) { const currentTask = task && typeof task === "object" ? task : {}; const canStart = options.canStart && typeof options.canStart === "object" ? options.canStart @@ -2437,7 +2092,7 @@ async function buildTaskBlockedContext(task, options = {}) { ? currentTask.workflowRuns : []; const timelineEvidence = collectTaskTimelineDiagnostics(currentTask, 6); - const logDiagnostics = await collectTaskLogDiagnostics( + const logDiagnostics = collectTaskLogDiagnostics( currentTask, normalizeCandidatePath(options.workspaceDir), 6, @@ -2597,38 +2252,22 @@ async function getWorkflowRequestContext(reqUrl, options = {}) { if (_testDefaultEngine) { engine = _testDefaultEngine; } else { - const preferInProcessEngine = Boolean(process.env.VITEST); - if (!preferInProcessEngine) { - /* Use Worker thread proxy for complete decoupling from the HTTP event loop */ - const proxy = new WorkflowEngineProxy(); - try { - await proxy._start({ - repoRoot, - workflowDir: paths.workflowDir, - runsDir: paths.runsDir, - }); - engine = proxy; - } catch (startErr) { - console.warn("[workflows] Worker thread unavailable, using in-process engine:", startErr.message); - } - } - if (!engine) { - engine = new wfMod.WorkflowEngine({ - workflowDir: paths.workflowDir, - runsDir: paths.runsDir, - detectInterruptedRuns: false, - services: _wfServices || {}, - onTaskWorkflowEvent: handleTaskWorkflowTraceEvent, + engine = new wfMod.WorkflowEngine({ + workflowDir: paths.workflowDir, + runsDir: paths.runsDir, + detectInterruptedRuns: false, + services: _wfServices || {}, + onTaskWorkflowEvent: handleTaskWorkflowTraceEvent, + }); + attachWorkflowEngineLiveBridge(engine); + if (typeof engine.registerTaskTraceHook === "function") { + engine.registerTaskTraceHook((event) => { + handleTaskWorkflowTraceEvent(event); }); - if (typeof engine.registerTaskTraceHook === "function") { - engine.registerTaskTraceHook((event) => { - handleTaskWorkflowTraceEvent(event); - }); - } - engine.load(); } - attachWorkflowEngineLiveBridge(engine); + engine.load(); } + attachWorkflowEngineLiveBridge(engine); _wfEngineByWorkspace.set(workspaceKey, engine); } if (options.bootstrapTemplates !== false) { @@ -2714,7 +2353,7 @@ function collectTaskLinkedSessionIds(task, tracker = null) { const taskKeySet = new Set(taskKeys); const sessionTracker = tracker || getSessionTracker(); const sessions = typeof sessionTracker?.listAllSessions === "function" - ? sessionTracker.listAllSessions({ includePersisted: true }) + ? sessionTracker.listAllSessions() : []; for (const session of sessions) { const sessionTaskId = normalizeDiffTaskRef(session?.taskId); @@ -2972,75 +2611,6 @@ function taskMatchesWorkspaceContext(task, workspaceContext) { ); } -function resolveWorkspaceFleetConfig(workspaceContext = {}) { - const configDir = resolveUiConfigDir(); - if (!configDir) return null; - const listed = listManagedWorkspaces(configDir, { repoRoot }); - const workspaceId = String(workspaceContext?.workspaceId || "").trim().toLowerCase(); - const workspace = - (workspaceId - ? listed.find((entry) => String(entry?.id || "").trim().toLowerCase() === workspaceId) - : null) || - getActiveManagedWorkspace(configDir) || - listed[0] || - null; - return workspace && typeof workspace === "object" ? workspace : null; -} - -function buildWorkspaceExecutorSummary(execStatus, workspaceContext) { - if (!execStatus || typeof execStatus !== "object" || !workspaceContext) return null; - const allSlots = Array.isArray(execStatus.slots) - ? execStatus.slots.map((slot, slotIndex) => ({ ...slot, slotIndex })) - : []; - const workspace = resolveWorkspaceFleetConfig(workspaceContext); - const executors = - workspace?.executors && typeof workspace.executors === "object" - ? workspace.executors - : null; - const configuredSlots = Math.max(0, Number(executors?.maxConcurrent || 0) || 0); - const globalMaxParallel = Math.max( - 0, - Number(execStatus.maxParallel || 0) || allSlots.length, - ); - const taskIndex = new Map(); - for (const task of getAllInternalTasks()) { - const taskId = String(task?.id || task?.taskId || "").trim(); - if (taskId) taskIndex.set(taskId, task); - } - const slots = workspaceContext.allWorkspaces - ? allSlots - : allSlots.filter((slot) => { - const taskId = String(slot?.taskId || "").trim(); - const task = taskIndex.get(taskId) || { id: taskId, workspace: "", meta: {} }; - return taskMatchesWorkspaceContext(task, workspaceContext); - }); - const activeSlots = slots.filter((slot) => { - const status = String(slot?.status || "").trim().toLowerCase(); - return status === "running" || status === "busy"; - }).length; - const maxParallel = configuredSlots > 0 - ? configuredSlots - : Math.max(globalMaxParallel, slots.length, activeSlots); - return { - workspaceId: String(workspaceContext.workspaceId || "").trim(), - workspaceDir: normalizeCandidatePath(workspaceContext.workspaceDir) || repoRoot, - workspaceRoot: - normalizeCandidatePath(workspaceContext.workspaceRoot) - || normalizeCandidatePath(workspaceContext.workspaceDir) - || repoRoot, - workspaceName: String(workspace?.name || workspace?.id || workspaceContext.workspaceId || "All workspaces").trim(), - pool: String(executors?.pool || "shared").trim() || "shared", - configuredSlots, - maxParallel, - activeSlots, - freeSlots: Math.max(0, maxParallel - activeSlots), - capacityPct: maxParallel > 0 ? Math.round((activeSlots / maxParallel) * 100) : 0, - globalMaxParallel, - globalActiveSlots: Math.max(0, Number(execStatus.activeSlots || 0) || 0), - slots, - }; -} - async function listTasksForWorkspaceContext(workspaceContext, { status = "", projectId = "" } = {}) { const adapter = getKanbanAdapter(); const projects = await adapter.listProjects(); @@ -3072,41 +2642,30 @@ async function collectBenchmarkWorkflowRuns(reqUrl, taskIds = new Set(), limit = const runs = []; for (const summary of summaries) { if (!summary?.runId) continue; - const summaryTaskIds = Array.isArray(summary?.taskIds) - ? summary.taskIds.map((value) => String(value || "").trim()).filter(Boolean) - : []; - const primaryTaskId = String(summary?.taskId || "").trim(); + const detail = wfCtx.engine.getRunDetail ? wfCtx.engine.getRunDetail(summary.runId) : null; + if (!detail?.detail) continue; + const data = detail.detail?.data || {}; + const primaryTaskId = String( + data.taskId || data.activeTaskId || data?.task?.id || "", + ).trim(); let matches = Boolean(primaryTaskId && taskIds.has(primaryTaskId)); - if (!matches && summaryTaskIds.length > 0) { - matches = summaryTaskIds.some((taskId) => taskIds.has(taskId)); - } - if (!matches && typeof wfCtx.engine.getRunDetail === "function") { - const detail = wfCtx.engine.getRunDetail(summary.runId); - if (detail?.detail) { - const data = detail.detail?.data || {}; - const detailTaskId = String( - data.taskId || data.activeTaskId || data?.task?.id || "", - ).trim(); - matches = Boolean(detailTaskId && taskIds.has(detailTaskId)); - } - } if (!matches && typeof wfCtx.engine.getTaskTraceEvents === "function") { const traceEvents = wfCtx.engine.getTaskTraceEvents(summary.runId) || []; matches = traceEvents.some((event) => taskIds.has(String(event?.taskId || "").trim())); } if (!matches) continue; runs.push({ - runId: summary.runId, - workflowId: summary.workflowId, - workflowName: summary.workflowName, - status: summary.status, - startedAt: summary.startedAt || null, - endedAt: summary.endedAt || null, - duration: summary.duration || null, + runId: detail.runId, + workflowId: detail.workflowId, + workflowName: detail.workflowName, + status: detail.status, + startedAt: detail.startedAt || null, + endedAt: detail.endedAt || null, + duration: detail.duration || null, summary: - summary.status === "failed" - ? `Workflow run failed (${summary.workflowName || summary.workflowId || summary.runId})` - : `Workflow run ${summary.status || "completed"} (${summary.workflowName || summary.workflowId || summary.runId})`, + detail.status === "failed" + ? `Workflow run failed (${detail.workflowName || detail.workflowId || detail.runId})` + : `Workflow run ${detail.status || "completed"} (${detail.workflowName || detail.workflowId || detail.runId})`, }); if (runs.length >= limit) break; } @@ -4424,7 +3983,6 @@ function normalizeCandidatePath(input) { if (!input) return ""; const raw = String(input).trim(); if (!raw) return ""; - if (hasUnresolvedTemplateTokens(raw)) return ""; try { return resolve(raw); } catch { @@ -5331,7 +4889,7 @@ async function buildWorktreePeek(wt) { const tracker = getSessionTracker(); const sessions = tracker - .listAllSessions({ includePersisted: false }) + .listAllSessions() .filter((s) => s.taskId === wt.taskKey || s.id === wt.taskKey); return { @@ -5597,8 +5155,6 @@ const UI_INSTANCE_LOCK_FILE = "ui-server.instance.lock.json"; const UI_SESSION_TOKEN_FILE = "ui-session-token.json"; const TUI_SESSION_TOKEN_FILE = "ui-token"; const UI_LAST_PORT_FILE = "ui-last-port.json"; -const DEFAULT_UI_INSTANCE_PROBE_TIMEOUT_MS = 1500; -const DEFAULT_UI_INSTANCE_STALE_GRACE_MS = 2 * 60 * 1000; const DEFAULT_AUTO_OPEN_COOLDOWN_MS = 12 * 60 * 60 * 1000; // 12h const DEFAULT_SESSION_TOKEN_TTL_MS = 30 * 24 * 60 * 60 * 1000; // 30 days const wsClients = new Set(); @@ -5674,7 +5230,7 @@ let _activeSessions = []; function getLiveSessionSnapshot({ includeHidden = false } = {}) { const tracker = getSessionTracker(); - let sessions = tracker.listAllSessions({ includePersisted: false }); + let sessions = tracker.listAllSessions(); if (!includeHidden) { sessions = sessions.filter((session) => { const detailed = tracker.getSessionById(session.id) || session; @@ -5744,10 +5300,6 @@ function resolveUiConfigDir() { try { mkdirSync(fromConfigPath, { recursive: true }); } catch { /* ok */ } return fromConfigPath; } - if (sandbox && process.env.BOSUN_TEST_ALLOW_REPO_LOCAL_CONFIG !== "1") { - try { mkdirSync(sandbox.configDir, { recursive: true }); } catch { /* ok */ } - return sandbox.configDir; - } if (String(process.env.REPO_ROOT || "").trim()) { const repoLocalConfigDirCandidates = [ resolve(repoRoot, ".bosun"), @@ -5872,113 +5424,7 @@ function writeUiInstanceLock(path, payload = {}) { } } -function clearUiInstanceLockFile(path) { - try { - if (path && existsSync(path)) unlinkSync(path); - } catch { - // best effort - } -} - -function describeUiInstanceTarget(payload = {}) { - return payload?.url - || (payload?.port - ? `${payload?.protocol || "http"}://${payload?.host || "127.0.0.1"}:${payload.port}` - : "unknown"); -} - -function normalizeUiProbeHost(host) { - const normalized = String(host || "").trim().toLowerCase(); - if ( - !normalized || - normalized === "0.0.0.0" || - normalized === "::" || - normalized === "[::]" || - normalized === "::0" - ) { - return "127.0.0.1"; - } - return normalized === "localhost" ? "127.0.0.1" : normalized; -} - -async function probeUiHealth(urlText, timeoutMs = DEFAULT_UI_INSTANCE_PROBE_TIMEOUT_MS) { - try { - const parsed = new URL(String(urlText || "")); - const isHttps = parsed.protocol === "https:"; - const requestImpl = isHttps ? httpsRequest : httpRequest; - const host = normalizeUiProbeHost(parsed.hostname); - return await new Promise((resolveProbe) => { - let settled = false; - const settle = (value) => { - if (settled) return; - settled = true; - resolveProbe(Boolean(value)); - }; - const req = requestImpl( - { - protocol: isHttps ? "https:" : "http:", - host, - port: parsed.port ? Number(parsed.port) : (isHttps ? 443 : 80), - path: "/healthz", - method: "GET", - timeout: Math.max(100, Math.trunc(Number(timeoutMs) || DEFAULT_UI_INSTANCE_PROBE_TIMEOUT_MS)), - }, - (res) => { - res.resume(); - settle(Number(res.statusCode || 0) >= 200 && Number(res.statusCode || 0) < 500); - }, - ); - req.on("error", () => settle(false)); - req.on("timeout", () => { - try { req.destroy(new Error("timeout")); } catch { /* best effort */ } - settle(false); - }); - req.end(); - }); - } catch { - return false; - } -} - -async function isUiInstanceResponsive(existing, { probeTimeoutMs } = {}) { - const port = Number(existing?.port || 0); - if (!Number.isFinite(port) || port <= 0 || port > 65535) return false; - const protocol = String(existing?.protocol || "").trim().toLowerCase() === "https" ? "https" : "http"; - const candidateUrls = []; - if (existing?.url) candidateUrls.push(String(existing.url)); - const host = normalizeUiProbeHost(existing?.host); - candidateUrls.push(`${protocol}://${host}:${port}`); - if (host !== "127.0.0.1") { - candidateUrls.push(`${protocol}://127.0.0.1:${port}`); - } - for (const candidate of new Set(candidateUrls.filter(Boolean))) { - if (await probeUiHealth(candidate, probeTimeoutMs)) return true; - } - return false; -} - -async function shouldTreatUiInstanceLockAsStale( - existing, - { - staleGraceMs = DEFAULT_UI_INSTANCE_STALE_GRACE_MS, - probeTimeoutMs = DEFAULT_UI_INSTANCE_PROBE_TIMEOUT_MS, - } = {}, -) { - if (!existing || existing.pid === process.pid) return false; - if (!isPidRunning(existing.pid)) return true; - const startedAt = Number(existing.startedAt || 0); - const ageMs = startedAt > 0 ? Math.max(0, Date.now() - startedAt) : Number.POSITIVE_INFINITY; - if (ageMs < Math.max(0, Math.trunc(Number(staleGraceMs) || DEFAULT_UI_INSTANCE_STALE_GRACE_MS))) { - return false; - } - return !(await isUiInstanceResponsive(existing, { probeTimeoutMs })); -} - -async function tryAcquireUiInstanceLock({ - preferredPort = 0, - staleGraceMs = DEFAULT_UI_INSTANCE_STALE_GRACE_MS, - probeTimeoutMs = DEFAULT_UI_INSTANCE_PROBE_TIMEOUT_MS, -} = {}) { +function tryAcquireUiInstanceLock({ preferredPort = 0 } = {}) { const lockPath = resolveUiInstanceLockPath(); uiInstanceLockPath = lockPath; const payload = { @@ -6010,15 +5456,14 @@ async function tryAcquireUiInstanceLock({ const current = readUiInstanceLock(lockPath); if (current && current.pid !== process.pid && isPidRunning(current.pid)) { - if (!(await shouldTreatUiInstanceLockAsStale(current, { staleGraceMs, probeTimeoutMs }))) { - return { ok: false, existing: current }; - } - console.warn( - `[telegram-ui] stale ui runtime lock detected (pid=${current.pid}) — reclaiming ${describeUiInstanceTarget(current)}`, - ); + return { ok: false, existing: current }; } - clearUiInstanceLockFile(lockPath); + try { + if (existsSync(lockPath)) unlinkSync(lockPath); + } catch { + // best effort + } try { return tryCreateLock(); @@ -6201,40 +5646,19 @@ function ensureSessionToken() { } function readLastUiPort() { - return readLastUiPortRecord()?.port || 0; -} - -function readLastUiPortRecord() { try { const portPath = resolveUiCachePath(UI_LAST_PORT_FILE); - if (!existsSync(portPath)) return null; + if (!existsSync(portPath)) return 0; const payload = JSON.parse(readFileSync(portPath, "utf8")); const port = Number(payload?.port || 0); - if (!Number.isFinite(port) || port <= 0 || port > 65535) return null; - return { - port: Math.trunc(port), - updatedAt: Number(payload?.updatedAt || 0) || 0, - pid: Number(payload?.pid || 0) || 0, - host: String(payload?.host || ""), - protocol: String(payload?.protocol || ""), - url: String(payload?.url || ""), - configDir: String(payload?.configDir || ""), - }; - } catch { - return null; - } -} - -function clearLastUiPort() { - try { - const portPath = resolveUiCachePath(UI_LAST_PORT_FILE); - if (existsSync(portPath)) unlinkSync(portPath); + if (!Number.isFinite(port) || port <= 0 || port > 65535) return 0; + return Math.trunc(port); } catch { - // best effort + return 0; } } -function persistLastUiPort(port, metadata = {}) { +function persistLastUiPort(port) { const normalized = Number(port || 0); if (!Number.isFinite(normalized) || normalized <= 0 || normalized > 65535) { return; @@ -6248,10 +5672,6 @@ function persistLastUiPort(port, metadata = {}) { port: Math.trunc(normalized), updatedAt: Date.now(), pid: process.pid, - host: String(metadata.host || ""), - protocol: String(metadata.protocol || ""), - url: String(metadata.url || ""), - configDir: resolveUiConfigDir(), }, null, 2, @@ -6963,154 +6383,11 @@ function normalizeGatesPolicy(raw = {}, options = {}) { }; } -function hasGuardrailsOverride(input = {}) { - if (!input || typeof input !== "object") return false; - return [ - input?.guardrailsOverride, - input?.overrideGuardrails, - input?.INPUTOverride, - input?.guardrails?.override, - input?.override?.guardrails, - ].some((value) => parseBooleanLike(value, false) === true); -} - -function resolveRequireReviewGuardrail() { - const explicit = process.env.BOSUN_FLOW_REQUIRE_REVIEW; - if (explicit !== undefined && String(explicit).trim() !== "") { - return parseBooleanLike(explicit, true); - } - return true; -} - -function resolvePreflightGuardrail(configData = {}) { - if (configData?.preflightEnabled !== undefined) { - return parseBooleanLike(configData.preflightEnabled, true); - } - return true; -} - -function buildHookGuardrailsOverview(rootDir) { - const catalog = getHookCatalog(); - const coreHooks = getCoreHooks(); - const defaultHooks = getDefaultHooks(); - const persistedState = loadHookState(rootDir); - const explicitStateKeys = Object.keys(persistedState?.enabled || {}); - const effectiveEnabledIds = explicitStateKeys.length > 0 - ? new Set(getEnabledHookIds(rootDir)) - : new Set(defaultHooks.map((hook) => hook.id)); - - return { - total: catalog.length, - coreCount: coreHooks.length, - defaultCount: defaultHooks.length, - enabledCount: effectiveEnabledIds.size, - enabledIds: [...effectiveEnabledIds].sort(), - hasPersistedState: explicitStateKeys.length > 0, - updatedAt: persistedState?.updatedAt || null, - categories: getHookCategories().map((category) => ({ - ...category, - enabledCount: catalog.filter((hook) => hook.category === category.id && effectiveEnabledIds.has(hook.id)).length, - })), - }; -} - -function buildTaskGuardrailsInput(body = {}, context = {}) { - return { - title: body?.title, - description: body?.description, - metadata: { - project: context.projectId || body?.project || "", - workspace: context.workspace || body?.workspace || "", - repository: context.repository || body?.repository || "", - repositories: context.repositories || body?.repositories || [], - priority: body?.priority || "", - status: body?.status || "", - type: body?.type || "", - tags: context.tags || body?.tags || [], - ...context.metadataTopLevel, - ...context.metadata, - ...(body?.meta && typeof body.meta === "object" ? body.meta : {}), - ...(body?.metadata && typeof body.metadata === "object" ? body.metadata : {}), - }, - }; -} - -function buildManualFlowGuardrailsInput(template, templateId, formValues = {}, executionContext = {}) { - return { - title: template?.name || templateId || "manual-flow", - description: template?.description || "", - metadata: { - templateId, - category: template?.category || "", - tags: Array.isArray(template?.tags) ? template.tags : [], - executionContext, - }, - formValues, - }; -} - -function buildGuardrailsSnapshot() { - const workspaceContext = resolveActiveWorkspaceExecutionContext(); - const workspaceDir = String(workspaceContext?.workspaceDir || repoRoot).trim() || repoRoot; - const { configData } = readConfigDocument(); - const guardrailsPolicy = ensureGuardrailsPolicy(workspaceDir); - const hooks = buildHookGuardrailsOverview(workspaceDir); - const repoGuardrails = detectRepoGuardrails(workspaceDir); - const runtime = { - preflightEnabled: resolvePreflightGuardrail(configData), - requireReview: resolveRequireReviewGuardrail(), - gates: normalizeGatesPolicy(configData?.gates, { - worktreeBootstrap: configData?.worktreeBootstrap, - }), - prAutomation: normalizePrAutomationPolicy(configData?.prAutomation, { includeOAuthTrustedAuthor: true }), - }; - - const warnings = []; - if (!runtime.preflightEnabled) warnings.push("Preflight checks are disabled."); - if (!runtime.requireReview) warnings.push("Review requirement is disabled."); - if (!guardrailsPolicy.INPUT.enabled) warnings.push("INPUT enforcement is disabled."); - if (!guardrailsPolicy.push.workflowOnly) warnings.push("Workflow-only push ownership is disabled."); - if (!guardrailsPolicy.push.blockAgentPushes) warnings.push("Agents are allowed to push directly."); - if (!guardrailsPolicy.push.requireManagedPrePush) warnings.push("Managed worktree pre-push validation is not required."); - if (!repoGuardrails.categories.prepush.detected) warnings.push("No prepush package script detected."); - if (!repoGuardrails.categories.ci.detected) warnings.push("No CI-like package scripts detected."); - - return { - workspace: { - workspaceId: workspaceContext?.workspaceId || "", - workspaceDir, - workspaceRoot: workspaceContext?.workspaceRoot || workspaceDir, - }, - summary: { - status: warnings.length === 0 ? "guarded" : warnings.length <= 2 ? "partial" : "needs-attention", - counts: { - hooksEnabled: hooks.enabledCount, - hooksTotal: hooks.total, - repoGuardrailsDetected: repoGuardrails.detectedCount, - runtimeEnabled: Number(runtime.preflightEnabled) + Number(runtime.requireReview), - INPUTEnabled: guardrailsPolicy.INPUT.enabled ? 1 : 0, - }, - warnings, - }, - hooks, - runtime, - repoGuardrails, - INPUT: { - policyPath: getGuardrailsPolicyPath(workspaceDir), - policy: guardrailsPolicy.INPUT, - }, - push: { - policyPath: getGuardrailsPolicyPath(workspaceDir), - policy: guardrailsPolicy.push, - }, - }; -} - -function validateConfigSchemaChanges(changes) { - try { - const schema = getConfigSchema(); - const validator = getConfigValidator(); - if (!schema || !validator) return {}; +function validateConfigSchemaChanges(changes) { + try { + const schema = getConfigSchema(); + const validator = getConfigValidator(); + if (!schema || !validator) return {}; const configPath = resolveConfigPath(); let configData = {}; @@ -8307,7 +7584,6 @@ async function spawnCloudflared(cfBin, args, maxRetries = 3) { return spawn(cfBin, args, { stdio: ["ignore", "pipe", "pipe"], detached: false, - windowsHide: true, }); } catch (err) { if (err.code === "ETXTBSY" && attempt < maxRetries) { @@ -8976,7 +8252,7 @@ function scrubStackTraces(payload) { return out; } function normalizeJsonResponsePayload(payload) { - return makeJsonSafe(scrubStackTraces(payload), { maxDepth: 12 }); + return makeJsonSafe(scrubStackTraces(payload), { maxDepth: 6 }); } function makeJsonSafe(value, options = {}) { @@ -10682,25 +9958,17 @@ function broadcastCanonicalEvent(channels, type, payload = {}) { payload, ts: Date.now(), }; - /* Yield the event loop between sends so HTTP requests aren't starved during - workflow event bursts (e.g. 20 PRs × many node transitions). */ - if (wsClients.size > 0) { - setImmediate(() => { - for (const socket of wsClients) { - const subscribed = socket.__channels || new Set(["*"]); - const shouldSend = subscribed.has("*") || Array.from(required).some((channel) => subscribed.has(channel)); - if (shouldSend) sendWsMessage(socket, message); - } - }); + for (const socket of wsClients) { + const subscribed = socket.__channels || new Set(["*"]); + const shouldSend = subscribed.has("*") || Array.from(required).some((channel) => subscribed.has(channel)); + if (shouldSend) sendWsMessage(socket, message); } } function getCurrentSessionSnapshot() { try { const tracker = getSessionTracker(); - return buildSessionsUpdatePayload( - tracker?.listAllSessions?.({ includePersisted: false }) || [], - ); + return buildSessionsUpdatePayload(tracker?.listAllSessions?.() || []); } catch { return []; } @@ -12399,33 +11667,6 @@ async function readStatusSnapshot() { } } -async function readUiWorktreeRecovery() { - const snapshot = await readStatusSnapshot(); - if (snapshot && typeof snapshot === "object" && snapshot.worktreeRecovery) { - return snapshot.worktreeRecovery; - } - return readWorktreeRecoveryState(repoRoot); -} - -/** - * Non-blocking async shell exec for git/gh calls inside HTTP request handlers. - * Prevents execSync/spawnSync from blocking the event loop and starving other requests. - */ -function execAsync(cmd, { cwd, timeout = 10_000, encoding = "utf8" } = {}) { - return new Promise((resolve, reject) => { - const child = exec(cmd, { cwd, timeout, encoding, windowsHide: true }); - let stdout = ""; - let stderr = ""; - child.stdout?.on("data", (d) => { stdout += d; }); - child.stderr?.on("data", (d) => { stderr += d; }); - child.on("close", (code) => { - if (code === 0 || code === null) resolve(stdout); - else reject(Object.assign(new Error(`exec failed (${code}): ${cmd}`), { stdout, stderr, exitCode: code })); - }); - child.on("error", reject); - }); -} - function runGit(args, timeoutMs = 10000) { const argList = Array.isArray(args) ? args @@ -12911,18 +12152,7 @@ function withinDays(entry, days) { async function readCompletedSessionEntries(maxLines = 100_000) { // Check multiple candidate paths — repoRoot may be the monorepo root // while data lives under the bosun subdirectory. - // When REPO_ROOT is not explicitly set, OR when repoRoot resolves to a - // workspace clone (e.g. .bosun/workspaces//bosun), the module-relative - // path is added first so we find the data written by task-executor - // (__dirname-relative) even when resolveRepoRoot() returns a workspace clone - // path instead of the module root. - const repoRootNorm = resolve(repoRoot).replace(/\\/g, "/"); - const isWorkspaceClone = repoRootNorm.includes("/.bosun/workspaces/"); - const useModuleRelative = !process.env.REPO_ROOT || isWorkspaceClone; const candidates = [ - ...(useModuleRelative - ? [resolve(__dirname, "..", ".cache", "session-accumulator.jsonl")] - : []), resolve(repoRoot, ".cache", "session-accumulator.jsonl"), resolve(repoRoot, "bosun", ".cache", "session-accumulator.jsonl"), ]; @@ -13113,12 +12343,6 @@ async function buildUsageAnalytics(days) { const dailySkills = {}; /** dailyMcp[date][tool] = count */ const dailyMcp = {}; - /** dailyInputTokens[date] = total input tokens */ - const dailyInputTokens = {}; - /** dailyOutputTokens[date] = total output tokens */ - const dailyOutputTokens = {}; - /** dailyTotalTokens[date] = total tokens */ - const dailyTotalTokens = {}; const allDates = new Set(); @@ -13135,11 +12359,6 @@ async function buildUsageAnalytics(days) { if (ts > newestTs) newestTs = ts; const day = getEntryDayKey(session, ts); if (day) allDates.add(day); - if (day) { - dailyInputTokens[day] = (dailyInputTokens[day] || 0) + numberOrZero(session.inputTokens); - dailyOutputTokens[day] = (dailyOutputTokens[day] || 0) + numberOrZero(session.outputTokens); - dailyTotalTokens[day] = (dailyTotalTokens[day] || 0) + numberOrZero(session.tokenCount); - } agentRuns += 1; const exec = String(session.executor || session.model || "unknown").trim() || "unknown"; @@ -13214,15 +12433,7 @@ async function buildUsageAnalytics(days) { const topSkillNames = topSkills.slice(0, 6).map((s) => s.name); const topMcpNames = topMcpTools.slice(0, 6).map((t) => t.name); - const trend = { - dates: sortedDates, - agents: {}, - skills: {}, - mcpTools: {}, - tokens: sortedDates.map((d) => dailyTotalTokens[d] || 0), - inputTokens: sortedDates.map((d) => dailyInputTokens[d] || 0), - outputTokens: sortedDates.map((d) => dailyOutputTokens[d] || 0), - }; + const trend = { dates: sortedDates, agents: {}, skills: {}, mcpTools: {} }; for (const name of topAgentNames) { trend.agents[name] = sortedDates.map((d) => dailyAgents[d]?.[name] || 0); } @@ -13233,17 +12444,10 @@ async function buildUsageAnalytics(days) { trend.mcpTools[name] = sortedDates.map((d) => dailyMcp[d]?.[name] || 0); } - const totalTokens = sessionWindow.reduce((sum, session) => sum + numberOrZero(session.tokenCount), 0); - const totalInputTokens = sessionWindow.reduce((sum, session) => sum + numberOrZero(session.inputTokens), 0); - const totalOutputTokens = sessionWindow.reduce((sum, session) => sum + numberOrZero(session.outputTokens), 0); - return { agentRuns, skillInvocations, mcpToolCalls, - totalTokens, - totalInputTokens, - totalOutputTokens, avgPerDay, lastActiveAt: newestTs < Infinity && newestTs > 0 ? new Date(newestTs).toISOString() : null, sinceAt: oldestTs < Infinity ? new Date(oldestTs).toISOString() : null, @@ -13260,18 +12464,7 @@ async function buildUsageAnalytics(days) { } function resolveAgentWorkLogDir() { - // When REPO_ROOT is not explicitly set, OR when repoRoot resolves to a - // workspace clone (e.g. .bosun/workspaces//bosun), the module-relative - // path is added first so we find the data written by task-executor - // (__dirname-relative) even when resolveRepoRoot() returns a workspace clone - // path instead of the module root. - const repoRootNorm = resolve(repoRoot).replace(/\\/g, "/"); - const isWorkspaceClone = repoRootNorm.includes("/.bosun/workspaces/"); - const useModuleRelative = !process.env.REPO_ROOT || isWorkspaceClone; const candidates = [ - ...(useModuleRelative - ? [resolve(__dirname, "..", ".cache", "agent-work-logs")] - : []), resolve(repoRoot, ".cache", "agent-work-logs"), // When repoRoot is the monorepo root, data lives under bosun/.cache resolve(repoRoot, "bosun", ".cache", "agent-work-logs"), @@ -13438,25 +12631,6 @@ async function readReplayableAgentRun(attemptId) { const first = events[0] || null; const last = events[events.length - 1] || null; const overview = buildReplayOverview(events); - const turns = []; - let turnIndex = 0; - for (const event of events) { - if (event?.type !== "usage") continue; - turnIndex += 1; - const usage = event?.data?.usage && typeof event.data.usage === "object" ? event.data.usage : {}; - const tokenCount = Number(usage.total_tokens ?? usage.totalTokens ?? event?.data?.tokenCount ?? 0) || 0; - const inputTokens = Number(usage.input_tokens ?? usage.inputTokens ?? 0) || 0; - const outputTokens = Number(usage.output_tokens ?? usage.outputTokens ?? 0) || 0; - const durationMs = Number(event?.data?.duration_ms ?? event?.data?.durationMs ?? 0) || 0; - turns.push({ - index: turnIndex, - timestamp: event.timestamp || null, - tokenCount, - inputTokens, - outputTokens, - durationMs, - }); - } return { attemptId: normalizedAttemptId, taskId: first?.taskId || last?.taskId || null, @@ -13469,7 +12643,6 @@ async function readReplayableAgentRun(attemptId) { : "in_progress", shortSteps: overview.shortSteps, totals: overview.totals, - turns, events, }; } @@ -13733,10 +12906,7 @@ async function resolveTaskLinkedWorktreePath(task, tracker = null) { const sessionTracker = tracker || getSessionTracker(); for (const sessionId of collectTaskLinkedSessionIds(task, sessionTracker)) { - const session = - sessionTracker?.getSessionById?.(sessionId) || - sessionTracker?.getSessionMessages?.(sessionId) || - sessionTracker?.getSession?.(sessionId); + const session = sessionTracker?.getSession?.(sessionId); const worktreePath = await resolveSessionWorktreePath(session); if (worktreePath && existsSync(worktreePath)) return worktreePath; } @@ -13758,17 +12928,13 @@ async function handleApi(req, res, url) { if (req.method === "OPTIONS") { res.writeHead(204, { "Access-Control-Allow-Origin": "*", - "Access-Control-Allow-Methods": "GET,POST,PUT,DELETE,OPTIONS", + "Access-Control-Allow-Methods": "GET,POST,OPTIONS", "Access-Control-Allow-Headers": "Content-Type,X-Telegram-InitData,X-Bosun-Fallback-Auth", }); res.end(); return; } - if (path.startsWith("/api/vault")) { - if (await handleVaultApi(req, res, path)) return; - } - if (path === "/api/auth/fallback/status" && req.method === "GET") { jsonResponse(res, 200, { ok: true, @@ -13807,45 +12973,6 @@ async function handleApi(req, res, url) { return; } - if (path === "/api/health") { - const payload = await getOrComputeCachedApiResponse("health", 2000, async () => ({ - ok: true, - uptime: process.uptime(), - wsClients: wsClients.size, - lanIp: getLocalLanIp(), - url: getTelegramUiUrl(), - })); - jsonResponse(res, 200, payload); - return; - } - - if (path === "/api/health-stats") { - const payload = await getOrComputeCachedApiResponse("health-stats", 30_000, async () => { - const SIX_HOURS_MS = 6 * 60 * 60 * 1000; - const cutoff = new Date(Date.now() - SIX_HOURS_MS).toISOString(); - let successRuns = 0; - let failedRuns = 0; - try { - const tasks = getAllInternalTasks(); - for (const task of tasks) { - for (const entry of (task.statusHistory || [])) { - if (entry.timestamp < cutoff) continue; - const normalizedStatus = String(entry.status || "").toLowerCase(); - if (normalizedStatus === "done") successRuns++; - else if (normalizedStatus === "error" || normalizedStatus === "failed" || normalizedStatus === "blocked") failedRuns++; - } - } - } catch { - // Task store not loaded or unavailable - } - const total = successRuns + failedRuns; - const failRate = total > 0 ? failedRuns / total : 0; - return { ok: true, successRuns, failedRuns, total, failRate, windowHours: 6 }; - }); - jsonResponse(res, 200, payload); - return; - } - const authResult = await requireAuth(req); if (!authResult?.ok) { jsonResponse(res, 401, { @@ -13955,40 +13082,9 @@ async function handleApi(req, res, url) { if (path === "/api/executor") { const executor = uiDeps.getInternalExecutor?.(); const mode = uiDeps.getExecutorMode?.() || "internal"; - const execStatus = executor?.getStatus?.() || null; - const workspaceContext = resolveWorkspaceContextFromRequest(url, { allowAll: false }) - || resolveActiveWorkspaceExecutionContext(); - /* Augment with active workflow run counts so Fleet Overview reflects - real system load even when no agent subprocess slots are occupied */ - let activeWorkflowRuns = 0; - let workflowRunDetails = []; - try { - const wfCtx = await getWorkflowRequestContext(url, { bootstrapTemplates: false }).catch(() => null); - if (wfCtx?.ok && wfCtx.engine) { - const runs = await Promise.resolve(wfCtx.engine.list?.() || []).catch(() => []); - const active = (Array.isArray(runs) ? runs : []).filter( - (r) => String(r?.status || "").toLowerCase() === "running" - ); - activeWorkflowRuns = active.length; - workflowRunDetails = active.slice(0, 20).map((r) => ({ - runId: r.id || r.runId, - workflowId: r.workflowId, - workflowName: r.workflowName || r.workflowId, - startedAt: r.startedAt, - activeNodeCount: r.activeNodeCount || 0, - })); - } - } catch { - // best-effort: executor data is still returned without workflow augmentation - } - const workspaceSummary = execStatus - ? buildWorkspaceExecutorSummary(execStatus, workspaceContext) - : null; jsonResponse(res, 200, { ok: true, - data: execStatus - ? { ...execStatus, workspaceSummary, activeWorkflowRuns, workflowRunDetails } - : null, + data: executor?.getStatus?.() || null, mode, paused: executor?.isPaused?.() || false, }); @@ -14604,7 +13700,7 @@ async function handleApi(req, res, url) { const sprintId = resolveTaskSprintId(detailTask); const sprintDag = includeDag && sprintId ? await getSprintDagData(sprintId) : null; const globalDag = includeDag ? await getGlobalDagData() : null; - const blockedContext = await buildTaskBlockedContext(detailTask, { + const blockedContext = buildTaskBlockedContext(detailTask, { canStart, workflowRuns: mergedWorkflowRuns, workspaceDir: workspaceContext?.workspaceDir || repoRoot, @@ -16362,33 +15458,6 @@ async function handleApi(req, res, url) { ? body.repositories.filter((value) => typeof value === "string" && value.trim()) : []; const metadataFields = buildTaskMetadataPatch(body || {}); - const workspaceContext = resolveActiveWorkspaceExecutionContext(); - const guardrailsRootDir = String(workspaceContext?.workspaceDir || repoRoot).trim() || repoRoot; - const INPUTPolicy = loadGuardrailsPolicy(guardrailsRootDir); - const taskAssessment = assessInputQuality( - buildTaskGuardrailsInput(body, { - projectId, - workspace, - repository, - repositories, - tags, - metadataTopLevel: metadataFields.topLevel, - metadata: metadataFields.meta, - }), - INPUTPolicy.INPUT, - ); - const taskAssessmentPayload = taskAssessment.blocked && hasGuardrailsOverride(body || {}) - ? { ...taskAssessment, overrideAccepted: true } - : taskAssessment; - if (taskAssessment.blocked && taskAssessmentPayload.overrideAccepted !== true) { - jsonResponse(res, 400, { - ok: false, - error: "Input blocked by INPUT guardrails", - code: "guardrails_INPUT_blocked", - assessment: taskAssessmentPayload, - }); - return; - } const taskData = { title: String(title).trim(), description: body?.description || "", @@ -16414,7 +15483,7 @@ async function handleApi(req, res, url) { }; const createdRaw = await adapter.createTask(projectId, taskData); const created = withTaskMetadataTopLevel(createdRaw); - jsonResponse(res, 200, { ok: true, data: created, assessment: taskAssessmentPayload }); + jsonResponse(res, 200, { ok: true, data: created }); broadcastUiEvent(["tasks", "overview"], "invalidate", { reason: "task-created", taskId: created?.id || null, @@ -17164,35 +16233,13 @@ async function handleApi(req, res, url) { } if (action === "enable") { const result = enableHook(rootDir, hookId); - if (result.success) { - broadcastUiEvent(["guardrails", "library", "overview"], "invalidate", { - reason: "hook-state-updated", - action, - hookId, - workspaceId: workspaceContext.workspaceId || "", - }); - } jsonResponse(res, result.success ? 200 : 400, { ok: result.success, ...result }); } else if (action === "disable") { const force = body?.force === true; const result = disableHook(rootDir, hookId, force); - if (result.success) { - broadcastUiEvent(["guardrails", "library", "overview"], "invalidate", { - reason: "hook-state-updated", - action, - hookId, - workspaceId: workspaceContext.workspaceId || "", - }); - } jsonResponse(res, result.success ? 200 : 400, { ok: result.success, ...result }); } else if (action === "initialize") { const state = initializeHookState(rootDir); - broadcastUiEvent(["guardrails", "library", "overview"], "invalidate", { - reason: "hook-state-initialized", - action, - hookId, - workspaceId: workspaceContext.workspaceId || "", - }); jsonResponse(res, 200, { ok: true, data: state }); } else { jsonResponse(res, 400, { ok: false, error: `Unknown action: ${action}. Use enable, disable, or initialize.` }); @@ -17432,16 +16479,12 @@ async function handleApi(req, res, url) { // ── Workspace Management API ────────────────────────────────────────────── if (path === "/api/workspaces") { try { - const payload = await getOrComputeCachedApiResponse(`workspaces:${repoRoot}`, 3000, async () => { - const configDir = resolveUiConfigDir(); - // Auto-initialize workspaces from disk if config has none yet. - // This path can touch the filesystem repeatedly under UI polling. - const { workspaces: initialized } = initializeWorkspaces(configDir, { repoRoot }); - const workspaces = initialized.length > 0 ? initialized : listManagedWorkspaces(configDir, { repoRoot }); - const active = getActiveManagedWorkspace(configDir); - return { ok: true, data: workspaces, activeId: active?.id || null }; - }); - jsonResponse(res, 200, payload); + const configDir = resolveUiConfigDir(); + // Auto-initialize workspaces from disk if config has none yet + const { workspaces: initialized } = initializeWorkspaces(configDir, { repoRoot }); + const workspaces = initialized.length > 0 ? initialized : listManagedWorkspaces(configDir, { repoRoot }); + const active = getActiveManagedWorkspace(configDir); + jsonResponse(res, 200, { ok: true, data: workspaces, activeId: active?.id || null }); } catch (err) { jsonResponse(res, 500, { ok: false, error: err.message }); } @@ -17480,8 +16523,6 @@ async function handleApi(req, res, url) { return; } setActiveManagedWorkspace(configDir, wsId); - invalidateApiCache("workspaces:"); - invalidateApiCache("workflows:"); const active = getActiveManagedWorkspace(configDir); jsonResponse(res, 200, { ok: true, @@ -17503,22 +16544,20 @@ async function handleApi(req, res, url) { if (path === "/api/workspaces/active/repos") { try { - const payload = await getOrComputeCachedApiResponse(`workspaces:active-repos:${repoRoot}`, 3000, async () => { - const configDir = resolveUiConfigDir(); - const active = getActiveManagedWorkspace(configDir); - if (!active) { - return { ok: true, repos: [] }; - } - const repos = Array.isArray(active.repos) - ? active.repos.map((r) => ({ - name: r.name || r.path || "", - path: r.path || "", - primary: Boolean(r.primary), - })) - : []; - return { ok: true, repos }; - }); - jsonResponse(res, 200, payload); + const configDir = resolveUiConfigDir(); + const active = getActiveManagedWorkspace(configDir); + if (!active) { + jsonResponse(res, 200, { ok: true, repos: [] }); + return; + } + const repos = Array.isArray(active.repos) + ? active.repos.map((r) => ({ + name: r.name || r.path || "", + path: r.path || "", + primary: Boolean(r.primary), + })) + : []; + jsonResponse(res, 200, { ok: true, repos }); } catch (err) { jsonResponse(res, 500, { ok: false, error: err.message }); } @@ -17749,7 +16788,7 @@ async function handleApi(req, res, url) { try { const worktrees = listActiveWorktrees(repoRoot); const stats = await getWorktreeStats(repoRoot); - const recovery = await readUiWorktreeRecovery(); + const recovery = await readWorktreeRecoveryState(repoRoot); const recoveryBackfill = buildRecoveryBackfilledWorktrees(worktrees, recovery); jsonResponse(res, 200, { ok: true, @@ -18406,30 +17445,34 @@ if (path === "/api/agent-logs/context") { let gitStatus = ""; let diffStat = ""; try { - gitLog = (await execAsync("git log --oneline -5", { + gitLog = execSync("git log --oneline -5 2>&1", { cwd: wtPath, + encoding: "utf8", timeout: 10000, - })).trim(); + }).trim(); } catch { gitLog = ""; } try { - gitStatus = (await execAsync("git status --short", { + gitStatus = execSync("git status --short 2>&1", { cwd: wtPath, + encoding: "utf8", timeout: 10000, - })).trim(); + }).trim(); } catch { gitStatus = ""; } try { - const branch = (await execAsync("git branch --show-current", { + const branch = execSync("git branch --show-current 2>&1", { cwd: wtPath, + encoding: "utf8", timeout: 5000, - })).trim(); - diffStat = (await execAsync(`git diff --stat main...${branch}`, { + }).trim(); + diffStat = execSync(`git diff --stat main...${branch} 2>&1`, { cwd: wtPath, + encoding: "utf8", timeout: 10000, - })).trim(); + }).trim(); } catch { diffStat = ""; } @@ -18479,7 +17522,7 @@ if (path === "/api/agent-logs/context") { try { const executor = uiDeps.getInternalExecutor?.(); const status = executor?.getStatus?.() || {}; - const worktreeRecovery = await readUiWorktreeRecovery(); + const worktreeRecovery = await readWorktreeRecoveryState(repoRoot); const data = { executor: { mode: uiDeps.getExecutorMode?.() || "internal", @@ -18617,17 +17660,17 @@ if (path === "/api/agent-logs/context") { wtPath = resolve(worktreeDir, wtName); worktreeMatches.push(...matches); } - const runWtGit = async (args) => { + const runWtGit = (args) => { try { - return (await execAsync(`git ${args}`, { cwd: wtPath, timeout: 5000 })).trim(); + return execSync(`git ${args}`, { cwd: wtPath, encoding: "utf8", timeout: 5000 }).trim(); } catch { return ""; } }; - const gitLog = await runWtGit("log --oneline -10"); - const gitLogDetailed = await runWtGit("log --format=%h||%D||%s||%cr -10"); - const gitStatus = await runWtGit("status --porcelain"); - const gitBranch = await runWtGit("rev-parse --abbrev-ref HEAD"); - const gitDiffStat = await runWtGit("diff --stat"); - const gitAheadBehind = await runWtGit("rev-list --left-right --count HEAD...@{upstream} 2>/dev/null"); + const gitLog = runWtGit("log --oneline -10"); + const gitLogDetailed = runWtGit("log --format=%h||%D||%s||%cr -10"); + const gitStatus = runWtGit("status --porcelain"); + const gitBranch = runWtGit("rev-parse --abbrev-ref HEAD"); + const gitDiffStat = runWtGit("diff --stat"); + const gitAheadBehind = runWtGit("rev-list --left-right --count HEAD...@{upstream} 2>/dev/null"); const changedFiles = gitStatus ? gitStatus .split("\n") @@ -18778,11 +17821,12 @@ if (path === "/api/agent-logs/context") { jsonResponse(res, 400, { ok: false, error: "branch is required" }); return; } - const hasRef = async (ref) => { + const hasRef = (ref) => { try { - await execAsync(`git show-ref --verify --quiet ${ref}`, { + execSync(`git show-ref --verify --quiet ${ref}`, { cwd: repoRoot, timeout: 5000, + stdio: "ignore", }); return true; } catch { @@ -18790,10 +17834,10 @@ if (path === "/api/agent-logs/context") { } }; const baseRef = - ((await hasRef("refs/heads/main")) && "main") || - ((await hasRef("refs/remotes/origin/main")) && "origin/main") || - ((await hasRef("refs/heads/master")) && "master") || - ((await hasRef("refs/remotes/origin/master")) && "origin/master") || + (hasRef("refs/heads/main") && "main") || + (hasRef("refs/remotes/origin/main") && "origin/main") || + (hasRef("refs/heads/master") && "master") || + (hasRef("refs/remotes/origin/master") && "origin/master") || null; const diffRange = baseRef ? `${baseRef}...${safe}` : `${safe}~1..${safe}`; const commitsRaw = runGit(`log ${safe} --format=%h||%s||%cr -20`, 15000); @@ -19092,28 +18136,19 @@ if (path === "/api/agent-logs/context") { if (path === "/api/workflows") { try { - const payload = await getOrComputeCachedApiResponse(`workflows:list:${url.search}`, 3000, async () => { - const wfCtx = await getWorkflowRequestContext(url, { bootstrapTemplates: false }); - if (!wfCtx.ok) { - return { __error: true, status: wfCtx.status, body: { ok: false, error: wfCtx.error } }; - } - const engine = wfCtx.engine; - const all = (await engine.list()).filter((workflow) => !shouldHideGeneratedWorkflowFromList(workflow)); - return { - ok: true, - workflows: all.map((w) => ({ - id: w.id, name: w.name, description: w.description, category: w.category, - enabled: w.enabled !== false, - nodeCount: Number.isFinite(w.nodeCount) ? w.nodeCount : (w.nodes || []).length, - trigger: w.trigger || (w.nodes || [])[0]?.type || "manual", - })), - }; - }); - if (payload?.__error) { - jsonResponse(res, payload.status, payload.body); + const wfCtx = await getWorkflowRequestContext(url, { bootstrapTemplates: false }); + if (!wfCtx.ok) { + jsonResponse(res, wfCtx.status, { ok: false, error: wfCtx.error }); return; } - jsonResponse(res, 200, payload); + const engine = wfCtx.engine; + const all = engine.list().filter((workflow) => !shouldHideGeneratedWorkflowFromList(workflow)); + jsonResponse(res, 200, { ok: true, workflows: all.map(w => ({ + id: w.id, name: w.name, description: w.description, category: w.category, + enabled: w.enabled !== false, + nodeCount: Number.isFinite(w.nodeCount) ? w.nodeCount : (w.nodes || []).length, + trigger: w.trigger || (w.nodes || [])[0]?.type || "manual", + })) }); } catch (err) { jsonResponse(res, 500, { ok: false, error: err.message }); } @@ -19133,7 +18168,6 @@ if (path === "/api/agent-logs/context") { _wfTemplates.applyWorkflowTemplateState(body); } const saved = await engine.save(body); - invalidateApiCache("workflows:"); jsonResponse(res, 200, { ok: true, workflow: saved }); } catch (err) { jsonResponse(res, 500, { ok: false, error: err.message }); @@ -19152,7 +18186,6 @@ if (path === "/api/agent-logs/context") { const engine = wfCtx.engine; const workflowPayload = body?.workflow ?? body; const imported = await engine.import(workflowPayload); - invalidateApiCache("workflows:"); jsonResponse(res, 200, { ok: true, workflow: imported }); } catch (err) { jsonResponse(res, 500, { ok: false, error: err.message }); @@ -19163,12 +18196,7 @@ if (path === "/api/agent-logs/context") { // GET /api/workflows/concurrency — live concurrency stats for dashboard if (path === "/api/workflows/concurrency" && req.method === "GET") { try { - const wfCtx = await getWorkflowRequestContext(url, { bootstrapTemplates: false }); - if (!wfCtx.ok) { - jsonResponse(res, wfCtx.status, { ok: false, error: wfCtx.error }); - return; - } - const stats = await wfCtx.engine.getConcurrencyStats(); + const stats = engine.getConcurrencyStats(); jsonResponse(res, 200, { ok: true, ...stats }); } catch (err) { jsonResponse(res, 500, { ok: false, error: err.message }); @@ -19493,10 +18521,10 @@ if (path === "/api/agent-logs/context") { ? Math.min(rawLimit, 5000) : 20; const page = typeof engine.getRunHistoryPage === "function" - ? await engine.getRunHistoryPage(null, { offset, limit }) + ? engine.getRunHistoryPage(null, { offset, limit }) : { - runs: engine.getRunHistory ? await engine.getRunHistory(null, limit) : [], - total: engine.getRunHistory ? (await engine.getRunHistory(null)).length : 0, + runs: engine.getRunHistory ? engine.getRunHistory(null, limit) : [], + total: engine.getRunHistory ? engine.getRunHistory(null).length : 0, offset, limit, }; @@ -19542,7 +18570,7 @@ if (path === "/api/agent-logs/context") { } if (action === "copilot-context" && (req.method === "GET" || req.method === "POST")) { - const run = typeof engine.getRunDetail === "function" ? await engine.getRunDetail(runId) : null; + const run = typeof engine.getRunDetail === "function" ? engine.getRunDetail(runId) : null; if (!run) { jsonResponse(res, 404, { ok: false, error: "Workflow run not found" }); return; @@ -19555,14 +18583,14 @@ if (path === "/api/agent-logs/context") { requestBody?.nodeId || url.searchParams.get("nodeId") || "", ).trim(); const workflow = typeof engine.get === "function" - ? await engine.get(String(run?.workflowId || "").trim()) + ? engine.get(String(run?.workflowId || "").trim()) : null; const nodeForensics = nodeId && typeof engine.getNodeForensics === "function" - ? await engine.getNodeForensics(runId, nodeId) + ? engine.getNodeForensics(runId, nodeId) : null; const runForensics = typeof engine.getRunForensics === "function" - ? await engine.getRunForensics(runId) + ? engine.getRunForensics(runId) : null; const payload = buildRunCopilotContextPayload(run, { intent, @@ -19589,7 +18617,7 @@ if (path === "/api/agent-logs/context") { } const body = await readJsonBody(req); const reason = String(body?.reason || "Run cancellation requested from UI").trim() || "Run cancellation requested from UI"; - const result = await engine.cancelRun(runId, { reason }); + const result = engine.cancelRun(runId, { reason }); if (!result?.ok) { const statusCode = String(result?.error || "").includes("not found") ? 404 : 409; jsonResponse(res, statusCode, { @@ -19615,7 +18643,7 @@ if (path === "/api/agent-logs/context") { // If mode is omitted, returns available retry options so the UI can // present a choice to the user. if (action === "retry" && req.method === "POST") { - const run = engine.getRunDetail ? await engine.getRunDetail(runId) : null; + const run = engine.getRunDetail ? engine.getRunDetail(runId) : null; if (!run) { jsonResponse(res, 404, { ok: false, error: "Workflow run not found" }); return; @@ -19628,7 +18656,7 @@ if (path === "/api/agent-logs/context") { const mode = body?.mode; if (!mode) { const retryOptions = typeof engine.getRetryOptions === "function" - ? await engine.getRetryOptions(runId) + ? engine.getRetryOptions(runId) : null; if (retryOptions) { jsonResponse(res, 200, { @@ -19672,7 +18700,7 @@ if (path === "/api/agent-logs/context") { return; } const forensics = typeof engine.getNodeForensics === "function" - ? await engine.getNodeForensics(runId, nodeId) + ? engine.getNodeForensics(runId, nodeId) : null; if (!forensics) { jsonResponse(res, 404, { ok: false, error: "Node not found in run" }); @@ -19685,7 +18713,7 @@ if (path === "/api/agent-logs/context") { // ── GET /api/workflows/runs/:id/forensics — full run forensics ── if (action === "forensics" && req.method === "GET") { const forensics = typeof engine.getRunForensics === "function" - ? await engine.getRunForensics(runId) + ? engine.getRunForensics(runId) : null; if (!forensics) { jsonResponse(res, 404, { ok: false, error: "Run not found" }); @@ -19697,7 +18725,7 @@ if (path === "/api/agent-logs/context") { // ── GET /api/workflows/runs/:id/evaluate — run evaluation ─────── if (action === "evaluate" && req.method === "GET") { - const run = engine.getRunDetail ? await engine.getRunDetail(runId) : null; + const run = engine.getRunDetail ? engine.getRunDetail(runId) : null; if (!run) { jsonResponse(res, 404, { ok: false, error: "Workflow run not found" }); return; @@ -19715,7 +18743,7 @@ if (path === "/api/agent-logs/context") { jsonResponse(res, 501, { ok: false, error: "Snapshots not supported" }); return; } - const result = await engine.createRunSnapshot(runId); + const result = engine.createRunSnapshot(runId); if (!result) { jsonResponse(res, 404, { ok: false, error: "Run not found" }); return; @@ -19726,10 +18754,10 @@ if (path === "/api/agent-logs/context") { // ── GET /api/workflows/runs/:id/snapshots — list snapshots ────── if (action === "snapshots" && req.method === "GET") { - const run = engine.getRunDetail ? await engine.getRunDetail(runId) : null; + const run = engine.getRunDetail ? engine.getRunDetail(runId) : null; const workflowId = run?.workflowId || run?.detail?.data?._workflowId || null; const snapshots = typeof engine.listSnapshots === "function" - ? await engine.listSnapshots(workflowId) + ? engine.listSnapshots(workflowId) : []; jsonResponse(res, 200, { ok: true, snapshots }); return; @@ -19756,7 +18784,7 @@ if (path === "/api/agent-logs/context") { // ── POST /api/workflows/runs/:id/remediate — apply fix actions ── if (action === "remediate" && req.method === "POST") { - const run = engine.getRunDetail ? await engine.getRunDetail(runId) : null; + const run = engine.getRunDetail ? engine.getRunDetail(runId) : null; if (!run) { jsonResponse(res, 404, { ok: false, error: "Workflow run not found" }); return; @@ -19873,42 +18901,39 @@ if (path === "/api/agent-logs/context") { } if (action === "runs") { - const payload = await getOrComputeCachedApiResponse(`workflows:runs:${workflowId}:${url.search}`, 2000, async () => { - const rawOffset = Number(url.searchParams.get("offset")); - const rawLimit = Number(url.searchParams.get("limit")); - const offset = Number.isFinite(rawOffset) && rawOffset > 0 - ? Math.max(0, Math.floor(rawOffset)) - : 0; - const limit = Number.isFinite(rawLimit) && rawLimit > 0 - ? Math.min(rawLimit, 5000) - : 20; - const page = typeof engine.getRunHistoryPage === "function" - ? engine.getRunHistoryPage(workflowId, { offset, limit }) - : { - runs: engine.getRunHistory ? engine.getRunHistory(workflowId, limit) : [], - total: engine.getRunHistory ? engine.getRunHistory(workflowId).length : 0, - offset, - limit, - }; - const runs = Array.isArray(page?.runs) ? page.runs : []; - const total = Number.isFinite(Number(page?.total)) ? Number(page.total) : runs.length; - const nextOffset = Number.isFinite(Number(page?.nextOffset)) - ? Number(page.nextOffset) - : (offset + runs.length < total ? offset + runs.length : null); - return { - ok: true, - runs, - pagination: { - total, + const rawOffset = Number(url.searchParams.get("offset")); + const rawLimit = Number(url.searchParams.get("limit")); + const offset = Number.isFinite(rawOffset) && rawOffset > 0 + ? Math.max(0, Math.floor(rawOffset)) + : 0; + const limit = Number.isFinite(rawLimit) && rawLimit > 0 + ? Math.min(rawLimit, 5000) + : 20; + const page = typeof engine.getRunHistoryPage === "function" + ? engine.getRunHistoryPage(workflowId, { offset, limit }) + : { + runs: engine.getRunHistory ? engine.getRunHistory(workflowId, limit) : [], + total: engine.getRunHistory ? engine.getRunHistory(workflowId).length : 0, offset, limit, - count: runs.length, - hasMore: page?.hasMore === true || (nextOffset != null && nextOffset < total), - nextOffset, - }, - }; + }; + const runs = Array.isArray(page?.runs) ? page.runs : []; + const total = Number.isFinite(Number(page?.total)) ? Number(page.total) : runs.length; + const nextOffset = Number.isFinite(Number(page?.nextOffset)) + ? Number(page.nextOffset) + : (offset + runs.length < total ? offset + runs.length : null); + jsonResponse(res, 200, { + ok: true, + runs, + pagination: { + total, + offset, + limit, + count: runs.length, + hasMore: page?.hasMore === true || (nextOffset != null && nextOffset < total), + nextOffset, + }, }); - jsonResponse(res, 200, payload); return; } @@ -20136,18 +19161,9 @@ if (path === "/api/agent-logs/context") { } // GET — return full workflow definition - const payload = await getOrComputeCachedApiResponse(`workflows:detail:${workflowId}:${url.search}`, 3000, async () => { - const wf = engine.get(workflowId); - if (!wf) { - return { __error: true, status: 404, body: { ok: false, error: "Workflow not found" } }; - } - return { ok: true, workflow: wf }; - }); - if (payload?.__error) { - jsonResponse(res, payload.status, payload.body); - return; - } - jsonResponse(res, 200, payload); + const wf = engine.get(workflowId); + if (!wf) { jsonResponse(res, 404, { ok: false, error: "Workflow not found" }); return; } + jsonResponse(res, 200, { ok: true, workflow: wf }); } catch (err) { jsonResponse(res, 500, { ok: false, error: err.message }); } @@ -20521,24 +19537,6 @@ if (path === "/api/agent-logs/context") { } const mf = await import("../workflow/manual-flows.mjs"); const ctx = resolveActiveWorkspaceExecutionContext(); - const template = mf.getFlowTemplate(templateId, ctx.workspaceDir); - const INPUTPolicy = loadGuardrailsPolicy(ctx.workspaceDir || repoRoot); - const flowAssessment = assessInputQuality( - buildManualFlowGuardrailsInput(template, templateId, formValues || {}, executionContext || {}), - INPUTPolicy.INPUT, - ); - const flowAssessmentPayload = flowAssessment.blocked && hasGuardrailsOverride(body || {}) - ? { ...flowAssessment, overrideAccepted: true } - : flowAssessment; - if (flowAssessment.blocked && flowAssessmentPayload.overrideAccepted !== true) { - jsonResponse(res, 400, { - ok: false, - error: "Input blocked by INPUT guardrails", - code: "guardrails_INPUT_blocked", - assessment: flowAssessmentPayload, - }); - return; - } const wfCtx = await getWorkflowRequestContext(url, { bootstrapTemplates: false }); const repository = String( executionContext?.repository || @@ -20575,7 +19573,7 @@ if (path === "/api/agent-logs/context") { }, }; const run = await mf.executeFlow(templateId, formValues || {}, ctx.workspaceDir, flowContext); - jsonResponse(res, 200, { ok: true, run, assessment: flowAssessmentPayload }); + jsonResponse(res, 200, { ok: true, run }); } catch (err) { jsonResponse(res, 500, { ok: false, error: err.message }); } @@ -20662,142 +19660,6 @@ if (path === "/api/agent-logs/context") { return; } - if (path === "/api/guardrails" && req.method === "GET") { - try { - const snapshot = buildGuardrailsSnapshot(); - jsonResponse(res, 200, { ok: true, snapshot }); - } catch (err) { - jsonResponse(res, 500, { ok: false, error: err.message }); - } - return; - } - - if (path === "/api/guardrails/policy" && req.method === "POST") { - try { - const body = await readJsonBody(req); - const INPUTPatch = body?.INPUT && typeof body.INPUT === "object" ? body.INPUT : null; - const pushPatch = body?.push && typeof body.push === "object" ? body.push : null; - const directPatch = body && typeof body === "object" && !Array.isArray(body) - ? body - : null; - const nextINPUTPatch = INPUTPatch || (directPatch && !Object.prototype.hasOwnProperty.call(directPatch, "push") ? directPatch : null); - if (!nextINPUTPatch && !pushPatch) { - jsonResponse(res, 400, { ok: false, error: "INPUT or push policy object is required" }); - return; - } - - const workspaceContext = resolveActiveWorkspaceExecutionContext(); - const workspaceDir = String(workspaceContext?.workspaceDir || repoRoot).trim() || repoRoot; - const currentPolicy = ensureGuardrailsPolicy(workspaceDir); - const nextPolicy = saveGuardrailsPolicy(workspaceDir, { - ...currentPolicy, - INPUT: nextINPUTPatch - ? { - ...currentPolicy.INPUT, - ...nextINPUTPatch, - } - : currentPolicy.INPUT, - push: pushPatch - ? { - ...currentPolicy.push, - ...pushPatch, - } - : currentPolicy.push, - }); - const snapshot = buildGuardrailsSnapshot(); - broadcastUiEvent(["guardrails", "settings", "overview"], "invalidate", { - reason: "guardrails-policy-updated", - }); - jsonResponse(res, 200, { - ok: true, - INPUT: { - policyPath: getGuardrailsPolicyPath(workspaceDir), - policy: nextPolicy.INPUT, - }, - push: { - policyPath: getGuardrailsPolicyPath(workspaceDir), - policy: nextPolicy.push, - }, - snapshot, - }); - } catch (err) { - jsonResponse(res, 500, { ok: false, error: err.message }); - } - return; - } - - if (path === "/api/guardrails/runtime" && req.method === "POST") { - try { - const body = await readJsonBody(req); - const runtimePatch = body?.runtime && typeof body.runtime === "object" - ? body.runtime - : body && typeof body === "object" - ? body - : null; - const preflightProvided = runtimePatch && hasOwn(runtimePatch, "preflightEnabled"); - const requireReviewProvided = runtimePatch && hasOwn(runtimePatch, "requireReview"); - if (!preflightProvided && !requireReviewProvided) { - jsonResponse(res, 400, { - ok: false, - error: "preflightEnabled or requireReview must be provided", - }); - return; - } - - let configPath = resolveConfigPath(); - if (preflightProvided) { - const { configPath: nextConfigPath, configData } = readConfigDocument(); - configPath = nextConfigPath; - configData.preflightEnabled = parseBooleanLike(runtimePatch.preflightEnabled, true); - writeFileSync(configPath, JSON.stringify(configData, null, 2) + "\n", "utf8"); - } - - const envPath = resolve(resolveUiConfigDir(), ".env"); - if (requireReviewProvided) { - const requireReview = parseBooleanLike(runtimePatch.requireReview, true); - process.env.BOSUN_FLOW_REQUIRE_REVIEW = requireReview ? "true" : "false"; - updateEnvFile({ BOSUN_FLOW_REQUIRE_REVIEW: process.env.BOSUN_FLOW_REQUIRE_REVIEW }); - } - - const snapshot = buildGuardrailsSnapshot(); - broadcastUiEvent(["guardrails", "settings", "overview"], "invalidate", { - reason: "guardrails-runtime-updated", - }); - jsonResponse(res, 200, { - ok: true, - configPath, - envPath, - runtime: snapshot.runtime, - snapshot, - }); - } catch (err) { - jsonResponse(res, 500, { ok: false, error: err.message }); - } - return; - } - - if (path === "/api/guardrails/assess" && req.method === "POST") { - try { - const body = await readJsonBody(req); - const workspaceContext = resolveActiveWorkspaceExecutionContext(); - const workspaceDir = String(workspaceContext?.workspaceDir || repoRoot).trim() || repoRoot; - const policy = ensureGuardrailsPolicy(workspaceDir); - const assessmentInput = body?.input ?? body?.payload ?? body?.assessmentInput ?? body; - const assessment = assessInputQuality(assessmentInput, policy.INPUT); - jsonResponse(res, 200, { - ok: true, - assessment, - INPUT: { - policyPath: getGuardrailsPolicyPath(workspaceDir), - policy: policy.INPUT, - }, - }); - } catch (err) { - jsonResponse(res, 500, { ok: false, error: err.message }); - } - return; - } - if (path === "/api/health-stats") { const SIX_HOURS_MS = 6 * 60 * 60 * 1000; const cutoff = new Date(Date.now() - SIX_HOURS_MS).toISOString(); @@ -20819,6 +19681,7 @@ if (path === "/api/agent-logs/context") { jsonResponse(res, 200, { ok: true, successRuns, failedRuns, total, failRate, windowHours: 6 }); return; } + if (path === "/api/config") { const regionEnv = (process.env.EXECUTOR_REGIONS || "").trim(); const regions = regionEnv ? regionEnv.split(",").map((r) => r.trim()).filter(Boolean) : ["auto"]; @@ -20857,161 +19720,6 @@ if (path === "/api/agent-logs/context") { return; } - // ── /api/env/detect — auto-detect project type from a repo path ────────────── - if (path === "/api/env/detect" && req.method === "POST") { - try { - const body = await readJsonBody(req); - const targetPath = body?.repoPath ? resolve(body.repoPath) : repoRoot; - const [{ detectProjectStack }, { detectEnvironmentTemplate, templateToRepoEnvironment }] = await Promise.all([ - import("../workflow/project-detection.mjs"), - import("../workspace/env-templates.mjs"), - ]); - const stackResult = detectProjectStack(targetPath); - const templateResult = detectEnvironmentTemplate(targetPath); - const environment = templateResult.template - ? templateToRepoEnvironment(templateResult.template) - : null; - jsonResponse(res, 200, { - ok: true, - stack: stackResult.primary ? { - id: stackResult.primary.id, - label: stackResult.primary.label, - packageManager: stackResult.primary.packageManager, - frameworks: stackResult.primary.frameworks, - commands: stackResult.primary.commands, - } : null, - allStacks: stackResult.stacks.map((s) => ({ id: s.id, label: s.label, packageManager: s.packageManager })), - template: templateResult.template ? { - id: templateResult.template.id, - label: templateResult.template.label, - group: templateResult.template.group, - icon: templateResult.template.icon, - } : null, - confidence: templateResult.confidence, - environment, - }); - } catch (err) { - jsonResponse(res, 500, { ok: false, error: err.message }); - } - return; - } - - // ── /api/repos/environment — read per-repo environment config ───────────── - if (path === "/api/repos/environment" && req.method === "GET") { - try { - const repoName = searchParams.get("name") || searchParams.get("repo"); - const { configData } = readConfigDocument(); - const repos = Array.isArray(configData?.repositories) - ? configData.repositories - : Array.isArray(configData?.repositories?.items) - ? configData.repositories.items - : []; - - if (!repoName) { - // Return environment config for all repos - const result = repos.map((r) => ({ - name: r.name || r.id || r.slug, - slug: r.slug, - environment: r.environment || null, - })); - jsonResponse(res, 200, { ok: true, repos: result }); - return; - } - - const repo = repos.find( - (r) => r.name === repoName || r.id === repoName || r.slug === repoName || r.slug?.endsWith("/" + repoName), - ); - if (!repo) { - jsonResponse(res, 404, { ok: false, error: `Repository '${repoName}' not found in config` }); - return; - } - jsonResponse(res, 200, { ok: true, name: repo.name, slug: repo.slug, environment: repo.environment || null }); - } catch (err) { - jsonResponse(res, 500, { ok: false, error: err.message }); - } - return; - } - - // ── /api/repos/environment — save per-repo environment config ───────────── - if (path === "/api/repos/environment" && req.method === "POST") { - try { - const body = await readJsonBody(req); - const { name: repoName, slug: repoSlug, environment } = body || {}; - const identifier = repoName || repoSlug; - if (!identifier) { - jsonResponse(res, 400, { ok: false, error: "name or slug is required" }); - return; - } - if (!environment || typeof environment !== "object") { - jsonResponse(res, 400, { ok: false, error: "environment object is required" }); - return; - } - const { configPath, configData } = readConfigDocument(); - let repos = Array.isArray(configData?.repositories) - ? configData.repositories - : Array.isArray(configData?.repositories?.items) - ? configData.repositories.items - : []; - - const idx = repos.findIndex( - (r) => r.name === identifier || r.id === identifier || r.slug === identifier || r.slug?.endsWith("/" + identifier), - ); - if (idx < 0) { - jsonResponse(res, 404, { ok: false, error: `Repository '${identifier}' not found in config` }); - return; - } - - // Sanitize environment config — only allow known fields - const sanitized = {}; - const allowed = ["template", "installCommands", "startCommand", "buildCommand", "testCommand", "lintCommand", "debugCommand", "worktreeSetupScript", "sharedPaths"]; - for (const key of allowed) { - if (key in environment) sanitized[key] = environment[key]; - } - - if (Array.isArray(configData.repositories)) { - configData.repositories[idx] = { ...configData.repositories[idx], environment: sanitized }; - } else { - configData.repositories.items[idx] = { ...configData.repositories.items[idx], environment: sanitized }; - } - - writeFileSync(configPath, JSON.stringify(configData, null, 2) + "\n", "utf8"); - broadcastUiEvent(["settings", "overview"], "invalidate", { reason: "repo-environment-updated", repo: identifier }); - jsonResponse(res, 200, { ok: true, name: identifier, environment: sanitized }); - } catch (err) { - jsonResponse(res, 500, { ok: false, error: err.message }); - } - return; - } - - // ── /api/env/templates — list all environment templates ────────────────── - if (path === "/api/env/templates" && req.method === "GET") { - try { - const { ENV_TEMPLATES, getTemplatesByGroup } = await import("../workspace/env-templates.mjs"); - jsonResponse(res, 200, { - ok: true, - templates: ENV_TEMPLATES.map((t) => ({ - id: t.id, - label: t.label, - description: t.description, - icon: t.icon, - group: t.group, - installCommands: t.installCommands, - startCommand: t.startCommand, - buildCommand: t.buildCommand, - testCommand: t.testCommand, - lintCommand: t.lintCommand, - debugCommand: t.debugCommand, - worktreeSetupCommands: t.worktreeSetupCommands, - sharedPaths: t.sharedPaths, - })), - groups: Object.keys(getTemplatesByGroup()), - }); - } catch (err) { - jsonResponse(res, 500, { ok: false, error: err.message }); - } - return; - } - if (path === "/api/config/update") { try { const body = await readJsonBody(req); @@ -22070,17 +20778,14 @@ if (path === "/api/agent-logs/context") { if (!session) return null; return sessionMatchesWorkspaceContext(session, workspaceContext) ? session : null; }; - const getScopedSessionRecord = ({ includeMessages = false } = {}) => { - const session = includeMessages - ? tracker.getSessionMessages(sessionId) - : (tracker.getSessionById(sessionId) || tracker.getSessionMessages(sessionId)); - if (!session) return null; - return sessionMatchesWorkspaceContext(session, workspaceContext) ? session : null; - }; if (!action && req.method === "GET") { try { - const session = getScopedSessionRecord({ includeMessages: true }); + if (!getScopedSession()) { + jsonResponse(res, 404, { ok: false, error: "Session not found" }); + return; + } + const session = tracker.getSessionMessages(sessionId); if (!session) { jsonResponse(res, 404, { ok: false, error: "Session not found" }); return; @@ -22507,7 +21212,7 @@ if (path === "/api/agent-logs/context") { if (action === "diff" && req.method === "GET") { try { - const session = getScopedSessionRecord(); + const session = getScopedSession(); if (!session) { jsonResponse(res, 200, { ok: true, @@ -23864,186 +22569,6 @@ if (path === "/api/agent-logs/context") { jsonResponse(res, 404, { ok: false, error: "Unknown API endpoint" }); } -// ─── Vault singleton ──────────────────────────────────────────────────────────── -let _vault = null; -function getVault() { - if (!_vault) _vault = new VaultStore(); - return _vault; -} - -async function ensureVaultOpen() { - const v = getVault(); - if (v.isUnlocked()) return v; - if (!v.isInitialized()) return null; - try { - const { key } = keychainGetOrCreate(); - v.open(key); - return v; - } catch { - return null; - } -} - -// ─── /api/vault/* routes ──────────────────────────────────────────────────────── -async function handleVaultApi(req, res, path) { - // GET /api/vault/status - if (path === "/api/vault/status" && req.method === "GET") { - const v = getVault(); - let status = v.status(); - if (!status.unlocked && v.isInitialized()) { - try { - const { key } = keychainGetOrCreate(); - v.open(key); - status = v.status(); - } catch { /* stays locked */ } - } - jsonResponse(res, 200, { ok: true, data: status }); - return true; - } - - // POST /api/vault/init - if (path === "/api/vault/init" && req.method === "POST") { - const v = getVault(); - if (v.isInitialized()) { - jsonResponse(res, 409, { ok: false, error: "Vault already initialized." }); - return true; - } - try { - const { key } = keychainGetOrCreate(); - v.init(key); - jsonResponse(res, 200, { ok: true, data: { initialized: true } }); - } catch (err) { - jsonResponse(res, 500, { ok: false, error: err.message }); - } - return true; - } - - // GET /api/vault/integrations - if (path === "/api/vault/integrations" && req.method === "GET") { - jsonResponse(res, 200, { ok: true, data: INTEGRATIONS }); - return true; - } - - // GET /api/vault/secrets - if (path === "/api/vault/secrets" && req.method === "GET") { - const v = await ensureVaultOpen(); - if (!v) { jsonResponse(res, 503, { ok: false, error: "Vault locked or not initialized." }); return true; } - jsonResponse(res, 200, { ok: true, data: v.listSecrets() }); - return true; - } - - // POST /api/vault/secrets - if (path === "/api/vault/secrets" && req.method === "POST") { - const v = await ensureVaultOpen(); - if (!v) { jsonResponse(res, 503, { ok: false, error: "Vault locked or not initialized." }); return true; } - try { - const body = await readJsonBody(req); - const id = v.createSecret(body); - jsonResponse(res, 201, { ok: true, data: { id, ...v.getSecret(id) } }); - } catch (err) { - jsonResponse(res, 400, { ok: false, error: err.message }); - } - return true; - } - - // GET /api/vault/secrets/:id - const secretIdMatch = path.match(/^\/api\/vault\/secrets\/([^/]+)$/); - if (secretIdMatch && req.method === "GET") { - const v = await ensureVaultOpen(); - if (!v) { jsonResponse(res, 503, { ok: false, error: "Vault locked or not initialized." }); return true; } - try { - jsonResponse(res, 200, { ok: true, data: v.getSecret(secretIdMatch[1]) }); - } catch (err) { - jsonResponse(res, 404, { ok: false, error: err.message }); - } - return true; - } - - // PUT /api/vault/secrets/:id - if (secretIdMatch && req.method === "PUT") { - const v = await ensureVaultOpen(); - if (!v) { jsonResponse(res, 503, { ok: false, error: "Vault locked or not initialized." }); return true; } - try { - const body = await readJsonBody(req); - v.updateSecret(secretIdMatch[1], body); - jsonResponse(res, 200, { ok: true, data: v.getSecret(secretIdMatch[1]) }); - } catch (err) { - jsonResponse(res, 404, { ok: false, error: err.message }); - } - return true; - } - - // DELETE /api/vault/secrets/:id - if (secretIdMatch && req.method === "DELETE") { - const v = await ensureVaultOpen(); - if (!v) { jsonResponse(res, 503, { ok: false, error: "Vault locked or not initialized." }); return true; } - try { - v.deleteSecret(secretIdMatch[1]); - jsonResponse(res, 200, { ok: true }); - } catch (err) { - jsonResponse(res, 404, { ok: false, error: err.message }); - } - return true; - } - - // PUT /api/vault/secrets/:id/permissions - const permMatch = path.match(/^\/api\/vault\/secrets\/([^/]+)\/permissions$/); - if (permMatch && req.method === "PUT") { - const v = await ensureVaultOpen(); - if (!v) { jsonResponse(res, 503, { ok: false, error: "Vault locked or not initialized." }); return true; } - try { - const body = await readJsonBody(req); - v.setPermissions(permMatch[1], body); - jsonResponse(res, 200, { ok: true, data: v.getSecret(permMatch[1]).permissions }); - } catch (err) { - jsonResponse(res, 404, { ok: false, error: err.message }); - } - return true; - } - - // GET /api/vault/env - if (path === "/api/vault/env" && req.method === "GET") { - const v = await ensureVaultOpen(); - if (!v) { jsonResponse(res, 503, { ok: false, error: "Vault locked or not initialized." }); return true; } - const keys = v.listEnvKeys(); - jsonResponse(res, 200, { ok: true, data: { keys } }); - return true; - } - - // POST /api/vault/env - if (path === "/api/vault/env" && req.method === "POST") { - const v = await ensureVaultOpen(); - if (!v) { jsonResponse(res, 503, { ok: false, error: "Vault locked or not initialized." }); return true; } - try { - const body = await readJsonBody(req); - if (!body?.key || typeof body.key !== "string") { - jsonResponse(res, 400, { ok: false, error: "key is required" }); return true; - } - v.setEnv(body.key, String(body.value ?? "")); - jsonResponse(res, 200, { ok: true, data: { key: body.key } }); - } catch (err) { - jsonResponse(res, 400, { ok: false, error: err.message }); - } - return true; - } - - // DELETE /api/vault/env/:key - const envKeyMatch = path.match(/^\/api\/vault\/env\/([^/]+)$/); - if (envKeyMatch && req.method === "DELETE") { - const v = await ensureVaultOpen(); - if (!v) { jsonResponse(res, 503, { ok: false, error: "Vault locked or not initialized." }); return true; } - try { - v.deleteEnv(decodeURIComponent(envKeyMatch[1])); - jsonResponse(res, 200, { ok: true }); - } catch (err) { - jsonResponse(res, 400, { ok: false, error: err.message }); - } - return true; - } - - return false; // not handled -} - async function handleStatic(req, res, url) { if (tryLocalSessionBootstrap(req, res, url)) { return; @@ -24160,9 +22685,7 @@ export async function startTelegramUiServer(options = {}) { const isTestRun = Boolean(process.env.VITEST) || process.env.NODE_ENV === "test" || - Boolean(process.env.JEST_WORKER_ID) || - Boolean(process.env.NODE_TEST_CONTEXT) || - process.execArgv.includes("--test"); + Boolean(process.env.JEST_WORKER_ID); if (isTestRun && typeof taskStoreModule?.configureTaskStore === "function") { const cacheDir = sandbox?.cacheDir || resolve(repoRoot, ".bosun", ".cache"); const isolatedStorePath = resolve( @@ -24173,16 +22696,13 @@ export async function startTelegramUiServer(options = {}) { } const skipInstanceLock = options.skipInstanceLock === true || - (options.skipInstanceLock !== false && ( - process.env.BOSUN_UI_SKIP_INSTANCE_LOCK === "1" || - isTestRun - )); + process.env.BOSUN_UI_SKIP_INSTANCE_LOCK === "1" || + isTestRun; const allowEphemeralPort = options.allowEphemeralPort === true || process.env.BOSUN_UI_ALLOW_EPHEMERAL_PORT === "1" || isTestRun; - const persistedPortRecord = readLastUiPortRecord(); - const persistedPort = persistedPortRecord?.port || 0; + const persistedPort = readLastUiPort(); const shouldReusePersistedPort = options.port == null && configuredPort === 0 && @@ -24226,15 +22746,15 @@ export async function startTelegramUiServer(options = {}) { ); if (!skipInstanceLock) { - const lockResult = await tryAcquireUiInstanceLock({ - preferredPort: port, - staleGraceMs: options.instanceLockStaleGraceMs, - probeTimeoutMs: options.instanceLockProbeTimeoutMs, - }); + const lockResult = tryAcquireUiInstanceLock({ preferredPort: port }); if (!lockResult.ok) { const existing = lockResult.existing || {}; + const existingTarget = existing.url + || (existing.port + ? `${existing.protocol || "http"}://${existing.host || "127.0.0.1"}:${existing.port}` + : "unknown"); console.warn( - `[telegram-ui] duplicate runtime detected (pid=${existing.pid}) — skipping secondary UI server start (${describeUiInstanceTarget(existing)})`, + `[telegram-ui] duplicate runtime detected (pid=${existing.pid}) — skipping secondary UI server start (${existingTarget})`, ); return null; } @@ -24245,7 +22765,6 @@ export async function startTelegramUiServer(options = {}) { if (!isTlsDisabled()) { tlsOpts = ensureSelfSignedCert(); } - let usedFallbackPort = false; const requestHandler = async (req, res) => { const url = new URL( @@ -24902,7 +23421,6 @@ export async function startTelegramUiServer(options = {}) { listenPort > 0; if (canRetryPortIncrement) { const nextPort = listenPort + 1; - usedFallbackPort = true; console.warn( `[telegram-ui] port ${listenPort} in use; retrying on ${nextPort} (attempt ${attempt + 1}/${maxPortFallbackAttempts})`, ); @@ -24914,7 +23432,6 @@ export async function startTelegramUiServer(options = {}) { const canRetryWithEphemeral = allowEphemeralPort && listenPort > 0 && (code === "EADDRINUSE" || code === "EACCES"); if (!canRetryWithEphemeral) throw err; - usedFallbackPort = true; console.warn( `[telegram-ui] failed to bind ${host}:${listenPort} (${code || "unknown"}); retrying with ephemeral port`, ); @@ -24923,9 +23440,6 @@ export async function startTelegramUiServer(options = {}) { } } } catch (err) { - if (shouldReusePersistedPort) { - clearLastUiPort(); - } releaseUiInstanceLock(); throw err; } @@ -24955,8 +23469,6 @@ export async function startTelegramUiServer(options = {}) { || normalized === "localhost" || normalized === "::1"; }; - const autoOpenSuppressedForFallbackPort = - usedFallbackPort || (port > 0 && actualPort !== port); const protocol = uiServerTls ? "https" : publicHost && !isLocalOrPrivateHost(publicHost) @@ -24971,7 +23483,7 @@ export async function startTelegramUiServer(options = {}) { url: uiServerUrl, startedAt: Date.now(), }); - persistLastUiPort(actualPort, { host, protocol, url: uiServerUrl }); + persistLastUiPort(actualPort); setComponentStatus("server", "running"); console.log(`[telegram-ui] server listening on ${uiServerUrl}`); if (uiServerTls) { @@ -25022,11 +23534,7 @@ export async function startTelegramUiServer(options = {}) { // - skip during Vitest / Jest test runs (avoids opening 20+ tabs during `npm test`) // - only open ONCE per process (singleton guard — prevents loops on server restart) const isTestRunRuntime = - process.env.VITEST || - process.env.NODE_ENV === "test" || - process.env.JEST_WORKER_ID || - process.env.NODE_TEST_CONTEXT || - process.execArgv.includes("--test"); + process.env.VITEST || process.env.NODE_ENV === "test" || process.env.JEST_WORKER_ID; const restartReason = String( options.restartReason || process.env.BOSUN_MONITOR_RESTART_REASON || "", ).trim(); @@ -25036,21 +23544,11 @@ export async function startTelegramUiServer(options = {}) { `[telegram-ui] auto-open suppressed during restart (${restartReason})`, ); } - if ( - autoOpenEnabled && - !options.skipAutoOpen && - autoOpenSuppressedForFallbackPort - ) { - console.log( - `[telegram-ui] auto-open suppressed because requested port ${port} was unavailable and UI bound ${actualPort} instead`, - ); - } if ( autoOpenEnabled && process.env.BOSUN_DESKTOP !== "1" && !options.skipAutoOpen && !suppressAutoOpenForRestart && - !autoOpenSuppressedForFallbackPort && !_browserOpened && !isTestRunRuntime && shouldAutoOpenBrowserNow() @@ -25163,10 +23661,12 @@ export function stopTelegramUiServer() { /* best effort */ } uiServer = null; - uiServerUrl = null; uiServerTls = false; resetProjectSyncWebhookMetrics(); releaseUiInstanceLock(); } export { getLocalLanIp }; + + + diff --git a/server/workflow-engine-worker.mjs b/server/workflow-engine-worker.mjs deleted file mode 100644 index 396b7049f..000000000 --- a/server/workflow-engine-worker.mjs +++ /dev/null @@ -1,258 +0,0 @@ -/** - * workflow-engine-worker.mjs - * - * Worker thread that hosts the Bosun workflow engine, completely isolated from - * the UI server's HTTP / WebSocket event loop. - * - * Protocol (parentPort messages): - * - * Parent → Worker: - * { type: "init", workerData: { repoRoot, workflowDir, runsDir } } - * { type: "call", callId, method, args } — proxied engine method call - * { type: "svc-res", callId, result?, error? } — response to a service call - * - * Worker → Parent: - * { type: "ready" } — engine fully initialised - * { type: "result", callId, result } — successful engine call - * { type: "error", callId, error, stack? } — failed engine call - * { type: "event", eventName, payload } — forwarded engine event - * { type: "svc-call",callId, method, args } — request main-thread service - */ - -import { parentPort, workerData } from "node:worker_threads"; -import { randomUUID } from "node:crypto"; -import { resolve, dirname } from "node:path"; -import { fileURLToPath, pathToFileURL } from "node:url"; - -const __dirname = dirname(fileURLToPath(import.meta.url)); -const repoRoot = workerData?.repoRoot || resolve(__dirname, ".."); - -// ── Pending service calls (worker awaiting main-thread response) ────────────── -const pendingSvcCalls = new Map(); - -function callMainService(method, args) { - return new Promise((resolve, reject) => { - const callId = randomUUID(); - pendingSvcCalls.set(callId, { resolve, reject }); - parentPort.postMessage({ type: "svc-call", callId, method, args }); - }); -} - -// ── Load workflow modules ────────────────────────────────────────────────────── -let engine = null; - -async function initEngine(cfg = {}) { - const base = pathToFileURL(repoRoot + "/").href; - - const [wfEngineMod, wfNodesMod, wfTemplatesMod] = await Promise.all([ - import(new URL("./workflow/workflow-engine.mjs", base).href), - import(new URL("./workflow/workflow-nodes.mjs", base).href), - import(new URL("./workflow/workflow-templates.mjs", base).href), - ]); - - if (typeof wfNodesMod?.ensureWorkflowNodeTypesLoaded === "function") { - await wfNodesMod.ensureWorkflowNodeTypesLoaded({ repoRoot }); - } - - // ── Build proxied service bundle ────────────────────────────────────────── - const telegram = { - async sendMessage(chatId, text, opts = {}) { - return callMainService("telegram.sendMessage", [chatId, text, opts]); - }, - }; - - const agentPool = { - async launchEphemeralThread(prompt, cwd, timeout, opts) { - return callMainService("agentPool.launchEphemeralThread", [prompt, cwd, timeout, opts]); - }, - async launchOrResumeThread(prompt, cwd, opts) { - return callMainService("agentPool.launchOrResumeThread", [prompt, cwd, opts]); - }, - async execWithRetry(taskKey, fn, opts) { - /* execWithRetry takes a function — not serialisable; call main-thread shim */ - return callMainService("agentPool.execWithRetry", [taskKey, null, opts]); - }, - async continueSession(sessionId, prompt, opts) { - return callMainService("agentPool.continueSession", [sessionId, prompt, opts]); - }, - async killSession(sessionId) { - return callMainService("agentPool.killSession", [sessionId]); - }, - }; - - const kanban = { - async createTask(projectIdOrData, taskData) { - return callMainService("kanban.createTask", [projectIdOrData, taskData]); - }, - async updateTaskStatus(taskId, status, opts) { - return callMainService("kanban.updateTaskStatus", [taskId, status, opts]); - }, - async listTasks(projectId, filters) { - return callMainService("kanban.listTasks", [projectId, filters]); - }, - async getTask(taskId) { - return callMainService("kanban.getTask", [taskId]); - }, - }; - - const meeting = { - async schedule(...args) { return callMainService("meeting.schedule", args); }, - async cancel(...args) { return callMainService("meeting.cancel", args); }, - async get(...args) { return callMainService("meeting.get", args); }, - }; - - const services = { telegram, agentPool, kanban, meeting }; - - // ── Create engine ───────────────────────────────────────────────────────── - engine = wfEngineMod.getWorkflowEngine({ - workflowDir: cfg.workflowDir, - runsDir: cfg.runsDir, - services, - detectInterruptedRuns: false, - }); - - // ── Forward engine events to main thread ────────────────────────────────── - const FORWARDED_EVENTS = [ - "run:start", "run:end", "run:error", "run:cancel:requested", - "node:start", "node:complete", "node:error", "node:skip", - "edge:flow", - ]; - for (const eventName of FORWARDED_EVENTS) { - engine.on(eventName, (payload) => { - try { - parentPort.postMessage({ type: "event", eventName, payload: sanitise(payload) }); - } catch { /* best-effort */ } - }); - } - - // ── Install recommended templates ───────────────────────────────────────── - if (typeof wfTemplatesMod?.installRecommendedWorkflowTemplates === "function") { - try { - await wfTemplatesMod.installRecommendedWorkflowTemplates(engine); - } catch { /* non-fatal */ } - } - - // ── Resume interrupted runs ──────────────────────────────────────────────── - if (typeof engine.resumeInterruptedRuns === "function") { - setTimeout(() => engine.resumeInterruptedRuns().catch(() => {}), 0); - } -} - -// ── Serialize engine return values for structured clone ──────────────────────── -function sanitise(value, depth = 0) { - if (depth > 8 || value === null || value === undefined) return value; - if (typeof value === "function") return "[Function]"; - if (typeof value !== "object") return value; - if (Array.isArray(value)) return value.map((v) => sanitise(v, depth + 1)); - const out = {}; - for (const [k, v] of Object.entries(value)) { - if (k.startsWith("_") && depth > 0) continue; - out[k] = sanitise(v, depth + 1); - } - return out; -} - -// ── Engine method dispatcher ────────────────────────────────────────────────── -async function dispatch(method, args) { - if (!engine) throw new Error("Workflow engine not yet initialised"); - switch (method) { - case "execute": { - const [workflowId, input, opts] = args; - const ctx = await engine.execute(workflowId, input, opts); - /* Return only the fields the main thread needs to avoid serialisation issues */ - return { - id: ctx?.id, - workflowId: ctx?.workflowId, - status: ctx?.status, - errors: ctx?.errors || [], - data: sanitise(ctx?.data), - }; - } - case "evaluateTriggers": - return engine.evaluateTriggers(...args); - case "get": - return sanitise(engine.get(...args)); - case "list": - return sanitise(engine.list(...args)); - case "getRunHistory": - return sanitise(await engine.getRunHistory?.(...args)); - case "getRunHistoryPage": - return sanitise(await engine.getRunHistoryPage?.(...args)); - case "getRunDetail": - return sanitise(await engine.getRunDetail?.(...args)); - case "getRunForensics": - return sanitise(await engine.getRunForensics?.(...args)); - case "getNodeForensics": - return sanitise(await engine.getNodeForensics?.(...args)); - case "getRetryOptions": - return sanitise(await engine.getRetryOptions?.(...args)); - case "retryRun": { - const ctx = await engine.retryRun(...args); - return { id: ctx?.id, workflowId: ctx?.workflowId, status: ctx?.status, errors: ctx?.errors || [] }; - } - case "restoreFromSnapshot": { - const ctx = await engine.restoreFromSnapshot?.(...args); - return { id: ctx?.id, workflowId: ctx?.workflowId, status: ctx?.status, errors: ctx?.errors || [] }; - } - case "cancelRun": - return engine.cancelRun?.(...args); - case "createRunSnapshot": - return engine.createRunSnapshot?.(...args); - case "listSnapshots": - return sanitise(engine.listSnapshots?.(...args)); - case "save": - return engine.save(...args); - case "import": - return sanitise(engine.import(...args)); - case "delete": - return engine.delete?.(...args); - case "getConcurrencyStats": - return sanitise(engine.getConcurrencyStats?.()); - case "getTaskTraceEvents": - return sanitise(await engine.getTaskTraceEvents?.(...args)); - case "load": - return engine.load?.(); - case "resumeInterruptedRuns": - return engine.resumeInterruptedRuns?.(); - case "registerTaskTraceHook": - /* Hooks cannot cross thread boundaries; silently ignore */ - return null; - default: - throw new Error(`Unknown engine method: ${method}`); - } -} - -// ── Message handler ──────────────────────────────────────────────────────────── -parentPort.on("message", async (msg) => { - if (!msg || typeof msg.type !== "string") return; - - if (msg.type === "init") { - try { - await initEngine(msg.workerData || {}); - parentPort.postMessage({ type: "ready" }); - } catch (err) { - parentPort.postMessage({ type: "error", callId: null, error: err.message, stack: err.stack }); - } - return; - } - - if (msg.type === "svc-res") { - const pending = pendingSvcCalls.get(msg.callId); - if (pending) { - pendingSvcCalls.delete(msg.callId); - if (msg.error) pending.reject(Object.assign(new Error(msg.error), { code: msg.code })); - else pending.resolve(msg.result); - } - return; - } - - if (msg.type === "call") { - const { callId, method, args } = msg; - try { - const result = await dispatch(method, args || []); - parentPort.postMessage({ type: "result", callId, result }); - } catch (err) { - parentPort.postMessage({ type: "error", callId, error: err.message, stack: err.stack }); - } - } -}); diff --git a/setup.mjs b/setup.mjs index 7cf00cdf2..dace073f8 100755 --- a/setup.mjs +++ b/setup.mjs @@ -1,3 +1,5 @@ +#!/usr/bin/env node + /** * bosun — Setup Wizard * @@ -24,7 +26,6 @@ import { resolve, dirname, basename, relative, isAbsolute } from "node:path"; import { execSync, spawnSync } from "node:child_process"; import { execFileSync } from "node:child_process"; import { fileURLToPath } from "node:url"; -import "./infra/windows-hidden-child-processes.mjs"; import { readCodexConfig, getConfigPath, @@ -58,10 +59,7 @@ import { resolveWorkflowTemplateIds, normalizeTemplateOverridesById, } from "./workflow/workflow-templates.mjs"; -import { - discoverTelegramPairingChat, - normalizeTelegramPairingCode, -} from "./telegram/get-telegram-chat-id.mjs"; +import { discoverTelegramChats } from "./telegram/get-telegram-chat-id.mjs"; const __dirname = dirname(fileURLToPath(import.meta.url)); @@ -91,126 +89,12 @@ function getVersion() { } } -const TELEGRAM_PAIRING_CODE_ALPHABET = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789"; - -function generateTelegramPairingCode(randomFn = Math.random) { - let code = ""; - for (let i = 0; i < 6; i += 1) { - const idx = Math.floor(randomFn() * TELEGRAM_PAIRING_CODE_ALPHABET.length); - code += TELEGRAM_PAIRING_CODE_ALPHABET[idx] || TELEGRAM_PAIRING_CODE_ALPHABET[0]; - } - return code; -} - -function buildTelegramAllowedChatIds(primaryChatId, ...rawValues) { - const seen = new Set(); - const ordered = []; - - for (const rawValue of [primaryChatId, ...rawValues]) { - for (const value of String(rawValue || "") - .split(",") - .map((item) => item.trim()) - .filter(Boolean)) { - if (seen.has(value)) continue; - seen.add(value); - ordered.push(value); - } - } - - return ordered.join(","); -} - -function applyTelegramChatPairing(env, chatId, sourceEnv = process.env) { - const normalizedChatId = String(chatId || "").trim(); - if (!normalizedChatId) return ""; - - const existingAllowed = buildTelegramAllowedChatIds( - normalizedChatId, - env.TELEGRAM_ALLOWED_CHAT_IDS, - env.TELEGRAM_CHAT_ID, - sourceEnv.TELEGRAM_ALLOWED_CHAT_IDS, - sourceEnv.TELEGRAM_CHAT_IDS, - sourceEnv.TELEGRAM_CHAT_ID, - ); - - env.TELEGRAM_CHAT_ID = normalizedChatId; - env.TELEGRAM_ALLOWED_CHAT_IDS = existingAllowed; - return normalizedChatId; -} - -async function promptForTelegramPairedChat({ - prompt, - token, - env, - sourceEnv = process.env, -}) { - const pairingCode = normalizeTelegramPairingCode(generateTelegramPairingCode()); - - console.log("\n" + chalk.bold("Step 3: Pair Your Telegram Chat")); - console.log( - " Bosun will capture the right chat automatically and lock commands to it.\n", - ); - console.log(" 1. Open Telegram and DM your bot"); - console.log(" 2. Send this pairing code:"); - console.log(` ${chalk.cyan(pairingCode)}`); - console.log(" 3. Come back here and press enter so Bosun can finish pairing"); - console.log(); - - while (true) { - const ready = await prompt.confirm( - "I sent the pairing code to my bot. Pair now?", - true, - ); - if (!ready) break; - - info("Checking Telegram for the pairing code..."); - try { - const pairing = await discoverTelegramPairingChat(token, pairingCode); - if (pairing.chat?.id) { - const pairedChatId = applyTelegramChatPairing( - env, - pairing.chat.id, - sourceEnv, - ); - const pairedLabel = - pairing.chat.username - ? `@${pairing.chat.username}` - : pairing.chat.title || pairing.chat.type || pairedChatId; - info(`✓ Paired ${pairedLabel}`); - info("✓ Telegram commands are locked to the paired chat"); - console.log(); - return pairedChatId; - } - warn(pairing.message || "Pairing code not found yet."); - } catch (err) { - warn(`Failed to check Telegram pairing: ${err.message}`); - } - - console.log( - chalk.dim( - " If you already sent the code, wait a moment and try again. The fallback is manual entry.", - ), - ); - const retry = await prompt.confirm("Try pairing again?", true); - if (!retry) break; - console.log(); - } - - console.log(); - info("Falling back to manual chat ID entry."); - console.log( - chalk.dim( - " Tip: you can still use bosun-chat-id --pair or set TELEGRAM_CHAT_ID manually later.", - ), - ); - const manualChatId = await prompt.ask( - "Chat ID (leave empty to set this up later)", - "", - ); - if (manualChatId) { - applyTelegramChatPairing(env, manualChatId, sourceEnv); - } - return env.TELEGRAM_CHAT_ID || ""; +function formatTelegramChatChoice(chat) { + const parts = [String(chat.id)]; + if (chat.type) parts.push(chat.type); + if (chat.username) parts.push(`@${chat.username}`); + if (chat.title) parts.push(chat.title); + return parts.join(" · "); } function hasSetupMarkers(dir) { @@ -3881,8 +3765,8 @@ async function main() { if (!hasBotReady) { warn("No problem! You can set up Telegram later by:"); console.log(" 1. Adding TELEGRAM_BOT_TOKEN to .env"); - console.log(" 2. Re-running: bosun --setup to pair your chat"); - console.log(" 3. Or setting TELEGRAM_CHAT_ID / TELEGRAM_ALLOWED_CHAT_IDS manually"); + console.log(" 2. Adding TELEGRAM_CHAT_ID to .env"); + console.log(" 3. Or re-running: bosun --setup"); console.log(); } else { // Step 2: Get bot token @@ -3912,12 +3796,105 @@ async function main() { info("✓ Token format looks good"); } - await promptForTelegramPairedChat({ - prompt, - token: env.TELEGRAM_BOT_TOKEN, - env, - sourceEnv: process.env, - }); + // Step 3: Get chat ID + console.log("\n" + chalk.bold("Step 3: Get Your Chat ID")); + console.log(" Your chat ID tells the bot where to send messages."); + console.log(); + + const knowsChatId = await prompt.confirm( + "Do you already know your chat ID?", + false, + ); + + if (knowsChatId) { + env.TELEGRAM_CHAT_ID = await prompt.ask( + "Chat ID (numeric, e.g., 123456789)", + process.env.TELEGRAM_CHAT_ID || "", + ); + } else { + // Guide user to get chat ID + console.log("\n" + chalk.cyan("To get your chat ID:") + "\n"); + console.log( + " 1. Open Telegram and search for your bot's username", + ); + console.log( + " 2. Click " + + chalk.cyan("START") + + " or send any message (e.g., 'Hello')", + ); + console.log(" 3. Come back here and we'll detect your chat ID"); + console.log(); + + const ready = await prompt.confirm( + "Ready? (I've messaged my bot)", + false, + ); + + if (ready) { + // Try to fetch chat ID from Telegram API + info("Fetching your chat ID from Telegram..."); + try { + const discovery = await discoverTelegramChats(env.TELEGRAM_BOT_TOKEN); + + if (discovery.chats.length === 1) { + env.TELEGRAM_CHAT_ID = String(discovery.chats[0].id); + info(`✓ Found your chat ID: ${env.TELEGRAM_CHAT_ID}`); + console.log(); + } else if (discovery.chats.length > 1) { + const selectedIdx = await prompt.choose( + "Select the chat Bosun should use:", + discovery.chats.map(formatTelegramChatChoice), + 0, + ); + const selectedChat = discovery.chats[selectedIdx]; + env.TELEGRAM_CHAT_ID = String(selectedChat.id); + info(`✓ Selected chat ID: ${env.TELEGRAM_CHAT_ID}`); + console.log(); + } else { + warn( + discovery.message || + "Couldn't find a chat ID. Make sure you sent a message to your bot.", + ); + console.log( + chalk.dim( + " Or run: bosun-chat-id (after starting the bot)", + ), + ); + env.TELEGRAM_CHAT_ID = await prompt.ask( + "Enter chat ID manually (or leave empty to set up later)", + "", + ); + } + } catch (err) { + warn(`Failed to fetch chat ID: ${err.message}`); + console.log( + chalk.dim( + " You can run: bosun-chat-id (after starting the bot)", + ), + ); + env.TELEGRAM_CHAT_ID = await prompt.ask( + "Enter chat ID manually (or leave empty to set up later)", + "", + ); + } + } else { + console.log(); + info("No problem! You can get your chat ID later by:"); + console.log( + " • Running: " + + chalk.cyan("bosun-chat-id") + + " (after starting bosun)", + ); + console.log( + " • Or manually: " + + chalk.cyan( + "curl 'https://api.telegram.org/bot/getUpdates'", + ), + ); + console.log(" Then add TELEGRAM_CHAT_ID to .env"); + console.log(); + } + } // Step 4: Verify setup if (env.TELEGRAM_CHAT_ID) { @@ -6042,8 +6019,6 @@ async function runNonInteractive({ env.GITHUB_REPO = process.env.GITHUB_REPO || slug || ""; env.TELEGRAM_BOT_TOKEN = process.env.TELEGRAM_BOT_TOKEN || ""; env.TELEGRAM_CHAT_ID = process.env.TELEGRAM_CHAT_ID || ""; - env.TELEGRAM_ALLOWED_CHAT_IDS = - process.env.TELEGRAM_ALLOWED_CHAT_IDS || process.env.TELEGRAM_CHAT_IDS || ""; applyTelegramMiniAppDefaults(env, process.env); env.KANBAN_BACKEND = process.env.KANBAN_BACKEND || "internal"; env.KANBAN_SYNC_POLICY = @@ -6568,7 +6543,7 @@ async function writeConfigFiles({ env, configJson, repoRoot, configDir }) { if (commandExists("pnpm")) { execSync("pnpm install", { cwd: __dirname, stdio: "inherit" }); } else { - execSync(`${resolveNpmCommand()} install`, { cwd: __dirname, stdio: "inherit" }); + execSync("npm install", { cwd: __dirname, stdio: "inherit" }); } success("Dependencies installed"); } catch { @@ -6648,7 +6623,7 @@ async function writeConfigFiles({ env, configJson, repoRoot, configDir }) { const portalChild = _spawn( launcher.executable, launcher.args || [], - { detached: true, stdio: "ignore", windowsHide: true }, + { detached: true, stdio: "ignore", windowsHide: false }, ); portalChild.unref(); success("Bosun portal is opening..."); @@ -6767,9 +6742,6 @@ export async function runSetup() { export { applyTelegramMiniAppDefaults, - applyTelegramChatPairing, - buildTelegramAllowedChatIds, - generateTelegramPairingCode, normalizeTelegramUiPort, extractProjectNumber, resolveOrCreateGitHubProjectNumber, @@ -6794,5 +6766,3 @@ if (process.argv[1] && resolve(process.argv[1]) === resolve(__filename_setup)) { }); } - - diff --git a/shell/claude-shell.mjs b/shell/claude-shell.mjs index 2e3fdfda4..f479b096b 100644 --- a/shell/claude-shell.mjs +++ b/shell/claude-shell.mjs @@ -5,7 +5,6 @@ * long-lived session with steering support via streaming input mode. */ -import "../infra/windows-hidden-child-processes.mjs"; import { mkdir, readFile, writeFile } from "node:fs/promises"; import { existsSync, readFileSync } from "node:fs"; import { resolve } from "node:path"; diff --git a/shell/codex-config.mjs b/shell/codex-config.mjs index d430377dc..6240fe719 100644 --- a/shell/codex-config.mjs +++ b/shell/codex-config.mjs @@ -1095,26 +1095,13 @@ const COMMON_MCP_SERVER_DEFS = [ lines: [ "[mcp_servers.microsoft-docs]", 'url = "https://learn.microsoft.com/api/mcp"', + '# NOTE: Tool list intentionally limited to avoid Azure Responses API schema-size/parser issues.', + 'tools = ["microsoft_docs_search", "microsoft_code_sample_search"]', ], isPresent: hasMicrosoftDocsMcp, }, ]; -const COMMON_MCP_SERVER_SECTION_NAMES = Object.freeze([ - "context7", - "sequential-thinking", - "playwright", - "microsoft-docs", - "microsoft_docs", -]); - -function shouldIncludeDefaultMcpServers(env = process.env) { - const raw = String(env.BOSUN_MCP_ALLOW_DEFAULT_SERVERS || "") - .trim() - .toLowerCase(); - return ["1", "true", "yes", "on", "y"].includes(raw); -} - function buildCommonMcpBlock(definition) { return [ "", @@ -1124,10 +1111,7 @@ function buildCommonMcpBlock(definition) { ].join("\n"); } -export function buildCommonMcpBlocks(env = process.env) { - if (!shouldIncludeDefaultMcpServers(env)) { - return ""; - } +export function buildCommonMcpBlocks() { return COMMON_MCP_SERVER_DEFS.map(buildCommonMcpBlock).join(""); } @@ -1137,45 +1121,6 @@ function hasNamedMcpServer(toml, name) { ); } -function stripNamedMcpSection(toml, name) { - const header = `[mcp_servers.${name}]`; - const headerIdx = toml.indexOf(header); - if (headerIdx === -1) { - return { toml, changed: false }; - } - - const lineStart = toml.lastIndexOf("\n", headerIdx); - let removeFrom = lineStart === -1 ? 0 : lineStart + 1; - const prefix = toml.slice(0, removeFrom); - const commentMatch = prefix.match(/(^|\n)# ── Common MCP servers \(added by bosun\) ──\s*\n$/); - if (commentMatch) { - removeFrom = prefix.length - commentMatch[0].length + (commentMatch[1] === "\n" ? 1 : 0); - } - - const afterHeader = headerIdx + header.length; - const nextSection = toml.indexOf("\n[", afterHeader); - const sectionEnd = nextSection === -1 ? toml.length : nextSection + 1; - const nextToml = `${toml.slice(0, removeFrom)}${toml.slice(sectionEnd)}`.replace(/\n{3,}/g, "\n\n"); - return { toml: nextToml, changed: nextToml !== toml }; -} - -export function stripCommonMcpServerBlocks(toml) { - let nextToml = String(toml || ""); - let changed = false; - for (const name of COMMON_MCP_SERVER_SECTION_NAMES) { - while (true) { - const stripped = stripNamedMcpSection(nextToml, name); - if (!stripped.changed) break; - nextToml = stripped.toml; - changed = true; - } - } - return { - toml: nextToml, - changed, - }; -} - function ensureMcpStartupTimeout(toml, name, timeoutSec = 120) { const header = `[mcp_servers.${name}]`; const headerIdx = toml.indexOf(header); @@ -1207,30 +1152,6 @@ function ensureMcpStartupTimeout(toml, name, timeoutSec = 120) { }; } -function stripUnsupportedMicrosoftDocsToolsConfig(toml) { - let nextToml = String(toml || ""); - for (const name of ["microsoft-docs", "microsoft_docs"]) { - const header = `[mcp_servers.${name}]`; - const headerIdx = nextToml.indexOf(header); - if (headerIdx === -1) continue; - - const afterHeader = headerIdx + header.length; - const nextSection = nextToml.indexOf("\n[", afterHeader); - const sectionEnd = nextSection === -1 ? nextToml.length : nextSection; - const section = nextToml.substring(afterHeader, sectionEnd); - const cleaned = section.replace( - /^\s*tools\s*=\s*\[[^\n]*\]\s*(?:\r?\n)?/gm, - "", - ); - - if (cleaned !== section) { - nextToml = - nextToml.substring(0, afterHeader) + cleaned + nextToml.substring(sectionEnd); - } - } - return nextToml; -} - function stripDeprecatedSandboxPermissions(toml) { return String(toml || "").replace( /^\s*sandbox_permissions\s*=.*(?:\r?\n)?/gim, @@ -1581,14 +1502,7 @@ function applyAgentSdkDefaults(toml, env, primarySdk, result) { return nextToml; } -function ensureCommonMcpDefaults(toml, result, env = process.env) { - if (!shouldIncludeDefaultMcpServers(env)) { - const stripped = stripCommonMcpServerBlocks(toml); - if (stripped.changed) { - result.commonMcpRemoved = true; - } - return stripped.toml; - } +function ensureCommonMcpDefaults(toml, result) { let nextToml = toml; for (const definition of COMMON_MCP_SERVER_DEFS) { if (!definition.isPresent(nextToml)) { @@ -1676,9 +1590,7 @@ function initializeCodexConfigState(result) { } return { originalToml, - toml: stripUnsupportedMicrosoftDocsToolsConfig( - stripDeprecatedSandboxPermissions(originalToml), - ), + toml: stripDeprecatedSandboxPermissions(originalToml), }; } @@ -1692,7 +1604,7 @@ function applyEnsureCodexConfigDefaults(toml, env, primarySdk, result) { result.featuresAdded = featureResult.added; nextToml = featureResult.toml; - nextToml = ensureCommonMcpDefaults(nextToml, result, env); + nextToml = ensureCommonMcpDefaults(nextToml, result); nextToml = applyModelProviderDefaults(nextToml, env, result); return { sandboxState, toml: nextToml }; @@ -1853,3 +1765,4 @@ function parseBoolEnv(value) { } + diff --git a/shell/codex-model-profiles.mjs b/shell/codex-model-profiles.mjs index 8210b587a..8956b8d4f 100644 --- a/shell/codex-model-profiles.mjs +++ b/shell/codex-model-profiles.mjs @@ -9,28 +9,6 @@ function clean(value) { return String(value ?? "").trim(); } -function trimTrailingSlashes(value) { - let normalized = String(value ?? ""); - let end = normalized.length; - while (end > 0 && normalized[end - 1] === "/") { - end -= 1; - } - return end === normalized.length ? normalized : normalized.slice(0, end); -} - -export function resolveCodexHomeDir(envInput = process.env) { - const home = - clean(envInput?.HOME) || - clean(envInput?.USERPROFILE) || - ( - clean(envInput?.HOMEDRIVE) && clean(envInput?.HOMEPATH) - ? `${clean(envInput.HOMEDRIVE)}${clean(envInput.HOMEPATH)}` - : "" - ) || - clean(homedir()); - return home; -} - function isAzureOpenAIBaseUrl(value) { try { const parsed = value instanceof URL ? value : new URL(String(value || "")); @@ -52,21 +30,12 @@ function normalizeAzureOpenAIBaseUrl(value) { parsed.pathname = "/openai/v1"; parsed.search = ""; parsed.hash = ""; - return trimTrailingSlashes(parsed.toString()); + return parsed.toString().replace(/\/+$/, ""); } catch { return raw; } } -function normalizeProviderBaseUrlForComparison(value, providerKind = "openai") { - const raw = clean(value); - if (!raw) return ""; - if (providerKind === "azure") { - return normalizeAzureOpenAIBaseUrl(raw); - } - return trimTrailingSlashes(raw); -} - function normalizeProfileName(value, fallback = DEFAULT_ACTIVE_PROFILE) { const raw = clean(value).toLowerCase(); if (!raw) return fallback; @@ -96,7 +65,7 @@ function hasEnvValue(env, key) { return Boolean(key && clean(env?.[key])); } -export function getProviderEndpointEnvKeys(sectionName, providerKind) { +function getProviderEndpointEnvKeys(sectionName, providerKind) { const normalizedName = clean(sectionName).toUpperCase().replace(/[^A-Z0-9]+/g, "_"); if (providerKind === "azure") { const keys = ["AZURE_OPENAI_ENDPOINT"]; @@ -161,9 +130,9 @@ function profileRecord(env, profileName, globalProvider) { }; } -export function readCodexConfigRuntimeDefaults(envInput = process.env) { +export function readCodexConfigRuntimeDefaults() { try { - const configPath = resolve(resolveCodexHomeDir(envInput), ".codex", "config.toml"); + const configPath = resolve(homedir(), ".codex", "config.toml"); if (!existsSync(configPath)) { return { model: "", modelProvider: "", providers: {} }; } @@ -195,8 +164,8 @@ export function readCodexConfigRuntimeDefaults(envInput = process.env) { } } -function readCodexConfigTopLevelModel(envInput = process.env) { - return readCodexConfigRuntimeDefaults(envInput).model; +function readCodexConfigTopLevelModel() { + return readCodexConfigRuntimeDefaults().model; } function selectConfigProviderForRuntime(configDefaults, env, preferredProvider = "") { @@ -210,18 +179,12 @@ function selectConfigProviderForRuntime(configDefaults, env, preferredProvider = const matchingEntries = preferred ? entries.filter((section) => section.provider === preferred) : entries; - const normalizedRuntimeBaseUrl = normalizeProviderBaseUrlForComparison( - runtimeBaseUrl, - preferred || inferProviderKindFromSection("", { baseUrl: runtimeBaseUrl }, "openai"), - ); const baseUrlMatchedEntries = runtimeBaseUrl - ? matchingEntries.filter((section) => - normalizeProviderBaseUrlForComparison(section.baseUrl, section.provider) === normalizedRuntimeBaseUrl) + ? matchingEntries.filter((section) => clean(section.baseUrl) === runtimeBaseUrl) : []; const envBackedEntries = matchingEntries.filter((section) => providerRuntimeConfigured(env, section)); const baseUrlMatchedEnvBackedEntries = runtimeBaseUrl - ? envBackedEntries.filter((section) => - normalizeProviderBaseUrlForComparison(section.baseUrl, section.provider) === normalizedRuntimeBaseUrl) + ? envBackedEntries.filter((section) => clean(section.baseUrl) === runtimeBaseUrl) : []; const preferredNames = preferred === "azure" ? ["azure"] @@ -245,9 +208,7 @@ function selectConfigProviderForRuntime(configDefaults, env, preferredProvider = ), }; const preferredMatches = !preferred || configured.provider === preferred; - const baseUrlMatches = !runtimeBaseUrl || - normalizeProviderBaseUrlForComparison(configured.baseUrl, configured.provider) - === normalizedRuntimeBaseUrl; + const baseUrlMatches = !runtimeBaseUrl || clean(configured.baseUrl) === runtimeBaseUrl; if (preferredMatches && baseUrlMatches && providerRuntimeConfigured(env, configured)) { return configured; } @@ -266,21 +227,8 @@ function selectConfigProviderForRuntime(configDefaults, env, preferredProvider = } function inferGlobalProvider(env, configDefaults = null) { - const baseUrl = clean(env.OPENAI_BASE_URL); - if (baseUrl) { - if (isAzureOpenAIBaseUrl(baseUrl)) return "azure"; - const configured = selectConfigProviderForRuntime(configDefaults, env); - if (configured && clean(configured.baseUrl) === baseUrl) { - return configured.provider; - } - return "openai"; - } - if (hasEnvValue(env, "AZURE_OPENAI_API_KEY")) { - return "azure"; - } - if (hasEnvValue(env, "OPENAI_API_KEY")) { - return "openai"; - } + const baseUrl = clean(env.OPENAI_BASE_URL).toLowerCase(); + if (isAzureOpenAIBaseUrl(baseUrl)) return "azure"; const configured = selectConfigProviderForRuntime(configDefaults, env); return configured?.provider || "openai"; } @@ -293,7 +241,7 @@ function inferGlobalProvider(env, configDefaults = null) { */ export function resolveCodexProfileRuntime(envInput = process.env) { const sourceEnv = { ...envInput }; - const configDefaults = readCodexConfigRuntimeDefaults(sourceEnv); + const configDefaults = readCodexConfigRuntimeDefaults(); const activeProfile = normalizeProfileName( sourceEnv.CODEX_MODEL_PROFILE, DEFAULT_ACTIVE_PROFILE, @@ -309,7 +257,7 @@ export function resolveCodexProfileRuntime(envInput = process.env) { const env = { ...sourceEnv }; - const configModel = readCodexConfigTopLevelModel(sourceEnv); + const configModel = readCodexConfigTopLevelModel(); if (active.model) { env.CODEX_MODEL = active.model; diff --git a/shell/codex-shell.mjs b/shell/codex-shell.mjs index 740b85cb8..bd22e550c 100644 --- a/shell/codex-shell.mjs +++ b/shell/codex-shell.mjs @@ -12,18 +12,16 @@ * thread_id so we can resume the same conversation across restarts. */ -import "../infra/windows-hidden-child-processes.mjs"; import { readFile, writeFile, mkdir, readdir } from "node:fs/promises"; import { resolve } from "node:path"; -import { fileURLToPath, pathToFileURL } from "node:url"; -import { resolveAgentSdkConfig, resolveCodexSdkInstall } from "../agent/agent-sdk.mjs"; +import { fileURLToPath } from "node:url"; +import { resolveAgentSdkConfig } from "../agent/agent-sdk.mjs"; import { loadConfig } from "../config/config.mjs"; import { maybeCompressSessionItems } from "../workspace/context-cache.mjs"; import { resolveRepoRoot } from "../config/repo-root.mjs"; import { resolveCodexProfileRuntime, readCodexConfigRuntimeDefaults, - getProviderEndpointEnvKeys, } from "./codex-model-profiles.mjs"; import { buildTaskWritableRoots } from "./codex-config.mjs"; import { @@ -129,7 +127,6 @@ function buildInjectedSandboxConfig(envInput, workingDirectory) { function buildCodexSdkRuntime(streamProviderOverrides, envInput = process.env, workingDirectory = DEFAULT_WORKING_DIRECTORY) { const resolved = resolveCodexProfileRuntime(envInput); const { env: resolvedEnv, configProvider } = resolved; - const runtimeDefaults = readCodexConfigRuntimeDefaults(envInput) || {}; const baseUrl = resolvedEnv.OPENAI_BASE_URL || ""; const isAzure = isAzureOpenAIBaseUrl(baseUrl); const hasCustomBaseUrl = Boolean(String(baseUrl || "").trim()); @@ -164,16 +161,6 @@ function buildCodexSdkRuntime(streamProviderOverrides, envInput = process.env, w if (!unsetEnvKeys.includes(otherEnvKey)) { unsetEnvKeys.push(otherEnvKey); } - // Also remove endpoint/base URL env keys associated with the non-selected provider - const endpointKeys = getProviderEndpointEnvKeys(sectionName, "azure"); - for (const epKey of endpointKeys) { - if (epKey in env) { - delete env[epKey]; - if (!unsetEnvKeys.includes(epKey)) { - unsetEnvKeys.push(epKey); - } - } - } } } catch { // best effort — do not block SDK startup if config inspection fails @@ -181,11 +168,6 @@ function buildCodexSdkRuntime(streamProviderOverrides, envInput = process.env, w } const providerName = isAzure ? "azure" : "openai"; - const providerSectionNameResolved = isAzure - ? providerSectionName - : hasCustomBaseUrl - ? (configProvider?.name || "openai-direct") - : null; const config = isAzure ? { model_providers: { @@ -203,22 +185,18 @@ function buildCodexSdkRuntime(streamProviderOverrides, envInput = process.env, w } : hasCustomBaseUrl ? { - model_providers: providerSectionNameResolved - ? { - [providerSectionNameResolved]: { - ...streamProviderOverrides, - }, - } - : undefined, + model_providers: { + [providerSectionName]: { + ...streamProviderOverrides, + }, + }, } : {}; Object.assign(config, buildInjectedSandboxConfig(envInput, workingDirectory)); - if (providerSectionNameResolved) { - config.model_provider = providerSectionNameResolved; - } - if (env.CODEX_MODEL) { + if (isAzure && env.CODEX_MODEL) { + config.model_provider = providerSectionName; config.model = env.CODEX_MODEL; } @@ -360,7 +338,6 @@ const DEFAULT_WORKING_DIRECTORY = REPO_ROOT; // ── State ──────────────────────────────────────────────────────────────────── let CodexClass = null; // The Codex class from SDK -const CODEX_SDK_SPECIFIER = "@openai/codex-sdk"; // Define the SDK specifier let codexInstance = null; // Singleton Codex instance let activeThread = null; // Current persistent Thread let activeThreadId = null; // Thread ID for resume @@ -408,17 +385,6 @@ function resolveCodexTransport() { return "auto"; } -function shouldUseBareCodexSdkImport() { - return Boolean(import.meta.vitest || process.env.VITEST); -} - -async function importCodexSdkModule(resolvedSdk) { - if (shouldUseBareCodexSdkImport()) { - return import(CODEX_SDK_SPECIFIER); - } - return import(pathToFileURL(resolvedSdk.entryPath).href); -} - // ── SDK Loading ────────────────────────────────────────────────────────────── async function loadCodexSdk() { @@ -437,14 +403,9 @@ async function loadCodexSdk() { } if (CodexClass) return CodexClass; try { - const resolvedSdk = resolveCodexSdkInstall({ extraRoots: [getWorkingDirectory()] }); - if (!resolvedSdk?.entryPath) { - console.error("[codex-shell] failed to load SDK: no complete @openai/codex-sdk install found"); - return null; - } - const mod = await importCodexSdkModule(resolvedSdk); + const mod = await import("@openai/codex-sdk"); CodexClass = mod.Codex; - console.log(`[codex-shell] SDK loaded successfully from ${resolvedSdk.rootDir}`); + console.log("[codex-shell] SDK loaded successfully"); return CodexClass; } catch (err) { console.error(`[codex-shell] failed to load SDK: ${err.message}`); @@ -580,19 +541,6 @@ You have FULL ACCESS to: - File read/write: read any file, create/edit any file - MCP servers configured in this environment (availability varies) -## File Editing Strategy — IMPORTANT - -When editing files, always prefer the Bosun MCP file tools (available via the bosun MCP server): - -1. **LOCATE first** — use \`grep_search\` to find the exact code location before editing. -2. **READ before editing** — use \`read_file\` to confirm the exact text including whitespace. -3. **PREFER surgical edits** — use \`str_replace_editor\` for targeted changes. - - \`old_str\` must exactly match the file content (copy from \`read_file\` output). - - Include more surrounding lines if the text is not unique. -4. **Full rewrites only when necessary** — use \`write_file\` for new files or complete rewrites. -5. **NEVER use shell workarounds** to edit files (no \`node -e\`, no \`sed -i\`, no temp scripts, no patch files). - These break on Windows due to encoding and quoting issues. The MCP tools handle encoding correctly. - Key files: ${REPO_ROOT} — Repository root .cache/orchestrator-status.json — Live status data (if enabled) @@ -653,9 +601,6 @@ async function getThread() { codexInstance = new Cls({ config: { ...runtime.config, - model_provider: runtime.config?.model_provider, - model_providers: runtime.config?.model_providers, - model: runtime.config?.model, features: { ...(runtime.config?.features || {}), child_agents_md: true, @@ -1363,4 +1308,3 @@ export async function initCodexShell() { ); } } - diff --git a/shell/copilot-shell.mjs b/shell/copilot-shell.mjs index 1a4db9f06..692e033ab 100644 --- a/shell/copilot-shell.mjs +++ b/shell/copilot-shell.mjs @@ -7,12 +7,11 @@ * as the primary executor. */ -import "../infra/windows-hidden-child-processes.mjs"; import { existsSync, readFileSync, appendFileSync, mkdirSync, copyFileSync } from "node:fs"; import { readFile, writeFile, mkdir } from "node:fs/promises"; import { dirname, resolve } from "node:path"; import { fileURLToPath } from "node:url"; -import { execSync as nodeExecSync } from "node:child_process"; +import { execSync } from "node:child_process"; import { createRequire } from "node:module"; import { resolveRepoRoot } from "../config/repo-root.mjs"; import { loadConfig } from "../config/config.mjs"; @@ -24,16 +23,18 @@ import { } from "../infra/stream-resilience.mjs"; import { maybeCompressSessionItems } from "../workspace/context-cache.mjs"; -function execSync(command, options = {}) { - return nodeExecSync(command, { - ...options, - windowsHide: options.windowsHide ?? (process.platform === "win32"), - }); -} - const __dirname = resolve(fileURLToPath(new URL(".", import.meta.url))); const require = createRequire(import.meta.url); +// Lazy-import MCP registry — cached at module scope per AGENTS.md rules. +let _mcpRegistry = null; +async function getMcpRegistry() { + if (!_mcpRegistry) { + _mcpRegistry = await import("../workflow/mcp-registry.mjs"); + } + return _mcpRegistry; +} + // ── Configuration ──────────────────────────────────────────────────────────── const DEFAULT_TIMEOUT_MS = 60 * 60 * 1000; // 60 min for agentic tasks @@ -75,10 +76,6 @@ function getMcpRuntimeConfig() { } } -function shouldAllowExternalMcpSources(mcpCfg = getMcpRuntimeConfig()) { - return mcpCfg?.allowExternalSources === true; -} - function resolveCopilotTransport() { const raw = String(process.env.COPILOT_TRANSPORT || "auto") .trim() @@ -316,6 +313,33 @@ async function buildCliArgs() { args.push("--additional-mcp-config", mcpConfigPath); } + // Also write a temp MCP config from the library if installed servers exist + // (non-fatal: library MCP is a convenience, not a hard requirement) + if (!mcpConfigPath) { + try { + const registry = await getMcpRegistry(); + const mcpCfg = getMcpRuntimeConfig(); + const installed = await registry.listInstalledMcpServers(REPO_ROOT); + const ids = installed && installed.length ? installed.map((e) => e.id) : []; + let resolved = await registry.resolveMcpServersForAgent(REPO_ROOT, ids); + if (typeof registry.wrapServersWithDiscoveryProxy === "function") { + resolved = registry.wrapServersWithDiscoveryProxy(REPO_ROOT, resolved, { + enabled: mcpCfg.useDiscoveryProxy !== false, + includeCustomTools: mcpCfg.includeCustomToolsInDiscoveryProxy !== false, + cacheTtlMs: mcpCfg.discoveryProxyCacheTtlMs, + executeTimeoutMs: mcpCfg.discoveryProxyExecuteTimeoutMs, + }); + } + if (resolved && resolved.length) { + const tmpPath = registry.writeTempCopilotMcpConfig(REPO_ROOT, resolved); + args.push("--additional-mcp-config", tmpPath); + console.log(`[copilot-shell] injected ${resolved.length} library MCP server(s) via CLI args`); + } + } catch (err) { + console.warn(`[copilot-shell] failed to inject library MCP servers into CLI args: ${err.message}`); + } + } + if (args.length > 0) { console.log(`[copilot-shell] cliArgs: ${args.join(" ")}`); } @@ -712,9 +736,6 @@ function loadMcpServersFromFile(path) { } function loadMcpServers(profile = null) { - if (!shouldAllowExternalMcpSources()) { - return null; - } if (profile?.mcpServers) return profile.mcpServers; if (profile?.mcpConfig) { return loadMcpServersFromFile(profile.mcpConfig); @@ -728,6 +749,53 @@ function loadMcpServers(profile = null) { return loadMcpServersFromFile(configPath); } +/** + * Merge installed MCP library servers into an existing mcpServers map. + * Called during session build to inject library-managed MCP servers into + * the Copilot SDK session alongside any profile/env servers. + * + * Non-fatal: if the registry is unavailable or encounters errors, the + * original servers map is returned unchanged. + * + * @param {Object|null} existingServers — mcpServers from profile/env/config + * @returns {Promise} — merged servers map + */ +async function mergeLibraryMcpServers(existingServers) { + try { + const registry = await getMcpRegistry(); + const mcpCfg = getMcpRuntimeConfig(); + const installed = await registry.listInstalledMcpServers(REPO_ROOT); + const installedIds = installed && installed.length ? installed.map((e) => e.id) : []; + + // Resolve all installed servers into full configs + let resolved = await registry.resolveMcpServersForAgent(REPO_ROOT, installedIds); + if (typeof registry.wrapServersWithDiscoveryProxy === "function") { + resolved = registry.wrapServersWithDiscoveryProxy(REPO_ROOT, resolved, { + enabled: mcpCfg.useDiscoveryProxy !== false, + includeCustomTools: mcpCfg.includeCustomToolsInDiscoveryProxy !== false, + cacheTtlMs: mcpCfg.discoveryProxyCacheTtlMs, + executeTimeoutMs: mcpCfg.discoveryProxyExecuteTimeoutMs, + }); + } + if (!resolved || !resolved.length) return existingServers; + + // Convert to Copilot mcpServers format: { [id]: { command, args, env? } | { url } } + const copilotJson = registry.buildCopilotMcpJson(resolved); + const libraryServers = copilotJson?.mcpServers || {}; + if (!Object.keys(libraryServers).length) return existingServers; + + // Merge: existing servers take precedence over library ones (user overrides win) + const merged = { ...libraryServers, ...(existingServers || {}) }; + console.log( + `[copilot-shell] Merged ${Object.keys(libraryServers).length} library MCP server(s) into session`, + ); + return merged; + } catch (err) { + console.warn(`[copilot-shell] Failed to merge library MCP servers: ${err.message}`); + return existingServers; + } +} + async function buildSessionConfig() { const profile = resolveCopilotProfile(); const config = { @@ -763,9 +831,9 @@ async function buildSessionConfig() { config.reasoningEffort = effort.toLowerCase(); } - // Only explicit profile/env/config MCP sources are loaded here. - // Bosun-managed per-agent MCP selection is injected by the agent pool. - const mcpServers = loadMcpServers(profile); + // Load MCP servers from profile/env/config, then merge library-managed servers + const baseServers = loadMcpServers(profile); + const mcpServers = await mergeLibraryMcpServers(baseServers); if (mcpServers) config.mcpServers = mcpServers; return config; } diff --git a/shell/gemini-shell.mjs b/shell/gemini-shell.mjs index de145e9ae..28e610005 100644 --- a/shell/gemini-shell.mjs +++ b/shell/gemini-shell.mjs @@ -11,7 +11,6 @@ * cli -> CLI only */ -import "../infra/windows-hidden-child-processes.mjs"; import { spawn } from "node:child_process"; import { mkdir, readFile, writeFile } from "node:fs/promises"; import { resolve } from "node:path"; diff --git a/shell/opencode-providers.mjs b/shell/opencode-providers.mjs index dbda32bf9..2fab4cf29 100644 --- a/shell/opencode-providers.mjs +++ b/shell/opencode-providers.mjs @@ -1,4 +1,3 @@ -// CLAUDE:SUMMARY — discovers OpenCode providers/models via SDK and CLI fallbacks, normalizing snapshots and tolerating ignorable model-listing failures. /** * opencode-providers.mjs — Dynamic OpenCode provider & model discovery * @@ -13,34 +12,10 @@ */ import { execFile, exec } from "node:child_process"; +import { promisify } from "node:util"; -function execFileAsync(...args) { - return new Promise((resolve, reject) => { - execFile(...args, (error, stdout = "", stderr = "") => { - if (error) { - if (stdout !== undefined) error.stdout = stdout; - if (stderr !== undefined) error.stderr = stderr; - reject(error); - return; - } - resolve({ stdout, stderr }); - }); - }); -} - -function execAsync(...args) { - return new Promise((resolve, reject) => { - exec(...args, (error, stdout = "", stderr = "") => { - if (error) { - if (stdout !== undefined) error.stdout = stdout; - if (stderr !== undefined) error.stderr = stderr; - reject(error); - return; - } - resolve({ stdout, stderr }); - }); - }); -} +const execFileAsync = promisify(execFile); +const execAsync = promisify(exec); // ── Module-scope cache (lives at module scope per AGENTS.md) ────────────────── @@ -106,14 +81,13 @@ function shouldRetryProviderQueryWithoutDirectory(err) { if (status === 400) return true; const message = String(err?.message || "").toLowerCase(); - const stderrText = String(err?.stderr || "").toLowerCase(); const responseText = String( err?.response?.data?.error?.message || err?.response?.data?.message || err?.cause?.message || "", ).toLowerCase(); - const haystack = `${message} ${stderrText} ${responseText}`; + const haystack = `${message} ${responseText}`; return ( haystack.includes(" 400") || haystack.includes("failed to list models: 400") || @@ -129,22 +103,19 @@ function shouldRetryProviderQueryWithoutDirectory(err) { function isIgnorableModelDiscoveryError(err) { if (!err) return false; - if (isIgnorableModelDiscoveryCause(err?.cause)) return true; - const status = Number( err?.status ?? err?.response?.status ?? err?.cause?.status ?? NaN, ); if (status === 400) return true; const message = String(err?.message || "").toLowerCase(); - const stderrText = String(err?.stderr || "").toLowerCase(); const responseText = String( err?.response?.data?.error?.message || err?.response?.data?.message || err?.cause?.message || "", ).toLowerCase(); - const haystack = `${message} ${stderrText} ${responseText}`; + const haystack = `${message} ${responseText}`; return ( haystack.includes("failed to list models: 400") || haystack.includes("bad request") || @@ -156,35 +127,6 @@ function isIgnorableModelDiscoveryError(err) { ); } -function isIgnorableModelDiscoveryCause(cause) { - if (!cause) return false; - - const code = String(cause?.code || "").toUpperCase(); - const statusCode = Number(cause?.statusCode ?? cause?.status ?? cause?.response?.status ?? cause?.response?.statusCode ?? cause?.response?.data?.status ?? cause?.response?.data?.statusCode ?? NaN); - if (statusCode === 400) return true; - - const bodyText = String( - cause?.body - ?? cause?.responseBody - ?? cause?.response?.body - ?? cause?.response?.data?.error?.message - ?? cause?.response?.data?.message - ?? "", - ).toLowerCase(); - const message = String(cause?.message || "").toLowerCase(); - const haystack = `${code} ${message} ${bodyText}`; - return ( - haystack.includes("failed to list models: 400") || - haystack.includes(" 400") || - haystack.includes("status code 400") || - haystack.includes("bad request") || - haystack.includes("/models") || - haystack.includes("invalid url") || - haystack.includes("deployment") || - haystack.includes("api version") - ); -} - function buildEmptySnapshot() { return { providers: [], @@ -196,56 +138,6 @@ function buildEmptySnapshot() { }; } -function hasIgnorableCliStderr(text) { - const stderrText = String(text || "").trim(); - if (!stderrText) return false; - return isIgnorableModelDiscoveryError({ - message: stderrText, - stderr: stderrText, - }); -} - -function hasIgnorableModelDiscoverySignal(err) { - if (isIgnorableModelDiscoveryError(err)) return true; - - const stderrText = String(err?.stderr || "").trim(); - const stdoutText = String(err?.stdout || "").trim(); - return ( - !stdoutText - && !!stderrText - && isIgnorableModelDiscoveryError({ - message: stderrText, - stderr: stderrText, - status: err?.status, - response: err?.response, - cause: err?.cause, - }) - ); -} - -function hasIgnorableModelDiscoveryText(stdout = "", stderr = "") { - const stdoutText = String(stdout || "").trim(); - const stderrText = String(stderr || "").trim(); - if (!stderrText) return false; - - return isIgnorableModelDiscoveryError({ - message: !stdoutText ? stderrText : "", - stdout: stdoutText, - stderr: stderrText, - }); -} - -function extractRecoverySnapshot(err) { - const payload = err?.response?.data; - if (!payload || typeof payload !== "object") return null; - try { - const snapshot = normalizeSDKProviders(payload); - return isEmptySnapshot(snapshot) ? null : snapshot; - } catch { - return null; - } -} - function isEmptySnapshot(snapshot) { return Boolean( snapshot @@ -320,12 +212,16 @@ async function invokeProviderEndpoint(endpoint, requestOptions, context = null) return await callEndpoint(requestOptions); } catch (err) { if (!shouldRetryProviderQueryWithoutDirectory(err)) { - throw err; + return null; } } } - return await callEndpoint(); + try { + return await callEndpoint(); + } catch { + return null; + } } function normalizeProviderListData(data) { @@ -394,42 +290,28 @@ async function discoverViaSDK(existingClient = null) { ? { query: { directory } } : undefined; - const providerPromise = invokeProviderEndpoint(client?.provider?.list, requestOptions, client?.provider); - const authPromise = invokeProviderEndpoint(client?.provider?.auth, requestOptions, client?.provider); - const [providerResult, authResult] = await Promise.allSettled([providerPromise, authPromise]); - - const normalizedProviderData = normalizeProviderListData( - providerResult.status === "fulfilled" - ? providerResult.value?.data - : providerResult.reason?.response?.data || providerResult.reason?.cause?.response?.data, - ); - if (!normalizedProviderData) { - const providerError = providerResult.status === "rejected" ? providerResult.reason : null; - const recoveredSnapshot = extractRecoverySnapshot(providerError); - if (recoveredSnapshot) { - console.warn("[opencode-providers] recovering provider metadata from SDK error payload"); - return recoveredSnapshot; - } - if (providerError) { - if (hasIgnorableModelDiscoverySignal(providerError)) { - console.warn(`[opencode-providers] SDK discovery hit ignorable provider error: ${providerError.message}`); - } else { - console.warn(`[opencode-providers] SDK discovery failed: ${providerError.message}`); - } - } - return null; - } + // Fetch provider list + auth methods in parallel + const [providerRes, authRes] = await Promise.all([ + invokeProviderEndpoint(client?.provider?.list, requestOptions, client?.provider), + invokeProviderEndpoint(client?.provider?.auth, requestOptions, client?.provider), + ]); - if (providerResult.status === "rejected") { - console.warn("[opencode-providers] recovering provider metadata from SDK error payload"); - } + const normalizedProviderData = normalizeProviderListData(providerRes?.data); + if (!normalizedProviderData) return null; - const authMethods = authResult.status === "fulfilled" - ? (authResult.value?.data || {}) - : {}; + const authMethods = authRes?.data || {}; return buildSnapshotFromNormalizedProviderData(normalizedProviderData, authMethods); } catch (err) { console.warn(`[opencode-providers] SDK discovery failed: ${err.message}`); + + const fallbackProviderData = normalizeProviderListData( + err?.response?.data || err?.cause?.response?.data, + ); + if (fallbackProviderData) { + console.warn("[opencode-providers] recovering provider metadata from SDK error payload"); + return buildSnapshotFromNormalizedProviderData(fallbackProviderData, {}); + } + return null; } } @@ -459,46 +341,26 @@ async function execOpencode(args, execOpts = {}) { timeout: 30_000, maxBuffer: 10 * 1024 * 1024, encoding: "utf-8", - windowsHide: process.platform === "win32", ...execOpts, }; const escaped = args.map((a) => `"${a}"`).join(" "); - const commandText = `"${bin}" ${escaped}`; if (isWindows) { // Use exec() on Windows to properly handle .cmd wrappers - const result = await execAsync(commandText, baseOpts); - const normalized = typeof result === "string" + const result = await execAsync(`"${bin}" ${escaped}`, baseOpts); + return typeof result === "string" ? { stdout: result, stderr: "" } : { stdout: result.stdout || "", stderr: result.stderr || "" }; - if (!normalized.stdout.trim() && normalized.stderr.trim() && !hasIgnorableModelDiscoveryText(normalized.stdout, normalized.stderr)) { - const err = new Error(normalized.stderr.trim()); - err.stderr = normalized.stderr; - throw err; - } - return normalized; } try { const result = await execFileAsync(bin, args, baseOpts); - const normalized = typeof result === "string" + return typeof result === "string" ? { stdout: result, stderr: "" } : { stdout: result.stdout || "", stderr: result.stderr || "" }; - if (!normalized.stdout.trim() && normalized.stderr.trim() && !hasIgnorableModelDiscoveryText(normalized.stdout, normalized.stderr)) { - const err = new Error(normalized.stderr.trim()); - err.stderr = normalized.stderr; - throw err; - } - return normalized; } catch { - const result = await execAsync(commandText, baseOpts); - const normalized = typeof result === "string" + const result = await execAsync(`"${bin}" ${escaped}`, baseOpts); + return typeof result === "string" ? { stdout: result, stderr: "" } : { stdout: result.stdout || "", stderr: result.stderr || "" }; - if (!normalized.stdout.trim() && normalized.stderr.trim() && !hasIgnorableModelDiscoveryText(normalized.stdout, normalized.stderr)) { - const err = new Error(normalized.stderr.trim()); - err.stderr = normalized.stderr; - throw err; - } - return normalized; } } @@ -673,9 +535,9 @@ async function discoverViaCLI() { // fall through to the original verbose failure below } - if (hasIgnorableModelDiscoverySignal(err)) { + if (isIgnorableModelDiscoveryError(err)) { console.warn( - `[opencode-providers] CLI model discovery hit ignorable provider error with no basic fallback data: ${err.message}` , + `[opencode-providers] skipping CLI model discovery after provider returned HTTP 400: ${err.message}` , ); return buildEmptySnapshot(); } @@ -729,9 +591,9 @@ async function discoverAllViaCLI() { // fall through to the original verbose failure below } - if (hasIgnorableModelDiscoverySignal(err)) { + if (isIgnorableModelDiscoveryError(err)) { console.warn( - `[opencode-providers] catalog discovery hit ignorable provider error with no basic fallback data: ${err.message}`, + `[opencode-providers] skipping catalog discovery after provider returned HTTP 400: ${err.message}`, ); return buildEmptySnapshot(); } @@ -763,31 +625,12 @@ export async function discoverProviders(opts = {}) { } // Try SDK first (requires running server) - let snapshot = null; - try { - snapshot = await discoverViaSDK(client); - } catch (err) { - const recoveredSnapshot = extractRecoverySnapshot(err); - if (recoveredSnapshot) { - snapshot = recoveredSnapshot; - } - if (!hasIgnorableModelDiscoverySignal(err)) { - throw err; - } - if (!recoveredSnapshot) { - console.warn( - `[opencode-providers] SDK discovery hit ignorable provider error; falling back to CLI: ${err.message}`, - ); - snapshot = null; - } - } + let snapshot = await discoverViaSDK(client); - const sdkDiscoveryFailed = snapshot == null; + const sdkSnapshotWasEmpty = isEmptySnapshot(snapshot); - // Fall back to CLI only when SDK discovery was unavailable or failed. - // A successful-but-empty SDK response is authoritative for older SDK - // compatibility probes and disconnected environments. - if (sdkDiscoveryFailed) { + // Fall back to CLI + if (!snapshot || sdkSnapshotWasEmpty) { snapshot = await discoverViaCLI(); } @@ -926,11 +769,3 @@ export function invalidateCache() { - - - - - - - - diff --git a/shell/opencode-shell.mjs b/shell/opencode-shell.mjs index 1841a32b0..7df9a5ac9 100644 --- a/shell/opencode-shell.mjs +++ b/shell/opencode-shell.mjs @@ -14,7 +14,6 @@ * Server: opencode binary on PATH (https://opencode.ai) */ -import "../infra/windows-hidden-child-processes.mjs"; import { mkdir, readFile, writeFile } from "node:fs/promises"; import { resolve } from "node:path"; import { fileURLToPath } from "node:url"; diff --git a/shell/pwsh-runtime.mjs b/shell/pwsh-runtime.mjs index 1906c6895..d0460836f 100644 --- a/shell/pwsh-runtime.mjs +++ b/shell/pwsh-runtime.mjs @@ -1,19 +1,12 @@ import { existsSync } from "node:fs"; import { dirname, resolve } from "node:path"; import { fileURLToPath } from "node:url"; -import { execSync as nodeExecSync } from "node:child_process"; +import { execSync } from "node:child_process"; const __dirname = dirname(fileURLToPath(import.meta.url)); const BUNDLED_PWSH_PATH = resolve(__dirname, "..", ".cache", "bosun", "pwsh", "pwsh"); const BUNDLED_PWSH_WINDOWS_PATH = `${BUNDLED_PWSH_PATH}.exe`; -function execSync(command, options = {}) { - return nodeExecSync(command, { - ...options, - windowsHide: options.windowsHide ?? (process.platform === "win32"), - }); -} - function commandExists(cmd) { try { execSync(`${process.platform === "win32" ? "where" : "which"} ${cmd}`, { diff --git a/site/AGENTS.md b/site/AGENTS.md index 1557c060b..565ee1544 100644 --- a/site/AGENTS.md +++ b/site/AGENTS.md @@ -14,7 +14,5 @@ Public website and docs pages (`bosun.engineer`) static assets. - Demo/smoke failures -> `site/ui/demo.html`, CI/test hooks. ## Validation -- Run `npm run syntax:check` after changing any file in `site/ui/`; the hook now validates browser import graphs, not just parse errors. -- Keep `site/ui/` helper/module copies in sync with their `ui/` counterparts when the hosted demo imports them directly. - Build docs: `npm run build:docs` - Full checks: `npm test && npm run build` diff --git a/site/docs/architecture.html b/site/docs/architecture.html index 70c3e8419..2e2176d3d 100644 --- a/site/docs/architecture.html +++ b/site/docs/architecture.html @@ -27,8 +27,8 @@ Bosun
- Current Version: v0.42.6 - Docs Last Updated: v0.42.6 + Current Version: v0.39.3 + Docs Last Updated: v0.39.3
diff --git a/site/docs/cli-reference.html b/site/docs/cli-reference.html index 6c1052dc6..6bf20caf5 100644 --- a/site/docs/cli-reference.html +++ b/site/docs/cli-reference.html @@ -27,8 +27,8 @@ Bosun
- Current Version: v0.42.6 - Docs Last Updated: v0.42.6 + Current Version: v0.39.3 + Docs Last Updated: v0.39.3
diff --git a/site/docs/configuration.html b/site/docs/configuration.html index a96129edf..fb5b0b027 100644 --- a/site/docs/configuration.html +++ b/site/docs/configuration.html @@ -27,8 +27,8 @@ Bosun
- Current Version: v0.42.6 - Docs Last Updated: v0.42.6 + Current Version: v0.39.3 + Docs Last Updated: v0.39.3
diff --git a/site/docs/getting-started.html b/site/docs/getting-started.html index 68abb8138..993605652 100644 --- a/site/docs/getting-started.html +++ b/site/docs/getting-started.html @@ -27,8 +27,8 @@ Bosun
- Current Version: v0.42.6 - Docs Last Updated: v0.42.6 + Current Version: v0.39.3 + Docs Last Updated: v0.39.3
@@ -93,7 +93,7 @@

Step 1: Install Bosun

Verify the install:

bosun --version
-# bosun v0.42.6
+# bosun v0.39.3

Step 2: Run setup

diff --git a/site/docs/index.html b/site/docs/index.html index 7644a2362..36b8a2480 100644 --- a/site/docs/index.html +++ b/site/docs/index.html @@ -29,8 +29,8 @@ Bosun
- Current Version: v0.42.6 - Docs Last Updated: v0.42.6 + Current Version: v0.39.3 + Docs Last Updated: v0.39.3
diff --git a/site/docs/installation.html b/site/docs/installation.html index 8c2095236..0f5f607d3 100644 --- a/site/docs/installation.html +++ b/site/docs/installation.html @@ -29,8 +29,8 @@ Bosun
- Current Version: v0.42.6 - Docs Last Updated: v0.42.6 + Current Version: v0.41.8 + Docs Last Updated: v0.41.8
diff --git a/site/docs/integrations.html b/site/docs/integrations.html index 999d011df..6b2116348 100644 --- a/site/docs/integrations.html +++ b/site/docs/integrations.html @@ -27,8 +27,8 @@ Bosun
- Current Version: v0.42.6 - Docs Last Updated: v0.42.6 + Current Version: v0.39.3 + Docs Last Updated: v0.39.3
diff --git a/site/lib/session-insights.mjs b/site/lib/session-insights.mjs index aa61676ec..2673fa076 100644 --- a/site/lib/session-insights.mjs +++ b/site/lib/session-insights.mjs @@ -225,83 +225,14 @@ function parseContextBreakdown(text) { function normalizeUsage(value) { if (!value || typeof value !== "object") return null; const input = - Number(value.input_tokens ?? value.prompt_tokens ?? value.inputTokens ?? value.promptTokens ?? value.input ?? value.prompt ?? 0) || 0; + Number(value.input_tokens ?? value.prompt_tokens ?? value.input ?? value.prompt ?? 0) || 0; const output = - Number(value.output_tokens ?? value.completion_tokens ?? value.outputTokens ?? value.completionTokens ?? value.output ?? value.completion ?? 0) || 0; - const total = Number(value.total_tokens ?? value.totalTokens ?? value.total ?? input + output) || 0; + Number(value.output_tokens ?? value.completion_tokens ?? value.output ?? value.completion ?? 0) || 0; + const total = Number(value.total_tokens ?? value.total ?? input + output) || 0; if (input <= 0 && output <= 0 && total <= 0) return null; return { input, output, total }; } -function normalizeTokenUsageMeta(meta) { - if (!meta || typeof meta !== "object") return null; - return normalizeUsage( - meta.tokenUsage - || meta.usage - || meta.tokens - || (meta.inputTokens != null || meta.outputTokens != null || meta.totalTokens != null ? meta : null), - ); -} - -function toTimestampMs(value) { - if (value === null || value === undefined || value === "") return null; - const ms = new Date(value).getTime(); - return Number.isFinite(ms) ? ms : null; -} - -function buildTurnTimeline(messages = []) { - const turns = new Map(); - for (const msg of Array.isArray(messages) ? messages : []) { - if (!msg || !Number.isFinite(Number(msg.turnIndex))) continue; - const turnIndex = Number(msg.turnIndex); - const timestamp = String(msg.timestamp || ""); - const tsMs = toTimestampMs(timestamp); - const entry = turns.get(turnIndex) || { - turn: turnIndex + 1, - turnIndex, - startedAt: null, - endedAt: null, - durationMs: null, - inputTokens: 0, - outputTokens: 0, - totalTokens: 0, - toolCalls: 0, - assistantPreview: "", - }; - if (tsMs !== null) { - const startedMs = toTimestampMs(entry.startedAt); - const endedMs = toTimestampMs(entry.endedAt); - if (startedMs === null || tsMs < startedMs) entry.startedAt = timestamp; - if (endedMs === null || tsMs > endedMs) entry.endedAt = timestamp; - } - const type = String(msg.type || "").toLowerCase(); - const role = String(msg.role || "").toLowerCase(); - if (type === "tool_call" && String(msg?.meta?.lifecycle || "").toLowerCase() !== "started") { - entry.toolCalls += 1; - } - const usage = normalizeTokenUsageMeta(msg?.meta) || normalizeUsage(msg?.usage) || null; - if (usage) { - entry.inputTokens += usage.input; - entry.outputTokens += usage.output; - entry.totalTokens += usage.total; - } - if ((role === "assistant" || type === "agent_message" || type === "assistant_message") && !entry.assistantPreview) { - entry.assistantPreview = toText(msg.content).replace(/\s+/g, " ").trim().slice(0, 180); - } - turns.set(turnIndex, entry); - } - return Array.from(turns.values()) - .sort((a, b) => a.turnIndex - b.turnIndex) - .map((entry) => { - const startedMs = toTimestampMs(entry.startedAt); - const endedMs = toTimestampMs(entry.endedAt); - return { - ...entry, - durationMs: startedMs !== null && endedMs !== null ? Math.max(0, endedMs - startedMs) : null, - }; - }); -} - export function formatCompactCount(value) { const n = Number(value || 0); if (!Number.isFinite(n)) return "0"; @@ -357,7 +288,7 @@ export function buildSessionInsights(fullSession = null) { }); } - const usage = normalizeTokenUsageMeta(msg?.meta) || normalizeUsage(msg?.usage) || null; + const usage = normalizeUsage(msg?.meta?.usage) || normalizeUsage(msg?.usage) || null; if (usage) { tokenUsage.inputTokens += usage.input; tokenUsage.outputTokens += usage.output; @@ -458,7 +389,6 @@ export function buildSessionInsights(fullSession = null) { contextWindow, contextBreakdown, tokenUsage, - turnTimeline: buildTurnTimeline(messages), activityDiff: { files: edited.map((entry) => ({ path: entry.path, @@ -487,7 +417,6 @@ export function buildSessionInsights(fullSession = null) { ? persisted.contextBreakdown : derived.contextBreakdown, tokenUsage: persisted.tokenUsage || derived.tokenUsage, - turnTimeline: Array.isArray(persisted.turnTimeline) ? persisted.turnTimeline : derived.turnTimeline, activityDiff: persisted.activityDiff || derived.activityDiff, generatedAt: persisted.generatedAt || derived.generatedAt, }; diff --git a/site/ui/app.js b/site/ui/app.js index e625ec565..06aa57f6a 100644 --- a/site/ui/app.js +++ b/site/ui/app.js @@ -352,9 +352,6 @@ import { wsLatency, wsReconnectIn, wsConnected, - wsReconnectCount, - wsStatus, - wsLastReconnectAt, loadingCount, } from "./modules/api.js"; import { @@ -418,7 +415,6 @@ import { ChatTab } from "./tabs/chat.js"; /* ── Lazy tab loading ── */ const _lazyTabCache = {}; -const _lazyTabInflight = {}; function resolveLazyTabComponent(mod, exportName) { const direct = exportName ? mod?.[exportName] : mod?.default; @@ -435,34 +431,13 @@ function LazyTab({ loader, fallback, ...props }) { const [Comp, setComp] = useState(_lazyTabCache[loader.key] || null); const [err, setErr] = useState(null); useEffect(() => { - setErr(null); - if (_lazyTabCache[loader.key]) { - setComp(() => _lazyTabCache[loader.key]); - return; - } + if (_lazyTabCache[loader.key]) { setComp(() => _lazyTabCache[loader.key]); return; } let cancelled = false; - const pendingLoad = _lazyTabInflight[loader.key] - || loader() - .then((mod) => { - const C = resolveLazyTabComponent(mod, loader.exportName); - _lazyTabCache[loader.key] = C; - return C; - }) - .finally(() => { - delete _lazyTabInflight[loader.key]; - }); - _lazyTabInflight[loader.key] = pendingLoad; - - pendingLoad - .then((resolvedComp) => { - if (!cancelled) setComp(() => resolvedComp); - }) - .catch((e) => { - if (!cancelled) { - setComp(null); - setErr(e); - } - }); + loader().then((mod) => { + const C = resolveLazyTabComponent(mod, loader.exportName); + _lazyTabCache[loader.key] = C; + if (!cancelled) setComp(() => C); + }).catch((e) => { if (!cancelled) setErr(e); }); return () => { cancelled = true; }; }, [loader]); if (err) return html`
Failed to load tab: ${err.message}
`; @@ -488,12 +463,10 @@ const BenchmarksTab = lazyTab("./tabs/benchmarks.js", "BenchmarksTab", () => imp const AgentsTab = lazyTab("./tabs/agents.js", "AgentsTab", () => import("./tabs/agents.js")); const FleetSessionsTab = lazyTab("./tabs/agents.js", "FleetSessionsTab", () => import("./tabs/agents.js")); const InfraTab = lazyTab("./tabs/infra.js", "InfraTab", () => import("./tabs/infra.js")); -const GuardrailsTab = lazyTab("./tabs/guardrails.js", "GuardrailsTab", () => import("./tabs/guardrails.js")); const ControlTab = lazyTab("./tabs/control.js", "ControlTab", () => import("./tabs/control.js")); const LogsTab = lazyTab("./tabs/logs.js", "LogsTab", () => import("./tabs/logs.js")); const TelemetryTab = lazyTab("./tabs/telemetry.js", "TelemetryTab", () => import("./tabs/telemetry.js")); const SettingsTab = lazyTab("./tabs/settings.js", "SettingsTab", () => import("./tabs/settings.js")); -const IntegrationsTab = lazyTab("./tabs/integrations.js", "IntegrationsTab", () => import("./tabs/integrations.js")); const WorkflowsTab = lazyTab("./tabs/workflows.js", "WorkflowsTab", () => import("./tabs/workflows.js")); const LibraryTab = lazyTab("./tabs/library.js", "LibraryTab", () => import("./tabs/library.js")); const LibraryMarketplaceTab = lazyTab("./tabs/library.js", "LibraryMarketplaceTab", () => import("./tabs/library.js")); @@ -779,7 +752,6 @@ const TAB_COMPONENTS = { agents: AgentsTab, "fleet-sessions": FleetSessionsTab, infra: InfraTab, - guardrails: GuardrailsTab, control: ControlTab, logs: LogsTab, telemetry: TelemetryTab, @@ -788,8 +760,8 @@ const TAB_COMPONENTS = { library: LibraryTab, marketplace: LibraryMarketplaceTab, settings: SettingsTab, - integrations: IntegrationsTab, }; + function getMaxFreshnessMs(rawFreshness) { if (typeof rawFreshness === "number") { return Number.isFinite(rawFreshness) ? rawFreshness : null; @@ -817,39 +789,6 @@ function inferUiConnected() { /* ═══════════════════════════════════════════════ * Header * ═══════════════════════════════════════════════ */ -function ConnectionBadge() { - const status = wsStatus.value; - const reconnectCount = wsReconnectCount.value; - const lastReconnectAt = wsLastReconnectAt.value; - - let label = "Offline"; - let badgeClass = "offline"; - if (status === "connected") { - label = "Connected"; - badgeClass = "connected"; - } else if (status === "reconnecting") { - label = reconnectCount > 0 ? `Reconnecting... ${reconnectCount}` : "Reconnecting..."; - badgeClass = "reconnecting"; - } - - const lastReconnectLabel = - lastReconnectAt != null - ? new Date(lastReconnectAt).toLocaleTimeString([], { hour: "numeric", minute: "2-digit", second: "2-digit" }) - : "never"; - const tooltip = `Connection status: ${label}; last reconnect ${lastReconnectLabel}`; - - return html` -
- - ${label} -
- `; -} - function Header() { const isConn = inferUiConnected(); const user = getTelegramUser(); @@ -894,7 +833,6 @@ function Header() { <${Box} sx=${{flexGrow: 1}} /> <${Stack} direction="row" spacing=${1} alignItems="center"> - <${ConnectionBadge} /> <${Chip} size="small" label=${connLabel} @@ -1298,28 +1236,6 @@ function InspectorPanel({ onResizeStart, onResizeReset, showResizer }) { const contextWindow = insights?.contextWindow || null; const tokenUsage = insights?.tokenUsage || null; const recentActions = Array.isArray(insights?.recentActions) ? insights.recentActions : []; - - // Context window breakdown grouping - const _SYSTEM_CTX = new Set(["system instructions", "tool definitions", "system"]); - const _USER_CTX = new Set(["messages", "files", "tool results", "user context"]); - const ctxRefTokens = contextWindow?.totalTokens || tokenUsage?.totalTokens || 0; - const ctxSystemRows = insightsContextBreakdown.filter((r) => _SYSTEM_CTX.has(String(r.label || "").toLowerCase())); - const ctxUserRows = insightsContextBreakdown.filter((r) => _USER_CTX.has(String(r.label || "").toLowerCase())); - const ctxOtherRows = insightsContextBreakdown.filter( - (r) => !_SYSTEM_CTX.has(String(r.label || "").toLowerCase()) && !_USER_CTX.has(String(r.label || "").toLowerCase()), - ); - const renderCtxRow = (row, idx) => { - const approxTokens = ctxRefTokens > 0 ? Math.round((row.percent / 100) * ctxRefTokens) : null; - return html` -
- ${row.label} - - ${approxTokens != null ? html`${formatCompactCount(approxTokens)}` : ""} - ${row.percent}% - -
`; - }; - let smartLogsContent = html`
${smartLogs.map( @@ -1405,55 +1321,54 @@ function InspectorPanel({ onResizeStart, onResizeReset, showResizer }) {
Messages${formatCompactCount(insightsTotals.messages)}
Errors${formatCompactCount(insightsTotals.errors)}
- ${(contextWindow || tokenUsage || insightsContextBreakdown.length > 0 || insightsTopTools.length > 0) && + ${(contextWindow || tokenUsage) && html`
-
- Context Window - ${contextWindow?.percent != null - ? html`${contextWindow.percent}%` - : html`Tracked`} -
- ${contextWindow?.percent != null && - html`
-
-
`} - ${contextWindow?.usedTokens != null && - html`
- ${formatCompactCount(contextWindow.usedTokens)}${contextWindow.totalTokens != null ? ` / ${formatCompactCount(contextWindow.totalTokens)} tokens` : " tokens"} -
`} - ${ctxSystemRows.length > 0 && - html`
-
System
- ${ctxSystemRows.map(renderCtxRow)} -
`} - ${ctxUserRows.length > 0 && - html`
-
User Context
- ${ctxUserRows.map(renderCtxRow)} -
`} - ${ctxOtherRows.length > 0 && ctxOtherRows.map(renderCtxRow)} + ${contextWindow && + html` +
Context Window + ${contextWindow.percent != null + ? `${contextWindow.percent}%` + : "Tracked"} +
+ ${(contextWindow.usedTokens || contextWindow.totalTokens) && + html` +
Token Fill + ${contextWindow.usedTokens != null ? formatCompactCount(contextWindow.usedTokens) : "—"} + ${contextWindow.totalTokens != null ? ` / ${formatCompactCount(contextWindow.totalTokens)}` : ""} +
+ `} + `} ${tokenUsage && - html`
-
Token Usage
-
- Input - ${formatCompactCount(tokenUsage.inputTokens)} -
-
- Output - ${formatCompactCount(tokenUsage.outputTokens)} -
-
`} - ${insightsTopTools.length > 0 && - html`
-
Top Tools
-
- ${insightsTopTools.map( - (tool) => html`${tool.name}: ${formatCompactCount(tool.count)}`, - )} + html` +
Token Usage${formatCompactCount(tokenUsage.totalTokens || 0)}
+
Input / Output${formatCompactCount(tokenUsage.inputTokens || 0)} / ${formatCompactCount(tokenUsage.outputTokens || 0)}
+ `} +
+ `} + ${insightsTopTools.length > 0 && + html` +
+ ${insightsTopTools.map( + (tool) => html` + + ${tool.name}: ${formatCompactCount(tool.count)} + + `, + )} +
+ `} + ${insightsContextBreakdown.length > 0 && + html` +
+ ${insightsContextBreakdown.slice(0, 6).map( + (row) => html` +
+ ${row.label} + ${row.percent}%
-
`} + `, + )}
`} ` @@ -2910,7 +2825,6 @@ function App() { /* ─── Mount ─── */ const mountRoot = () => document.getElementById("app"); const signalAppMounted = () => { - globalThis.__bosunAppMounted = true; globalThis.dispatchEvent?.(new Event("bosun:app-mounted")); }; const mountApp = () => { @@ -2928,7 +2842,6 @@ const remountApp = () => { root.replaceChildren(); } preactRender(html`<${App} />`, root); - signalAppMounted(); }; globalThis.__veRemountApp = remountApp; mountApp(); diff --git a/site/ui/components/chat-view.js b/site/ui/components/chat-view.js index 3c757a4da..0f45bd4c7 100644 --- a/site/ui/components/chat-view.js +++ b/site/ui/components/chat-view.js @@ -1004,21 +1004,20 @@ export function ChatView({ sessionId, readOnly = false, embedded = false }) { const statusSessionId = String(globalStatus.sessionId || ""); const statusMatchesSession = statusSessionId.length > 0 && statusSessionId === currentSessionId; - const liveState = statusMatchesSession ? (globalStatus.state || "idle") : "idle"; statusState = paused ? "paused" - : liveState !== "idle" - ? liveState - : isActive ? "active" : "idle"; + : statusMatchesSession + ? globalStatus.state || "idle" + : "idle"; statusText = paused ? "Stream paused" - : liveState !== "idle" - ? agentStatusText.value - : isActive ? "Active" : "Ready"; + : statusMatchesSession + ? agentStatusText.value || "Ready" + : "Ready"; } catch (err) { console.warn("[ChatView] Failed to read status signals:", err); - statusState = paused ? "paused" : isActive ? "active" : "idle"; - statusText = paused ? "Stream paused" : isActive ? "Active" : "Ready"; + statusState = paused ? "paused" : "idle"; + statusText = paused ? "Stream paused" : "Ready"; } const renderItems = useMemo(() => { diff --git a/site/ui/demo-defaults.js b/site/ui/demo-defaults.js index 307bf5060..e2425a0e4 100644 --- a/site/ui/demo-defaults.js +++ b/site/ui/demo-defaults.js @@ -15,11 +15,10 @@ "pr", "handoff", "progression", - "event-driven", - "worktree-managed" + "event-driven" ], - "nodeCount": 17, - "edgeCount": 20, + "nodeCount": 13, + "edgeCount": 16, "recommended": true, "enabled": true, "trigger": "trigger.workflow_call", @@ -32,19 +31,15 @@ }, "metadata": { "author": "bosun", - "version": 2, + "version": 1, "createdAt": "2026-03-13T00:00:00Z", - "templateVersion": "2.0.0", + "templateVersion": "1.0.0", "tags": [ "github", "pr", "handoff", "progression", - "event-driven", - "worktree-managed" - ], - "changelog": [ - "v2.0: Programmatic worktree setup + push. Agent no longer manages git state directly — fixes the live-pr-XXX synthetic branch problem." + "event-driven" ] }, "nodes": [ @@ -99,7 +94,7 @@ "label": "Normalize PR Context", "config": { "key": "prProgressContext", - "value": "/* */ (() => { const prOut = $ctx.getNodeOutput('create-pr') || $ctx.getNodeOutput('create-pr-retry') || {}; const prUrl = String($data?.prUrl || prOut?.prUrl || prOut?.url || '').trim(); const repoMatch = prUrl.match(/github\\.com\\/([^/]+\\/[^/?#]+)/i); const repo = String($data?.repo || (repoMatch ? repoMatch[1] : '')).trim(); const rawPrNumber = $data?.prNumber ?? prOut?.prNumber ?? null; const parsedPrNumber = Number.parseInt(String(rawPrNumber || ''), 10); return { taskId: String($data?.taskId || '').trim() || null, taskTitle: String($data?.taskTitle || '').trim() || null, repo: repo || null, branch: String($data?.branch || prOut?.branch || '').trim() || null, baseBranch: String($data?.baseBranch || prOut?.base || 'main').trim() || 'main', prNumber: Number.isFinite(parsedPrNumber) && parsedPrNumber > 0 ? parsedPrNumber : null, prUrl: prUrl || null, };})()", + "value": "(() => { const prOut = $ctx.getNodeOutput('create-pr') || $ctx.getNodeOutput('create-pr-retry') || {}; const prUrl = String($data?.prUrl || prOut?.prUrl || prOut?.url || '').trim(); const repoMatch = prUrl.match(/github\\.com\\/([^/]+\\/[^/?#]+)/i); const repo = String($data?.repo || (repoMatch ? repoMatch[1] : '')).trim(); const rawPrNumber = $data?.prNumber ?? prOut?.prNumber ?? null; const parsedPrNumber = Number.parseInt(String(rawPrNumber || ''), 10); return { taskId: String($data?.taskId || '').trim() || null, taskTitle: String($data?.taskTitle || '').trim() || null, repo: repo || null, branch: String($data?.branch || prOut?.branch || '').trim() || null, baseBranch: String($data?.baseBranch || prOut?.base || 'main').trim() || 'main', prNumber: Number.isFinite(parsedPrNumber) && parsedPrNumber > 0 ? parsedPrNumber : null, prUrl: prUrl || null, };})()", "isExpression": true }, "position": { @@ -203,118 +198,21 @@ "default" ] }, - { - "id": "setup-pr-worktree", - "type": "action.run_command", - "label": "Clone & Checkout PR Branch", - "config": { - "command": "node", - "args": [ - "-e", - "const os=require('os'); const path=require('path'); const fs=require('fs'); const {execFileSync}=require('child_process'); const repo=String(process.env.PR_REPO||'').trim(); const branch=String(process.env.PR_BRANCH||'').trim(); const base=String(process.env.PR_BASE||'main').trim(); const num=String(process.env.PR_NUMBER||'0').trim(); if(!repo||!branch){console.log(JSON.stringify({error:'missing repo or branch',repo,branch}));process.exit(1);} const wt=path.join(os.tmpdir(),'bosun-progfix-'+num.replace(/[^0-9a-z]/gi,'-')); let reused=false; if(fs.existsSync(path.join(wt,'.git'))){ try{ const cur=execFileSync('git',['rev-parse','--abbrev-ref','HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(cur===branch){ execFileSync('git',['fetch','origin',branch],{cwd:wt,encoding:'utf8',timeout:120000,stdio:['ignore','pipe','pipe']}); execFileSync('git',['reset','--hard','origin/'+branch],{cwd:wt,encoding:'utf8',timeout:30000}); execFileSync('git',['clean','-fdx'],{cwd:wt,encoding:'utf8',timeout:30000}); try{execFileSync('git',['fetch','origin',base],{cwd:wt,encoding:'utf8',timeout:60000,stdio:['ignore','pipe','pipe']});}catch{} reused=true; }else{fs.rmSync(wt,{recursive:true,force:true});} }catch{try{fs.rmSync(wt,{recursive:true,force:true});}catch{}} } if(!reused){ if(fs.existsSync(wt)){try{fs.rmSync(wt,{recursive:true,force:true});}catch{}} execFileSync('gh',['repo','clone',repo,wt,'--','--branch',branch],{encoding:'utf8',timeout:300000,stdio:'inherit'}); execFileSync('git',['fetch','origin',branch],{cwd:wt,encoding:'utf8',timeout:120000,stdio:['ignore','pipe','pipe']}); execFileSync('git',['reset','--hard','origin/'+branch],{cwd:wt,encoding:'utf8',timeout:30000}); try{execFileSync('git',['fetch','origin',base],{cwd:wt,encoding:'utf8',timeout:60000,stdio:['ignore','pipe','pipe']});}catch{} } const finalBranch=execFileSync('git',['rev-parse','--abbrev-ref','HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(finalBranch!==branch){console.error('Branch mismatch: expected '+branch+' got '+finalBranch);process.exit(1);} console.log(JSON.stringify({worktreePath:wt,branch:finalBranch,base,repo,number:num,reused}));" - ], - "parseJson": true, - "failOnError": true, - "timeoutMs": 600000, - "env": { - "PR_REPO": "(()=>{ const d=JSON.parse($ctx.getNodeOutput('inspect-pr')?.output||'{}'); return String(d.repo||$data?.prProgressContext?.repo||''); })()", - "PR_BRANCH": "(()=>{ const d=JSON.parse($ctx.getNodeOutput('inspect-pr')?.output||'{}'); return String(d.branch||d.prDigest?.core?.branch||$data?.prProgressContext?.branch||''); })()", - "PR_BASE": "(()=>{ const d=JSON.parse($ctx.getNodeOutput('inspect-pr')?.output||'{}'); return String(d.baseBranch||d.prDigest?.core?.baseBranch||$data?.prProgressContext?.baseBranch||'main'); })()", - "PR_NUMBER": "(()=>{ const d=JSON.parse($ctx.getNodeOutput('inspect-pr')?.output||'{}'); return String(d.prNumber||$data?.prProgressContext?.prNumber||'0'); })()" - } - }, - "position": { - "x": 220, - "y": 880 - }, - "outputs": [ - "default" - ] - }, - { - "id": "set-pr-worktree-path", - "type": "action.set_variable", - "label": "Set Agent Working Directory", - "config": { - "key": "worktreePath", - "value": "{{setup-pr-worktree.output.worktreePath}}" - }, - "position": { - "x": 220, - "y": 920 - }, - "outputs": [ - "default" - ] - }, { "id": "dispatch-fix-agent", "type": "action.run_agent", "label": "Dispatch Focused Fix Agent", "config": { - "prompt": "You are a Bosun PR repair fallback agent working one PR only.\n\n## CRITICAL RULES — Read Before Doing Anything\n\nYour working directory is already a git clone of the target repo, checked out on the PR's HEAD branch (`{{setup-pr-worktree.output.branch}}`). The base branch (`{{setup-pr-worktree.output.base}}`) has been fetched.\n\n- Do NOT clone the repo. Do NOT create branches. Do NOT push.\n- Work ONLY in the current directory on the current branch.\n- The workflow will commit and push your changes automatically after you finish.\n\n## PR Context\n\n{{$ctx.getNodeOutput('inspect-pr')?.output}}\n\n## Repair Attempt Output\n\n{{$ctx.getNodeOutput('programmatic-fix')?.output}}\n\nUse prDigest.body, prDigest.files, prDigest.issueComments, prDigest.reviews, prDigest.reviewComments, prDigest.checks, failedAnnotations, and any failedLogExcerpt before making changes.\n\n## Fix Instructions\n\n- Only fix this PR's CI or merge-conflict issue.\n- For merge conflicts: `git merge origin/{{setup-pr-worktree.output.base}}` and resolve.\n- For CI failures: study the error output and apply the MINIMAL code fix.\n- Do not merge, approve, or close the PR.\n- Keep the patch minimal and scoped to the reported failure.\n- After fixing, remove the label:\n `gh pr edit {{setup-pr-worktree.output.number}} --repo {{setup-pr-worktree.output.repo}} --remove-label bosun-needs-fix`\n", + "prompt": "You are a Bosun PR repair fallback agent working one PR only.\n\nPR context:\n{{$ctx.getNodeOutput('inspect-pr')?.output}}\n\nRepair attempt output:\n{{$ctx.getNodeOutput('programmatic-fix')?.output}}\n\nUse prDigest.body, prDigest.files, prDigest.issueComments, prDigest.reviews, prDigest.reviewComments, prDigest.checks, failedAnnotations, and any failedLogExcerpt before making changes.\n\nRules:\n- Only fix this PR's CI or merge-conflict issue.\n- Do not merge, approve, or close the PR.\n- Keep the patch minimal and scoped to the reported failure.\n- If you repair the PR, remove the bosun-needs-fix label.\n", "sdk": "auto", "timeoutMs": 1800000, - "delegationWatchdogTimeoutMs": "{{delegationWatchdogTimeoutMs}}", - "delegationWatchdogMaxRecoveries": "{{delegationWatchdogMaxRecoveries}}", "maxRetries": 2, "retryDelayMs": 30000, "continueOnError": true }, "position": { "x": 220, - "y": 970 - }, - "outputs": [ - "default" - ] - }, - { - "id": "push-pr-fixes", - "type": "action.run_command", - "label": "Push Fixes to PR Branch", - "config": { - "command": "node", - "args": [ - "-e", - "const {execFileSync}=require('child_process'); const wt=String(process.env.WORKTREE_PATH||'').trim(); const expectedBranch=String(process.env.PR_BRANCH||'').trim(); if(!wt){console.log(JSON.stringify({pushed:false,reason:'no worktree path'}));process.exit(0);} const branch=execFileSync('git',['rev-parse','--abbrev-ref','HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(expectedBranch&&branch!==expectedBranch){console.log(JSON.stringify({pushed:false,reason:'branch mismatch',expected:expectedBranch,actual:branch}));process.exit(1);} const status=execFileSync('git',['status','--porcelain'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); const diff=execFileSync('git',['diff','--stat','HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); const ahead=execFileSync('git',['rev-list','--count','origin/'+branch+'..HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(!status&&!diff&&ahead==='0'){console.log(JSON.stringify({pushed:false,reason:'nothing to push'}));process.exit(0);} if(status){execFileSync('git',['add','-A'],{cwd:wt,timeout:30000});execFileSync('git',['commit','-m','fix: bosun PR repair (progressor)'],{cwd:wt,timeout:30000});} execFileSync('git',['push','--force-with-lease','origin',branch],{cwd:wt,encoding:'utf8',timeout:120000,stdio:'inherit'}); console.log(JSON.stringify({pushed:true,branch}));" - ], - "continueOnError": true, - "failOnError": false, - "timeoutMs": 300000, - "env": { - "WORKTREE_PATH": "{{setup-pr-worktree.output.worktreePath}}", - "PR_BRANCH": "{{setup-pr-worktree.output.branch}}" - } - }, - "position": { - "x": 220, - "y": 1020 - }, - "outputs": [ - "default" - ] - }, - { - "id": "cleanup-pr-worktree", - "type": "action.run_command", - "label": "Cleanup Temp Clone", - "config": { - "command": "node", - "args": [ - "-e", - "const fs=require('fs'); const wt=String(process.env.WORKTREE_PATH||'').trim(); if(wt&&fs.existsSync(wt)){try{fs.rmSync(wt,{recursive:true,force:true});console.log('cleaned up '+wt);}catch(e){console.warn('cleanup failed: '+e.message);}} else{console.log('nothing to clean');}" - ], - "continueOnError": true, - "failOnError": false, - "timeoutMs": 60000, - "env": { - "WORKTREE_PATH": "{{setup-pr-worktree.output.worktreePath}}" - } - }, - "position": { - "x": 220, - "y": 1060 + "y": 950 }, "outputs": [ "default" @@ -462,9 +360,9 @@ "sourcePort": "default" }, { - "id": "fix-agent-needed->setup-pr-worktree", + "id": "fix-agent-needed->dispatch-fix-agent", "source": "fix-agent-needed", - "target": "setup-pr-worktree", + "target": "dispatch-fix-agent", "sourcePort": "default", "condition": "$output?.result === true" }, @@ -476,32 +374,8 @@ "condition": "$output?.result !== true" }, { - "id": "setup-pr-worktree->set-pr-worktree-path", - "source": "setup-pr-worktree", - "target": "set-pr-worktree-path", - "sourcePort": "default" - }, - { - "id": "set-pr-worktree-path->dispatch-fix-agent", - "source": "set-pr-worktree-path", - "target": "dispatch-fix-agent", - "sourcePort": "default" - }, - { - "id": "dispatch-fix-agent->push-pr-fixes", + "id": "dispatch-fix-agent->notify-complete", "source": "dispatch-fix-agent", - "target": "push-pr-fixes", - "sourcePort": "default" - }, - { - "id": "push-pr-fixes->cleanup-pr-worktree", - "source": "push-pr-fixes", - "target": "cleanup-pr-worktree", - "sourcePort": "default" - }, - { - "id": "cleanup-pr-worktree->notify-complete", - "source": "cleanup-pr-worktree", "target": "notify-complete", "sourcePort": "default" }, @@ -556,8 +430,8 @@ "bosun-attached", "safety" ], - "nodeCount": 23, - "edgeCount": 32, + "nodeCount": 19, + "edgeCount": 26, "recommended": true, "enabled": true, "trigger": "trigger.schedule", @@ -567,21 +441,21 @@ "labelNeedsReview": "bosun-needs-human-review", "repoScope": "auto", "maxPrs": 25, - "intervalMs": 1800000, + "intervalMs": 90000, "suspiciousDeletionRatio": 3, "minDestructiveDeletions": 500, "autoApplySuggestions": true, "trustedAuthors": "", "allowTrustedFixes": false, "allowTrustedMerges": false, - "maxConcurrentFixes": 3, - "prFixTtlMinutes": 120 + "delegationWatchdogTimeoutMs": 300000, + "delegationWatchdogMaxRecoveries": 1 }, "metadata": { "author": "bosun", - "version": 5, + "version": 4, "createdAt": "2025-07-01T00:00:00Z", - "templateVersion": "3.0.0", + "templateVersion": "2.3.0", "tags": [ "github", "pr", @@ -597,7 +471,7 @@ "registerBuiltinHooks (PostPR block)" ], "calledFrom": [], - "description": "v3.0: Replaces single mega-agent dispatch with per-PR claim system and parallel fan-out. Each PR gets its own dedicated agent (template-pr-fix-single) with 2-hour budget. PR claims prevent duplicate work across watchdog cycles (TTL=prFixTtlMinutes). All per-PR agents are session-tracked in Fleet/Sessions. v2.3: Adds fast-path update-branch for out-of-date (BEHIND) PRs without conflicts. Consolidates PR polling into one gh pr list fetch per target repo per cycle. Uses deterministic-first remediation and review/merge command nodes; agent execution is now fallback-only for unresolved conflicts or failed automatic remediation attempts. All external PRs (no bosun-attached label) remain untouched." + "description": "v2.3: Adds fast-path update-branch for out-of-date (BEHIND) PRs without conflicts. Consolidates PR polling into one gh pr list fetch per target repo per cycle. Uses deterministic-first remediation and review/merge command nodes; agent execution is now fallback-only for unresolved conflicts or failed automatic remediation attempts. All external PRs (no bosun-attached label) remain untouched." } }, "nodes": [ @@ -624,7 +498,7 @@ "command": "node", "args": [ "-e", - "const fs=require('fs'); const path=require('path'); const {execFileSync}=require('child_process'); const LABEL_FIX='{{labelNeedsFix}}'; const MAX_PRS=Math.max(1,Number('{{maxPrs}}')||25); const REPO_SCOPE=String('{{repoScope}}'||'auto').trim(); const FIELDS='number,title,body,author,headRefName,baseRefName,isDraft,mergeable,statusCheckRollup,labels,url'; const FAIL_STATES=new Set(['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE']); const PEND_STATES=new Set(['PENDING','IN_PROGRESS','QUEUED','WAITING','REQUESTED','EXPECTED']); const CONFLICT_MERGEABLES=new Set(['CONFLICTING','DIRTY']); const BEHIND_MERGEABLES=new Set(['BEHIND']); const SECURITY_CHECK_RE=/(^|[^a-z])(codeql|code scanning|security|sarif|codacy)([^a-z]|$)/i; const BOSUN_CREATED_LABEL='bosun-pr-bosun-created'; function readCheckName(check){return String(check?.name||check?.context||check?.workflowName||check?.displayTitle||'').trim();} function isFailedCheck(check){return FAIL_STATES.has(check?.conclusion||check?.state||'');} function isSecurityCheckName(name){return SECURITY_CHECK_RE.test(String(name||''));} const GH_MAX_BUFFER=25*1024*1024;const GH_CACHE_TTL_MS=30000;const ghReadCache=new Map();let ghRateLimitUntil=0;function ghSleep(ms){if(!Number.isFinite(ms)||ms<=0)return;Atomics.wait(new Int32Array(new SharedArrayBuffer(4)),0,0,Math.min(ms,5000));}function ghCacheKey(args){return JSON.stringify(Array.isArray(args)?args:[]);}function isGhReadOnly(args){const list=Array.isArray(args)?args.map((item)=>String(item||'').trim().toLowerCase()):[];if(list.length===0)return false;const joined=' '+list.join(' ')+' ';return !/( edit | merge | close | reopen | rerun | delete | create | ready | cancel )/.test(joined);}function readGhMessage(error){return String(error?.stderr||error?.stdout||error?.message||error||'');}function runGh(args){const cacheable=isGhReadOnly(args);const key=cacheable?ghCacheKey(args):'';const now=Date.now();if(cacheable){const cached=ghReadCache.get(key);if(cached&&cached.expiresAt>now)return cached.output;if(nowString(entry||'').trim().toLowerCase()).filter(Boolean); return String(value||'').split(',').map((entry)=>entry.trim().toLowerCase()).filter(Boolean);} function parseBool(value,fallback){if(value===undefined||value===null||value==='') return fallback; const raw=String(value).trim().toLowerCase(); if(['1','true','yes','on'].includes(raw)) return true; if(['0','false','no','off'].includes(raw)) return false; return fallback;} function normalizeCheckKey(name){return String(name||'').trim().toLowerCase().replace(/\\s+/g,' ');} function matchesCheckPattern(name,pattern){const text=String(name||'').trim().toLowerCase();const token=String(pattern||'').trim().toLowerCase();if(!text||!token)return false;if(token==='*')return true;if(!token.includes('*'))return text.includes(token);const parts=token.split('*').filter(Boolean);if(parts.length===0)return true;let cursor=0;for(const part of parts){const idx=text.indexOf(part,cursor);if(idx===-1)return false;cursor=idx+part.length;}if(!token.startsWith('*')&&!text.startsWith(parts[0]||''))return false;if(!token.endsWith('*')&&!text.endsWith(parts[parts.length-1]||''))return false;return true;} function matchesAnyPattern(name,patterns){return (Array.isArray(patterns)?patterns:[]).some((pattern)=>matchesCheckPattern(name,pattern));} function readCheckState(check){return String(check?.conclusion||check?.state||check?.status||check?.bucket||'').trim().toUpperCase();} function isPassingCheckState(state,treatNeutralAsPass){if(!state)return true;if(['SUCCESS','PASS','PASSED','COMPLETED'].includes(state))return true;if(treatNeutralAsPass&&['NEUTRAL','SKIPPED'].includes(state))return true;return !FAIL_STATES.has(state)&&!PEND_STATES.has(state);} function evaluateCheckGates(checks,policy){const normalized=(Array.isArray(checks)?checks:[]).map((check)=>({raw:check,name:readCheckName(check),state:readCheckState(check)})).filter((check)=>check.name);const considered=normalized.filter((check)=>!matchesAnyPattern(check.name,policy.ignorePatterns));let required=considered;if(policy.mode==='required-only'){required=considered.filter((check)=>matchesAnyPattern(check.name,policy.requiredPatterns));}if((Array.isArray(policy.optionalPatterns)?policy.optionalPatterns:[]).length>0){required=required.filter((check)=>!matchesAnyPattern(check.name,policy.optionalPatterns));}const missingRequired=policy.requireAnyRequiredCheck&&required.length===0;const failedRequiredChecks=required.filter((check)=>FAIL_STATES.has(check.state));const pendingRequiredChecks=required.filter((check)=>PEND_STATES.has(check.state));const hasRequiredFailure=failedRequiredChecks.length>0;const hasBlockingPending=policy.treatPendingRequiredAsBlocking&&pendingRequiredChecks.length>0;const isReady=!missingRequired&&!hasRequiredFailure&&!hasBlockingPending&&required.every((check)=>isPassingCheckState(check.state,policy.treatNeutralAsPass));return {consideredCount:considered.length,requiredCount:required.length,failedRequiredChecks:failedRequiredChecks.map((check)=>check.raw),pendingRequiredChecks:pendingRequiredChecks.map((check)=>check.raw),hasRequiredFailure,hasBlockingPending,blocksForMissingRequired:missingRequired,isReady,shouldKickCi:considered.length===0};} function buildFailureFingerprint(names){const normalized=[...new Set((Array.isArray(names)?names:[]).map(normalizeCheckKey).filter(Boolean))].sort();return normalized.join('|');} function readLabelNames(pr){return Array.isArray(pr?.labels)?pr.labels.map((entry)=>typeof entry==='string'?entry:entry?.name).filter(Boolean):[];} function isBosunCreated(pr){return readLabelNames(pr).includes(BOSUN_CREATED_LABEL);} function readAuthorLogin(pr){return String(pr?.author?.login||pr?.author?.name||'').trim().toLowerCase();} function configPath(){ const home=String(process.env.BOSUN_HOME||process.env.BOSUN_PROJECT_DIR||'').trim(); return home?path.join(home,'bosun.config.json'):path.join(process.cwd(),'bosun.config.json'); } function readBosunConfig(){ try { return JSON.parse(fs.readFileSync(configPath(),'utf8')); } catch { return {}; } } function collectReposFromConfig(){ const repos=[]; try{ const cfg=readBosunConfig(); const workspaces=Array.isArray(cfg?.workspaces)?cfg.workspaces:[]; if(workspaces.length>0){ const active=String(cfg?.activeWorkspace||'').trim().toLowerCase(); const activeWs=active?workspaces.find(w=>String(w?.id||'').trim().toLowerCase()===active):null; const wsList=activeWs?[activeWs]:workspaces; for(const ws of wsList){ for(const repo of (Array.isArray(ws?.repos)?ws.repos:[])){ const slug=typeof repo==='string'?String(repo).trim():String(repo?.slug||'').trim(); if(slug) repos.push(slug); } } } if(repos.length===0){ for(const repo of (Array.isArray(cfg?.repos)?cfg.repos:[])){ const slug=typeof repo==='string'?String(repo).trim():String(repo?.slug||'').trim(); if(slug) repos.push(slug); } } }catch{} return repos; } function resolveRepoTargets(){ if(REPO_SCOPE&&REPO_SCOPE!=='auto'&&REPO_SCOPE!=='all'&&REPO_SCOPE!=='current'){ return [...new Set(REPO_SCOPE.split(',').map(v=>v.trim()).filter(Boolean))]; } if(REPO_SCOPE==='current') return ['']; const fromConfig=collectReposFromConfig(); if(fromConfig.length>0) return [...new Set(fromConfig)]; const envRepo=String(process.env.GITHUB_REPOSITORY||'').trim(); if(envRepo) return [envRepo]; return ['']; } const BOSUN_CONFIG=readBosunConfig(); const PR_AUTOMATION=(BOSUN_CONFIG&&typeof BOSUN_CONFIG.prAutomation==='object')?BOSUN_CONFIG.prAutomation:{}; const ATTACH_MODE=((String(PR_AUTOMATION?.attachMode||'all').trim().toLowerCase())||'all'); const TRUSTED_AUTHORS=new Set([...normalizeList(PR_AUTOMATION?.trustedAuthors),...normalizeList('{{trustedAuthors}}')]); const ALLOW_TRUSTED_FIXES=parseBool(PR_AUTOMATION?.allowTrustedFixes ?? '{{allowTrustedFixes}}', false); const ALLOW_TRUSTED_MERGES=parseBool(PR_AUTOMATION?.allowTrustedMerges ?? '{{allowTrustedMerges}}', false); const CHECK_GATES=(BOSUN_CONFIG&&typeof BOSUN_CONFIG.gates==='object'&&BOSUN_CONFIG.gates&&typeof BOSUN_CONFIG.gates.checks==='object')?BOSUN_CONFIG.gates.checks:{}; const CHECK_MODE=((String(CHECK_GATES?.mode||'all').trim().toLowerCase())||'all'); const REQUIRED_CHECK_PATTERNS=normalizeList(CHECK_GATES?.requiredPatterns); const OPTIONAL_CHECK_PATTERNS=normalizeList(CHECK_GATES?.optionalPatterns); const IGNORE_CHECK_PATTERNS=normalizeList(CHECK_GATES?.ignorePatterns); const REQUIRE_ANY_REQUIRED_CHECK=parseBool(CHECK_GATES?.requireAnyRequiredCheck, true); const TREAT_PENDING_REQUIRED_AS_BLOCKING=parseBool(CHECK_GATES?.treatPendingRequiredAsBlocking, true); const TREAT_NEUTRAL_AS_PASS=parseBool(CHECK_GATES?.treatNeutralAsPass, false); const defaultBranchFailureCache=new Map(); function collectDefaultBranchFailureNames(repo,baseBranch){const cacheKey=[repo,baseBranch].join('::');if(defaultBranchFailureCache.has(cacheKey))return defaultBranchFailureCache.get(cacheKey);const failedNames=new Set();try{const runs=safeGhJson(['run','list','--repo',repo,'--branch',baseBranch,'--json','databaseId,workflowName,displayTitle,conclusion,status','--limit','6'],[]);for(const run of (Array.isArray(runs)?runs:[])){const conclusion=String(run?.conclusion||'').trim().toUpperCase();if(!FAIL_STATES.has(conclusion))continue;const runId=Number(run?.databaseId||0)||0;if(runId>0){const view=safeGhJson(['run','view',String(runId),'--repo',repo,'--json','jobs'],{});const jobs=Array.isArray(view?.jobs)?view.jobs:[];for(const job of jobs){const jobState=String(job?.conclusion||job?.status||'').trim().toUpperCase();if(FAIL_STATES.has(jobState)){const normalized=normalizeCheckKey(job?.name);if(normalized)failedNames.add(normalized);}}}const workflowName=normalizeCheckKey(run?.workflowName||run?.displayTitle);if(workflowName)failedNames.add(workflowName);}}catch{}const resolved=[...failedNames];defaultBranchFailureCache.set(cacheKey,resolved);return resolved;} function parseRepoFromUrl(url){ const raw=String(url||''); const marker='github.com/'; const idx=raw.toLowerCase().indexOf(marker); if(idx<0) return ''; const tail=raw.slice(idx+marker.length).split('/'); if(tail.length<2) return ''; const owner=String(tail[0]||'').trim(); const repo=String(tail[1]||'').trim(); return owner&&repo?(owner+'/'+repo):''; } const repoTargets=resolveRepoTargets(); const prs=[]; const repoErrors=[]; for(const target of repoTargets){ const repo=String(target||'').trim(); const args=['pr','list','--state','open','--json',FIELDS,'--limit',String(MAX_PRS)]; if(repo) args.push('--repo',repo); try{ const list=ghJson(args); for(const pr of (Array.isArray(list)?list:[])){ const prRepo=repo||parseRepoFromUrl(pr?.url)||String(process.env.GITHUB_REPOSITORY||'').trim(); prs.push({...pr,__repo:prRepo}); } }catch(e){ repoErrors.push({repo:repo||'current',error:String(e?.message||e)}); } } const taskCli=path.join(process.cwd(),'task','task-cli.mjs'); const taskRunner=fs.existsSync(taskCli)?'direct':'cli'; const taskMaxBuffer=1024*1024*8; function parseJson(raw,fallback){try{return JSON.parse(raw||'')}catch{return fallback;}} function runTask(args){const cmdArgs=taskRunner==='cli'?['cli.mjs','task',...args,'--config-dir','.bosun','--repo-root','.']:[taskCli,...args];return execFileSync('node',cmdArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe'],maxBuffer:taskMaxBuffer}).trim();} let taskListCache=null; function loadTaskList(){if(taskListCache)return taskListCache;try{const raw=runTask(['list','--json']);const tasks=parseJson(raw,[]);taskListCache=Array.isArray(tasks)?tasks:[];}catch{taskListCache=[];}return taskListCache;} function normalizeTaskValue(value){return String(value||'').trim().toLowerCase();} function resolveTaskIdForPr(item){const prNumber=Number(item?.n||0)||0;const prUrl=normalizeTaskValue(item?.url);const branch=normalizeTaskValue(item?.branch);const matches=loadTaskList().filter((task)=>{if(!task||typeof task!=='object')return false;const taskPrNumber=Number(task?.prNumber||task?.pr_number||0)||0;if(prNumber>0&&taskPrNumber===prNumber)return true;const taskPrUrl=normalizeTaskValue(task?.prUrl||task?.pr_url);if(prUrl&&taskPrUrl===prUrl)return true;const taskBranch=normalizeTaskValue(task?.branchName||task?.branch||task?.meta?.branchName||task?.meta?.branch);return Boolean(branch&&taskBranch===branch);});if(matches.length===0)return null;const inReview=matches.find((task)=>normalizeTaskValue(task?.status)==='inreview');return String((inReview||matches[0])?.id||'').trim()||null;} function getTaskSnapshot(id){if(!id)return null;try{return parseJson(runTask(['get',id,'--json']),null);}catch{return null;}} function updateTaskReviewSignal(item){const taskId=resolveTaskIdForPr(item);if(!taskId)return false;const snapshot=getTaskSnapshot(taskId)||{};const existingMeta=snapshot?.meta&&typeof snapshot.meta==='object'?snapshot.meta:{};const existingReviewHealth=existingMeta.reviewHealth&&typeof existingMeta.reviewHealth==='object'?existingMeta.reviewHealth:{};const nextReviewHealth={...existingReviewHealth,status:String(item?.reviewStatus||'unknown'),failureScope:String(item?.failureScope||'none'),sharedIncidentId:item?.sharedIncidentId||null,failureFingerprint:item?.failureFingerprint||null,failingWorkflow:item?.failingWorkflow||null,failingJobs:Array.isArray(item?.failedCheckNames)?item.failedCheckNames:[],baseBranch:String(item?.base||snapshot?.baseBranch||'').trim()||null,repo:String(item?.repo||'').trim()||null,updatedAt:new Date().toISOString(),source:'pr-watchdog'};const patch={meta:{...existingMeta,reviewHealth:nextReviewHealth}};try{runTask(['update',taskId,JSON.stringify(patch)]);return true;}catch{return false;}} const sharedFailureFingerprints=new Map(); for(const pr of prs){const labels=(pr.labels||[]).map(l=>typeof l==='string'?l:l?.name).filter(Boolean);const bosunCreated=isBosunCreated(pr);const trustedAuthor=TRUSTED_AUTHORS.has(readAuthorLogin(pr));const attachEligible=bosunCreated||ATTACH_MODE==='all'||(ATTACH_MODE==='trusted-only'&&trustedAuthor);const checks=pr.statusCheckRollup||[];const gateVerdict=evaluateCheckGates(checks,{mode:CHECK_MODE,requiredPatterns:REQUIRED_CHECK_PATTERNS,optionalPatterns:OPTIONAL_CHECK_PATTERNS,ignorePatterns:IGNORE_CHECK_PATTERNS,requireAnyRequiredCheck:REQUIRE_ANY_REQUIRED_CHECK,treatPendingRequiredAsBlocking:TREAT_PENDING_REQUIRED_AS_BLOCKING,treatNeutralAsPass:TREAT_NEUTRAL_AS_PASS});const failedCheckNames=gateVerdict.failedRequiredChecks.map(readCheckName).filter(Boolean);const hasSecurityFail=failedCheckNames.some(isSecurityCheckName);const isConflict=CONFLICT_MERGEABLES.has(String(pr.mergeable||'').toUpperCase());const isDraft=pr.isDraft===true;const repo=String(pr.__repo||'').trim();const base=String(pr.baseRefName||'').trim()||'main';if(isDraft||!attachEligible||!gateVerdict.hasRequiredFailure||hasSecurityFail||isConflict)continue;const fingerprint=buildFailureFingerprint(failedCheckNames);if(!fingerprint)continue;const sharedKey=[repo,base,fingerprint].join('::');sharedFailureFingerprints.set(sharedKey,(sharedFailureFingerprints.get(sharedKey)||0)+1);} const readyCandidates=[],conflicts=[],securityFailures=[],ciFailures=[],sharedFailures=[],pending=[],drafted=[],behindBranches=[],skippedUntrusted=[]; let newlyLabeled=0,staleLabelCleared=0,ciKicked=0,taskReviewSignalsUpdated=0; for(const pr of prs){ const labels=(pr.labels||[]).map(l=>typeof l==='string'?l:l?.name).filter(Boolean); const bosunCreated=isBosunCreated(pr); const trustedAuthor=TRUSTED_AUTHORS.has(readAuthorLogin(pr)); const attachEligible=bosunCreated || ATTACH_MODE==='all' || (ATTACH_MODE==='trusted-only' && trustedAuthor); const canFix=bosunCreated || (attachEligible && ALLOW_TRUSTED_FIXES && trustedAuthor); const canMerge=bosunCreated || (attachEligible && ALLOW_TRUSTED_MERGES && trustedAuthor); const hasFixLabel=labels.includes(LABEL_FIX); const checks=pr.statusCheckRollup||[]; const gateVerdict=evaluateCheckGates(checks,{mode:CHECK_MODE,requiredPatterns:REQUIRED_CHECK_PATTERNS,optionalPatterns:OPTIONAL_CHECK_PATTERNS,ignorePatterns:IGNORE_CHECK_PATTERNS,requireAnyRequiredCheck:REQUIRE_ANY_REQUIRED_CHECK,treatPendingRequiredAsBlocking:TREAT_PENDING_REQUIRED_AS_BLOCKING,treatNeutralAsPass:TREAT_NEUTRAL_AS_PASS}); const failedChecks=gateVerdict.failedRequiredChecks; const failedCheckNames=failedChecks.map(readCheckName).filter(Boolean); const securityCheckNames=failedCheckNames.filter(isSecurityCheckName); const hasFail=gateVerdict.hasRequiredFailure; const hasSecurityFail=securityCheckNames.length>0; const hasPend=gateVerdict.hasBlockingPending; const isConflict=CONFLICT_MERGEABLES.has(String(pr.mergeable||'').toUpperCase()); const isBehind=BEHIND_MERGEABLES.has(String(pr.mergeable||'').toUpperCase()); const isDraft=pr.isDraft===true; const repo=String(pr.__repo||'').trim(); const base=String(pr.baseRefName||'').trim()||'main'; const failureFingerprint=buildFailureFingerprint(failedCheckNames); const sharedFailureKey=[repo,base,failureFingerprint].join('::'); const repeatedFailureCount=Number(sharedFailureFingerprints.get(sharedFailureKey)||0); const defaultBranchFailureNames=repo&&base?collectDefaultBranchFailureNames(repo,base):[]; const defaultBranchFailureSet=new Set((Array.isArray(defaultBranchFailureNames)?defaultBranchFailureNames:[]).map(normalizeCheckKey).filter(Boolean)); const allFailuresOnDefaultBranch=failedCheckNames.length>0&&failedCheckNames.every((name)=>defaultBranchFailureSet.has(normalizeCheckKey(name))); const isSharedFailure=hasFail&&!hasSecurityFail&&!isConflict&&(allFailuresOnDefaultBranch||repeatedFailureCount>=2); const sharedIncidentId=isSharedFailure&&failureFingerprint?[repo,base,failureFingerprint].join(':'):null; if(isDraft){drafted.push({n:pr.number,repo});continue;} if(!bosunCreated && !attachEligible){skippedUntrusted.push({n:pr.number,repo,reason:'attach_policy_excluded'});continue;} if(!bosunCreated && !trustedAuthor){skippedUntrusted.push({n:pr.number,repo,reason:'public_observation_only'});continue;} if(isBehind&&!isConflict){ if(canFix) behindBranches.push({n:pr.number,repo,branch:pr.headRefName,base:pr.baseRefName,url:pr.url}); } if(isConflict){ if(!canFix){skippedUntrusted.push({n:pr.number,repo,reason:'fix_not_allowed'});continue;} conflicts.push({n:pr.number,repo,branch:pr.headRefName,base:pr.baseRefName,url:pr.url,mergeable:String(pr.mergeable||'').toUpperCase()}); if(updateTaskReviewSignal({n:pr.number,repo,branch:pr.headRefName,base,url:pr.url,reviewStatus:'conflict',failureScope:'pr_local',failedCheckNames:[],failureFingerprint:null,failingWorkflow:null,sharedIncidentId:null}))taskReviewSignalsUpdated++; if(!hasFixLabel){ try{const editArgs=['pr','edit',String(pr.number),'--add-label',LABEL_FIX];if(repo)editArgs.push('--repo',repo);execFileSync('gh',editArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe']});newlyLabeled++;} catch(e){process.stderr.write('label err '+(repo?repo+' ':'')+'#'+pr.number+': '+(e?.message||e)+'\\\\n');} } } else if(hasSecurityFail){ if(!canFix){skippedUntrusted.push({n:pr.number,repo,reason:'security_fix_not_allowed'});continue;} securityFailures.push({n:pr.number,repo,branch:pr.headRefName,base:pr.baseRefName,url:pr.url,title:pr.title,failedCheckNames,securityCheckNames}); if(updateTaskReviewSignal({n:pr.number,repo,branch:pr.headRefName,base,url:pr.url,reviewStatus:'security_failure',failureScope:'pr_local',failedCheckNames,failureFingerprint,failingWorkflow:securityCheckNames[0]||failedCheckNames[0]||null,sharedIncidentId:null}))taskReviewSignalsUpdated++; if(!hasFixLabel){ try{const editArgs=['pr','edit',String(pr.number),'--add-label',LABEL_FIX];if(repo)editArgs.push('--repo',repo);execFileSync('gh',editArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe']});newlyLabeled++;} catch(e){process.stderr.write('label err '+(repo?repo+' ':'')+'#'+pr.number+': '+(e?.message||e)+'\\n');} } } else if(hasFail){ if(isSharedFailure){ sharedFailures.push({n:pr.number,repo,branch:pr.headRefName,base:pr.baseRefName,url:pr.url,title:pr.title,failedCheckNames,failureFingerprint,sharedIncidentId,defaultBranchFailureNames,repeatedFailureCount}); if(updateTaskReviewSignal({n:pr.number,repo,branch:pr.headRefName,base,url:pr.url,reviewStatus:'shared_ci_failure',failureScope:'shared',failedCheckNames,failureFingerprint,failingWorkflow:failedCheckNames[0]||null,sharedIncidentId}))taskReviewSignalsUpdated++; if(hasFixLabel){ try{const rmArgs=['pr','edit',String(pr.number),'--remove-label',LABEL_FIX];if(repo)rmArgs.push('--repo',repo);execFileSync('gh',rmArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe']});staleLabelCleared++;} catch(e){process.stderr.write('shared-label-rm err '+(repo?repo+' ':'')+'#'+pr.number+': '+(e?.message||e)+'\\n');} } continue; } if(!canFix){skippedUntrusted.push({n:pr.number,repo,reason:'ci_fix_not_allowed'});continue;} ciFailures.push({n:pr.number,repo,branch:pr.headRefName,url:pr.url,failedCheckNames}); if(updateTaskReviewSignal({n:pr.number,repo,branch:pr.headRefName,base,url:pr.url,reviewStatus:'ci_failure',failureScope:'pr_local',failedCheckNames,failureFingerprint,failingWorkflow:failedCheckNames[0]||null,sharedIncidentId:null}))taskReviewSignalsUpdated++; if(!hasFixLabel){ try{const editArgs=['pr','edit',String(pr.number),'--add-label',LABEL_FIX];if(repo)editArgs.push('--repo',repo);execFileSync('gh',editArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe']});newlyLabeled++;} catch(e){process.stderr.write('label err '+(repo?repo+' ':'')+'#'+pr.number+': '+(e?.message||e)+'\\\\n');} } } else { if(updateTaskReviewSignal({n:pr.number,repo,branch:pr.headRefName,base,url:pr.url,reviewStatus:hasPend?'pending':gateVerdict.isReady?'ready':'idle',failureScope:'none',failedCheckNames:[],failureFingerprint:null,failingWorkflow:null,sharedIncidentId:null}))taskReviewSignalsUpdated++; if(hasFixLabel&&!hasPend&&!gateVerdict.blocksForMissingRequired){ try{ const rmArgs=['pr','edit',String(pr.number),'--remove-label',LABEL_FIX]; if(repo)rmArgs.push('--repo',repo); execFileSync('gh',rmArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe']}); staleLabelCleared++; }catch(e){process.stderr.write('stale-label-rm err '+(repo?repo+' ':'')+'#'+pr.number+': '+(e?.message||e)+'\\\\n');} } else if(gateVerdict.isReady&&!hasFixLabel){ if(hasPend) pending.push({n:pr.number,repo}); if(canMerge){ readyCandidates.push({n:pr.number,repo,branch:pr.headRefName,base:pr.baseRefName,url:pr.url,title:pr.title,pendingChecks:hasPend}); } else { skippedUntrusted.push({n:pr.number,repo,reason:'merge_not_allowed'}); } } if(gateVerdict.shouldKickCi&&repo&&pr.headRefName&&!isDraft){ try{execFileSync('gh',['workflow','run','ci.yaml','--repo',repo,'--ref',pr.headRefName],{encoding:'utf8',stdio:['pipe','pipe','pipe']});ciKicked++;} catch{} } } } console.log(JSON.stringify({ total:prs.length, reposScanned:repoTargets.length, repoErrors, readyCandidates, conflicts, behindBranches, securityFailures, ciFailures, sharedFailures, pending:pending.length, drafted:drafted.length, skippedUntrusted, newlyLabeled, staleLabelCleared, ciKicked, fixNeeded:conflicts.length+securityFailures.length+ciFailures.length, sharedIncidentCount:sharedFailures.length, taskReviewSignalsUpdated, trustPolicy:{trustedAuthors:[...TRUSTED_AUTHORS],allowTrustedFixes:ALLOW_TRUSTED_FIXES,allowTrustedMerges:ALLOW_TRUSTED_MERGES} }));" + "const fs=require('fs'); const path=require('path'); const {execFileSync}=require('child_process'); const LABEL_FIX='{{labelNeedsFix}}'; const MAX_PRS=Math.max(1,Number('{{maxPrs}}')||25); const REPO_SCOPE=String('{{repoScope}}'||'auto').trim(); const FIELDS='number,title,body,author,headRefName,baseRefName,isDraft,mergeable,statusCheckRollup,labels,url'; const FAIL_STATES=new Set(['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE']); const PEND_STATES=new Set(['PENDING','IN_PROGRESS','QUEUED','WAITING','REQUESTED','EXPECTED']); const CONFLICT_MERGEABLES=new Set(['CONFLICTING','DIRTY']); const BEHIND_MERGEABLES=new Set(['BEHIND']); const SECURITY_CHECK_RE=/(^|[^a-z])(codeql|code scanning|security|sarif|codacy)([^a-z]|$)/i; const BOSUN_CREATED_LABEL='bosun-pr-bosun-created'; function readCheckName(check){return String(check?.name||check?.context||check?.workflowName||check?.displayTitle||'').trim();} function isFailedCheck(check){return FAIL_STATES.has(check?.conclusion||check?.state||'');} function isSecurityCheckName(name){return SECURITY_CHECK_RE.test(String(name||''));} function ghJson(args){const out=execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();return out?JSON.parse(out):[];} function runGh(args){return execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();} function safeGhJson(args,fallback){try{const out=runGh(args);return out?JSON.parse(out):fallback;}catch{return fallback;}} function normalizeList(value){if(Array.isArray(value)) return value.map((entry)=>String(entry||'').trim().toLowerCase()).filter(Boolean); return String(value||'').split(',').map((entry)=>entry.trim().toLowerCase()).filter(Boolean);} function parseBool(value,fallback){if(value===undefined||value===null||value==='') return fallback; const raw=String(value).trim().toLowerCase(); if(['1','true','yes','on'].includes(raw)) return true; if(['0','false','no','off'].includes(raw)) return false; return fallback;} function normalizeCheckKey(name){return String(name||'').trim().toLowerCase().replace(/\\s+/g,' ');} function matchesCheckPattern(name,pattern){const text=String(name||'').trim().toLowerCase();const token=String(pattern||'').trim().toLowerCase();if(!text||!token)return false;if(token==='*')return true;if(!token.includes('*'))return text.includes(token);const parts=token.split('*').filter(Boolean);if(parts.length===0)return true;let cursor=0;for(const part of parts){const idx=text.indexOf(part,cursor);if(idx===-1)return false;cursor=idx+part.length;}if(!token.startsWith('*')&&!text.startsWith(parts[0]||''))return false;if(!token.endsWith('*')&&!text.endsWith(parts[parts.length-1]||''))return false;return true;} function matchesAnyPattern(name,patterns){return (Array.isArray(patterns)?patterns:[]).some((pattern)=>matchesCheckPattern(name,pattern));} function readCheckState(check){return String(check?.conclusion||check?.state||check?.status||check?.bucket||'').trim().toUpperCase();} function isPassingCheckState(state,treatNeutralAsPass){if(!state)return true;if(['SUCCESS','PASS','PASSED','COMPLETED'].includes(state))return true;if(treatNeutralAsPass&&['NEUTRAL','SKIPPED'].includes(state))return true;return !FAIL_STATES.has(state)&&!PEND_STATES.has(state);} function evaluateCheckGates(checks,policy){const normalized=(Array.isArray(checks)?checks:[]).map((check)=>({raw:check,name:readCheckName(check),state:readCheckState(check)})).filter((check)=>check.name);const considered=normalized.filter((check)=>!matchesAnyPattern(check.name,policy.ignorePatterns));let required=considered;if(policy.mode==='required-only'){required=considered.filter((check)=>matchesAnyPattern(check.name,policy.requiredPatterns));}if((Array.isArray(policy.optionalPatterns)?policy.optionalPatterns:[]).length>0){required=required.filter((check)=>!matchesAnyPattern(check.name,policy.optionalPatterns));}const missingRequired=policy.requireAnyRequiredCheck&&required.length===0;const failedRequiredChecks=required.filter((check)=>FAIL_STATES.has(check.state));const pendingRequiredChecks=required.filter((check)=>PEND_STATES.has(check.state));const hasRequiredFailure=failedRequiredChecks.length>0;const hasBlockingPending=policy.treatPendingRequiredAsBlocking&&pendingRequiredChecks.length>0;const isReady=!missingRequired&&!hasRequiredFailure&&!hasBlockingPending&&required.every((check)=>isPassingCheckState(check.state,policy.treatNeutralAsPass));return {consideredCount:considered.length,requiredCount:required.length,failedRequiredChecks:failedRequiredChecks.map((check)=>check.raw),pendingRequiredChecks:pendingRequiredChecks.map((check)=>check.raw),hasRequiredFailure,hasBlockingPending,blocksForMissingRequired:missingRequired,isReady,shouldKickCi:considered.length===0};} function buildFailureFingerprint(names){const normalized=[...new Set((Array.isArray(names)?names:[]).map(normalizeCheckKey).filter(Boolean))].sort();return normalized.join('|');} function readLabelNames(pr){return Array.isArray(pr?.labels)?pr.labels.map((entry)=>typeof entry==='string'?entry:entry?.name).filter(Boolean):[];} function isBosunCreated(pr){return readLabelNames(pr).includes(BOSUN_CREATED_LABEL);} function readAuthorLogin(pr){return String(pr?.author?.login||pr?.author?.name||'').trim().toLowerCase();} function configPath(){ const home=String(process.env.BOSUN_HOME||process.env.BOSUN_PROJECT_DIR||'').trim(); return home?path.join(home,'bosun.config.json'):path.join(process.cwd(),'bosun.config.json'); } function readBosunConfig(){ try { return JSON.parse(fs.readFileSync(configPath(),'utf8')); } catch { return {}; } } function collectReposFromConfig(){ const repos=[]; try{ const cfg=readBosunConfig(); const workspaces=Array.isArray(cfg?.workspaces)?cfg.workspaces:[]; if(workspaces.length>0){ const active=String(cfg?.activeWorkspace||'').trim().toLowerCase(); const activeWs=active?workspaces.find(w=>String(w?.id||'').trim().toLowerCase()===active):null; const wsList=activeWs?[activeWs]:workspaces; for(const ws of wsList){ for(const repo of (Array.isArray(ws?.repos)?ws.repos:[])){ const slug=typeof repo==='string'?String(repo).trim():String(repo?.slug||'').trim(); if(slug) repos.push(slug); } } } if(repos.length===0){ for(const repo of (Array.isArray(cfg?.repos)?cfg.repos:[])){ const slug=typeof repo==='string'?String(repo).trim():String(repo?.slug||'').trim(); if(slug) repos.push(slug); } } }catch{} return repos; } function resolveRepoTargets(){ if(REPO_SCOPE&&REPO_SCOPE!=='auto'&&REPO_SCOPE!=='all'&&REPO_SCOPE!=='current'){ return [...new Set(REPO_SCOPE.split(',').map(v=>v.trim()).filter(Boolean))]; } if(REPO_SCOPE==='current') return ['']; const fromConfig=collectReposFromConfig(); if(fromConfig.length>0) return [...new Set(fromConfig)]; const envRepo=String(process.env.GITHUB_REPOSITORY||'').trim(); if(envRepo) return [envRepo]; return ['']; } const BOSUN_CONFIG=readBosunConfig(); const PR_AUTOMATION=(BOSUN_CONFIG&&typeof BOSUN_CONFIG.prAutomation==='object')?BOSUN_CONFIG.prAutomation:{}; const ATTACH_MODE=((String(PR_AUTOMATION?.attachMode||'all').trim().toLowerCase())||'all'); const TRUSTED_AUTHORS=new Set([...normalizeList(PR_AUTOMATION?.trustedAuthors),...normalizeList('{{trustedAuthors}}')]); const ALLOW_TRUSTED_FIXES=parseBool(PR_AUTOMATION?.allowTrustedFixes ?? '{{allowTrustedFixes}}', false); const ALLOW_TRUSTED_MERGES=parseBool(PR_AUTOMATION?.allowTrustedMerges ?? '{{allowTrustedMerges}}', false); const CHECK_GATES=(BOSUN_CONFIG&&typeof BOSUN_CONFIG.gates==='object'&&BOSUN_CONFIG.gates&&typeof BOSUN_CONFIG.gates.checks==='object')?BOSUN_CONFIG.gates.checks:{}; const CHECK_MODE=((String(CHECK_GATES?.mode||'all').trim().toLowerCase())||'all'); const REQUIRED_CHECK_PATTERNS=normalizeList(CHECK_GATES?.requiredPatterns); const OPTIONAL_CHECK_PATTERNS=normalizeList(CHECK_GATES?.optionalPatterns); const IGNORE_CHECK_PATTERNS=normalizeList(CHECK_GATES?.ignorePatterns); const REQUIRE_ANY_REQUIRED_CHECK=parseBool(CHECK_GATES?.requireAnyRequiredCheck, true); const TREAT_PENDING_REQUIRED_AS_BLOCKING=parseBool(CHECK_GATES?.treatPendingRequiredAsBlocking, true); const TREAT_NEUTRAL_AS_PASS=parseBool(CHECK_GATES?.treatNeutralAsPass, false); const defaultBranchFailureCache=new Map(); function collectDefaultBranchFailureNames(repo,baseBranch){const cacheKey=[repo,baseBranch].join('::');if(defaultBranchFailureCache.has(cacheKey))return defaultBranchFailureCache.get(cacheKey);const failedNames=new Set();try{const runs=safeGhJson(['run','list','--repo',repo,'--branch',baseBranch,'--json','databaseId,workflowName,displayTitle,conclusion,status','--limit','6'],[]);for(const run of (Array.isArray(runs)?runs:[])){const conclusion=String(run?.conclusion||'').trim().toUpperCase();if(!FAIL_STATES.has(conclusion))continue;const runId=Number(run?.databaseId||0)||0;if(runId>0){const view=safeGhJson(['run','view',String(runId),'--repo',repo,'--json','jobs'],{});const jobs=Array.isArray(view?.jobs)?view.jobs:[];for(const job of jobs){const jobState=String(job?.conclusion||job?.status||'').trim().toUpperCase();if(FAIL_STATES.has(jobState)){const normalized=normalizeCheckKey(job?.name);if(normalized)failedNames.add(normalized);}}}const workflowName=normalizeCheckKey(run?.workflowName||run?.displayTitle);if(workflowName)failedNames.add(workflowName);}}catch{}const resolved=[...failedNames];defaultBranchFailureCache.set(cacheKey,resolved);return resolved;} function parseRepoFromUrl(url){ const raw=String(url||''); const marker='github.com/'; const idx=raw.toLowerCase().indexOf(marker); if(idx<0) return ''; const tail=raw.slice(idx+marker.length).split('/'); if(tail.length<2) return ''; const owner=String(tail[0]||'').trim(); const repo=String(tail[1]||'').trim(); return owner&&repo?(owner+'/'+repo):''; } const repoTargets=resolveRepoTargets(); const prs=[]; const repoErrors=[]; for(const target of repoTargets){ const repo=String(target||'').trim(); const args=['pr','list','--state','open','--json',FIELDS,'--limit',String(MAX_PRS)]; if(repo) args.push('--repo',repo); try{ const list=ghJson(args); for(const pr of (Array.isArray(list)?list:[])){ const prRepo=repo||parseRepoFromUrl(pr?.url)||String(process.env.GITHUB_REPOSITORY||'').trim(); prs.push({...pr,__repo:prRepo}); } }catch(e){ repoErrors.push({repo:repo||'current',error:String(e?.message||e)}); } } const taskCli=path.join(process.cwd(),'task','task-cli.mjs'); const taskRunner=fs.existsSync(taskCli)?'direct':'cli'; const taskMaxBuffer=1024*1024*8; function parseJson(raw,fallback){try{return JSON.parse(raw||'')}catch{return fallback;}} function runTask(args){const cmdArgs=taskRunner==='cli'?['cli.mjs','task',...args,'--config-dir','.bosun','--repo-root','.']:[taskCli,...args];return execFileSync('node',cmdArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe'],maxBuffer:taskMaxBuffer}).trim();} let taskListCache=null; function loadTaskList(){if(taskListCache)return taskListCache;try{const raw=runTask(['list','--json']);const tasks=parseJson(raw,[]);taskListCache=Array.isArray(tasks)?tasks:[];}catch{taskListCache=[];}return taskListCache;} function normalizeTaskValue(value){return String(value||'').trim().toLowerCase();} function resolveTaskIdForPr(item){const prNumber=Number(item?.n||0)||0;const prUrl=normalizeTaskValue(item?.url);const branch=normalizeTaskValue(item?.branch);const matches=loadTaskList().filter((task)=>{if(!task||typeof task!=='object')return false;const taskPrNumber=Number(task?.prNumber||task?.pr_number||0)||0;if(prNumber>0&&taskPrNumber===prNumber)return true;const taskPrUrl=normalizeTaskValue(task?.prUrl||task?.pr_url);if(prUrl&&taskPrUrl===prUrl)return true;const taskBranch=normalizeTaskValue(task?.branchName||task?.branch||task?.meta?.branchName||task?.meta?.branch);return Boolean(branch&&taskBranch===branch);});if(matches.length===0)return null;const inReview=matches.find((task)=>normalizeTaskValue(task?.status)==='inreview');return String((inReview||matches[0])?.id||'').trim()||null;} function getTaskSnapshot(id){if(!id)return null;try{return parseJson(runTask(['get',id,'--json']),null);}catch{return null;}} function updateTaskReviewSignal(item){const taskId=resolveTaskIdForPr(item);if(!taskId)return false;const snapshot=getTaskSnapshot(taskId)||{};const existingMeta=snapshot?.meta&&typeof snapshot.meta==='object'?snapshot.meta:{};const existingReviewHealth=existingMeta.reviewHealth&&typeof existingMeta.reviewHealth==='object'?existingMeta.reviewHealth:{};const nextReviewHealth={...existingReviewHealth,status:String(item?.reviewStatus||'unknown'),failureScope:String(item?.failureScope||'none'),sharedIncidentId:item?.sharedIncidentId||null,failureFingerprint:item?.failureFingerprint||null,failingWorkflow:item?.failingWorkflow||null,failingJobs:Array.isArray(item?.failedCheckNames)?item.failedCheckNames:[],baseBranch:String(item?.base||snapshot?.baseBranch||'').trim()||null,repo:String(item?.repo||'').trim()||null,updatedAt:new Date().toISOString(),source:'pr-watchdog'};const patch={meta:{...existingMeta,reviewHealth:nextReviewHealth}};try{runTask(['update',taskId,JSON.stringify(patch)]);return true;}catch{return false;}} const sharedFailureFingerprints=new Map(); for(const pr of prs){const labels=(pr.labels||[]).map(l=>typeof l==='string'?l:l?.name).filter(Boolean);const bosunCreated=isBosunCreated(pr);const trustedAuthor=TRUSTED_AUTHORS.has(readAuthorLogin(pr));const attachEligible=bosunCreated||ATTACH_MODE==='all'||(ATTACH_MODE==='trusted-only'&&trustedAuthor);const checks=pr.statusCheckRollup||[];const gateVerdict=evaluateCheckGates(checks,{mode:CHECK_MODE,requiredPatterns:REQUIRED_CHECK_PATTERNS,optionalPatterns:OPTIONAL_CHECK_PATTERNS,ignorePatterns:IGNORE_CHECK_PATTERNS,requireAnyRequiredCheck:REQUIRE_ANY_REQUIRED_CHECK,treatPendingRequiredAsBlocking:TREAT_PENDING_REQUIRED_AS_BLOCKING,treatNeutralAsPass:TREAT_NEUTRAL_AS_PASS});const failedCheckNames=gateVerdict.failedRequiredChecks.map(readCheckName).filter(Boolean);const hasSecurityFail=failedCheckNames.some(isSecurityCheckName);const isConflict=CONFLICT_MERGEABLES.has(String(pr.mergeable||'').toUpperCase());const isDraft=pr.isDraft===true;const repo=String(pr.__repo||'').trim();const base=String(pr.baseRefName||'').trim()||'main';if(isDraft||!attachEligible||!gateVerdict.hasRequiredFailure||hasSecurityFail||isConflict)continue;const fingerprint=buildFailureFingerprint(failedCheckNames);if(!fingerprint)continue;const sharedKey=[repo,base,fingerprint].join('::');sharedFailureFingerprints.set(sharedKey,(sharedFailureFingerprints.get(sharedKey)||0)+1);} const readyCandidates=[],conflicts=[],securityFailures=[],ciFailures=[],sharedFailures=[],pending=[],drafted=[],behindBranches=[],skippedUntrusted=[]; let newlyLabeled=0,staleLabelCleared=0,ciKicked=0,taskReviewSignalsUpdated=0; for(const pr of prs){ const labels=(pr.labels||[]).map(l=>typeof l==='string'?l:l?.name).filter(Boolean); const bosunCreated=isBosunCreated(pr); const trustedAuthor=TRUSTED_AUTHORS.has(readAuthorLogin(pr)); const attachEligible=bosunCreated || ATTACH_MODE==='all' || (ATTACH_MODE==='trusted-only' && trustedAuthor); const canFix=bosunCreated || (attachEligible && ALLOW_TRUSTED_FIXES && trustedAuthor); const canMerge=bosunCreated || (attachEligible && ALLOW_TRUSTED_MERGES && trustedAuthor); const hasFixLabel=labels.includes(LABEL_FIX); const checks=pr.statusCheckRollup||[]; const gateVerdict=evaluateCheckGates(checks,{mode:CHECK_MODE,requiredPatterns:REQUIRED_CHECK_PATTERNS,optionalPatterns:OPTIONAL_CHECK_PATTERNS,ignorePatterns:IGNORE_CHECK_PATTERNS,requireAnyRequiredCheck:REQUIRE_ANY_REQUIRED_CHECK,treatPendingRequiredAsBlocking:TREAT_PENDING_REQUIRED_AS_BLOCKING,treatNeutralAsPass:TREAT_NEUTRAL_AS_PASS}); const failedChecks=gateVerdict.failedRequiredChecks; const failedCheckNames=failedChecks.map(readCheckName).filter(Boolean); const securityCheckNames=failedCheckNames.filter(isSecurityCheckName); const hasFail=gateVerdict.hasRequiredFailure; const hasSecurityFail=securityCheckNames.length>0; const hasPend=gateVerdict.hasBlockingPending; const isConflict=CONFLICT_MERGEABLES.has(String(pr.mergeable||'').toUpperCase()); const isBehind=BEHIND_MERGEABLES.has(String(pr.mergeable||'').toUpperCase()); const isDraft=pr.isDraft===true; const repo=String(pr.__repo||'').trim(); const base=String(pr.baseRefName||'').trim()||'main'; const failureFingerprint=buildFailureFingerprint(failedCheckNames); const sharedFailureKey=[repo,base,failureFingerprint].join('::'); const repeatedFailureCount=Number(sharedFailureFingerprints.get(sharedFailureKey)||0); const defaultBranchFailureNames=repo&&base?collectDefaultBranchFailureNames(repo,base):[]; const defaultBranchFailureSet=new Set((Array.isArray(defaultBranchFailureNames)?defaultBranchFailureNames:[]).map(normalizeCheckKey).filter(Boolean)); const allFailuresOnDefaultBranch=failedCheckNames.length>0&&failedCheckNames.every((name)=>defaultBranchFailureSet.has(normalizeCheckKey(name))); const isSharedFailure=hasFail&&!hasSecurityFail&&!isConflict&&(allFailuresOnDefaultBranch||repeatedFailureCount>=2); const sharedIncidentId=isSharedFailure&&failureFingerprint?[repo,base,failureFingerprint].join(':'):null; if(isDraft){drafted.push({n:pr.number,repo});continue;} if(!bosunCreated && !attachEligible){skippedUntrusted.push({n:pr.number,repo,reason:'attach_policy_excluded'});continue;} if(!bosunCreated && !trustedAuthor){skippedUntrusted.push({n:pr.number,repo,reason:'public_observation_only'});continue;} if(isBehind&&!isConflict){ if(canFix) behindBranches.push({n:pr.number,repo,branch:pr.headRefName,base:pr.baseRefName,url:pr.url}); } if(isConflict){ if(!canFix){skippedUntrusted.push({n:pr.number,repo,reason:'fix_not_allowed'});continue;} conflicts.push({n:pr.number,repo,branch:pr.headRefName,base:pr.baseRefName,url:pr.url,mergeable:String(pr.mergeable||'').toUpperCase()}); if(updateTaskReviewSignal({n:pr.number,repo,branch:pr.headRefName,base,url:pr.url,reviewStatus:'conflict',failureScope:'pr_local',failedCheckNames:[],failureFingerprint:null,failingWorkflow:null,sharedIncidentId:null}))taskReviewSignalsUpdated++; if(!hasFixLabel){ try{const editArgs=['pr','edit',String(pr.number),'--add-label',LABEL_FIX];if(repo)editArgs.push('--repo',repo);execFileSync('gh',editArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe']});newlyLabeled++;} catch(e){process.stderr.write('label err '+(repo?repo+' ':'')+'#'+pr.number+': '+(e?.message||e)+'\\\\n');} } } else if(hasSecurityFail){ if(!canFix){skippedUntrusted.push({n:pr.number,repo,reason:'security_fix_not_allowed'});continue;} securityFailures.push({n:pr.number,repo,branch:pr.headRefName,base:pr.baseRefName,url:pr.url,title:pr.title,failedCheckNames,securityCheckNames}); if(updateTaskReviewSignal({n:pr.number,repo,branch:pr.headRefName,base,url:pr.url,reviewStatus:'security_failure',failureScope:'pr_local',failedCheckNames,failureFingerprint,failingWorkflow:securityCheckNames[0]||failedCheckNames[0]||null,sharedIncidentId:null}))taskReviewSignalsUpdated++; if(!hasFixLabel){ try{const editArgs=['pr','edit',String(pr.number),'--add-label',LABEL_FIX];if(repo)editArgs.push('--repo',repo);execFileSync('gh',editArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe']});newlyLabeled++;} catch(e){process.stderr.write('label err '+(repo?repo+' ':'')+'#'+pr.number+': '+(e?.message||e)+'\\n');} } } else if(hasFail){ if(isSharedFailure){ sharedFailures.push({n:pr.number,repo,branch:pr.headRefName,base:pr.baseRefName,url:pr.url,title:pr.title,failedCheckNames,failureFingerprint,sharedIncidentId,defaultBranchFailureNames,repeatedFailureCount}); if(updateTaskReviewSignal({n:pr.number,repo,branch:pr.headRefName,base,url:pr.url,reviewStatus:'shared_ci_failure',failureScope:'shared',failedCheckNames,failureFingerprint,failingWorkflow:failedCheckNames[0]||null,sharedIncidentId}))taskReviewSignalsUpdated++; if(hasFixLabel){ try{const rmArgs=['pr','edit',String(pr.number),'--remove-label',LABEL_FIX];if(repo)rmArgs.push('--repo',repo);execFileSync('gh',rmArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe']});staleLabelCleared++;} catch(e){process.stderr.write('shared-label-rm err '+(repo?repo+' ':'')+'#'+pr.number+': '+(e?.message||e)+'\\n');} } continue; } if(!canFix){skippedUntrusted.push({n:pr.number,repo,reason:'ci_fix_not_allowed'});continue;} ciFailures.push({n:pr.number,repo,branch:pr.headRefName,url:pr.url,failedCheckNames}); if(updateTaskReviewSignal({n:pr.number,repo,branch:pr.headRefName,base,url:pr.url,reviewStatus:'ci_failure',failureScope:'pr_local',failedCheckNames,failureFingerprint,failingWorkflow:failedCheckNames[0]||null,sharedIncidentId:null}))taskReviewSignalsUpdated++; if(!hasFixLabel){ try{const editArgs=['pr','edit',String(pr.number),'--add-label',LABEL_FIX];if(repo)editArgs.push('--repo',repo);execFileSync('gh',editArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe']});newlyLabeled++;} catch(e){process.stderr.write('label err '+(repo?repo+' ':'')+'#'+pr.number+': '+(e?.message||e)+'\\\\n');} } } else { if(updateTaskReviewSignal({n:pr.number,repo,branch:pr.headRefName,base,url:pr.url,reviewStatus:hasPend?'pending':gateVerdict.isReady?'ready':'idle',failureScope:'none',failedCheckNames:[],failureFingerprint:null,failingWorkflow:null,sharedIncidentId:null}))taskReviewSignalsUpdated++; if(hasFixLabel&&!hasPend&&!gateVerdict.blocksForMissingRequired){ try{ const rmArgs=['pr','edit',String(pr.number),'--remove-label',LABEL_FIX]; if(repo)rmArgs.push('--repo',repo); execFileSync('gh',rmArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe']}); staleLabelCleared++; }catch(e){process.stderr.write('stale-label-rm err '+(repo?repo+' ':'')+'#'+pr.number+': '+(e?.message||e)+'\\\\n');} } else if(gateVerdict.isReady&&!hasFixLabel){ if(hasPend) pending.push({n:pr.number,repo}); if(canMerge){ readyCandidates.push({n:pr.number,repo,branch:pr.headRefName,base:pr.baseRefName,url:pr.url,title:pr.title,pendingChecks:hasPend}); } else { skippedUntrusted.push({n:pr.number,repo,reason:'merge_not_allowed'}); } } if(gateVerdict.shouldKickCi&&repo&&pr.headRefName&&!isDraft){ try{execFileSync('gh',['workflow','run','ci.yaml','--repo',repo,'--ref',pr.headRefName],{encoding:'utf8',stdio:['pipe','pipe','pipe']});ciKicked++;} catch{} } } } console.log(JSON.stringify({ total:prs.length, reposScanned:repoTargets.length, repoErrors, readyCandidates, conflicts, behindBranches, securityFailures, ciFailures, sharedFailures, pending:pending.length, drafted:drafted.length, skippedUntrusted, newlyLabeled, staleLabelCleared, ciKicked, fixNeeded:conflicts.length+securityFailures.length+ciFailures.length, sharedIncidentCount:sharedFailures.length, taskReviewSignalsUpdated, trustPolicy:{trustedAuthors:[...TRUSTED_AUTHORS],allowTrustedFixes:ALLOW_TRUSTED_FIXES,allowTrustedMerges:ALLOW_TRUSTED_MERGES} }));" ], "continueOnError": false, "failOnError": true @@ -758,58 +632,22 @@ ] }, { - "id": "claim-unclaimed-security-prs", - "type": "action.run_command", - "label": "Claim Unclaimed Security PRs", - "config": { - "command": "node", - "args": [ - "-e", - "const fs=require('fs'); const path=require('path'); const raw=String(process.env.BOSUN_SECURITY_FIX||''); const payload=(()=>{try{return JSON.parse(raw||'{}')}catch{return {}}})(); const needsAgent=Array.isArray(payload.needsAgent)?payload.needsAgent:[]; const TTL_MINUTES=Math.max(5,Number(process.env.PR_FIX_TTL_MINUTES||120)); const TTL_MS=TTL_MINUTES*60*1000; const CLAIM_FILE=path.join(process.cwd(),'.cache','bosun','pr-security-fix-claims.json'); const now=Date.now(); let data={claims:{},updatedAt:new Date().toISOString()}; try{fs.mkdirSync(path.dirname(CLAIM_FILE),{recursive:true});}catch{} try{if(fs.existsSync(CLAIM_FILE))data=JSON.parse(fs.readFileSync(CLAIM_FILE,'utf8'));}catch{} if(!data.claims)data.claims={}; for(const[key,claim]of Object.entries(data.claims)){if(now-new Date(claim.claimedAt).getTime()>TTL_MS)delete data.claims[key];} const unclaimed=[]; const alreadyClaimed=[]; for(const item of needsAgent){ const key=String(item.repo||'')+'/'+String(item.number||''); if(!key||key==='/'){continue;} if(data.claims[key]){alreadyClaimed.push({key,...item});continue;} data.claims[key]={claimedAt:new Date().toISOString(),repo:item.repo,number:item.number}; unclaimed.push({...item,claimKey:key,taskId:'pr-secfix-'+String(item.repo||'').replace(/[^a-z0-9]/gi,'-')+'-'+String(item.number||'')}); } data.updatedAt=new Date().toISOString(); try{fs.writeFileSync(CLAIM_FILE,JSON.stringify(data,null,2),'utf8');}catch{} console.log(JSON.stringify({unclaimedCount:unclaimed.length,alreadyClaimedCount:alreadyClaimed.length,unclaimed,alreadyClaimed}));" - ], - "continueOnError": true, - "failOnError": false, - "env": { - "BOSUN_SECURITY_FIX": "{{$ctx.getNodeOutput('programmatic-security-fix')?.output || '{}'}}", - "PR_FIX_TTL_MINUTES": "{{prFixTtlMinutes}}" - } - }, - "position": { - "x": 120, - "y": 920 - }, - "outputs": [ - "default" - ] - }, - { - "id": "has-unclaimed-security-fixes", - "type": "condition.expression", - "label": "Unclaimed Security Fixes?", - "config": { - "expression": "(()=>{try{const o=$ctx.getNodeOutput('claim-unclaimed-security-prs');const d=typeof o?.output==='object'?o.output:JSON.parse(o?.output||'{}');return (Array.isArray(d.unclaimed)?d.unclaimed:[]).length>0;}catch(e){return false;}})()" - }, - "position": { - "x": 120, - "y": 1010 - }, - "outputs": [ - "default" - ] - }, - { - "id": "dispatch-security-fix-agents", - "type": "loop.for_each", - "label": "Dispatch Security Fix Agents (Per PR)", + "id": "dispatch-security-fix-agent", + "type": "action.run_agent", + "label": "Dispatch Security Fix Agent", "config": { - "items": "(()=>{try{const o=$ctx.getNodeOutput('claim-unclaimed-security-prs');const d=typeof o?.output==='object'?o.output:JSON.parse(o?.output||'{}');return Array.isArray(d.unclaimed)?d.unclaimed:[];}catch{return []}})();", - "variable": "item", - "maxConcurrent": "{{maxConcurrentFixes}}", - "workflowId": "template-pr-security-fix-single" + "prompt": "You are a Bosun PR security remediation agent. Work only the PRs in this JSON:\n\n{{$ctx.getNodeOutput('programmatic-security-fix')?.output}}\n\nEach item represents a Bosun-created or explicitly trusted PR blocked by CodeQL or GitHub code scanning.\nUse the supplied alert data, prDigest.body, prDigest.files, prDigest.issueComments, prDigest.reviews, prDigest.reviewComments, and prDigest.checks to make the smallest safe code change that resolves the finding.\nFor each repaired PR: check out the branch, fix only the reported code-scanning issue, run targeted validation, push the branch, and remove bosun-needs-fix after success.\n\nSTRICT RULES:\n- Only fix the listed code-scanning or CodeQL findings.\n- No unrelated refactors, dependency churn, merges, approvals, or PR closure.\n- If alert fetch failed, inspect the PR checks and relevant source to resolve the security failure directly.\n- Do NOT touch PRs that are not Bosun-created or explicitly trusted by config.", + "sdk": "auto", + "timeoutMs": 1800000, + "delegationWatchdogTimeoutMs": "{{delegationWatchdogTimeoutMs}}", + "delegationWatchdogMaxRecoveries": "{{delegationWatchdogMaxRecoveries}}", + "maxRetries": 2, + "retryDelayMs": 30000, + "continueOnError": true }, "position": { "x": 120, - "y": 1100 + "y": 970 }, "outputs": [ "default" @@ -838,7 +676,7 @@ "command": "node", "args": [ "-e", - "const {execFileSync}=require('child_process'); const raw=String(process.env.BOSUN_FETCH_AND_CLASSIFY||''); const payload=(()=>{try{return JSON.parse(raw||'{}')}catch{return {}}})(); const ciFailures=Array.isArray(payload.ciFailures)?payload.ciFailures:[]; const conflicts=Array.isArray(payload.conflicts)?payload.conflicts:[]; const needsAgent=[]; let rerunRequested=0; const FAIL_STATES=new Set(['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE']); const MAX_AUTO_RERUN_ATTEMPT=1; const GH_MAX_BUFFER=25*1024*1024;const GH_CACHE_TTL_MS=30000;const ghReadCache=new Map();let ghRateLimitUntil=0;function ghSleep(ms){if(!Number.isFinite(ms)||ms<=0)return;Atomics.wait(new Int32Array(new SharedArrayBuffer(4)),0,0,Math.min(ms,5000));}function ghCacheKey(args){return JSON.stringify(Array.isArray(args)?args:[]);}function isGhReadOnly(args){const list=Array.isArray(args)?args.map((item)=>String(item||'').trim().toLowerCase()):[];if(list.length===0)return false;const joined=' '+list.join(' ')+' ';return !/( edit | merge | close | reopen | rerun | delete | create | ready | cancel )/.test(joined);}function readGhMessage(error){return String(error?.stderr||error?.stdout||error?.message||error||'');}function runGh(args){const cacheable=isGhReadOnly(args);const key=cacheable?ghCacheKey(args):'';const now=Date.now();if(cacheable){const cached=ghReadCache.get(key);if(cached&&cached.expiresAt>now)return cached.output;if(nowFAIL_STATES.has(String(step?.conclusion||step?.status||'').toUpperCase())).map((step)=>({name:String(step?.name||''),number:Number(step?.number||0)||null,status:String(step?.status||''),conclusion:String(step?.conclusion||'')})).filter((step)=>step.name).slice(0,10)}} function truncateText(value,max){const text=String(value||'').replace(/\\r/g,'').trim();if(!text)return '';return text.length>max?text.slice(0,Math.max(0,max-19))+'\\n...[truncated]':text;} function compactUser(user){const login=String(user?.login||user?.name||'').trim();return login?{login,url:String(user?.url||user?.html_url||'').trim()||null}:null;} function compactCheck(check){const name=String(check?.name||check?.context||check?.workflowName||'').trim();const state=String(check?.state||check?.conclusion||'').toUpperCase();const bucket=String(check?.bucket||'').toUpperCase();if(!name&&!state&&!bucket)return null;return {name:name||null,state:state||null,bucket:bucket||null,workflow:String(check?.workflowName||'').trim()||null};} function compactIssueComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactReview(review){return {id:Number(review?.id||0)||null,author:compactUser(review?.user||review?.author),state:String(review?.state||'').trim()||null,submittedAt:String(review?.submitted_at||review?.submittedAt||'').trim()||null,body:truncateText(review?.body,1200)};} function compactReviewComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),path:String(comment?.path||'').trim()||null,line:Number(comment?.line||0)||Number(comment?.original_line||0)||null,side:String(comment?.side||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactFile(file){const path=String(file?.filename||file?.path||'').trim();return path?{path,status:String(file?.status||'').trim()||null,additions:Number(file?.additions||0)||0,deletions:Number(file?.deletions||0)||0,changes:Number(file?.changes||0)||0}:null;} function collectPrDigest(repo,number,fallback){const pr=safeGhJson(['pr','view',String(number),'--repo',repo,'--json','number,title,body,url,headRefName,baseRefName,isDraft,mergeable,statusCheckRollup,author,labels,reviewDecision'],{});const issueComments=safeGhJson(['api','repos/'+repo+'/issues/'+number+'/comments?per_page=100'],[]).map(compactIssueComment).slice(0,40);const reviews=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/reviews?per_page=100'],[]).map(compactReview).slice(0,40);const reviewComments=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/comments?per_page=100'],[]).map(compactReviewComment).slice(0,60);const files=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/files?per_page=100'],[]).map(compactFile).filter(Boolean).slice(0,80);const requested=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/requested_reviewers'],{});const requestedReviewers=[...(Array.isArray(requested?.users)?requested.users:[]).map(compactUser),...(Array.isArray(requested?.teams)?requested.teams:[]).map((team)=>{const slug=String(team?.slug||team?.name||'').trim();return slug?{team:slug,url:String(team?.html_url||team?.url||'').trim()||null}:null;})].filter(Boolean);const checks=(Array.isArray(pr.statusCheckRollup)?pr.statusCheckRollup:[]).map(compactCheck).filter(Boolean);const failingChecks=checks.filter((check)=>['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE'].includes(check.state)||check.bucket==='FAIL');const pendingChecks=checks.filter((check)=>['QUEUED','IN_PROGRESS','PENDING','WAITING','REQUESTED'].includes(check.state));const labels=(Array.isArray(pr.labels)?pr.labels:[]).map((label)=>String(label?.name||label||'').trim()).filter(Boolean);const digestSummary=['PR #'+String(pr?.number||number)+' '+String(pr?.title||fallback?.title||''),'repo='+repo+' branch='+(String(pr?.headRefName||fallback?.branch||'').trim()||'unknown'),'checks='+checks.length+' fail='+failingChecks.length+' pending='+pendingChecks.length,'comments='+issueComments.length+' reviews='+reviews.length+' reviewComments='+reviewComments.length+' files='+files.length,labels.length?'labels='+labels.join(', '):''].filter(Boolean).join('\\n');return {core:{number:Number(pr?.number||number)||number,title:String(pr?.title||fallback?.title||''),url:String(pr?.url||fallback?.url||'').trim()||null,body:truncateText(pr?.body,4000),branch:String(pr?.headRefName||fallback?.branch||'').trim()||null,baseBranch:String(pr?.baseRefName||fallback?.base||'').trim()||null,isDraft:pr?.isDraft===true,mergeable:String(pr?.mergeable||'').trim()||null,author:compactUser(pr?.author),reviewDecision:String(pr?.reviewDecision||'').trim()||null},labels,requestedReviewers,checks,ciSummary:{total:checks.length,failing:failingChecks.length,pending:pendingChecks.length,passing:Math.max(0,checks.length-failingChecks.length-pendingChecks.length)},issueComments,reviews,reviewComments,files,digestSummary};} const CI_LOG_EXCERPT_MAX_CHARS=12000;const CI_MAX_JOB_DIAGNOSTICS=10;const CI_MAX_ANNOTATIONS=60;function safeGhJsonRunner(runner,args,fallback){try{const out=runner(args);return out?JSON.parse(out):fallback;}catch{return fallback;}}function parseCheckRunId(value){const match=String(value||'').match(/\\/check-runs\\/(\\d+)/i);return match?Number(match[1]||0)||0:0;}function normalizeAnnotation(annotation){if(!annotation||typeof annotation!=='object')return null;const path=String(annotation.path||'').trim();const message=truncateText(annotation.message,1200);if(!path&&!message)return null;return {path:path||null,startLine:Number(annotation.start_line||0)||null,endLine:Number(annotation.end_line||0)||null,startColumn:Number(annotation.start_column||0)||null,endColumn:Number(annotation.end_column||0)||null,level:String(annotation.annotation_level||'').trim()||null,title:truncateText(annotation.title,300)||null,message,rawDetails:truncateText(annotation.raw_details,800)||null};}function collectCheckRunAnnotations(repo,checkRunId,runner){if(!repo||!checkRunId)return [];const annotations=[];for(let page=1;page<=3&&annotations.length=CI_MAX_ANNOTATIONS)break;}if(batch.length<50)break;}return annotations.slice(0,CI_MAX_ANNOTATIONS);}function collectCiDiagnostics(repo,run,runner){const info={failedRun:normalizeRun(run),failedJobs:[],failedAnnotations:[],failedLogExcerpt:'',diagnosticsError:''};const runId=Number(run?.databaseId||0)||0;if(!runId||!repo)return info;let workflowJobs=[];try{const viewRaw=runner(['run','view',String(runId),'--repo',repo,'--json','attempt,conclusion,status,workflowName,displayTitle,url,createdAt,updatedAt,jobs']);const view=(()=>{try{return JSON.parse(viewRaw||'{}')}catch{return {}}})();info.failedRun=normalizeRun({...run,...view});const apiJobs=safeGhJsonRunner(runner,['api','repos/'+repo+'/actions/runs/'+runId+'/jobs?per_page=100'],{});workflowJobs=Array.isArray(apiJobs?.jobs)?apiJobs.jobs:(Array.isArray(view.jobs)?view.jobs:[]);info.failedJobs=workflowJobs.map(normalizeJob).filter((job)=>job&&(FAIL_STATES.has(String(job.conclusion||'').toUpperCase())||job.failedSteps.length>0)).slice(0,CI_MAX_JOB_DIAGNOSTICS);}catch(e){info.diagnosticsError=String(e?.message||e);}try{for(const job of info.failedJobs){const checkRunId=parseCheckRunId(job?.checkRunUrl);const annotations=collectCheckRunAnnotations(repo,checkRunId,runner);if(annotations.length===0)continue;info.failedAnnotations.push({name:String(job?.name||''),checkRunId,annotations});if(info.failedAnnotations.length>=CI_MAX_JOB_DIAGNOSTICS)break;}}catch(e){const message=String(e?.message||e);if(message&&message!==info.diagnosticsError){info.diagnosticsError=info.diagnosticsError?info.diagnosticsError+' | '+message:message;}}try{info.failedLogExcerpt=truncateText(runner(['run','view',String(runId),'--repo',repo,'--log-failed']),CI_LOG_EXCERPT_MAX_CHARS);}catch(e){const message=String(e?.message||e);if(message&&message!==info.diagnosticsError){info.diagnosticsError=info.diagnosticsError?info.diagnosticsError+' | '+message:message;}}return info;} for(const item of ciFailures){ const repo=String(item?.repo||'').trim(); const branch=String(item?.branch||'').trim(); const n=String(item?.n||'').trim(); const failedCheckNames=Array.isArray(item?.failedCheckNames)?item.failedCheckNames:[]; const url=String(item?.url||'').trim(); const title=String(item?.title||'').trim(); const prDigest=repo&&n?collectPrDigest(repo,n,{branch,title,url}):null; if(!repo||!branch){needsAgent.push({repo,number:n,branch,url,title,failedCheckNames,reason:'missing_repo_or_branch',prDigest,digestSummary:String(prDigest?.digestSummary||'')});continue;} let runs=[]; try{ const listRaw=runGh(['run','list','--repo',repo,'--branch',branch,'--json','databaseId,attempt,conclusion,status,workflowName,displayTitle,url,createdAt,updatedAt','--limit','8']); const parsedRuns=(()=>{try{return JSON.parse(listRaw||'[]')}catch{return []}})(); runs=Array.isArray(parsedRuns)?parsedRuns:[]; }catch(e){needsAgent.push({repo,number:n,branch,url,title,failedCheckNames,reason:'ci_run_listing_failed',error:String(e?.message||e),prDigest,digestSummary:String(prDigest?.digestSummary||'')});continue;} const failed=runs.find((r)=>FAIL_STATES.has(String(r?.conclusion||'').toUpperCase())); const failedRun=normalizeRun(failed); if(failedRun?.databaseId&&failedRun.attempt<=MAX_AUTO_RERUN_ATTEMPT){ try{runGh(['run','rerun',String(failedRun.databaseId),'--repo',repo]);rerunRequested++;continue;} catch(e){needsAgent.push({repo,number:n,branch,url,title,failedCheckNames,reason:'ci_rerun_failed',error:String(e?.message||e),prDigest,digestSummary:String(prDigest?.digestSummary||''),...collectCiDiagnostics(repo,failedRun,runGh)});continue;} } if(failedRun?.databaseId){needsAgent.push({repo,number:n,branch,url,title,failedCheckNames,reason:'auto_rerun_limit_reached',rerunAttempts:failedRun.attempt||0,prDigest,digestSummary:String(prDigest?.digestSummary||''),...collectCiDiagnostics(repo,failedRun,runGh)});continue;} needsAgent.push({repo,number:n,branch,url,title,failedCheckNames,reason:'no_rerunnable_failed_run_found',recentRuns:runs.map(normalizeRun).filter(Boolean).slice(0,5),prDigest,digestSummary:String(prDigest?.digestSummary||'')}); } let branchUpdated=0; for(const item of conflicts){ const repo=String(item?.repo||'').trim(); const n=String(item?.n||'').trim(); const branch=String(item?.branch||'').trim(); const base=String(item?.base||'').trim(); const mergeable=String(item?.mergeable||'').toUpperCase(); const prDigest=repo&&n?collectPrDigest(repo,n,{branch,base,url:String(item?.url||'')}):null; if(!repo||!n){needsAgent.push({...item,reason:'missing_repo_or_pr',prDigest,digestSummary:String(prDigest?.digestSummary||'')});continue;} if(mergeable==='BEHIND'){ try{ const headSha=JSON.parse(runGh(['pr','view',n,'--repo',repo,'--json','headRefOid'])).headRefOid; const apiArgs=['api','-X','PUT','repos/'+repo+'/pulls/'+n+'/update-branch','--field','expected_head_sha='+headSha]; runGh(apiArgs); branchUpdated++; }catch(e){needsAgent.push({repo,number:n,branch,base,mergeable,reason:'branch_update_failed',error:String(e?.message||e),prDigest,digestSummary:String(prDigest?.digestSummary||'')});} continue; } needsAgent.push({repo,number:n,branch,base,mergeable,reason:'merge_conflict_requires_code_resolution',prDigest,digestSummary:String(prDigest?.digestSummary||'')}); } console.log(JSON.stringify({rerunRequested,branchUpdated,ciFailureCount:ciFailures.length,conflictCount:conflicts.length,needsAgentCount:needsAgent.length,needsAgent}));" + "const {execFileSync}=require('child_process'); const raw=String(process.env.BOSUN_FETCH_AND_CLASSIFY||''); const payload=(()=>{try{return JSON.parse(raw||'{}')}catch{return {}}})(); const ciFailures=Array.isArray(payload.ciFailures)?payload.ciFailures:[]; const conflicts=Array.isArray(payload.conflicts)?payload.conflicts:[]; const needsAgent=[]; let rerunRequested=0; const FAIL_STATES=new Set(['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE']); const MAX_AUTO_RERUN_ATTEMPT=1; function runGh(args){return execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();} function safeGhJson(args,fallback){try{const out=runGh(args);return out?JSON.parse(out):fallback;}catch{return fallback;}} function normalizeRun(run){if(!run||typeof run!=='object')return null;return {databaseId:Number(run.databaseId||0)||null,attempt:Number(run.attempt||0)||0,conclusion:String(run.conclusion||''),status:String(run.status||''),workflowName:String(run.workflowName||run.name||''),displayTitle:String(run.displayTitle||run.name||''),url:String(run.url||''),createdAt:String(run.createdAt||''),updatedAt:String(run.updatedAt||'')}} function normalizeJob(job){if(!job||typeof job!=='object')return null;const steps=Array.isArray(job.steps)?job.steps:[];return {databaseId:Number(job.databaseId||job.id||0)||null,name:String(job.name||''),status:String(job.status||''),conclusion:String(job.conclusion||''),url:String(job.url||job.html_url||''),checkRunUrl:String(job.check_run_url||job.checkRunUrl||''),failedSteps:steps.filter((step)=>FAIL_STATES.has(String(step?.conclusion||step?.status||'').toUpperCase())).map((step)=>({name:String(step?.name||''),number:Number(step?.number||0)||null,status:String(step?.status||''),conclusion:String(step?.conclusion||'')})).filter((step)=>step.name).slice(0,10)}} function truncateText(value,max){const text=String(value||'').replace(/\\r/g,'').trim();if(!text)return '';return text.length>max?text.slice(0,Math.max(0,max-19))+'\\n...[truncated]':text;} function compactUser(user){const login=String(user?.login||user?.name||'').trim();return login?{login,url:String(user?.url||user?.html_url||'').trim()||null}:null;} function compactCheck(check){const name=String(check?.name||check?.context||check?.workflowName||'').trim();const state=String(check?.state||check?.conclusion||'').toUpperCase();const bucket=String(check?.bucket||'').toUpperCase();if(!name&&!state&&!bucket)return null;return {name:name||null,state:state||null,bucket:bucket||null,workflow:String(check?.workflowName||'').trim()||null};} function compactIssueComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactReview(review){return {id:Number(review?.id||0)||null,author:compactUser(review?.user||review?.author),state:String(review?.state||'').trim()||null,submittedAt:String(review?.submitted_at||review?.submittedAt||'').trim()||null,body:truncateText(review?.body,1200)};} function compactReviewComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),path:String(comment?.path||'').trim()||null,line:Number(comment?.line||0)||Number(comment?.original_line||0)||null,side:String(comment?.side||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactFile(file){const path=String(file?.filename||file?.path||'').trim();return path?{path,status:String(file?.status||'').trim()||null,additions:Number(file?.additions||0)||0,deletions:Number(file?.deletions||0)||0,changes:Number(file?.changes||0)||0}:null;} function collectPrDigest(repo,number,fallback){const pr=safeGhJson(['pr','view',String(number),'--repo',repo,'--json','number,title,body,url,headRefName,baseRefName,isDraft,mergeable,statusCheckRollup,author,labels,reviewDecision'],{});const issueComments=safeGhJson(['api','repos/'+repo+'/issues/'+number+'/comments?per_page=100'],[]).map(compactIssueComment).slice(0,40);const reviews=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/reviews?per_page=100'],[]).map(compactReview).slice(0,40);const reviewComments=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/comments?per_page=100'],[]).map(compactReviewComment).slice(0,60);const files=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/files?per_page=100'],[]).map(compactFile).filter(Boolean).slice(0,80);const requested=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/requested_reviewers'],{});const requestedReviewers=[...(Array.isArray(requested?.users)?requested.users:[]).map(compactUser),...(Array.isArray(requested?.teams)?requested.teams:[]).map((team)=>{const slug=String(team?.slug||team?.name||'').trim();return slug?{team:slug,url:String(team?.html_url||team?.url||'').trim()||null}:null;})].filter(Boolean);const checks=(Array.isArray(pr.statusCheckRollup)?pr.statusCheckRollup:[]).map(compactCheck).filter(Boolean);const failingChecks=checks.filter((check)=>['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE'].includes(check.state)||check.bucket==='FAIL');const pendingChecks=checks.filter((check)=>['QUEUED','IN_PROGRESS','PENDING','WAITING','REQUESTED'].includes(check.state));const labels=(Array.isArray(pr.labels)?pr.labels:[]).map((label)=>String(label?.name||label||'').trim()).filter(Boolean);const digestSummary=['PR #'+String(pr?.number||number)+' '+String(pr?.title||fallback?.title||''),'repo='+repo+' branch='+(String(pr?.headRefName||fallback?.branch||'').trim()||'unknown'),'checks='+checks.length+' fail='+failingChecks.length+' pending='+pendingChecks.length,'comments='+issueComments.length+' reviews='+reviews.length+' reviewComments='+reviewComments.length+' files='+files.length,labels.length?'labels='+labels.join(', '):''].filter(Boolean).join('\\n');return {core:{number:Number(pr?.number||number)||number,title:String(pr?.title||fallback?.title||''),url:String(pr?.url||fallback?.url||'').trim()||null,body:truncateText(pr?.body,4000),branch:String(pr?.headRefName||fallback?.branch||'').trim()||null,baseBranch:String(pr?.baseRefName||fallback?.base||'').trim()||null,isDraft:pr?.isDraft===true,mergeable:String(pr?.mergeable||'').trim()||null,author:compactUser(pr?.author),reviewDecision:String(pr?.reviewDecision||'').trim()||null},labels,requestedReviewers,checks,ciSummary:{total:checks.length,failing:failingChecks.length,pending:pendingChecks.length,passing:Math.max(0,checks.length-failingChecks.length-pendingChecks.length)},issueComments,reviews,reviewComments,files,digestSummary};} const CI_LOG_EXCERPT_MAX_CHARS=12000;const CI_MAX_JOB_DIAGNOSTICS=10;const CI_MAX_ANNOTATIONS=60;function safeGhJsonRunner(runner,args,fallback){try{const out=runner(args);return out?JSON.parse(out):fallback;}catch{return fallback;}}function parseCheckRunId(value){const match=String(value||'').match(/\\/check-runs\\/(\\d+)/i);return match?Number(match[1]||0)||0:0;}function normalizeAnnotation(annotation){if(!annotation||typeof annotation!=='object')return null;const path=String(annotation.path||'').trim();const message=truncateText(annotation.message,1200);if(!path&&!message)return null;return {path:path||null,startLine:Number(annotation.start_line||0)||null,endLine:Number(annotation.end_line||0)||null,startColumn:Number(annotation.start_column||0)||null,endColumn:Number(annotation.end_column||0)||null,level:String(annotation.annotation_level||'').trim()||null,title:truncateText(annotation.title,300)||null,message,rawDetails:truncateText(annotation.raw_details,800)||null};}function collectCheckRunAnnotations(repo,checkRunId,runner){if(!repo||!checkRunId)return [];const annotations=[];for(let page=1;page<=3&&annotations.length=CI_MAX_ANNOTATIONS)break;}if(batch.length<50)break;}return annotations.slice(0,CI_MAX_ANNOTATIONS);}function collectCiDiagnostics(repo,run,runner){const info={failedRun:normalizeRun(run),failedJobs:[],failedAnnotations:[],failedLogExcerpt:'',diagnosticsError:''};const runId=Number(run?.databaseId||0)||0;if(!runId||!repo)return info;let workflowJobs=[];try{const viewRaw=runner(['run','view',String(runId),'--repo',repo,'--json','attempt,conclusion,status,workflowName,displayTitle,url,createdAt,updatedAt,jobs']);const view=(()=>{try{return JSON.parse(viewRaw||'{}')}catch{return {}}})();info.failedRun=normalizeRun({...run,...view});const apiJobs=safeGhJsonRunner(runner,['api','repos/'+repo+'/actions/runs/'+runId+'/jobs?per_page=100'],{});workflowJobs=Array.isArray(apiJobs?.jobs)?apiJobs.jobs:(Array.isArray(view.jobs)?view.jobs:[]);info.failedJobs=workflowJobs.map(normalizeJob).filter((job)=>job&&(FAIL_STATES.has(String(job.conclusion||'').toUpperCase())||job.failedSteps.length>0)).slice(0,CI_MAX_JOB_DIAGNOSTICS);}catch(e){info.diagnosticsError=String(e?.message||e);}try{for(const job of info.failedJobs){const checkRunId=parseCheckRunId(job?.checkRunUrl);const annotations=collectCheckRunAnnotations(repo,checkRunId,runner);if(annotations.length===0)continue;info.failedAnnotations.push({name:String(job?.name||''),checkRunId,annotations});if(info.failedAnnotations.length>=CI_MAX_JOB_DIAGNOSTICS)break;}}catch(e){const message=String(e?.message||e);if(message&&message!==info.diagnosticsError){info.diagnosticsError=info.diagnosticsError?info.diagnosticsError+' | '+message:message;}}try{info.failedLogExcerpt=truncateText(runner(['run','view',String(runId),'--repo',repo,'--log-failed']),CI_LOG_EXCERPT_MAX_CHARS);}catch(e){const message=String(e?.message||e);if(message&&message!==info.diagnosticsError){info.diagnosticsError=info.diagnosticsError?info.diagnosticsError+' | '+message:message;}}return info;} for(const item of ciFailures){ const repo=String(item?.repo||'').trim(); const branch=String(item?.branch||'').trim(); const n=String(item?.n||'').trim(); const failedCheckNames=Array.isArray(item?.failedCheckNames)?item.failedCheckNames:[]; const url=String(item?.url||'').trim(); const title=String(item?.title||'').trim(); const prDigest=repo&&n?collectPrDigest(repo,n,{branch,title,url}):null; if(!repo||!branch){needsAgent.push({repo,number:n,branch,url,title,failedCheckNames,reason:'missing_repo_or_branch',prDigest,digestSummary:String(prDigest?.digestSummary||'')});continue;} let runs=[]; try{ const listRaw=runGh(['run','list','--repo',repo,'--branch',branch,'--json','databaseId,attempt,conclusion,status,workflowName,displayTitle,url,createdAt,updatedAt','--limit','8']); const parsedRuns=(()=>{try{return JSON.parse(listRaw||'[]')}catch{return []}})(); runs=Array.isArray(parsedRuns)?parsedRuns:[]; }catch(e){needsAgent.push({repo,number:n,branch,url,title,failedCheckNames,reason:'ci_run_listing_failed',error:String(e?.message||e),prDigest,digestSummary:String(prDigest?.digestSummary||'')});continue;} const failed=runs.find((r)=>FAIL_STATES.has(String(r?.conclusion||'').toUpperCase())); const failedRun=normalizeRun(failed); if(failedRun?.databaseId&&failedRun.attempt<=MAX_AUTO_RERUN_ATTEMPT){ try{runGh(['run','rerun',String(failedRun.databaseId),'--repo',repo]);rerunRequested++;continue;} catch(e){needsAgent.push({repo,number:n,branch,url,title,failedCheckNames,reason:'ci_rerun_failed',error:String(e?.message||e),prDigest,digestSummary:String(prDigest?.digestSummary||''),...collectCiDiagnostics(repo,failedRun,runGh)});continue;} } if(failedRun?.databaseId){needsAgent.push({repo,number:n,branch,url,title,failedCheckNames,reason:'auto_rerun_limit_reached',rerunAttempts:failedRun.attempt||0,prDigest,digestSummary:String(prDigest?.digestSummary||''),...collectCiDiagnostics(repo,failedRun,runGh)});continue;} needsAgent.push({repo,number:n,branch,url,title,failedCheckNames,reason:'no_rerunnable_failed_run_found',recentRuns:runs.map(normalizeRun).filter(Boolean).slice(0,5),prDigest,digestSummary:String(prDigest?.digestSummary||'')}); } let branchUpdated=0; for(const item of conflicts){ const repo=String(item?.repo||'').trim(); const n=String(item?.n||'').trim(); const branch=String(item?.branch||'').trim(); const base=String(item?.base||'').trim(); const mergeable=String(item?.mergeable||'').toUpperCase(); const prDigest=repo&&n?collectPrDigest(repo,n,{branch,base,url:String(item?.url||'')}):null; if(!repo||!n){needsAgent.push({...item,reason:'missing_repo_or_pr',prDigest,digestSummary:String(prDigest?.digestSummary||'')});continue;} if(mergeable==='BEHIND'){ try{ const headSha=JSON.parse(runGh(['pr','view',n,'--repo',repo,'--json','headRefOid'])).headRefOid; const apiArgs=['api','-X','PUT','repos/'+repo+'/pulls/'+n+'/update-branch','--field','expected_head_sha='+headSha]; runGh(apiArgs); branchUpdated++; }catch(e){needsAgent.push({repo,number:n,branch,base,mergeable,reason:'branch_update_failed',error:String(e?.message||e),prDigest,digestSummary:String(prDigest?.digestSummary||'')});} continue; } needsAgent.push({repo,number:n,branch,base,mergeable,reason:'merge_conflict_requires_code_resolution',prDigest,digestSummary:String(prDigest?.digestSummary||'')}); } console.log(JSON.stringify({rerunRequested,branchUpdated,ciFailureCount:ciFailures.length,conflictCount:conflicts.length,needsAgentCount:needsAgent.length,needsAgent}));" ], "continueOnError": true, "failOnError": false, @@ -870,21 +708,18 @@ ] }, { - "id": "claim-unclaimed-prs", - "type": "action.run_command", - "label": "Claim & Filter Unclaimed PRs", + "id": "dispatch-fix-agent", + "type": "action.run_agent", + "label": "Dispatch Fix Agent (Fallback)", "config": { - "command": "node", - "args": [ - "-e", - "const fs=require('fs'); const path=require('path'); const raw=String(process.env.BOSUN_PROGRAMMATIC_FIX||''); const payload=(()=>{try{return JSON.parse(raw||'{}')}catch{return {}}})(); const needsAgent=Array.isArray(payload.needsAgent)?payload.needsAgent:[]; const TTL_MS=Math.max(60000,Number(process.env.PR_FIX_TTL_MINUTES||'120')*60*1000); const STALE_CLAIM_MS=Math.max(10*60*1000,Math.min(TTL_MS,20*60*1000)); const CLAIM_DIR=path.join(process.cwd(),'.cache','bosun'); const CLAIM_FILE=path.join(CLAIM_DIR,'pr-fix-claims.json'); function loadClaims(){try{const d=JSON.parse(fs.readFileSync(CLAIM_FILE,'utf8'));return(d&&typeof d==='object'&&d.claims&&typeof d.claims==='object')?d.claims:{};}catch{return {};}} function saveClaims(claims){try{if(!fs.existsSync(CLAIM_DIR))fs.mkdirSync(CLAIM_DIR,{recursive:true});const data={version:1,claims,updatedAt:new Date().toISOString()};const tmp=CLAIM_FILE+'.tmp'+Date.now();fs.writeFileSync(tmp,JSON.stringify(data,null,2),'utf8');fs.renameSync(tmp,CLAIM_FILE);}catch(e){process.stderr.write('[claim] save error: '+String(e?.message||e)+'\\n');}} const now=Date.now(); const claims=loadClaims(); /* Purge expired or abandoned claims so stalled repair runs do not block retries for hours. */ for(const key of Object.keys(claims)){const claim=claims[key]||{};const expiresAt=new Date(claim.expiresAt||0).getTime();const claimedAt=new Date(claim.claimedAt||0).getTime();const staleByAge=Number.isFinite(claimedAt)&&claimedAt>0&&(now-claimedAt)>=STALE_CLAIM_MS;if(now>expiresAt||staleByAge)delete claims[key];} const unclaimed=[]; const alreadyClaimed=[]; for(const item of needsAgent){ const repo=String(item?.repo||'').trim(); const number=String(item?.number||item?.n||'').trim(); if(!repo||!number){unclaimed.push({...item,taskId:'pr-fix-unknown',taskTitle:'Unknown PR',claimKey:''});continue;} const key=repo+'#'+number; const claim=claims[key]; if(claim&&now{try{const o=$ctx.getNodeOutput('claim-unclaimed-prs');const d=typeof o?.output==='object'?o.output:JSON.parse(o?.output||'{}');return (Array.isArray(d.unclaimed)?d.unclaimed:[]).length>0;}catch(e){return false;}})()" - }, - "position": { - "x": 280, - "y": 1060 - }, - "outputs": [ - "default" - ] - }, - { - "id": "dispatch-fix-agents", - "type": "loop.for_each", - "label": "Dispatch Fix Agents (Per PR)", - "config": { - "items": "(()=>{try{const o=$ctx.getNodeOutput('claim-unclaimed-prs');const d=typeof o?.output==='object'?o.output:JSON.parse(o?.output||'{}');return Array.isArray(d.unclaimed)?d.unclaimed:[];}catch{return []}})();", - "variable": "item", - "maxConcurrent": "{{maxConcurrentFixes}}", - "workflowId": "template-pr-fix-single" - }, - "position": { - "x": 280, - "y": 1160 - }, - "outputs": [ - "default" - ] - }, { "id": "review-needed", "type": "condition.expression", @@ -1112,9 +914,9 @@ "sourcePort": "default" }, { - "id": "security-agent-needed->claim-unclaimed-security-prs", + "id": "security-agent-needed->dispatch-security-fix-agent", "source": "security-agent-needed", - "target": "claim-unclaimed-security-prs", + "target": "dispatch-security-fix-agent", "sourcePort": "default", "condition": "$output?.result === true" }, @@ -1126,28 +928,8 @@ "condition": "$output?.result !== true" }, { - "id": "claim-unclaimed-security-prs->has-unclaimed-security-fixes", - "source": "claim-unclaimed-security-prs", - "target": "has-unclaimed-security-fixes", - "sourcePort": "default" - }, - { - "id": "has-unclaimed-security-fixes->dispatch-security-fix-agents", - "source": "has-unclaimed-security-fixes", - "target": "dispatch-security-fix-agents", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "has-unclaimed-security-fixes->generic-fix-needed", - "source": "has-unclaimed-security-fixes", - "target": "generic-fix-needed", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "dispatch-security-fix-agents->generic-fix-needed", - "source": "dispatch-security-fix-agents", + "id": "dispatch-security-fix-agent->generic-fix-needed", + "source": "dispatch-security-fix-agent", "target": "generic-fix-needed", "sourcePort": "default" }, @@ -1172,9 +954,9 @@ "sourcePort": "default" }, { - "id": "fix-agent-needed->claim-unclaimed-prs", + "id": "fix-agent-needed->dispatch-fix-agent", "source": "fix-agent-needed", - "target": "claim-unclaimed-prs", + "target": "dispatch-fix-agent", "sourcePort": "default", "condition": "$output?.result === true" }, @@ -1186,28 +968,8 @@ "condition": "$output?.result !== true" }, { - "id": "claim-unclaimed-prs->has-unclaimed-fixes", - "source": "claim-unclaimed-prs", - "target": "has-unclaimed-fixes", - "sourcePort": "default" - }, - { - "id": "has-unclaimed-fixes->dispatch-fix-agents", - "source": "has-unclaimed-fixes", - "target": "dispatch-fix-agents", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "has-unclaimed-fixes->review-needed", - "source": "has-unclaimed-fixes", - "target": "review-needed", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "dispatch-fix-agents->review-needed", - "source": "dispatch-fix-agents", + "id": "dispatch-fix-agent->review-needed", + "source": "dispatch-fix-agent", "target": "review-needed", "sourcePort": "default" }, @@ -1350,7 +1112,7 @@ "command": "node", "args": [ "-e", - "const {execFileSync}=require('child_process'); const fs=require('fs'); const raw=String(process.env.BOSUN_FETCH_PR_STATE||''); const data=(()=>{try{return JSON.parse(raw||'{}')}catch{return {}}})(); const merged=Array.isArray(data.merged)?data.merged:[]; const open=Array.isArray(data.open)?data.open:[]; const updates=[]; const unresolved=[]; const maxBuffer=25*1024*1024; const cliPath=fs.existsSync('cli.mjs')?'cli.mjs':''; const taskCli=['task/task-cli.mjs','task-cli.mjs'].find(p=>fs.existsSync(p))||''; const taskRunner=cliPath?'cli':(taskCli?'task-cli':''); if(!taskRunner){ console.log(JSON.stringify({updated:0,unresolved:[{reason:'task_command_missing'}],needsAgent:true})); process.exit(0); } function runTask(args){const cmdArgs=taskRunner==='cli'?['cli.mjs','task',...args,'--config-dir','.bosun','--repo-root','.']:[taskCli,...args];return execFileSync('node',cmdArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe'],maxBuffer}).trim();} function parseJsonObject(raw){const txt=String(raw||'').trim();if(!txt)return null;try{return JSON.parse(txt);}catch{}const lines=txt.split(/\\r?\\n/);for(let start=0;starts.trim()).filter(Boolean);for(let i=compact.length-1;i>=0;i--){const line=compact[i];if(!(line.startsWith('{')||line.startsWith('[')))continue;try{return JSON.parse(line);}catch{}}const start=txt.indexOf('{');const end=txt.lastIndexOf('}');if(start>=0&&end>start){try{return JSON.parse(txt.slice(start,end+1));}catch{}}return null;} let taskListCache=null; function normalizeRepo(value){return String(value||'').trim().toLowerCase();} function listTasks(){ if(Array.isArray(taskListCache)) return taskListCache; try{const raw=runTask(['list','--json']);const tasks=parseJsonObject(raw);taskListCache=Array.isArray(tasks)?tasks:[];return taskListCache;}catch{taskListCache=[];return taskListCache;} } function resolveTaskId(item){ const explicit=String(item?.taskId||'').trim(); if(explicit) return explicit; const branch=String(item?.branch||'').trim(); if(!branch) return ''; const repo=normalizeRepo(item?.repo); const matches=listTasks().filter((task)=>{ const taskBranch=String(task?.branchName||'').trim(); if(taskBranch!==branch) return false; const taskRepo=normalizeRepo(task?.repository||''); if(!repo || !taskRepo) return true; return taskRepo===repo; }); if(matches.length===1) return String(matches[0]?.id||'').trim(); const exactRepo=matches.find((task)=>normalizeRepo(task?.repository||'')===repo); return exactRepo?String(exactRepo?.id||'').trim():''; } function getTaskSnapshot(id){ try{const raw=runTask(['get',id,'--json']);const task=parseJsonObject(raw);return {status:task?.status||null,reviewStatus:task?.reviewStatus||null};}catch{return {status:null,reviewStatus:null};} } for(const item of merged){ const id=resolveTaskId(item); if(!id){unresolved.push({taskId:null,repo:String(item?.repo||''),branch:String(item?.branch||''),status:'done',reason:'task_lookup_failed'});continue;} try{runTask(['update',id,'--status','done']);updates.push({taskId:id,status:'done'});}catch(e){unresolved.push({taskId:id,status:'done',error:String(e?.message||e)});} } for(const item of open){ const id=resolveTaskId(item); if(!id){unresolved.push({taskId:null,repo:String(item?.repo||''),branch:String(item?.branch||''),status:'inreview',reason:'task_lookup_failed'});continue;} try{const snap=getTaskSnapshot(id);const current=String(snap?.status||'').trim().toLowerCase();const review=String(snap?.reviewStatus||'').toLowerCase();if(current==='inreview'||current==='done'){updates.push({taskId:id,status:current,skipped:true});continue;}runTask(['update',id,'--status','inreview']);updates.push({taskId:id,status:'inreview',fromStatus:current||null,reviewStatus:review||null});}catch(e){unresolved.push({taskId:id,status:'inreview',error:String(e?.message||e)});} } const actionableUnresolved=unresolved.filter((item)=>String(item?.taskId||'').trim()); console.log(JSON.stringify({updated:updates.length,updates,unresolved,actionableUnresolved,needsAgent:actionableUnresolved.length>0}));" + "const {execFileSync}=require('child_process'); const fs=require('fs'); const raw=String(process.env.BOSUN_FETCH_PR_STATE||''); const data=(()=>{try{return JSON.parse(raw||'{}')}catch{return {}}})(); const merged=Array.isArray(data.merged)?data.merged:[]; const open=Array.isArray(data.open)?data.open:[]; const updates=[]; const unresolved=[]; const maxBuffer=25*1024*1024; const cliPath=fs.existsSync('cli.mjs')?'cli.mjs':''; const taskCli=['task/task-cli.mjs','task-cli.mjs'].find(p=>fs.existsSync(p))||''; const taskRunner=cliPath?'cli':(taskCli?'task-cli':''); if(!taskRunner){ console.log(JSON.stringify({updated:0,unresolved:[{reason:'task_command_missing'}],needsAgent:true})); process.exit(0); } function runTask(args){const cmdArgs=taskRunner==='cli'?['cli.mjs','task',...args,'--config-dir','.bosun','--repo-root','.']:[taskCli,...args];return execFileSync('node',cmdArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe'],maxBuffer}).trim();} function parseJsonObject(raw){const txt=String(raw||'').trim();if(!txt)return null;try{return JSON.parse(txt);}catch{}const lines=txt.split(/\\r?\\n/);for(let start=0;starts.trim()).filter(Boolean);for(let i=compact.length-1;i>=0;i--){const line=compact[i];if(!(line.startsWith('{')||line.startsWith('[')))continue;try{return JSON.parse(line);}catch{}}const start=txt.indexOf('{');const end=txt.lastIndexOf('}');if(start>=0&&end>start){try{return JSON.parse(txt.slice(start,end+1));}catch{}}return null;} let taskListCache=null; function normalizeRepo(value){return String(value||'').trim().toLowerCase();} function listTasks(){ if(Array.isArray(taskListCache)) return taskListCache; try{const raw=runTask(['list','--json']);const tasks=parseJsonObject(raw);taskListCache=Array.isArray(tasks)?tasks:[];return taskListCache;}catch{taskListCache=[];return taskListCache;} } function resolveTaskId(item){ const explicit=String(item?.taskId||'').trim(); if(explicit) return explicit; const branch=String(item?.branch||'').trim(); if(!branch) return ''; const repo=normalizeRepo(item?.repo); const matches=listTasks().filter((task)=>{ const taskBranch=String(task?.branchName||'').trim(); if(taskBranch!==branch) return false; const taskRepo=normalizeRepo(task?.repository||''); if(!repo || !taskRepo) return true; return taskRepo===repo; }); if(matches.length===1) return String(matches[0]?.id||'').trim(); const exactRepo=matches.find((task)=>normalizeRepo(task?.repository||'')===repo); return exactRepo?String(exactRepo?.id||'').trim():''; } function getTaskSnapshot(id){ try{const raw=runTask(['get',id,'--json']);const task=parseJsonObject(raw);return {status:task?.status||null,reviewStatus:task?.reviewStatus||null};}catch{return {status:null,reviewStatus:null};} } for(const item of merged){ const id=resolveTaskId(item); if(!id){unresolved.push({taskId:null,repo:String(item?.repo||''),branch:String(item?.branch||''),status:'done',reason:'task_lookup_failed'});continue;} try{runTask(['update',id,'--status','done']);updates.push({taskId:id,status:'done'});}catch(e){unresolved.push({taskId:id,status:'done',error:String(e?.message||e)});} } for(const item of open){ const id=resolveTaskId(item); if(!id){unresolved.push({taskId:null,repo:String(item?.repo||''),branch:String(item?.branch||''),status:'inreview',reason:'task_lookup_failed'});continue;} try{const snap=getTaskSnapshot(id);const current=String(snap?.status||'').trim().toLowerCase();const review=String(snap?.reviewStatus||'').toLowerCase();if(current==='inreview'||current==='done'){updates.push({taskId:id,status:current,skipped:true});continue;}runTask(['update',id,'--status','inreview']);updates.push({taskId:id,status:'inreview',fromStatus:current||null,reviewStatus:review||null});}catch(e){unresolved.push({taskId:id,status:'inreview',error:String(e?.message||e)});} } const actionableUnresolved=unresolved.filter((item)=>String(item?.taskId||'').trim()); console.log(JSON.stringify({updated:updates.length,updates,unresolved,needsAgent:actionableUnresolved.length>0}));" ], "continueOnError": true, "failOnError": false, @@ -1488,52 +1250,65 @@ ] }, { - "id": "template-github-check-failure", - "name": "GitHub Check Failure Handler", - "description": "Event-driven workflow that fires the moment a GitHub check run fails. Identifies the associated PR and applies the bosun-needs-fix label instantly so the PR Watchdog can dispatch a repair agent on its next sweep. Eliminates the up-to-30-minute delay between a CI failure and Bosun's response.", + "id": "template-pr-conflict-resolver", + "name": "PR Conflict Resolver", + "description": ":alert: SUPERSEDED for bosun-managed repos — use the Bosun PR Watchdog (template-bosun-pr-watchdog) instead. The Watchdog consolidates conflict resolution, CI-failure repair, diff-safety review, and merge into one cycle with a single gh API call and a mandatory review gate before any merge. This template is kept for repos that do not use the assistive bosun-attached label convention. It only touches Bosun-created PRs and never auto-merges directly — it resolves conflicts and then defers to the Watchdog's review gate for the actual merge decision.", "category": "github", "categoryLabel": "GitHub", "categoryIcon": ":git:", "categoryOrder": 1, "tags": [ "github", - "ci", - "check", - "event-driven", - "webhook", - "reliability" + "pr", + "conflict", + "rebase", + "automation", + "bosun-attached" ], - "nodeCount": 5, - "edgeCount": 4, - "recommended": true, - "enabled": true, - "trigger": "trigger.event", + "nodeCount": 11, + "edgeCount": 10, + "recommended": false, + "enabled": false, + "trigger": "trigger.schedule", "variables": { - "labelNeedsFix": "bosun-needs-fix", - "ignoredCheckNames": "codecov,dependabot,semantic-pr-title" + "checkIntervalMs": 1800000, + "maxConcurrentFixes": 3, + "maxRetries": 3 }, "metadata": { "author": "bosun", - "version": 1, - "createdAt": "2026-06-01T00:00:00Z", - "templateVersion": "1.0.0", + "version": 2, + "createdAt": "2025-02-25T00:00:00Z", + "templateVersion": "2.0.0", "tags": [ "github", - "ci", - "check", - "event-driven", - "webhook", - "reliability" - ] + "pr", + "conflict", + "rebase", + "automation", + "bosun-attached" + ], + "replaces": { + "module": "pr-cleanup-daemon.mjs", + "functions": [ + "PRCleanupDaemon.run", + "processCleanup", + "resolveConflicts" + ], + "calledFrom": [ + "monitor.mjs:startProcess" + ], + "description": "v2: Restricted to Bosun-created PRs only — never touches external-contributor PRs. Removed direct auto-merge: this template now only resolves the conflict and pushes; the Bosun PR Watchdog (template-bosun-pr-watchdog) owns the merge decision with its diff-safety review gate. Skips PRs already tagged bosun-needs-fix (watchdog owns those). Labels PR with bosun-needs-fix during resolution so watchdog knows it is in-flight." + } }, "nodes": [ { "id": "trigger", - "type": "trigger.event", - "label": "Check Run Failed", + "type": "trigger.schedule", + "label": "Check Every 30min", "config": { - "eventType": "github:check_run", - "filter": "$event?.action === 'completed' && $event?.checkConclusion === 'failure' && !String($event?.checkName || '').split(',').some(n => String($data?.ignoredCheckNames || '').toLowerCase().split(',').map(s => s.trim()).includes(n.trim().toLowerCase()))" + "intervalMs": "{{checkIntervalMs}}", + "cron": "*/30 * * * *" }, "position": { "x": 400, @@ -1544,311 +1319,166 @@ ] }, { - "id": "check-has-pr", - "type": "condition.expression", - "label": "Associated PR Found?", - "config": { - "expression": "Number($data?.prNumber) > 0 && Boolean($data?.repo)" - }, - "position": { - "x": 400, - "y": 190 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "label-fix", + "id": "list-prs", "type": "action.run_command", - "label": "Label PR: bosun-needs-fix", + "label": "List Bosun-Created Conflicting PRs", "config": { - "command": "gh", - "args": [ - "pr", - "edit", - "{{prNumber}}", - "--add-label", - "{{labelNeedsFix}}", - "--repo", - "{{repo}}" - ], - "continueOnError": true + "command": "gh pr list --state open --json number,title,body,headRefName,baseRefName,mergeable,labels --limit {{maxConcurrentFixes}}" }, "position": { - "x": 250, - "y": 340 + "x": 400, + "y": 180 }, "outputs": [ "default" ] }, { - "id": "log-labeled", - "type": "notify.log", - "label": "Log Fix Label Applied", + "id": "target-pr", + "type": "action.set_variable", + "label": "Pick Conflict PR", "config": { - "message": ":x: Check '{{checkName}}' failed on PR #{{prNumber}} ({{repo}}). Applied label '{{labelNeedsFix}}' — PR Watchdog will dispatch repair.", - "level": "warn" + "key": "targetPrNumber", + "value": "(() => { const raw = $ctx.getNodeOutput('list-prs')?.output || '[]'; let prs = []; try { prs = typeof raw === 'string' ? JSON.parse(raw) : raw; } catch { return ''; } if (!Array.isArray(prs)) return ''; const CONFLICT = new Set(['CONFLICTING', 'BEHIND', 'DIRTY']); const BOSUN_CREATED_LABEL = 'bosun-pr-bosun-created'; const readLabelNames = (pr) => Array.isArray(pr?.labels) ? pr.labels.map((entry) => typeof entry === 'string' ? entry : entry?.name).filter(Boolean) : []; const isBosunCreated = (pr) => readLabelNames(pr).includes(BOSUN_CREATED_LABEL); /* Skip PRs already owned by the watchdog fix agent */ const pr = prs.find((p) => isBosunCreated(p) && CONFLICT.has(String(p?.mergeable || '').toUpperCase()) && !(p.labels || []).some((l) => l.name === 'bosun-needs-fix') ); return pr?.number ? String(pr.number) : '';})()", + "isExpression": true }, "position": { - "x": 250, - "y": 490 + "x": 400, + "y": 260 }, "outputs": [ "default" ] }, { - "id": "log-no-pr", - "type": "notify.log", - "label": "Log No Associated PR", + "id": "target-branch", + "type": "action.set_variable", + "label": "Capture Conflict Branch", "config": { - "message": "Check '{{checkName}}' failed in {{repo}} (conclusion: {{checkConclusion}}) — no associated PR found.", - "level": "debug" + "key": "targetPrBranch", + "value": "(() => { const raw = $ctx.getNodeOutput('list-prs')?.output || '[]'; let prs = []; try { prs = typeof raw === 'string' ? JSON.parse(raw) : raw; } catch { return ''; } if (!Array.isArray(prs)) return ''; const pr = prs.find((p) => String(p?.number || '') === String($data?.targetPrNumber || '')); return pr?.headRefName || '';})()", + "isExpression": true }, "position": { - "x": 620, + "x": 400, "y": 340 }, "outputs": [ "default" ] - } - ], - "edges": [ - { - "id": "trigger->check-has-pr", - "source": "trigger", - "target": "check-has-pr", - "sourcePort": "default" - }, - { - "id": "check-has-pr->label-fix", - "source": "check-has-pr", - "target": "label-fix", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "check-has-pr->log-no-pr", - "source": "check-has-pr", - "target": "log-no-pr", - "sourcePort": "no", - "condition": "$output?.result !== true" }, { - "id": "label-fix->log-labeled", - "source": "label-fix", - "target": "log-labeled", - "sourcePort": "default" - } - ] - }, - { - "id": "template-github-pr-event-handler", - "name": "GitHub PR Event Handler", - "description": "Event-driven workflow that fires as soon as a PR is opened, updated, or reopened via GitHub webhook. Identifies the linked Bosun task by branch name and immediately updates its status to in-review — no polling required. Complements the PR Watchdog which runs every 30 minutes as a fallback.", - "category": "github", - "categoryLabel": "GitHub", - "categoryIcon": ":git:", - "categoryOrder": 1, - "tags": [ - "github", - "pr", - "event-driven", - "lifecycle", - "webhook" - ], - "nodeCount": 9, - "edgeCount": 8, - "recommended": true, - "enabled": true, - "trigger": "trigger.event", - "variables": { - "labelInReview": "bosun/in-review", - "taskBranchPrefix": "task/" - }, - "metadata": { - "author": "bosun", - "version": 1, - "createdAt": "2026-06-01T00:00:00Z", - "templateVersion": "1.0.0", - "tags": [ - "github", - "pr", - "event-driven", - "lifecycle", - "webhook" - ] - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.event", - "label": "PR Opened / Updated", + "id": "target-base", + "type": "action.set_variable", + "label": "Capture Base Branch", "config": { - "eventType": "github:pull_request", - "filter": "['opened','synchronize','reopened'].includes(String($event?.action || '').toLowerCase())" + "key": "targetPrBase", + "value": "(() => { const raw = $ctx.getNodeOutput('list-prs')?.output || '[]'; let prs = []; try { prs = typeof raw === 'string' ? JSON.parse(raw) : raw; } catch { return 'main'; } if (!Array.isArray(prs)) return 'main'; const pr = prs.find((p) => String(p?.number || '') === String($data?.targetPrNumber || '')); return pr?.baseRefName || 'main';})()", + "isExpression": true }, "position": { "x": 400, - "y": 50 + "y": 420 }, "outputs": [ "default" ] }, { - "id": "check-bosun-branch", + "id": "has-conflicts", "type": "condition.expression", - "label": "Is a Bosun Task Branch?", + "label": "Any Conflicts?", "config": { - "expression": "Boolean($data?.prBranch) && String($data?.prBranch || '').startsWith(String($data?.taskBranchPrefix || 'task/'))" + "expression": "Boolean($data?.targetPrNumber)" }, "position": { "x": 400, - "y": 190 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "find-task", - "type": "action.run_command", - "label": "Find Linked Task", - "config": { - "command": "node", - "args": [ - "-e", - "\n const fs = require(\"node:fs\");\n const path = require(\"node:path\");\n const { pathToFileURL } = require(\"node:url\");\n let repoRoot = process.cwd();\n const mirrorMarker = (path.sep + \".bosun\" + path.sep + \"workspaces\" + path.sep).toLowerCase();\n if (repoRoot.toLowerCase().includes(mirrorMarker)) {\n const r = path.resolve(repoRoot, \"..\", \"..\", \"..\", \"..\");\n if (fs.existsSync(path.join(r, \"kanban\", \"kanban-adapter.mjs\"))) repoRoot = r;\n }\n const kanbanUrl = pathToFileURL(path.join(repoRoot, \"kanban\", \"kanban-adapter.mjs\")).href;\n const branch = process.env.PR_BRANCH || \"\";\n import(kanbanUrl)\n .then(k => k.listTasks(undefined, {}))\n .then(tasks => {\n const task = (tasks || []).find(t =>\n (t.branch || t.metadata?.branch) === branch\n );\n console.log(JSON.stringify(task || null));\n })\n .catch(e => { console.error(e.message); process.exit(1); });\n " - ], - "env": { - "PR_BRANCH": "{{prBranch}}" - }, - "parseJson": true - }, - "position": { - "x": 250, - "y": 340 + "y": 510 }, "outputs": [ "default" ] }, { - "id": "check-task-found", - "type": "condition.expression", - "label": "Task Found?", - "config": { - "expression": "Boolean($ctx.getNodeOutput('find-task')?.output?.id)" - }, - "position": { - "x": 250, - "y": 490 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "update-inreview", - "type": "action.update_task_status", - "label": "Mark Task In Review", + "id": "label-fixing", + "type": "action.run_command", + "label": "Label bosun-needs-fix", "config": { - "taskId": "{{$ctx.getNodeOutput('find-task')?.output?.id || ''}}", - "status": "inreview", - "taskTitle": "{{$ctx.getNodeOutput('find-task')?.output?.title || prTitle || ''}}", - "workflowEvent": "task.in_review", - "workflowData": { - "source": "github:pr_opened", - "prNumber": "{{prNumber}}", - "prUrl": "{{prUrl}}", - "branch": "{{prBranch}}", - "repo": "{{repo}}" - } + "command": "gh pr edit {{targetPrNumber}} --add-label bosun-needs-fix", + "continueOnError": true }, "position": { - "x": 250, - "y": 640 + "x": 200, + "y": 650 }, "outputs": [ "default" ] }, { - "id": "add-label-in-review", - "type": "action.run_command", - "label": "Add In-Review Label", + "id": "resolve-conflicts", + "type": "action.run_agent", + "label": "Resolve Conflicts", "config": { - "command": "node", - "args": [ - "-e", - "const {execFileSync}=require('child_process'); const n=String(process.env.PR_NUMBER||'').trim(); const repo=String(process.env.REPO||'').trim(); const label=String(process.env.LABEL_IN_REVIEW||'bosun/in-review').trim(); if(!n||!label){process.exit(0);} try{ const args=['pr','edit',n,'--add-label',label]; if(repo)args.push('--repo',repo); execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}); console.log(JSON.stringify({labeled:true,label,pr:n})); }catch(e){ process.stderr.write('label warn: '+String(e?.message||e)+'\\n'); console.log(JSON.stringify({labeled:false,label,pr:n,error:String(e?.message||e)})); }" - ], - "continueOnError": true, - "failOnError": false, - "env": { - "PR_NUMBER": "{{prNumber}}", - "REPO": "{{repo}}", - "LABEL_IN_REVIEW": "{{labelInReview}}" - } + "prompt": "You are a merge conflict resolution agent for PR #{{targetPrNumber}} on branch {{targetPrBranch}} (base: {{targetPrBase}}).\n\nSteps:\n1. git fetch origin\n2. git checkout {{targetPrBranch}}\n3. git rebase origin/{{targetPrBase}} (fall back to merge if rebase is too complex)\n4. Resolve all merge conflicts, preserving the intent of both sides.\n5. Run the repo's build and test suite to confirm nothing is broken.\n6. git push --force-with-lease origin {{targetPrBranch}}\n7. Remove the bosun-needs-fix label: gh pr edit {{targetPrNumber}} --remove-label bosun-needs-fix\n\nRules:\n- Only make minimal conflict-resolution changes. No unrelated refactors.\n- Do NOT merge, close, or approve the PR — the Bosun PR Watchdog handles merging.\n- Do NOT touch PRs that are not Bosun-created.", + "sdk": "auto", + "timeoutMs": 1800000, + "failOnError": true, + "maxRetries": "{{maxRetries}}", + "retryDelayMs": 30000, + "continueOnError": true }, "position": { - "x": 250, - "y": 720 + "x": 200, + "y": 800 }, "outputs": [ "default" ] }, { - "id": "log-updated", - "type": "notify.log", - "label": "Log In Review", + "id": "notify-fixed", + "type": "notify.telegram", + "label": "Notify Resolved", "config": { - "message": ":rocket: Task {{$ctx.getNodeOutput('find-task')?.output?.id}} moved to in-review — PR #{{prNumber}} ({{prBranch}}) in {{repo}}", - "level": "info" + "message": ":settings: PR #{{targetPrNumber}} conflict resolved — awaiting CI and Watchdog review before merge", + "silent": true }, "position": { - "x": 250, - "y": 790 + "x": 200, + "y": 960 }, "outputs": [ "default" ] }, { - "id": "log-no-task", + "id": "notify-failed", "type": "notify.log", - "label": "Log No Task Found", + "label": "Log Resolution Failed", "config": { - "message": "PR #{{prNumber}} opened on branch {{prBranch}} in {{repo}} — no linked Bosun task found.", - "level": "debug" + "message": "PR #{{targetPrNumber}} conflict could not be resolved cleanly — manual review required", + "level": "warn" }, "position": { - "x": 550, - "y": 490 + "x": 450, + "y": 800 }, "outputs": [ "default" ] }, { - "id": "log-not-bosun", + "id": "skip", "type": "notify.log", - "label": "Log Non-Bosun Branch", + "label": "No Conflicts", "config": { - "message": "PR #{{prNumber}} on {{prBranch}} is not a Bosun task branch — skipping.", - "level": "debug" + "message": "PR Conflict Resolver: no unhandled Bosun-created conflicts found", + "level": "info" }, "position": { - "x": 650, - "y": 340 + "x": 620, + "y": 510 }, "outputs": [ "default" @@ -1857,119 +1487,135 @@ ], "edges": [ { - "id": "trigger->check-bosun-branch", + "id": "trigger->list-prs", "source": "trigger", - "target": "check-bosun-branch", + "target": "list-prs", "sourcePort": "default" }, { - "id": "check-bosun-branch->find-task", - "source": "check-bosun-branch", - "target": "find-task", - "sourcePort": "yes", - "condition": "$output?.result === true" + "id": "list-prs->target-pr", + "source": "list-prs", + "target": "target-pr", + "sourcePort": "default" }, { - "id": "check-bosun-branch->log-not-bosun", - "source": "check-bosun-branch", - "target": "log-not-bosun", - "sourcePort": "no", - "condition": "$output?.result !== true" + "id": "target-pr->target-branch", + "source": "target-pr", + "target": "target-branch", + "sourcePort": "default" }, { - "id": "find-task->check-task-found", - "source": "find-task", - "target": "check-task-found", + "id": "target-branch->target-base", + "source": "target-branch", + "target": "target-base", "sourcePort": "default" }, { - "id": "check-task-found->update-inreview", - "source": "check-task-found", - "target": "update-inreview", - "sourcePort": "yes", + "id": "target-base->has-conflicts", + "source": "target-base", + "target": "has-conflicts", + "sourcePort": "default" + }, + { + "id": "has-conflicts->label-fixing", + "source": "has-conflicts", + "target": "label-fixing", + "sourcePort": "default", "condition": "$output?.result === true" }, { - "id": "check-task-found->log-no-task", - "source": "check-task-found", - "target": "log-no-task", - "sourcePort": "no", + "id": "has-conflicts->skip", + "source": "has-conflicts", + "target": "skip", + "sourcePort": "default", "condition": "$output?.result !== true" }, { - "id": "update-inreview->add-label-in-review", - "source": "update-inreview", - "target": "add-label-in-review", + "id": "label-fixing->resolve-conflicts", + "source": "label-fixing", + "target": "resolve-conflicts", "sourcePort": "default" }, { - "id": "add-label-in-review->log-updated", - "source": "add-label-in-review", - "target": "log-updated", - "sourcePort": "default" - } - ] - }, - { - "id": "template-pr-conflict-resolver", - "name": "PR Conflict Resolver", - "description": ":alert: SUPERSEDED for bosun-managed repos — use the Bosun PR Watchdog (template-bosun-pr-watchdog) instead. The Watchdog consolidates conflict resolution, CI-failure repair, diff-safety review, and merge into one cycle with a single gh API call and a mandatory review gate before any merge. This template is kept for repos that do not use the assistive bosun-attached label convention. It only touches Bosun-created PRs and never auto-merges directly — it resolves conflicts and then defers to the Watchdog's review gate for the actual merge decision.", - "category": "github", + "id": "resolve-conflicts->notify-fixed", + "source": "resolve-conflicts", + "target": "notify-fixed", + "sourcePort": "default", + "condition": "$ctx.getNodeOutput('resolve-conflicts')?.success === true" + }, + { + "id": "resolve-conflicts->notify-failed", + "source": "resolve-conflicts", + "target": "notify-failed", + "sourcePort": "default", + "condition": "$ctx.getNodeOutput('resolve-conflicts')?.success !== true" + } + ] + }, + { + "id": "template-pr-merge-strategy", + "name": "PR Merge Strategy", + "description": "Automated PR merge decision workflow with resilient retry paths. Analyzes CI + agent output, executes merge/prompt/close/re-attempt actions, and escalates gracefully when any branch action fails.", + "category": "github", "categoryLabel": "GitHub", "categoryIcon": ":git:", "categoryOrder": 1, "tags": [ "github", "pr", - "conflict", - "rebase", - "automation", - "bosun-attached" + "merge", + "strategy", + "automation" ], - "nodeCount": 11, - "edgeCount": 10, - "recommended": false, - "enabled": false, - "trigger": "trigger.schedule", + "nodeCount": 20, + "edgeCount": 29, + "recommended": true, + "enabled": true, + "trigger": "trigger.pr_event", "variables": { - "checkIntervalMs": 1800000, - "maxConcurrentFixes": 3, - "maxRetries": 3 + "ciTimeoutMs": 300000, + "cooldownSec": 60, + "maxRetries": 3, + "baseBranch": "main", + "requireBosunCreatedPr": true }, "metadata": { "author": "bosun", - "version": 2, - "createdAt": "2025-02-25T00:00:00Z", - "templateVersion": "2.0.0", + "version": 1, + "createdAt": "2025-02-24T00:00:00Z", + "templateVersion": "1.0.0", "tags": [ "github", "pr", - "conflict", - "rebase", - "automation", - "bosun-attached" + "merge", + "strategy", + "automation" ], "replaces": { - "module": "pr-cleanup-daemon.mjs", + "module": "merge-strategy.mjs", "functions": [ - "PRCleanupDaemon.run", - "processCleanup", - "resolveConflicts" + "analyzeMergeStrategy", + "executeDecision", + "analyzeAndExecute" ], "calledFrom": [ - "monitor.mjs:startProcess" + "monitor.mjs:runMergeStrategyAnalysis" ], - "description": "v2: Restricted to Bosun-created PRs only — never touches external-contributor PRs. Removed direct auto-merge: this template now only resolves the conflict and pushes; the Bosun PR Watchdog (template-bosun-pr-watchdog) owns the merge decision with its diff-safety review gate. Skips PRs already tagged bosun-needs-fix (watchdog owns those). Labels PR with bosun-needs-fix during resolution so watchdog knows it is in-flight." + "description": "Replaces hardcoded merge-strategy analysis and decision execution. All 7 decision outcomes (merge, prompt, close, re_attempt, manual_review, wait, noop) are encoded as visual workflow branches instead of imperative code." } }, "nodes": [ { "id": "trigger", - "type": "trigger.schedule", - "label": "Check Every 30min", + "type": "trigger.pr_event", + "label": "PR Ready for Merge Decision", "config": { - "intervalMs": "{{checkIntervalMs}}", - "cron": "*/30 * * * *" + "event": "review_requested", + "events": [ + "review_requested", + "approved", + "opened" + ] }, "position": { "x": 400, @@ -1980,499 +1626,333 @@ ] }, { - "id": "list-prs", + "id": "load-pr-context", "type": "action.run_command", - "label": "List Bosun-Created Conflicting PRs", + "label": "Load PR Context", "config": { - "command": "gh pr list --state open --json number,title,body,headRefName,baseRefName,mergeable,labels --limit {{maxConcurrentFixes}}" + "command": "gh pr view {{prNumber}} --json body,author,title,labels" }, "position": { "x": 400, - "y": 180 + "y": 140 }, "outputs": [ "default" ] }, { - "id": "target-pr", - "type": "action.set_variable", - "label": "Pick Conflict PR", + "id": "automation-eligible", + "type": "condition.expression", + "label": "Bosun-Created PR?", "config": { - "key": "targetPrNumber", - "value": "/* */ (() => { const raw = $ctx.getNodeOutput('list-prs')?.output || '[]'; let prs = []; try { prs = typeof raw === 'string' ? JSON.parse(raw) : raw; } catch { return ''; } if (!Array.isArray(prs)) return ''; const CONFLICT = new Set(['CONFLICTING', 'BEHIND', 'DIRTY']); const BOSUN_CREATED_LABEL = 'bosun-pr-bosun-created'; const readLabelNames = (pr) => Array.isArray(pr?.labels) ? pr.labels.map((entry) => typeof entry === 'string' ? entry : entry?.name).filter(Boolean) : []; const hasBosunCreatedText = (value) => { const text = String(value || ''); const taskIdMatch = text.match(/(?:Bosun-Task|VE-Task|Task-ID|task[_-]?id)[:\\s]+([a-zA-Z0-9_-]{4,64})/i); const hasLegacyTaskSignature = Boolean(taskIdMatch && text.toLowerCase().includes(`automated pr for task ${String(taskIdMatch[1] || '').trim().toLowerCase()}`)); return text.includes('') || /Bosun-Origin:\\s*created/i.test(text) || /auto-created by bosun/i.test(text) || hasLegacyTaskSignature; }; const isBosunCreated = (pr) => readLabelNames(pr).includes(BOSUN_CREATED_LABEL) || hasBosunCreatedText(pr?.body); /* Skip PRs already owned by the watchdog fix agent */ const pr = prs.find((p) => isBosunCreated(p) && CONFLICT.has(String(p?.mergeable || '').toUpperCase()) && !(p.labels || []).some((l) => l.name === 'bosun-needs-fix') ); return pr?.number ? String(pr.number) : '';})()", - "isExpression": true + "expression": "(() => { if ($data?.requireBosunCreatedPr !== true && String($data?.requireBosunCreatedPr || '').toLowerCase() !== 'true') return true; const raw = $ctx.getNodeOutput('load-pr-context')?.output || '{}'; let pr = {}; try { pr = typeof raw === 'string' ? JSON.parse(raw) : raw; } catch { return false; } const labels = Array.isArray(pr?.labels) ? pr.labels.map((entry) => typeof entry === 'string' ? entry : entry?.name).filter(Boolean) : []; return labels.includes('bosun-pr-bosun-created'); })()" }, "position": { "x": 400, - "y": 260 + "y": 230 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "target-branch", - "type": "action.set_variable", - "label": "Capture Conflict Branch", + "id": "check-ci", + "type": "validation.build", + "label": "Check CI Status", "config": { - "key": "targetPrBranch", - "value": "/* */ (() => { const raw = $ctx.getNodeOutput('list-prs')?.output || '[]'; let prs = []; try { prs = typeof raw === 'string' ? JSON.parse(raw) : raw; } catch { return ''; } if (!Array.isArray(prs)) return ''; const pr = prs.find((p) => String(p?.number || '') === String($data?.targetPrNumber || '')); return pr?.headRefName || '';})()", - "isExpression": true + "command": "gh pr checks {{prNumber}} --json name,state" }, "position": { - "x": 400, - "y": 340 + "x": 150, + "y": 320 }, "outputs": [ "default" ] }, { - "id": "target-base", - "type": "action.set_variable", - "label": "Capture Base Branch", + "id": "get-diff", + "type": "action.run_command", + "label": "Get Diff Stats", "config": { - "key": "targetPrBase", - "value": "/* */ (() => { const raw = $ctx.getNodeOutput('list-prs')?.output || '[]'; let prs = []; try { prs = typeof raw === 'string' ? JSON.parse(raw) : raw; } catch { return 'main'; } if (!Array.isArray(prs)) return 'main'; const pr = prs.find((p) => String(p?.number || '') === String($data?.targetPrNumber || '')); return pr?.baseRefName || 'main';})()", - "isExpression": true + "command": "git diff --stat {{baseBranch}}...HEAD" }, "position": { - "x": 400, - "y": 420 + "x": 650, + "y": 320 }, "outputs": [ "default" ] }, { - "id": "has-conflicts", + "id": "ci-passed", "type": "condition.expression", - "label": "Any Conflicts?", - "config": { - "expression": "Boolean($data?.targetPrNumber)" - }, - "position": { - "x": 400, - "y": 510 - }, - "outputs": [ - "default" - ] - }, - { - "id": "label-fixing", - "type": "action.run_command", - "label": "Label bosun-needs-fix", + "label": "CI Passed?", "config": { - "command": "gh pr edit {{targetPrNumber}} --add-label bosun-needs-fix", - "continueOnError": true + "expression": "(() => { const out = $ctx.getNodeOutput('check-ci'); if (!out || out.passed !== true) return false; let checks = []; try { checks = JSON.parse(out.output || '[]'); } catch { return false; } if (!Array.isArray(checks) || checks.length === 0) return false; const ok = new Set(['SUCCESS', 'PASSED', 'PASS', 'COMPLETED', 'NEUTRAL', 'SKIPPED']); return checks.every((c) => ok.has(String(c?.state || '').toUpperCase())); })()" }, "position": { - "x": 200, - "y": 650 + "x": 150, + "y": 470 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "resolve-conflicts", - "type": "action.run_agent", - "label": "Resolve Conflicts", + "id": "wait-for-ci", + "type": "action.delay", + "label": "Wait for CI", "config": { - "prompt": "You are a merge conflict resolution agent for PR #{{targetPrNumber}} on branch {{targetPrBranch}} (base: {{targetPrBase}}).\n\nSteps:\n1. git fetch origin\n2. git checkout {{targetPrBranch}}\n3. git rebase origin/{{targetPrBase}} (fall back to merge if rebase is too complex)\n4. Resolve all merge conflicts, preserving the intent of both sides.\n5. Run the repo's build and test suite to confirm nothing is broken.\n6. git push --force-with-lease origin {{targetPrBranch}}\n7. Remove the bosun-needs-fix label: gh pr edit {{targetPrNumber}} --remove-label bosun-needs-fix\n\nRules:\n- Only make minimal conflict-resolution changes. No unrelated refactors.\n- Do NOT merge, close, or approve the PR — the Bosun PR Watchdog handles merging.\n- Do NOT touch PRs that are not Bosun-created.", - "sdk": "auto", - "timeoutMs": 1800000, - "failOnError": true, - "maxRetries": "{{maxRetries}}", - "retryDelayMs": 30000, - "continueOnError": true + "ms": "{{ciTimeoutMs}}", + "seconds": "{{cooldownSec}}", + "reason": "CI is still running" }, "position": { - "x": 200, - "y": 800 + "x": 150, + "y": 620 }, "outputs": [ "default" ] }, { - "id": "notify-fixed", - "type": "notify.telegram", - "label": "Notify Resolved", + "id": "skip-untrusted-pr", + "type": "notify.log", + "label": "Skip Non-Bosun PR", "config": { - "message": ":settings: PR #{{targetPrNumber}} conflict resolved — awaiting CI and Watchdog review before merge", - "silent": true + "message": "PR Merge Strategy: skipping PR #{{prNumber}} because it is attached but not Bosun-created", + "level": "info" }, "position": { - "x": 200, - "y": 960 + "x": 730, + "y": 230 }, "outputs": [ "default" ] }, { - "id": "notify-failed", - "type": "notify.log", - "label": "Log Resolution Failed", + "id": "analyze", + "type": "action.run_agent", + "label": "Analyze Merge Strategy", "config": { - "message": "PR #{{targetPrNumber}} conflict could not be resolved cleanly — manual review required", - "level": "warn" + "prompt": "# PR Merge Strategy Analysis\n\nReview PR #{{prNumber}} on branch {{branch}}.\n\n## Decision Options:\n1. **merge_after_ci_pass** — Code looks correct, CI is green, merge it.\n2. **prompt** — Agent needs to do more work (provide specific instructions).\n3. **close_pr** — PR should be closed (bad approach, duplicate, etc.).\n4. **re_attempt** — Start task over with fresh agent.\n5. **manual_review** — Escalate to human reviewer.\n6. **wait** — CI still running, wait before deciding.\n7. **noop** — No action needed.\n\nRespond with JSON: { \"action\": \"\", \"reason\": \"\", \"message\": \"\" }", + "timeoutMs": 900000 }, "position": { - "x": 450, - "y": 800 + "x": 400, + "y": 350 }, "outputs": [ "default" ] }, { - "id": "skip", - "type": "notify.log", - "label": "No Conflicts", + "id": "parse-decision", + "type": "action.set_variable", + "label": "Parse Decision JSON", "config": { - "message": "PR Conflict Resolver: no unhandled Bosun-created conflicts found", - "level": "info" - }, - "position": { - "x": 620, - "y": 510 + "key": "decision", + "value": "(() => { const raw = $ctx.getNodeOutput('analyze')?.output || '{}'; if (raw && typeof raw === 'object') return raw; try { return JSON.parse(String(raw)); } catch { return { action: 'manual_review', reason: 'unparseable merge strategy response', message: String(raw || '') }; } })()", + "isExpression": true }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->list-prs", - "source": "trigger", - "target": "list-prs", - "sourcePort": "default" - }, - { - "id": "list-prs->target-pr", - "source": "list-prs", - "target": "target-pr", - "sourcePort": "default" - }, - { - "id": "target-pr->target-branch", - "source": "target-pr", - "target": "target-branch", - "sourcePort": "default" - }, - { - "id": "target-branch->target-base", - "source": "target-branch", - "target": "target-base", - "sourcePort": "default" - }, - { - "id": "target-base->has-conflicts", - "source": "target-base", - "target": "has-conflicts", - "sourcePort": "default" - }, - { - "id": "has-conflicts->label-fixing", - "source": "has-conflicts", - "target": "label-fixing", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "has-conflicts->skip", - "source": "has-conflicts", - "target": "skip", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "label-fixing->resolve-conflicts", - "source": "label-fixing", - "target": "resolve-conflicts", - "sourcePort": "default" - }, - { - "id": "resolve-conflicts->notify-fixed", - "source": "resolve-conflicts", - "target": "notify-fixed", - "sourcePort": "default", - "condition": "$ctx.getNodeOutput('resolve-conflicts')?.success === true" - }, - { - "id": "resolve-conflicts->notify-failed", - "source": "resolve-conflicts", - "target": "notify-failed", - "sourcePort": "default", - "condition": "$ctx.getNodeOutput('resolve-conflicts')?.success !== true" - } - ] - }, - { - "id": "template-pr-fix-single", - "name": "PR Fix Agent (Single PR)", - "description": "Fixes one Bosun-attached PR using a dedicated long-running agent (up to 2 hours). Dispatched by the PR Watchdog loop for each unclaimed PR needing repair. Programmatically clones the target repo and checks out the PR's HEAD branch into a temp worktree, runs the agent there, then pushes fixes back with --force-with-lease and cleans up. The agent NEVER manages git setup or push.", - "category": "github", - "categoryLabel": "GitHub", - "categoryIcon": ":git:", - "categoryOrder": 1, - "tags": [ - "github", - "pr", - "ci", - "fix", - "single-pr", - "session-tracked", - "worktree-managed" - ], - "nodeCount": 11, - "edgeCount": 10, - "recommended": false, - "enabled": true, - "trigger": "trigger.manual", - "variables": {}, - "metadata": { - "author": "bosun", - "version": 3, - "createdAt": "2026-03-29T00:00:00Z", - "templateVersion": "2.0.0", - "tags": [ - "github", - "pr", - "ci", - "fix", - "single-pr", - "session-tracked", - "worktree-managed" - ], - "notes": "Invoked by template-bosun-pr-watchdog via loop.for_each. Do not enable this template as a standalone scheduled workflow. v2.0: Programmatic worktree setup + push. Agent no longer manages git clone/push — prevents wrong-branch pushes and new-branch creation." - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.manual", - "label": "Start", - "config": {}, "position": { - "x": 100, - "y": 100 + "x": 400, + "y": 430 }, "outputs": [ "default" ] }, { - "id": "setup-task", - "type": "action.set_variable", - "label": "Setup PR Task ID", + "id": "decision-router", + "type": "condition.switch", + "label": "Route Decision", "config": { - "key": "taskId", - "value": "'pr-fix-' + String($data?.item?.taskId || (String($data?.item?.repo || '').replace(/[^a-z0-9]/gi, '-').replace(/-+/g,'-').replace(/^-|-$/g,'') + '-' + String($data?.item?.number || $data?.item?.n || '0'))).replace(/^-|-$/g, '')", - "isExpression": true + "value": "(() => { const action = String($data?.decision?.action || '').trim().toLowerCase(); return action || 'manual_review'; })()", + "cases": { + "merge_after_ci_pass": "merge", + "prompt": "prompt-agent", + "close_pr": "close", + "re_attempt": "retry", + "manual_review": "escalate", + "wait": "wait-for-ci", + "noop": "default" + } }, "position": { - "x": 380, - "y": 100 + "x": 400, + "y": 520 }, "outputs": [ + "merge", + "prompt-agent", + "close", + "retry", + "escalate", + "wait-for-ci", "default" ] }, { - "id": "setup-title", - "type": "action.set_variable", - "label": "Setup PR Task Title", + "id": "do-merge", + "type": "action.run_command", + "label": "Auto-Merge PR", "config": { - "key": "taskTitle", - "value": "'Fix PR #' + String($data?.item?.number || $data?.item?.n || '?') + ($data?.item?.title ? ' \\'' + String($data.item.title).slice(0,60) + '\\'' : '') + ' (' + String($data?.item?.repo || '') + ')'", - "isExpression": true + "command": "gh pr merge {{prNumber}} --auto --merge", + "failOnError": true, + "maxRetries": "{{maxRetries}}", + "retryDelayMs": 30000, + "continueOnError": true }, "position": { - "x": 660, - "y": 100 + "x": 100, + "y": 680 }, "outputs": [ "default" ] }, { - "id": "setup-claim-key", - "type": "action.set_variable", - "label": "Setup Claim Key", + "id": "do-prompt", + "type": "action.run_agent", + "label": "Prompt Agent", "config": { - "key": "claimKey", - "value": "String($data?.item?.claimKey || '')", - "isExpression": true + "prompt": "Continue working on the PR. Instructions: {{decision.message}}", + "timeoutMs": 3600000, + "failOnError": true, + "maxRetries": 2, + "retryDelayMs": 15000, + "continueOnError": true }, "position": { - "x": 940, - "y": 100 + "x": 300, + "y": 680 }, "outputs": [ "default" ] }, { - "id": "setup-worktree", + "id": "do-close", "type": "action.run_command", - "label": "Clone & Checkout PR Branch", + "label": "Close PR", "config": { - "command": "node", - "args": [ - "-e", - "const os=require('os'); const path=require('path'); const fs=require('fs'); const {execFileSync}=require('child_process'); const repo=String(process.env.PR_REPO||'').trim(); const branch=String(process.env.PR_BRANCH||'').trim(); const base=String(process.env.PR_BASE||'main').trim(); const num=String(process.env.PR_NUMBER||'0').trim(); if(!repo||!branch){console.log(JSON.stringify({error:'missing repo or branch',repo,branch}));process.exit(1);} const wt=path.join(os.tmpdir(),'bosun-prfix-'+num.replace(/[^0-9a-z]/gi,'-')); let reused=false; if(fs.existsSync(path.join(wt,'.git'))){ try{ const cur=execFileSync('git',['rev-parse','--abbrev-ref','HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(cur===branch){ execFileSync('git',['fetch','origin',branch],{cwd:wt,encoding:'utf8',timeout:120000,stdio:['ignore','pipe','pipe']}); execFileSync('git',['reset','--hard','origin/'+branch],{cwd:wt,encoding:'utf8',timeout:30000}); execFileSync('git',['clean','-fdx'],{cwd:wt,encoding:'utf8',timeout:30000}); try{execFileSync('git',['fetch','origin',base],{cwd:wt,encoding:'utf8',timeout:60000,stdio:['ignore','pipe','pipe']});}catch{} reused=true; }else{fs.rmSync(wt,{recursive:true,force:true});} }catch{try{fs.rmSync(wt,{recursive:true,force:true});}catch{}} } if(!reused){ if(fs.existsSync(wt)){try{fs.rmSync(wt,{recursive:true,force:true});}catch{}} execFileSync('gh',['repo','clone',repo,wt,'--','--branch',branch],{encoding:'utf8',timeout:300000,stdio:'inherit'}); execFileSync('git',['fetch','origin',branch],{cwd:wt,encoding:'utf8',timeout:120000,stdio:['ignore','pipe','pipe']}); execFileSync('git',['reset','--hard','origin/'+branch],{cwd:wt,encoding:'utf8',timeout:30000}); try{execFileSync('git',['fetch','origin',base],{cwd:wt,encoding:'utf8',timeout:60000,stdio:['ignore','pipe','pipe']});}catch{} } const finalBranch=execFileSync('git',['rev-parse','--abbrev-ref','HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(finalBranch!==branch){console.error('Branch mismatch: expected '+branch+' got '+finalBranch);process.exit(1);} console.log(JSON.stringify({worktreePath:wt,branch:finalBranch,base,repo,number:num,reused}));" - ], - "parseJson": true, + "command": "gh pr close {{prNumber}} --comment \"{{decision.reason}}\"", "failOnError": true, - "timeoutMs": 600000, - "env": { - "PR_REPO": "(()=>{ const i=$data?.item||{}; return String(i.repo||i.prDigest?.core?.repo||''); })()", - "PR_BRANCH": "(()=>{ const i=$data?.item||{}; return String(i.branch||i.prDigest?.core?.branch||''); })()", - "PR_BASE": "(()=>{ const i=$data?.item||{}; return String(i.base||i.baseBranch||i.prDigest?.core?.baseBranch||'main'); })()", - "PR_NUMBER": "(()=>{ const i=$data?.item||{}; return String(i.number||i.n||'0'); })()" - } + "maxRetries": 2, + "retryDelayMs": 15000, + "continueOnError": true }, "position": { - "x": 1220, - "y": 100 + "x": 500, + "y": 680 }, "outputs": [ "default" ] }, { - "id": "set-worktree-path", - "type": "action.set_variable", - "label": "Set Agent Working Directory", + "id": "do-retry", + "type": "action.run_agent", + "label": "Re-attempt Task", "config": { - "key": "worktreePath", - "value": "{{setup-worktree.output.worktreePath}}" + "prompt": "Start the task over from scratch. Previous attempt failed: {{decision.reason}}", + "timeoutMs": 3600000, + "failOnError": true, + "maxRetries": 2, + "retryDelayMs": 15000, + "continueOnError": true }, "position": { - "x": 1500, - "y": 100 + "x": 700, + "y": 680 }, "outputs": [ "default" ] }, { - "id": "setup-prompt", - "type": "action.set_variable", - "label": "Build Agent Prompt", + "id": "do-escalate", + "type": "notify.telegram", + "label": "Escalate to Human", "config": { - "key": "agentPrompt", - "value": "(()=>{\n const item = $data?.item || {};\n const prDigest = item.prDigest || {};\n const core = prDigest.core || {};\n const repo = String(item.repo || core.repo || '');\n const branch = String(item.branch || core.branch || '');\n const base = String(item.base || item.baseBranch || core.baseBranch || 'main');\n const number = String(item.number || item.n || '');\n const title = String(item.title || core.title || '');\n const reason = String(item.reason || '');\n const url = String(item.url || core.url || '');\n const mergeable = String(item.mergeable || core.mergeable || '');\n const failedChecks = Array.isArray(item.failedCheckNames) ? item.failedCheckNames : [];\n const failedJobs = Array.isArray(item.failedJobs) ? item.failedJobs : [];\n const annotations = Array.isArray(item.failedAnnotations) ? item.failedAnnotations : [];\n const logExcerpt = String(item.failedLogExcerpt || '').trim();\n const recentRuns = Array.isArray(item.recentRuns) ? item.recentRuns : [];\n const ciSummary = prDigest.ciSummary || {};\n const prBody = String(core.body || '').trim();\n const files = Array.isArray(prDigest.files) ? prDigest.files : [];\n const reviews = Array.isArray(prDigest.reviews) ? prDigest.reviews : [];\n const reviewComments = Array.isArray(prDigest.reviewComments) ? prDigest.reviewComments : [];\n const issueComments = Array.isArray(prDigest.issueComments) ? prDigest.issueComments : [];\n const allChecks = Array.isArray(prDigest.checks) ? prDigest.checks : [];\n let p = 'You are a Bosun PR repair agent. Your ONLY job is to fix this single PR.\\n\\n';\n p += '## PR Identity\\n\\n';\n p += '- **Repo**: ' + repo + '\\n';\n p += '- **PR Number**: #' + number + '\\n';\n p += '- **Title**: ' + title + '\\n';\n p += '- **URL**: ' + url + '\\n';\n p += '- **Head Branch**: `' + branch + '`\\n';\n p += '- **Base Branch**: `' + base + '`\\n';\n p += '- **Fix Reason**: `' + reason + '`\\n';\n if (mergeable) p += '- **Merge State**: ' + mergeable + '\\n';\n if (item.error) p += '- **Error**: ' + item.error + '\\n';\n if (item.rerunAttempts) p += '- **Rerun Attempts**: ' + item.rerunAttempts + '\\n';\n p += '\\n';\n if (failedChecks.length > 0) {\n p += '## Failed CI Checks\\n\\n';\n failedChecks.forEach(n => { p += '- `' + n + '`\\n'; });\n p += '\\n';\n }\n if (ciSummary.total > 0 || ciSummary.failing > 0) {\n p += '## CI Check Summary\\n\\n';\n p += 'Total: ' + (ciSummary.total||0) + ' | Failing: ' + (ciSummary.failing||0) + ' | Pending: ' + (ciSummary.pending||0) + ' | Passing: ' + (ciSummary.passing||0) + '\\n\\n';\n const failingAllChecks = allChecks.filter(c => ['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE'].includes(c.state));\n if (failingAllChecks.length > 0) {\n p += 'Failing checks:\\n';\n failingAllChecks.forEach(c => { p += '- `' + (c.name||c.workflow||'') + '` → ' + c.state + '\\n'; });\n p += '\\n';\n }\n }\n if (item.failedRun) {\n const run = item.failedRun;\n p += '## Failed Workflow Run\\n\\n';\n p += '- **Workflow**: ' + (run.workflowName || run.displayTitle || '') + '\\n';\n p += '- **Run ID**: ' + run.databaseId + '\\n';\n p += '- **Attempt**: ' + run.attempt + '\\n';\n p += '- **Conclusion**: ' + run.conclusion + '\\n';\n p += '- **URL**: ' + run.url + '\\n';\n p += '\\n';\n }\n if (failedJobs.length > 0) {\n p += '## Failed Jobs\\n\\n';\n failedJobs.slice(0,8).forEach(job => {\n p += '### ' + (job.name||'unknown') + '\\n';\n p += '- Conclusion: ' + job.conclusion + '\\n';\n if (job.url) p += '- URL: ' + job.url + '\\n';\n if (Array.isArray(job.failedSteps) && job.failedSteps.length > 0) {\n p += '- Failed steps: ' + job.failedSteps.map(s => '`' + s.name + '`').join(', ') + '\\n';\n }\n p += '\\n';\n });\n }\n if (annotations.length > 0) {\n p += '## Code Annotations (Errors / Warnings)\\n\\n';\n annotations.slice(0,6).forEach(annot => {\n if (Array.isArray(annot.annotations) && annot.annotations.length > 0) {\n p += '**Job: ' + (annot.name||'') + '**\\n';\n annot.annotations.slice(0,15).forEach(a => {\n p += '- `' + (a.path||'') + ':' + (a.startLine||'') + '` **' + (a.title||a.level||'error') + '**: ' + (a.message||'') + '\\n';\n });\n p += '\\n';\n }\n });\n }\n if (logExcerpt) {\n p += '## CI Log Excerpt (Failed Steps)\\n\\n```\\n' + logExcerpt.slice(0,10000) + '\\n```\\n\\n';\n }\n if (recentRuns.length > 0) {\n p += '## Recent CI Runs\\n\\n';\n recentRuns.forEach(r => { p += '- ' + (r.workflowName||r.displayTitle||'') + ' (' + r.conclusion + ') ' + (r.url||'') + '\\n'; });\n p += '\\n';\n }\n if (mergeable === 'CONFLICTING' || mergeable === 'DIRTY') {\n p += '## Merge Conflict\\n\\nThis PR has merge conflicts with base branch `' + base + '`. ';\n p += 'You must rebase or merge `origin/' + base + '` into `' + branch + '` and resolve all conflicts.\\n\\n';\n }\n if (prBody) {\n p += '## PR Description\\n\\n' + prBody.slice(0,2000) + '\\n\\n';\n }\n if (files.length > 0) {\n p += '## Changed Files (' + files.length + ')\\n\\n';\n files.slice(0,40).forEach(f => { p += '- `' + f.path + '` (+' + (f.additions||0) + '/-' + (f.deletions||0) + ')\\n'; });\n p += '\\n';\n }\n const reviewsWithBody = reviews.filter(r => r.body && r.body.trim());\n if (reviewsWithBody.length > 0 || reviewComments.length > 0) {\n p += '## Reviews & Inline Comments\\n\\n';\n reviewsWithBody.slice(0,5).forEach(r => {\n p += '**' + (r.author?.login||'reviewer') + '** (' + r.state + '): ' + r.body.slice(0,400) + '\\n\\n';\n });\n if (reviewComments.length > 0) {\n p += 'Inline comments:\\n';\n reviewComments.slice(0,12).forEach(c => {\n p += '- `' + (c.path||'') + ':' + (c.line||'') + '` (' + (c.author?.login||'') + '): ' + (c.body||'').slice(0,250) + '\\n';\n });\n p += '\\n';\n }\n }\n const issueCommentsWithBody = issueComments.filter(c => c.body && c.body.trim());\n if (issueCommentsWithBody.length > 0) {\n p += '## Issue Comments\\n\\n';\n issueCommentsWithBody.slice(0,5).forEach(c => {\n p += '**' + (c.author?.login||'user') + '**: ' + c.body.slice(0,300) + '\\n\\n';\n });\n }\n return p;\n})()", - "isExpression": true + "message": ":eye: PR #{{prNumber}} needs manual review: {{decision.reason}}" }, "position": { - "x": 1780, - "y": 100 + "x": 900, + "y": 680 }, "outputs": [ "default" ] }, { - "id": "fix-agent", - "type": "action.run_agent", - "label": "Fix PR (Dedicated Agent)", + "id": "action-succeeded", + "type": "condition.expression", + "label": "Action Succeeded?", "config": { - "prompt": "{{agentPrompt}}\n\n## Workspace\n\nYour working directory is already a git clone of the target repo, checked out on the PR's HEAD branch (`{{setup-worktree.output.branch}}`). The base branch (`origin/{{setup-worktree.output.base}}`) has been fetched and is available for merge/rebase operations.\n\n## CRITICAL RULES — READ BEFORE DOING ANYTHING\n\n1. **Do NOT clone or re-clone the repo** — you are already in it.\n2. **Do NOT create new branches.** Stay on the current branch.\n3. **Do NOT push.** The workflow pushes for you automatically after you finish.\n4. **Do NOT switch branches** with `git checkout` or `git switch`.\n5. **Do NOT run `cd` to change to a different directory.** Stay in the cwd.\n6. Fix ONLY the specific issue listed in the Fix Reason above.\n7. Do NOT merge, approve, or close the PR.\n8. Do NOT touch any other PRs or repos.\n\n## Fix Instructions\n\nUse the PR digest (CI diagnostics, log excerpts, annotations, reviews) above to identify the root cause and apply the MINIMAL fix.\n\n**By `reason` field:**\n- `merge_conflict_requires_code_resolution`: Run `git merge origin/{{setup-worktree.output.base}}`, resolve *all* conflicts in code, run available tests, then `git commit`.\n- `auto_rerun_limit_reached` / `ci_rerun_failed`: Study the failed log excerpt and job details to find the root cause. Fix the code, run tests, `git add` and `git commit`.\n- `no_rerunnable_failed_run_found`: Look at `gh pr checks` for this PR, inspect the failure, fix the issue, and commit.\n- `branch_update_failed` / `missing_repo_or_branch`: Inspect with `gh pr view`, diagnose, fix.\n\n**After fixing:** Commit with a clear message like `fix: resolve CI failure in `.\nThen remove the fix label:\n```\ngh pr edit {{setup-worktree.output.number}} --repo {{setup-worktree.output.repo}} --remove-label bosun-needs-fix\n```\n", - "sdk": "auto", - "timeoutMs": 7200000, - "maxRetries": 1, - "retryDelayMs": 60000, - "sessionRetries": 2, - "maxContinues": 3, - "continueOnSession": true, - "continueOnError": true, - "failOnError": false + "expression": "(() => { const action = String($data?.decision?.action || '').trim().toLowerCase(); if (action === 'merge_after_ci_pass') return $ctx.getNodeOutput('do-merge')?.success === true; if (action === 'prompt') return $ctx.getNodeOutput('do-prompt')?.success === true; if (action === 'close_pr') return $ctx.getNodeOutput('do-close')?.success === true; if (action === 're_attempt') return $ctx.getNodeOutput('do-retry')?.success === true; if (action === 'manual_review') return $ctx.getNodeOutput('do-escalate')?.sent !== false; return true; })()" }, "position": { - "x": 2060, - "y": 100 + "x": 480, + "y": 770 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "push-fixes", - "type": "action.run_command", - "label": "Push Fixes to PR Branch", + "id": "notify-action-failed", + "type": "notify.telegram", + "label": "Escalate Action Failure", "config": { - "command": "node", - "args": [ - "-e", - "const {execFileSync}=require('child_process'); const wt=String(process.env.WORKTREE_PATH||'').trim(); const branch=String(process.env.PR_BRANCH||'').trim(); const num=String(process.env.PR_NUMBER||'').trim(); if(!wt||!branch){console.log(JSON.stringify({pushed:false,reason:'missing_worktree_or_branch'}));process.exit(0);} const cur=execFileSync('git',['rev-parse','--abbrev-ref','HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(cur!==branch){console.log(JSON.stringify({pushed:false,reason:'wrong_branch',expected:branch,actual:cur}));process.exit(1);} const status=execFileSync('git',['status','--porcelain'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(status){ execFileSync('git',['add','-A'],{cwd:wt,encoding:'utf8',timeout:30000}); try{execFileSync('git',['commit','-m','bosun: commit remaining changes for PR #'+num],{cwd:wt,encoding:'utf8',timeout:30000});}catch{} } let hasDiff=false; try{const d=execFileSync('git',['rev-list','--count','origin/'+branch+'..HEAD'],{cwd:wt,encoding:'utf8',timeout:30000}).trim();hasDiff=Number(d)>0;} catch{hasDiff=true;} if(!hasDiff){console.log(JSON.stringify({pushed:false,reason:'no_new_commits'}));process.exit(0);} execFileSync('git',['push','--force-with-lease','origin','HEAD:'+branch],{cwd:wt,encoding:'utf8',timeout:120000,stdio:'inherit'}); console.log(JSON.stringify({pushed:true,branch:cur,commits:Number(execFileSync('git',['rev-list','--count','origin/'+branch+'..HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim()||0)}));" - ], - "parseJson": true, - "continueOnError": true, - "failOnError": false, - "timeoutMs": 300000, - "env": { - "WORKTREE_PATH": "{{setup-worktree.output.worktreePath}}", - "PR_BRANCH": "{{setup-worktree.output.branch}}", - "PR_NUMBER": "{{setup-worktree.output.number}}" - } + "message": ":alert: PR #{{prNumber}} workflow action failed after retries ({{decision.action}}). Reason: {{decision.reason}}. Manual follow-up required." }, "position": { - "x": 2340, - "y": 100 + "x": 760, + "y": 850 }, "outputs": [ "default" ] }, { - "id": "cleanup-worktree", - "type": "action.run_command", - "label": "Cleanup Temp Worktree", + "id": "notify-complete", + "type": "notify.log", + "label": "Log Result", "config": { - "command": "node", - "args": [ - "-e", - "const fs=require('fs'); const wt=String(process.env.WORKTREE_PATH||'').trim(); if(!wt){console.log(JSON.stringify({cleaned:false,reason:'no_path'}));process.exit(0);} try{fs.rmSync(wt,{recursive:true,force:true});console.log(JSON.stringify({cleaned:true,path:wt}));} catch(e){console.log(JSON.stringify({cleaned:false,error:String(e?.message||e)}));}" - ], - "continueOnError": true, - "failOnError": false, - "env": { - "WORKTREE_PATH": "{{setup-worktree.output.worktreePath}}" - } + "message": "PR #{{prNumber}} merge strategy: {{decision.action}} — {{decision.reason}}", + "level": "info" }, "position": { - "x": 2620, - "y": 100 + "x": 400, + "y": 850 }, "outputs": [ "default" ] }, { - "id": "release-claim", - "type": "action.run_command", - "label": "Release PR Claim", + "id": "end", + "type": "flow.end", + "label": "End Merge Strategy", "config": { - "command": "node", - "args": [ - "-e", - "const fs=require('fs'); const path=require('path'); const claimKey=String(process.env.PR_CLAIM_KEY||'').trim(); if(!claimKey){console.log(JSON.stringify({released:false,reason:'no_claim_key'}));process.exit(0);} const CLAIM_FILE=path.join(process.cwd(),'.cache','bosun','pr-fix-claims.json'); try{ if(!fs.existsSync(CLAIM_FILE)){console.log(JSON.stringify({released:false,reason:'no_claim_file'}));process.exit(0);} const data=JSON.parse(fs.readFileSync(CLAIM_FILE,'utf8')); if(data.claims&&data.claims[claimKey]){ delete data.claims[claimKey]; data.updatedAt=new Date().toISOString(); fs.writeFileSync(CLAIM_FILE,JSON.stringify(data,null,2),'utf8'); console.log(JSON.stringify({released:true,claimKey})); }else{ console.log(JSON.stringify({released:false,reason:'not_found',claimKey})); } }catch(e){ console.log(JSON.stringify({released:false,reason:'error',error:String(e?.message||e),claimKey})); }" - ], - "continueOnError": true, - "failOnError": false, - "env": { - "PR_CLAIM_KEY": "{{claimKey}}" + "status": "completed", + "message": "PR merge strategy flow completed for PR #{{prNumber}}", + "output": { + "prNumber": "{{prNumber}}", + "action": "{{decision.action}}" } }, "position": { - "x": 2900, - "y": 100 + "x": 400, + "y": 950 }, "outputs": [ "default" @@ -2481,71 +1961,192 @@ ], "edges": [ { - "id": "trigger->setup-task", + "id": "trigger->load-pr-context", "source": "trigger", - "target": "setup-task", - "sourcePort": "default" - }, - { - "id": "setup-task->setup-title", - "source": "setup-task", - "target": "setup-title", + "target": "load-pr-context", "sourcePort": "default" }, { - "id": "setup-title->setup-claim-key", - "source": "setup-title", - "target": "setup-claim-key", + "id": "load-pr-context->automation-eligible", + "source": "load-pr-context", + "target": "automation-eligible", "sourcePort": "default" }, { - "id": "setup-claim-key->setup-worktree", - "source": "setup-claim-key", - "target": "setup-worktree", - "sourcePort": "default" + "id": "automation-eligible->check-ci", + "source": "automation-eligible", + "target": "check-ci", + "sourcePort": "yes", + "condition": "$output?.result === true" }, { - "id": "setup-worktree->set-worktree-path", - "source": "setup-worktree", - "target": "set-worktree-path", + "id": "automation-eligible->get-diff", + "source": "automation-eligible", + "target": "get-diff", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "automation-eligible->skip-untrusted-pr", + "source": "automation-eligible", + "target": "skip-untrusted-pr", + "sourcePort": "no", + "condition": "$output?.result !== true" + }, + { + "id": "check-ci->ci-passed", + "source": "check-ci", + "target": "ci-passed", "sourcePort": "default" }, { - "id": "set-worktree-path->setup-prompt", - "source": "set-worktree-path", - "target": "setup-prompt", + "id": "ci-passed->wait-for-ci", + "source": "ci-passed", + "target": "wait-for-ci", + "sourcePort": "no", + "condition": "$output?.result !== true" + }, + { + "id": "ci-passed->analyze", + "source": "ci-passed", + "target": "analyze", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "get-diff->analyze", + "source": "get-diff", + "target": "analyze", "sourcePort": "default" }, { - "id": "setup-prompt->fix-agent", - "source": "setup-prompt", - "target": "fix-agent", + "id": "wait-for-ci->analyze", + "source": "wait-for-ci", + "target": "analyze", "sourcePort": "default" }, { - "id": "fix-agent->push-fixes", - "source": "fix-agent", - "target": "push-fixes", + "id": "analyze->parse-decision", + "source": "analyze", + "target": "parse-decision", "sourcePort": "default" }, { - "id": "push-fixes->cleanup-worktree", - "source": "push-fixes", - "target": "cleanup-worktree", + "id": "parse-decision->decision-router", + "source": "parse-decision", + "target": "decision-router", "sourcePort": "default" }, { - "id": "cleanup-worktree->release-claim", - "source": "cleanup-worktree", - "target": "release-claim", + "id": "decision-router->do-merge", + "source": "decision-router", + "target": "do-merge", + "sourcePort": "merge" + }, + { + "id": "decision-router->do-prompt", + "source": "decision-router", + "target": "do-prompt", + "sourcePort": "prompt-agent" + }, + { + "id": "decision-router->do-close", + "source": "decision-router", + "target": "do-close", + "sourcePort": "close" + }, + { + "id": "decision-router->do-retry", + "source": "decision-router", + "target": "do-retry", + "sourcePort": "retry" + }, + { + "id": "decision-router->do-escalate", + "source": "decision-router", + "target": "do-escalate", + "sourcePort": "escalate" + }, + { + "id": "decision-router->wait-for-ci", + "source": "decision-router", + "target": "wait-for-ci", + "sourcePort": "wait-for-ci" + }, + { + "id": "decision-router->notify-complete", + "source": "decision-router", + "target": "notify-complete", + "sourcePort": "default" + }, + { + "id": "do-merge->action-succeeded", + "source": "do-merge", + "target": "action-succeeded", + "sourcePort": "default" + }, + { + "id": "do-prompt->action-succeeded", + "source": "do-prompt", + "target": "action-succeeded", + "sourcePort": "default" + }, + { + "id": "do-close->action-succeeded", + "source": "do-close", + "target": "action-succeeded", + "sourcePort": "default" + }, + { + "id": "do-retry->action-succeeded", + "source": "do-retry", + "target": "action-succeeded", + "sourcePort": "default" + }, + { + "id": "do-escalate->action-succeeded", + "source": "do-escalate", + "target": "action-succeeded", + "sourcePort": "default" + }, + { + "id": "action-succeeded->notify-complete", + "source": "action-succeeded", + "target": "notify-complete", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "action-succeeded->notify-action-failed", + "source": "action-succeeded", + "target": "notify-action-failed", + "sourcePort": "no", + "condition": "$output?.result !== true" + }, + { + "id": "notify-action-failed->notify-complete", + "source": "notify-action-failed", + "target": "notify-complete", + "sourcePort": "default" + }, + { + "id": "notify-complete->end", + "source": "notify-complete", + "target": "end", + "sourcePort": "default" + }, + { + "id": "skip-untrusted-pr->end", + "source": "skip-untrusted-pr", + "target": "end", "sourcePort": "default" } ] }, { - "id": "template-pr-merge-strategy", - "name": "PR Merge Strategy", - "description": "Automated PR merge decision workflow with resilient retry paths. Analyzes CI + agent output, executes merge/prompt/close/re-attempt actions, and escalates gracefully when any branch action fails.", + "id": "template-pr-triage", + "name": "PR Triage & Labels", + "description": "Automatically triage incoming PRs: classify by size, detect breaking changes, add labels, and assign reviewers based on CODEOWNERS.", "category": "github", "categoryLabel": "GitHub", "categoryIcon": ":git:", @@ -2553,21 +2154,18 @@ "tags": [ "github", "pr", - "merge", - "strategy", + "triage", + "labels", "automation" ], - "nodeCount": 20, - "edgeCount": 29, + "nodeCount": 10, + "edgeCount": 12, "recommended": true, "enabled": true, "trigger": "trigger.pr_event", "variables": { - "ciTimeoutMs": 300000, - "cooldownSec": 60, - "maxRetries": 3, - "baseBranch": "main", - "requireBosunCreatedPr": true + "smallThreshold": 50, + "largeThreshold": 500 }, "metadata": { "author": "bosun", @@ -2577,35 +2175,28 @@ "tags": [ "github", "pr", - "merge", - "strategy", + "triage", + "labels", "automation" ], "replaces": { - "module": "merge-strategy.mjs", + "module": "github-reconciler.mjs", "functions": [ - "analyzeMergeStrategy", - "executeDecision", - "analyzeAndExecute" + "PR labeling and classification logic" ], "calledFrom": [ - "monitor.mjs:runMergeStrategyAnalysis" + "monitor.mjs:checkEpicBranches" ], - "description": "Replaces hardcoded merge-strategy analysis and decision execution. All 7 decision outcomes (merge, prompt, close, re_attempt, manual_review, wait, noop) are encoded as visual workflow branches instead of imperative code." + "description": "Replaces scattered PR classification logic with a structured triage workflow. Size classification, breaking change detection, and label assignment become explicit workflow nodes." } }, "nodes": [ { "id": "trigger", "type": "trigger.pr_event", - "label": "PR Ready for Merge Decision", + "label": "PR Opened", "config": { - "event": "review_requested", - "events": [ - "review_requested", - "approved", - "opened" - ] + "event": "opened" }, "position": { "x": 400, @@ -2616,333 +2207,371 @@ ] }, { - "id": "load-pr-context", + "id": "get-stats", "type": "action.run_command", - "label": "Load PR Context", + "label": "Get PR Stats", "config": { - "command": "gh pr view {{prNumber}} --json body,author,title,labels" + "command": "gh pr view {{prNumber}} --json additions,deletions,files,labels,title,body" }, "position": { "x": 400, - "y": 140 + "y": 180 }, "outputs": [ "default" ] }, { - "id": "automation-eligible", - "type": "condition.expression", - "label": "Bosun-Created PR?", + "id": "classify-size", + "type": "condition.switch", + "label": "Classify Size", "config": { - "expression": "/* auto-created by bosun */ (() => { if ($data?.requireBosunCreatedPr !== true && String($data?.requireBosunCreatedPr || '').toLowerCase() !== 'true') return true; const raw = $ctx.getNodeOutput('load-pr-context')?.output || '{}'; let pr = {}; try { pr = typeof raw === 'string' ? JSON.parse(raw) : raw; } catch { return false; } const labels = Array.isArray(pr?.labels) ? pr.labels.map((entry) => typeof entry === 'string' ? entry : entry?.name).filter(Boolean) : []; const body = String(pr?.body || ''); return labels.includes('bosun-pr-bosun-created') || body.includes('') || /auto-created by bosun/i.test(body); })()" + "value": "(() => { const raw = $ctx.getNodeOutput('get-stats')?.output || '{}'; let stats = {}; try { stats = typeof raw === 'string' ? JSON.parse(raw) : raw; } catch { stats = {}; } const delta = Number(stats?.additions || 0) + Number(stats?.deletions || 0); const small = Number($data?.smallThreshold || 50); const large = Number($data?.largeThreshold || 500); if (delta < small) return 'small'; if (delta > large) return 'large'; return 'medium'; })()", + "cases": { + "small": "small", + "medium": "medium", + "large": "large" + } }, "position": { "x": 400, - "y": 230 + "y": 330 }, "outputs": [ - "yes", - "no" + "small", + "medium", + "large", + "default" ] }, { - "id": "check-ci", - "type": "validation.build", - "label": "Check CI Status", + "id": "label-small", + "type": "action.run_command", + "label": "Label: Size/S", "config": { - "command": "gh pr checks {{prNumber}} --json name,state" + "command": "gh pr edit {{prNumber}} --add-label \"size/S\"" }, "position": { "x": 150, - "y": 320 + "y": 480 }, "outputs": [ "default" ] }, { - "id": "get-diff", + "id": "label-medium", "type": "action.run_command", - "label": "Get Diff Stats", + "label": "Label: Size/M", "config": { - "command": "git diff --stat {{baseBranch}}...HEAD" + "command": "gh pr edit {{prNumber}} --add-label \"size/M\"" }, "position": { - "x": 650, - "y": 320 + "x": 400, + "y": 480 }, "outputs": [ "default" ] }, { - "id": "ci-passed", - "type": "condition.expression", - "label": "CI Passed?", + "id": "label-large", + "type": "action.run_command", + "label": "Label: Size/L", "config": { - "expression": "(() => { const out = $ctx.getNodeOutput('check-ci'); if (!out || out.passed !== true) return false; let checks = []; try { checks = JSON.parse(out.output || '[]'); } catch { return false; } if (!Array.isArray(checks) || checks.length === 0) return false; const ok = new Set(['SUCCESS', 'PASSED', 'PASS', 'COMPLETED', 'NEUTRAL', 'SKIPPED']); return checks.every((c) => ok.has(String(c?.state || '').toUpperCase())); })()" + "command": "gh pr edit {{prNumber}} --add-label \"size/L\"" }, "position": { - "x": 150, - "y": 470 + "x": 650, + "y": 480 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "wait-for-ci", - "type": "action.delay", - "label": "Wait for CI", + "id": "detect-breaking", + "type": "condition.expression", + "label": "Detect Breaking Changes", "config": { - "ms": "{{ciTimeoutMs}}", - "seconds": "{{cooldownSec}}", - "reason": "CI is still running" + "expression": "(() => { const raw=$ctx.getNodeOutput('get-stats')?.output||'{}'; let stats={}; try{stats=typeof raw==='string'?JSON.parse(raw):raw;}catch{return false;} const title=String(stats?.title||'').toLowerCase(); const body=String(stats?.body||'').toLowerCase(); const files=Array.isArray(stats?.files)?stats.files.map((f)=>String(f?.path||f?.filename||f||'').toLowerCase()):[]; const text=title+'\\n'+body; const explicit=/\\bbreaking\\b|\\bbreaking change\\b|\\bmajor\\b|\\bbackward incompatible\\b/.test(text); const apiTouch=files.some((f)=>f.includes('api/')||f.includes('/proto/')||f.includes('openapi')||f.includes('schema')); const contractWords=/\\bremove\\b|\\brename\\b|\\bdeprecate\\b|\\bdrop\\b/.test(text); return explicit || (apiTouch && contractWords);})()" }, "position": { - "x": 150, - "y": 620 + "x": 400, + "y": 630 }, "outputs": [ "default" ] }, { - "id": "skip-untrusted-pr", - "type": "notify.log", - "label": "Skip Non-Bosun PR", + "id": "is-breaking", + "type": "condition.expression", + "label": "Breaking?", "config": { - "message": "PR Merge Strategy: skipping PR #{{prNumber}} because it is attached but not Bosun-created", - "level": "info" + "expression": "(() => { return $ctx.getNodeOutput('detect-breaking')?.result === true; })()" }, "position": { - "x": 730, - "y": 230 + "x": 400, + "y": 780 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "analyze", - "type": "action.run_agent", - "label": "Analyze Merge Strategy", + "id": "label-breaking", + "type": "action.run_command", + "label": "Label: Breaking", "config": { - "prompt": "# PR Merge Strategy Analysis\n\nReview PR #{{prNumber}} on branch {{branch}}.\n\n## Decision Options:\n1. **merge_after_ci_pass** — Code looks correct, CI is green, merge it.\n2. **prompt** — Agent needs to do more work (provide specific instructions).\n3. **close_pr** — PR should be closed (bad approach, duplicate, etc.).\n4. **re_attempt** — Start task over with fresh agent.\n5. **manual_review** — Escalate to human reviewer.\n6. **wait** — CI still running, wait before deciding.\n7. **noop** — No action needed.\n\nRespond with JSON: { \"action\": \"\", \"reason\": \"\", \"message\": \"\" }", - "timeoutMs": 900000 + "command": "gh pr edit {{prNumber}} --add-label \"breaking-change\"" }, "position": { - "x": 400, - "y": 350 + "x": 200, + "y": 920 }, "outputs": [ "default" ] }, { - "id": "parse-decision", - "type": "action.set_variable", - "label": "Parse Decision JSON", + "id": "done", + "type": "notify.log", + "label": "Triage Complete", "config": { - "key": "decision", - "value": "(() => { const raw = $ctx.getNodeOutput('analyze')?.output || '{}'; if (raw && typeof raw === 'object') return raw; try { return JSON.parse(String(raw)); } catch { return { action: 'manual_review', reason: 'unparseable merge strategy response', message: String(raw || '') }; } })()", - "isExpression": true + "message": "PR #{{prNumber}} triage workflow completed", + "level": "info" }, "position": { "x": 400, - "y": 430 + "y": 1050 }, "outputs": [ "default" ] + } + ], + "edges": [ + { + "id": "trigger->get-stats", + "source": "trigger", + "target": "get-stats", + "sourcePort": "default" }, { - "id": "decision-router", - "type": "condition.switch", - "label": "Route Decision", + "id": "get-stats->classify-size", + "source": "get-stats", + "target": "classify-size", + "sourcePort": "default" + }, + { + "id": "classify-size->label-small", + "source": "classify-size", + "target": "label-small", + "sourcePort": "small" + }, + { + "id": "classify-size->label-medium", + "source": "classify-size", + "target": "label-medium", + "sourcePort": "medium" + }, + { + "id": "classify-size->label-large", + "source": "classify-size", + "target": "label-large", + "sourcePort": "large" + }, + { + "id": "label-small->detect-breaking", + "source": "label-small", + "target": "detect-breaking", + "sourcePort": "default" + }, + { + "id": "label-medium->detect-breaking", + "source": "label-medium", + "target": "detect-breaking", + "sourcePort": "default" + }, + { + "id": "label-large->detect-breaking", + "source": "label-large", + "target": "detect-breaking", + "sourcePort": "default" + }, + { + "id": "detect-breaking->is-breaking", + "source": "detect-breaking", + "target": "is-breaking", + "sourcePort": "default" + }, + { + "id": "is-breaking->label-breaking", + "source": "is-breaking", + "target": "label-breaking", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "is-breaking->done", + "source": "is-breaking", + "target": "done", + "sourcePort": "no", + "condition": "$output?.result !== true" + }, + { + "id": "label-breaking->done", + "source": "label-breaking", + "target": "done", + "sourcePort": "default" + } + ] + }, + { + "id": "template-release-drafter", + "name": "Release Drafter", + "description": "Automatically generates release notes from merged PRs since the last tag. Groups changes by conventional commit type (features, fixes, refactors, etc.) and drafts a GitHub release.", + "category": "github", + "categoryLabel": "GitHub", + "categoryIcon": ":git:", + "categoryOrder": 1, + "tags": [ + "github", + "release", + "notes", + "changelog", + "draft" + ], + "nodeCount": 7, + "edgeCount": 6, + "recommended": false, + "enabled": true, + "trigger": "trigger.manual", + "variables": { + "baseBranch": "main", + "releasePrefix": "v" + }, + "metadata": { + "author": "bosun", + "version": 1, + "createdAt": "2025-02-25T00:00:00Z", + "templateVersion": "1.0.0", + "tags": [ + "github", + "release", + "notes", + "changelog", + "draft" + ] + }, + "nodes": [ + { + "id": "trigger", + "type": "trigger.manual", + "label": "Draft Release Notes", "config": { - "value": "(() => { const action = String($data?.decision?.action || '').trim().toLowerCase(); return action || 'manual_review'; })()", - "cases": { - "merge_after_ci_pass": "merge", - "prompt": "prompt-agent", - "close_pr": "close", - "re_attempt": "retry", - "manual_review": "escalate", - "wait": "wait-for-ci", - "noop": "default" - } + "description": "Generate release notes from merged PRs" }, "position": { "x": 400, - "y": 520 + "y": 50 }, "outputs": [ - "merge", - "prompt-agent", - "close", - "retry", - "escalate", - "wait-for-ci", "default" ] }, { - "id": "do-merge", + "id": "get-last-tag", "type": "action.run_command", - "label": "Auto-Merge PR", + "label": "Get Last Tag", "config": { - "command": "gh pr merge {{prNumber}} --auto --merge", - "failOnError": true, - "maxRetries": "{{maxRetries}}", - "retryDelayMs": 30000, - "continueOnError": true + "command": "git describe --tags --abbrev=0 2>/dev/null || echo '{{releasePrefix}}0.0.0'" }, "position": { - "x": 100, - "y": 680 + "x": 400, + "y": 180 }, "outputs": [ "default" ] }, { - "id": "do-prompt", - "type": "action.run_agent", - "label": "Prompt Agent", + "id": "list-prs", + "type": "action.run_command", + "label": "List Merged PRs", "config": { - "prompt": "Continue working on the PR. Instructions: {{decision.message}}", - "timeoutMs": 3600000, - "failOnError": true, - "maxRetries": 2, - "retryDelayMs": 15000, + "command": "gh pr list --state merged --base {{baseBranch}} --json number,title,labels,author,mergedAt --limit 100", "continueOnError": true }, "position": { - "x": 300, - "y": 680 + "x": 400, + "y": 310 }, "outputs": [ "default" ] }, { - "id": "do-close", + "id": "get-commits", "type": "action.run_command", - "label": "Close PR", + "label": "Get Commit Log", "config": { - "command": "gh pr close {{prNumber}} --comment \"{{decision.reason}}\"", - "failOnError": true, - "maxRetries": 2, - "retryDelayMs": 15000, - "continueOnError": true + "command": "git log $(git describe --tags --abbrev=0 2>/dev/null || echo HEAD~50)..HEAD --oneline --no-merges" }, "position": { - "x": 500, - "y": 680 + "x": 400, + "y": 440 }, "outputs": [ "default" ] }, { - "id": "do-retry", + "id": "draft-notes", "type": "action.run_agent", - "label": "Re-attempt Task", + "label": "Draft Release Notes", "config": { - "prompt": "Start the task over from scratch. Previous attempt failed: {{decision.reason}}", - "timeoutMs": 3600000, - "failOnError": true, - "maxRetries": 2, - "retryDelayMs": 15000, - "continueOnError": true + "prompt": "# Generate Release Notes\n\n## Merged PRs (JSON)\n{{prList}}\n\n## Commit Log\n{{commitLog}}\n\n## Last Tag\n{{lastTag}}\n\nGenerate professional release notes in the following format:\n\n# What's Changed\n\n## :rocket: Features\n- [list feat: commits with PR references]\n\n## :bug: Bug Fixes\n- [list fix: commits with PR references]\n\n## :settings: Improvements\n- [list refactor/perf/style commits]\n\n## :u1f4da: Documentation\n- [list docs: commits]\n\n## :hammer: Internal\n- [list chore/ci/build commits]\n\nOmit empty sections. Include contributor attribution. Be concise.", + "sdk": "auto", + "timeoutMs": 600000 }, "position": { - "x": 700, - "y": 680 + "x": 400, + "y": 590 }, "outputs": [ "default" ] }, { - "id": "do-escalate", - "type": "notify.telegram", - "label": "Escalate to Human", - "config": { - "message": ":eye: PR #{{prNumber}} needs manual review: {{decision.reason}}" - }, - "position": { - "x": 900, - "y": 680 - }, - "outputs": [ - "default" - ] - }, - { - "id": "action-succeeded", - "type": "condition.expression", - "label": "Action Succeeded?", - "config": { - "expression": "(() => { const action = String($data?.decision?.action || '').trim().toLowerCase(); if (action === 'merge_after_ci_pass') return $ctx.getNodeOutput('do-merge')?.success === true; if (action === 'prompt') return $ctx.getNodeOutput('do-prompt')?.success === true; if (action === 'close_pr') return $ctx.getNodeOutput('do-close')?.success === true; if (action === 're_attempt') return $ctx.getNodeOutput('do-retry')?.success === true; if (action === 'manual_review') return $ctx.getNodeOutput('do-escalate')?.sent !== false; return true; })()" - }, - "position": { - "x": 480, - "y": 770 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "notify-action-failed", - "type": "notify.telegram", - "label": "Escalate Action Failure", + "id": "save-draft", + "type": "action.write_file", + "label": "Save Draft", "config": { - "message": ":alert: PR #{{prNumber}} workflow action failed after retries ({{decision.action}}). Reason: {{decision.reason}}. Manual follow-up required." + "path": "RELEASE_DRAFT.md", + "content": "{{releaseNotes}}" }, "position": { - "x": 760, - "y": 850 + "x": 400, + "y": 740 }, "outputs": [ "default" ] }, { - "id": "notify-complete", + "id": "notify-ready", "type": "notify.log", - "label": "Log Result", + "label": "Draft Ready", "config": { - "message": "PR #{{prNumber}} merge strategy: {{decision.action}} — {{decision.reason}}", + "message": "Release notes draft saved to RELEASE_DRAFT.md — review and publish when ready", "level": "info" }, "position": { "x": 400, - "y": 850 - }, - "outputs": [ - "default" - ] - }, - { - "id": "end", - "type": "flow.end", - "label": "End Merge Strategy", - "config": { - "status": "completed", - "message": "PR merge strategy flow completed for PR #{{prNumber}}", - "output": { - "prNumber": "{{prNumber}}", - "action": "{{decision.action}}" - } - }, - "position": { - "x": 400, - "y": 950 + "y": 870 }, "outputs": [ "default" @@ -2951,450 +2580,175 @@ ], "edges": [ { - "id": "trigger->load-pr-context", + "id": "trigger->get-last-tag", "source": "trigger", - "target": "load-pr-context", - "sourcePort": "default" - }, - { - "id": "load-pr-context->automation-eligible", - "source": "load-pr-context", - "target": "automation-eligible", - "sourcePort": "default" - }, - { - "id": "automation-eligible->check-ci", - "source": "automation-eligible", - "target": "check-ci", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "automation-eligible->get-diff", - "source": "automation-eligible", - "target": "get-diff", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "automation-eligible->skip-untrusted-pr", - "source": "automation-eligible", - "target": "skip-untrusted-pr", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "check-ci->ci-passed", - "source": "check-ci", - "target": "ci-passed", - "sourcePort": "default" - }, - { - "id": "ci-passed->wait-for-ci", - "source": "ci-passed", - "target": "wait-for-ci", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "ci-passed->analyze", - "source": "ci-passed", - "target": "analyze", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "get-diff->analyze", - "source": "get-diff", - "target": "analyze", - "sourcePort": "default" - }, - { - "id": "wait-for-ci->analyze", - "source": "wait-for-ci", - "target": "analyze", - "sourcePort": "default" - }, - { - "id": "analyze->parse-decision", - "source": "analyze", - "target": "parse-decision", - "sourcePort": "default" - }, - { - "id": "parse-decision->decision-router", - "source": "parse-decision", - "target": "decision-router", - "sourcePort": "default" - }, - { - "id": "decision-router->do-merge", - "source": "decision-router", - "target": "do-merge", - "sourcePort": "merge" - }, - { - "id": "decision-router->do-prompt", - "source": "decision-router", - "target": "do-prompt", - "sourcePort": "prompt-agent" - }, - { - "id": "decision-router->do-close", - "source": "decision-router", - "target": "do-close", - "sourcePort": "close" - }, - { - "id": "decision-router->do-retry", - "source": "decision-router", - "target": "do-retry", - "sourcePort": "retry" - }, - { - "id": "decision-router->do-escalate", - "source": "decision-router", - "target": "do-escalate", - "sourcePort": "escalate" - }, - { - "id": "decision-router->wait-for-ci", - "source": "decision-router", - "target": "wait-for-ci", - "sourcePort": "wait-for-ci" - }, - { - "id": "decision-router->notify-complete", - "source": "decision-router", - "target": "notify-complete", - "sourcePort": "default" - }, - { - "id": "do-merge->action-succeeded", - "source": "do-merge", - "target": "action-succeeded", - "sourcePort": "default" - }, - { - "id": "do-prompt->action-succeeded", - "source": "do-prompt", - "target": "action-succeeded", - "sourcePort": "default" - }, - { - "id": "do-close->action-succeeded", - "source": "do-close", - "target": "action-succeeded", + "target": "get-last-tag", "sourcePort": "default" }, { - "id": "do-retry->action-succeeded", - "source": "do-retry", - "target": "action-succeeded", + "id": "get-last-tag->list-prs", + "source": "get-last-tag", + "target": "list-prs", "sourcePort": "default" }, { - "id": "do-escalate->action-succeeded", - "source": "do-escalate", - "target": "action-succeeded", + "id": "list-prs->get-commits", + "source": "list-prs", + "target": "get-commits", "sourcePort": "default" }, { - "id": "action-succeeded->notify-complete", - "source": "action-succeeded", - "target": "notify-complete", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "action-succeeded->notify-action-failed", - "source": "action-succeeded", - "target": "notify-action-failed", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "notify-action-failed->notify-complete", - "source": "notify-action-failed", - "target": "notify-complete", + "id": "get-commits->draft-notes", + "source": "get-commits", + "target": "draft-notes", "sourcePort": "default" }, { - "id": "notify-complete->end", - "source": "notify-complete", - "target": "end", + "id": "draft-notes->save-draft", + "source": "draft-notes", + "target": "save-draft", "sourcePort": "default" }, { - "id": "skip-untrusted-pr->end", - "source": "skip-untrusted-pr", - "target": "end", + "id": "save-draft->notify-ready", + "source": "save-draft", + "target": "notify-ready", "sourcePort": "default" } ] }, { - "id": "template-pr-security-fix-single", - "name": "PR Security Fix Agent (Single PR)", - "description": "Fixes one Bosun-attached PR with CodeQL or code-scanning failures using a dedicated long-running agent (up to 2 hours). Programmatically clones the target repo and checks out the PR's HEAD branch into a temp worktree, runs the agent there, then pushes fixes back with --force-with-lease. The agent NEVER manages git setup or push.", + "id": "template-review-agent", + "name": "Review Agent", + "description": "Automatically runs code review when a PR is opened or updated. Checks build, tests, and code quality, then posts review comments.", "category": "github", "categoryLabel": "GitHub", "categoryIcon": ":git:", "categoryOrder": 1, "tags": [ - "github", + "review", "pr", - "security", - "codeql", - "fix", - "single-pr", - "session-tracked", - "worktree-managed" + "automation" ], - "nodeCount": 11, - "edgeCount": 10, - "recommended": false, + "nodeCount": 6, + "edgeCount": 6, + "recommended": true, "enabled": true, - "trigger": "trigger.manual", + "trigger": "trigger.pr_event", "variables": {}, "metadata": { "author": "bosun", - "version": 2, - "createdAt": "2026-03-30T00:00:00Z", - "templateVersion": "2.0.0", + "version": 1, + "createdAt": "2025-02-24T00:00:00Z", + "templateVersion": "1.0.0", "tags": [ - "github", + "review", "pr", - "security", - "codeql", - "fix", - "single-pr", - "session-tracked", - "worktree-managed" + "automation" ], - "notes": "Invoked by template-bosun-pr-watchdog via loop.for_each for security failures. Do not enable as standalone. v2.0: Programmatic worktree + push." + "replaces": { + "module": "review-agent.mjs", + "functions": [ + "ReviewAgent.runReview", + "createReviewAgent" + ], + "calledFrom": [ + "monitor.mjs:checkEpicBranches" + ], + "description": "Replaces the ReviewAgent class with a visual workflow. Build, test, and AI review steps run in parallel with results aggregated." + } }, "nodes": [ { "id": "trigger", - "type": "trigger.manual", - "label": "Start", - "config": {}, - "position": { - "x": 100, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "setup-task", - "type": "action.set_variable", - "label": "Setup Security PR Task ID", - "config": { - "key": "taskId", - "value": "'pr-secfix-' + String($data?.item?.taskId || (String($data?.item?.repo || '').replace(/[^a-z0-9]/gi, '-').replace(/-+/g,'-').replace(/^-|-$/g,'') + '-' + String($data?.item?.number || $data?.item?.n || '0'))).replace(/^-|-$/g, '')", - "isExpression": true - }, - "position": { - "x": 380, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "setup-title", - "type": "action.set_variable", - "label": "Setup Security PR Task Title", - "config": { - "key": "taskTitle", - "value": "'Security Fix PR #' + String($data?.item?.number || $data?.item?.n || '?') + ' (' + String($data?.item?.repo || '') + ')'", - "isExpression": true - }, - "position": { - "x": 660, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "setup-claim-key", - "type": "action.set_variable", - "label": "Setup Claim Key", - "config": { - "key": "claimKey", - "value": "String($data?.item?.claimKey || '')", - "isExpression": true - }, - "position": { - "x": 940, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "setup-worktree", - "type": "action.run_command", - "label": "Clone & Checkout PR Branch", + "type": "trigger.pr_event", + "label": "PR Opened/Updated", "config": { - "command": "node", - "args": [ - "-e", - "const os=require('os'); const path=require('path'); const fs=require('fs'); const {execFileSync}=require('child_process'); const repo=String(process.env.PR_REPO||'').trim(); const branch=String(process.env.PR_BRANCH||'').trim(); const base=String(process.env.PR_BASE||'main').trim(); const num=String(process.env.PR_NUMBER||'0').trim(); if(!repo||!branch){console.log(JSON.stringify({error:'missing repo or branch',repo,branch}));process.exit(1);} const wt=path.join(os.tmpdir(),'bosun-secfix-'+num.replace(/[^0-9a-z]/gi,'-')); let reused=false; if(fs.existsSync(path.join(wt,'.git'))){ try{ const cur=execFileSync('git',['rev-parse','--abbrev-ref','HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(cur===branch){ execFileSync('git',['fetch','origin',branch],{cwd:wt,encoding:'utf8',timeout:120000,stdio:['ignore','pipe','pipe']}); execFileSync('git',['reset','--hard','origin/'+branch],{cwd:wt,encoding:'utf8',timeout:30000}); execFileSync('git',['clean','-fdx'],{cwd:wt,encoding:'utf8',timeout:30000}); try{execFileSync('git',['fetch','origin',base],{cwd:wt,encoding:'utf8',timeout:60000,stdio:['ignore','pipe','pipe']});}catch{} reused=true; }else{fs.rmSync(wt,{recursive:true,force:true});} }catch{try{fs.rmSync(wt,{recursive:true,force:true});}catch{}} } if(!reused){ if(fs.existsSync(wt)){try{fs.rmSync(wt,{recursive:true,force:true});}catch{}} execFileSync('gh',['repo','clone',repo,wt,'--','--branch',branch],{encoding:'utf8',timeout:300000,stdio:'inherit'}); execFileSync('git',['fetch','origin',branch],{cwd:wt,encoding:'utf8',timeout:120000,stdio:['ignore','pipe','pipe']}); execFileSync('git',['reset','--hard','origin/'+branch],{cwd:wt,encoding:'utf8',timeout:30000}); try{execFileSync('git',['fetch','origin',base],{cwd:wt,encoding:'utf8',timeout:60000,stdio:['ignore','pipe','pipe']});}catch{} } const finalBranch=execFileSync('git',['rev-parse','--abbrev-ref','HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(finalBranch!==branch){console.error('Branch mismatch: expected '+branch+' got '+finalBranch);process.exit(1);} console.log(JSON.stringify({worktreePath:wt,branch:finalBranch,base,repo,number:num,reused}));" - ], - "parseJson": true, - "failOnError": true, - "timeoutMs": 600000, - "env": { - "PR_REPO": "(()=>{ const i=$data?.item||{}; return String(i.repo||i.prDigest?.core?.repo||''); })()", - "PR_BRANCH": "(()=>{ const i=$data?.item||{}; return String(i.branch||i.prDigest?.core?.branch||''); })()", - "PR_BASE": "(()=>{ const i=$data?.item||{}; return String(i.base||i.baseBranch||i.prDigest?.core?.baseBranch||'main'); })()", - "PR_NUMBER": "(()=>{ const i=$data?.item||{}; return String(i.number||i.n||'0'); })()" - } + "event": "opened" }, "position": { - "x": 1220, - "y": 100 + "x": 400, + "y": 50 }, "outputs": [ "default" ] }, { - "id": "set-worktree-path", - "type": "action.set_variable", - "label": "Set Agent Working Directory", + "id": "run-build", + "type": "validation.build", + "label": "Run Build", "config": { - "key": "worktreePath", - "value": "{{setup-worktree.output.worktreePath}}" + "command": "npm run build" }, "position": { - "x": 1500, - "y": 100 + "x": 200, + "y": 200 }, "outputs": [ "default" ] }, { - "id": "setup-prompt", - "type": "action.set_variable", - "label": "Build Security Agent Prompt", + "id": "run-tests", + "type": "validation.tests", + "label": "Run Tests", "config": { - "key": "agentPrompt", - "value": "(()=>{\n const item = $data?.item || {};\n const prDigest = item.prDigest || {};\n const core = prDigest.core || {};\n const repo = String(item.repo || core.repo || '');\n const branch = String(item.branch || core.branch || '');\n const base = String(item.base || item.baseBranch || core.baseBranch || 'main');\n const number = String(item.number || item.n || '');\n const title = String(item.title || core.title || '');\n const url = String(item.url || core.url || '');\n const securityChecks = Array.isArray(item.securityCheckNames) ? item.securityCheckNames : [];\n const failedChecks = Array.isArray(item.failedCheckNames) ? item.failedCheckNames : [];\n const alerts = Array.isArray(item.alerts) ? item.alerts : [];\n const fetchError = String(item.fetchError || '').trim();\n const prBody = String(core.body || '').trim();\n const files = Array.isArray(prDigest.files) ? prDigest.files : [];\n const reviews = Array.isArray(prDigest.reviews) ? prDigest.reviews : [];\n const reviewComments = Array.isArray(prDigest.reviewComments) ? prDigest.reviewComments : [];\n const allChecks = Array.isArray(prDigest.checks) ? prDigest.checks : [];\n let p = 'You are a Bosun PR **security remediation** agent. Fix ONLY the security/CodeQL findings on this single PR.\\n\\n';\n p += '## PR Identity\\n\\n';\n p += '- **Repo**: ' + repo + '\\n';\n p += '- **PR Number**: #' + number + '\\n';\n p += '- **Title**: ' + title + '\\n';\n p += '- **URL**: ' + url + '\\n';\n p += '- **Head Branch**: `' + branch + '`\\n';\n p += '- **Base Branch**: `' + base + '`\\n\\n';\n if (securityChecks.length > 0) {\n p += '## Failed Security Checks\\n\\n';\n securityChecks.forEach(n => { p += '- `' + n + '`\\n'; });\n p += '\\n';\n }\n if (alerts.length > 0) {\n p += '## Code Scanning Alerts\\n\\n';\n alerts.forEach(a => {\n p += '### Alert #' + (a.number||'?') + ' — ' + (a.ruleName||a.ruleId||'unknown rule') + '\\n';\n p += '- **Severity**: ' + (a.securitySeverity||a.severity||'unknown') + '\\n';\n p += '- **Tool**: ' + (a.tool||'unknown') + '\\n';\n p += '- **File**: `' + (a.path||'') + ':' + (a.startLine||'') + '`\\n';\n if (a.url) p += '- **URL**: ' + a.url + '\\n';\n p += '\\n';\n });\n }\n if (fetchError) {\n p += '## Alert Fetch Error\\n\\n' + fetchError + '\\n\\n';\n p += 'Alert fetch failed. Inspect the PR checks and source code directly to identify the security issue.\\n\\n';\n }\n if (prBody) {\n p += '## PR Description\\n\\n' + prBody.slice(0,2000) + '\\n\\n';\n }\n if (files.length > 0) {\n p += '## Changed Files (' + files.length + ')\\n\\n';\n files.slice(0,40).forEach(f => { p += '- `' + f.path + '` (+' + (f.additions||0) + '/-' + (f.deletions||0) + ')\\n'; });\n p += '\\n';\n }\n return p;\n})()", - "isExpression": true + "command": "npm test" }, "position": { - "x": 1780, - "y": 100 + "x": 600, + "y": 200 }, "outputs": [ "default" ] }, { - "id": "fix-agent", + "id": "run-review", "type": "action.run_agent", - "label": "Fix Security Issue (Dedicated Agent)", - "config": { - "prompt": "{{agentPrompt}}\n\n## Workspace\n\nYour working directory is already a git clone of the target repo, checked out on the PR's HEAD branch (`{{setup-worktree.output.branch}}`). The base branch (`origin/{{setup-worktree.output.base}}`) has been fetched.\n\n## CRITICAL RULES — READ BEFORE DOING ANYTHING\n\n1. **Do NOT clone or re-clone the repo** — you are already in it.\n2. **Do NOT create new branches.** Stay on the current branch.\n3. **Do NOT push.** The workflow pushes for you automatically after you finish.\n4. **Do NOT switch branches** with `git checkout` or `git switch`.\n5. **Do NOT run `cd` to change to a different directory.** Stay in the cwd.\n6. Fix ONLY the listed security/CodeQL findings. No unrelated changes.\n7. Do NOT merge, approve, or close the PR.\n8. Do NOT touch any other PRs or repos.\n\n## Fix Instructions\n\n1. Read each alert's file and line number from the context above.\n2. Understand the security finding (SQL injection, XSS, path traversal, etc.).\n3. Apply the MINIMAL code change that resolves the finding.\n4. If alerts could not be fetched, run:\n `gh api repos/{{setup-worktree.output.repo}}/code-scanning/alerts --jq '.[] | select(.state==\"open\")' -X GET`\n5. Run any available tests to validate the fix.\n6. `git add` and `git commit` with a clear message referencing the security finding.\n\n**After fixing:** Remove the fix label:\n```\ngh pr edit {{setup-worktree.output.number}} --repo {{setup-worktree.output.repo}} --remove-label bosun-needs-fix\n```\n", - "sdk": "auto", - "timeoutMs": 7200000, - "maxRetries": 1, - "retryDelayMs": 60000, - "sessionRetries": 2, - "maxContinues": 3, - "continueOnSession": true, - "continueOnError": true, - "failOnError": false - }, - "position": { - "x": 2060, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "push-fixes", - "type": "action.run_command", - "label": "Push Fixes to PR Branch", + "label": "Agent Review", "config": { - "command": "node", - "args": [ - "-e", - "const {execFileSync}=require('child_process'); const wt=String(process.env.WORKTREE_PATH||'').trim(); const branch=String(process.env.PR_BRANCH||'').trim(); const num=String(process.env.PR_NUMBER||'').trim(); if(!wt||!branch){console.log(JSON.stringify({pushed:false,reason:'missing_worktree_or_branch'}));process.exit(0);} const cur=execFileSync('git',['rev-parse','--abbrev-ref','HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(cur!==branch){console.log(JSON.stringify({pushed:false,reason:'wrong_branch',expected:branch,actual:cur}));process.exit(1);} const status=execFileSync('git',['status','--porcelain'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(status){ execFileSync('git',['add','-A'],{cwd:wt,encoding:'utf8',timeout:30000}); try{execFileSync('git',['commit','-m','bosun: commit security fix changes for PR #'+num],{cwd:wt,encoding:'utf8',timeout:30000});}catch{} } let hasDiff=false; try{const d=execFileSync('git',['rev-list','--count','origin/'+branch+'..HEAD'],{cwd:wt,encoding:'utf8',timeout:30000}).trim();hasDiff=Number(d)>0;} catch{hasDiff=true;} if(!hasDiff){console.log(JSON.stringify({pushed:false,reason:'no_new_commits'}));process.exit(0);} execFileSync('git',['push','--force-with-lease','origin','HEAD:'+branch],{cwd:wt,encoding:'utf8',timeout:120000,stdio:'inherit'}); console.log(JSON.stringify({pushed:true,branch:cur}));" - ], - "parseJson": true, - "continueOnError": true, - "failOnError": false, - "timeoutMs": 300000, - "env": { - "WORKTREE_PATH": "{{setup-worktree.output.worktreePath}}", - "PR_BRANCH": "{{setup-worktree.output.branch}}", - "PR_NUMBER": "{{setup-worktree.output.number}}" - } + "prompt": "# Code Review\n\nReview the changes in the current branch. Check for:\n1. Code quality and best practices\n2. Potential bugs or edge cases\n3. Test coverage for new features\n4. Documentation updates if needed\n\nProvide a structured review with specific file:line references.", + "timeoutMs": 900000 }, "position": { - "x": 2340, - "y": 100 + "x": 400, + "y": 350 }, "outputs": [ "default" ] }, { - "id": "cleanup-worktree", - "type": "action.run_command", - "label": "Cleanup Temp Worktree", + "id": "aggregate", + "type": "transform.aggregate", + "label": "Collect Results", "config": { - "command": "node", - "args": [ - "-e", - "const fs=require('fs'); const wt=String(process.env.WORKTREE_PATH||'').trim(); if(!wt){console.log(JSON.stringify({cleaned:false,reason:'no_path'}));process.exit(0);} try{fs.rmSync(wt,{recursive:true,force:true});console.log(JSON.stringify({cleaned:true,path:wt}));} catch(e){console.log(JSON.stringify({cleaned:false,error:String(e?.message||e)}));}" - ], - "continueOnError": true, - "failOnError": false, - "env": { - "WORKTREE_PATH": "{{setup-worktree.output.worktreePath}}" - } + "sources": [ + "run-build", + "run-tests", + "run-review" + ] }, "position": { - "x": 2620, - "y": 100 + "x": 400, + "y": 500 }, "outputs": [ "default" ] }, { - "id": "release-claim", - "type": "action.run_command", - "label": "Release Security PR Claim", + "id": "notify", + "type": "notify.telegram", + "label": "Post Review", "config": { - "command": "node", - "args": [ - "-e", - "const fs=require('fs'); const path=require('path'); const claimKey=String(process.env.PR_CLAIM_KEY||'').trim(); if(!claimKey){console.log(JSON.stringify({released:false,reason:'no_claim_key'}));process.exit(0);} const CLAIM_FILE=path.join(process.cwd(),'.cache','bosun','pr-security-fix-claims.json'); try{ if(!fs.existsSync(CLAIM_FILE)){console.log(JSON.stringify({released:false,reason:'no_claim_file'}));process.exit(0);} const data=JSON.parse(fs.readFileSync(CLAIM_FILE,'utf8')); if(data.claims&&data.claims[claimKey]){ delete data.claims[claimKey]; data.updatedAt=new Date().toISOString(); fs.writeFileSync(CLAIM_FILE,JSON.stringify(data,null,2),'utf8'); console.log(JSON.stringify({released:true,claimKey})); }else{ console.log(JSON.stringify({released:false,reason:'not_found',claimKey})); } }catch(e){ console.log(JSON.stringify({released:false,reason:'error',error:String(e?.message||e),claimKey})); }" - ], - "continueOnError": true, - "failOnError": false, - "env": { - "PR_CLAIM_KEY": "{{claimKey}}" - } + "message": ":edit: PR review complete for {{branch}}" }, "position": { - "x": 2900, - "y": 100 + "x": 400, + "y": 640 }, "outputs": [ "default" @@ -3403,121 +2757,111 @@ ], "edges": [ { - "id": "trigger->setup-task", + "id": "trigger->run-build", "source": "trigger", - "target": "setup-task", - "sourcePort": "default" - }, - { - "id": "setup-task->setup-title", - "source": "setup-task", - "target": "setup-title", - "sourcePort": "default" - }, - { - "id": "setup-title->setup-claim-key", - "source": "setup-title", - "target": "setup-claim-key", - "sourcePort": "default" - }, - { - "id": "setup-claim-key->setup-worktree", - "source": "setup-claim-key", - "target": "setup-worktree", - "sourcePort": "default" - }, - { - "id": "setup-worktree->set-worktree-path", - "source": "setup-worktree", - "target": "set-worktree-path", + "target": "run-build", "sourcePort": "default" }, { - "id": "set-worktree-path->setup-prompt", - "source": "set-worktree-path", - "target": "setup-prompt", + "id": "trigger->run-tests", + "source": "trigger", + "target": "run-tests", "sourcePort": "default" }, { - "id": "setup-prompt->fix-agent", - "source": "setup-prompt", - "target": "fix-agent", + "id": "run-build->run-review", + "source": "run-build", + "target": "run-review", "sourcePort": "default" }, { - "id": "fix-agent->push-fixes", - "source": "fix-agent", - "target": "push-fixes", + "id": "run-tests->run-review", + "source": "run-tests", + "target": "run-review", "sourcePort": "default" }, { - "id": "push-fixes->cleanup-worktree", - "source": "push-fixes", - "target": "cleanup-worktree", + "id": "run-review->aggregate", + "source": "run-review", + "target": "aggregate", "sourcePort": "default" }, { - "id": "cleanup-worktree->release-claim", - "source": "cleanup-worktree", - "target": "release-claim", + "id": "aggregate->notify", + "source": "aggregate", + "target": "notify", "sourcePort": "default" } ] }, { - "id": "template-pr-triage", - "name": "PR Triage & Labels", - "description": "Automatically triage incoming PRs: classify by size, detect breaking changes, add labels, and assign reviewers based on CODEOWNERS.", + "id": "template-sdk-conflict-resolver", + "name": "SDK Conflict Resolver", + "description": "Intelligent merge-conflict resolution using SDK agents. Auto-resolves lockfiles and generated files mechanically, then launches an agent with full context to resolve semantic conflicts in code, configs, and imports. Verifies resolution and pushes.", "category": "github", "categoryLabel": "GitHub", "categoryIcon": ":git:", "categoryOrder": 1, "tags": [ "github", - "pr", - "triage", - "labels", - "automation" + "merge", + "conflict", + "sdk", + "agent", + "resolution" ], - "nodeCount": 10, - "edgeCount": 12, + "nodeCount": 18, + "edgeCount": 18, "recommended": true, "enabled": true, - "trigger": "trigger.pr_event", + "trigger": "trigger.event", "variables": { - "smallThreshold": 50, - "largeThreshold": 500 + "timeoutMs": 600000, + "cooldownMs": 1800000, + "maxAttempts": 4, + "baseBranch": "main", + "delegationWatchdogTimeoutMs": 300000, + "delegationWatchdogMaxRecoveries": 1 }, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2025-02-24T00:00:00Z", + "createdAt": "2025-06-01T00:00:00Z", "templateVersion": "1.0.0", "tags": [ "github", - "pr", - "triage", - "labels", - "automation" + "merge", + "conflict", + "sdk", + "agent", + "resolution" + ], + "requiredTemplates": [ + "template-pr-merge-strategy" ], "replaces": { - "module": "github-reconciler.mjs", + "module": "sdk-conflict-resolver.mjs", "functions": [ - "PR labeling and classification logic" + "resolveConflictsWithSDK", + "buildSDKConflictPrompt", + "isSDKResolutionOnCooldown", + "isSDKResolutionExhausted" ], "calledFrom": [ - "monitor.mjs:checkEpicBranches" + "conflict-resolver.mjs:resolveConflicts", + "monitor.mjs:handleMergeConflict" ], - "description": "Replaces scattered PR classification logic with a structured triage workflow. Size classification, breaking change detection, and label assignment become explicit workflow nodes." + "description": "Replaces the imperative sdk-conflict-resolver.mjs with a visual workflow. File classification, auto-resolve, SDK agent launch, marker verification, and push become auditable nodes. Chains into PR Merge Strategy after successful resolution." } }, "nodes": [ { "id": "trigger", - "type": "trigger.pr_event", - "label": "PR Opened", + "type": "trigger.event", + "label": "Merge Conflict Detected", "config": { - "event": "opened" + "eventType": "pr.conflict_detected", + "description": "Fires when a PR has merge conflicts that need resolution" }, "position": { "x": 400, @@ -3528,113 +2872,155 @@ ] }, { - "id": "get-stats", - "type": "action.run_command", - "label": "Get PR Stats", + "id": "check-cooldown", + "type": "condition.expression", + "label": "On Cooldown?", "config": { - "command": "gh pr view {{prNumber}} --json additions,deletions,files,labels,title,body" + "expression": "(() => { const last = Number($data?.lastAttemptAt || 0); if (!last) return false; return (Date.now() - last) < ($data?.cooldownMs || 1800000); })()" }, "position": { "x": 400, - "y": 180 + "y": 200 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "classify-size", - "type": "condition.switch", - "label": "Classify Size", + "id": "check-attempts", + "type": "condition.expression", + "label": "Attempts Exhausted?", "config": { - "value": "(() => { const raw = $ctx.getNodeOutput('get-stats')?.output || '{}'; let stats = {}; try { stats = typeof raw === 'string' ? JSON.parse(raw) : raw; } catch { stats = {}; } const delta = Number(stats?.additions || 0) + Number(stats?.deletions || 0); const small = Number($data?.smallThreshold || 50); const large = Number($data?.largeThreshold || 500); if (delta < small) return 'small'; if (delta > large) return 'large'; return 'medium'; })()", - "cases": { - "small": "small", - "medium": "medium", - "large": "large" - } + "expression": "Number($data?.attemptCount || 0) >= Number($data?.maxAttempts || 4)" }, "position": { "x": 400, - "y": 330 + "y": 350 }, "outputs": [ - "small", - "medium", - "large", - "default" + "yes", + "no" ] }, { - "id": "label-small", + "id": "get-conflicts", "type": "action.run_command", - "label": "Label: Size/S", + "label": "List Conflicted Files", "config": { - "command": "gh pr edit {{prNumber}} --add-label \"size/S\"" + "command": "git diff --name-only --diff-filter=U", + "cwd": "{{worktreePath}}", + "continueOnError": true }, "position": { - "x": 150, - "y": 480 + "x": 400, + "y": 500 }, "outputs": [ "default" ] }, { - "id": "label-medium", - "type": "action.run_command", - "label": "Label: Size/M", + "id": "classify-files", + "type": "action.set_variable", + "label": "Classify Files", "config": { - "command": "gh pr edit {{prNumber}} --add-label \"size/M\"" + "key": "fileClassification", + "value": "(() => { const output = $ctx.getNodeOutput('get-conflicts')?.output || ''; const files = output.split('\\n').map(f => f.trim()).filter(Boolean); const auto = []; const manual = []; const AUTO_THEIRS = ['pnpm-lock.yaml','package-lock.json','yarn.lock','go.sum']; const AUTO_OURS = ['CHANGELOG.md','coverage.txt','results.txt']; for (const f of files) { const name = f.split('/').pop(); if (AUTO_THEIRS.includes(name) || name.endsWith('.lock')) auto.push({file:f,strategy:'theirs'}); else if (AUTO_OURS.includes(name)) auto.push({file:f,strategy:'ours'}); else manual.push(f); } return {auto, manual, total: files.length}; })()", + "isExpression": true }, "position": { "x": 400, - "y": 480 + "y": 650 }, "outputs": [ "default" ] }, { - "id": "label-large", + "id": "auto-resolve", "type": "action.run_command", - "label": "Label: Size/L", + "label": "Auto-Resolve Trivial Files", "config": { - "command": "gh pr edit {{prNumber}} --add-label \"size/L\"" + "command": "node -e \"const files = JSON.parse(process.env.AUTO_FILES || '[]'); const {execSync} = require('child_process'); let resolved = 0; for (const {file, strategy} of files) { try { execSync('git checkout --' + strategy + ' -- ' + file, {cwd: process.env.CWD}); execSync('git add ' + file, {cwd: process.env.CWD}); resolved++; } catch {} } console.log(JSON.stringify({resolved}));\" ", + "env": { + "AUTO_FILES": "{{fileClassification.auto}}", + "CWD": "{{worktreePath}}" + }, + "continueOnError": true }, "position": { - "x": 650, - "y": 480 + "x": 200, + "y": 800 }, "outputs": [ "default" ] }, { - "id": "detect-breaking", + "id": "has-manual", "type": "condition.expression", - "label": "Detect Breaking Changes", + "label": "Manual Conflicts Remain?", "config": { - "expression": "/* */ (() => { const raw=$ctx.getNodeOutput('get-stats')?.output||'{}'; let stats={}; try{stats=typeof raw==='string'?JSON.parse(raw):raw;}catch{return false;} const title=String(stats?.title||'').toLowerCase(); const body=String(stats?.body||'').toLowerCase(); const files=Array.isArray(stats?.files)?stats.files.map((f)=>String(f?.path||f?.filename||f||'').toLowerCase()):[]; const text=title+'\\n'+body; const explicit=/\\bbreaking\\b|\\bbreaking change\\b|\\bmajor\\b|\\bbackward incompatible\\b/.test(text); const apiTouch=files.some((f)=>f.includes('api/')||f.includes('/proto/')||f.includes('openapi')||f.includes('schema')); const contractWords=/\\bremove\\b|\\brename\\b|\\bdeprecate\\b|\\bdrop\\b/.test(text); return explicit || (apiTouch && contractWords);})()" + "expression": "(() => { const c = $data?.fileClassification; return c?.manual?.length > 0; })()" }, "position": { "x": 400, - "y": 630 + "y": 800 + }, + "outputs": [ + "yes", + "no" + ] + }, + { + "id": "launch-agent", + "type": "action.run_agent", + "label": "SDK Agent: Resolve Conflicts", + "config": { + "prompt": "# Merge Conflict Resolution\n\nYou are resolving merge conflicts in a git worktree.\n\n## Context\n- **Working directory**: `{{worktreePath}}`\n- **PR branch** (HEAD): `{{branch}}`\n- **Base branch** (incoming): `origin/{{baseBranch}}`\n- **PR**: #{{prNumber}}\n- **Task**: {{taskTitle}}\n\n## Conflicted files needing manual resolution:\n{{manualFiles}}\n\n## Instructions\n1. Read both sides of each conflict carefully\n2. Understand the INTENT of each change (feature vs upstream)\n3. Write a correct resolution that preserves both intents\n4. `git add` each resolved file\n5. Run `git commit --no-edit` to finalize the merge\n6. Do NOT use `--theirs` or `--ours` for code files\n7. Ensure no conflict markers (`<<<<<<<`, `=======`, `>>>>>>>`) remain", + "sdk": "auto", + "timeoutMs": "{{timeoutMs}}", + "delegationWatchdogTimeoutMs": "{{delegationWatchdogTimeoutMs}}", + "delegationWatchdogMaxRecoveries": "{{delegationWatchdogMaxRecoveries}}", + "failOnError": true, + "continueOnError": true + }, + "position": { + "x": 200, + "y": 950 }, "outputs": [ "default" ] }, { - "id": "is-breaking", + "id": "verify-clean", + "type": "action.run_command", + "label": "Verify No Markers", + "config": { + "command": "git grep -rl '^<<<<<<<\\|^=======\\|^>>>>>>>' -- . || echo CLEAN", + "cwd": "{{worktreePath}}", + "continueOnError": true + }, + "position": { + "x": 200, + "y": 1100 + }, + "outputs": [ + "default" + ] + }, + { + "id": "markers-clean", "type": "condition.expression", - "label": "Breaking?", + "label": "Markers Clean?", "config": { - "expression": "(() => { return $ctx.getNodeOutput('detect-breaking')?.result === true; })()" + "expression": "(() => { const out = $ctx.getNodeOutput('verify-clean')?.output || ''; return out.trim() === 'CLEAN' || out.trim() === ''; })()" }, "position": { - "x": 400, - "y": 780 + "x": 200, + "y": 1250 }, "outputs": [ "yes", @@ -3642,31 +3028,132 @@ ] }, { - "id": "label-breaking", + "id": "push-result", "type": "action.run_command", - "label": "Label: Breaking", + "label": "Push Resolution", "config": { - "command": "gh pr edit {{prNumber}} --add-label \"breaking-change\"" + "command": "git push origin HEAD:{{branch}}", + "cwd": "{{worktreePath}}", + "continueOnError": true, + "maxRetries": 2, + "retryDelayMs": 10000 }, "position": { "x": 200, - "y": 920 + "y": 1400 }, "outputs": [ "default" ] }, { - "id": "done", + "id": "commit-auto-only", + "type": "action.run_command", + "label": "Commit Auto-Only Resolution", + "config": { + "command": "git commit --no-edit", + "cwd": "{{worktreePath}}", + "continueOnError": true + }, + "position": { + "x": 600, + "y": 950 + }, + "outputs": [ + "default" + ] + }, + { + "id": "push-auto", + "type": "action.run_command", + "label": "Push Auto Resolution", + "config": { + "command": "git push origin HEAD:{{branch}}", + "cwd": "{{worktreePath}}", + "continueOnError": true + }, + "position": { + "x": 600, + "y": 1100 + }, + "outputs": [ + "default" + ] + }, + { + "id": "notify-resolved", "type": "notify.log", - "label": "Triage Complete", + "label": "Conflict Resolved", "config": { - "message": "PR #{{prNumber}} triage workflow completed", + "message": "SDK conflict resolution succeeded for PR #{{prNumber}} on {{branch}}", "level": "info" }, "position": { "x": 400, - "y": 1050 + "y": 1550 + }, + "outputs": [ + "default" + ] + }, + { + "id": "escalate-cooldown", + "type": "notify.log", + "label": "On Cooldown", + "config": { + "message": "SDK conflict resolution skipped — cooldown active for {{branch}}", + "level": "warn" + }, + "position": { + "x": 700, + "y": 200 + }, + "outputs": [ + "default" + ] + }, + { + "id": "escalate-exhausted", + "type": "notify.telegram", + "label": "Max Attempts Reached", + "config": { + "message": ":warning: Merge conflicts on **{{branch}}** (PR #{{prNumber}}) could not be resolved after {{maxAttempts}} SDK attempts. Manual intervention required." + }, + "position": { + "x": 700, + "y": 350 + }, + "outputs": [ + "default" + ] + }, + { + "id": "escalate-markers", + "type": "notify.telegram", + "label": "Markers Still Present", + "config": { + "message": ":alert: SDK agent resolved conflicts on **{{branch}}** but conflict markers remain. Manual review needed for PR #{{prNumber}}." + }, + "position": { + "x": 500, + "y": 1400 + }, + "outputs": [ + "default" + ] + }, + { + "id": "chain-merge-strategy", + "type": "action.execute_workflow", + "label": "Re-evaluate Merge", + "config": { + "workflowId": "template-pr-merge-strategy", + "mode": "dispatch", + "input": "({prNumber: $data?.prNumber, branch: $data?.branch, baseBranch: $data?.baseBranch})" + }, + "position": { + "x": 200, + "y": 1550 }, "outputs": [ "default" @@ -3675,104 +3162,145 @@ ], "edges": [ { - "id": "trigger->get-stats", + "id": "trigger->check-cooldown", "source": "trigger", - "target": "get-stats", + "target": "check-cooldown", "sourcePort": "default" }, { - "id": "get-stats->classify-size", - "source": "get-stats", - "target": "classify-size", - "sourcePort": "default" + "id": "check-cooldown->escalate-cooldown", + "source": "check-cooldown", + "target": "escalate-cooldown", + "sourcePort": "yes", + "condition": "$output?.result === true" }, { - "id": "classify-size->label-small", - "source": "classify-size", - "target": "label-small", - "sourcePort": "small" + "id": "check-cooldown->check-attempts", + "source": "check-cooldown", + "target": "check-attempts", + "sourcePort": "no", + "condition": "$output?.result !== true" }, { - "id": "classify-size->label-medium", - "source": "classify-size", - "target": "label-medium", - "sourcePort": "medium" + "id": "check-attempts->escalate-exhausted", + "source": "check-attempts", + "target": "escalate-exhausted", + "sourcePort": "yes", + "condition": "$output?.result === true" }, { - "id": "classify-size->label-large", - "source": "classify-size", - "target": "label-large", - "sourcePort": "large" + "id": "check-attempts->get-conflicts", + "source": "check-attempts", + "target": "get-conflicts", + "sourcePort": "no", + "condition": "$output?.result !== true" }, { - "id": "label-small->detect-breaking", - "source": "label-small", - "target": "detect-breaking", + "id": "get-conflicts->classify-files", + "source": "get-conflicts", + "target": "classify-files", "sourcePort": "default" }, { - "id": "label-medium->detect-breaking", - "source": "label-medium", - "target": "detect-breaking", + "id": "classify-files->auto-resolve", + "source": "classify-files", + "target": "auto-resolve", "sourcePort": "default" }, { - "id": "label-large->detect-breaking", - "source": "label-large", - "target": "detect-breaking", + "id": "auto-resolve->has-manual", + "source": "auto-resolve", + "target": "has-manual", "sourcePort": "default" }, { - "id": "detect-breaking->is-breaking", - "source": "detect-breaking", - "target": "is-breaking", + "id": "has-manual->launch-agent", + "source": "has-manual", + "target": "launch-agent", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "has-manual->commit-auto-only", + "source": "has-manual", + "target": "commit-auto-only", + "sourcePort": "no", + "condition": "$output?.result !== true" + }, + { + "id": "launch-agent->verify-clean", + "source": "launch-agent", + "target": "verify-clean", "sourcePort": "default" }, { - "id": "is-breaking->label-breaking", - "source": "is-breaking", - "target": "label-breaking", + "id": "verify-clean->markers-clean", + "source": "verify-clean", + "target": "markers-clean", + "sourcePort": "default" + }, + { + "id": "markers-clean->push-result", + "source": "markers-clean", + "target": "push-result", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "is-breaking->done", - "source": "is-breaking", - "target": "done", + "id": "markers-clean->escalate-markers", + "source": "markers-clean", + "target": "escalate-markers", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "label-breaking->done", - "source": "label-breaking", - "target": "done", + "id": "push-result->chain-merge-strategy", + "source": "push-result", + "target": "chain-merge-strategy", + "sourcePort": "default" + }, + { + "id": "chain-merge-strategy->notify-resolved", + "source": "chain-merge-strategy", + "target": "notify-resolved", + "sourcePort": "default" + }, + { + "id": "commit-auto-only->push-auto", + "source": "commit-auto-only", + "target": "push-auto", + "sourcePort": "default" + }, + { + "id": "push-auto->notify-resolved", + "source": "push-auto", + "target": "notify-resolved", "sourcePort": "default" } ] }, { - "id": "template-release-drafter", - "name": "Release Drafter", - "description": "Automatically generates release notes from merged PRs since the last tag. Groups changes by conventional commit type (features, fixes, refactors, etc.) and drafts a GitHub release.", + "id": "template-stale-pr-reaper", + "name": "Stale PR Reaper", + "description": "Close stale PRs that have been inactive for too long. Posts a warning comment before closing and cleans up associated branches.", "category": "github", "categoryLabel": "GitHub", "categoryIcon": ":git:", "categoryOrder": 1, "tags": [ "github", - "release", - "notes", - "changelog", - "draft" + "pr", + "stale", + "cleanup" ], - "nodeCount": 7, - "edgeCount": 6, - "recommended": false, + "nodeCount": 9, + "edgeCount": 8, + "recommended": true, "enabled": true, - "trigger": "trigger.manual", + "trigger": "trigger.schedule", "variables": { - "baseBranch": "main", - "releasePrefix": "v" + "staleAfterDays": 14, + "warningBeforeDays": 3 }, "metadata": { "author": "bosun", @@ -3781,19 +3309,33 @@ "templateVersion": "1.0.0", "tags": [ "github", - "release", - "notes", - "changelog", - "draft" - ] + "pr", + "stale", + "cleanup" + ], + "replaces": { + "module": "workspace-reaper.mjs", + "functions": [ + "runReaperSweep", + "cleanOrphanedWorktrees" + ], + "calledFrom": [ + "monitor.mjs:runMaintenanceSweep" + ], + "description": "Replaces workspace-reaper.mjs stale PR / orphaned worktree cleanup and the pr-cleanup-daemon.mjs temporary worktree remnants. Warning, closing, branch deletion, and worktree pruning are explicit, auditable steps.", + "also": [ + "pr-cleanup-daemon.mjs (temp worktree cleanup)" + ] + } }, "nodes": [ { "id": "trigger", - "type": "trigger.manual", - "label": "Draft Release Notes", + "type": "trigger.schedule", + "label": "Daily Check", "config": { - "description": "Generate release notes from merged PRs" + "intervalMs": 86400000, + "cron": "0 8 * * *" }, "position": { "x": 400, @@ -3804,95 +3346,125 @@ ] }, { - "id": "get-last-tag", + "id": "find-stale", "type": "action.run_command", - "label": "Get Last Tag", + "label": "Find Stale PRs", "config": { - "command": "git describe --tags --abbrev=0 2>/dev/null || echo '{{releasePrefix}}0.0.0'" + "command": "gh pr list --json number,title,updatedAt,headRefName --limit 50" }, "position": { "x": 400, - "y": 180 + "y": 200 }, "outputs": [ "default" ] }, { - "id": "list-prs", - "type": "action.run_command", - "label": "List Merged PRs", + "id": "has-stale", + "type": "condition.expression", + "label": "Any Stale PRs?", "config": { - "command": "gh pr list --state merged --base {{baseBranch}} --json number,title,labels,author,mergedAt --limit 100", - "continueOnError": true + "expression": "($ctx.getNodeOutput('find-stale')?.output || '[]').length > 2" }, "position": { "x": 400, - "y": 310 + "y": 350 }, "outputs": [ "default" ] }, { - "id": "get-commits", + "id": "warn-stale", "type": "action.run_command", - "label": "Get Commit Log", + "label": "Post Warning Comment", "config": { - "command": "git log $(git describe --tags --abbrev=0 2>/dev/null || echo HEAD~50)..HEAD --oneline --no-merges" + "command": "node -e \"const {execFileSync}=require('child_process');const stale=Number('{{staleAfterDays}}')||14;const warn=Number('{{warningBeforeDays}}')||3;const now=Date.now();const prs=JSON.parse(execFileSync('gh',['pr','list','--state','open','--json','number,updatedAt,labels','--limit','100'],{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim()||'[]');let n=0;for(const pr of prs){const age=(now-new Date(pr.updatedAt))/864e5;if(age>=(stale-warn)&&age(typeof l==='string'?l:l?.name)==='stale-warning');if(!lbl){try{execFileSync('gh',['pr','comment',String(pr.number),'--body','\\u26a0\\ufe0f This PR has been inactive for '+Math.floor(age)+' day(s) and will be closed in '+Math.ceil(stale-age)+' day(s). Please update or close it if no longer needed.'],{encoding:'utf8',stdio:['pipe','pipe','pipe']});execFileSync('gh',['pr','edit',String(pr.number),'--add-label','stale-warning'],{encoding:'utf8',stdio:['pipe','pipe','pipe']});n++;}catch(e){}}}}console.log('Warned '+n+' PR(s).');\"", + "continueOnError": true }, "position": { - "x": 400, - "y": 440 + "x": 200, + "y": 500 }, "outputs": [ "default" ] }, { - "id": "draft-notes", - "type": "action.run_agent", - "label": "Draft Release Notes", + "id": "close-stale", + "type": "action.run_command", + "label": "Close Expired PRs", "config": { - "prompt": "# Generate Release Notes\n\n## Merged PRs (JSON)\n{{prList}}\n\n## Commit Log\n{{commitLog}}\n\n## Last Tag\n{{lastTag}}\n\nGenerate professional release notes in the following format:\n\n# What's Changed\n\n## :rocket: Features\n- [list feat: commits with PR references]\n\n## :bug: Bug Fixes\n- [list fix: commits with PR references]\n\n## :settings: Improvements\n- [list refactor/perf/style commits]\n\n## :u1f4da: Documentation\n- [list docs: commits]\n\n## :hammer: Internal\n- [list chore/ci/build commits]\n\nOmit empty sections. Include contributor attribution. Be concise.", - "sdk": "auto", - "timeoutMs": 600000 + "command": "node -e \"const {execFileSync}=require('child_process');const stale=Number('{{staleAfterDays}}')||14;const now=Date.now();const prs=JSON.parse(execFileSync('gh',['pr','list','--state','open','--json','number,title,updatedAt,headRefName','--limit','100'],{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim()||'[]');let n=0;for(const pr of prs){const age=(now-new Date(pr.updatedAt))/864e5;if(age>=stale){try{execFileSync('gh',['pr','close',String(pr.number),'--comment','Automatically closed: inactive for '+Math.floor(age)+' days (threshold: '+stale+' days).','--delete-branch'],{encoding:'utf8',stdio:['pipe','pipe','pipe']});n++;}catch(e){process.stderr.write('close #'+pr.number+': '+(e?.message||e)+'\\n');}}}console.log('Closed '+n+' stale PR(s).');\"", + "continueOnError": true }, "position": { - "x": 400, - "y": 590 + "x": 200, + "y": 650 }, "outputs": [ "default" ] }, { - "id": "save-draft", - "type": "action.write_file", - "label": "Save Draft", + "id": "cleanup-branches", + "type": "action.run_command", + "label": "Delete Stale Branches", "config": { - "path": "RELEASE_DRAFT.md", - "content": "{{releaseNotes}}" + "command": "git fetch --prune origin" }, "position": { - "x": 400, - "y": 740 + "x": 200, + "y": 800 }, "outputs": [ "default" ] }, { - "id": "notify-ready", - "type": "notify.log", - "label": "Draft Ready", + "id": "prune-worktrees", + "type": "action.run_command", + "label": "Prune Git Worktrees", "config": { - "message": "Release notes draft saved to RELEASE_DRAFT.md — review and publish when ready", - "level": "info" + "command": "git worktree prune --expire 7.days.ago 2>/dev/null && echo 'Worktree prune complete.' || echo 'Worktree prune skipped (not a git repo).'", + "continueOnError": true }, "position": { - "x": 400, - "y": 870 + "x": 200, + "y": 950 + }, + "outputs": [ + "default" + ] + }, + { + "id": "summary", + "type": "notify.telegram", + "label": "Summary", + "config": { + "message": ":trash: Stale PR cleanup complete", + "silent": true + }, + "position": { + "x": 200, + "y": 1100 + }, + "outputs": [ + "default" + ] + }, + { + "id": "skip", + "type": "notify.log", + "label": "No Stale PRs", + "config": { + "message": "No stale PRs found", + "level": "info" + }, + "position": { + "x": 600, + "y": 500 }, "outputs": [ "default" @@ -3901,91 +3473,112 @@ ], "edges": [ { - "id": "trigger->get-last-tag", + "id": "trigger->find-stale", "source": "trigger", - "target": "get-last-tag", + "target": "find-stale", "sourcePort": "default" }, { - "id": "get-last-tag->list-prs", - "source": "get-last-tag", - "target": "list-prs", + "id": "find-stale->has-stale", + "source": "find-stale", + "target": "has-stale", "sourcePort": "default" }, { - "id": "list-prs->get-commits", - "source": "list-prs", - "target": "get-commits", + "id": "has-stale->warn-stale", + "source": "has-stale", + "target": "warn-stale", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "has-stale->skip", + "source": "has-stale", + "target": "skip", + "sourcePort": "default", + "condition": "$output?.result !== true" + }, + { + "id": "warn-stale->close-stale", + "source": "warn-stale", + "target": "close-stale", "sourcePort": "default" }, { - "id": "get-commits->draft-notes", - "source": "get-commits", - "target": "draft-notes", + "id": "close-stale->cleanup-branches", + "source": "close-stale", + "target": "cleanup-branches", "sourcePort": "default" }, { - "id": "draft-notes->save-draft", - "source": "draft-notes", - "target": "save-draft", + "id": "cleanup-branches->prune-worktrees", + "source": "cleanup-branches", + "target": "prune-worktrees", "sourcePort": "default" }, { - "id": "save-draft->notify-ready", - "source": "save-draft", - "target": "notify-ready", + "id": "prune-worktrees->summary", + "source": "prune-worktrees", + "target": "summary", "sourcePort": "default" } ] }, { - "id": "template-review-agent", - "name": "Review Agent", - "description": "Automatically runs code review when a PR is opened or updated. Checks build, tests, and code quality, then posts review comments.", - "category": "github", - "categoryLabel": "GitHub", - "categoryIcon": ":git:", - "categoryOrder": 1, + "id": "template-agent-session-monitor", + "name": "Agent Session Monitor", + "description": "Monitors active agent sessions for timeouts, excessive token usage, or inactivity. Auto-continues stalled agents or escalates hung ones.", + "category": "agents", + "categoryLabel": "Agents", + "categoryIcon": ":bot:", + "categoryOrder": 2, "tags": [ - "review", - "pr", - "automation" + "agent", + "monitor", + "session", + "health" ], - "nodeCount": 6, - "edgeCount": 6, + "nodeCount": 9, + "edgeCount": 8, "recommended": true, "enabled": true, - "trigger": "trigger.pr_event", - "variables": {}, + "trigger": "trigger.schedule", + "variables": { + "checkIntervalMs": 300000, + "maxIdleMs": 600000, + "maxTokenPercent": 85 + }, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2025-02-24T00:00:00Z", + "createdAt": "2025-02-25T00:00:00Z", "templateVersion": "1.0.0", "tags": [ - "review", - "pr", - "automation" + "agent", + "monitor", + "session", + "health" ], "replaces": { - "module": "review-agent.mjs", + "module": "session-tracker.mjs", "functions": [ - "ReviewAgent.runReview", - "createReviewAgent" + "SessionTracker.checkHealth", + "pollAgentAlerts" ], "calledFrom": [ - "monitor.mjs:checkEpicBranches" + "monitor.mjs:startAgentAlertTailer" ], - "description": "Replaces the ReviewAgent class with a visual workflow. Build, test, and AI review steps run in parallel with results aggregated." + "description": "Replaces hardcoded agent session monitoring with a visual workflow. Health checks, stall detection, and auto-continuation are configurable workflow steps." } }, "nodes": [ { "id": "trigger", - "type": "trigger.pr_event", - "label": "PR Opened/Updated", + "type": "trigger.schedule", + "label": "Check Every 5min", "config": { - "event": "opened" + "intervalMs": "{{checkIntervalMs}}", + "cron": "*/5 * * * *" }, "position": { "x": 400, @@ -3996,14 +3589,15 @@ ] }, { - "id": "run-build", - "type": "validation.build", - "label": "Run Build", + "id": "list-sessions", + "type": "action.run_command", + "label": "List Active Sessions", "config": { - "command": "npm run build" + "command": "node -e \"const fs = require('node:fs');const path = require('node:path');const { pathToFileURL } = require('node:url');const cwd = process.cwd();const mirrorMarker = `${path.sep}.bosun${path.sep}workspaces${path.sep}`.toLowerCase();let repoRoot = cwd;if (cwd.toLowerCase().includes(mirrorMarker)) {const sourceRepoRoot = path.resolve(cwd, '..', '..', '..', '..');if (fs.existsSync(path.join(sourceRepoRoot, 'infra', 'session-tracker.mjs'))) repoRoot = sourceRepoRoot;}const trackerModuleUrl = pathToFileURL(path.join(repoRoot, 'infra', 'session-tracker.mjs')).href;import(trackerModuleUrl).then(({ getSessionTracker }) => {const tracker = getSessionTracker();const sessions = tracker.getActiveSessions().map((session) => {const progress = tracker.getProgressStatus(session.taskId);return {id: session.taskId,taskId: session.taskId,taskTitle: session.taskTitle || null,status: progress.status,idleMs: progress.idleMs,totalEvents: progress.totalEvents,elapsedMs: progress.elapsedMs,lastEventType: progress.lastEventType,recommendation: progress.recommendation,tokenPercent: null};});console.log(JSON.stringify(sessions));}).catch((err) => { console.error(err?.stack || String(err)); process.exit(1); });\"", + "continueOnError": true }, "position": { - "x": 200, + "x": 400, "y": 200 }, "outputs": [ @@ -4011,177 +3605,209 @@ ] }, { - "id": "run-tests", - "type": "validation.tests", - "label": "Run Tests", + "id": "has-active", + "type": "condition.expression", + "label": "Any Active?", "config": { - "command": "npm test" + "expression": "(() => {const raw = String($ctx.getNodeOutput('list-sessions')?.output || '[]');const lines = raw.split(/\\r?\\n/).map((line) => line.trim()).filter(Boolean);const candidate = lines.length ? lines[lines.length - 1] : '[]';try {const parsed = JSON.parse(candidate);return Array.isArray(parsed) ? parsed : [];} catch {return [];}})().length > 0" }, "position": { - "x": 600, - "y": 200 + "x": 400, + "y": 340 }, "outputs": [ "default" ] }, { - "id": "run-review", - "type": "action.run_agent", - "label": "Agent Review", + "id": "check-health", + "type": "action.run_command", + "label": "Check Session Health", "config": { - "prompt": "# Code Review\n\nReview the changes in the current branch. Check for:\n1. Code quality and best practices\n2. Potential bugs or edge cases\n3. Test coverage for new features\n4. Documentation updates if needed\n\nProvide a structured review with specific file:line references.", - "timeoutMs": 900000 + "command": "node -e \"const fs = require('node:fs');const path = require('node:path');const { pathToFileURL } = require('node:url');const cwd = process.cwd();const mirrorMarker = `${path.sep}.bosun${path.sep}workspaces${path.sep}`.toLowerCase();let repoRoot = cwd;if (cwd.toLowerCase().includes(mirrorMarker)) {const sourceRepoRoot = path.resolve(cwd, '..', '..', '..', '..');if (fs.existsSync(path.join(sourceRepoRoot, 'infra', 'session-tracker.mjs'))) repoRoot = sourceRepoRoot;}const trackerModuleUrl = pathToFileURL(path.join(repoRoot, 'infra', 'session-tracker.mjs')).href;import(trackerModuleUrl).then(({ getSessionTracker }) => {const tracker = getSessionTracker();const sessions = tracker.getActiveSessions().map((session) => {const progress = tracker.getProgressStatus(session.taskId);return {id: session.taskId,taskId: session.taskId,taskTitle: session.taskTitle || null,status: progress.status,idleMs: progress.idleMs,totalEvents: progress.totalEvents,elapsedMs: progress.elapsedMs,lastEventType: progress.lastEventType,recommendation: progress.recommendation,tokenPercent: null};});console.log(JSON.stringify(sessions));}).catch((err) => { console.error(err?.stack || String(err)); process.exit(1); });\"", + "continueOnError": true }, "position": { - "x": 400, - "y": 350 + "x": 200, + "y": 490 }, "outputs": [ "default" ] }, { - "id": "aggregate", - "type": "transform.aggregate", - "label": "Collect Results", + "id": "has-issues", + "type": "condition.expression", + "label": "Any Unhealthy?", "config": { - "sources": [ - "run-build", - "run-tests", - "run-review" - ] + "expression": "(() => { const sessions = (() => {const raw = String($ctx.getNodeOutput('check-health')?.output || '[]');const lines = raw.split(/\\r?\\n/).map((line) => line.trim()).filter(Boolean);const candidate = lines.length ? lines[lines.length - 1] : '[]';try {const parsed = JSON.parse(candidate);return Array.isArray(parsed) ? parsed : [];} catch {return [];}})(); const maxIdleMs = Number($data?.maxIdleMs || 600000); const maxTokenPercent = Number($data?.maxTokenPercent || 85); return sessions.some((item) => { const status = String(item?.status || '').toLowerCase(); const idleMs = Number(item?.idleMs || 0); const tokenPercent = Number(item?.tokenPercent); return status === 'idle' || status === 'stalled' || status === 'timeout' || idleMs > maxIdleMs || (Number.isFinite(tokenPercent) && tokenPercent >= maxTokenPercent); }); })()" }, "position": { - "x": 400, - "y": 500 + "x": 200, + "y": 640 }, "outputs": [ "default" ] }, { - "id": "notify", + "id": "auto-continue", + "type": "action.continue_session", + "label": "Auto-Continue Stalled", + "config": { + "prompt": "You appear to have stalled. Please continue working on the current task.", + "strategy": "continue", + "timeoutMs": 300000 + }, + "position": { + "x": 100, + "y": 800 + }, + "outputs": [ + "default" + ] + }, + { + "id": "alert-hung", "type": "notify.telegram", - "label": "Post Review", + "label": "Alert Hung Sessions", "config": { - "message": ":edit: PR review complete for {{branch}}" + "message": ":dot: Agent session appears hung — auto-continue attempted. Check status." }, "position": { - "x": 400, + "x": 100, + "y": 950 + }, + "outputs": [ + "default" + ] + }, + { + "id": "all-healthy", + "type": "notify.log", + "label": "Sessions Healthy", + "config": { + "message": "All active agent sessions are healthy", + "level": "info" + }, + "position": { + "x": 450, "y": 640 }, "outputs": [ "default" ] + }, + { + "id": "no-sessions", + "type": "notify.log", + "label": "No Active Sessions", + "config": { + "message": "No active agent sessions to monitor", + "level": "info" + }, + "position": { + "x": 600, + "y": 490 + }, + "outputs": [ + "default" + ] } ], "edges": [ { - "id": "trigger->run-build", + "id": "trigger->list-sessions", "source": "trigger", - "target": "run-build", + "target": "list-sessions", "sourcePort": "default" }, { - "id": "trigger->run-tests", - "source": "trigger", - "target": "run-tests", + "id": "list-sessions->has-active", + "source": "list-sessions", + "target": "has-active", "sourcePort": "default" }, { - "id": "run-build->run-review", - "source": "run-build", - "target": "run-review", - "sourcePort": "default" + "id": "has-active->check-health", + "source": "has-active", + "target": "check-health", + "sourcePort": "default", + "condition": "$output?.result === true" }, { - "id": "run-tests->run-review", - "source": "run-tests", - "target": "run-review", - "sourcePort": "default" + "id": "has-active->no-sessions", + "source": "has-active", + "target": "no-sessions", + "sourcePort": "default", + "condition": "$output?.result !== true" }, { - "id": "run-review->aggregate", - "source": "run-review", - "target": "aggregate", + "id": "check-health->has-issues", + "source": "check-health", + "target": "has-issues", "sourcePort": "default" }, { - "id": "aggregate->notify", - "source": "aggregate", - "target": "notify", + "id": "has-issues->auto-continue", + "source": "has-issues", + "target": "auto-continue", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "has-issues->all-healthy", + "source": "has-issues", + "target": "all-healthy", + "sourcePort": "default", + "condition": "$output?.result !== true" + }, + { + "id": "auto-continue->alert-hung", + "source": "auto-continue", + "target": "alert-hung", "sourcePort": "default" } ] }, { - "id": "template-sdk-conflict-resolver", - "name": "SDK Conflict Resolver", - "description": "Intelligent merge-conflict resolution using SDK agents. Auto-resolves lockfiles and generated files mechanically, then launches an agent with full context to resolve semantic conflicts in code, configs, and imports. Verifies resolution and pushes.", - "category": "github", - "categoryLabel": "GitHub", - "categoryIcon": ":git:", - "categoryOrder": 1, + "id": "template-custom-agent", + "name": "Custom Agent Profile", + "description": "Starter template for creating a custom agent profile with configurable validation, notification, and completion gates. Duplicate and customize to match your specific workflow.", + "category": "agents", + "categoryLabel": "Agents", + "categoryIcon": ":bot:", + "categoryOrder": 2, "tags": [ - "github", - "merge", - "conflict", - "sdk", + "custom", "agent", - "resolution" + "starter" ], - "nodeCount": 18, - "edgeCount": 18, - "recommended": true, - "enabled": true, - "trigger": "trigger.event", + "nodeCount": 7, + "edgeCount": 6, + "recommended": false, + "enabled": false, + "trigger": "trigger.manual", "variables": { - "timeoutMs": 600000, - "cooldownMs": 1800000, - "maxAttempts": 4, - "baseBranch": "main" + "agentName": "my-custom-agent" }, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2025-06-01T00:00:00Z", + "createdAt": "2025-02-24T00:00:00Z", "templateVersion": "1.0.0", "tags": [ - "github", - "merge", - "conflict", - "sdk", + "custom", "agent", - "resolution" - ], - "requiredTemplates": [ - "template-pr-merge-strategy" - ], - "replaces": { - "module": "sdk-conflict-resolver.mjs", - "functions": [ - "resolveConflictsWithSDK", - "buildSDKConflictPrompt", - "isSDKResolutionOnCooldown", - "isSDKResolutionExhausted" - ], - "calledFrom": [ - "conflict-resolver.mjs:resolveConflicts", - "monitor.mjs:handleMergeConflict" - ], - "description": "Replaces the imperative sdk-conflict-resolver.mjs with a visual workflow. File classification, auto-resolve, SDK agent launch, marker verification, and push become auditable nodes. Chains into PR Merge Strategy after successful resolution." - } + "starter" + ] }, "nodes": [ { "id": "trigger", - "type": "trigger.event", - "label": "Merge Conflict Detected", - "config": { - "eventType": "pr.conflict_detected", - "description": "Fires when a PR has merge conflicts that need resolution" - }, + "type": "trigger.manual", + "label": "Start", + "config": {}, "position": { "x": 400, "y": 50 @@ -4191,716 +3817,640 @@ ] }, { - "id": "check-cooldown", - "type": "condition.expression", - "label": "On Cooldown?", + "id": "set-context", + "type": "action.set_variable", + "label": "Set Context", "config": { - "expression": "(() => { const last = Number($data?.lastAttemptAt || 0); if (!last) return false; return (Date.now() - last) < ($data?.cooldownMs || 1800000); })()" + "key": "agentProfile", + "value": "{{agentName}}" }, "position": { "x": 400, - "y": 200 + "y": 180 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "check-attempts", - "type": "condition.expression", - "label": "Attempts Exhausted?", + "id": "run-agent", + "type": "action.run_agent", + "label": "Run Agent", "config": { - "expression": "Number($data?.attemptCount || 0) >= Number($data?.maxAttempts || 4)" + "prompt": "# Custom Agent Task\n\nTask: {{taskTitle}}\n{{taskDescription}}", + "sdk": "auto" }, "position": { "x": 400, - "y": 350 + "y": 310 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "get-conflicts", - "type": "action.run_command", - "label": "List Conflicted Files", + "id": "verify", + "type": "validation.tests", + "label": "Run Verification", "config": { - "command": "git diff --name-only --diff-filter=U", - "cwd": "{{worktreePath}}", - "continueOnError": true + "command": "npm test" }, "position": { "x": 400, - "y": 500 + "y": 440 }, "outputs": [ "default" ] }, { - "id": "classify-files", - "type": "action.set_variable", - "label": "Classify Files", + "id": "check-result", + "type": "condition.expression", + "label": "Passed?", "config": { - "key": "fileClassification", - "value": "(() => { const output = $ctx.getNodeOutput('get-conflicts')?.output || ''; const files = output.split('\\n').map(f => f.trim()).filter(Boolean); const auto = []; const manual = []; const AUTO_THEIRS = ['pnpm-lock.yaml','package-lock.json','yarn.lock','go.sum']; const AUTO_OURS = ['CHANGELOG.md','coverage.txt','results.txt']; for (const f of files) { const name = f.split('/').pop(); if (AUTO_THEIRS.includes(name) || name.endsWith('.lock')) auto.push({file:f,strategy:'theirs'}); else if (AUTO_OURS.includes(name)) auto.push({file:f,strategy:'ours'}); else manual.push(f); } return {auto, manual, total: files.length}; })()", - "isExpression": true + "expression": "$ctx.getNodeOutput('verify')?.passed === true" }, "position": { "x": 400, - "y": 650 + "y": 570 }, "outputs": [ "default" ] }, { - "id": "auto-resolve", - "type": "action.run_command", - "label": "Auto-Resolve Trivial Files", + "id": "complete", + "type": "action.update_task_status", + "label": "Mark Complete", "config": { - "command": "node -e \"const files = JSON.parse(process.env.AUTO_FILES || '[]'); const {execSync} = require('child_process'); let resolved = 0; for (const {file, strategy} of files) { try { execSync('git checkout --' + strategy + ' -- ' + file, {cwd: process.env.CWD}); execSync('git add ' + file, {cwd: process.env.CWD}); resolved++; } catch {} } console.log(JSON.stringify({resolved}));\" ", - "env": { - "AUTO_FILES": "{{fileClassification.auto}}", - "CWD": "{{worktreePath}}" - }, - "continueOnError": true + "taskId": "{{taskId}}", + "status": "done" }, "position": { "x": 200, - "y": 800 + "y": 700 }, "outputs": [ "default" ] }, { - "id": "has-manual", - "type": "condition.expression", - "label": "Manual Conflicts Remain?", + "id": "fail-notify", + "type": "notify.log", + "label": "Log Failure", "config": { - "expression": "(() => { const c = $data?.fileClassification; return c?.manual?.length > 0; })()" + "message": "Custom agent verification failed for {{taskId}}", + "level": "warn" }, "position": { - "x": 400, - "y": 800 + "x": 600, + "y": 700 }, "outputs": [ - "yes", - "no" + "default" ] + } + ], + "edges": [ + { + "id": "trigger->set-context", + "source": "trigger", + "target": "set-context", + "sourcePort": "default" }, { - "id": "launch-agent", - "type": "action.run_agent", - "label": "SDK Agent: Resolve Conflicts", - "config": { - "prompt": "# Merge Conflict Resolution\n\nYou are resolving merge conflicts in a git worktree.\n\n## Context\n- **Working directory**: `{{worktreePath}}`\n- **PR branch** (HEAD): `{{branch}}`\n- **Base branch** (incoming): `origin/{{baseBranch}}`\n- **PR**: #{{prNumber}}\n- **Task**: {{taskTitle}}\n\n## Conflicted files needing manual resolution:\n{{manualFiles}}\n\n## Instructions\n1. Read both sides of each conflict carefully\n2. Understand the INTENT of each change (feature vs upstream)\n3. Write a correct resolution that preserves both intents\n4. `git add` each resolved file\n5. Run `git commit --no-edit` to finalize the merge\n6. Do NOT use `--theirs` or `--ours` for code files\n7. Ensure no conflict markers (`<<<<<<<`, `=======`, `>>>>>>>`) remain", - "sdk": "auto", - "timeoutMs": "{{timeoutMs}}", - "delegationWatchdogTimeoutMs": "{{delegationWatchdogTimeoutMs}}", - "delegationWatchdogMaxRecoveries": "{{delegationWatchdogMaxRecoveries}}", - "failOnError": true, - "continueOnError": true - }, - "position": { - "x": 200, - "y": 950 - }, - "outputs": [ - "default" - ] + "id": "set-context->run-agent", + "source": "set-context", + "target": "run-agent", + "sourcePort": "default" }, { - "id": "verify-clean", - "type": "action.run_command", - "label": "Verify No Markers", - "config": { - "command": "git grep -rl '^<<<<<<<\\|^=======\\|^>>>>>>>' -- . || echo CLEAN", - "cwd": "{{worktreePath}}", - "continueOnError": true - }, - "position": { - "x": 200, - "y": 1100 - }, - "outputs": [ - "default" - ] + "id": "run-agent->verify", + "source": "run-agent", + "target": "verify", + "sourcePort": "default" }, { - "id": "markers-clean", - "type": "condition.expression", - "label": "Markers Clean?", - "config": { - "expression": "(() => { const out = $ctx.getNodeOutput('verify-clean')?.output || ''; return out.trim() === 'CLEAN' || out.trim() === ''; })()" - }, - "position": { - "x": 200, - "y": 1250 - }, - "outputs": [ - "yes", - "no" - ] + "id": "verify->check-result", + "source": "verify", + "target": "check-result", + "sourcePort": "default" }, { - "id": "push-result", - "type": "action.run_command", - "label": "Push Resolution", + "id": "check-result->complete", + "source": "check-result", + "target": "complete", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "check-result->fail-notify", + "source": "check-result", + "target": "fail-notify", + "sourcePort": "default", + "condition": "$output?.result !== true" + } + ] + }, + { + "id": "template-frontend-agent", + "name": "Frontend Agent", + "description": "Front-end development agent that validates work by taking screenshots, storing them as evidence, and having an independent model verify the implementation matches the task requirements before marking complete.", + "category": "agents", + "categoryLabel": "Agents", + "categoryIcon": ":bot:", + "categoryOrder": 2, + "tags": [ + "frontend", + "agent", + "validation", + "screenshot" + ], + "nodeCount": 15, + "edgeCount": 17, + "recommended": false, + "enabled": true, + "trigger": "trigger.task_assigned", + "variables": { + "devServerUrl": "http://localhost:3000", + "evidenceDir": ".bosun/evidence", + "screenshotCount": 3 + }, + "metadata": { + "author": "bosun", + "version": 1, + "createdAt": "2025-02-24T00:00:00Z", + "templateVersion": "1.0.0", + "tags": [ + "frontend", + "agent", + "validation", + "screenshot" + ], + "replaces": { + "module": "agent-hooks.mjs", + "functions": [ + "screenshotValidation", + "evidenceCollection" + ], + "calledFrom": [ + "monitor.mjs:startFreshSession" + ], + "description": "Replaces hardcoded frontend agent profile with a visual workflow. Screenshot capture, model verification, and evidence collection are explicit steps." + } + }, + "nodes": [ + { + "id": "trigger", + "type": "trigger.task_assigned", + "label": "Task Assigned", "config": { - "command": "git push origin HEAD:{{branch}}", - "cwd": "{{worktreePath}}", - "continueOnError": true, - "maxRetries": 2, - "retryDelayMs": 10000 + "agentType": "frontend", + "taskPattern": "feat\\(.*\\)|fix\\(.*\\)|style\\(.*\\)|ui|frontend|css|component" }, "position": { - "x": 200, - "y": 1400 + "x": 400, + "y": 50 }, "outputs": [ "default" ] }, { - "id": "commit-auto-only", - "type": "action.run_command", - "label": "Commit Auto-Only Resolution", + "id": "select-profile", + "type": "agent.select_profile", + "label": "Select Agent Profile", "config": { - "command": "git commit --no-edit", - "cwd": "{{worktreePath}}", - "continueOnError": true + "profiles": { + "frontend": { + "titlePatterns": [ + "ui", + "frontend", + "css", + "component", + "page", + "layout", + "style", + "design" + ], + "tags": [ + "frontend", + "ui", + "css", + "component" + ] + }, + "fullstack": { + "titlePatterns": [ + "api.*ui", + "full.?stack" + ], + "tags": [ + "fullstack" + ] + } + }, + "default": "frontend" }, "position": { - "x": 600, - "y": 950 + "x": 400, + "y": 160 }, "outputs": [ "default" ] }, { - "id": "push-auto", - "type": "action.run_command", - "label": "Push Auto Resolution", + "id": "run-agent", + "type": "action.run_agent", + "label": "Run Frontend Agent", "config": { - "command": "git push origin HEAD:{{branch}}", + "prompt": "# Frontend Development Task\n\n## Task: {{taskTitle}}\n\n## Description\n{{taskDescription}}\n\n## Special Instructions\nYou are a **frontend specialist** agent. Your focus areas:\n- HTML/CSS layout and styling\n- JavaScript/TypeScript UI logic\n- Component architecture and state management\n- Responsive design and accessibility\n- Visual accuracy matching design specifications\n\n## CRITICAL: Evidence Collection\nAfter completing your implementation:\n1. Start the dev server if not running\n2. Take screenshots of ALL pages/components you changed\n3. Save each screenshot to `.bosun/evidence/` directory\n4. Include screenshots of: main view, mobile view, any interactive states\n5. Name files descriptively: `homepage-desktop.png`, `modal-open.png`, etc.\n6. Capture at least {{screenshotCount}} key screenshots across target states/viewports.\n\n## Workflow\n1. Read task requirements carefully\n2. Implement all frontend changes\n3. Run `npm run build` to verify no errors\n4. Run `npm run lint` to verify no warnings\n5. Start dev server and screenshot all changed pages\n6. Commit and push\n\n## Do NOT mark task complete yourself — the validation workflow handles that.", + "sdk": "auto", "cwd": "{{worktreePath}}", - "continueOnError": true + "timeoutMs": 7200000, + "agentProfile": "frontend" }, "position": { - "x": 600, - "y": 1100 + "x": 400, + "y": 280 }, "outputs": [ "default" ] }, { - "id": "notify-resolved", - "type": "notify.log", - "label": "Conflict Resolved", + "id": "verify-build", + "type": "validation.build", + "label": "Verify Build", "config": { - "message": "SDK conflict resolution succeeded for PR #{{prNumber}} on {{branch}}", - "level": "info" + "command": "npm run build", + "cwd": "{{worktreePath}}", + "zeroWarnings": true }, "position": { - "x": 400, - "y": 1550 + "x": 150, + "y": 420 }, "outputs": [ "default" ] }, { - "id": "escalate-cooldown", - "type": "notify.log", - "label": "On Cooldown", + "id": "verify-lint", + "type": "validation.lint", + "label": "Verify Lint", "config": { - "message": "SDK conflict resolution skipped — cooldown active for {{branch}}", - "level": "warn" + "command": "npm run lint", + "cwd": "{{worktreePath}}" }, "position": { - "x": 700, - "y": 200 + "x": 650, + "y": 420 }, "outputs": [ "default" ] }, { - "id": "escalate-exhausted", - "type": "notify.telegram", - "label": "Max Attempts Reached", + "id": "screenshot-desktop", + "type": "validation.screenshot", + "label": "Screenshot Desktop", "config": { - "message": ":warning: Merge conflicts on **{{branch}}** (PR #{{prNumber}}) could not be resolved after {{maxAttempts}} SDK attempts. Manual intervention required." + "url": "{{devServerUrl}}", + "outputDir": "{{evidenceDir}}", + "filename": "desktop-{{taskId}}.png", + "viewport": { + "width": 1920, + "height": 1080 + } }, "position": { - "x": 700, - "y": 350 + "x": 100, + "y": 560 }, "outputs": [ "default" ] }, { - "id": "escalate-markers", - "type": "notify.telegram", - "label": "Markers Still Present", + "id": "screenshot-tablet", + "type": "validation.screenshot", + "label": "Screenshot Tablet", "config": { - "message": ":alert: SDK agent resolved conflicts on **{{branch}}** but conflict markers remain. Manual review needed for PR #{{prNumber}}." + "url": "{{devServerUrl}}", + "outputDir": "{{evidenceDir}}", + "filename": "tablet-{{taskId}}.png", + "viewport": { + "width": 768, + "height": 1024 + } }, "position": { - "x": 500, - "y": 1400 + "x": 400, + "y": 560 }, "outputs": [ "default" ] }, { - "id": "chain-merge-strategy", - "type": "action.execute_workflow", - "label": "Re-evaluate Merge", + "id": "screenshot-mobile", + "type": "validation.screenshot", + "label": "Screenshot Mobile", "config": { - "workflowId": "template-pr-merge-strategy", - "mode": "dispatch", - "input": "({prNumber: $data?.prNumber, branch: $data?.branch, baseBranch: $data?.baseBranch})" + "url": "{{devServerUrl}}", + "outputDir": "{{evidenceDir}}", + "filename": "mobile-{{taskId}}.png", + "viewport": { + "width": 375, + "height": 812 + } }, "position": { - "x": 200, - "y": 1550 + "x": 700, + "y": 560 }, "outputs": [ "default" ] - } - ], - "edges": [ - { - "id": "trigger->check-cooldown", - "source": "trigger", - "target": "check-cooldown", - "sourcePort": "default" - }, - { - "id": "check-cooldown->escalate-cooldown", - "source": "check-cooldown", - "target": "escalate-cooldown", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "check-cooldown->check-attempts", - "source": "check-cooldown", - "target": "check-attempts", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "check-attempts->escalate-exhausted", - "source": "check-attempts", - "target": "escalate-exhausted", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "check-attempts->get-conflicts", - "source": "check-attempts", - "target": "get-conflicts", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "get-conflicts->classify-files", - "source": "get-conflicts", - "target": "classify-files", - "sourcePort": "default" - }, - { - "id": "classify-files->auto-resolve", - "source": "classify-files", - "target": "auto-resolve", - "sourcePort": "default" - }, - { - "id": "auto-resolve->has-manual", - "source": "auto-resolve", - "target": "has-manual", - "sourcePort": "default" - }, - { - "id": "has-manual->launch-agent", - "source": "has-manual", - "target": "launch-agent", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "has-manual->commit-auto-only", - "source": "has-manual", - "target": "commit-auto-only", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "launch-agent->verify-clean", - "source": "launch-agent", - "target": "verify-clean", - "sourcePort": "default" - }, - { - "id": "verify-clean->markers-clean", - "source": "verify-clean", - "target": "markers-clean", - "sourcePort": "default" - }, - { - "id": "markers-clean->push-result", - "source": "markers-clean", - "target": "push-result", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "markers-clean->escalate-markers", - "source": "markers-clean", - "target": "escalate-markers", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "push-result->chain-merge-strategy", - "source": "push-result", - "target": "chain-merge-strategy", - "sourcePort": "default" - }, - { - "id": "chain-merge-strategy->notify-resolved", - "source": "chain-merge-strategy", - "target": "notify-resolved", - "sourcePort": "default" - }, - { - "id": "commit-auto-only->push-auto", - "source": "commit-auto-only", - "target": "push-auto", - "sourcePort": "default" }, { - "id": "push-auto->notify-resolved", - "source": "push-auto", - "target": "notify-resolved", - "sourcePort": "default" - } - ] - }, - { - "id": "template-stale-pr-reaper", - "name": "Stale PR Reaper", - "description": "Close stale PRs that have been inactive for too long. Posts a warning comment before closing and cleans up associated branches.", - "category": "github", - "categoryLabel": "GitHub", - "categoryIcon": ":git:", - "categoryOrder": 1, - "tags": [ - "github", - "pr", - "stale", - "cleanup" - ], - "nodeCount": 9, - "edgeCount": 8, - "recommended": true, - "enabled": true, - "trigger": "trigger.schedule", - "variables": { - "staleAfterDays": 14, - "warningBeforeDays": 3 - }, - "metadata": { - "author": "bosun", - "version": 1, - "createdAt": "2025-02-25T00:00:00Z", - "templateVersion": "1.0.0", - "tags": [ - "github", - "pr", - "stale", - "cleanup" - ], - "replaces": { - "module": "workspace-reaper.mjs", - "functions": [ - "runReaperSweep", - "cleanOrphanedWorktrees" - ], - "calledFrom": [ - "monitor.mjs:runMaintenanceSweep" - ], - "description": "Replaces workspace-reaper.mjs stale PR / orphaned worktree cleanup and the pr-cleanup-daemon.mjs temporary worktree remnants. Warning, closing, branch deletion, and worktree pruning are explicit, auditable steps.", - "also": [ - "pr-cleanup-daemon.mjs (temp worktree cleanup)" - ] - } - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.schedule", - "label": "Daily Check", + "id": "collect-evidence", + "type": "agent.evidence_collect", + "label": "Collect Evidence", "config": { - "intervalMs": 86400000, - "cron": "0 8 * * *" + "evidenceDir": "{{evidenceDir}}" }, "position": { "x": 400, - "y": 50 + "y": 700 }, "outputs": [ "default" ] }, { - "id": "find-stale", - "type": "action.run_command", - "label": "Find Stale PRs", + "id": "model-review", + "type": "validation.model_review", + "label": "Model Verification", "config": { - "command": "gh pr list --json number,title,updatedAt,headRefName --limit 50" + "evidenceDir": "{{evidenceDir}}", + "originalTask": "{{taskTitle}}: {{taskDescription}}", + "criteria": "Visual implementation matches requirements. No broken layouts. Responsive design works across viewports. No console errors visible.", + "strictMode": true }, "position": { "x": 400, - "y": 200 + "y": 840 }, "outputs": [ "default" ] }, { - "id": "has-stale", + "id": "check-review", "type": "condition.expression", - "label": "Any Stale PRs?", + "label": "Review Passed?", "config": { - "expression": "($ctx.getNodeOutput('find-stale')?.output || '[]').length > 2" + "expression": "$output?.model_review?.passed === true || $data?.modelReviewPassed === true" }, "position": { "x": 400, - "y": 350 + "y": 960 }, "outputs": [ "default" ] }, { - "id": "warn-stale", - "type": "action.run_command", - "label": "Post Warning Comment", + "id": "mark-success", + "type": "action.update_task_status", + "label": "Mark Task Done", "config": { - "command": "node -e \"const {execFileSync}=require('child_process');const stale=Number('{{staleAfterDays}}')||14;const warn=Number('{{warningBeforeDays}}')||3;const now=Date.now();const prs=JSON.parse(execFileSync('gh',['pr','list','--state','open','--json','number,updatedAt,labels','--limit','100'],{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim()||'[]');let n=0;for(const pr of prs){const age=(now-new Date(pr.updatedAt))/864e5;if(age>=(stale-warn)&&age(typeof l==='string'?l:l?.name)==='stale-warning');if(!lbl){try{execFileSync('gh',['pr','comment',String(pr.number),'--body','\\u26a0\\ufe0f This PR has been inactive for '+Math.floor(age)+' day(s) and will be closed in '+Math.ceil(stale-age)+' day(s). Please update or close it if no longer needed.'],{encoding:'utf8',stdio:['pipe','pipe','pipe']});execFileSync('gh',['pr','edit',String(pr.number),'--add-label','stale-warning'],{encoding:'utf8',stdio:['pipe','pipe','pipe']});n++;}catch(e){}}}}console.log('Warned '+n+' PR(s).');\"", - "continueOnError": true + "taskId": "{{taskId}}", + "status": "done" }, "position": { "x": 200, - "y": 500 + "y": 1080 }, "outputs": [ "default" ] }, { - "id": "close-stale", - "type": "action.run_command", - "label": "Close Expired PRs", + "id": "notify-success", + "type": "notify.telegram", + "label": "Notify Success", "config": { - "command": "node -e \"const {execFileSync}=require('child_process');const stale=Number('{{staleAfterDays}}')||14;const now=Date.now();const prs=JSON.parse(execFileSync('gh',['pr','list','--state','open','--json','number,title,updatedAt,headRefName','--limit','100'],{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim()||'[]');let n=0;for(const pr of prs){const age=(now-new Date(pr.updatedAt))/864e5;if(age>=stale){try{execFileSync('gh',['pr','close',String(pr.number),'--comment','Automatically closed: inactive for '+Math.floor(age)+' days (threshold: '+stale+' days).','--delete-branch'],{encoding:'utf8',stdio:['pipe','pipe','pipe']});n++;}catch(e){process.stderr.write('close #'+pr.number+': '+(e?.message||e)+'\\n');}}}console.log('Closed '+n+' stale PR(s).');\"", - "continueOnError": true + "message": ":check: Frontend task **{{taskTitle}}** passed visual verification and is complete." }, "position": { "x": 200, - "y": 650 + "y": 1200 }, "outputs": [ "default" ] }, { - "id": "cleanup-branches", - "type": "action.run_command", - "label": "Delete Stale Branches", + "id": "notify-failure", + "type": "notify.telegram", + "label": "Notify Review Failed", "config": { - "command": "git fetch --prune origin" + "message": "❌ Frontend task **{{taskTitle}}** failed visual verification.\nEvidence dir: `{{evidenceDir}}`\nReason: `{{model-review.reason}}`\nEvidence count: `{{model-review.evidenceCount}}`\nReview output: {{model-review.reviewOutput}}" }, "position": { - "x": 200, - "y": 800 + "x": 600, + "y": 1080 }, "outputs": [ "default" ] }, { - "id": "prune-worktrees", - "type": "action.run_command", - "label": "Prune Git Worktrees", + "id": "log-failure", + "type": "notify.log", + "label": "Log Failure", "config": { - "command": "git worktree prune --expire 7.days.ago 2>/dev/null && echo 'Worktree prune complete.' || echo 'Worktree prune skipped (not a git repo).'", - "continueOnError": true + "message": "Frontend verification failed for {{taskId}}: evidenceDir={{evidenceDir}} reason={{model-review.reason}} evidenceCount={{model-review.evidenceCount}}", + "level": "warn" }, "position": { - "x": 200, - "y": 950 + "x": 600, + "y": 1200 }, "outputs": [ "default" ] + } + ], + "edges": [ + { + "id": "trigger->select-profile", + "source": "trigger", + "target": "select-profile", + "sourcePort": "default" }, { - "id": "summary", - "type": "notify.telegram", - "label": "Summary", - "config": { - "message": ":trash: Stale PR cleanup complete", - "silent": true - }, - "position": { - "x": 200, - "y": 1100 - }, - "outputs": [ - "default" - ] + "id": "select-profile->run-agent", + "source": "select-profile", + "target": "run-agent", + "sourcePort": "default" }, { - "id": "skip", - "type": "notify.log", - "label": "No Stale PRs", - "config": { - "message": "No stale PRs found", - "level": "info" - }, - "position": { - "x": 600, - "y": 500 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ + "id": "run-agent->verify-build", + "source": "run-agent", + "target": "verify-build", + "sourcePort": "default" + }, { - "id": "trigger->find-stale", - "source": "trigger", - "target": "find-stale", + "id": "run-agent->verify-lint", + "source": "run-agent", + "target": "verify-lint", "sourcePort": "default" }, { - "id": "find-stale->has-stale", - "source": "find-stale", - "target": "has-stale", + "id": "verify-build->screenshot-desktop", + "source": "verify-build", + "target": "screenshot-desktop", "sourcePort": "default" }, { - "id": "has-stale->warn-stale", - "source": "has-stale", - "target": "warn-stale", - "sourcePort": "default", - "condition": "$output?.result === true" + "id": "verify-build->screenshot-tablet", + "source": "verify-build", + "target": "screenshot-tablet", + "sourcePort": "default" }, { - "id": "has-stale->skip", - "source": "has-stale", - "target": "skip", - "sourcePort": "default", - "condition": "$output?.result !== true" + "id": "verify-build->screenshot-mobile", + "source": "verify-build", + "target": "screenshot-mobile", + "sourcePort": "default" }, { - "id": "warn-stale->close-stale", - "source": "warn-stale", - "target": "close-stale", + "id": "verify-lint->screenshot-desktop", + "source": "verify-lint", + "target": "screenshot-desktop", "sourcePort": "default" }, { - "id": "close-stale->cleanup-branches", - "source": "close-stale", - "target": "cleanup-branches", + "id": "screenshot-desktop->collect-evidence", + "source": "screenshot-desktop", + "target": "collect-evidence", "sourcePort": "default" }, { - "id": "cleanup-branches->prune-worktrees", - "source": "cleanup-branches", - "target": "prune-worktrees", + "id": "screenshot-tablet->collect-evidence", + "source": "screenshot-tablet", + "target": "collect-evidence", "sourcePort": "default" }, { - "id": "prune-worktrees->summary", - "source": "prune-worktrees", - "target": "summary", + "id": "screenshot-mobile->collect-evidence", + "source": "screenshot-mobile", + "target": "collect-evidence", + "sourcePort": "default" + }, + { + "id": "collect-evidence->model-review", + "source": "collect-evidence", + "target": "model-review", + "sourcePort": "default" + }, + { + "id": "model-review->check-review", + "source": "model-review", + "target": "check-review", + "sourcePort": "default" + }, + { + "id": "check-review->mark-success", + "source": "check-review", + "target": "mark-success", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "check-review->notify-failure", + "source": "check-review", + "target": "notify-failure", + "sourcePort": "default", + "condition": "$output?.result !== true" + }, + { + "id": "mark-success->notify-success", + "source": "mark-success", + "target": "notify-success", + "sourcePort": "default" + }, + { + "id": "notify-failure->log-failure", + "source": "notify-failure", + "target": "log-failure", "sourcePort": "default" } ] }, { - "id": "template-agent-session-monitor", - "name": "Agent Session Monitor", - "description": "Monitors active agent sessions for timeouts, excessive token usage, or inactivity. Auto-continues stalled agents or escalates hung ones.", + "id": "template-meeting-subworkflow-chain", + "name": "Meeting Orchestrator + Subworkflow Chain", + "description": "Runs a meeting session start/send/vision/transcript/finalize flow, applies a wake-phrase trigger + transcript quality guard, then invokes a child workflow via action.execute_workflow for post-meeting automation.", "category": "agents", "categoryLabel": "Agents", "categoryIcon": ":bot:", "categoryOrder": 2, "tags": [ - "agent", - "monitor", - "session", - "health" + "meeting", + "subworkflow", + "chaining", + "agents" ], - "nodeCount": 9, - "edgeCount": 8, - "recommended": true, - "enabled": true, - "trigger": "trigger.schedule", + "nodeCount": 14, + "edgeCount": 15, + "recommended": false, + "enabled": false, + "trigger": "trigger.manual", "variables": { - "checkIntervalMs": 300000, - "maxIdleMs": 600000, - "maxTokenPercent": 85 + "sessionTitle": "Sprint Planning Sync", + "meetingExecutor": "codex", + "wakePhrase": "bosun wake", + "openingMessage": "Kick off planning review. Capture decisions, blockers, and next actions.", + "frameDataUrl": "", + "visionSource": "screen", + "visionPrompt": "Summarize visible meeting context, shared docs, and any blockers shown.", + "visionModel": "", + "visionMinIntervalMs": 1500, + "forceVisionAnalyze": false, + "minTranscriptChars": 140, + "childWorkflowId": "template-task-planner", + "finalizeDisposition": "completed", + "notifyPrefix": ":memo:" }, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2025-02-25T00:00:00Z", + "createdAt": "2026-02-28T00:00:00Z", "templateVersion": "1.0.0", "tags": [ - "agent", - "monitor", - "session", - "health" + "meeting", + "subworkflow", + "chaining", + "agents" ], - "replaces": { - "module": "session-tracker.mjs", - "functions": [ - "SessionTracker.checkHealth", - "pollAgentAlerts" - ], - "calledFrom": [ - "monitor.mjs:startAgentAlertTailer" - ], - "description": "Replaces hardcoded agent session monitoring with a visual workflow. Health checks, stall detection, and auto-continuation are configurable workflow steps." - } + "requiredTemplates": [ + "template-task-planner" + ] }, "nodes": [ { "id": "trigger", - "type": "trigger.schedule", - "label": "Check Every 5min", - "config": { - "intervalMs": "{{checkIntervalMs}}", - "cron": "*/5 * * * *" - }, + "type": "trigger.manual", + "label": "Start Meeting Orchestration", + "config": {}, "position": { - "x": 400, + "x": 450, "y": 50 }, "outputs": [ @@ -4908,322 +4458,227 @@ ] }, { - "id": "list-sessions", - "type": "action.run_command", - "label": "List Active Sessions", - "config": { - "command": "node -e \"const fs = require('node:fs');const path = require('node:path');const { pathToFileURL } = require('node:url');const cwd = process.cwd();const mirrorMarker = `${path.sep}.bosun${path.sep}workspaces${path.sep}`.toLowerCase();let repoRoot = cwd;if (cwd.toLowerCase().includes(mirrorMarker)) {const sourceRepoRoot = path.resolve(cwd, '..', '..', '..', '..');if (fs.existsSync(path.join(sourceRepoRoot, 'infra', 'session-tracker.mjs'))) repoRoot = sourceRepoRoot;}const trackerModuleUrl = pathToFileURL(path.join(repoRoot, 'infra', 'session-tracker.mjs')).href;import(trackerModuleUrl).then(({ getSessionTracker }) => {const tracker = getSessionTracker();const sessions = tracker.getActiveSessions().map((session) => {const progress = tracker.getProgressStatus(session.taskId);return {id: session.taskId,taskId: session.taskId,taskTitle: session.taskTitle || null,status: progress.status,idleMs: progress.idleMs,totalEvents: progress.totalEvents,elapsedMs: progress.elapsedMs,lastEventType: progress.lastEventType,recommendation: progress.recommendation,tokenPercent: null};});console.log(JSON.stringify(sessions));}).catch((err) => { console.error(err?.stack || String(err)); process.exit(1); });\"", - "continueOnError": true - }, - "position": { - "x": 400, - "y": 200 - }, - "outputs": [ - "default" - ] - }, - { - "id": "has-active", - "type": "condition.expression", - "label": "Any Active?", + "id": "meeting-start", + "type": "meeting.start", + "label": "Meeting Start", "config": { - "expression": "(() => {const raw = String($ctx.getNodeOutput('list-sessions')?.output || '[]');const lines = raw.split(/\\r?\\n/).map((line) => line.trim()).filter(Boolean);const candidate = lines.length ? lines[lines.length - 1] : '[]';try {const parsed = JSON.parse(candidate);return Array.isArray(parsed) ? parsed : [];} catch {return [];}})().length > 0" + "title": "{{sessionTitle}}", + "executor": "{{meetingExecutor}}", + "wakePhrase": "{{wakePhrase}}", + "includeTaskContext": true }, "position": { - "x": 400, - "y": 340 + "x": 450, + "y": 190 }, "outputs": [ "default" ] }, { - "id": "check-health", - "type": "action.run_command", - "label": "Check Session Health", + "id": "meeting-send", + "type": "meeting.send", + "label": "Send Opening Prompt", "config": { - "command": "node -e \"const fs = require('node:fs');const path = require('node:path');const { pathToFileURL } = require('node:url');const cwd = process.cwd();const mirrorMarker = `${path.sep}.bosun${path.sep}workspaces${path.sep}`.toLowerCase();let repoRoot = cwd;if (cwd.toLowerCase().includes(mirrorMarker)) {const sourceRepoRoot = path.resolve(cwd, '..', '..', '..', '..');if (fs.existsSync(path.join(sourceRepoRoot, 'infra', 'session-tracker.mjs'))) repoRoot = sourceRepoRoot;}const trackerModuleUrl = pathToFileURL(path.join(repoRoot, 'infra', 'session-tracker.mjs')).href;import(trackerModuleUrl).then(({ getSessionTracker }) => {const tracker = getSessionTracker();const sessions = tracker.getActiveSessions().map((session) => {const progress = tracker.getProgressStatus(session.taskId);return {id: session.taskId,taskId: session.taskId,taskTitle: session.taskTitle || null,status: progress.status,idleMs: progress.idleMs,totalEvents: progress.totalEvents,elapsedMs: progress.elapsedMs,lastEventType: progress.lastEventType,recommendation: progress.recommendation,tokenPercent: null};});console.log(JSON.stringify(sessions));}).catch((err) => { console.error(err?.stack || String(err)); process.exit(1); });\"", - "continueOnError": true + "message": "{{openingMessage}}", + "role": "system" }, "position": { - "x": 200, - "y": 490 + "x": 450, + "y": 320 }, "outputs": [ "default" ] }, { - "id": "has-issues", - "type": "condition.expression", - "label": "Any Unhealthy?", + "id": "meeting-vision", + "type": "meeting.vision", + "label": "Analyze Meeting Frame", "config": { - "expression": "(() => { const sessions = (() => {const raw = String($ctx.getNodeOutput('check-health')?.output || '[]');const lines = raw.split(/\\r?\\n/).map((line) => line.trim()).filter(Boolean);const candidate = lines.length ? lines[lines.length - 1] : '[]';try {const parsed = JSON.parse(candidate);return Array.isArray(parsed) ? parsed : [];} catch {return [];}})(); const maxIdleMs = Number($data?.maxIdleMs || 600000); const maxTokenPercent = Number($data?.maxTokenPercent || 85); return sessions.some((item) => { const status = String(item?.status || '').toLowerCase(); const idleMs = Number(item?.idleMs || 0); const tokenPercent = Number(item?.tokenPercent); return status === 'idle' || status === 'stalled' || status === 'timeout' || idleMs > maxIdleMs || (Number.isFinite(tokenPercent) && tokenPercent >= maxTokenPercent); }); })()" + "frameDataUrl": "{{frameDataUrl}}", + "source": "{{visionSource}}", + "prompt": "{{visionPrompt}}", + "visionModel": "{{visionModel}}", + "minIntervalMs": "{{visionMinIntervalMs}}", + "forceAnalyze": "{{forceVisionAnalyze}}", + "failOnError": false }, "position": { - "x": 200, - "y": 640 + "x": 450, + "y": 450 }, "outputs": [ "default" ] }, { - "id": "auto-continue", - "type": "action.continue_session", - "label": "Auto-Continue Stalled", + "id": "meeting-transcript", + "type": "meeting.transcript", + "label": "Capture Transcript", "config": { - "prompt": "You appear to have stalled. Please continue working on the current task.", - "strategy": "continue", - "timeoutMs": 300000 + "includeMessages": true }, "position": { - "x": 100, - "y": 800 + "x": 450, + "y": 580 }, "outputs": [ "default" ] }, { - "id": "alert-hung", - "type": "notify.telegram", - "label": "Alert Hung Sessions", + "id": "wake-phrase-trigger", + "type": "trigger.meeting.wake_phrase", + "label": "Wake Phrase Trigger", "config": { - "message": ":dot: Agent session appears hung — auto-continue attempted. Check status." + "wakePhrase": "{{wakePhrase}}", + "text": "{{meeting-transcript.transcript}}", + "mode": "contains" }, "position": { - "x": 100, - "y": 950 + "x": 450, + "y": 710 }, "outputs": [ "default" ] }, { - "id": "all-healthy", - "type": "notify.log", - "label": "Sessions Healthy", + "id": "guard-transcript", + "type": "condition.expression", + "label": "Wake Phrase + Transcript Guard", "config": { - "message": "All active agent sessions are healthy", - "level": "info" + "expression": "(() => { const transcript = String($ctx.getNodeOutput('meeting-transcript')?.transcript || ''); const minChars = Number($data?.minTranscriptChars || 0); const hasWake = $ctx.getNodeOutput('wake-phrase-trigger')?.triggered === true; return transcript.length >= minChars && hasWake; })()" }, "position": { "x": 450, - "y": 640 + "y": 840 }, "outputs": [ "default" ] }, { - "id": "no-sessions", - "type": "notify.log", - "label": "No Active Sessions", + "id": "notify-guard-failed", + "type": "notify.telegram", + "label": "Notify Guard Failed", "config": { - "message": "No active agent sessions to monitor", - "level": "info" - }, - "position": { - "x": 600, - "y": 490 + "message": "{{notifyPrefix}} Meeting transcript guard failed for **{{sessionTitle}}**. Wake phrase missing or transcript shorter than {{minTranscriptChars}} chars." }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->list-sessions", - "source": "trigger", - "target": "list-sessions", - "sourcePort": "default" - }, - { - "id": "list-sessions->has-active", - "source": "list-sessions", - "target": "has-active", - "sourcePort": "default" - }, - { - "id": "has-active->check-health", - "source": "has-active", - "target": "check-health", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "has-active->no-sessions", - "source": "has-active", - "target": "no-sessions", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "check-health->has-issues", - "source": "check-health", - "target": "has-issues", - "sourcePort": "default" - }, - { - "id": "has-issues->auto-continue", - "source": "has-issues", - "target": "auto-continue", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "has-issues->all-healthy", - "source": "has-issues", - "target": "all-healthy", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "auto-continue->alert-hung", - "source": "auto-continue", - "target": "alert-hung", - "sourcePort": "default" - } - ] - }, - { - "id": "template-custom-agent", - "name": "Custom Agent Profile", - "description": "Starter template for creating a custom agent profile with configurable validation, notification, and completion gates. Duplicate and customize to match your specific workflow.", - "category": "agents", - "categoryLabel": "Agents", - "categoryIcon": ":bot:", - "categoryOrder": 2, - "tags": [ - "custom", - "agent", - "starter" - ], - "nodeCount": 7, - "edgeCount": 6, - "recommended": false, - "enabled": false, - "trigger": "trigger.manual", - "variables": { - "agentName": "my-custom-agent" - }, - "metadata": { - "author": "bosun", - "version": 1, - "createdAt": "2025-02-24T00:00:00Z", - "templateVersion": "1.0.0", - "tags": [ - "custom", - "agent", - "starter" - ] - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.manual", - "label": "Start", - "config": {}, "position": { - "x": 400, - "y": 50 + "x": 840, + "y": 840 }, "outputs": [ "default" ] }, { - "id": "set-context", - "type": "action.set_variable", - "label": "Set Context", + "id": "execute-child-workflow", + "type": "action.execute_workflow", + "label": "Run Child Workflow", "config": { - "key": "agentProfile", - "value": "{{agentName}}" + "workflowId": "{{childWorkflowId}}", + "mode": "sync", + "inheritContext": true, + "includeKeys": [ + "meetingSessionId", + "sessionTitle", + "wakePhrase", + "meetingVisionSummary" + ], + "input": { + "parentWorkflowId": "{{_workflowId}}", + "parentRunId": "{{_workflowRunId}}", + "sessionTitle": "{{sessionTitle}}", + "wakePhrase": "{{wakePhrase}}", + "transcript": "{{meeting-transcript.transcript}}", + "visionSummary": "{{meeting-vision.summary}}" + }, + "outputVariable": "childWorkflowResult", + "failOnChildError": false }, "position": { - "x": 400, - "y": 180 + "x": 450, + "y": 980 }, "outputs": [ "default" ] }, { - "id": "run-agent", - "type": "action.run_agent", - "label": "Run Agent", + "id": "child-workflow-ok", + "type": "condition.expression", + "label": "Child Workflow Succeeded?", "config": { - "prompt": "# Custom Agent Task\n\nTask: {{taskTitle}}\n{{taskDescription}}", - "sdk": "auto" + "expression": "$ctx.getNodeOutput('execute-child-workflow')?.success === true" }, "position": { - "x": 400, - "y": 310 + "x": 450, + "y": 1110 }, "outputs": [ "default" ] }, { - "id": "verify", - "type": "validation.tests", - "label": "Run Verification", + "id": "notify-chain-success", + "type": "notify.telegram", + "label": "Notify Chain Success", "config": { - "command": "npm test" + "message": "{{notifyPrefix}} Meeting workflow chained into **{{childWorkflowId}}** successfully for **{{sessionTitle}}**." }, "position": { - "x": 400, - "y": 440 + "x": 250, + "y": 1230 }, "outputs": [ "default" ] }, { - "id": "check-result", - "type": "condition.expression", - "label": "Passed?", + "id": "notify-chain-failed", + "type": "notify.telegram", + "label": "Notify Chain Failure", "config": { - "expression": "$ctx.getNodeOutput('verify')?.passed === true" + "message": ":alert: Meeting flow completed but child workflow **{{childWorkflowId}}** failed or timed out for **{{sessionTitle}}**." }, "position": { - "x": 400, - "y": 570 + "x": 650, + "y": 1230 }, "outputs": [ "default" ] }, { - "id": "complete", - "type": "action.update_task_status", - "label": "Mark Complete", + "id": "meeting-finalize", + "type": "meeting.finalize", + "label": "Finalize Meeting Session", "config": { - "taskId": "{{taskId}}", - "status": "done" + "status": "{{finalizeDisposition}}", + "note": "Meeting subworkflow chain finalized." }, "position": { - "x": 200, - "y": 700 + "x": 450, + "y": 1360 }, "outputs": [ "default" ] }, { - "id": "fail-notify", + "id": "final-log", "type": "notify.log", - "label": "Log Failure", + "label": "Record Final Outcome", "config": { - "message": "Custom agent verification failed for {{taskId}}", - "level": "warn" + "message": "Meeting orchestration finalized for {{sessionTitle}} with child workflow {{childWorkflowId}}", + "level": "info" }, "position": { - "x": 600, - "y": 700 + "x": 450, + "y": 1490 }, "outputs": [ "default" @@ -5232,90 +4687,157 @@ ], "edges": [ { - "id": "trigger->set-context", + "id": "trigger->meeting-start", "source": "trigger", - "target": "set-context", + "target": "meeting-start", "sourcePort": "default" }, { - "id": "set-context->run-agent", - "source": "set-context", - "target": "run-agent", + "id": "meeting-start->meeting-send", + "source": "meeting-start", + "target": "meeting-send", "sourcePort": "default" }, { - "id": "run-agent->verify", - "source": "run-agent", - "target": "verify", + "id": "meeting-send->meeting-vision", + "source": "meeting-send", + "target": "meeting-vision", "sourcePort": "default" }, { - "id": "verify->check-result", - "source": "verify", - "target": "check-result", + "id": "meeting-vision->meeting-transcript", + "source": "meeting-vision", + "target": "meeting-transcript", "sourcePort": "default" }, { - "id": "check-result->complete", - "source": "check-result", - "target": "complete", - "sourcePort": "default", + "id": "meeting-transcript->wake-phrase-trigger", + "source": "meeting-transcript", + "target": "wake-phrase-trigger", + "sourcePort": "default" + }, + { + "id": "wake-phrase-trigger->guard-transcript", + "source": "wake-phrase-trigger", + "target": "guard-transcript", + "sourcePort": "default" + }, + { + "id": "guard-transcript->execute-child-workflow", + "source": "guard-transcript", + "target": "execute-child-workflow", + "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "check-result->fail-notify", - "source": "check-result", - "target": "fail-notify", - "sourcePort": "default", + "id": "guard-transcript->notify-guard-failed", + "source": "guard-transcript", + "target": "notify-guard-failed", + "sourcePort": "no", + "condition": "$output?.result !== true" + }, + { + "id": "execute-child-workflow->child-workflow-ok", + "source": "execute-child-workflow", + "target": "child-workflow-ok", + "sourcePort": "default" + }, + { + "id": "child-workflow-ok->notify-chain-success", + "source": "child-workflow-ok", + "target": "notify-chain-success", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "child-workflow-ok->notify-chain-failed", + "source": "child-workflow-ok", + "target": "notify-chain-failed", + "sourcePort": "no", "condition": "$output?.result !== true" + }, + { + "id": "notify-chain-success->meeting-finalize", + "source": "notify-chain-success", + "target": "meeting-finalize", + "sourcePort": "default" + }, + { + "id": "notify-chain-failed->meeting-finalize", + "source": "notify-chain-failed", + "target": "meeting-finalize", + "sourcePort": "default" + }, + { + "id": "notify-guard-failed->meeting-finalize", + "source": "notify-guard-failed", + "target": "meeting-finalize", + "sourcePort": "default" + }, + { + "id": "meeting-finalize->final-log", + "source": "meeting-finalize", + "target": "final-log", + "sourcePort": "default" } ] }, { - "id": "template-frontend-agent", - "name": "Frontend Agent", - "description": "Front-end development agent that validates work by taking screenshots, storing them as evidence, and having an independent model verify the implementation matches the task requirements before marking complete.", + "id": "template-backend-agent", + "name": "Task Completion Agent", + "description": "General-purpose task completion agent with a test-first methodology. Writes tests first, implements the feature, validates with build + lint, then creates a PR. Works with any language/framework — commands are auto-detected from your project or fully customizable.", "category": "agents", "categoryLabel": "Agents", "categoryIcon": ":bot:", "categoryOrder": 2, "tags": [ - "frontend", "agent", - "validation", - "screenshot" + "task-completion", + "test-first", + "tdd", + "multi-language" ], - "nodeCount": 15, - "edgeCount": 17, - "recommended": false, + "nodeCount": 29, + "edgeCount": 28, + "recommended": true, "enabled": true, "trigger": "trigger.task_assigned", "variables": { - "devServerUrl": "http://localhost:3000", - "evidenceDir": ".bosun/evidence", - "screenshotCount": 3 + "testCommand": "npm test", + "buildCommand": "npm run build", + "lintCommand": "", + "baseBranch": "main", + "protectedBranches": [ + "main", + "master", + "develop", + "production" + ], + "agentSdk": "auto", + "timeoutMs": 3600000, + "autoFixTimeoutMs": 1200000 }, "metadata": { "author": "bosun", - "version": 1, - "createdAt": "2025-02-24T00:00:00Z", - "templateVersion": "1.0.0", + "version": 2, + "createdAt": "2025-02-25T00:00:00Z", + "templateVersion": "2.0.0", "tags": [ - "frontend", "agent", - "validation", - "screenshot" + "task-completion", + "test-first", + "tdd", + "multi-language" ], "replaces": { - "module": "agent-hooks.mjs", + "module": "primary-agent.mjs", "functions": [ - "screenshotValidation", - "evidenceCollection" + "runAgentWithTask" ], "calledFrom": [ - "monitor.mjs:startFreshSession" + "task-executor.mjs:executeTask" ], - "description": "Replaces hardcoded frontend agent profile with a visual workflow. Screenshot capture, model verification, and evidence collection are explicit steps." + "description": "Replaces generic agent task execution with a structured workflow. Test-first methodology, build/lint gates, and Bosun-managed PR lifecycle handoff are enforced as distinct workflow stages. Works with any language/framework." } }, "nodes": [ @@ -5323,10 +4845,7 @@ "id": "trigger", "type": "trigger.task_assigned", "label": "Task Assigned", - "config": { - "agentType": "frontend", - "taskPattern": "feat\\(.*\\)|fix\\(.*\\)|style\\(.*\\)|ui|frontend|css|component" - }, + "config": {}, "position": { "x": 400, "y": 50 @@ -5336,668 +4855,481 @@ ] }, { - "id": "select-profile", - "type": "agent.select_profile", - "label": "Select Agent Profile", + "id": "plan-work", + "type": "agent.run_planner", + "label": "Plan Implementation", "config": { - "profiles": { - "frontend": { - "titlePatterns": [ - "ui", - "frontend", - "css", - "component", - "page", - "layout", - "style", - "design" - ], - "tags": [ - "frontend", - "ui", - "css", - "component" - ] - }, - "fullstack": { - "titlePatterns": [ - "api.*ui", - "full.?stack" - ], - "tags": [ - "fullstack" - ] - } - }, - "default": "frontend" + "prompt": "Analyze the task requirements and create a step-by-step implementation plan. Identify which files need to be modified, what tests need to be written, and any API contracts to maintain.", + "outputVariable": "plan", + "repoMapQuery": "{{taskTitle}} {{taskDescription}}", + "repoMapFileLimit": 8 }, "position": { "x": 400, - "y": 160 + "y": 180 }, "outputs": [ "default" ] }, { - "id": "run-agent", + "id": "write-tests", "type": "action.run_agent", - "label": "Run Frontend Agent", + "label": "Write Tests First", "config": { - "prompt": "# Frontend Development Task\n\n## Task: {{taskTitle}}\n\n## Description\n{{taskDescription}}\n\n## Special Instructions\nYou are a **frontend specialist** agent. Your focus areas:\n- HTML/CSS layout and styling\n- JavaScript/TypeScript UI logic\n- Component architecture and state management\n- Responsive design and accessibility\n- Visual accuracy matching design specifications\n\n## CRITICAL: Evidence Collection\nAfter completing your implementation:\n1. Start the dev server if not running\n2. Take screenshots of ALL pages/components you changed\n3. Save each screenshot to `.bosun/evidence/` directory\n4. Include screenshots of: main view, mobile view, any interactive states\n5. Name files descriptively: `homepage-desktop.png`, `modal-open.png`, etc.\n6. Capture at least {{screenshotCount}} key screenshots across target states/viewports.\n\n## Workflow\n1. Read task requirements carefully\n2. Implement all frontend changes\n3. Run `npm run build` to verify no errors\n4. Run `npm run lint` to verify no warnings\n5. Start dev server and screenshot all changed pages\n6. Commit and push\n\n## Do NOT mark task complete yourself — the validation workflow handles that.", - "sdk": "auto", - "cwd": "{{worktreePath}}", - "timeoutMs": 7200000, - "agentProfile": "frontend" + "prompt": "# Test-First Development\n\nBased on the plan:\n{{plan}}\n\nWrite comprehensive tests FIRST before any implementation:\n1. Unit tests for new functions/methods\n2. Integration tests for API endpoints if applicable\n3. Edge cases and error scenarios\n\nUse the project's test command: {{testCommand}}\nCommit with message \"test: add tests for [feature]\"", + "sdk": "{{agentSdk}}", + "timeoutMs": "{{timeoutMs}}" }, "position": { "x": 400, - "y": 280 + "y": 330 }, "outputs": [ "default" ] }, { - "id": "verify-build", - "type": "validation.build", - "label": "Verify Build", + "id": "implement", + "type": "action.run_agent", + "label": "Implement Feature", "config": { - "command": "npm run build", - "cwd": "{{worktreePath}}", - "zeroWarnings": true + "prompt": "# Implement Feature\n\nThe tests have been written. Now implement the feature to make them pass:\n1. Follow existing code conventions\n2. Add proper error handling\n3. Ensure all new tests pass\n4. Do NOT modify the tests — make the code fit the contract\n\nRun `{{testCommand}}` after implementation.\nCommit with message \"feat: implement [feature]\"", + "sdk": "{{agentSdk}}", + "timeoutMs": "{{timeoutMs}}" }, "position": { - "x": 150, - "y": 420 + "x": 400, + "y": 490 }, "outputs": [ "default" ] }, { - "id": "verify-lint", - "type": "validation.lint", - "label": "Verify Lint", + "id": "main-build", + "type": "validation.build", + "label": "Build Check", "config": { - "command": "npm run lint", - "cwd": "{{worktreePath}}" + "command": "{{buildCommand}}", + "zeroWarnings": true }, "position": { - "x": 650, - "y": 420 + "x": 400, + "y": 0 }, "outputs": [ "default" ] }, { - "id": "screenshot-desktop", - "type": "validation.screenshot", - "label": "Screenshot Desktop", + "id": "main-test", + "type": "validation.tests", + "label": "Test Run", "config": { - "url": "{{devServerUrl}}", - "outputDir": "{{evidenceDir}}", - "filename": "desktop-{{taskId}}.png", - "viewport": { - "width": 1920, - "height": 1080 - } + "command": "{{testCommand}}" }, "position": { - "x": 100, - "y": 560 + "x": 400, + "y": 130 }, "outputs": [ "default" ] }, { - "id": "screenshot-tablet", - "type": "validation.screenshot", - "label": "Screenshot Tablet", + "id": "main-lint", + "type": "validation.lint", + "label": "Lint Check", "config": { - "url": "{{devServerUrl}}", - "outputDir": "{{evidenceDir}}", - "filename": "tablet-{{taskId}}.png", - "viewport": { - "width": 768, - "height": 1024 - } + "command": "{{lintCommand}}" }, "position": { "x": 400, - "y": 560 + "y": 260 }, "outputs": [ "default" ] }, { - "id": "screenshot-mobile", - "type": "validation.screenshot", - "label": "Screenshot Mobile", + "id": "all-passed", + "type": "condition.expression", + "label": "All Checks Passed?", "config": { - "url": "{{devServerUrl}}", - "outputDir": "{{evidenceDir}}", - "filename": "mobile-{{taskId}}.png", - "viewport": { - "width": 375, - "height": 812 - } + "expression": "$ctx.getNodeOutput('main-build')?.passed === true && $ctx.getNodeOutput('main-test')?.passed === true && $ctx.getNodeOutput('main-lint')?.passed === true" }, "position": { - "x": 700, - "y": 560 + "x": 400, + "y": 1040 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "collect-evidence", - "type": "agent.evidence_collect", - "label": "Collect Evidence", + "id": "push-branch", + "type": "action.push_branch", + "label": "Push Branch", "config": { - "evidenceDir": "{{evidenceDir}}" + "worktreePath": "{{worktreePath}}", + "branch": "{{branch}}", + "baseBranch": "{{baseBranch}}", + "rebaseBeforePush": true, + "emptyDiffGuard": true, + "protectedBranches": "{{protectedBranches}}" }, "position": { - "x": 400, - "y": 700 + "x": 250, + "y": 1110 }, "outputs": [ "default" ] }, { - "id": "model-review", - "type": "validation.model_review", - "label": "Model Verification", + "id": "create-pr", + "type": "action.create_pr", + "label": "Handoff PR Lifecycle", "config": { - "evidenceDir": "{{evidenceDir}}", - "originalTask": "{{taskTitle}}: {{taskDescription}}", - "criteria": "Visual implementation matches requirements. No broken layouts. Responsive design works across viewports. No console errors visible.", - "strictMode": true + "title": "feat: {{taskTitle}}", + "body": "Implements backend task with test-first methodology.\n\n**Plan:**\n{{plan}}\n\nAll tests passing. Bosun lifecycle handoff ready.", + "branch": "{{branch}}", + "baseBranch": "{{baseBranch}}", + "failOnError": true, + "maxRetries": 3, + "retryDelayMs": 15000, + "continueOnError": true }, "position": { - "x": 400, - "y": 840 + "x": 250, + "y": 1170 }, "outputs": [ "default" ] }, { - "id": "check-review", + "id": "main-pr-ok", "type": "condition.expression", - "label": "Review Passed?", + "label": "PR Created?", "config": { - "expression": "$output?.model_review?.passed === true || $data?.modelReviewPassed === true" + "expression": "Boolean($ctx.getNodeOutput($edge.source)?.prNumber || $ctx.getNodeOutput($edge.source)?.prUrl)" }, "position": { "x": 400, - "y": 960 + "y": 0 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "mark-success", + "id": "main-set-inreview", "type": "action.update_task_status", - "label": "Mark Task Done", + "label": "Set In-Review", "config": { "taskId": "{{taskId}}", - "status": "done" + "status": "inreview", + "taskTitle": "{{taskTitle}}" }, "position": { - "x": 200, - "y": 1080 + "x": 300, + "y": 130 }, "outputs": [ "default" ] }, { - "id": "notify-success", - "type": "notify.telegram", - "label": "Notify Success", + "id": "main-handoff-progressor", + "type": "action.execute_workflow", + "label": "Handoff PR Progressor", "config": { - "message": ":check: Frontend task **{{taskTitle}}** passed visual verification and is complete." + "workflowId": "template-bosun-pr-progressor", + "mode": "dispatch", + "input": { + "taskId": "{{taskId}}", + "taskTitle": "{{taskTitle}}", + "branch": "{{branch}}", + "baseBranch": "{{baseBranch}}" + } }, "position": { - "x": 200, - "y": 1200 + "x": 300, + "y": 260 }, "outputs": [ "default" ] }, { - "id": "notify-failure", - "type": "notify.telegram", - "label": "Notify Review Failed", + "id": "notify-done", + "type": "notify.log", + "label": "Task Complete", "config": { - "message": "❌ Frontend task **{{taskTitle}}** failed visual verification.\nEvidence dir: `{{evidenceDir}}`\nReason: `{{model-review.reason}}`\nEvidence count: `{{model-review.evidenceCount}}`\nReview output: {{model-review.reviewOutput}}" + "message": "Task completion agent finished task — PR lifecycle handoff recorded", + "level": "info" }, "position": { - "x": 600, - "y": 1080 + "x": 180, + "y": 1320 }, "outputs": [ "default" ] }, { - "id": "log-failure", - "type": "notify.log", - "label": "Log Failure", + "id": "notify-pr-failed", + "type": "notify.telegram", + "label": "Escalate Lifecycle Handoff Failure", "config": { - "message": "Frontend verification failed for {{taskId}}: evidenceDir={{evidenceDir}} reason={{model-review.reason}} evidenceCount={{model-review.evidenceCount}}", - "level": "warn" + "message": ":alert: Task completion agent passed validation for {{taskTitle}} but failed to record Bosun PR lifecycle handoff after retries. Manual follow-up required." }, "position": { - "x": 600, - "y": 1200 + "x": 420, + "y": 1320 }, "outputs": [ "default" ] - } - ], - "edges": [ - { - "id": "trigger->select-profile", - "source": "trigger", - "target": "select-profile", - "sourcePort": "default" }, { - "id": "select-profile->run-agent", - "source": "select-profile", - "target": "run-agent", - "sourcePort": "default" + "id": "set-validation-summary", + "type": "action.set_variable", + "label": "Summarize Validation Output", + "config": { + "key": "validationSummary", + "value": "(() => { const implement = $ctx.getNodeOutput('implement') || {}; const build = $ctx.getNodeOutput('main-build') || {}; const test = $ctx.getNodeOutput('main-test') || {}; const lint = $ctx.getNodeOutput('main-lint') || {}; return ['- implement.success: ' + (implement.success === true), '- build.passed: ' + (build.passed === true), '- test-final.passed: ' + (test.passed === true), '- lint.passed: ' + (lint.passed === true), '', 'Build output:', String(build.output || '').slice(0, 6000), '', 'Test output:', String(test.output || '').slice(0, 6000), '', 'Lint output:', String(lint.output || '').slice(0, 6000)].join('\\n'); })()", + "isExpression": true + }, + "position": { + "x": 620, + "y": 1090 + }, + "outputs": [ + "default" + ] }, { - "id": "run-agent->verify-build", - "source": "run-agent", - "target": "verify-build", - "sourcePort": "default" + "id": "auto-fix", + "type": "action.run_agent", + "label": "Auto-Fix Validation Failures", + "config": { + "prompt": "# Fix Validation Failures\n\nThe first validation pass failed for task **{{taskTitle}}**.\n\nPlan:\n{{plan}}\n\nCurrent validation outputs:\n{{validationSummary}}\n\nFix the code so build/tests/lint pass.\nDo NOT weaken, remove, or bypass tests.\nKeep the original task scope.\n\nRun build + tests + lint locally before finishing.\nCommit with message \"fix: address validation failures\"", + "sdk": "{{agentSdk}}", + "timeoutMs": "{{autoFixTimeoutMs}}" + }, + "position": { + "x": 620, + "y": 1170 + }, + "outputs": [ + "default" + ] }, { - "id": "run-agent->verify-lint", - "source": "run-agent", - "target": "verify-lint", - "sourcePort": "default" + "id": "retry-build", + "type": "validation.build", + "label": "Build Check", + "config": { + "command": "{{buildCommand}}", + "zeroWarnings": true + }, + "position": { + "x": 400, + "y": 0 + }, + "outputs": [ + "default" + ] }, { - "id": "verify-build->screenshot-desktop", - "source": "verify-build", - "target": "screenshot-desktop", - "sourcePort": "default" + "id": "retry-test", + "type": "validation.tests", + "label": "Test Run", + "config": { + "command": "{{testCommand}}" + }, + "position": { + "x": 400, + "y": 130 + }, + "outputs": [ + "default" + ] }, { - "id": "verify-build->screenshot-tablet", - "source": "verify-build", - "target": "screenshot-tablet", - "sourcePort": "default" + "id": "retry-lint", + "type": "validation.lint", + "label": "Lint Check", + "config": { + "command": "{{lintCommand}}" + }, + "position": { + "x": 400, + "y": 260 + }, + "outputs": [ + "default" + ] }, { - "id": "verify-build->screenshot-mobile", - "source": "verify-build", - "target": "screenshot-mobile", - "sourcePort": "default" + "id": "retry-passed", + "type": "condition.expression", + "label": "Retry Checks Passed?", + "config": { + "expression": "$ctx.getNodeOutput('retry-build')?.passed === true && $ctx.getNodeOutput('retry-test')?.passed === true && $ctx.getNodeOutput('retry-lint')?.passed === true" + }, + "position": { + "x": 620, + "y": 1690 + }, + "outputs": [ + "yes", + "no" + ] }, { - "id": "verify-lint->screenshot-desktop", - "source": "verify-lint", - "target": "screenshot-desktop", - "sourcePort": "default" - }, - { - "id": "screenshot-desktop->collect-evidence", - "source": "screenshot-desktop", - "target": "collect-evidence", - "sourcePort": "default" - }, - { - "id": "screenshot-tablet->collect-evidence", - "source": "screenshot-tablet", - "target": "collect-evidence", - "sourcePort": "default" - }, - { - "id": "screenshot-mobile->collect-evidence", - "source": "screenshot-mobile", - "target": "collect-evidence", - "sourcePort": "default" - }, - { - "id": "collect-evidence->model-review", - "source": "collect-evidence", - "target": "model-review", - "sourcePort": "default" - }, - { - "id": "model-review->check-review", - "source": "model-review", - "target": "check-review", - "sourcePort": "default" - }, - { - "id": "check-review->mark-success", - "source": "check-review", - "target": "mark-success", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "check-review->notify-failure", - "source": "check-review", - "target": "notify-failure", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "mark-success->notify-success", - "source": "mark-success", - "target": "notify-success", - "sourcePort": "default" - }, - { - "id": "notify-failure->log-failure", - "source": "notify-failure", - "target": "log-failure", - "sourcePort": "default" - } - ] - }, - { - "id": "template-meeting-subworkflow-chain", - "name": "Meeting Orchestrator + Subworkflow Chain", - "description": "Runs a meeting session start/send/vision/transcript/finalize flow, applies a wake-phrase trigger + transcript quality guard, then invokes a child workflow via action.execute_workflow for post-meeting automation.", - "category": "agents", - "categoryLabel": "Agents", - "categoryIcon": ":bot:", - "categoryOrder": 2, - "tags": [ - "meeting", - "subworkflow", - "chaining", - "agents" - ], - "nodeCount": 14, - "edgeCount": 15, - "recommended": false, - "enabled": false, - "trigger": "trigger.manual", - "variables": { - "sessionTitle": "Sprint Planning Sync", - "meetingExecutor": "codex", - "wakePhrase": "bosun wake", - "openingMessage": "Kick off planning review. Capture decisions, blockers, and next actions.", - "frameDataUrl": "", - "visionSource": "screen", - "visionPrompt": "Summarize visible meeting context, shared docs, and any blockers shown.", - "visionModel": "", - "visionMinIntervalMs": 1500, - "forceVisionAnalyze": false, - "minTranscriptChars": 140, - "childWorkflowId": "template-task-planner", - "finalizeDisposition": "completed", - "notifyPrefix": ":memo:" - }, - "metadata": { - "author": "bosun", - "version": 1, - "createdAt": "2026-02-28T00:00:00Z", - "templateVersion": "1.0.0", - "tags": [ - "meeting", - "subworkflow", - "chaining", - "agents" - ], - "requiredTemplates": [ - "template-task-planner" - ] - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.manual", - "label": "Start Meeting Orchestration", - "config": {}, - "position": { - "x": 450, - "y": 50 - }, - "outputs": [ - "default" - ] - }, - { - "id": "meeting-start", - "type": "meeting.start", - "label": "Meeting Start", - "config": { - "title": "{{sessionTitle}}", - "executor": "{{meetingExecutor}}", - "wakePhrase": "{{wakePhrase}}", - "includeTaskContext": true - }, - "position": { - "x": 450, - "y": 190 - }, - "outputs": [ - "default" - ] - }, - { - "id": "meeting-send", - "type": "meeting.send", - "label": "Send Opening Prompt", - "config": { - "message": "{{openingMessage}}", - "role": "system" - }, - "position": { - "x": 450, - "y": 320 - }, - "outputs": [ - "default" - ] - }, - { - "id": "meeting-vision", - "type": "meeting.vision", - "label": "Analyze Meeting Frame", - "config": { - "frameDataUrl": "{{frameDataUrl}}", - "source": "{{visionSource}}", - "prompt": "{{visionPrompt}}", - "visionModel": "{{visionModel}}", - "minIntervalMs": "{{visionMinIntervalMs}}", - "forceAnalyze": "{{forceVisionAnalyze}}", - "failOnError": false - }, - "position": { - "x": 450, - "y": 450 - }, - "outputs": [ - "default" - ] - }, - { - "id": "meeting-transcript", - "type": "meeting.transcript", - "label": "Capture Transcript", + "id": "push-branch-retry", + "type": "action.push_branch", + "label": "Push Branch (Retry)", "config": { - "includeMessages": true + "worktreePath": "{{worktreePath}}", + "branch": "{{branch}}", + "baseBranch": "{{baseBranch}}", + "rebaseBeforePush": true, + "emptyDiffGuard": true, + "protectedBranches": "{{protectedBranches}}" }, "position": { "x": 450, - "y": 580 + "y": 1760 }, "outputs": [ "default" ] }, { - "id": "wake-phrase-trigger", - "type": "trigger.meeting.wake_phrase", - "label": "Wake Phrase Trigger", + "id": "create-pr-retry", + "type": "action.create_pr", + "label": "Handoff PR Lifecycle (After Retry)", "config": { - "wakePhrase": "{{wakePhrase}}", - "text": "{{meeting-transcript.transcript}}", - "mode": "contains" + "title": "feat: {{taskTitle}}", + "body": "Implements backend task after auto-fix retry.\n\n**Plan:**\n{{plan}}\n\nValidation passed after remediation. Bosun lifecycle handoff ready.", + "branch": "{{branch}}", + "baseBranch": "{{baseBranch}}", + "failOnError": true, + "maxRetries": 3, + "retryDelayMs": 15000, + "continueOnError": true }, "position": { "x": 450, - "y": 710 + "y": 1820 }, "outputs": [ "default" ] }, { - "id": "guard-transcript", + "id": "retry-pr-ok", "type": "condition.expression", - "label": "Wake Phrase + Transcript Guard", + "label": "PR Created?", "config": { - "expression": "(() => { const transcript = String($ctx.getNodeOutput('meeting-transcript')?.transcript || ''); const minChars = Number($data?.minTranscriptChars || 0); const hasWake = $ctx.getNodeOutput('wake-phrase-trigger')?.triggered === true; return transcript.length >= minChars && hasWake; })()" + "expression": "Boolean($ctx.getNodeOutput($edge.source)?.prNumber || $ctx.getNodeOutput($edge.source)?.prUrl)" }, "position": { - "x": 450, - "y": 840 + "x": 400, + "y": 0 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "notify-guard-failed", - "type": "notify.telegram", - "label": "Notify Guard Failed", + "id": "retry-set-inreview", + "type": "action.update_task_status", + "label": "Set In-Review", "config": { - "message": "{{notifyPrefix}} Meeting transcript guard failed for **{{sessionTitle}}**. Wake phrase missing or transcript shorter than {{minTranscriptChars}} chars." + "taskId": "{{taskId}}", + "status": "inreview", + "taskTitle": "{{taskTitle}}" }, "position": { - "x": 840, - "y": 840 + "x": 300, + "y": 130 }, "outputs": [ "default" ] }, { - "id": "execute-child-workflow", + "id": "retry-handoff-progressor", "type": "action.execute_workflow", - "label": "Run Child Workflow", + "label": "Handoff PR Progressor", "config": { - "workflowId": "{{childWorkflowId}}", - "mode": "sync", - "inheritContext": true, - "includeKeys": [ - "meetingSessionId", - "sessionTitle", - "wakePhrase", - "meetingVisionSummary" - ], + "workflowId": "template-bosun-pr-progressor", + "mode": "dispatch", "input": { - "parentWorkflowId": "{{_workflowId}}", - "parentRunId": "{{_workflowRunId}}", - "sessionTitle": "{{sessionTitle}}", - "wakePhrase": "{{wakePhrase}}", - "transcript": "{{meeting-transcript.transcript}}", - "visionSummary": "{{meeting-vision.summary}}" - }, - "outputVariable": "childWorkflowResult", - "failOnChildError": false + "taskId": "{{taskId}}", + "taskTitle": "{{taskTitle}}", + "branch": "{{branch}}", + "baseBranch": "{{baseBranch}}" + } }, "position": { - "x": 450, - "y": 980 + "x": 300, + "y": 260 }, "outputs": [ "default" ] }, { - "id": "child-workflow-ok", - "type": "condition.expression", - "label": "Child Workflow Succeeded?", + "id": "notify-done-retry", + "type": "notify.log", + "label": "Task Complete (After Retry)", "config": { - "expression": "$ctx.getNodeOutput('execute-child-workflow')?.success === true" + "message": "Task completion agent finished task after retry — PR lifecycle handoff recorded", + "level": "info" }, "position": { - "x": 450, - "y": 1110 + "x": 360, + "y": 1980 }, "outputs": [ "default" ] }, { - "id": "notify-chain-success", + "id": "notify-fail", "type": "notify.telegram", - "label": "Notify Chain Success", + "label": "Checks Failed", "config": { - "message": "{{notifyPrefix}} Meeting workflow chained into **{{childWorkflowId}}** successfully for **{{sessionTitle}}**." + "message": ":alert: Task completion agent: validation failed for task {{taskTitle}} even after remediation pass. Manual review needed." }, "position": { - "x": 250, - "y": 1230 + "x": 820, + "y": 1820 }, "outputs": [ "default" ] }, { - "id": "notify-chain-failed", + "id": "notify-pr-failed-retry", "type": "notify.telegram", - "label": "Notify Chain Failure", - "config": { - "message": ":alert: Meeting flow completed but child workflow **{{childWorkflowId}}** failed or timed out for **{{sessionTitle}}**." - }, - "position": { - "x": 650, - "y": 1230 - }, - "outputs": [ - "default" - ] - }, - { - "id": "meeting-finalize", - "type": "meeting.finalize", - "label": "Finalize Meeting Session", - "config": { - "status": "{{finalizeDisposition}}", - "note": "Meeting subworkflow chain finalized." - }, - "position": { - "x": 450, - "y": 1360 - }, - "outputs": [ - "default" - ] - }, - { - "id": "final-log", - "type": "notify.log", - "label": "Record Final Outcome", + "label": "Escalate Lifecycle Failure (Retry Path)", "config": { - "message": "Meeting orchestration finalized for {{sessionTitle}} with child workflow {{childWorkflowId}}", - "level": "info" + "message": ":alert: Task completion agent remediation passed for {{taskTitle}} but Bosun PR lifecycle handoff failed after retries. Manual follow-up required." }, "position": { - "x": 450, - "y": 1490 + "x": 620, + "y": 1980 }, "outputs": [ "default" @@ -6006,170 +5338,229 @@ ], "edges": [ { - "id": "trigger->meeting-start", + "id": "trigger->plan-work", "source": "trigger", - "target": "meeting-start", + "target": "plan-work", "sourcePort": "default" }, { - "id": "meeting-start->meeting-send", - "source": "meeting-start", - "target": "meeting-send", + "id": "plan-work->write-tests", + "source": "plan-work", + "target": "write-tests", "sourcePort": "default" }, { - "id": "meeting-send->meeting-vision", - "source": "meeting-send", - "target": "meeting-vision", + "id": "write-tests->implement", + "source": "write-tests", + "target": "implement", "sourcePort": "default" }, { - "id": "meeting-vision->meeting-transcript", - "source": "meeting-vision", - "target": "meeting-transcript", + "id": "implement->main-build", + "source": "implement", + "target": "main-build", "sourcePort": "default" }, { - "id": "meeting-transcript->wake-phrase-trigger", - "source": "meeting-transcript", - "target": "wake-phrase-trigger", + "id": "main-build->main-test", + "source": "main-build", + "target": "main-test", "sourcePort": "default" }, { - "id": "wake-phrase-trigger->guard-transcript", - "source": "wake-phrase-trigger", - "target": "guard-transcript", + "id": "main-test->main-lint", + "source": "main-test", + "target": "main-lint", "sourcePort": "default" }, { - "id": "guard-transcript->execute-child-workflow", - "source": "guard-transcript", - "target": "execute-child-workflow", + "id": "main-lint->all-passed", + "source": "main-lint", + "target": "all-passed", + "sourcePort": "default" + }, + { + "id": "all-passed->push-branch", + "source": "all-passed", + "target": "push-branch", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "guard-transcript->notify-guard-failed", - "source": "guard-transcript", - "target": "notify-guard-failed", + "id": "all-passed->set-validation-summary", + "source": "all-passed", + "target": "set-validation-summary", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "execute-child-workflow->child-workflow-ok", - "source": "execute-child-workflow", - "target": "child-workflow-ok", + "id": "push-branch->create-pr", + "source": "push-branch", + "target": "create-pr", "sourcePort": "default" }, { - "id": "child-workflow-ok->notify-chain-success", - "source": "child-workflow-ok", - "target": "notify-chain-success", + "id": "create-pr->main-pr-ok", + "source": "create-pr", + "target": "main-pr-ok", + "sourcePort": "default" + }, + { + "id": "main-pr-ok->main-set-inreview", + "source": "main-pr-ok", + "target": "main-set-inreview", + "sourcePort": "yes" + }, + { + "id": "main-set-inreview->main-handoff-progressor", + "source": "main-set-inreview", + "target": "main-handoff-progressor", + "sourcePort": "default" + }, + { + "id": "main-handoff-progressor->notify-done", + "source": "main-handoff-progressor", + "target": "notify-done", + "sourcePort": "default" + }, + { + "id": "main-pr-ok->notify-pr-failed", + "source": "main-pr-ok", + "target": "notify-pr-failed", + "sourcePort": "no", + "condition": "$output?.result !== true" + }, + { + "id": "set-validation-summary->auto-fix", + "source": "set-validation-summary", + "target": "auto-fix", + "sourcePort": "default" + }, + { + "id": "auto-fix->retry-build", + "source": "auto-fix", + "target": "retry-build", + "sourcePort": "default" + }, + { + "id": "retry-build->retry-test", + "source": "retry-build", + "target": "retry-test", + "sourcePort": "default" + }, + { + "id": "retry-test->retry-lint", + "source": "retry-test", + "target": "retry-lint", + "sourcePort": "default" + }, + { + "id": "retry-lint->retry-passed", + "source": "retry-lint", + "target": "retry-passed", + "sourcePort": "default" + }, + { + "id": "retry-passed->push-branch-retry", + "source": "retry-passed", + "target": "push-branch-retry", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "child-workflow-ok->notify-chain-failed", - "source": "child-workflow-ok", - "target": "notify-chain-failed", + "id": "retry-passed->notify-fail", + "source": "retry-passed", + "target": "notify-fail", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "notify-chain-success->meeting-finalize", - "source": "notify-chain-success", - "target": "meeting-finalize", + "id": "push-branch-retry->create-pr-retry", + "source": "push-branch-retry", + "target": "create-pr-retry", "sourcePort": "default" }, { - "id": "notify-chain-failed->meeting-finalize", - "source": "notify-chain-failed", - "target": "meeting-finalize", + "id": "create-pr-retry->retry-pr-ok", + "source": "create-pr-retry", + "target": "retry-pr-ok", "sourcePort": "default" }, { - "id": "notify-guard-failed->meeting-finalize", - "source": "notify-guard-failed", - "target": "meeting-finalize", + "id": "retry-pr-ok->retry-set-inreview", + "source": "retry-pr-ok", + "target": "retry-set-inreview", + "sourcePort": "yes" + }, + { + "id": "retry-set-inreview->retry-handoff-progressor", + "source": "retry-set-inreview", + "target": "retry-handoff-progressor", "sourcePort": "default" }, { - "id": "meeting-finalize->final-log", - "source": "meeting-finalize", - "target": "final-log", + "id": "retry-handoff-progressor->notify-done-retry", + "source": "retry-handoff-progressor", + "target": "notify-done-retry", "sourcePort": "default" + }, + { + "id": "retry-pr-ok->notify-pr-failed-retry", + "source": "retry-pr-ok", + "target": "notify-pr-failed-retry", + "sourcePort": "no", + "condition": "$output?.result !== true" } ] }, { - "id": "template-backend-agent", - "name": "Task Completion Agent", - "description": "General-purpose task completion agent with a test-first methodology. Writes tests first, implements the feature, validates with build + lint, then creates a PR. Works with any language/framework — commands are auto-detected from your project or fully customizable.", + "id": "template-voice-video-parallel-rollout", + "name": "Voice + Video Rollout (Parallel Lanes)", + "description": "Launches three agent lanes in parallel (capture pipeline, provider adapters, and QA/rollout hardening) to accelerate Voice + Video delivery while keeping workstreams isolated by worktree.", "category": "agents", "categoryLabel": "Agents", "categoryIcon": ":bot:", "categoryOrder": 2, "tags": [ - "agent", - "task-completion", - "test-first", - "tdd", - "multi-language", - "multi-remediation" + "voice", + "video", + "parallel", + "subagents", + "rollout" ], - "nodeCount": 46, - "edgeCount": 48, - "recommended": true, - "enabled": true, - "trigger": "trigger.task_assigned", + "nodeCount": 11, + "edgeCount": 12, + "recommended": false, + "enabled": false, + "trigger": "trigger.manual", "variables": { - "testCommand": "npm test", - "buildCommand": "npm run build", - "lintCommand": "", - "baseBranch": "main", - "protectedBranches": [ - "main", - "master", - "develop", - "production" - ], - "agentSdk": "auto", - "timeoutMs": 3600000, - "testTimeoutMs": 1800000, - "autoFixTimeoutMs": 1200000 + "lane1Worktree": "{{worktreePath}}", + "lane2Worktree": "{{worktreePath}}", + "lane3Worktree": "{{worktreePath}}", + "integrationBranch": "feat/voice-video-integration", + "definitionOfDone": "Voice + vision works end-to-end, provider fallback is explicit, and tests cover config + transport + failure paths." }, "metadata": { "author": "bosun", - "version": 3, - "createdAt": "2025-02-25T00:00:00Z", - "templateVersion": "3.0.0", + "version": 1, + "createdAt": "2026-02-28T00:00:00Z", + "templateVersion": "1.0.0", "tags": [ - "agent", - "task-completion", - "test-first", - "tdd", - "multi-language", - "multi-remediation" - ], - "replaces": { - "module": "primary-agent.mjs", - "functions": [ - "runAgentWithTask" - ], - "calledFrom": [ - "task-executor.mjs:executeTask" - ], - "description": "Replaces generic agent task execution with a structured workflow. Test-first methodology, build/lint gates, and Bosun-managed PR lifecycle handoff are enforced as distinct workflow stages. Works with any language/framework." - } + "voice", + "video", + "parallel", + "subagents", + "rollout" + ] }, "nodes": [ { "id": "trigger", - "type": "trigger.task_assigned", - "label": "Task Assigned", + "type": "trigger.manual", + "label": "Launch Parallel Rollout", "config": {}, "position": { - "x": 400, + "x": 500, "y": 50 }, "outputs": [ @@ -6177,1143 +5568,1167 @@ ] }, { - "id": "plan-work", - "type": "agent.run_planner", - "label": "Plan Implementation", + "id": "check-worktrees", + "type": "condition.expression", + "label": "Worktrees Distinct?", "config": { - "prompt": "Analyze the task requirements and create a step-by-step implementation plan. Identify which files need to be modified, what tests need to be written, and any API contracts to maintain.", - "outputVariable": "plan", - "repoMapQuery": "{{taskTitle}} {{taskDescription}}", - "repoMapFileLimit": 8 + "expression": "(() => { const a = String($data?.lane1Worktree || '').trim(); const b = String($data?.lane2Worktree || '').trim(); const c = String($data?.lane3Worktree || '').trim(); if (!a || !b || !c) return false; return new Set([a, b, c]).size === 3; })()" }, "position": { - "x": 400, - "y": 180 + "x": 500, + "y": 170 }, "outputs": [ "default" ] }, { - "id": "write-tests", - "type": "action.run_agent", - "label": "Write Tests First", + "id": "notify-worktree-error", + "type": "notify.telegram", + "label": "Invalid Worktree Setup", "config": { - "prompt": "# Test-First Development\n\nBased on the plan:\n{{plan}}\n\nWrite comprehensive tests FIRST before any implementation:\n1. Unit tests for new functions/methods\n2. Integration tests for API endpoints if applicable\n3. Edge cases and error scenarios\n\nUse the project's test command: {{testCommand}}\nCreate a descriptive test commit message that names the behavior or surface covered.\nExample: \"test: cover portal login validation\"", - "sdk": "{{agentSdk}}", - "timeoutMs": "{{timeoutMs}}" + "message": "Parallel rollout aborted. Configure three distinct worktrees in `lane1Worktree`, `lane2Worktree`, and `lane3Worktree` before launching." }, "position": { - "x": 400, - "y": 330 + "x": 860, + "y": 170 }, "outputs": [ "default" ] }, { - "id": "implement", - "type": "action.run_agent", - "label": "Implement Feature", + "id": "kickoff-log", + "type": "notify.log", + "label": "Kickoff Parallel Lanes", "config": { - "prompt": "# Implement Feature\n\nThe tests have been written. Now implement the feature to make them pass:\n1. Follow existing code conventions\n2. Add proper error handling\n3. Ensure all new tests pass\n4. Do NOT modify the tests — make the code fit the contract\n\nRun `{{testCommand}}` after implementation.\nCreate a descriptive feat/fix commit message that names the shipped capability.\nExample: \"feat: add portal login rate limiting\"", - "sdk": "{{agentSdk}}", - "timeoutMs": "{{timeoutMs}}" + "message": "Starting parallel rollout on branch {{integrationBranch}} with 3 lanes.", + "level": "info" }, "position": { - "x": 400, - "y": 490 + "x": 500, + "y": 290 }, "outputs": [ "default" ] }, { - "id": "main-build", - "type": "validation.build", - "label": "Build Check", + "id": "lane-capture-core", + "type": "action.run_agent", + "label": "Lane 1: Capture Core", "config": { - "command": "{{buildCommand}}", - "zeroWarnings": true + "prompt": "# Lane 1 - Capture Core\n\nWork only in this lane's worktree. Focus on:\n1. Voice video config/schema/env/settings keys\n2. Browser capture loop (screen/camera), adaptive FPS, compression, change detection\n3. Overlay controls + capture state indicators\n\nGuardrails:\n- Do not touch provider dispatch code owned by Lane 2\n- Keep changes bounded to UI/config paths\n- Add/extend tests for capture throttling and config behavior\n\nTarget branch: {{integrationBranch}}\nDefinition of done: {{definitionOfDone}}", + "sdk": "auto", + "cwd": "{{lane1Worktree}}", + "timeoutMs": 5400000, + "includeTaskContext": false, + "failOnError": true }, "position": { - "x": 400, - "y": 0 + "x": 120, + "y": 450 }, "outputs": [ "default" ] }, { - "id": "main-test", - "type": "validation.tests", - "label": "Test Run", + "id": "lane-provider-bridge", + "type": "action.run_agent", + "label": "Lane 2: Provider Bridge", "config": { - "command": "{{testCommand}}", - "timeoutMs": "{{testTimeoutMs}}" + "prompt": "# Lane 2 - Provider Bridge\n\nWork only in this lane's worktree. Focus on:\n1. Server-side vision frame ingress route and validation\n2. Provider dispatch in voice relay (OpenAI image path, Gemini live path, Claude vision path)\n3. Rate-limits, payload caps, and fallback semantics\n\nGuardrails:\n- Do not edit overlay/capture UI owned by Lane 1\n- Keep provider logic behind explicit feature flags\n- Add/extend tests for endpoint validation and provider routing\n\nTarget branch: {{integrationBranch}}\nDefinition of done: {{definitionOfDone}}", + "sdk": "auto", + "cwd": "{{lane2Worktree}}", + "timeoutMs": 5400000, + "includeTaskContext": false, + "failOnError": true }, "position": { - "x": 400, - "y": 130 + "x": 500, + "y": 450 }, "outputs": [ "default" ] }, { - "id": "main-lint", - "type": "validation.lint", - "label": "Lint Check", + "id": "lane-hardening", + "type": "action.run_agent", + "label": "Lane 3: QA + Rollout", "config": { - "command": "{{lintCommand}}" + "prompt": "# Lane 3 - QA + Rollout Hardening\n\nWork only in this lane's worktree. Focus on:\n1. Integration tests, resilience tests, and docs updates\n2. Migration/rollout notes and operator controls\n3. Conflict-free merge guidance across Lane 1 and Lane 2 outputs\n\nGuardrails:\n- Avoid touching core capture loop and provider dispatch internals unless a test proves breakage\n- Keep this lane focused on verification, docs, and release safety\n- Produce a concise verification summary\n\nTarget branch: {{integrationBranch}}\nDefinition of done: {{definitionOfDone}}", + "sdk": "auto", + "cwd": "{{lane3Worktree}}", + "timeoutMs": 3600000, + "includeTaskContext": false, + "failOnError": true }, "position": { - "x": 400, - "y": 260 + "x": 880, + "y": 450 }, "outputs": [ "default" ] }, { - "id": "all-passed", - "type": "condition.expression", - "label": "All Checks Passed?", + "id": "aggregate", + "type": "transform.aggregate", + "label": "Aggregate Lane Results", "config": { - "expression": "$ctx.getNodeOutput('main-build')?.passed === true && $ctx.getNodeOutput('main-test')?.passed === true && $ctx.getNodeOutput('main-lint')?.passed === true" + "sources": [ + "lane-capture-core", + "lane-provider-bridge", + "lane-hardening" + ] }, "position": { - "x": 400, - "y": 1040 + "x": 500, + "y": 640 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "push-branch", - "type": "action.push_branch", - "label": "Push Branch", + "id": "all-passed", + "type": "condition.expression", + "label": "All Lanes Passed?", "config": { - "worktreePath": "{{worktreePath}}", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "rebaseBeforePush": true, - "mergeBaseBeforePush": true, - "autoResolveMergeConflicts": true, - "conflictResolverSdk": "{{agentSdk}}", - "emptyDiffGuard": true, - "protectedBranches": "{{protectedBranches}}" + "expression": "$ctx.getNodeOutput('lane-capture-core')?.success === true && $ctx.getNodeOutput('lane-provider-bridge')?.success === true && $ctx.getNodeOutput('lane-hardening')?.success === true" }, "position": { - "x": 250, - "y": 1110 + "x": 500, + "y": 770 }, "outputs": [ "default" ] }, { - "id": "push-ok", - "type": "condition.expression", - "label": "Push OK?", + "id": "notify-success", + "type": "notify.telegram", + "label": "Notify Success", "config": { - "expression": "$ctx.getNodeOutput('push-branch')?.pushed === true" + "message": "Parallel Voice + Video rollout lanes completed successfully on {{integrationBranch}}. Proceed to integration and final verification." }, "position": { - "x": 250, - "y": 1170 + "x": 300, + "y": 910 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "create-pr", - "type": "action.create_pr", - "label": "Handoff PR Lifecycle", + "id": "notify-failure", + "type": "notify.telegram", + "label": "Notify Failure", "config": { - "title": "feat: {{taskTitle}}", - "body": "Implements backend task with test-first methodology.\n\n**Plan:**\n{{plan}}\n\nAll tests passing. Bosun lifecycle handoff ready.", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "failOnError": true, - "maxRetries": 3, - "retryDelayMs": 15000, - "continueOnError": true + "message": "Parallel Voice + Video rollout has lane failures on {{integrationBranch}}. Inspect lane outputs before integration." }, "position": { - "x": 250, - "y": 1170 + "x": 700, + "y": 910 }, "outputs": [ "default" ] + } + ], + "edges": [ + { + "id": "trigger->check-worktrees", + "source": "trigger", + "target": "check-worktrees", + "sourcePort": "default" }, { - "id": "main-pr-ok", - "type": "condition.expression", - "label": "PR Created?", - "config": { - "expression": "Boolean($ctx.getNodeOutput($edge.source)?.prNumber || $ctx.getNodeOutput($edge.source)?.prUrl)" - }, - "position": { - "x": 400, - "y": 0 - }, - "outputs": [ - "yes", - "no" - ] + "id": "check-worktrees->kickoff-log", + "source": "check-worktrees", + "target": "kickoff-log", + "sourcePort": "default", + "condition": "$output?.result === true" }, { - "id": "main-set-inreview", - "type": "action.update_task_status", - "label": "Set In-Review", - "config": { - "taskId": "{{taskId}}", - "status": "inreview", - "taskTitle": "{{taskTitle}}" - }, - "position": { - "x": 300, - "y": 130 - }, - "outputs": [ - "default" - ] + "id": "check-worktrees->notify-worktree-error", + "source": "check-worktrees", + "target": "notify-worktree-error", + "sourcePort": "default", + "condition": "$output?.result !== true" }, { - "id": "main-handoff-progressor", - "type": "action.execute_workflow", - "label": "Handoff PR Progressor", - "config": { - "workflowId": "template-bosun-pr-progressor", - "mode": "dispatch", - "input": { - "taskId": "{{taskId}}", - "taskTitle": "{{taskTitle}}", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}" - } - }, - "position": { - "x": 300, - "y": 260 - }, - "outputs": [ - "default" - ] + "id": "kickoff-log->lane-capture-core", + "source": "kickoff-log", + "target": "lane-capture-core", + "sourcePort": "default" }, { - "id": "notify-done", - "type": "notify.log", - "label": "Task Complete", - "config": { - "message": "Task completion agent finished task — PR lifecycle handoff recorded", - "level": "info" - }, - "position": { - "x": 180, - "y": 1320 - }, - "outputs": [ - "default" - ] + "id": "kickoff-log->lane-provider-bridge", + "source": "kickoff-log", + "target": "lane-provider-bridge", + "sourcePort": "default" }, { - "id": "notify-pr-failed", - "type": "notify.telegram", - "label": "Escalate Lifecycle Handoff Failure", - "config": { - "message": ":alert: Task completion agent passed validation for {{taskTitle}} but failed to record Bosun PR lifecycle handoff after retries. Manual follow-up required." - }, - "position": { - "x": 420, - "y": 1320 - }, - "outputs": [ - "default" - ] + "id": "kickoff-log->lane-hardening", + "source": "kickoff-log", + "target": "lane-hardening", + "sourcePort": "default" }, { - "id": "set-validation-summary", - "type": "action.set_variable", - "label": "Summarize Validation Output", - "config": { - "key": "validationSummary", - "value": "(() => { function fmtGate(label, out) { if (!out || !Object.keys(out).length) return label + ': (not run)'; const diag = out.outputDiagnostics || {}; const lines = [label + ': ' + (out.passed === true ? 'PASSED' : 'FAILED')]; if (diag.summary) lines.push(' Summary: ' + diag.summary); const targets = diag.failedTargets || []; if (targets.length) { lines.push(' Failed targets (' + targets.length + '):'); targets.slice(0, 20).forEach(t => lines.push(' - ' + t)); if (targets.length > 20) lines.push(' ... and ' + (targets.length - 20) + ' more'); } const rerun = out.outputSuggestedRerun || diag.suggestedRerun || ''; if (rerun) lines.push(' Rerun: `' + rerun + '`'); const hint = out.outputHint || diag.hint || ''; if (hint) lines.push(' Hint: ' + hint); if (out.output) lines.push(' Output:\\n' + String(out.output).slice(0, 5000)); return lines.join('\\n'); } const build = $ctx.getNodeOutput('main-build') || {}; const test = $ctx.getNodeOutput('main-test') || {}; const lint = $ctx.getNodeOutput('main-lint') || {}; return [ '## Validation Results', '', fmtGate('Build', build), '', fmtGate('Test', test), '', fmtGate('Lint', lint), ].join('\\n'); })()", - "isExpression": true - }, - "position": { - "x": 620, - "y": 1090 - }, - "outputs": [ - "default" - ] + "id": "lane-capture-core->aggregate", + "source": "lane-capture-core", + "target": "aggregate", + "sourcePort": "default" }, { - "id": "auto-fix", - "type": "action.run_agent", - "label": "Auto-Fix Validation Failures", + "id": "lane-provider-bridge->aggregate", + "source": "lane-provider-bridge", + "target": "aggregate", + "sourcePort": "default" + }, + { + "id": "lane-hardening->aggregate", + "source": "lane-hardening", + "target": "aggregate", + "sourcePort": "default" + }, + { + "id": "aggregate->all-passed", + "source": "aggregate", + "target": "all-passed", + "sourcePort": "default" + }, + { + "id": "all-passed->notify-success", + "source": "all-passed", + "target": "notify-success", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "all-passed->notify-failure", + "source": "all-passed", + "target": "notify-failure", + "sourcePort": "default", + "condition": "$output?.result !== true" + } + ] + }, + { + "id": "template-build-deploy", + "name": "Build & Deploy", + "description": "Complete CI/CD-style pipeline: build → test → lint → deploy. Configurable deployment commands for any hosting target.", + "category": "ci-cd", + "categoryLabel": "CI/CD", + "categoryIcon": ":rocket:", + "categoryOrder": 3, + "tags": [ + "ci", + "cd", + "deploy", + "build" + ], + "nodeCount": 6, + "edgeCount": 5, + "recommended": false, + "enabled": false, + "trigger": "trigger.event", + "variables": { + "deployCommand": "npm run deploy", + "deployBranch": "main" + }, + "metadata": { + "author": "bosun", + "version": 1, + "createdAt": "2025-02-24T00:00:00Z", + "templateVersion": "1.0.0", + "tags": [ + "ci", + "cd", + "deploy", + "build" + ], + "replaces": { + "module": "monitor.mjs", + "functions": [ + "preflight checks" + ], + "calledFrom": [ + "preflight.mjs" + ], + "description": "Replaces ad-hoc build/test/lint validation steps with a coordinated CI/CD pipeline workflow." + } + }, + "nodes": [ + { + "id": "trigger", + "type": "trigger.event", + "label": "On PR Merged", "config": { - "prompt": "# Fix Validation Failures — Pass 1\n\nThe first validation pass failed for task **{{taskTitle}}**.\n\nPlan:\n{{plan}}\n\n{{validationSummary}}\n\nSTRATEGY:\n1. Look at which gates failed (Build / Test / Lint) and focus on those.\n2. Check the **Failed Targets** — these are the exact tests/files/packages that broke.\n3. Fix compilation errors first, then test failures, then lint issues.\n4. Use the **Suggested Rerun Command** (if shown) to iterate on just the failing targets.\n5. Once targeted failures pass, run all three gates to confirm everything is green.\n\nRULES:\n- Do NOT weaken, remove, or bypass tests.\n- Keep the original task scope.\n- Create a descriptive fix commit message that names the concrete failure resolved.", - "sdk": "{{agentSdk}}", - "timeoutMs": "{{autoFixTimeoutMs}}" + "eventType": "pr.merged", + "filter": "$event.branch === '{{deployBranch}}'" }, "position": { - "x": 620, - "y": 1170 + "x": 400, + "y": 50 }, "outputs": [ "default" ] }, { - "id": "retry-build", + "id": "build", "type": "validation.build", - "label": "Build Check", + "label": "Build", "config": { - "command": "{{buildCommand}}", + "command": "npm run build", "zeroWarnings": true }, "position": { "x": 400, - "y": 0 + "y": 180 }, "outputs": [ "default" ] }, { - "id": "retry-test", + "id": "test", "type": "validation.tests", - "label": "Test Run", + "label": "Tests", "config": { - "command": "{{testCommand}}", - "timeoutMs": "{{testTimeoutMs}}" + "command": "npm test" }, "position": { "x": 400, - "y": 130 + "y": 310 }, "outputs": [ "default" ] }, { - "id": "retry-lint", + "id": "lint", "type": "validation.lint", - "label": "Lint Check", + "label": "Lint", "config": { - "command": "{{lintCommand}}" + "command": "npm run lint" }, "position": { "x": 400, - "y": 260 + "y": 440 }, "outputs": [ "default" ] }, { - "id": "retry-passed", - "type": "condition.expression", - "label": "Retry Checks Passed?", + "id": "deploy", + "type": "action.run_command", + "label": "Deploy", "config": { - "expression": "$ctx.getNodeOutput('retry-build')?.passed === true && $ctx.getNodeOutput('retry-test')?.passed === true && $ctx.getNodeOutput('retry-lint')?.passed === true" + "command": "{{deployCommand}}" }, "position": { - "x": 620, - "y": 1690 + "x": 400, + "y": 570 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "push-branch-retry", - "type": "action.push_branch", - "label": "Push Branch (Retry)", + "id": "notify", + "type": "notify.telegram", + "label": "Notify Deploy", "config": { - "worktreePath": "{{worktreePath}}", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "rebaseBeforePush": true, - "mergeBaseBeforePush": true, - "autoResolveMergeConflicts": true, - "conflictResolverSdk": "{{agentSdk}}", - "emptyDiffGuard": true, - "protectedBranches": "{{protectedBranches}}" + "message": ":rocket: Deployment to production completed for {{branch}}" }, "position": { - "x": 450, - "y": 1760 + "x": 400, + "y": 700 }, "outputs": [ "default" ] + } + ], + "edges": [ + { + "id": "trigger->build", + "source": "trigger", + "target": "build", + "sourcePort": "default" }, { - "id": "push-ok-retry", - "type": "condition.expression", - "label": "Push OK? (Retry)", - "config": { - "expression": "$ctx.getNodeOutput('push-branch-retry')?.pushed === true" - }, - "position": { - "x": 450, - "y": 1820 - }, - "outputs": [ - "yes", - "no" - ] + "id": "build->test", + "source": "build", + "target": "test", + "sourcePort": "default" }, { - "id": "create-pr-retry", - "type": "action.create_pr", - "label": "Handoff PR Lifecycle (After Retry)", + "id": "test->lint", + "source": "test", + "target": "lint", + "sourcePort": "default" + }, + { + "id": "lint->deploy", + "source": "lint", + "target": "deploy", + "sourcePort": "default" + }, + { + "id": "deploy->notify", + "source": "deploy", + "target": "notify", + "sourcePort": "default" + } + ] + }, + { + "id": "template-canary-deploy", + "name": "Canary Deploy", + "description": "Two-phase deployment: deploy to a staging/canary environment first, run smoke tests, then promote to production or auto-rollback on failure. Reduces blast radius of bad deploys.", + "category": "ci-cd", + "categoryLabel": "CI/CD", + "categoryIcon": ":rocket:", + "categoryOrder": 3, + "tags": [ + "deploy", + "canary", + "staging", + "rollback", + "smoke-test" + ], + "nodeCount": 12, + "edgeCount": 11, + "recommended": false, + "enabled": false, + "trigger": "trigger.manual", + "variables": { + "stagingCommand": "npm run deploy:staging", + "productionCommand": "npm run deploy:production", + "rollbackCommand": "npm run deploy:rollback", + "smokeTestCommand": "npm run test:smoke", + "promotionDelayMs": 300000 + }, + "metadata": { + "author": "bosun", + "version": 1, + "createdAt": "2025-02-25T00:00:00Z", + "templateVersion": "1.0.0", + "tags": [ + "deploy", + "canary", + "staging", + "rollback", + "smoke-test" + ] + }, + "nodes": [ + { + "id": "trigger", + "type": "trigger.manual", + "label": "Deploy Canary", "config": { - "title": "feat: {{taskTitle}}", - "body": "Implements backend task after auto-fix retry.\n\n**Plan:**\n{{plan}}\n\nValidation passed after remediation. Bosun lifecycle handoff ready.", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "failOnError": true, - "maxRetries": 3, - "retryDelayMs": 15000, - "continueOnError": true + "description": "Start a canary deployment" }, "position": { - "x": 450, - "y": 1820 + "x": 400, + "y": 50 }, "outputs": [ "default" ] }, { - "id": "retry-pr-ok", - "type": "condition.expression", - "label": "PR Created?", + "id": "build", + "type": "validation.build", + "label": "Build", "config": { - "expression": "Boolean($ctx.getNodeOutput($edge.source)?.prNumber || $ctx.getNodeOutput($edge.source)?.prUrl)" + "command": "npm run build", + "zeroWarnings": true }, "position": { "x": 400, - "y": 0 + "y": 180 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "retry-set-inreview", - "type": "action.update_task_status", - "label": "Set In-Review", + "id": "deploy-staging", + "type": "action.run_command", + "label": "Deploy to Staging", "config": { - "taskId": "{{taskId}}", - "status": "inreview", - "taskTitle": "{{taskTitle}}" + "command": "{{stagingCommand}}", + "continueOnError": true }, "position": { - "x": 300, - "y": 130 + "x": 400, + "y": 310 }, "outputs": [ "default" ] }, { - "id": "retry-handoff-progressor", - "type": "action.execute_workflow", - "label": "Handoff PR Progressor", + "id": "staging-ok", + "type": "condition.expression", + "label": "Staging Deploy OK?", "config": { - "workflowId": "template-bosun-pr-progressor", - "mode": "dispatch", - "input": { - "taskId": "{{taskId}}", - "taskTitle": "{{taskTitle}}", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}" - } + "expression": "$ctx.getNodeOutput('deploy-staging')?.success === true" }, "position": { - "x": 300, - "y": 260 + "x": 400, + "y": 440 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "notify-done-retry", - "type": "notify.log", - "label": "Task Complete (After Retry)", + "id": "smoke-tests", + "type": "action.run_command", + "label": "Run Smoke Tests", "config": { - "message": "Task completion agent finished task after retry — PR lifecycle handoff recorded", - "level": "info" + "command": "{{smokeTestCommand}}", + "continueOnError": true }, "position": { - "x": 360, - "y": 1980 + "x": 250, + "y": 570 }, "outputs": [ "default" ] }, { - "id": "set-retry2-summary", - "type": "action.set_variable", - "label": "Summarize Retry-1 Output", + "id": "smoke-passed", + "type": "condition.expression", + "label": "Smoke Tests Passed?", "config": { - "key": "retry2Summary", - "value": "(() => { function fmtGate(label, out) { if (!out || !Object.keys(out).length) return label + ': (not run)'; const diag = out.outputDiagnostics || {}; const lines = [label + ': ' + (out.passed === true ? 'PASSED' : 'FAILED')]; if (diag.summary) lines.push(' Summary: ' + diag.summary); const targets = diag.failedTargets || []; if (targets.length) { lines.push(' Failed (' + targets.length + '):'); targets.slice(0, 15).forEach(t => lines.push(' - ' + t)); if (targets.length > 15) lines.push(' ... +' + (targets.length - 15) + ' more'); } const rerun = out.outputSuggestedRerun || diag.suggestedRerun || ''; if (rerun) lines.push(' Rerun: `' + rerun + '`'); if (diag.deltaSummary) lines.push(' Delta: ' + diag.deltaSummary); if (out.output) lines.push(' Output:\\n' + String(out.output).slice(0, 3500)); return lines.join('\\n'); } const b1 = $ctx.getNodeOutput('main-build') || {}; const t1 = $ctx.getNodeOutput('main-test') || {}; const l1 = $ctx.getNodeOutput('main-lint') || {}; const b2 = $ctx.getNodeOutput('retry-build') || {}; const t2 = $ctx.getNodeOutput('retry-test') || {}; const l2 = $ctx.getNodeOutput('retry-lint') || {}; return [ '## Validation History (both passes failed)', '', '### Pass 1 — Original', fmtGate('Build', b1), fmtGate('Test', t1), fmtGate('Lint', l1), '', '### Pass 2 — After First Auto-Fix', fmtGate('Build', b2), fmtGate('Test', t2), fmtGate('Lint', l2), ].join('\\n'); })()", - "isExpression": true + "expression": "$ctx.getNodeOutput('smoke-tests')?.success === true" }, "position": { - "x": 820, - "y": 1820 + "x": 250, + "y": 700 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "auto-fix-2", - "type": "action.run_agent", - "label": "Auto-Fix (Escalated, Pass 2)", + "id": "wait-bake", + "type": "action.delay", + "label": "Bake Time", "config": { - "prompt": "# Fix Validation Failures — FINAL AUTOMATED ATTEMPT\n\nThis is the SECOND and LAST automated remediation pass for task **{{taskTitle}}**.\nThe first auto-fix attempt DID NOT resolve all issues. You MUST take a different approach.\n\nPlan:\n{{plan}}\n\n{{retry2Summary}}\n\nANALYSIS STEPS:\n1. Compare **Failed Targets** between Pass 1 and Pass 2.\n - Same targets still failing → previous fix was wrong, try a different approach.\n - New targets appearing → previous fix broke something else, fix both.\n - Some resolved → partially right, focus on remaining.\n2. Check the **Delta** field to see what changed between runs.\n3. Use the **Rerun** command to iterate on just the failing targets.\n\nCRITICAL RULES:\n- Do NOT repeat the same fix that already failed.\n- If a test is genuinely wrong or testing stale behavior, fix the test AND the code.\n- If build/lint/test configs are misconfigured, fix the config.\n- Do NOT weaken, remove, or skip tests. Do NOT add --force or --no-verify flags.\n- Keep the original task scope — do not revert the feature.\n\nRun build + tests + lint locally and confirm ALL pass before finishing.\nCreate a descriptive commit: \"fix: \"", - "sdk": "{{agentSdk}}", - "timeoutMs": "{{autoFixTimeoutMs}}" + "ms": "{{promotionDelayMs}}", + "reason": "Waiting for bake time before promoting to production" }, "position": { - "x": 820, - "y": 1900 + "x": 100, + "y": 830 }, "outputs": [ "default" ] }, { - "id": "retry2-build", - "type": "validation.build", - "label": "Build Check", + "id": "promote-prod", + "type": "action.run_command", + "label": "Promote to Production", "config": { - "command": "{{buildCommand}}", - "zeroWarnings": true + "command": "{{productionCommand}}" }, "position": { - "x": 400, - "y": 0 + "x": 100, + "y": 960 }, "outputs": [ "default" ] }, { - "id": "retry2-test", - "type": "validation.tests", - "label": "Test Run", + "id": "notify-success", + "type": "notify.telegram", + "label": "Deploy Succeeded", "config": { - "command": "{{testCommand}}", - "timeoutMs": "{{testTimeoutMs}}" + "message": ":check: **Canary deploy promoted to production** successfully." }, "position": { - "x": 400, - "y": 130 + "x": 100, + "y": 1090 }, "outputs": [ "default" ] }, { - "id": "retry2-lint", - "type": "validation.lint", - "label": "Lint Check", + "id": "rollback", + "type": "action.run_command", + "label": "Rollback", "config": { - "command": "{{lintCommand}}" + "command": "{{rollbackCommand}}", + "continueOnError": true }, "position": { - "x": 400, - "y": 260 + "x": 550, + "y": 700 }, "outputs": [ "default" ] }, { - "id": "retry2-passed", - "type": "condition.expression", - "label": "Retry-2 Checks Passed?", + "id": "notify-rollback", + "type": "notify.telegram", + "label": "Deploy Rolled Back", "config": { - "expression": "$ctx.getNodeOutput('retry2-build')?.passed === true && $ctx.getNodeOutput('retry2-test')?.passed === true && $ctx.getNodeOutput('retry2-lint')?.passed === true" + "message": ":refresh: **Canary deploy rolled back.**\n\nSmoke tests or staging deploy failed. Production unchanged." }, "position": { - "x": 820, - "y": 2400 + "x": 550, + "y": 830 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "push-branch-retry2", - "type": "action.push_branch", - "label": "Push Branch (Retry 2)", + "id": "notify-staging-fail", + "type": "notify.telegram", + "label": "Staging Failed", "config": { - "worktreePath": "{{worktreePath}}", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "rebaseBeforePush": true, - "mergeBaseBeforePush": true, - "autoResolveMergeConflicts": true, - "conflictResolverSdk": "{{agentSdk}}", - "emptyDiffGuard": true, - "protectedBranches": "{{protectedBranches}}" + "message": ":close: **Staging deploy failed.** Not proceeding to canary phase." }, "position": { - "x": 650, - "y": 2470 + "x": 600, + "y": 440 }, "outputs": [ "default" ] + } + ], + "edges": [ + { + "id": "trigger->build", + "source": "trigger", + "target": "build", + "sourcePort": "default" }, { - "id": "push-ok-retry2", - "type": "condition.expression", - "label": "Push OK? (Retry 2)", + "id": "build->deploy-staging", + "source": "build", + "target": "deploy-staging", + "sourcePort": "default" + }, + { + "id": "deploy-staging->staging-ok", + "source": "deploy-staging", + "target": "staging-ok", + "sourcePort": "default" + }, + { + "id": "staging-ok->smoke-tests", + "source": "staging-ok", + "target": "smoke-tests", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "staging-ok->notify-staging-fail", + "source": "staging-ok", + "target": "notify-staging-fail", + "sourcePort": "no", + "condition": "$output?.result !== true" + }, + { + "id": "smoke-tests->smoke-passed", + "source": "smoke-tests", + "target": "smoke-passed", + "sourcePort": "default" + }, + { + "id": "smoke-passed->wait-bake", + "source": "smoke-passed", + "target": "wait-bake", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "smoke-passed->rollback", + "source": "smoke-passed", + "target": "rollback", + "sourcePort": "no", + "condition": "$output?.result !== true" + }, + { + "id": "wait-bake->promote-prod", + "source": "wait-bake", + "target": "promote-prod", + "sourcePort": "default" + }, + { + "id": "promote-prod->notify-success", + "source": "promote-prod", + "target": "notify-success", + "sourcePort": "default" + }, + { + "id": "rollback->notify-rollback", + "source": "rollback", + "target": "notify-rollback", + "sourcePort": "default" + } + ] + }, + { + "id": "template-release-pipeline", + "name": "Release Pipeline", + "description": "End-to-end release automation: version bump, changelog generation, build, test, npm publish, GitHub release creation, and team notification. Triggered manually or on a schedule for regular release cadences.", + "category": "ci-cd", + "categoryLabel": "CI/CD", + "categoryIcon": ":rocket:", + "categoryOrder": 3, + "tags": [ + "release", + "publish", + "npm", + "changelog", + "version" + ], + "nodeCount": 14, + "edgeCount": 14, + "recommended": true, + "enabled": true, + "trigger": "trigger.manual", + "variables": { + "bumpType": "patch", + "publishToNpm": true, + "dryRun": false + }, + "metadata": { + "author": "bosun", + "version": 1, + "createdAt": "2025-02-25T00:00:00Z", + "templateVersion": "1.0.0", + "tags": [ + "release", + "publish", + "npm", + "changelog", + "version" + ], + "replaces": { + "module": "publish.mjs", + "functions": [ + "publish", + "bumpVersion", + "createGitHubRelease" + ], + "calledFrom": [ + "cli.mjs:publish" + ], + "description": "Replaces the imperative publish.mjs script with a visual release pipeline. Each stage (bump, changelog, build, test, publish, release) becomes a discrete, retriable workflow node." + } + }, + "nodes": [ + { + "id": "trigger", + "type": "trigger.manual", + "label": "Start Release", "config": { - "expression": "$ctx.getNodeOutput('push-branch-retry2')?.pushed === true" + "description": "Kick off a new release" }, "position": { - "x": 650, - "y": 2530 + "x": 400, + "y": 50 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "create-pr-retry2", - "type": "action.create_pr", - "label": "Handoff PR Lifecycle (After Retry 2)", + "id": "bump-version", + "type": "action.run_command", + "label": "Bump Version", "config": { - "title": "feat: {{taskTitle}}", - "body": "Implements backend task after two auto-fix passes.\n\n**Plan:**\n{{plan}}\n\nValidation passed after 2nd remediation. Bosun lifecycle handoff ready.", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "failOnError": true, - "maxRetries": 3, - "retryDelayMs": 15000, - "continueOnError": true + "command": "npm version {{bumpType}} --no-git-tag-version" }, "position": { - "x": 650, - "y": 2530 + "x": 400, + "y": 180 }, "outputs": [ "default" ] }, { - "id": "retry2-pr-ok", - "type": "condition.expression", - "label": "PR Created?", + "id": "read-version", + "type": "action.run_command", + "label": "Read New Version", "config": { - "expression": "Boolean($ctx.getNodeOutput($edge.source)?.prNumber || $ctx.getNodeOutput($edge.source)?.prUrl)" + "command": "node -p \"require('./package.json').version\"" }, "position": { "x": 400, - "y": 0 + "y": 310 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "retry2-set-inreview", - "type": "action.update_task_status", - "label": "Set In-Review", + "id": "set-version", + "type": "action.set_variable", + "label": "Set Version Variable", "config": { - "taskId": "{{taskId}}", - "status": "inreview", - "taskTitle": "{{taskTitle}}" + "key": "version", + "value": "(() => String($ctx.getNodeOutput('read-version')?.output || '').trim())()", + "isExpression": true }, "position": { - "x": 300, - "y": 130 + "x": 400, + "y": 380 }, "outputs": [ "default" ] }, { - "id": "retry2-handoff-progressor", - "type": "action.execute_workflow", - "label": "Handoff PR Progressor", + "id": "generate-changelog", + "type": "action.run_agent", + "label": "Generate Changelog", "config": { - "workflowId": "template-bosun-pr-progressor", - "mode": "dispatch", - "input": { - "taskId": "{{taskId}}", - "taskTitle": "{{taskTitle}}", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}" - } + "prompt": "# Generate Changelog Entry\n\nRead the git log since the last tag:\n```\ngit log $(git describe --tags --abbrev=0)..HEAD --oneline\n```\n\nGroup commits into categories (Features, Fixes, Refactors, Docs, etc.)\nfollowing the Keep a Changelog format.\n\nWrite the entry to CHANGELOG.md under a new version heading.\nCommit the result with message \"docs: update changelog for vX.Y.Z\".", + "sdk": "auto", + "timeoutMs": 600000 }, "position": { - "x": 300, - "y": 260 + "x": 400, + "y": 440 }, "outputs": [ "default" ] }, { - "id": "notify-done-retry2", - "type": "notify.log", - "label": "Task Complete (After Retry 2)", + "id": "build", + "type": "validation.build", + "label": "Build", "config": { - "message": "Task completion agent finished task after 2nd retry — PR lifecycle handoff recorded", - "level": "info" + "command": "npm run build", + "zeroWarnings": true }, "position": { - "x": 560, - "y": 2690 + "x": 400, + "y": 570 }, "outputs": [ "default" ] }, { - "id": "set-blocked-validation", - "type": "action.update_task_status", - "label": "Block Task (Validation Exhausted)", + "id": "test", + "type": "validation.tests", + "label": "Run Tests", "config": { - "taskId": "{{taskId}}", - "status": "blocked", - "taskTitle": "{{taskTitle}}", - "blockedReason": "Validation failed after 2 automated remediation passes" + "command": "npm test" }, "position": { - "x": 1020, - "y": 2470 + "x": 400, + "y": 700 }, "outputs": [ "default" ] }, { - "id": "notify-fail", - "type": "notify.telegram", - "label": "Checks Failed (Exhausted)", + "id": "test-passed", + "type": "condition.expression", + "label": "Tests Passed?", "config": { - "message": ":alert: Backend agent: validation failed for task {{taskTitle}} even after 2 remediation passes. Task blocked — manual review needed." + "expression": "$ctx.getNodeOutput('test')?.passed === true" }, "position": { - "x": 1020, - "y": 2560 + "x": 400, + "y": 830 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "notify-pr-failed-retry", - "type": "notify.telegram", - "label": "Escalate Lifecycle Failure (Retry Path)", + "id": "should-publish", + "type": "condition.expression", + "label": "Publish To npm?", "config": { - "message": ":alert: Task completion agent remediation passed for {{taskTitle}} but Bosun PR lifecycle handoff failed after retries. Manual follow-up required." + "expression": "Boolean($data?.publishToNpm)" }, "position": { - "x": 620, - "y": 1980 + "x": 250, + "y": 1030 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "notify-pr-failed-retry2", - "type": "notify.telegram", - "label": "Escalate Lifecycle Failure (Retry 2)", + "id": "commit-tag", + "type": "action.git_operations", + "label": "Commit & Tag", "config": { - "message": ":alert: Task completion agent 2nd remediation passed for {{taskTitle}} but Bosun PR lifecycle handoff failed. Manual follow-up required." + "operations": [ + { + "op": "add", + "paths": [ + "." + ] + }, + { + "op": "commit", + "message": "chore(release): v{{version}}" + }, + { + "op": "tag", + "name": "v{{version}}" + }, + { + "op": "push", + "includeTags": true + } + ] }, "position": { - "x": 820, - "y": 2690 + "x": 250, + "y": 960 }, "outputs": [ "default" ] - } - ], - "edges": [ - { - "id": "trigger->plan-work", - "source": "trigger", - "target": "plan-work", - "sourcePort": "default" - }, - { - "id": "plan-work->write-tests", - "source": "plan-work", - "target": "write-tests", - "sourcePort": "default" - }, - { - "id": "write-tests->implement", - "source": "write-tests", - "target": "implement", - "sourcePort": "default" - }, - { - "id": "implement->main-build", - "source": "implement", - "target": "main-build", - "sourcePort": "default" - }, - { - "id": "main-build->main-test", - "source": "main-build", - "target": "main-test", - "sourcePort": "default" - }, - { - "id": "main-test->main-lint", - "source": "main-test", - "target": "main-lint", - "sourcePort": "default" - }, - { - "id": "main-lint->all-passed", - "source": "main-lint", - "target": "all-passed", - "sourcePort": "default" - }, - { - "id": "all-passed->push-branch", - "source": "all-passed", - "target": "push-branch", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "all-passed->set-validation-summary", - "source": "all-passed", - "target": "set-validation-summary", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "push-branch->push-ok", - "source": "push-branch", - "target": "push-ok", - "sourcePort": "default" - }, - { - "id": "push-ok->create-pr", - "source": "push-ok", - "target": "create-pr", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "push-ok->notify-pr-failed", - "source": "push-ok", - "target": "notify-pr-failed", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "create-pr->main-pr-ok", - "source": "create-pr", - "target": "main-pr-ok", - "sourcePort": "default" - }, - { - "id": "main-pr-ok->main-set-inreview", - "source": "main-pr-ok", - "target": "main-set-inreview", - "sourcePort": "yes" - }, - { - "id": "main-set-inreview->main-handoff-progressor", - "source": "main-set-inreview", - "target": "main-handoff-progressor", - "sourcePort": "default" - }, - { - "id": "main-handoff-progressor->notify-done", - "source": "main-handoff-progressor", - "target": "notify-done", - "sourcePort": "default" - }, - { - "id": "main-pr-ok->notify-pr-failed", - "source": "main-pr-ok", - "target": "notify-pr-failed", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "set-validation-summary->auto-fix", - "source": "set-validation-summary", - "target": "auto-fix", - "sourcePort": "default" - }, - { - "id": "auto-fix->retry-build", - "source": "auto-fix", - "target": "retry-build", - "sourcePort": "default" - }, - { - "id": "retry-build->retry-test", - "source": "retry-build", - "target": "retry-test", - "sourcePort": "default" - }, - { - "id": "retry-test->retry-lint", - "source": "retry-test", - "target": "retry-lint", - "sourcePort": "default" - }, - { - "id": "retry-lint->retry-passed", - "source": "retry-lint", - "target": "retry-passed", - "sourcePort": "default" - }, - { - "id": "retry-passed->push-branch-retry", - "source": "retry-passed", - "target": "push-branch-retry", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "retry-passed->set-retry2-summary", - "source": "retry-passed", - "target": "set-retry2-summary", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "push-branch-retry->push-ok-retry", - "source": "push-branch-retry", - "target": "push-ok-retry", - "sourcePort": "default" }, { - "id": "push-ok-retry->create-pr-retry", - "source": "push-ok-retry", - "target": "create-pr-retry", - "sourcePort": "yes", - "condition": "$output?.result === true" + "id": "publish-npm", + "type": "action.run_command", + "label": "Publish to npm", + "config": { + "command": "if [ \"{{dryRun}}\" = \"true\" ]; then echo 'Dry run: skipping npm publish'; else npm publish --access public; fi", + "continueOnError": true + }, + "position": { + "x": 250, + "y": 1090 + }, + "outputs": [ + "default" + ] }, { - "id": "push-ok-retry->notify-pr-failed-retry", - "source": "push-ok-retry", - "target": "notify-pr-failed-retry", - "sourcePort": "no", - "condition": "$output?.result !== true" + "id": "create-gh-release", + "type": "action.run_command", + "label": "GitHub Release", + "config": { + "command": "gh release create v{{version}} --generate-notes --title \"v{{version}}\"", + "continueOnError": true + }, + "position": { + "x": 250, + "y": 1220 + }, + "outputs": [ + "default" + ] }, { - "id": "create-pr-retry->retry-pr-ok", - "source": "create-pr-retry", - "target": "retry-pr-ok", - "sourcePort": "default" + "id": "notify-success", + "type": "notify.telegram", + "label": "Notify: Released", + "config": { + "message": ":box: **Release published!**\n\nVersion: v{{version}}\nnpm + GitHub release created." + }, + "position": { + "x": 250, + "y": 1350 + }, + "outputs": [ + "default" + ] }, { - "id": "retry-pr-ok->retry-set-inreview", - "source": "retry-pr-ok", - "target": "retry-set-inreview", - "sourcePort": "yes" - }, + "id": "notify-failure", + "type": "notify.telegram", + "label": "Notify: Release Failed", + "config": { + "message": ":close: **Release pipeline failed** at test stage.\n\nVersion bump was {{bumpType}} but tests did not pass. Manual intervention required." + }, + "position": { + "x": 600, + "y": 960 + }, + "outputs": [ + "default" + ] + } + ], + "edges": [ { - "id": "retry-set-inreview->retry-handoff-progressor", - "source": "retry-set-inreview", - "target": "retry-handoff-progressor", + "id": "trigger->bump-version", + "source": "trigger", + "target": "bump-version", "sourcePort": "default" }, { - "id": "retry-handoff-progressor->notify-done-retry", - "source": "retry-handoff-progressor", - "target": "notify-done-retry", + "id": "bump-version->read-version", + "source": "bump-version", + "target": "read-version", "sourcePort": "default" }, { - "id": "retry-pr-ok->notify-pr-failed-retry", - "source": "retry-pr-ok", - "target": "notify-pr-failed-retry", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "set-retry2-summary->auto-fix-2", - "source": "set-retry2-summary", - "target": "auto-fix-2", + "id": "read-version->set-version", + "source": "read-version", + "target": "set-version", "sourcePort": "default" }, { - "id": "auto-fix-2->retry2-build", - "source": "auto-fix-2", - "target": "retry2-build", + "id": "set-version->generate-changelog", + "source": "set-version", + "target": "generate-changelog", "sourcePort": "default" }, { - "id": "retry2-build->retry2-test", - "source": "retry2-build", - "target": "retry2-test", + "id": "generate-changelog->build", + "source": "generate-changelog", + "target": "build", "sourcePort": "default" }, { - "id": "retry2-test->retry2-lint", - "source": "retry2-test", - "target": "retry2-lint", + "id": "build->test", + "source": "build", + "target": "test", "sourcePort": "default" }, { - "id": "retry2-lint->retry2-passed", - "source": "retry2-lint", - "target": "retry2-passed", + "id": "test->test-passed", + "source": "test", + "target": "test-passed", "sourcePort": "default" }, { - "id": "retry2-passed->push-branch-retry2", - "source": "retry2-passed", - "target": "push-branch-retry2", + "id": "test-passed->commit-tag", + "source": "test-passed", + "target": "commit-tag", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "retry2-passed->set-blocked-validation", - "source": "retry2-passed", - "target": "set-blocked-validation", + "id": "test-passed->notify-failure", + "source": "test-passed", + "target": "notify-failure", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "set-blocked-validation->notify-fail", - "source": "set-blocked-validation", - "target": "notify-fail", - "sourcePort": "default" - }, - { - "id": "push-branch-retry2->push-ok-retry2", - "source": "push-branch-retry2", - "target": "push-ok-retry2", + "id": "commit-tag->should-publish", + "source": "commit-tag", + "target": "should-publish", "sourcePort": "default" }, { - "id": "push-ok-retry2->create-pr-retry2", - "source": "push-ok-retry2", - "target": "create-pr-retry2", + "id": "should-publish->publish-npm", + "source": "should-publish", + "target": "publish-npm", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "push-ok-retry2->notify-pr-failed-retry2", - "source": "push-ok-retry2", - "target": "notify-pr-failed-retry2", + "id": "should-publish->create-gh-release", + "source": "should-publish", + "target": "create-gh-release", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "create-pr-retry2->retry2-pr-ok", - "source": "create-pr-retry2", - "target": "retry2-pr-ok", - "sourcePort": "default" - }, - { - "id": "retry2-pr-ok->retry2-set-inreview", - "source": "retry2-pr-ok", - "target": "retry2-set-inreview", - "sourcePort": "yes" - }, - { - "id": "retry2-set-inreview->retry2-handoff-progressor", - "source": "retry2-set-inreview", - "target": "retry2-handoff-progressor", + "id": "publish-npm->create-gh-release", + "source": "publish-npm", + "target": "create-gh-release", "sourcePort": "default" }, { - "id": "retry2-handoff-progressor->notify-done-retry2", - "source": "retry2-handoff-progressor", - "target": "notify-done-retry2", + "id": "create-gh-release->notify-success", + "source": "create-gh-release", + "target": "notify-success", "sourcePort": "default" - }, - { - "id": "retry2-pr-ok->notify-pr-failed-retry2", - "source": "retry2-pr-ok", - "target": "notify-pr-failed-retry2", - "sourcePort": "no", - "condition": "$output?.result !== true" } ] }, { - "id": "template-voice-video-parallel-rollout", - "name": "Voice + Video Rollout (Parallel Lanes)", - "description": "Launches three agent lanes in parallel (capture pipeline, provider adapters, and QA/rollout hardening) to accelerate Voice + Video delivery while keeping workstreams isolated by worktree.", - "category": "agents", - "categoryLabel": "Agents", - "categoryIcon": ":bot:", - "categoryOrder": 2, + "id": "template-nightly-report", + "name": "Nightly Report", + "description": "Generates a daily summary of agent activity: tasks completed, PRs merged, errors encountered, and token usage. Sends to Telegram.", + "category": "planning", + "categoryLabel": "Planning", + "categoryIcon": ":clipboard:", + "categoryOrder": 4, "tags": [ - "voice", - "video", - "parallel", - "subagents", - "rollout" + "report", + "daily", + "telegram", + "analytics" ], - "nodeCount": 11, - "edgeCount": 12, + "nodeCount": 6, + "edgeCount": 7, "recommended": false, "enabled": false, - "trigger": "trigger.manual", + "trigger": "trigger.schedule", "variables": { - "lane1Worktree": "{{worktreePath}}", - "lane2Worktree": "{{worktreePath}}", - "lane3Worktree": "{{worktreePath}}", - "integrationBranch": "feat/voice-video-integration", - "definitionOfDone": "Voice + vision works end-to-end, provider fallback is explicit, and tests cover config + transport + failure paths." + "reportHour": 23, + "reportTimezone": "UTC" }, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2026-02-28T00:00:00Z", + "createdAt": "2025-02-25T00:00:00Z", "templateVersion": "1.0.0", "tags": [ - "voice", - "video", - "parallel", - "subagents", - "rollout" - ] + "report", + "daily", + "telegram", + "analytics" + ], + "replaces": { + "module": "telegram-sentinel.mjs", + "functions": [ + "dailyDigest", + "sendStatusReport" + ], + "calledFrom": [ + "monitor.mjs:startSentinelBridge" + ], + "description": "Replaces ad-hoc Telegram status reporting with a scheduled nightly report workflow. Stats gathering runs in parallel, then an agent generates a formatted summary." + } }, "nodes": [ { "id": "trigger", - "type": "trigger.manual", - "label": "Launch Parallel Rollout", - "config": {}, + "type": "trigger.schedule", + "label": "Nightly at 11pm", + "config": { + "intervalMs": 86400000, + "cron": "0 {{reportHour}} * * *" + }, "position": { - "x": 500, + "x": 400, "y": 50 }, "outputs": [ @@ -7321,308 +6736,186 @@ ] }, { - "id": "check-worktrees", - "type": "condition.expression", - "label": "Worktrees Distinct?", + "id": "get-task-stats", + "type": "action.run_command", + "label": "Get Task Stats", "config": { - "expression": "(() => { const a = String($data?.lane1Worktree || '').trim(); const b = String($data?.lane2Worktree || '').trim(); const c = String($data?.lane3Worktree || '').trim(); if (!a || !b || !c) return false; return new Set([a, b, c]).size === 3; })()" + "command": "bosun task stats --json", + "continueOnError": true }, "position": { - "x": 500, - "y": 170 + "x": 150, + "y": 200 }, "outputs": [ "default" ] }, { - "id": "notify-worktree-error", - "type": "notify.telegram", - "label": "Invalid Worktree Setup", + "id": "get-pr-stats", + "type": "action.run_command", + "label": "Get PR Stats", "config": { - "message": "Parallel rollout aborted. Configure three distinct worktrees in `lane1Worktree`, `lane2Worktree`, and `lane3Worktree` before launching." + "command": "gh pr list --state all --json number,state,mergedAt --limit 50", + "continueOnError": true }, "position": { - "x": 860, - "y": 170 + "x": 400, + "y": 200 }, "outputs": [ "default" ] }, { - "id": "kickoff-log", - "type": "notify.log", - "label": "Kickoff Parallel Lanes", + "id": "get-agent-stats", + "type": "action.run_command", + "label": "Get Agent Stats", "config": { - "message": "Starting parallel rollout on branch {{integrationBranch}} with 3 lanes.", - "level": "info" + "command": "bosun agent stats --json 2>/dev/null || echo '{}'", + "continueOnError": true }, "position": { - "x": 500, - "y": 290 + "x": 650, + "y": 200 }, "outputs": [ "default" ] }, { - "id": "lane-capture-core", + "id": "generate-report", "type": "action.run_agent", - "label": "Lane 1: Capture Core", + "label": "Generate Report", "config": { - "prompt": "# Lane 1 - Capture Core\n\nWork only in this lane's worktree. Focus on:\n1. Voice video config/schema/env/settings keys\n2. Browser capture loop (screen/camera), adaptive FPS, compression, change detection\n3. Overlay controls + capture state indicators\n\nGuardrails:\n- Do not touch provider dispatch code owned by Lane 2\n- Keep changes bounded to UI/config paths\n- Add/extend tests for capture throttling and config behavior\n\nTarget branch: {{integrationBranch}}\nDefinition of done: {{definitionOfDone}}", - "sdk": "auto", - "cwd": "{{lane1Worktree}}", - "timeoutMs": 5400000, - "includeTaskContext": false, - "failOnError": true + "prompt": "Generate a concise daily activity report from the following data.\n\n## Task Stats\n{{taskStats}}\n\n## PR Activity\n{{prStats}}\n\n## Agent Activity\n{{agentStats}}\n\nFormat as a Telegram-friendly message with emoji headers. Include:\n- Tasks completed today vs yesterday\n- PRs merged / opened / closed\n- Agent success rate\n- Notable errors or anomalies\n- Recommendations for tomorrow", + "timeoutMs": 300000 }, "position": { - "x": 120, - "y": 450 + "x": 400, + "y": 380 }, "outputs": [ "default" ] }, { - "id": "lane-provider-bridge", - "type": "action.run_agent", - "label": "Lane 2: Provider Bridge", + "id": "send-report", + "type": "notify.telegram", + "label": "Send Report", "config": { - "prompt": "# Lane 2 - Provider Bridge\n\nWork only in this lane's worktree. Focus on:\n1. Server-side vision frame ingress route and validation\n2. Provider dispatch in voice relay (OpenAI image path, Gemini live path, Claude vision path)\n3. Rate-limits, payload caps, and fallback semantics\n\nGuardrails:\n- Do not edit overlay/capture UI owned by Lane 1\n- Keep provider logic behind explicit feature flags\n- Add/extend tests for endpoint validation and provider routing\n\nTarget branch: {{integrationBranch}}\nDefinition of done: {{definitionOfDone}}", - "sdk": "auto", - "cwd": "{{lane2Worktree}}", - "timeoutMs": 5400000, - "includeTaskContext": false, - "failOnError": true + "message": ":chart: **Daily Bosun Report** ({{reportTimezone}})\n\n{{reportOutput}}" }, "position": { - "x": 500, - "y": 450 + "x": 400, + "y": 540 }, "outputs": [ "default" ] + } + ], + "edges": [ + { + "id": "trigger->get-task-stats", + "source": "trigger", + "target": "get-task-stats", + "sourcePort": "default" }, { - "id": "lane-hardening", - "type": "action.run_agent", - "label": "Lane 3: QA + Rollout", - "config": { - "prompt": "# Lane 3 - QA + Rollout Hardening\n\nWork only in this lane's worktree. Focus on:\n1. Integration tests, resilience tests, and docs updates\n2. Migration/rollout notes and operator controls\n3. Conflict-free merge guidance across Lane 1 and Lane 2 outputs\n\nGuardrails:\n- Avoid touching core capture loop and provider dispatch internals unless a test proves breakage\n- Keep this lane focused on verification, docs, and release safety\n- Produce a concise verification summary\n\nTarget branch: {{integrationBranch}}\nDefinition of done: {{definitionOfDone}}", - "sdk": "auto", - "cwd": "{{lane3Worktree}}", - "timeoutMs": 3600000, - "includeTaskContext": false, - "failOnError": true - }, - "position": { - "x": 880, - "y": 450 - }, - "outputs": [ - "default" - ] + "id": "trigger->get-pr-stats", + "source": "trigger", + "target": "get-pr-stats", + "sourcePort": "default" }, { - "id": "aggregate", - "type": "transform.aggregate", - "label": "Aggregate Lane Results", - "config": { - "sources": [ - "lane-capture-core", - "lane-provider-bridge", - "lane-hardening" - ] - }, - "position": { - "x": 500, - "y": 640 - }, - "outputs": [ - "default" - ] + "id": "trigger->get-agent-stats", + "source": "trigger", + "target": "get-agent-stats", + "sourcePort": "default" }, { - "id": "all-passed", - "type": "condition.expression", - "label": "All Lanes Passed?", - "config": { - "expression": "$ctx.getNodeOutput('lane-capture-core')?.success === true && $ctx.getNodeOutput('lane-provider-bridge')?.success === true && $ctx.getNodeOutput('lane-hardening')?.success === true" - }, - "position": { - "x": 500, - "y": 770 - }, - "outputs": [ - "default" - ] + "id": "get-task-stats->generate-report", + "source": "get-task-stats", + "target": "generate-report", + "sourcePort": "default" }, { - "id": "notify-success", - "type": "notify.telegram", - "label": "Notify Success", - "config": { - "message": "Parallel Voice + Video rollout lanes completed successfully on {{integrationBranch}}. Proceed to integration and final verification." - }, - "position": { - "x": 300, - "y": 910 - }, - "outputs": [ - "default" - ] - }, - { - "id": "notify-failure", - "type": "notify.telegram", - "label": "Notify Failure", - "config": { - "message": "Parallel Voice + Video rollout has lane failures on {{integrationBranch}}. Inspect lane outputs before integration." - }, - "position": { - "x": 700, - "y": 910 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->check-worktrees", - "source": "trigger", - "target": "check-worktrees", - "sourcePort": "default" - }, - { - "id": "check-worktrees->kickoff-log", - "source": "check-worktrees", - "target": "kickoff-log", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "check-worktrees->notify-worktree-error", - "source": "check-worktrees", - "target": "notify-worktree-error", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "kickoff-log->lane-capture-core", - "source": "kickoff-log", - "target": "lane-capture-core", - "sourcePort": "default" - }, - { - "id": "kickoff-log->lane-provider-bridge", - "source": "kickoff-log", - "target": "lane-provider-bridge", - "sourcePort": "default" - }, - { - "id": "kickoff-log->lane-hardening", - "source": "kickoff-log", - "target": "lane-hardening", - "sourcePort": "default" - }, - { - "id": "lane-capture-core->aggregate", - "source": "lane-capture-core", - "target": "aggregate", - "sourcePort": "default" - }, - { - "id": "lane-provider-bridge->aggregate", - "source": "lane-provider-bridge", - "target": "aggregate", + "id": "get-pr-stats->generate-report", + "source": "get-pr-stats", + "target": "generate-report", "sourcePort": "default" }, { - "id": "lane-hardening->aggregate", - "source": "lane-hardening", - "target": "aggregate", + "id": "get-agent-stats->generate-report", + "source": "get-agent-stats", + "target": "generate-report", "sourcePort": "default" }, { - "id": "aggregate->all-passed", - "source": "aggregate", - "target": "all-passed", + "id": "generate-report->send-report", + "source": "generate-report", + "target": "send-report", "sourcePort": "default" - }, - { - "id": "all-passed->notify-success", - "source": "all-passed", - "target": "notify-success", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "all-passed->notify-failure", - "source": "all-passed", - "target": "notify-failure", - "sourcePort": "default", - "condition": "$output?.result !== true" } ] }, { - "id": "template-build-deploy", - "name": "Build & Deploy", - "description": "Complete CI/CD-style pipeline: build → test → lint → deploy. Configurable deployment commands for any hosting target.", - "category": "ci-cd", - "categoryLabel": "CI/CD", - "categoryIcon": ":rocket:", - "categoryOrder": 3, + "id": "template-sprint-retrospective", + "name": "Sprint Retrospective", + "description": "Weekly automated retrospective: gathers metrics on tasks completed, PRs merged, agent success rates, and common failure patterns. Generates improvement suggestions and creates action item tasks.", + "category": "planning", + "categoryLabel": "Planning", + "categoryIcon": ":clipboard:", + "categoryOrder": 4, "tags": [ - "ci", - "cd", - "deploy", - "build" + "planning", + "retrospective", + "metrics", + "improvement", + "weekly" ], - "nodeCount": 6, - "edgeCount": 5, + "nodeCount": 10, + "edgeCount": 11, "recommended": false, - "enabled": false, - "trigger": "trigger.event", + "enabled": true, + "trigger": "trigger.schedule", "variables": { - "deployCommand": "npm run deploy", - "deployBranch": "main" + "lookbackDays": 7, + "lookbackWindowMs": 604800000, + "createImprovementTasks": true }, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2025-02-24T00:00:00Z", + "createdAt": "2025-02-25T00:00:00Z", "templateVersion": "1.0.0", "tags": [ - "ci", - "cd", - "deploy", - "build" + "planning", + "retrospective", + "metrics", + "improvement", + "weekly" ], "replaces": { - "module": "monitor.mjs", + "module": "telegram-sentinel.mjs", "functions": [ - "preflight checks" + "weeklyDigest" ], "calledFrom": [ - "preflight.mjs" + "monitor.mjs:scheduleWeeklyDigest" ], - "description": "Replaces ad-hoc build/test/lint validation steps with a coordinated CI/CD pipeline workflow." + "description": "Replaces simple weekly digest with a comprehensive retrospective workflow. Metrics gathering, AI analysis, action item creation, and reporting are structured as workflow stages." } }, "nodes": [ { "id": "trigger", - "type": "trigger.event", - "label": "On PR Merged", + "type": "trigger.schedule", + "label": "Weekly Retro", "config": { - "eventType": "pr.merged", - "filter": "$event.branch === '{{deployBranch}}'" + "intervalMs": 604800000, + "cron": "0 9 * * 1" }, "position": { "x": 400, @@ -7633,76 +6926,145 @@ ] }, { - "id": "build", - "type": "validation.build", - "label": "Build", + "id": "task-metrics", + "type": "action.bosun_cli", + "label": "Gather Task Metrics", "config": { - "command": "npm run build", - "zeroWarnings": true + "command": "task list --format json --since {{lookbackDays}}d", + "continueOnError": true }, "position": { - "x": 400, - "y": 180 + "x": 200, + "y": 200 }, "outputs": [ "default" ] }, { - "id": "test", - "type": "validation.tests", - "label": "Tests", + "id": "pr-metrics", + "type": "action.run_command", + "label": "Gather PR Metrics", "config": { - "command": "npm test" + "command": "gh pr list --state all --json number,title,state,createdAt,mergedAt,closedAt --limit 50", + "continueOnError": true }, "position": { - "x": 400, - "y": 310 + "x": 600, + "y": 200 }, "outputs": [ "default" ] }, { - "id": "lint", - "type": "validation.lint", - "label": "Lint", + "id": "error-analysis", + "type": "action.analyze_errors", + "label": "Analyze Error Patterns", "config": { - "command": "npm run lint" + "timeWindowMs": "{{lookbackWindowMs}}", + "groupBy": "category" + }, + "position": { + "x": 200, + "y": 350 + }, + "outputs": [ + "default" + ] + }, + { + "id": "agent-stats", + "type": "action.bosun_cli", + "label": "Agent Performance", + "config": { + "command": "status --json", + "continueOnError": true + }, + "position": { + "x": 600, + "y": 350 + }, + "outputs": [ + "default" + ] + }, + { + "id": "generate-retro", + "type": "action.run_agent", + "label": "Generate Retrospective", + "config": { + "prompt": "# Sprint Retrospective Analysis\n\nAnalyze the following data from the past {{lookbackDays}} days:\n\n## Task Metrics\n{{taskMetrics}}\n\n## PR Metrics\n{{prMetrics}}\n\n## Error Patterns\n{{errorAnalysis}}\n\n## Agent Performance\n{{agentStats}}\n\nGenerate a retrospective report with these sections:\n\n### :chart: Key Metrics\n- Tasks completed vs created\n- Average task cycle time\n- PR merge rate and average review time\n- Agent success rate\n\n### :check: What Went Well\n- Highlight successful patterns and wins\n\n### :close: What Didn't Go Well\n- Identify bottlenecks and recurring issues\n\n### :target: Action Items\nFor each improvement suggestion, output a line:\nACTION: [title] | [description]\n\nBe specific and actionable. Limit to 3-5 improvement items.", + "sdk": "auto", + "timeoutMs": 600000 }, "position": { "x": 400, - "y": 440 + "y": 520 }, "outputs": [ "default" ] }, { - "id": "deploy", - "type": "action.run_command", - "label": "Deploy", + "id": "has-actions", + "type": "condition.expression", + "label": "Has Action Items?", "config": { - "command": "{{deployCommand}}" + "expression": "($ctx.getNodeOutput('generate-retro')?.output || '').includes('ACTION:')" }, "position": { "x": 400, - "y": 570 + "y": 680 + }, + "outputs": [ + "yes", + "no" + ] + }, + { + "id": "create-tasks", + "type": "action.run_agent", + "label": "Create Improvement Tasks", + "config": { + "prompt": "# Create Improvement Tasks\n\nFrom the retrospective output, extract all lines starting with ACTION:\nand create a bosun task for each one.\n\nUse the CLI: bosun task create --title \"[title]\" --description \"[description]\" --tag improvement --tag retro\n\nOnly create tasks if {{createImprovementTasks}} is true.", + "sdk": "auto", + "timeoutMs": 300000 + }, + "position": { + "x": 250, + "y": 830 }, "outputs": [ "default" ] }, { - "id": "notify", + "id": "send-report", "type": "notify.telegram", - "label": "Notify Deploy", + "label": "Send Retro Report", "config": { - "message": ":rocket: Deployment to production completed for {{branch}}" + "message": ":clipboard: **Weekly Retrospective** (past {{lookbackDays}} days)\n\n{{retroOutput}}" }, "position": { "x": 400, - "y": 700 + "y": 980 + }, + "outputs": [ + "default" + ] + }, + { + "id": "log-no-actions", + "type": "notify.log", + "label": "No Actions Needed", + "config": { + "message": "Sprint retrospective complete — no action items generated", + "level": "info" + }, + "position": { + "x": 600, + "y": 830 }, "outputs": [ "default" @@ -7711,84 +7073,130 @@ ], "edges": [ { - "id": "trigger->build", + "id": "trigger->task-metrics", "source": "trigger", - "target": "build", + "target": "task-metrics", "sourcePort": "default" }, { - "id": "build->test", - "source": "build", - "target": "test", + "id": "trigger->pr-metrics", + "source": "trigger", + "target": "pr-metrics", "sourcePort": "default" }, { - "id": "test->lint", - "source": "test", - "target": "lint", + "id": "task-metrics->error-analysis", + "source": "task-metrics", + "target": "error-analysis", "sourcePort": "default" }, { - "id": "lint->deploy", - "source": "lint", - "target": "deploy", + "id": "pr-metrics->agent-stats", + "source": "pr-metrics", + "target": "agent-stats", "sourcePort": "default" }, { - "id": "deploy->notify", - "source": "deploy", - "target": "notify", + "id": "error-analysis->generate-retro", + "source": "error-analysis", + "target": "generate-retro", + "sourcePort": "default" + }, + { + "id": "agent-stats->generate-retro", + "source": "agent-stats", + "target": "generate-retro", + "sourcePort": "default" + }, + { + "id": "generate-retro->has-actions", + "source": "generate-retro", + "target": "has-actions", + "sourcePort": "default" + }, + { + "id": "has-actions->create-tasks", + "source": "has-actions", + "target": "create-tasks", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "has-actions->log-no-actions", + "source": "has-actions", + "target": "log-no-actions", + "sourcePort": "no", + "condition": "$output?.result !== true" + }, + { + "id": "create-tasks->send-report", + "source": "create-tasks", + "target": "send-report", + "sourcePort": "default" + }, + { + "id": "log-no-actions->send-report", + "source": "log-no-actions", + "target": "send-report", "sourcePort": "default" } ] }, { - "id": "template-canary-deploy", - "name": "Canary Deploy", - "description": "Two-phase deployment: deploy to a staging/canary environment first, run smoke tests, then promote to production or auto-rollback on failure. Reduces blast radius of bad deploys.", - "category": "ci-cd", - "categoryLabel": "CI/CD", - "categoryIcon": ":rocket:", - "categoryOrder": 3, + "id": "template-task-planner", + "name": "Task Planner", + "description": "Automatically generates new backlog tasks when the todo count drops below a configurable threshold. Replaces the previous hardcoded TASK_PLANNER_MODE / REPLENISH_ENABLED env-var system.", + "category": "planning", + "categoryLabel": "Planning", + "categoryIcon": ":clipboard:", + "categoryOrder": 4, "tags": [ - "deploy", - "canary", - "staging", - "rollback", - "smoke-test" + "planner", + "backlog", + "automation" ], - "nodeCount": 12, - "edgeCount": 11, - "recommended": false, - "enabled": false, - "trigger": "trigger.manual", + "nodeCount": 11, + "edgeCount": 10, + "recommended": true, + "enabled": true, + "trigger": "trigger.task_low", "variables": { - "stagingCommand": "npm run deploy:staging", - "productionCommand": "npm run deploy:production", - "rollbackCommand": "npm run deploy:rollback", - "smokeTestCommand": "npm run test:smoke", - "promotionDelayMs": 300000 + "minTodoCount": 3, + "taskCount": 5, + "dedupHours": 24, + "failureCooldownMinutes": 30, + "prompt": "", + "plannerContext": "Focus on high-value implementation work. Avoid duplicating existing tasks." }, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2025-02-25T00:00:00Z", + "createdAt": "2025-02-24T00:00:00Z", "templateVersion": "1.0.0", "tags": [ - "deploy", - "canary", - "staging", - "rollback", - "smoke-test" - ] + "planner", + "backlog", + "automation" + ], + "replaces": { + "module": "monitor.mjs", + "functions": [ + "startTaskPlannerStatusLoop" + ], + "calledFrom": [ + "monitor.mjs:startProcess" + ], + "description": "Replaces the hardcoded task planner status loop. Task counting, gap analysis, and replenishment are visual workflow steps." + } }, "nodes": [ { "id": "trigger", - "type": "trigger.manual", - "label": "Deploy Canary", + "type": "trigger.task_low", + "label": "Backlog Low?", "config": { - "description": "Start a canary deployment" + "threshold": "{{minTodoCount}}", + "status": "todo" }, "position": { "x": 400, @@ -7799,12 +7207,11 @@ ] }, { - "id": "build", - "type": "validation.build", - "label": "Build", + "id": "check-dedup", + "type": "condition.expression", + "label": "Dedup Window", "config": { - "command": "npm run build", - "zeroWarnings": true + "expression": "(() => { const now = Date.now(); const lastSuccessAt = Number($data?._lastPlannerRun || 0); const lastFailureAt = Number($data?._lastPlannerFailureAt || 0); const successWindowMs = Number($data?.dedupHours || 24) * 3600000; const failureWindowMs = Number($data?.failureCooldownMinutes || 30) * 60000; return (now - lastSuccessAt) > successWindowMs && (now - lastFailureAt) > failureWindowMs;})()" }, "position": { "x": 400, @@ -7815,12 +7222,12 @@ ] }, { - "id": "deploy-staging", - "type": "action.run_command", - "label": "Deploy to Staging", + "id": "log-start", + "type": "notify.log", + "label": "Log Planner Start", "config": { - "command": "{{stagingCommand}}", - "continueOnError": true + "message": "Task planner triggered: {{trigger.todoCount}} tasks remaining (threshold: {{minTodoCount}})", + "level": "info" }, "position": { "x": 400, @@ -7831,31 +7238,43 @@ ] }, { - "id": "staging-ok", - "type": "condition.expression", - "label": "Staging Deploy OK?", + "id": "run-planner", + "type": "agent.run_planner", + "label": "Generate Tasks", "config": { - "expression": "$ctx.getNodeOutput('deploy-staging')?.success === true" + "taskCount": "{{taskCount}}", + "context": "{{plannerContext}}", + "prompt": "{{prompt}}", + "repoMapQuery": "{{plannerContext}} {{prompt}}", + "repoMapFileLimit": 8, + "dedup": true, + "timeoutMs": 960000, + "agentTimeoutMs": 900000, + "maxRetries": 0, + "retryable": false }, "position": { "x": 400, "y": 440 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "smoke-tests", - "type": "action.run_command", - "label": "Run Smoke Tests", + "id": "materialize-tasks", + "type": "action.materialize_planner_tasks", + "label": "Create Tasks", "config": { - "command": "{{smokeTestCommand}}", - "continueOnError": true + "plannerNodeId": "run-planner", + "maxTasks": "{{taskCount}}", + "status": "draft", + "dedup": true, + "failOnZero": true, + "minCreated": 1 }, "position": { - "x": 250, + "x": 400, "y": 570 }, "outputs": [ @@ -7863,31 +7282,31 @@ ] }, { - "id": "smoke-passed", + "id": "check-result", "type": "condition.expression", - "label": "Smoke Tests Passed?", + "label": "Planner Succeeded?", "config": { - "expression": "$ctx.getNodeOutput('smoke-tests')?.success === true" + "expression": "$ctx.getNodeOutput('materialize-tasks')?.success === true && ($ctx.getNodeOutput('materialize-tasks')?.createdCount || 0) > 0" }, "position": { - "x": 250, + "x": 400, "y": 700 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "wait-bake", - "type": "action.delay", - "label": "Bake Time", + "id": "set-timestamp", + "type": "action.set_variable", + "label": "Update Last Run", "config": { - "ms": "{{promotionDelayMs}}", - "reason": "Waiting for bake time before promoting to production" + "key": "_lastPlannerRun", + "value": "Date.now()", + "isExpression": true }, "position": { - "x": 100, + "x": 200, "y": 830 }, "outputs": [ @@ -7895,14 +7314,15 @@ ] }, { - "id": "promote-prod", - "type": "action.run_command", - "label": "Promote to Production", + "id": "notify-done", + "type": "notify.telegram", + "label": "Notify Tasks Created", "config": { - "command": "{{productionCommand}}" + "message": ":folder: Task planner created {{materialize-tasks.createdCount}} backlog tasks (skipped {{materialize-tasks.skippedCount}} duplicates).", + "silent": true }, "position": { - "x": 100, + "x": 200, "y": 960 }, "outputs": [ @@ -7910,45 +7330,31 @@ ] }, { - "id": "notify-success", - "type": "notify.telegram", - "label": "Deploy Succeeded", - "config": { - "message": ":check: **Canary deploy promoted to production** successfully." - }, - "position": { - "x": 100, - "y": 1090 - }, - "outputs": [ - "default" - ] - }, - { - "id": "rollback", - "type": "action.run_command", - "label": "Rollback", + "id": "notify-skip", + "type": "notify.log", + "label": "Log Dedup Skip", "config": { - "command": "{{rollbackCommand}}", - "continueOnError": true + "message": "Task planner skipped: within dedup window", + "level": "info" }, "position": { - "x": 550, - "y": 700 + "x": 650, + "y": 180 }, "outputs": [ "default" ] }, { - "id": "notify-rollback", - "type": "notify.telegram", - "label": "Deploy Rolled Back", + "id": "notify-fail", + "type": "notify.log", + "label": "Log Planner Failure", "config": { - "message": ":refresh: **Canary deploy rolled back.**\n\nSmoke tests or staging deploy failed. Production unchanged." + "message": "Task planner failed to materialize tasks from planner output", + "level": "warn" }, "position": { - "x": 550, + "x": 600, "y": 830 }, "outputs": [ @@ -7956,15 +7362,17 @@ ] }, { - "id": "notify-staging-fail", - "type": "notify.telegram", - "label": "Staging Failed", + "id": "set-timestamp-fail", + "type": "action.set_variable", + "label": "Cooldown After Failure", "config": { - "message": ":close: **Staging deploy failed.** Not proceeding to canary phase." + "key": "_lastPlannerFailureAt", + "value": "Date.now()", + "isExpression": true }, "position": { "x": 600, - "y": 440 + "y": 960 }, "outputs": [ "default" @@ -7973,134 +7381,124 @@ ], "edges": [ { - "id": "trigger->build", + "id": "trigger->check-dedup", "source": "trigger", - "target": "build", + "target": "check-dedup", "sourcePort": "default" }, { - "id": "build->deploy-staging", - "source": "build", - "target": "deploy-staging", - "sourcePort": "default" + "id": "check-dedup->log-start", + "source": "check-dedup", + "target": "log-start", + "sourcePort": "default", + "condition": "$output?.result === true" }, { - "id": "deploy-staging->staging-ok", - "source": "deploy-staging", - "target": "staging-ok", - "sourcePort": "default" + "id": "check-dedup->notify-skip", + "source": "check-dedup", + "target": "notify-skip", + "sourcePort": "default", + "condition": "$output?.result !== true" }, { - "id": "staging-ok->smoke-tests", - "source": "staging-ok", - "target": "smoke-tests", - "sourcePort": "yes", - "condition": "$output?.result === true" + "id": "log-start->run-planner", + "source": "log-start", + "target": "run-planner", + "sourcePort": "default" }, { - "id": "staging-ok->notify-staging-fail", - "source": "staging-ok", - "target": "notify-staging-fail", - "sourcePort": "no", - "condition": "$output?.result !== true" + "id": "run-planner->materialize-tasks", + "source": "run-planner", + "target": "materialize-tasks", + "sourcePort": "default" }, { - "id": "smoke-tests->smoke-passed", - "source": "smoke-tests", - "target": "smoke-passed", + "id": "materialize-tasks->check-result", + "source": "materialize-tasks", + "target": "check-result", "sourcePort": "default" }, { - "id": "smoke-passed->wait-bake", - "source": "smoke-passed", - "target": "wait-bake", - "sourcePort": "yes", + "id": "check-result->set-timestamp", + "source": "check-result", + "target": "set-timestamp", + "sourcePort": "default", "condition": "$output?.result === true" }, { - "id": "smoke-passed->rollback", - "source": "smoke-passed", - "target": "rollback", - "sourcePort": "no", + "id": "check-result->notify-fail", + "source": "check-result", + "target": "notify-fail", + "sourcePort": "default", "condition": "$output?.result !== true" }, { - "id": "wait-bake->promote-prod", - "source": "wait-bake", - "target": "promote-prod", - "sourcePort": "default" - }, - { - "id": "promote-prod->notify-success", - "source": "promote-prod", - "target": "notify-success", + "id": "set-timestamp->notify-done", + "source": "set-timestamp", + "target": "notify-done", "sourcePort": "default" }, { - "id": "rollback->notify-rollback", - "source": "rollback", - "target": "notify-rollback", + "id": "notify-fail->set-timestamp-fail", + "source": "notify-fail", + "target": "set-timestamp-fail", "sourcePort": "default" } ] }, { - "id": "template-release-pipeline", - "name": "Release Pipeline", - "description": "End-to-end release automation: version bump, changelog generation, build, test, npm publish, GitHub release creation, and team notification. Triggered manually or on a schedule for regular release cadences.", - "category": "ci-cd", - "categoryLabel": "CI/CD", - "categoryIcon": ":rocket:", - "categoryOrder": 3, + "id": "template-task-replenish", + "name": "Task Replenish (Scheduled)", + "description": "Periodically checks backlog and replenishes tasks on a schedule. This replaces the previous INTERNAL_EXECUTOR_REPLENISH_ENABLED env var with a configurable visual workflow.", + "category": "planning", + "categoryLabel": "Planning", + "categoryIcon": ":clipboard:", + "categoryOrder": 4, "tags": [ - "release", - "publish", - "npm", - "changelog", - "version" + "replenish", + "schedule", + "backlog" ], - "nodeCount": 14, - "edgeCount": 14, - "recommended": true, - "enabled": true, - "trigger": "trigger.manual", + "nodeCount": 7, + "edgeCount": 6, + "recommended": false, + "enabled": false, + "trigger": "trigger.schedule", "variables": { - "bumpType": "patch", - "publishToNpm": true, - "dryRun": false + "intervalMs": 3600000, + "minTodoCount": 5, + "taskCount": 8, + "prompt": "", + "plannerContext": "Scheduled replenishment run. Prioritize implementation tasks that build on recent PRs." }, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2025-02-25T00:00:00Z", + "createdAt": "2025-02-24T00:00:00Z", "templateVersion": "1.0.0", "tags": [ - "release", - "publish", - "npm", - "changelog", - "version" + "replenish", + "schedule", + "backlog" ], "replaces": { - "module": "publish.mjs", + "module": "monitor.mjs", "functions": [ - "publish", - "bumpVersion", - "createGitHubRelease" + "startTaskPlannerStatusLoop (scheduled variant)" ], "calledFrom": [ - "cli.mjs:publish" + "monitor.mjs:startProcess" ], - "description": "Replaces the imperative publish.mjs script with a visual release pipeline. Each stage (bump, changelog, build, test, publish, release) becomes a discrete, retriable workflow node." + "description": "Replaces the cron-based task replenishment loop in monitor. Backlog scanning and planner execution become visual workflow steps." } }, "nodes": [ { "id": "trigger", - "type": "trigger.manual", - "label": "Start Release", + "type": "trigger.schedule", + "label": "Hourly Check", "config": { - "description": "Kick off a new release" + "intervalMs": "{{intervalMs}}" }, "position": { "x": 400, @@ -8111,11 +7509,11 @@ ] }, { - "id": "bump-version", - "type": "action.run_command", - "label": "Bump Version", + "id": "check-backlog", + "type": "trigger.task_low", + "label": "Check Backlog Level", "config": { - "command": "npm version {{bumpType}} --no-git-tag-version" + "threshold": "{{minTodoCount}}" }, "position": { "x": 400, @@ -8126,11 +7524,11 @@ ] }, { - "id": "read-version", - "type": "action.run_command", - "label": "Read New Version", + "id": "needs-tasks", + "type": "condition.expression", + "label": "Needs Replenishment?", "config": { - "command": "node -p \"require('./package.json').version\"" + "expression": "$ctx.getNodeOutput('check-backlog')?.triggered === true" }, "position": { "x": 400, @@ -8141,427 +7539,419 @@ ] }, { - "id": "set-version", - "type": "action.set_variable", - "label": "Set Version Variable", + "id": "run-planner", + "type": "agent.run_planner", + "label": "Generate Tasks", "config": { - "key": "version", - "value": "(() => String($ctx.getNodeOutput('read-version')?.output || '').trim())()", - "isExpression": true + "taskCount": "{{taskCount}}", + "context": "{{plannerContext}}", + "prompt": "{{prompt}}", + "repoMapQuery": "{{plannerContext}} {{prompt}}", + "repoMapFileLimit": 8, + "timeoutMs": 960000, + "agentTimeoutMs": 900000, + "maxRetries": 0, + "retryable": false }, "position": { "x": 400, - "y": 380 + "y": 440 }, "outputs": [ "default" ] }, { - "id": "generate-changelog", - "type": "action.run_agent", - "label": "Generate Changelog", + "id": "materialize-tasks", + "type": "action.materialize_planner_tasks", + "label": "Create Tasks", "config": { - "prompt": "# Generate Changelog Entry\n\nRead the git log since the last tag:\n```\ngit log $(git describe --tags --abbrev=0)..HEAD --oneline\n```\n\nGroup commits into categories (Features, Fixes, Refactors, Docs, etc.)\nfollowing the Keep a Changelog format.\n\nWrite the entry to CHANGELOG.md under a new version heading.\nCommit the result with message \"docs: update changelog for vX.Y.Z\".", - "sdk": "auto", - "timeoutMs": 600000 + "plannerNodeId": "run-planner", + "maxTasks": "{{taskCount}}", + "status": "todo", + "dedup": true, + "failOnZero": true, + "minCreated": 1 }, "position": { "x": 400, - "y": 440 + "y": 570 }, "outputs": [ "default" ] }, { - "id": "build", - "type": "validation.build", - "label": "Build", + "id": "notify", + "type": "notify.telegram", + "label": "Notify", "config": { - "command": "npm run build", - "zeroWarnings": true + "message": ":refresh: Scheduled replenishment created {{materialize-tasks.createdCount}} tasks (skipped {{materialize-tasks.skippedCount}}).", + "silent": true }, "position": { "x": 400, - "y": 570 + "y": 700 }, "outputs": [ "default" ] }, { - "id": "test", - "type": "validation.tests", - "label": "Run Tests", + "id": "skip-log", + "type": "notify.log", + "label": "No Replenish Needed", "config": { - "command": "npm test" + "message": "Scheduled replenishment check: backlog sufficient, skipping" }, "position": { - "x": 400, - "y": 700 + "x": 700, + "y": 310 }, "outputs": [ "default" ] + } + ], + "edges": [ + { + "id": "trigger->check-backlog", + "source": "trigger", + "target": "check-backlog", + "sourcePort": "default" }, { - "id": "test-passed", - "type": "condition.expression", - "label": "Tests Passed?", + "id": "check-backlog->needs-tasks", + "source": "check-backlog", + "target": "needs-tasks", + "sourcePort": "default" + }, + { + "id": "needs-tasks->run-planner", + "source": "needs-tasks", + "target": "run-planner", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "needs-tasks->skip-log", + "source": "needs-tasks", + "target": "skip-log", + "sourcePort": "default", + "condition": "$output?.result !== true" + }, + { + "id": "run-planner->materialize-tasks", + "source": "run-planner", + "target": "materialize-tasks", + "sourcePort": "default" + }, + { + "id": "materialize-tasks->notify", + "source": "materialize-tasks", + "target": "notify", + "sourcePort": "default" + } + ] + }, + { + "id": "template-weekly-fitness-summary", + "name": "Weekly Fitness Summary", + "description": "Weekly evaluator workflow that scores delivery fitness using throughput, regression rate, merge success, reopened tasks, and debt growth. Produces follow-up actions and can materialize them as backlog tasks.", + "category": "planning", + "categoryLabel": "Planning", + "categoryIcon": ":clipboard:", + "categoryOrder": 4, + "tags": [ + "planning", + "weekly", + "fitness", + "evaluation", + "debt", + "throughput" + ], + "nodeCount": 15, + "edgeCount": 18, + "recommended": false, + "enabled": false, + "trigger": "trigger.schedule", + "variables": { + "scheduleCron": "0 9 * * 1", + "lookbackDays": 7, + "evaluatorFocus": "Bias toward systemic fixes that reduce regressions and execution thrash.", + "createFollowupTasks": true, + "maxFollowupTasks": 4 + }, + "metadata": { + "author": "bosun", + "version": 1, + "createdAt": "2026-03-07T00:00:00Z", + "templateVersion": "1.0.0", + "tags": [ + "planning", + "weekly", + "fitness", + "evaluation", + "debt", + "throughput" + ], + "replaces": { + "module": "monitor.mjs", + "functions": [ + "scheduleWeeklyFitnessSummary" + ], + "calledFrom": [ + "monitor.mjs:startProcess" + ], + "description": "Adds a weekly evaluator loop that measures delivery fitness and optionally materializes improvement actions as tasks." + } + }, + "nodes": [ + { + "id": "trigger", + "type": "trigger.schedule", + "label": "Weekly Schedule", "config": { - "expression": "$ctx.getNodeOutput('test')?.passed === true" + "intervalMs": 604800000, + "cron": "{{scheduleCron}}" }, "position": { - "x": 400, - "y": 830 + "x": 420, + "y": 40 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "should-publish", - "type": "condition.expression", - "label": "Publish To npm?", + "id": "task-metrics", + "type": "action.bosun_cli", + "label": "Collect Task Metrics", "config": { - "expression": "Boolean($data?.publishToNpm)" + "subcommand": "task list", + "args": "--json", + "parseJson": true, + "continueOnError": true }, "position": { - "x": 250, - "y": 1030 + "x": 150, + "y": 180 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "commit-tag", - "type": "action.git_operations", - "label": "Commit & Tag", + "id": "pr-metrics", + "type": "action.run_command", + "label": "Collect PR Metrics", "config": { - "operations": [ - { - "op": "add", - "paths": [ - "." - ] - }, - { - "op": "commit", - "message": "chore(release): v{{version}}" - }, - { - "op": "tag", - "name": "v{{version}}" - }, - { - "op": "push", - "includeTags": true - } - ] + "command": "gh pr list --state all --json number,state,mergedAt,closedAt,createdAt,updatedAt,title,body --limit 200", + "continueOnError": true }, "position": { - "x": 250, - "y": 960 + "x": 420, + "y": 180 }, "outputs": [ "default" ] }, { - "id": "publish-npm", + "id": "debt-metrics", "type": "action.run_command", - "label": "Publish to npm", + "label": "Collect Debt Signals", "config": { - "command": "if [ \"{{dryRun}}\" = \"true\" ]; then echo 'Dry run: skipping npm publish'; else npm publish --access public; fi", + "command": "node -e \"const fs=require('fs');const p='.bosun/workflow-runs/task-debt-ledger.jsonl';if(!fs.existsSync(p)){console.log('[]');process.exit(0);}const lines=fs.readFileSync(p,'utf8').split(/\\r?\\n/).filter(Boolean);console.log(JSON.stringify(lines.slice(-500).map(l=>{try{return JSON.parse(l)}catch{return null}}).filter(Boolean)));\"", "continueOnError": true }, "position": { - "x": 250, - "y": 1090 + "x": 690, + "y": 180 }, "outputs": [ "default" ] }, { - "id": "create-gh-release", - "type": "action.run_command", - "label": "GitHub Release", + "id": "read-previous-summary", + "type": "action.read_file", + "label": "Read Prior Summary", "config": { - "command": "gh release create v{{version}} --generate-notes --title \"v{{version}}\"", - "continueOnError": true + "path": ".bosun/workflow-runs/weekly-fitness-summary.latest.json" }, "position": { - "x": 250, - "y": 1220 + "x": 960, + "y": 180 }, "outputs": [ "default" ] }, { - "id": "notify-success", - "type": "notify.telegram", - "label": "Notify: Released", + "id": "summarize-fitness-metrics", + "type": "action.set_variable", + "label": "Summarize Fitness Metrics", "config": { - "message": ":box: **Release published!**\n\nVersion: v{{version}}\nnpm + GitHub release created." + "key": "fitnessSummary", + "value": "(() => { try { const now = Date.now(); const lookbackDays = Math.max(1, Number($data?.lookbackDays || 7)); const windowMs = lookbackDays * 24 * 60 * 60 * 1000; const currentStart = now - windowMs; const previousStart = currentStart - windowMs; const previousEnd = currentStart; const toNumber = (v, fallback = 0) => { const n = Number(v); return Number.isFinite(n) ? n : fallback; }; const toIso = (ms) => new Date(ms).toISOString(); const parseJsonSafe = (raw) => { try { return JSON.parse(String(raw)); } catch { return null; } }; const extractCanonicalItems = (value) => { if (!value || typeof value !== 'object') return null; const keys = ['items', 'tasks', 'entries', 'records', 'results', 'data']; for (const key of keys) { if (Array.isArray(value[key])) return value[key].filter(Boolean); } return null; }; const parseSource = (raw, depth = 0) => { if (depth > 3) return { items: [], degraded: true, parsedAny: false, partial: false }; if (Array.isArray(raw)) return { items: raw.filter(Boolean), degraded: false, parsedAny: raw.length > 0, partial: false }; if (raw && typeof raw === 'object') { const canonical = extractCanonicalItems(raw) ?? extractCanonicalItems(raw.output) ?? extractCanonicalItems(raw.result) ?? extractCanonicalItems(raw.payload); if (canonical) return { items: canonical, degraded: false, parsedAny: canonical.length > 0, partial: false }; const wrappedCandidates = [raw.output, raw.result, raw.payload, raw.data, raw.stdout, raw.content, raw.text, raw.json]; for (const candidate of wrappedCandidates) { if (candidate == null) continue; const parsedCandidate = parseSource(candidate, depth + 1); if (parsedCandidate.items.length > 0 || parsedCandidate.parsedAny || parsedCandidate.degraded === false) return parsedCandidate; } return { items: [], degraded: Object.keys(raw).length > 0, parsedAny: false, partial: false }; } if (typeof raw !== 'string') return { items: [], degraded: true, parsedAny: false, partial: false }; const trimmed = raw.trim(); if (!trimmed) return { items: [], degraded: false, parsedAny: false, partial: false }; const parsed = parseJsonSafe(trimmed); if (Array.isArray(parsed)) return { items: parsed.filter(Boolean), degraded: false, parsedAny: true, partial: false }; if (parsed && typeof parsed === 'object') { const canonical = extractCanonicalItems(parsed) ?? extractCanonicalItems(parsed.output) ?? extractCanonicalItems(parsed.result) ?? extractCanonicalItems(parsed.payload); if (canonical) return { items: canonical, degraded: false, parsedAny: true, partial: false }; } const lines = trimmed.split(/\\r?\\n/).filter((line) => line.trim() !== ''); const parsedLines = []; let failedLines = 0; for (const line of lines) { const parsedLine = parseJsonSafe(line); if (parsedLine == null) { failedLines += 1; continue; } if (Array.isArray(parsedLine)) parsedLines.push(...parsedLine.filter(Boolean)); else parsedLines.push(parsedLine); } if (parsedLines.length > 0) return { items: parsedLines, degraded: failedLines > 0, parsedAny: true, partial: failedLines > 0 }; return { items: [], degraded: true, parsedAny: false, partial: false }; }; const getTs = (item) => { if (!item || typeof item !== 'object') return null; const fields = ['completedAt', 'closedAt', 'mergedAt', 'resolvedAt', 'updatedAt', 'createdAt', 'timestamp', 'ts', 'date', 'completed_at', 'closed_at', 'merged_at', 'resolved_at', 'updated_at', 'created_at']; for (const key of fields) { const value = item[key]; if (!value) continue; const ms = Date.parse(String(value)); if (Number.isFinite(ms)) return ms; if (typeof value === 'number' && Number.isFinite(value)) return value > 1e12 ? value : value * 1000; } return null; }; const normalizeBucket = (items) => { const stamped = []; const unstamped = []; for (const item of items) { const ts = getTs(item); if (ts == null) unstamped.push(item); else stamped.push({ item, ts }); } return { stamped, unstamped }; }; const splitWindows = (items) => { const { stamped, unstamped } = normalizeBucket(items); const current = stamped.filter((entry) => entry.ts >= currentStart && entry.ts <= now).map((entry) => entry.item); const previous = stamped.filter((entry) => entry.ts >= previousStart && entry.ts < previousEnd).map((entry) => entry.item); const usedFallbackWindow = stamped.length === 0 && unstamped.length > 0; if (usedFallbackWindow) return { current: unstamped, previous: [], usedFallbackWindow }; return { current, previous, usedFallbackWindow }; }; const metric = (name, value, previous, direction, unit, confidence, status, notes = []) => { const hasCurrent = typeof value === 'number' && Number.isFinite(value); const hasPrevious = typeof previous === 'number' && Number.isFinite(previous); return { name, value: hasCurrent ? value : null, previous: hasPrevious ? previous : null, delta: hasCurrent && hasPrevious ? Number((value - previous).toFixed(2)) : null, direction, unit, confidence, status, notes: notes.filter(Boolean), }; }; const sourceStatus = (nodeOut, parsedList, parsedMeta = {}) => { const output = nodeOut?.output; const hasPayload = (() => { if (output == null) return false; if (Array.isArray(output)) return true; if (typeof output === 'string') return output.trim() !== ''; if (typeof output === 'object') { const wrapped = [output.stdout, output.content, output.text, output.json, output.output, output.result, output.payload, output.data]; if (wrapped.some((v) => (typeof v === 'string' ? v.trim() !== '' : v != null))) return true; return Object.keys(output).length > 0; } return true; })(); const success = nodeOut?.success !== false; if (!hasPayload) return { status: 'missing', confidence: 'low' }; if (!Array.isArray(parsedList)) return { status: 'degraded', confidence: 'low' }; if (parsedMeta?.degraded || parsedMeta?.partial) return { status: 'degraded', confidence: parsedList.length > 0 ? 'medium' : 'low' }; if (!success) return { status: 'degraded', confidence: parsedList.length > 0 ? 'medium' : 'low' }; return { status: 'ok', confidence: parsedList.length > 0 ? 'high' : 'medium' }; }; const taskNode = $ctx.getNodeOutput('task-metrics') || {}; const prNode = $ctx.getNodeOutput('pr-metrics') || {}; const debtNode = $ctx.getNodeOutput('debt-metrics') || {}; const prevNode = $ctx.getNodeOutput('read-previous-summary') || {}; const taskParsed = parseSource(taskNode.output); const prParsed = parseSource(prNode.output); const debtParsed = parseSource(debtNode.output); const tasks = taskParsed.items; const prs = prParsed.items; const debt = debtParsed.items; const taskHealth = sourceStatus(taskNode, tasks, taskParsed); const prHealth = sourceStatus(prNode, prs, prParsed); const debtHealth = sourceStatus(debtNode, debt, debtParsed); const taskSplit = splitWindows(tasks); const prSplit = splitWindows(prs); const debtSplit = splitWindows(debt); const doneStatuses = new Set(['done', 'closed', 'completed', 'merged', 'resolved']); const isDone = (item) => doneStatuses.has(String(item?.status ?? item?.state ?? '').toLowerCase()); const taskTelemetryUnavailable = taskHealth.status === 'missing' || (taskHealth.status === 'degraded' && tasks.length === 0); const throughputCurrent = taskTelemetryUnavailable ? null : taskSplit.current.filter(isDone).length; const throughputPrevious = taskTelemetryUnavailable ? null : taskSplit.previous.filter(isDone).length; const reopenedCount = (items) => items.filter((item) => { if (!item || typeof item !== 'object') return false; const reopenCount = toNumber(item.reopenCount ?? item.reopenedCount ?? item.reopen_count ?? item.reopened_count, 0); if (reopenCount > 0) return true; if (item.reopened === true) return true; const status = String(item.status ?? item.state ?? '').toLowerCase(); return status.includes('reopen'); }).length; const reopenedCurrent = taskTelemetryUnavailable ? null : reopenedCount(taskSplit.current); const reopenedPrevious = taskTelemetryUnavailable ? null : reopenedCount(taskSplit.previous); const classifyRegression = (pr) => /revert|regression|rollback|hotfix/i.test(String(pr?.title || '') + ' ' + String(pr?.body || '')); const regressionCurrentCount = prSplit.current.filter(classifyRegression).length; const regressionPreviousCount = prSplit.previous.filter(classifyRegression).length; const regressionCurrentRate = prSplit.current.length > 0 ? Number(((regressionCurrentCount / prSplit.current.length) * 100).toFixed(2)) : null; const regressionPreviousRate = prSplit.previous.length > 0 ? Number(((regressionPreviousCount / prSplit.previous.length) * 100).toFixed(2)) : null; const mergedCount = (items) => items.filter((pr) => String(pr?.state || '').toLowerCase() === 'merged' || Boolean(pr?.mergedAt) || Boolean(pr?.merged_at) || pr?.merged === true).length; const closedCount = (items) => items.filter((pr) => { const state = String(pr?.state || '').toLowerCase(); return state === 'closed' || state === 'merged' || Boolean(pr?.closedAt) || Boolean(pr?.closed_at) || Boolean(pr?.mergedAt) || Boolean(pr?.merged_at); }).length; const mergeClosedCurrent = closedCount(prSplit.current); const mergeClosedPrevious = closedCount(prSplit.previous); const mergeSuccessCurrent = mergeClosedCurrent > 0 ? Number(((mergedCount(prSplit.current) / mergeClosedCurrent) * 100).toFixed(2)) : null; const mergeSuccessPrevious = mergeClosedPrevious > 0 ? Number(((mergedCount(prSplit.previous) / mergeClosedPrevious) * 100).toFixed(2)) : null; const debtDelta = (entries) => { let total = 0; for (const entry of entries) { if (entry == null) continue; if (typeof entry === 'number') { total += entry; continue; } if (typeof entry !== 'object') continue; if (Number.isFinite(Number(entry.debtDelta))) { total += Number(entry.debtDelta); continue; } if (Number.isFinite(Number(entry.delta))) { total += Number(entry.delta); continue; } if (Number.isFinite(Number(entry.netChange))) { total += Number(entry.netChange); continue; } const amt = Number.isFinite(Number(entry.amount)) ? Number(entry.amount) : 1; const kind = String(entry.type || entry.event || entry.action || '').toLowerCase(); if (/resolved|burn|paydown|decrease|closed/.test(kind)) total -= amt; else if (/created|added|increase|opened|new/.test(kind)) total += amt; } return Number(total.toFixed(2)); }; const debtCurrent = debtSplit.current.length > 0 ? debtDelta(debtSplit.current) : null; const debtPrevious = debtSplit.previous.length > 0 ? debtDelta(debtSplit.previous) : null; const priorRaw = prevNode?.success === true ? (parseSource(prevNode.content).items?.[0] ?? parseJsonSafe(prevNode.content)) : null; const priorParsed = priorRaw?.fitnessSummary && typeof priorRaw.fitnessSummary === 'object' ? priorRaw.fitnessSummary : (priorRaw && typeof priorRaw === 'object' ? priorRaw : null); const metricConfidence = (primaryHealth, hasValue, usedFallbackWindow) => { if (!hasValue) return 'low'; if (primaryHealth.status === 'missing') return 'low'; if (primaryHealth.status === 'degraded') return 'low'; if (usedFallbackWindow) return 'medium'; return primaryHealth.confidence || 'medium'; }; const throughputMetric = metric('throughput', throughputCurrent, throughputPrevious, 'up_is_good', 'tasks', metricConfidence(taskHealth, throughputCurrent != null, taskSplit.usedFallbackWindow), taskHealth.status, [throughputCurrent == null ? 'Task telemetry unavailable for this window.' : '', taskSplit.usedFallbackWindow ? 'No task timestamps detected; treated all records as current week.' : '']); const regressionMetric = metric('regression_rate', regressionCurrentRate, regressionPreviousRate, 'down_is_good', 'percent', metricConfidence(prHealth, regressionCurrentRate != null, prSplit.usedFallbackWindow), prHealth.status, [regressionCurrentRate == null ? 'Insufficient PR sample to compute regression rate.' : '', prSplit.usedFallbackWindow ? 'No PR timestamps detected; treated all records as current week.' : '']); const mergeMetric = metric('merge_success', mergeSuccessCurrent, mergeSuccessPrevious, 'up_is_good', 'percent', metricConfidence(prHealth, mergeSuccessCurrent != null, prSplit.usedFallbackWindow), prHealth.status, [mergeSuccessCurrent == null ? 'No closed or merged PRs in scope.' : '', prSplit.usedFallbackWindow ? 'No PR timestamps detected; treated all records as current week.' : '']); const reopenedMetric = metric('reopened_tasks', reopenedCurrent, reopenedPrevious, 'down_is_good', 'tasks', metricConfidence(taskHealth, reopenedCurrent != null, taskSplit.usedFallbackWindow), taskHealth.status, [reopenedCurrent == null ? 'Task telemetry unavailable for this window.' : '', taskSplit.usedFallbackWindow ? 'No task timestamps detected; treated all records as current week.' : '']); const debtMetric = metric('debt_growth', debtCurrent, debtPrevious, 'down_is_good', 'points', metricConfidence(debtHealth, debtCurrent != null, debtSplit.usedFallbackWindow), debtHealth.status, [debtCurrent == null ? 'No debt ledger events in scope.' : '', debtSplit.usedFallbackWindow ? 'No debt timestamps detected; treated all records as current week.' : '']); const metrics = { throughput: throughputMetric, regression_rate: regressionMetric, merge_success: mergeMetric, reopened_tasks: reopenedMetric, debt_growth: debtMetric }; const metricKeys = ['throughput', 'regression_rate', 'merge_success', 'reopened_tasks', 'debt_growth']; const trendDeltas = metricKeys.reduce((acc, key) => { const d = metrics?.[key]?.delta; acc[key] = Number.isFinite(d) ? d : null; return acc; }, {}); const normalizePriorTrendDelta = (metricName) => { const direct = priorParsed?.priorWeekTrendDeltas?.[metricName]; if (Number.isFinite(Number(direct))) return Number(Number(direct).toFixed(2)); const trend = priorParsed?.trendDeltas?.[metricName]; if (Number.isFinite(Number(trend))) return Number(Number(trend).toFixed(2)); const metricDelta = priorParsed?.metrics?.[metricName]?.delta; if (Number.isFinite(Number(metricDelta))) return Number(Number(metricDelta).toFixed(2)); return null; }; const priorWeekTrendDeltas = metricKeys.reduce((acc, key) => { acc[key] = normalizePriorTrendDelta(key); return acc; }, {}); const priorWeekDeltas = priorWeekTrendDeltas; const priorWeekMetrics = priorParsed?.metrics && typeof priorParsed.metrics === 'object' ? priorParsed.metrics : null; const alertThresholds = { throughput: 1, regression_rate: 2.5, merge_success: 2.5, reopened_tasks: 1, debt_growth: 1 }; const metricTrendAlerts = Object.entries(metrics).flatMap(([metricName, m]) => { if (m == null || m.delta == null) return []; if (String(m.confidence || '').toLowerCase() === 'low') return []; const delta = Number(m.delta); const isRegression = (m.direction === 'up_is_good' && delta < 0) || (m.direction === 'down_is_good' && delta > 0); if (!isRegression) return []; const absDelta = Math.abs(delta); const threshold = alertThresholds[metricName] ?? 1; const severity = absDelta >= threshold * 2 ? 'high' : absDelta >= threshold ? 'medium' : 'low'; return [{ metric: metricName, severity, delta, reason: `${metricName} moved in a negative direction by ${delta} ${m.unit}.` }]; }); const sourceHealth = { tasks: { ...taskHealth, count: tasks.length }, prs: { ...prHealth, count: prs.length }, debt: { ...debtHealth, count: debt.length }, }; const sourceTelemetryAlerts = Object.entries(sourceHealth).flatMap(([sourceName, health]) => { if (health?.status === 'ok') return []; const severity = health?.status === 'missing' ? 'high' : 'medium'; const reason = health?.status === 'missing' ? `${sourceName} telemetry missing; metric interpretation may be limited.` : `${sourceName} telemetry partially parsed; confidence reduced.`; return [{ metric: `telemetry:${sourceName}`, severity, delta: null, reason }]; }); const trendAlerts = [...metricTrendAlerts, ...sourceTelemetryAlerts]; const confidenceValues = Object.values(metrics).map((m) => m?.confidence || 'low'); const overallConfidence = confidenceValues.every((c) => c === 'high') ? 'high' : confidenceValues.some((c) => c === 'low') ? 'low' : 'medium'; const plannerSignals = { schemaVersion: '1.0', overallConfidence, trendAlertCount: trendAlerts.length, highSeverityAlertCount: trendAlerts.filter((a) => a?.severity === 'high').length, sourceStatus: Object.fromEntries(Object.entries(sourceHealth).map(([k, v]) => [k, v?.status || 'missing'])), metricStatus: Object.fromEntries(metricKeys.map((k) => [k, metrics?.[k]?.status || 'missing'])), metricConfidence: Object.fromEntries(metricKeys.map((k) => [k, metrics?.[k]?.confidence || 'low'])), metricValues: Object.fromEntries(metricKeys.map((k) => [k, Number.isFinite(metrics?.[k]?.value) ? Number(metrics[k].value) : null])), trendDeltas, priorWeekTrendDeltas, }; const plannerArtifact = { schemaVersion: '1.0', generatedAt: toIso(now), lookbackDays, sourceStatus: plannerSignals.sourceStatus, metricConfidence: plannerSignals.metricConfidence, metricValues: plannerSignals.metricValues, trendDeltas, priorWeekTrendDeltas, trendAlertCount: plannerSignals.trendAlertCount, highSeverityAlertCount: plannerSignals.highSeverityAlertCount, trendAlerts, }; return { schemaVersion: '1.0', generatedAt: toIso(now), lookbackDays, window: { currentStart: toIso(currentStart), currentEnd: toIso(now), previousStart: toIso(previousStart), previousEnd: toIso(previousEnd) }, sourceHealth, metrics, trendDeltas, trendAlerts, priorWeekTrendDeltas, priorWeekDeltas, priorWeekMetrics, plannerSignals, plannerArtifact, dataQuality: { overallConfidence, missingSources: Object.entries(sourceHealth).filter(([, v]) => v.status === 'missing').map(([k]) => k), degradedSources: Object.entries(sourceHealth).filter(([, v]) => v.status === 'degraded').map(([k]) => k), }, }; } catch (error) { return { schemaVersion: '1.0', generatedAt: new Date().toISOString(), lookbackDays: Number($data?.lookbackDays || 7), sourceHealth: { tasks: { status: 'missing', confidence: 'low', count: 0 }, prs: { status: 'missing', confidence: 'low', count: 0 }, debt: { status: 'missing', confidence: 'low', count: 0 }, }, metrics: { throughput: { value: null, previous: null, delta: null, confidence: 'low', status: 'missing' }, regression_rate: { value: null, previous: null, delta: null, confidence: 'low', status: 'missing' }, merge_success: { value: null, previous: null, delta: null, confidence: 'low', status: 'missing' }, reopened_tasks: { value: null, previous: null, delta: null, confidence: 'low', status: 'missing' }, debt_growth: { value: null, previous: null, delta: null, confidence: 'low', status: 'missing' }, }, trendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, trendAlerts: [{ metric: 'summary', severity: 'high', delta: null, reason: `Fitness summary fallback engaged: ${error?.message || 'unknown error'}` }], priorWeekTrendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, priorWeekDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, priorWeekMetrics: null, plannerSignals: { schemaVersion: '1.0', overallConfidence: 'low', trendAlertCount: 1, highSeverityAlertCount: 1, sourceStatus: { tasks: 'missing', prs: 'missing', debt: 'missing' }, metricStatus: { throughput: 'missing', regression_rate: 'missing', merge_success: 'missing', reopened_tasks: 'missing', debt_growth: 'missing' }, metricConfidence: { throughput: 'low', regression_rate: 'low', merge_success: 'low', reopened_tasks: 'low', debt_growth: 'low' }, metricValues: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, trendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, priorWeekTrendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, }, plannerArtifact: { schemaVersion: '1.0', generatedAt: new Date().toISOString(), lookbackDays: Number($data?.lookbackDays || 7), sourceStatus: { tasks: 'missing', prs: 'missing', debt: 'missing' }, metricConfidence: { throughput: 'low', regression_rate: 'low', merge_success: 'low', reopened_tasks: 'low', debt_growth: 'low' }, metricValues: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, trendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, priorWeekTrendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, trendAlertCount: 1, highSeverityAlertCount: 1, trendAlerts: [{ metric: 'summary', severity: 'high', delta: null, reason: `Fitness summary fallback engaged: ${error?.message || 'unknown error'}` }], }, dataQuality: { overallConfidence: 'low', missingSources: ['tasks', 'prs', 'debt'], degradedSources: [] }, }; }})()", + "isExpression": true }, "position": { - "x": 250, - "y": 1350 + "x": 420, + "y": 360 }, "outputs": [ "default" ] }, { - "id": "notify-failure", - "type": "notify.telegram", - "label": "Notify: Release Failed", + "id": "serialize-fitness-summary", + "type": "action.set_variable", + "label": "Serialize Fitness Summary", "config": { - "message": ":close: **Release pipeline failed** at test stage.\n\nVersion bump was {{bumpType}} but tests did not pass. Manual intervention required." + "key": "fitnessSummaryJson", + "value": "(() => JSON.stringify($data?.fitnessSummary || {}, null, 2))()", + "isExpression": true }, "position": { - "x": 600, - "y": 960 + "x": 420, + "y": 500 }, "outputs": [ "default" ] - } - ], - "edges": [ + }, { - "id": "trigger->bump-version", - "source": "trigger", - "target": "bump-version", - "sourcePort": "default" + "id": "render-trend-alerts", + "type": "action.set_variable", + "label": "Render Trend Alerts", + "config": { + "key": "fitnessTrendAlertsText", + "value": "(() => { const alerts = Array.isArray($data?.fitnessSummary?.trendAlerts) ? $data.fitnessSummary.trendAlerts : []; if (!alerts.length) return 'No negative trend alerts this week.'; return alerts.map((a, idx) => `${idx + 1}. ${a.metric} (${a.severity}) - ${a.reason}`).join('\\n'); })()", + "isExpression": true + }, + "position": { + "x": 420, + "y": 640 + }, + "outputs": [ + "default" + ] }, { - "id": "bump-version->read-version", - "source": "bump-version", - "target": "read-version", - "sourcePort": "default" - }, - { - "id": "read-version->set-version", - "source": "read-version", - "target": "set-version", - "sourcePort": "default" - }, - { - "id": "set-version->generate-changelog", - "source": "set-version", - "target": "generate-changelog", - "sourcePort": "default" - }, - { - "id": "generate-changelog->build", - "source": "generate-changelog", - "target": "build", - "sourcePort": "default" - }, - { - "id": "build->test", - "source": "build", - "target": "test", - "sourcePort": "default" - }, - { - "id": "test->test-passed", - "source": "test", - "target": "test-passed", - "sourcePort": "default" - }, - { - "id": "test-passed->commit-tag", - "source": "test-passed", - "target": "commit-tag", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "test-passed->notify-failure", - "source": "test-passed", - "target": "notify-failure", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "commit-tag->should-publish", - "source": "commit-tag", - "target": "should-publish", - "sourcePort": "default" - }, - { - "id": "should-publish->publish-npm", - "source": "should-publish", - "target": "publish-npm", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "should-publish->create-gh-release", - "source": "should-publish", - "target": "create-gh-release", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "publish-npm->create-gh-release", - "source": "publish-npm", - "target": "create-gh-release", - "sourcePort": "default" + "id": "persist-fitness-summary", + "type": "action.write_file", + "label": "Persist Fitness Summary Artifact", + "config": { + "path": ".bosun/workflow-runs/weekly-fitness-summary.latest.json", + "content": "{{fitnessSummaryJson}}", + "mkdir": true + }, + "position": { + "x": 420, + "y": 780 + }, + "outputs": [ + "default" + ] }, { - "id": "create-gh-release->notify-success", - "source": "create-gh-release", - "target": "notify-success", - "sourcePort": "default" - } - ] - }, - { - "id": "template-nightly-report", - "name": "Nightly Report", - "description": "Generates a daily summary of agent activity: tasks completed, PRs merged, errors encountered, and token usage. Sends to Telegram.", - "category": "planning", - "categoryLabel": "Planning", - "categoryIcon": ":clipboard:", - "categoryOrder": 4, - "tags": [ - "report", - "daily", - "telegram", - "analytics" - ], - "nodeCount": 6, - "edgeCount": 7, - "recommended": false, - "enabled": false, - "trigger": "trigger.schedule", - "variables": { - "reportHour": 23, - "reportTimezone": "UTC" - }, - "metadata": { - "author": "bosun", - "version": 1, - "createdAt": "2025-02-25T00:00:00Z", - "templateVersion": "1.0.0", - "tags": [ - "report", - "daily", - "telegram", - "analytics" - ], - "replaces": { - "module": "telegram-sentinel.mjs", - "functions": [ - "dailyDigest", - "sendStatusReport" - ], - "calledFrom": [ - "monitor.mjs:startSentinelBridge" - ], - "description": "Replaces ad-hoc Telegram status reporting with a scheduled nightly report workflow. Stats gathering runs in parallel, then an agent generates a formatted summary." - } - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.schedule", - "label": "Nightly at 11pm", + "id": "evaluate-fitness", + "type": "action.run_agent", + "label": "Evaluate Fitness", "config": { - "intervalMs": 86400000, - "cron": "0 {{reportHour}} * * *" + "prompt": "# Weekly Delivery Fitness Evaluation\n\nEvaluate the last {{lookbackDays}} days using this machine-readable summary:\n\nMetrics to evaluate:\n- Throughput\n- Regression rate\n- Merge success\n- Reopened tasks\n- Debt growth\n\n## Weekly Fitness JSON\n{{fitnessSummaryJson}}\n\n## Negative Trend Alerts\n{{fitnessTrendAlertsText}}\n\nFocus directive: {{evaluatorFocus}}\n\nRequirements:\n- Respect confidence and status on each metric.\n- If a metric has low confidence or missing telemetry, call that out explicitly and avoid overconfident recommendations.\n- Use prior-week deltas when available.\n- If one telemetry source is unavailable, still provide a stable scorecard and best-effort recommendations.\n\nReturn sections:\n1) Scorecard (0-100) with one line per metric and confidence\n2) Root-cause analysis of the largest drag\n3) Countermeasures ranked by impact/cost\n4) FOLLOW_UP_ACTION lines using format:\nFOLLOW_UP_ACTION: [title] | [description] | [repo_area] | [risk] | [effort]\n\nOnly include FOLLOW_UP_ACTION lines for changes that are worth implementing this week.", + "sdk": "auto", + "timeoutMs": 600000 }, "position": { - "x": 400, - "y": 50 + "x": 420, + "y": 930 }, "outputs": [ "default" ] }, { - "id": "get-task-stats", - "type": "action.run_command", - "label": "Get Task Stats", + "id": "has-followups", + "type": "condition.expression", + "label": "Follow-ups Enabled + Present", "config": { - "command": "bosun task stats --json", - "continueOnError": true + "expression": "($data?.createFollowupTasks === true) && (($ctx.getNodeOutput('evaluate-fitness')?.output || '').includes('FOLLOW_UP_ACTION:'))" }, "position": { - "x": 150, - "y": 200 + "x": 420, + "y": 1090 }, "outputs": [ "default" ] }, { - "id": "get-pr-stats", - "type": "action.run_command", - "label": "Get PR Stats", + "id": "build-followup-json", + "type": "action.run_agent", + "label": "Build Follow-up Tasks JSON", "config": { - "command": "gh pr list --state all --json number,state,mergedAt --limit 50", - "continueOnError": true + "prompt": "Convert FOLLOW_UP_ACTION lines below into a single JSON object with shape { \"tasks\": [...] }.\n\nSource:\n{{evaluate-fitness.output}}\n\nStructured context:\n{{fitnessSummaryJson}}\n\nRules:\n- Generate at most {{maxFollowupTasks}} tasks\n- Include fields: title, description, implementation_steps, acceptance_criteria, verification, priority, tags, base_branch, impact, confidence, risk, estimated_effort, repo_areas, why_now, kill_criteria\n- Use trend deltas from the summary artifact to justify urgency and avoid parse errors\n- Keep tasks implementation-ready and avoid duplicates\n- Return only JSON", + "sdk": "auto", + "timeoutMs": 300000 }, "position": { - "x": 400, - "y": 200 + "x": 220, + "y": 1260 }, "outputs": [ "default" ] }, { - "id": "get-agent-stats", - "type": "action.run_command", - "label": "Get Agent Stats", + "id": "materialize-followups", + "type": "action.materialize_planner_tasks", + "label": "Materialize Follow-up Tasks", "config": { - "command": "bosun agent stats --json 2>/dev/null || echo '{}'", - "continueOnError": true + "plannerNodeId": "build-followup-json", + "maxTasks": "{{maxFollowupTasks}}", + "status": "todo", + "dedup": true, + "failOnZero": false, + "minCreated": 0 }, "position": { - "x": 650, - "y": 200 + "x": 220, + "y": 1420 }, "outputs": [ "default" ] }, { - "id": "generate-report", - "type": "action.run_agent", - "label": "Generate Report", + "id": "notify-summary", + "type": "notify.telegram", + "label": "Send Weekly Fitness Summary", "config": { - "prompt": "Generate a concise daily activity report from the following data.\n\n## Task Stats\n{{taskStats}}\n\n## PR Activity\n{{prStats}}\n\n## Agent Activity\n{{agentStats}}\n\nFormat as a Telegram-friendly message with emoji headers. Include:\n- Tasks completed today vs yesterday\n- PRs merged / opened / closed\n- Agent success rate\n- Notable errors or anomalies\n- Recommendations for tomorrow", - "timeoutMs": 300000 + "message": ":chart: Weekly fitness evaluation complete. Follow-up tasks created: {{materialize-followups.createdCount}}\\n\\nTrend alerts:\\n{{fitnessTrendAlertsText}}\\n\\n{{evaluate-fitness.output}}", + "silent": true }, "position": { - "x": 400, - "y": 380 + "x": 420, + "y": 1580 }, "outputs": [ "default" ] }, { - "id": "send-report", - "type": "notify.telegram", - "label": "Send Report", + "id": "log-no-followups", + "type": "notify.log", + "label": "No Follow-up Tasks", "config": { - "message": ":chart: **Daily Bosun Report** ({{reportTimezone}})\n\n{{reportOutput}}" + "message": "Weekly fitness evaluation completed with no follow-up task creation.", + "level": "info" }, "position": { - "x": 400, - "y": 540 + "x": 620, + "y": 1260 }, "outputs": [ "default" @@ -8570,105 +7960,174 @@ ], "edges": [ { - "id": "trigger->get-task-stats", + "id": "trigger->task-metrics", "source": "trigger", - "target": "get-task-stats", + "target": "task-metrics", "sourcePort": "default" }, { - "id": "trigger->get-pr-stats", + "id": "trigger->pr-metrics", "source": "trigger", - "target": "get-pr-stats", + "target": "pr-metrics", "sourcePort": "default" }, { - "id": "trigger->get-agent-stats", + "id": "trigger->debt-metrics", "source": "trigger", - "target": "get-agent-stats", + "target": "debt-metrics", "sourcePort": "default" }, { - "id": "get-task-stats->generate-report", - "source": "get-task-stats", - "target": "generate-report", + "id": "trigger->read-previous-summary", + "source": "trigger", + "target": "read-previous-summary", "sourcePort": "default" }, { - "id": "get-pr-stats->generate-report", - "source": "get-pr-stats", - "target": "generate-report", + "id": "task-metrics->summarize-fitness-metrics", + "source": "task-metrics", + "target": "summarize-fitness-metrics", "sourcePort": "default" }, { - "id": "get-agent-stats->generate-report", - "source": "get-agent-stats", - "target": "generate-report", + "id": "pr-metrics->summarize-fitness-metrics", + "source": "pr-metrics", + "target": "summarize-fitness-metrics", "sourcePort": "default" }, { - "id": "generate-report->send-report", - "source": "generate-report", - "target": "send-report", + "id": "debt-metrics->summarize-fitness-metrics", + "source": "debt-metrics", + "target": "summarize-fitness-metrics", + "sourcePort": "default" + }, + { + "id": "read-previous-summary->summarize-fitness-metrics", + "source": "read-previous-summary", + "target": "summarize-fitness-metrics", + "sourcePort": "default" + }, + { + "id": "summarize-fitness-metrics->serialize-fitness-summary", + "source": "summarize-fitness-metrics", + "target": "serialize-fitness-summary", + "sourcePort": "default" + }, + { + "id": "serialize-fitness-summary->render-trend-alerts", + "source": "serialize-fitness-summary", + "target": "render-trend-alerts", + "sourcePort": "default" + }, + { + "id": "render-trend-alerts->persist-fitness-summary", + "source": "render-trend-alerts", + "target": "persist-fitness-summary", + "sourcePort": "default" + }, + { + "id": "persist-fitness-summary->evaluate-fitness", + "source": "persist-fitness-summary", + "target": "evaluate-fitness", + "sourcePort": "default" + }, + { + "id": "evaluate-fitness->has-followups", + "source": "evaluate-fitness", + "target": "has-followups", + "sourcePort": "default" + }, + { + "id": "has-followups->build-followup-json", + "source": "has-followups", + "target": "build-followup-json", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "has-followups->log-no-followups", + "source": "has-followups", + "target": "log-no-followups", + "sourcePort": "default", + "condition": "$output?.result !== true" + }, + { + "id": "build-followup-json->materialize-followups", + "source": "build-followup-json", + "target": "materialize-followups", + "sourcePort": "default" + }, + { + "id": "materialize-followups->notify-summary", + "source": "materialize-followups", + "target": "notify-summary", + "sourcePort": "default" + }, + { + "id": "log-no-followups->notify-summary", + "source": "log-no-followups", + "target": "notify-summary", "sourcePort": "default" } ] }, { - "id": "template-sprint-retrospective", - "name": "Sprint Retrospective", - "description": "Weekly automated retrospective: gathers metrics on tasks completed, PRs merged, agent success rates, and common failure patterns. Generates improvement suggestions and creates action item tasks.", - "category": "planning", - "categoryLabel": "Planning", - "categoryIcon": ":clipboard:", - "categoryOrder": 4, + "id": "template-anomaly-watchdog", + "name": "Anomaly Watchdog", + "description": "Real-time anomaly detection for agent sessions — catches death loops, stalls, token overflows, rebase spirals, and thought spinning. Automatically intervenes or escalates depending on severity.", + "category": "reliability", + "categoryLabel": "Reliability", + "categoryIcon": ":shield:", + "categoryOrder": 5, "tags": [ - "planning", - "retrospective", - "metrics", - "improvement", - "weekly" + "anomaly", + "watchdog", + "death-loop", + "stall", + "reliability" ], - "nodeCount": 10, - "edgeCount": 11, - "recommended": false, + "nodeCount": 9, + "edgeCount": 12, + "recommended": true, "enabled": true, - "trigger": "trigger.schedule", + "trigger": "trigger.event", "variables": { - "lookbackDays": 7, - "lookbackWindowMs": 604800000, - "createImprovementTasks": true + "stallThresholdMs": 300000, + "maxTokenUsage": 0.9, + "maxConsecutiveErrors": 5 }, "metadata": { "author": "bosun", "version": 1, "createdAt": "2025-02-25T00:00:00Z", - "templateVersion": "1.0.0", + "templateVersion": "1.0.1", "tags": [ - "planning", - "retrospective", - "metrics", - "improvement", - "weekly" + "anomaly", + "watchdog", + "death-loop", + "stall", + "reliability" ], "replaces": { - "module": "telegram-sentinel.mjs", + "module": "anomaly-detector.mjs", "functions": [ - "weeklyDigest" + "AnomalyDetector.processLine", + "onAnomaly callback" ], "calledFrom": [ - "monitor.mjs:scheduleWeeklyDigest" + "monitor.mjs:startAgentAlertTailer" ], - "description": "Replaces simple weekly digest with a comprehensive retrospective workflow. Metrics gathering, AI analysis, action item creation, and reporting are structured as workflow stages." + "description": "Replaces hardcoded anomaly detection responses with a visual workflow. Each anomaly type (death loop, stall, token overflow, rebase spiral, thought spin) routes to a specific intervention node." } }, "nodes": [ { "id": "trigger", - "type": "trigger.schedule", - "label": "Weekly Retro", + "type": "trigger.event", + "label": "Agent Anomaly Detected", "config": { - "intervalMs": 604800000, - "cron": "0 9 * * 1" + "eventType": "agent.anomaly", + "filter": "$event?.severity === 'high' || $event?.severity === 'critical'" }, "position": { "x": 400, @@ -8679,145 +8138,142 @@ ] }, { - "id": "task-metrics", - "type": "action.bosun_cli", - "label": "Gather Task Metrics", + "id": "classify", + "type": "condition.switch", + "label": "Classify Anomaly", "config": { - "command": "task list --format json --since {{lookbackDays}}d", - "continueOnError": true + "value": "$data?.anomalyType || 'unknown'", + "cases": { + "DEATH_LOOP": "death-loop", + "STALL": "stall", + "TOKEN_OVERFLOW": "token-overflow", + "REBASE_SPIRAL": "rebase-spiral", + "THOUGHT_SPIN": "thought-spin" + } }, "position": { - "x": 200, + "x": 400, "y": 200 }, "outputs": [ + "death-loop", + "stall", + "token-overflow", + "rebase-spiral", + "thought-spin", "default" ] }, { - "id": "pr-metrics", - "type": "action.run_command", - "label": "Gather PR Metrics", + "id": "kill-and-restart", + "type": "action.restart_agent", + "label": "Kill & Restart Agent", "config": { - "command": "gh pr list --state all --json number,title,state,createdAt,mergedAt,closedAt --limit 50", - "continueOnError": true + "sessionId": "{{sessionId}}", + "reason": "Death loop detected — agent cycling through the same error pattern", + "prompt": "The previous session entered a death loop. Start fresh with a different approach.\n\nOriginal task: {{taskTitle}}" }, "position": { - "x": 600, - "y": 200 + "x": 100, + "y": 380 }, "outputs": [ "default" ] }, { - "id": "error-analysis", - "type": "action.analyze_errors", - "label": "Analyze Error Patterns", + "id": "nudge-stall", + "type": "action.continue_session", + "label": "Nudge Stalled Agent", "config": { - "timeWindowMs": "{{lookbackWindowMs}}", - "groupBy": "category" + "sessionId": "{{sessionId}}", + "prompt": "You appear to be stalled. Please continue working on the current task. If you are stuck, describe the blocker and try a different approach.", + "strategy": "continue" }, "position": { - "x": 200, - "y": 350 + "x": 300, + "y": 380 }, "outputs": [ "default" ] }, { - "id": "agent-stats", - "type": "action.bosun_cli", - "label": "Agent Performance", + "id": "trim-context", + "type": "action.continue_session", + "label": "Trim Context & Continue", "config": { - "command": "status --json", - "continueOnError": true + "sessionId": "{{sessionId}}", + "prompt": "Your context window is nearly full. Summarize your progress so far in 2-3 sentences, then continue with the most critical remaining work.", + "strategy": "refine" }, "position": { - "x": 600, - "y": 350 + "x": 500, + "y": 380 }, "outputs": [ "default" ] }, { - "id": "generate-retro", - "type": "action.run_agent", - "label": "Generate Retrospective", + "id": "fix-rebase", + "type": "action.run_command", + "label": "Fix Stuck Rebase", "config": { - "prompt": "# Sprint Retrospective Analysis\n\nAnalyze the following data from the past {{lookbackDays}} days:\n\n## Task Metrics\n{{taskMetrics}}\n\n## PR Metrics\n{{prMetrics}}\n\n## Error Patterns\n{{errorAnalysis}}\n\n## Agent Performance\n{{agentStats}}\n\nGenerate a retrospective report with these sections:\n\n### :chart: Key Metrics\n- Tasks completed vs created\n- Average task cycle time\n- PR merge rate and average review time\n- Agent success rate\n\n### :check: What Went Well\n- Highlight successful patterns and wins\n\n### :close: What Didn't Go Well\n- Identify bottlenecks and recurring issues\n\n### :target: Action Items\nFor each improvement suggestion, output a line:\nACTION: [title] | [description]\n\nBe specific and actionable. Limit to 3-5 improvement items.", - "sdk": "auto", - "timeoutMs": 600000 + "command": "git rebase --abort 2>/dev/null; git reset --hard HEAD; git checkout -B {{branch}} origin/{{branch}} 2>/dev/null || true", + "cwd": "{{worktreePath}}" }, "position": { - "x": 400, - "y": 520 + "x": 700, + "y": 380 }, "outputs": [ "default" ] }, { - "id": "has-actions", - "type": "condition.expression", - "label": "Has Action Items?", + "id": "break-spin", + "type": "action.continue_session", + "label": "Break Thought Spin", "config": { - "expression": "($ctx.getNodeOutput('generate-retro')?.output || '').includes('ACTION:')" + "sessionId": "{{sessionId}}", + "prompt": "Stop your current analysis. You are repeating the same reasoning. Take a concrete action NOW:\n1. Make a specific code change, OR\n2. Run a specific command, OR\n3. Report that you are blocked and need help.\nDo NOT continue analyzing.", + "strategy": "continue" }, "position": { - "x": 400, - "y": 680 + "x": 900, + "y": 380 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "create-tasks", - "type": "action.run_agent", - "label": "Create Improvement Tasks", + "id": "log-intervention", + "type": "notify.log", + "label": "Log Intervention", "config": { - "prompt": "# Create Improvement Tasks\n\nFrom the retrospective output, extract all lines starting with ACTION:\nand create a bosun task for each one.\n\nUse the CLI: bosun task create --title \"[title]\" --description \"[description]\" --tag improvement --tag retro\n\nOnly create tasks if {{createImprovementTasks}} is true.", - "sdk": "auto", - "timeoutMs": 300000 - }, - "position": { - "x": 250, - "y": 830 - }, - "outputs": [ - "default" - ] - }, - { - "id": "send-report", - "type": "notify.telegram", - "label": "Send Retro Report", - "config": { - "message": ":clipboard: **Weekly Retrospective** (past {{lookbackDays}} days)\n\n{{retroOutput}}" + "message": "Anomaly watchdog intervened: {{anomalyType}} for session {{sessionId}}", + "level": "warn" }, "position": { "x": 400, - "y": 980 + "y": 550 }, "outputs": [ "default" ] }, { - "id": "log-no-actions", - "type": "notify.log", - "label": "No Actions Needed", + "id": "alert-telegram", + "type": "notify.telegram", + "label": "Alert Human", "config": { - "message": "Sprint retrospective complete — no action items generated", - "level": "info" + "message": ":alert: Agent anomaly detected: **{{anomalyType}}**\nSession: {{sessionId}}\nTask: {{taskTitle}}\nIntervention: auto-applied\nThresholds: stall={{stallThresholdMs}}ms token={{maxTokenUsage}} maxErrors={{maxConsecutiveErrors}}" }, "position": { - "x": 600, - "y": 830 + "x": 400, + "y": 700 }, "outputs": [ "default" @@ -8826,1292 +8282,964 @@ ], "edges": [ { - "id": "trigger->task-metrics", + "id": "trigger->classify", "source": "trigger", - "target": "task-metrics", + "target": "classify", "sourcePort": "default" }, { - "id": "trigger->pr-metrics", - "source": "trigger", - "target": "pr-metrics", - "sourcePort": "default" + "id": "classify->kill-and-restart", + "source": "classify", + "target": "kill-and-restart", + "sourcePort": "death-loop" }, { - "id": "task-metrics->error-analysis", - "source": "task-metrics", - "target": "error-analysis", - "sourcePort": "default" + "id": "classify->nudge-stall", + "source": "classify", + "target": "nudge-stall", + "sourcePort": "stall" }, { - "id": "pr-metrics->agent-stats", - "source": "pr-metrics", - "target": "agent-stats", - "sourcePort": "default" + "id": "classify->trim-context", + "source": "classify", + "target": "trim-context", + "sourcePort": "token-overflow" }, { - "id": "error-analysis->generate-retro", - "source": "error-analysis", - "target": "generate-retro", - "sourcePort": "default" + "id": "classify->fix-rebase", + "source": "classify", + "target": "fix-rebase", + "sourcePort": "rebase-spiral" }, { - "id": "agent-stats->generate-retro", - "source": "agent-stats", - "target": "generate-retro", + "id": "classify->break-spin", + "source": "classify", + "target": "break-spin", + "sourcePort": "thought-spin" + }, + { + "id": "kill-and-restart->log-intervention", + "source": "kill-and-restart", + "target": "log-intervention", "sourcePort": "default" }, { - "id": "generate-retro->has-actions", - "source": "generate-retro", - "target": "has-actions", + "id": "nudge-stall->log-intervention", + "source": "nudge-stall", + "target": "log-intervention", "sourcePort": "default" }, { - "id": "has-actions->create-tasks", - "source": "has-actions", - "target": "create-tasks", - "sourcePort": "yes", - "condition": "$output?.result === true" + "id": "trim-context->log-intervention", + "source": "trim-context", + "target": "log-intervention", + "sourcePort": "default" }, { - "id": "has-actions->log-no-actions", - "source": "has-actions", - "target": "log-no-actions", - "sourcePort": "no", - "condition": "$output?.result !== true" + "id": "fix-rebase->log-intervention", + "source": "fix-rebase", + "target": "log-intervention", + "sourcePort": "default" }, { - "id": "create-tasks->send-report", - "source": "create-tasks", - "target": "send-report", + "id": "break-spin->log-intervention", + "source": "break-spin", + "target": "log-intervention", "sourcePort": "default" }, { - "id": "log-no-actions->send-report", - "source": "log-no-actions", - "target": "send-report", + "id": "log-intervention->alert-telegram", + "source": "log-intervention", + "target": "alert-telegram", "sourcePort": "default" } ] }, { - "id": "template-task-planner", - "name": "Task Planner", - "description": "Automatically generates new backlog tasks when the todo count drops below a configurable threshold. Replaces the previous hardcoded TASK_PLANNER_MODE / REPLENISH_ENABLED env-var system.", - "category": "planning", - "categoryLabel": "Planning", - "categoryIcon": ":clipboard:", - "categoryOrder": 4, + "id": "template-continuation-loop", + "name": "Continuation Loop", + "description": "Issue-state continuation loop. Polls externalStatus, keeps driving the agent until terminal state or max turns, and handles stuck sessions with retry/escalate/pause.", + "category": "reliability", + "categoryLabel": "Reliability", + "categoryIcon": ":shield:", + "categoryOrder": 5, "tags": [ - "planner", - "backlog", - "automation" + "continuation", + "loop", + "linear", + "external-status", + "stuck-detection" ], - "nodeCount": 11, - "edgeCount": 10, - "recommended": true, + "nodeCount": 33, + "edgeCount": 36, + "recommended": false, "enabled": true, - "trigger": "trigger.task_low", + "trigger": "trigger.manual", "variables": { - "minTodoCount": 3, - "taskCount": 5, - "dedupHours": 24, - "failureCooldownMinutes": 30, - "prompt": "", - "plannerContext": "Focus on high-value implementation work. Avoid duplicating existing tasks." + "taskId": "", + "worktreePath": "", + "maxTurns": 8, + "pollIntervalMs": 30000, + "terminalStates": [ + "done", + "cancelled" + ], + "stuckThresholdMs": 300000, + "maxStuckAutoRetries": 1, + "onStuck": "escalate", + "continuePrompt": "Continue this task from the current state. Focus on the next missing step and push toward completion.", + "retryPrompt": "No progress was detected recently. Try a different approach and make concrete progress (commit or file updates).", + "sdk": "auto", + "model": "", + "timeoutMs": 1800000 }, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2025-02-24T00:00:00Z", - "templateVersion": "1.0.0", + "createdAt": "2026-03-10T00:00:00Z", + "templateVersion": "1.1.0", "tags": [ - "planner", - "backlog", - "automation" + "continuation", + "loop", + "linear", + "external-status", + "stuck-detection" ], - "replaces": { - "module": "monitor.mjs", - "functions": [ - "startTaskPlannerStatusLoop" - ], - "calledFrom": [ - "monitor.mjs:startProcess" - ], - "description": "Replaces the hardcoded task planner status loop. Task counting, gap analysis, and replenishment are visual workflow steps." - } + "configType": "continuation-loop" }, "nodes": [ { "id": "trigger", - "type": "trigger.task_low", - "label": "Backlog Low?", - "config": { - "threshold": "{{minTodoCount}}", - "status": "todo" - }, + "type": "trigger.manual", + "label": "Start Continuation Loop", + "config": {}, "position": { - "x": 400, - "y": 50 + "x": 420, + "y": 60 }, "outputs": [ "default" ] }, { - "id": "check-dedup", - "type": "condition.expression", - "label": "Dedup Window", + "id": "init-turn", + "type": "action.set_variable", + "label": "Initialize Turn Counter", "config": { - "expression": "(() => { const now = Date.now(); const lastSuccessAt = Number($data?._lastPlannerRun || 0); const lastFailureAt = Number($data?._lastPlannerFailureAt || 0); const successWindowMs = Number($data?.dedupHours || 24) * 3600000; const failureWindowMs = Number($data?.failureCooldownMinutes || 30) * 60000; return (now - lastSuccessAt) > successWindowMs && (now - lastFailureAt) > failureWindowMs;})()" + "key": "continuationTurn", + "value": "0", + "isExpression": true }, "position": { - "x": 400, - "y": 180 + "x": 420, + "y": 170 }, "outputs": [ "default" ] }, { - "id": "log-start", - "type": "notify.log", - "label": "Log Planner Start", + "id": "init-progress-at", + "type": "action.set_variable", + "label": "Initialize Progress Clock", "config": { - "message": "Task planner triggered: {{trigger.todoCount}} tasks remaining (threshold: {{minTodoCount}})", - "level": "info" + "key": "lastProgressAt", + "value": "Date.now()", + "isExpression": true }, "position": { - "x": 400, - "y": 310 + "x": 420, + "y": 280 }, "outputs": [ "default" ] }, { - "id": "run-planner", - "type": "agent.run_planner", - "label": "Generate Tasks", + "id": "init-signature", + "type": "action.set_variable", + "label": "Initialize Progress Signature", "config": { - "taskCount": "{{taskCount}}", - "context": "{{plannerContext}}", - "prompt": "{{prompt}}", - "repoMapQuery": "{{plannerContext}} {{prompt}}", - "repoMapFileLimit": 8, - "dedup": true, - "timeoutMs": 960000, - "agentTimeoutMs": 900000, - "maxRetries": 0, - "retryable": false + "key": "lastProgressSignature", + "value": "''", + "isExpression": true }, "position": { - "x": 400, - "y": 440 + "x": 420, + "y": 390 }, "outputs": [ "default" ] }, { - "id": "materialize-tasks", - "type": "action.materialize_planner_tasks", - "label": "Create Tasks", + "id": "init-stuck-retry-count", + "type": "action.set_variable", + "label": "Initialize Stuck Retry Count", "config": { - "plannerNodeId": "run-planner", - "maxTasks": "{{taskCount}}", - "status": "draft", - "dedup": true, - "failOnZero": true, - "minCreated": 1 + "key": "stuckRetryCount", + "value": "0", + "isExpression": true }, "position": { - "x": 400, - "y": 570 + "x": 420, + "y": 450 }, "outputs": [ "default" ] }, { - "id": "check-result", - "type": "condition.expression", - "label": "Planner Succeeded?", + "id": "poll-task", + "type": "action.bosun_function", + "label": "Poll External Task State", "config": { - "expression": "$ctx.getNodeOutput('materialize-tasks')?.success === true && ($ctx.getNodeOutput('materialize-tasks')?.createdCount || 0) > 0" + "function": "tasks.get", + "args": { + "taskId": "{{taskId}}" + }, + "outputVariable": "continuationTask" }, "position": { - "x": 400, - "y": 700 + "x": 420, + "y": 500 }, "outputs": [ "default" ] }, { - "id": "set-timestamp", + "id": "derive-status", "type": "action.set_variable", - "label": "Update Last Run", + "label": "Derive External Status", "config": { - "key": "_lastPlannerRun", - "value": "Date.now()", + "key": "currentExternalStatus", + "value": "String(($data?.continuationTask?.externalStatus ?? $data?.continuationTask?.status ?? '') || '').trim().toLowerCase()", "isExpression": true }, "position": { - "x": 200, - "y": 830 + "x": 420, + "y": 610 }, "outputs": [ "default" ] }, { - "id": "notify-done", - "type": "notify.telegram", - "label": "Notify Tasks Created", + "id": "terminal-check", + "type": "condition.expression", + "label": "Terminal State Reached?", "config": { - "message": ":folder: Task planner created {{materialize-tasks.createdCount}} backlog tasks (skipped {{materialize-tasks.skippedCount}} duplicates).", - "silent": true + "expression": "(() => { const s = String($data?.currentExternalStatus || '').trim().toLowerCase(); const t = Array.isArray($data?.terminalStates) ? $data.terminalStates.map(v => String(v || '').trim().toLowerCase()).filter(Boolean) : []; return Boolean(s) && t.includes(s); })()" }, "position": { - "x": 200, - "y": 960 + "x": 420, + "y": 720 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "notify-skip", - "type": "notify.log", - "label": "Log Dedup Skip", + "id": "end-terminal", + "type": "flow.end", + "label": "End: Terminal State", "config": { - "message": "Task planner skipped: within dedup window", - "level": "info" + "status": "completed", + "message": "Continuation loop completed: terminal external state '{{currentExternalStatus}}' reached for task {{taskId}}.", + "output": { + "reason": "terminal_state", + "taskId": "{{taskId}}", + "externalStatus": "{{currentExternalStatus}}" + } }, "position": { - "x": 650, - "y": 180 + "x": 160, + "y": 860 }, "outputs": [ "default" ] }, { - "id": "notify-fail", - "type": "notify.log", - "label": "Log Planner Failure", + "id": "max-turns-check", + "type": "condition.expression", + "label": "Max Turns Reached?", "config": { - "message": "Task planner failed to materialize tasks from planner output", - "level": "warn" + "expression": "Number($data?.continuationTurn || 0) >= Number($data?.maxTurns || 0)" }, "position": { - "x": 600, - "y": 830 + "x": 620, + "y": 860 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "set-timestamp-fail", - "type": "action.set_variable", - "label": "Cooldown After Failure", + "id": "end-max-turns", + "type": "flow.end", + "label": "End: Max Turns", "config": { - "key": "_lastPlannerFailureAt", - "value": "Date.now()", - "isExpression": true + "status": "failed", + "message": "Continuation loop stopped after reaching maxTurns={{maxTurns}} for task {{taskId}}.", + "output": { + "reason": "max_turns", + "taskId": "{{taskId}}", + "turns": "{{continuationTurn}}" + } }, "position": { - "x": 600, - "y": 960 + "x": 460, + "y": 1000 }, "outputs": [ "default" ] - } - ], - "edges": [ - { - "id": "trigger->check-dedup", - "source": "trigger", - "target": "check-dedup", - "sourcePort": "default" - }, - { - "id": "check-dedup->log-start", - "source": "check-dedup", - "target": "log-start", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "check-dedup->notify-skip", - "source": "check-dedup", - "target": "notify-skip", - "sourcePort": "default", - "condition": "$output?.result !== true" }, { - "id": "log-start->run-planner", - "source": "log-start", - "target": "run-planner", - "sourcePort": "default" + "id": "run-agent", + "type": "action.run_agent", + "label": "Drive Agent", + "config": { + "prompt": "{{continuePrompt}}", + "taskId": "{{taskId}}", + "cwd": "{{worktreePath}}", + "sdk": "{{sdk}}", + "model": "{{model}}", + "timeoutMs": "{{timeoutMs}}", + "failOnError": false + }, + "position": { + "x": 800, + "y": 1000 + }, + "outputs": [ + "default" + ] }, { - "id": "run-planner->materialize-tasks", - "source": "run-planner", - "target": "materialize-tasks", - "sourcePort": "default" + "id": "capture-progress", + "type": "action.run_command", + "label": "Capture Progress Signature", + "config": { + "command": "node -e \"const cp=require('node:child_process');const crypto=require('node:crypto');const head=(cp.execSync('git rev-parse HEAD',{encoding:'utf8'}).trim()||'');const dirtyRaw=cp.execSync('git status --porcelain=v1',{encoding:'utf8'});const dirtyCount=dirtyRaw.split(/\\r?\\n/).filter(Boolean).length;const statusDigest=crypto.createHash('sha1').update(dirtyRaw).digest('hex').slice(0,16);process.stdout.write(JSON.stringify({head,dirtyCount,statusDigest}));\"", + "cwd": "{{worktreePath}}", + "failOnError": false + }, + "position": { + "x": 800, + "y": 1120 + }, + "outputs": [ + "default" + ] }, { - "id": "materialize-tasks->check-result", - "source": "materialize-tasks", - "target": "check-result", - "sourcePort": "default" + "id": "derive-signature", + "type": "action.set_variable", + "label": "Derive Signature", + "config": { + "key": "currentProgressSignature", + "value": "(() => { const raw = String($ctx.getNodeOutput('capture-progress')?.output || '').trim(); try { const parsed = JSON.parse(raw); const head = String(parsed?.head || ''); const dirty = Number(parsed?.dirtyCount || 0); const statusDigest = String(parsed?.statusDigest || ''); return `${head}:${dirty}:${statusDigest}`; } catch { return ''; } })()", + "isExpression": true + }, + "position": { + "x": 800, + "y": 1240 + }, + "outputs": [ + "default" + ] }, { - "id": "check-result->set-timestamp", - "source": "check-result", - "target": "set-timestamp", - "sourcePort": "default", - "condition": "$output?.result === true" + "id": "progress-changed", + "type": "condition.expression", + "label": "Progress Changed?", + "config": { + "expression": "String($data?.currentProgressSignature || '') !== String($data?.lastProgressSignature || '')" + }, + "position": { + "x": 800, + "y": 1360 + }, + "outputs": [ + "yes", + "no" + ] }, { - "id": "check-result->notify-fail", - "source": "check-result", - "target": "notify-fail", - "sourcePort": "default", - "condition": "$output?.result !== true" + "id": "mark-progress-at", + "type": "action.set_variable", + "label": "Update Progress Clock", + "config": { + "key": "lastProgressAt", + "value": "(() => { const changed = String($data?.currentProgressSignature || '') !== String($data?.lastProgressSignature || ''); return changed ? Date.now() : Number($data?.lastProgressAt || 0); })()", + "isExpression": true + }, + "position": { + "x": 680, + "y": 1490 + }, + "outputs": [ + "default" + ] }, { - "id": "set-timestamp->notify-done", - "source": "set-timestamp", - "target": "notify-done", - "sourcePort": "default" + "id": "mark-progress-sig", + "type": "action.set_variable", + "label": "Update Progress Signature", + "config": { + "key": "lastProgressSignature", + "value": "$data?.currentProgressSignature || ''", + "isExpression": true + }, + "position": { + "x": 680, + "y": 1600 + }, + "outputs": [ + "default" + ] }, { - "id": "notify-fail->set-timestamp-fail", - "source": "notify-fail", - "target": "set-timestamp-fail", - "sourcePort": "default" - } - ] - }, - { - "id": "template-task-replenish", - "name": "Task Replenish (Scheduled)", - "description": "Periodically checks backlog and replenishes tasks on a schedule. This replaces the previous INTERNAL_EXECUTOR_REPLENISH_ENABLED env var with a configurable visual workflow.", - "category": "planning", - "categoryLabel": "Planning", - "categoryIcon": ":clipboard:", - "categoryOrder": 4, - "tags": [ - "replenish", - "schedule", - "backlog" - ], - "nodeCount": 7, - "edgeCount": 6, - "recommended": false, - "enabled": false, - "trigger": "trigger.schedule", - "variables": { - "intervalMs": 3600000, - "minTodoCount": 5, - "taskCount": 8, - "prompt": "", - "plannerContext": "Scheduled replenishment run. Prioritize implementation tasks that build on recent PRs." - }, - "metadata": { - "author": "bosun", - "version": 1, - "createdAt": "2025-02-24T00:00:00Z", - "templateVersion": "1.0.0", - "tags": [ - "replenish", - "schedule", - "backlog" - ], - "replaces": { - "module": "monitor.mjs", - "functions": [ - "startTaskPlannerStatusLoop (scheduled variant)" - ], - "calledFrom": [ - "monitor.mjs:startProcess" - ], - "description": "Replaces the cron-based task replenishment loop in monitor. Backlog scanning and planner execution become visual workflow steps." - } - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.schedule", - "label": "Hourly Check", + "id": "reset-stuck-retry-count", + "type": "action.set_variable", + "label": "Reset Stuck Retry Count On Progress", "config": { - "intervalMs": "{{intervalMs}}" + "key": "stuckRetryCount", + "value": "(() => { const changed = String($data?.currentProgressSignature || '') !== String($data?.lastProgressSignature || ''); return changed ? 0 : Number($data?.stuckRetryCount || 0); })()", + "isExpression": true }, "position": { - "x": 400, - "y": 50 + "x": 680, + "y": 1710 }, "outputs": [ "default" ] }, { - "id": "check-backlog", - "type": "trigger.task_low", - "label": "Check Backlog Level", + "id": "stuck-check", + "type": "condition.expression", + "label": "Session Stuck?", "config": { - "threshold": "{{minTodoCount}}" + "expression": "(Date.now() - Number($data?.lastProgressAt || 0)) >= Number($data?.stuckThresholdMs || 0)" }, "position": { - "x": 400, - "y": 180 + "x": 980, + "y": 1820 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "needs-tasks", - "type": "condition.expression", - "label": "Needs Replenishment?", + "id": "emit-stuck", + "type": "action.emit_event", + "label": "Emit session-stuck", "config": { - "expression": "$ctx.getNodeOutput('check-backlog')?.triggered === true" + "eventType": "session-stuck", + "payload": { + "taskId": "{{taskId}}", + "turn": "{{continuationTurn}}", + "externalStatus": "{{currentExternalStatus}}", + "stuckThresholdMs": "{{stuckThresholdMs}}", + "stuckForMs": "{{Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))}}", + "onStuck": "{{onStuck}}", + "stuckRetryCount": "{{stuckRetryCount}}", + "maxStuckAutoRetries": "{{maxStuckAutoRetries}}", + "lastProgressAt": "{{lastProgressAt}}", + "lastProgressSignature": "{{lastProgressSignature}}", + "currentProgressSignature": "{{currentProgressSignature}}", + "progressSnapshot": "{{$ctx.getNodeOutput('capture-progress')?.output || ''}}", + "lastAgentSuccess": "{{$ctx.getNodeOutput('run-agent')?.success === true}}", + "lastAgentOutput": "{{$ctx.getNodeOutput('run-agent')?.output || ''}}" + }, + "outputVariable": "sessionStuckEvent" }, "position": { - "x": 400, - "y": 310 + "x": 980, + "y": 1600 }, "outputs": [ "default" ] }, { - "id": "run-planner", - "type": "agent.run_planner", - "label": "Generate Tasks", + "id": "stuck-route", + "type": "condition.switch", + "label": "Route onStuck Action", "config": { - "taskCount": "{{taskCount}}", - "context": "{{plannerContext}}", - "prompt": "{{prompt}}", - "repoMapQuery": "{{plannerContext}} {{prompt}}", - "repoMapFileLimit": 8, - "timeoutMs": 960000, - "agentTimeoutMs": 900000, - "maxRetries": 0, - "retryable": false + "value": "$data?.onStuck || 'escalate'", + "cases": { + "retry": "retry", + "escalate": "escalate", + "pause": "pause" + } }, "position": { - "x": 400, - "y": 440 + "x": 980, + "y": 1710 }, "outputs": [ + "retry", + "escalate", + "pause", "default" ] }, { - "id": "materialize-tasks", - "type": "action.materialize_planner_tasks", - "label": "Create Tasks", + "id": "stuck-retry-budget", + "type": "condition.expression", + "label": "Stuck Retry Budget Remaining?", "config": { - "plannerNodeId": "run-planner", - "maxTasks": "{{taskCount}}", - "status": "todo", - "dedup": true, - "failOnZero": true, - "minCreated": 1 + "expression": "Number($data?.stuckRetryCount || 0) < Number($data?.maxStuckAutoRetries || 0)" }, "position": { - "x": 400, - "y": 570 + "x": 760, + "y": 1820 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "notify", - "type": "notify.telegram", - "label": "Notify", + "id": "stuck-retry", + "type": "action.run_agent", + "label": "Retry After Stuck", "config": { - "message": ":refresh: Scheduled replenishment created {{materialize-tasks.createdCount}} tasks (skipped {{materialize-tasks.skippedCount}}).", - "silent": true + "prompt": "{{retryPrompt}}\n\nStuck context:\n- taskId: {{taskId}}\n- externalStatus: {{currentExternalStatus}}\n- turn: {{continuationTurn}}\n- stuckRetryCount: {{stuckRetryCount}}/{{maxStuckAutoRetries}}\n- stuckForMs: {{Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))}}\n- lastProgressSignature: {{lastProgressSignature}}\n- currentProgressSignature: {{currentProgressSignature}}\n- progressSnapshot: {{$ctx.getNodeOutput('capture-progress')?.output || ''}}\n- lastAgentOutput: {{$ctx.getNodeOutput('run-agent')?.output || ''}}\n\nTry a materially different approach. If you cannot create progress, explain the specific blocker.", + "taskId": "{{taskId}}", + "cwd": "{{worktreePath}}", + "sdk": "{{sdk}}", + "model": "{{model}}", + "timeoutMs": "{{timeoutMs}}", + "failOnError": false }, "position": { - "x": 400, - "y": 700 + "x": 760, + "y": 1830 }, "outputs": [ "default" ] }, { - "id": "skip-log", - "type": "notify.log", - "label": "No Replenish Needed", + "id": "increment-stuck-retry-count", + "type": "action.set_variable", + "label": "Increment Stuck Retry Count", "config": { - "message": "Scheduled replenishment check: backlog sufficient, skipping" + "key": "stuckRetryCount", + "value": "Number($data?.stuckRetryCount || 0) + 1", + "isExpression": true }, "position": { - "x": 700, - "y": 310 + "x": 760, + "y": 1940 }, "outputs": [ "default" ] - } - ], - "edges": [ - { - "id": "trigger->check-backlog", - "source": "trigger", - "target": "check-backlog", - "sourcePort": "default" - }, - { - "id": "check-backlog->needs-tasks", - "source": "check-backlog", - "target": "needs-tasks", - "sourcePort": "default" - }, - { - "id": "needs-tasks->run-planner", - "source": "needs-tasks", - "target": "run-planner", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "needs-tasks->skip-log", - "source": "needs-tasks", - "target": "skip-log", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "run-planner->materialize-tasks", - "source": "run-planner", - "target": "materialize-tasks", - "sourcePort": "default" }, { - "id": "materialize-tasks->notify", - "source": "materialize-tasks", - "target": "notify", - "sourcePort": "default" - } - ] - }, - { - "id": "template-weekly-fitness-summary", - "name": "Weekly Fitness Summary", - "description": "Weekly evaluator workflow that scores delivery fitness using throughput, regression rate, merge success, reopened tasks, and debt growth. Produces follow-up actions and can materialize them as backlog tasks.", - "category": "planning", - "categoryLabel": "Planning", - "categoryIcon": ":clipboard:", - "categoryOrder": 4, - "tags": [ - "planning", - "weekly", - "fitness", - "evaluation", - "debt", - "throughput" - ], - "nodeCount": 15, - "edgeCount": 18, - "recommended": false, - "enabled": false, - "trigger": "trigger.schedule", - "variables": { - "scheduleCron": "0 9 * * 1", - "lookbackDays": 7, - "evaluatorFocus": "Bias toward systemic fixes that reduce regressions and execution thrash.", - "createFollowupTasks": true, - "maxFollowupTasks": 4 - }, - "metadata": { - "author": "bosun", - "version": 1, - "createdAt": "2026-03-07T00:00:00Z", - "templateVersion": "1.0.0", - "tags": [ - "planning", - "weekly", - "fitness", - "evaluation", - "debt", - "throughput" - ], - "replaces": { - "module": "monitor.mjs", - "functions": [ - "scheduleWeeklyFitnessSummary" - ], - "calledFrom": [ - "monitor.mjs:startProcess" - ], - "description": "Adds a weekly evaluator loop that measures delivery fitness and optionally materializes improvement actions as tasks." - } - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.schedule", - "label": "Weekly Schedule", + "id": "stuck-escalate", + "type": "notify.log", + "label": "Escalate Stuck Session", "config": { - "intervalMs": 604800000, - "cron": "{{scheduleCron}}" + "level": "warn", + "message": "session-stuck: escalation requested for task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}}, stuckForMs={{Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))}}, stuckRetryCount={{stuckRetryCount}}/{{maxStuckAutoRetries}}, lastProgressSignature={{lastProgressSignature}}, currentProgressSignature={{currentProgressSignature}})" }, "position": { - "x": 420, - "y": 40 + "x": 980, + "y": 1830 }, "outputs": [ "default" ] }, { - "id": "task-metrics", - "type": "action.bosun_cli", - "label": "Collect Task Metrics", + "id": "stuck-escalate-budget", + "type": "notify.log", + "label": "Escalate Stuck Session (Retry Limit)", "config": { - "subcommand": "task list", - "args": "--json", - "parseJson": true, - "continueOnError": true + "level": "warn", + "message": "session-stuck: retry budget exhausted for task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}}, stuckForMs={{Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))}}, stuckRetryCount={{stuckRetryCount}}/{{maxStuckAutoRetries}}, lastProgressSignature={{lastProgressSignature}}, currentProgressSignature={{currentProgressSignature}})" }, "position": { - "x": 150, - "y": 180 + "x": 760, + "y": 2050 }, "outputs": [ "default" ] }, { - "id": "pr-metrics", - "type": "action.run_command", - "label": "Collect PR Metrics", + "id": "stuck-pause", + "type": "notify.log", + "label": "Pause Stuck Session", "config": { - "command": "gh pr list --state all --json number,state,mergedAt,closedAt,createdAt,updatedAt,title,body --limit 200", - "continueOnError": true + "level": "warn", + "message": "session-stuck: paused task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}})" }, "position": { - "x": 420, - "y": 180 + "x": 1200, + "y": 1830 }, "outputs": [ "default" ] }, { - "id": "debt-metrics", - "type": "action.run_command", - "label": "Collect Debt Signals", + "id": "end-escalated", + "type": "flow.end", + "label": "End: Escalated", "config": { - "command": "node -e \"const fs=require('fs');const p='.bosun/workflow-runs/task-debt-ledger.jsonl';if(!fs.existsSync(p)){console.log('[]');process.exit(0);}const lines=fs.readFileSync(p,'utf8').split(/\\r?\\n/).filter(Boolean);console.log(JSON.stringify(lines.slice(-500).map(l=>{try{return JSON.parse(l)}catch{return null}}).filter(Boolean)));\"", - "continueOnError": true + "status": "failed", + "message": "Continuation loop escalated due to session-stuck for task {{taskId}}.", + "output": { + "reason": "stuck_escalated", + "taskId": "{{taskId}}", + "event": "{{sessionStuckEvent.eventType}}", + "stuckRetryCount": "{{stuckRetryCount}}", + "maxStuckAutoRetries": "{{maxStuckAutoRetries}}" + } }, "position": { - "x": 690, - "y": 180 + "x": 980, + "y": 1950 }, "outputs": [ "default" ] }, { - "id": "read-previous-summary", - "type": "action.read_file", - "label": "Read Prior Summary", + "id": "end-paused", + "type": "flow.end", + "label": "End: Paused", "config": { - "path": ".bosun/workflow-runs/weekly-fitness-summary.latest.json" + "status": "completed", + "message": "Continuation loop paused due to session-stuck for task {{taskId}}.", + "output": { + "reason": "stuck_paused", + "taskId": "{{taskId}}", + "event": "{{sessionStuckEvent.eventType}}" + } }, "position": { - "x": 960, - "y": 180 + "x": 1200, + "y": 1950 }, "outputs": [ "default" ] }, { - "id": "summarize-fitness-metrics", - "type": "action.set_variable", - "label": "Summarize Fitness Metrics", + "id": "wait-next-turn", + "type": "action.delay", + "label": "Wait Poll Interval", "config": { - "key": "fitnessSummary", - "value": "(() => { try { const now = Date.now(); const lookbackDays = Math.max(1, Number($data?.lookbackDays || 7)); const windowMs = lookbackDays * 24 * 60 * 60 * 1000; const currentStart = now - windowMs; const previousStart = currentStart - windowMs; const previousEnd = currentStart; const toNumber = (v, fallback = 0) => { const n = Number(v); return Number.isFinite(n) ? n : fallback; }; const toIso = (ms) => new Date(ms).toISOString(); const parseJsonSafe = (raw) => { try { return JSON.parse(String(raw)); } catch { return null; } }; const extractCanonicalItems = (value) => { if (!value || typeof value !== 'object') return null; const keys = ['items', 'tasks', 'entries', 'records', 'results', 'data']; for (const key of keys) { if (Array.isArray(value[key])) return value[key].filter(Boolean); } return null; }; const parseSource = (raw, depth = 0) => { if (depth > 3) return { items: [], degraded: true, parsedAny: false, partial: false }; if (Array.isArray(raw)) return { items: raw.filter(Boolean), degraded: false, parsedAny: raw.length > 0, partial: false }; if (raw && typeof raw === 'object') { const canonical = extractCanonicalItems(raw) ?? extractCanonicalItems(raw.output) ?? extractCanonicalItems(raw.result) ?? extractCanonicalItems(raw.payload); if (canonical) return { items: canonical, degraded: false, parsedAny: canonical.length > 0, partial: false }; const wrappedCandidates = [raw.output, raw.result, raw.payload, raw.data, raw.stdout, raw.content, raw.text, raw.json]; for (const candidate of wrappedCandidates) { if (candidate == null) continue; const parsedCandidate = parseSource(candidate, depth + 1); if (parsedCandidate.items.length > 0 || parsedCandidate.parsedAny || parsedCandidate.degraded === false) return parsedCandidate; } return { items: [], degraded: Object.keys(raw).length > 0, parsedAny: false, partial: false }; } if (typeof raw !== 'string') return { items: [], degraded: true, parsedAny: false, partial: false }; const trimmed = raw.trim(); if (!trimmed) return { items: [], degraded: false, parsedAny: false, partial: false }; const parsed = parseJsonSafe(trimmed); if (Array.isArray(parsed)) return { items: parsed.filter(Boolean), degraded: false, parsedAny: true, partial: false }; if (parsed && typeof parsed === 'object') { const canonical = extractCanonicalItems(parsed) ?? extractCanonicalItems(parsed.output) ?? extractCanonicalItems(parsed.result) ?? extractCanonicalItems(parsed.payload); if (canonical) return { items: canonical, degraded: false, parsedAny: true, partial: false }; } const lines = trimmed.split(/\\r?\\n/).filter((line) => line.trim() !== ''); const parsedLines = []; let failedLines = 0; for (const line of lines) { const parsedLine = parseJsonSafe(line); if (parsedLine == null) { failedLines += 1; continue; } if (Array.isArray(parsedLine)) parsedLines.push(...parsedLine.filter(Boolean)); else parsedLines.push(parsedLine); } if (parsedLines.length > 0) return { items: parsedLines, degraded: failedLines > 0, parsedAny: true, partial: failedLines > 0 }; return { items: [], degraded: true, parsedAny: false, partial: false }; }; const detectLinewiseParseHealth = (raw) => { if (typeof raw !== 'string') return { mixedValidity: false, nonJson: false }; const lines = raw.split(/\\r?\\n/).map((line) => line.trim()).filter(Boolean); if (lines.length === 0) return { mixedValidity: false, nonJson: false }; let parsedLines = 0; let failedLines = 0; for (const line of lines) { if (parseJsonSafe(line) == null) failedLines += 1; else parsedLines += 1; } return { mixedValidity: parsedLines > 0 && failedLines > 0, nonJson: parsedLines === 0 && failedLines > 0 }; }; const getTs = (item) => { if (!item || typeof item !== 'object') return null; const fields = ['completedAt', 'closedAt', 'mergedAt', 'resolvedAt', 'updatedAt', 'createdAt', 'timestamp', 'ts', 'date', 'completed_at', 'closed_at', 'merged_at', 'resolved_at', 'updated_at', 'created_at']; for (const key of fields) { const value = item[key]; if (!value) continue; const ms = Date.parse(String(value)); if (Number.isFinite(ms)) return ms; if (typeof value === 'number' && Number.isFinite(value)) return value > 1e12 ? value : value * 1000; } return null; }; const normalizeBucket = (items) => { const stamped = []; const unstamped = []; for (const item of items) { const ts = getTs(item); if (ts == null) unstamped.push(item); else stamped.push({ item, ts }); } return { stamped, unstamped }; }; const splitWindows = (items) => { const { stamped, unstamped } = normalizeBucket(items); const current = stamped.filter((entry) => entry.ts >= currentStart && entry.ts <= now).map((entry) => entry.item); const previous = stamped.filter((entry) => entry.ts >= previousStart && entry.ts < previousEnd).map((entry) => entry.item); const usedFallbackWindow = stamped.length === 0 && unstamped.length > 0; if (usedFallbackWindow) return { current: unstamped, previous: [], usedFallbackWindow }; return { current, previous, usedFallbackWindow }; }; const metric = (name, value, previous, direction, unit, confidence, status, notes = []) => { const hasCurrent = typeof value === 'number' && Number.isFinite(value); const hasPrevious = typeof previous === 'number' && Number.isFinite(previous); return { name, value: hasCurrent ? value : null, previous: hasPrevious ? previous : null, delta: hasCurrent && hasPrevious ? Number((value - previous).toFixed(2)) : null, direction, unit, confidence, status, notes: notes.filter(Boolean), }; }; const sourceStatus = (nodeOut, parsedList, parsedMeta = {}) => { const output = nodeOut?.output; const hasPayload = (() => { if (output == null) return false; if (Array.isArray(output)) return true; if (typeof output === 'string') return output.trim() !== ''; if (typeof output === 'object') { const wrapped = [output.stdout, output.content, output.text, output.json, output.output, output.result, output.payload, output.data]; if (wrapped.some((v) => (typeof v === 'string' ? v.trim() !== '' : v != null))) return true; return Object.keys(output).length > 0; } return true; })(); const linewiseHealth = (() => { if (typeof output === 'string') return detectLinewiseParseHealth(output); if (output && typeof output === 'object') { const candidate = [output.stdout, output.content, output.text, output.output, output.result, output.payload, output.data].find((value) => typeof value === 'string' && value.trim() !== ''); return detectLinewiseParseHealth(candidate); } return { mixedValidity: false, nonJson: false }; })(); const success = nodeOut?.success !== false; if (!hasPayload) return { status: 'missing', confidence: 'low' }; if (!Array.isArray(parsedList)) return { status: 'degraded', confidence: 'low' }; if (linewiseHealth.mixedValidity) return { status: 'degraded', confidence: parsedList.length > 0 ? 'medium' : 'low' }; if (linewiseHealth.nonJson && parsedList.length === 0) return { status: 'degraded', confidence: 'low' }; if (parsedMeta?.degraded || parsedMeta?.partial) return { status: 'degraded', confidence: parsedList.length > 0 ? 'medium' : 'low' }; if (!success) return { status: 'degraded', confidence: parsedList.length > 0 ? 'medium' : 'low' }; return { status: 'ok', confidence: parsedList.length > 0 ? 'high' : 'medium' }; }; const taskNode = $ctx.getNodeOutput('task-metrics') || {}; const prNode = $ctx.getNodeOutput('pr-metrics') || {}; const debtNode = $ctx.getNodeOutput('debt-metrics') || {}; const prevNode = $ctx.getNodeOutput('read-previous-summary') || {}; const taskParsed = parseSource(taskNode.output); const prParsed = parseSource(prNode.output); const debtParsed = parseSource(debtNode.output); const tasks = taskParsed.items; const prs = prParsed.items; const debt = debtParsed.items; const taskHealth = sourceStatus(taskNode, tasks, taskParsed); const prHealth = sourceStatus(prNode, prs, prParsed); const debtHealth = sourceStatus(debtNode, debt, debtParsed); const taskSplit = splitWindows(tasks); const prSplit = splitWindows(prs); const debtSplit = splitWindows(debt); const doneStatuses = new Set(['done', 'closed', 'completed', 'merged', 'resolved']); const isDone = (item) => doneStatuses.has(String(item?.status ?? item?.state ?? '').toLowerCase()); const taskTelemetryUnavailable = taskHealth.status === 'missing' || (taskHealth.status === 'degraded' && tasks.length === 0); const throughputCurrent = taskTelemetryUnavailable ? null : taskSplit.current.filter(isDone).length; const throughputPrevious = taskTelemetryUnavailable ? null : taskSplit.previous.filter(isDone).length; const reopenedCount = (items) => items.filter((item) => { if (!item || typeof item !== 'object') return false; const reopenCount = toNumber(item.reopenCount ?? item.reopenedCount ?? item.reopen_count ?? item.reopened_count, 0); if (reopenCount > 0) return true; if (item.reopened === true) return true; const status = String(item.status ?? item.state ?? '').toLowerCase(); return status.includes('reopen'); }).length; const reopenedCurrent = taskTelemetryUnavailable ? null : reopenedCount(taskSplit.current); const reopenedPrevious = taskTelemetryUnavailable ? null : reopenedCount(taskSplit.previous); const classifyRegression = (pr) => /revert|regression|rollback|hotfix/i.test(String(pr?.title || '') + ' ' + String(pr?.body || '')); const regressionCurrentCount = prSplit.current.filter(classifyRegression).length; const regressionPreviousCount = prSplit.previous.filter(classifyRegression).length; const regressionCurrentRate = prSplit.current.length > 0 ? Number(((regressionCurrentCount / prSplit.current.length) * 100).toFixed(2)) : null; const regressionPreviousRate = prSplit.previous.length > 0 ? Number(((regressionPreviousCount / prSplit.previous.length) * 100).toFixed(2)) : null; const mergedCount = (items) => items.filter((pr) => String(pr?.state || '').toLowerCase() === 'merged' || Boolean(pr?.mergedAt) || Boolean(pr?.merged_at) || pr?.merged === true).length; const closedCount = (items) => items.filter((pr) => { const state = String(pr?.state || '').toLowerCase(); return state === 'closed' || state === 'merged' || Boolean(pr?.closedAt) || Boolean(pr?.closed_at) || Boolean(pr?.mergedAt) || Boolean(pr?.merged_at); }).length; const mergeClosedCurrent = closedCount(prSplit.current); const mergeClosedPrevious = closedCount(prSplit.previous); const mergeSuccessCurrent = mergeClosedCurrent > 0 ? Number(((mergedCount(prSplit.current) / mergeClosedCurrent) * 100).toFixed(2)) : null; const mergeSuccessPrevious = mergeClosedPrevious > 0 ? Number(((mergedCount(prSplit.previous) / mergeClosedPrevious) * 100).toFixed(2)) : null; const debtDelta = (entries) => { let total = 0; for (const entry of entries) { if (entry == null) continue; if (typeof entry === 'number') { total += entry; continue; } if (typeof entry !== 'object') continue; if (Number.isFinite(Number(entry.debtDelta))) { total += Number(entry.debtDelta); continue; } if (Number.isFinite(Number(entry.delta))) { total += Number(entry.delta); continue; } if (Number.isFinite(Number(entry.netChange))) { total += Number(entry.netChange); continue; } const amt = Number.isFinite(Number(entry.amount)) ? Number(entry.amount) : 1; const kind = String(entry.type || entry.event || entry.action || '').toLowerCase(); if (/resolved|burn|paydown|decrease|closed/.test(kind)) total -= amt; else if (/created|added|increase|opened|new/.test(kind)) total += amt; } return Number(total.toFixed(2)); }; const debtCurrent = debtSplit.current.length > 0 ? debtDelta(debtSplit.current) : null; const debtPrevious = debtSplit.previous.length > 0 ? debtDelta(debtSplit.previous) : null; const priorRaw = prevNode?.success === true ? (parseSource(prevNode.content).items?.[0] ?? parseJsonSafe(prevNode.content)) : null; const priorParsed = priorRaw?.fitnessSummary && typeof priorRaw.fitnessSummary === 'object' ? priorRaw.fitnessSummary : (priorRaw && typeof priorRaw === 'object' ? priorRaw : null); const metricConfidence = (primaryHealth, hasValue, usedFallbackWindow) => { if (!hasValue) return 'low'; if (primaryHealth.status === 'missing') return 'low'; if (primaryHealth.status === 'degraded') return 'low'; if (usedFallbackWindow) return 'medium'; return primaryHealth.confidence || 'medium'; }; const throughputMetric = metric('throughput', throughputCurrent, throughputPrevious, 'up_is_good', 'tasks', metricConfidence(taskHealth, throughputCurrent != null, taskSplit.usedFallbackWindow), taskHealth.status, [throughputCurrent == null ? 'Task telemetry unavailable for this window.' : '', taskSplit.usedFallbackWindow ? 'No task timestamps detected; treated all records as current week.' : '']); const regressionMetric = metric('regression_rate', regressionCurrentRate, regressionPreviousRate, 'down_is_good', 'percent', metricConfidence(prHealth, regressionCurrentRate != null, prSplit.usedFallbackWindow), prHealth.status, [regressionCurrentRate == null ? 'Insufficient PR sample to compute regression rate.' : '', prSplit.usedFallbackWindow ? 'No PR timestamps detected; treated all records as current week.' : '']); const mergeMetric = metric('merge_success', mergeSuccessCurrent, mergeSuccessPrevious, 'up_is_good', 'percent', metricConfidence(prHealth, mergeSuccessCurrent != null, prSplit.usedFallbackWindow), prHealth.status, [mergeSuccessCurrent == null ? 'No closed or merged PRs in scope.' : '', prSplit.usedFallbackWindow ? 'No PR timestamps detected; treated all records as current week.' : '']); const reopenedMetric = metric('reopened_tasks', reopenedCurrent, reopenedPrevious, 'down_is_good', 'tasks', metricConfidence(taskHealth, reopenedCurrent != null, taskSplit.usedFallbackWindow), taskHealth.status, [reopenedCurrent == null ? 'Task telemetry unavailable for this window.' : '', taskSplit.usedFallbackWindow ? 'No task timestamps detected; treated all records as current week.' : '']); const debtMetric = metric('debt_growth', debtCurrent, debtPrevious, 'down_is_good', 'points', metricConfidence(debtHealth, debtCurrent != null, debtSplit.usedFallbackWindow), debtHealth.status, [debtCurrent == null ? 'No debt ledger events in scope.' : '', debtSplit.usedFallbackWindow ? 'No debt timestamps detected; treated all records as current week.' : '']); const metrics = { throughput: throughputMetric, regression_rate: regressionMetric, merge_success: mergeMetric, reopened_tasks: reopenedMetric, debt_growth: debtMetric }; const metricKeys = ['throughput', 'regression_rate', 'merge_success', 'reopened_tasks', 'debt_growth']; const trendDeltas = metricKeys.reduce((acc, key) => { const d = metrics?.[key]?.delta; acc[key] = Number.isFinite(d) ? d : null; return acc; }, {}); const normalizePriorTrendDelta = (metricName) => { const direct = priorParsed?.priorWeekTrendDeltas?.[metricName]; if (Number.isFinite(Number(direct))) return Number(Number(direct).toFixed(2)); const trend = priorParsed?.trendDeltas?.[metricName]; if (Number.isFinite(Number(trend))) return Number(Number(trend).toFixed(2)); const metricDelta = priorParsed?.metrics?.[metricName]?.delta; if (Number.isFinite(Number(metricDelta))) return Number(Number(metricDelta).toFixed(2)); return null; }; const priorWeekTrendDeltas = metricKeys.reduce((acc, key) => { acc[key] = normalizePriorTrendDelta(key); return acc; }, {}); const priorWeekDeltas = priorWeekTrendDeltas; const priorWeekMetrics = priorParsed?.metrics && typeof priorParsed.metrics === 'object' ? priorParsed.metrics : null; const alertThresholds = { throughput: 1, regression_rate: 2.5, merge_success: 2.5, reopened_tasks: 1, debt_growth: 1 }; const metricTrendAlerts = Object.entries(metrics).flatMap(([metricName, m]) => { if (m == null || m.delta == null) return []; if (String(m.confidence || '').toLowerCase() === 'low') return []; const delta = Number(m.delta); const isRegression = (m.direction === 'up_is_good' && delta < 0) || (m.direction === 'down_is_good' && delta > 0); if (!isRegression) return []; const absDelta = Math.abs(delta); const threshold = alertThresholds[metricName] ?? 1; const severity = absDelta >= threshold * 2 ? 'high' : absDelta >= threshold ? 'medium' : 'low'; return [{ metric: metricName, severity, delta, reason: `${metricName} moved in a negative direction by ${delta} ${m.unit}.` }]; }); const sourceHealth = { tasks: { ...taskHealth, count: tasks.length }, prs: { ...prHealth, count: prs.length }, debt: { ...debtHealth, count: debt.length }, }; const sourceTelemetryAlerts = Object.entries(sourceHealth).flatMap(([sourceName, health]) => { if (health?.status === 'ok') return []; const severity = health?.status === 'missing' ? 'high' : 'medium'; const reason = health?.status === 'missing' ? `${sourceName} telemetry missing; metric interpretation may be limited.` : `${sourceName} telemetry partially parsed; confidence reduced.`; return [{ metric: `telemetry:${sourceName}`, severity, delta: null, reason }]; }); const trendAlerts = [...metricTrendAlerts, ...sourceTelemetryAlerts]; const confidenceValues = Object.values(metrics).map((m) => m?.confidence || 'low'); const overallConfidence = confidenceValues.every((c) => c === 'high') ? 'high' : confidenceValues.some((c) => c === 'low') ? 'low' : 'medium'; const plannerSignals = { schemaVersion: '1.0', overallConfidence, trendAlertCount: trendAlerts.length, highSeverityAlertCount: trendAlerts.filter((a) => a?.severity === 'high').length, sourceStatus: Object.fromEntries(Object.entries(sourceHealth).map(([k, v]) => [k, v?.status || 'missing'])), metricStatus: Object.fromEntries(metricKeys.map((k) => [k, metrics?.[k]?.status || 'missing'])), metricConfidence: Object.fromEntries(metricKeys.map((k) => [k, metrics?.[k]?.confidence || 'low'])), metricValues: Object.fromEntries(metricKeys.map((k) => [k, Number.isFinite(metrics?.[k]?.value) ? Number(metrics[k].value) : null])), trendDeltas, priorWeekTrendDeltas, }; const plannerArtifact = { schemaVersion: '1.0', generatedAt: toIso(now), lookbackDays, sourceStatus: plannerSignals.sourceStatus, metricConfidence: plannerSignals.metricConfidence, metricValues: plannerSignals.metricValues, trendDeltas, priorWeekTrendDeltas, trendAlertCount: plannerSignals.trendAlertCount, highSeverityAlertCount: plannerSignals.highSeverityAlertCount, trendAlerts, }; return { schemaVersion: '1.0', generatedAt: toIso(now), lookbackDays, window: { currentStart: toIso(currentStart), currentEnd: toIso(now), previousStart: toIso(previousStart), previousEnd: toIso(previousEnd) }, sourceHealth, metrics, trendDeltas, trendAlerts, priorWeekTrendDeltas, priorWeekDeltas, priorWeekMetrics, plannerSignals, plannerArtifact, dataQuality: { overallConfidence, missingSources: Object.entries(sourceHealth).filter(([, v]) => v.status === 'missing').map(([k]) => k), degradedSources: Object.entries(sourceHealth).filter(([, v]) => v.status === 'degraded').map(([k]) => k), }, }; } catch (error) { return { schemaVersion: '1.0', generatedAt: new Date().toISOString(), lookbackDays: Number($data?.lookbackDays || 7), sourceHealth: { tasks: { status: 'missing', confidence: 'low', count: 0 }, prs: { status: 'missing', confidence: 'low', count: 0 }, debt: { status: 'missing', confidence: 'low', count: 0 }, }, metrics: { throughput: { value: null, previous: null, delta: null, confidence: 'low', status: 'missing' }, regression_rate: { value: null, previous: null, delta: null, confidence: 'low', status: 'missing' }, merge_success: { value: null, previous: null, delta: null, confidence: 'low', status: 'missing' }, reopened_tasks: { value: null, previous: null, delta: null, confidence: 'low', status: 'missing' }, debt_growth: { value: null, previous: null, delta: null, confidence: 'low', status: 'missing' }, }, trendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, trendAlerts: [{ metric: 'summary', severity: 'high', delta: null, reason: `Fitness summary fallback engaged: ${error?.message || 'unknown error'}` }], priorWeekTrendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, priorWeekDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, priorWeekMetrics: null, plannerSignals: { schemaVersion: '1.0', overallConfidence: 'low', trendAlertCount: 1, highSeverityAlertCount: 1, sourceStatus: { tasks: 'missing', prs: 'missing', debt: 'missing' }, metricStatus: { throughput: 'missing', regression_rate: 'missing', merge_success: 'missing', reopened_tasks: 'missing', debt_growth: 'missing' }, metricConfidence: { throughput: 'low', regression_rate: 'low', merge_success: 'low', reopened_tasks: 'low', debt_growth: 'low' }, metricValues: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, trendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, priorWeekTrendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, }, plannerArtifact: { schemaVersion: '1.0', generatedAt: new Date().toISOString(), lookbackDays: Number($data?.lookbackDays || 7), sourceStatus: { tasks: 'missing', prs: 'missing', debt: 'missing' }, metricConfidence: { throughput: 'low', regression_rate: 'low', merge_success: 'low', reopened_tasks: 'low', debt_growth: 'low' }, metricValues: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, trendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, priorWeekTrendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, trendAlertCount: 1, highSeverityAlertCount: 1, trendAlerts: [{ metric: 'summary', severity: 'high', delta: null, reason: `Fitness summary fallback engaged: ${error?.message || 'unknown error'}` }], }, dataQuality: { overallConfidence: 'low', missingSources: ['tasks', 'prs', 'debt'], degradedSources: [] }, }; }})()", - "isExpression": true + "ms": "{{pollIntervalMs}}", + "reason": "Waiting before next external status poll" }, "position": { - "x": 420, - "y": 360 + "x": 760, + "y": 1950 }, "outputs": [ "default" ] }, { - "id": "serialize-fitness-summary", + "id": "increment-turn", "type": "action.set_variable", - "label": "Serialize Fitness Summary", + "label": "Increment Turn", "config": { - "key": "fitnessSummaryJson", - "value": "(() => JSON.stringify($data?.fitnessSummary || {}, null, 2))()", + "key": "continuationTurn", + "value": "Number($data?.continuationTurn || 0) + 1", "isExpression": true }, "position": { - "x": 420, - "y": 500 + "x": 760, + "y": 2060 }, "outputs": [ "default" ] }, { - "id": "render-trend-alerts", - "type": "action.set_variable", - "label": "Render Trend Alerts", + "id": "wait-next-turn-no-stuck", + "type": "action.delay", + "label": "Wait (No Stuck)", "config": { - "key": "fitnessTrendAlertsText", - "value": "(() => { const alerts = Array.isArray($data?.fitnessSummary?.trendAlerts) ? $data.fitnessSummary.trendAlerts : []; if (!alerts.length) return 'No negative trend alerts this week.'; return alerts.map((a, idx) => `${idx + 1}. ${a.metric} (${a.severity}) - ${a.reason}`).join('\\n'); })()", - "isExpression": true + "ms": "{{pollIntervalMs}}", + "reason": "Waiting before next external status poll" }, "position": { - "x": 420, - "y": 640 + "x": 1080, + "y": 1950 }, "outputs": [ "default" ] }, { - "id": "persist-fitness-summary", - "type": "action.write_file", - "label": "Persist Fitness Summary Artifact", + "id": "increment-turn-no-stuck", + "type": "action.set_variable", + "label": "Increment Turn (No Stuck)", "config": { - "path": ".bosun/workflow-runs/weekly-fitness-summary.latest.json", - "content": "{{fitnessSummaryJson}}", - "mkdir": true + "key": "continuationTurn", + "value": "Number($data?.continuationTurn || 0) + 1", + "isExpression": true }, "position": { - "x": 420, - "y": 780 + "x": 1080, + "y": 2060 }, "outputs": [ "default" ] + } + ], + "edges": [ + { + "id": "trigger->init-turn", + "source": "trigger", + "target": "init-turn", + "sourcePort": "default" }, { - "id": "evaluate-fitness", - "type": "action.run_agent", - "label": "Evaluate Fitness", - "config": { - "prompt": "# Weekly Delivery Fitness Evaluation\n\nEvaluate the last {{lookbackDays}} days using this machine-readable summary:\n\nMetrics to evaluate:\n- Throughput\n- Regression rate\n- Merge success\n- Reopened tasks\n- Debt growth\n\n## Weekly Fitness JSON\n{{fitnessSummaryJson}}\n\n## Negative Trend Alerts\n{{fitnessTrendAlertsText}}\n\nFocus directive: {{evaluatorFocus}}\n\nRequirements:\n- Respect confidence and status on each metric.\n- If a metric has low confidence or missing telemetry, call that out explicitly and avoid overconfident recommendations.\n- Use prior-week deltas when available.\n- If one telemetry source is unavailable, still provide a stable scorecard and best-effort recommendations.\n\nReturn sections:\n1) Scorecard (0-100) with one line per metric and confidence\n2) Root-cause analysis of the largest drag\n3) Countermeasures ranked by impact/cost\n4) FOLLOW_UP_ACTION lines using format:\nFOLLOW_UP_ACTION: [title] | [description] | [repo_area] | [risk] | [effort]\n\nOnly include FOLLOW_UP_ACTION lines for changes that are worth implementing this week.", - "sdk": "auto", - "timeoutMs": 600000 - }, - "position": { - "x": 420, - "y": 930 - }, - "outputs": [ - "default" - ] + "id": "init-turn->init-progress-at", + "source": "init-turn", + "target": "init-progress-at", + "sourcePort": "default" }, { - "id": "has-followups", - "type": "condition.expression", - "label": "Follow-ups Enabled + Present", - "config": { - "expression": "($data?.createFollowupTasks === true) && (($ctx.getNodeOutput('evaluate-fitness')?.output || '').includes('FOLLOW_UP_ACTION:'))" - }, - "position": { - "x": 420, - "y": 1090 - }, - "outputs": [ - "default" - ] + "id": "init-progress-at->init-signature", + "source": "init-progress-at", + "target": "init-signature", + "sourcePort": "default" }, { - "id": "build-followup-json", - "type": "action.run_agent", - "label": "Build Follow-up Tasks JSON", - "config": { - "prompt": "Convert FOLLOW_UP_ACTION lines below into a single JSON object with shape { \"tasks\": [...] }.\n\nSource:\n{{evaluate-fitness.output}}\n\nStructured context:\n{{fitnessSummaryJson}}\n\nRules:\n- Generate at most {{maxFollowupTasks}} tasks\n- Include fields: title, description, implementation_steps, acceptance_criteria, verification, priority, tags, base_branch, impact, confidence, risk, estimated_effort, repo_areas, why_now, kill_criteria\n- Use trend deltas from the summary artifact to justify urgency and avoid parse errors\n- Keep tasks implementation-ready and avoid duplicates\n- Return only JSON", - "sdk": "auto", - "timeoutMs": 300000 - }, - "position": { - "x": 220, - "y": 1260 - }, - "outputs": [ - "default" - ] + "id": "init-signature->init-stuck-retry-count", + "source": "init-signature", + "target": "init-stuck-retry-count", + "sourcePort": "default" }, { - "id": "materialize-followups", - "type": "action.materialize_planner_tasks", - "label": "Materialize Follow-up Tasks", - "config": { - "plannerNodeId": "build-followup-json", - "maxTasks": "{{maxFollowupTasks}}", - "status": "todo", - "dedup": true, - "failOnZero": false, - "minCreated": 0 - }, - "position": { - "x": 220, - "y": 1420 - }, - "outputs": [ - "default" - ] + "id": "init-stuck-retry-count->poll-task", + "source": "init-stuck-retry-count", + "target": "poll-task", + "sourcePort": "default" }, { - "id": "notify-summary", - "type": "notify.telegram", - "label": "Send Weekly Fitness Summary", - "config": { - "message": ":chart: Weekly fitness evaluation complete. Follow-up tasks created: {{materialize-followups.createdCount}}\\n\\nTrend alerts:\\n{{fitnessTrendAlertsText}}\\n\\n{{evaluate-fitness.output}}", - "silent": true - }, - "position": { - "x": 420, - "y": 1580 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-no-followups", - "type": "notify.log", - "label": "No Follow-up Tasks", - "config": { - "message": "Weekly fitness evaluation completed with no follow-up task creation.", - "level": "info" - }, - "position": { - "x": 620, - "y": 1260 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->task-metrics", - "source": "trigger", - "target": "task-metrics", + "id": "poll-task->derive-status", + "source": "poll-task", + "target": "derive-status", "sourcePort": "default" }, { - "id": "trigger->pr-metrics", - "source": "trigger", - "target": "pr-metrics", + "id": "derive-status->terminal-check", + "source": "derive-status", + "target": "terminal-check", "sourcePort": "default" }, { - "id": "trigger->debt-metrics", - "source": "trigger", - "target": "debt-metrics", - "sourcePort": "default" + "id": "terminal-check->end-terminal", + "source": "terminal-check", + "target": "end-terminal", + "sourcePort": "yes", + "condition": "$output?.result === true" }, { - "id": "trigger->read-previous-summary", - "source": "trigger", - "target": "read-previous-summary", - "sourcePort": "default" + "id": "terminal-check->max-turns-check", + "source": "terminal-check", + "target": "max-turns-check", + "sourcePort": "no", + "condition": "$output?.result !== true" }, { - "id": "task-metrics->summarize-fitness-metrics", - "source": "task-metrics", - "target": "summarize-fitness-metrics", - "sourcePort": "default" + "id": "max-turns-check->end-max-turns", + "source": "max-turns-check", + "target": "end-max-turns", + "sourcePort": "yes", + "condition": "$output?.result === true" }, { - "id": "pr-metrics->summarize-fitness-metrics", - "source": "pr-metrics", - "target": "summarize-fitness-metrics", - "sourcePort": "default" + "id": "max-turns-check->run-agent", + "source": "max-turns-check", + "target": "run-agent", + "sourcePort": "no", + "condition": "$output?.result !== true" }, { - "id": "debt-metrics->summarize-fitness-metrics", - "source": "debt-metrics", - "target": "summarize-fitness-metrics", + "id": "run-agent->capture-progress", + "source": "run-agent", + "target": "capture-progress", "sourcePort": "default" }, { - "id": "read-previous-summary->summarize-fitness-metrics", - "source": "read-previous-summary", - "target": "summarize-fitness-metrics", + "id": "capture-progress->derive-signature", + "source": "capture-progress", + "target": "derive-signature", "sourcePort": "default" }, { - "id": "summarize-fitness-metrics->serialize-fitness-summary", - "source": "summarize-fitness-metrics", - "target": "serialize-fitness-summary", + "id": "derive-signature->progress-changed", + "source": "derive-signature", + "target": "progress-changed", "sourcePort": "default" }, { - "id": "serialize-fitness-summary->render-trend-alerts", - "source": "serialize-fitness-summary", - "target": "render-trend-alerts", + "id": "progress-changed->mark-progress-at", + "source": "progress-changed", + "target": "mark-progress-at", "sourcePort": "default" }, { - "id": "render-trend-alerts->persist-fitness-summary", - "source": "render-trend-alerts", - "target": "persist-fitness-summary", + "id": "mark-progress-at->mark-progress-sig", + "source": "mark-progress-at", + "target": "mark-progress-sig", "sourcePort": "default" }, { - "id": "persist-fitness-summary->evaluate-fitness", - "source": "persist-fitness-summary", - "target": "evaluate-fitness", + "id": "mark-progress-sig->reset-stuck-retry-count", + "source": "mark-progress-sig", + "target": "reset-stuck-retry-count", "sourcePort": "default" }, { - "id": "evaluate-fitness->has-followups", - "source": "evaluate-fitness", - "target": "has-followups", + "id": "reset-stuck-retry-count->stuck-check", + "source": "reset-stuck-retry-count", + "target": "stuck-check", "sourcePort": "default" }, { - "id": "has-followups->build-followup-json", - "source": "has-followups", - "target": "build-followup-json", - "sourcePort": "default", + "id": "stuck-check->emit-stuck", + "source": "stuck-check", + "target": "emit-stuck", + "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "has-followups->log-no-followups", - "source": "has-followups", - "target": "log-no-followups", - "sourcePort": "default", + "id": "stuck-check->wait-next-turn-no-stuck", + "source": "stuck-check", + "target": "wait-next-turn-no-stuck", + "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "build-followup-json->materialize-followups", - "source": "build-followup-json", - "target": "materialize-followups", - "sourcePort": "default" - }, - { - "id": "materialize-followups->notify-summary", - "source": "materialize-followups", - "target": "notify-summary", - "sourcePort": "default" - }, - { - "id": "log-no-followups->notify-summary", - "source": "log-no-followups", - "target": "notify-summary", + "id": "emit-stuck->stuck-route", + "source": "emit-stuck", + "target": "stuck-route", "sourcePort": "default" - } - ] - }, - { - "id": "template-anomaly-watchdog", - "name": "Anomaly Watchdog", - "description": "Real-time anomaly detection for agent sessions — catches death loops, stalls, token overflows, rebase spirals, and thought spinning. Automatically intervenes or escalates depending on severity.", - "category": "reliability", - "categoryLabel": "Reliability", - "categoryIcon": ":shield:", - "categoryOrder": 5, - "tags": [ - "anomaly", - "watchdog", - "death-loop", - "stall", - "reliability" - ], - "nodeCount": 9, - "edgeCount": 12, - "recommended": true, - "enabled": true, - "trigger": "trigger.event", - "variables": { - "stallThresholdMs": 300000, - "maxTokenUsage": 0.9, - "maxConsecutiveErrors": 5 - }, - "metadata": { - "author": "bosun", - "version": 1, - "createdAt": "2025-02-25T00:00:00Z", - "templateVersion": "1.0.1", - "tags": [ - "anomaly", - "watchdog", - "death-loop", - "stall", - "reliability" - ], - "replaces": { - "module": "anomaly-detector.mjs", - "functions": [ - "AnomalyDetector.processLine", - "onAnomaly callback" - ], - "calledFrom": [ - "monitor.mjs:startAgentAlertTailer" - ], - "description": "Replaces hardcoded anomaly detection responses with a visual workflow. Each anomaly type (death loop, stall, token overflow, rebase spiral, thought spin) routes to a specific intervention node." - } - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.event", - "label": "Agent Anomaly Detected", - "config": { - "eventType": "agent.anomaly", - "filter": "$event?.severity === 'high' || $event?.severity === 'critical'" - }, - "position": { - "x": 400, - "y": 50 - }, - "outputs": [ - "default" - ] - }, - { - "id": "classify", - "type": "condition.switch", - "label": "Classify Anomaly", - "config": { - "value": "$data?.anomalyType || 'unknown'", - "cases": { - "DEATH_LOOP": "death-loop", - "STALL": "stall", - "TOKEN_OVERFLOW": "token-overflow", - "REBASE_SPIRAL": "rebase-spiral", - "THOUGHT_SPIN": "thought-spin" - } - }, - "position": { - "x": 400, - "y": 200 - }, - "outputs": [ - "death-loop", - "stall", - "token-overflow", - "rebase-spiral", - "thought-spin", - "default" - ] - }, - { - "id": "kill-and-restart", - "type": "action.restart_agent", - "label": "Kill & Restart Agent", - "config": { - "sessionId": "{{sessionId}}", - "reason": "Death loop detected — agent cycling through the same error pattern", - "prompt": "The previous session entered a death loop. Start fresh with a different approach.\n\nOriginal task: {{taskTitle}}" - }, - "position": { - "x": 100, - "y": 380 - }, - "outputs": [ - "default" - ] - }, - { - "id": "nudge-stall", - "type": "action.continue_session", - "label": "Nudge Stalled Agent", - "config": { - "sessionId": "{{sessionId}}", - "prompt": "You appear to be stalled. Please continue working on the current task. If you are stuck, describe the blocker and try a different approach.", - "strategy": "continue" - }, - "position": { - "x": 300, - "y": 380 - }, - "outputs": [ - "default" - ] }, { - "id": "trim-context", - "type": "action.continue_session", - "label": "Trim Context & Continue", - "config": { - "sessionId": "{{sessionId}}", - "prompt": "Your context window is nearly full. Summarize your progress so far in 2-3 sentences, then continue with the most critical remaining work.", - "strategy": "refine" - }, - "position": { - "x": 500, - "y": 380 - }, - "outputs": [ - "default" - ] - }, - { - "id": "fix-rebase", - "type": "action.run_command", - "label": "Fix Stuck Rebase", - "config": { - "command": "git rebase --abort 2>/dev/null; git reset --hard HEAD; git checkout -B {{branch}} origin/{{branch}} 2>/dev/null || true", - "cwd": "{{worktreePath}}" - }, - "position": { - "x": 700, - "y": 380 - }, - "outputs": [ - "default" - ] + "id": "stuck-route->stuck-retry-budget", + "source": "stuck-route", + "target": "stuck-retry-budget", + "sourcePort": "retry" }, { - "id": "break-spin", - "type": "action.continue_session", - "label": "Break Thought Spin", - "config": { - "sessionId": "{{sessionId}}", - "prompt": "Stop your current analysis. You are repeating the same reasoning. Take a concrete action NOW:\n1. Make a specific code change, OR\n2. Run a specific command, OR\n3. Report that you are blocked and need help.\nDo NOT continue analyzing.", - "strategy": "continue" - }, - "position": { - "x": 900, - "y": 380 - }, - "outputs": [ - "default" - ] + "id": "stuck-route->stuck-escalate", + "source": "stuck-route", + "target": "stuck-escalate", + "sourcePort": "escalate" }, { - "id": "log-intervention", - "type": "notify.log", - "label": "Log Intervention", - "config": { - "message": "Anomaly watchdog intervened: {{anomalyType}} for session {{sessionId}}", - "level": "warn" - }, - "position": { - "x": 400, - "y": 550 - }, - "outputs": [ - "default" - ] + "id": "stuck-route->stuck-pause", + "source": "stuck-route", + "target": "stuck-pause", + "sourcePort": "pause" }, { - "id": "alert-telegram", - "type": "notify.telegram", - "label": "Alert Human", - "config": { - "message": ":alert: Agent anomaly detected: **{{anomalyType}}**\nSession: {{sessionId}}\nTask: {{taskTitle}}\nIntervention: auto-applied\nThresholds: stall={{stallThresholdMs}}ms token={{maxTokenUsage}} maxErrors={{maxConsecutiveErrors}}" - }, - "position": { - "x": 400, - "y": 700 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->classify", - "source": "trigger", - "target": "classify", + "id": "stuck-route->stuck-escalate", + "source": "stuck-route", + "target": "stuck-escalate", "sourcePort": "default" }, { - "id": "classify->kill-and-restart", - "source": "classify", - "target": "kill-and-restart", - "sourcePort": "death-loop" + "id": "stuck-retry-budget->stuck-retry", + "source": "stuck-retry-budget", + "target": "stuck-retry", + "sourcePort": "yes", + "condition": "$output?.result === true" }, { - "id": "classify->nudge-stall", - "source": "classify", - "target": "nudge-stall", - "sourcePort": "stall" + "id": "stuck-retry-budget->stuck-escalate-budget", + "source": "stuck-retry-budget", + "target": "stuck-escalate-budget", + "sourcePort": "no", + "condition": "$output?.result !== true" }, { - "id": "classify->trim-context", - "source": "classify", - "target": "trim-context", - "sourcePort": "token-overflow" + "id": "stuck-retry->increment-stuck-retry-count", + "source": "stuck-retry", + "target": "increment-stuck-retry-count", + "sourcePort": "default" }, { - "id": "classify->fix-rebase", - "source": "classify", - "target": "fix-rebase", - "sourcePort": "rebase-spiral" + "id": "increment-stuck-retry-count->wait-next-turn", + "source": "increment-stuck-retry-count", + "target": "wait-next-turn", + "sourcePort": "default" }, { - "id": "classify->break-spin", - "source": "classify", - "target": "break-spin", - "sourcePort": "thought-spin" + "id": "stuck-escalate->end-escalated", + "source": "stuck-escalate", + "target": "end-escalated", + "sourcePort": "default" }, { - "id": "kill-and-restart->log-intervention", - "source": "kill-and-restart", - "target": "log-intervention", + "id": "stuck-escalate-budget->end-escalated", + "source": "stuck-escalate-budget", + "target": "end-escalated", "sourcePort": "default" }, { - "id": "nudge-stall->log-intervention", - "source": "nudge-stall", - "target": "log-intervention", + "id": "stuck-pause->end-paused", + "source": "stuck-pause", + "target": "end-paused", "sourcePort": "default" }, { - "id": "trim-context->log-intervention", - "source": "trim-context", - "target": "log-intervention", + "id": "wait-next-turn->increment-turn", + "source": "wait-next-turn", + "target": "increment-turn", "sourcePort": "default" }, { - "id": "fix-rebase->log-intervention", - "source": "fix-rebase", - "target": "log-intervention", + "id": "wait-next-turn-no-stuck->increment-turn-no-stuck", + "source": "wait-next-turn-no-stuck", + "target": "increment-turn-no-stuck", "sourcePort": "default" }, { - "id": "break-spin->log-intervention", - "source": "break-spin", - "target": "log-intervention", - "sourcePort": "default" + "id": "increment-turn->poll-task", + "source": "increment-turn", + "target": "poll-task", + "sourcePort": "default", + "backEdge": true, + "maxIterations": 500 }, { - "id": "log-intervention->alert-telegram", - "source": "log-intervention", - "target": "alert-telegram", - "sourcePort": "default" + "id": "increment-turn-no-stuck->poll-task", + "source": "increment-turn-no-stuck", + "target": "poll-task", + "sourcePort": "default", + "backEdge": true, + "maxIterations": 500 } ] }, { "id": "template-continuation-loop", "name": "Continuation Loop", - "description": "Issue-state continuation loop. Fires automatically for any available task (trigger.task_available), drives the agent until a terminal state or max turns, and handles stuck sessions with retry/escalate/pause. taskId and worktreePath are auto-populated from the picked task — no manual input required.", + "description": "Issue-state continuation loop. Polls externalStatus, keeps driving the agent until terminal state or max turns, and handles stuck sessions with retry/escalate/pause.", "category": "reliability", "categoryLabel": "Reliability", "categoryIcon": ":shield:", @@ -10123,13 +9251,12 @@ "external-status", "stuck-detection" ], - "nodeCount": 34, - "edgeCount": 37, + "nodeCount": 33, + "edgeCount": 36, "recommended": false, "enabled": true, - "trigger": "trigger.task_available", + "trigger": "trigger.manual", "variables": { - "maxParallel": 1, "taskId": "", "worktreePath": "", "maxTurns": 8, @@ -10151,7 +9278,7 @@ "author": "bosun", "version": 1, "createdAt": "2026-03-10T00:00:00Z", - "templateVersion": "1.3.0", + "templateVersion": "1.1.0", "tags": [ "continuation", "loop", @@ -10164,18 +9291,9 @@ "nodes": [ { "id": "trigger", - "type": "trigger.task_available", - "label": "Pick Available Task", - "config": { - "maxParallel": "{{maxParallel}}", - "status": "inprogress", - "statuses": [ - "inprogress", - "todo" - ], - "filterCodexScoped": true, - "filterDrafts": true - }, + "type": "trigger.manual", + "label": "Start Continuation Loop", + "config": {}, "position": { "x": 420, "y": 60 @@ -10373,7 +9491,6 @@ "sdk": "{{sdk}}", "model": "{{model}}", "timeoutMs": "{{timeoutMs}}", - "requireTaskPromptCompleteness": false, "failOnError": false }, "position": { @@ -10418,23 +9535,6 @@ "default" ] }, - { - "id": "derive-stuck-ms", - "type": "action.set_variable", - "label": "Derive Stuck Duration", - "config": { - "key": "stuckForMs", - "value": "Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))", - "isExpression": true - }, - "position": { - "x": 1080, - "y": 1230 - }, - "outputs": [ - "default" - ] - }, { "id": "progress-changed", "type": "condition.expression", @@ -10507,7 +9607,7 @@ "type": "condition.expression", "label": "Session Stuck?", "config": { - "expression": "(() => { const agentOutput = $ctx.getNodeOutput('run-agent') || {}; const normalizedOutput = String(agentOutput?.output || '').replace(/\\s+/g, ' ').trim().toLowerCase(); const placeholderOutput = normalizedOutput === 'continued' || normalizedOutput === 'model response continued' || normalizedOutput === '(agent completed with no text output)'; const streamCount = Array.isArray(agentOutput?.stream) ? agentOutput.stream.length : 0; const itemCount = Number(agentOutput?.itemCount || (Array.isArray(agentOutput?.items) ? agentOutput.items.length : 0) || 0); const meaningfulAgentActivity = streamCount > 0 || itemCount > 0 || (!!normalizedOutput && !placeholderOutput); const noProgressChange = String($data?.currentProgressSignature || '') === String($data?.lastProgressSignature || ''); if (noProgressChange && !meaningfulAgentActivity) return true; if (placeholderOutput && noProgressChange) return true; const lastProgressAt = Number($data?.lastProgressAt || 0); const stuckThresholdMs = Number($data?.stuckThresholdMs || 0); if (stuckThresholdMs <= 0) return noProgressChange; if (lastProgressAt <= 0) return false; return noProgressChange && (Date.now() - lastProgressAt) >= stuckThresholdMs; })()" + "expression": "(Date.now() - Number($data?.lastProgressAt || 0)) >= Number($data?.stuckThresholdMs || 0)" }, "position": { "x": 980, @@ -10529,17 +9629,13 @@ "turn": "{{continuationTurn}}", "externalStatus": "{{currentExternalStatus}}", "stuckThresholdMs": "{{stuckThresholdMs}}", - "stuckForMs": "{{stuckForMs}}", + "stuckForMs": "{{Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))}}", "onStuck": "{{onStuck}}", "stuckRetryCount": "{{stuckRetryCount}}", "maxStuckAutoRetries": "{{maxStuckAutoRetries}}", "lastProgressAt": "{{lastProgressAt}}", "lastProgressSignature": "{{lastProgressSignature}}", "currentProgressSignature": "{{currentProgressSignature}}", - "placeholderResponse": "{{(() => { const normalizedOutput = String($ctx.getNodeOutput('run-agent')?.output || '').replace(/\\s+/g, ' ').trim().toLowerCase(); return normalizedOutput === 'continued' || normalizedOutput === 'model response continued'; })()}}", - "agentActivityDetected": "{{(() => { const agentOutput = $ctx.getNodeOutput('run-agent') || {}; const normalizedOutput = String(agentOutput?.output || '').replace(/\\s+/g, ' ').trim().toLowerCase(); const placeholderOutput = normalizedOutput === 'continued' || normalizedOutput === 'model response continued' || normalizedOutput === '(agent completed with no text output)'; const streamCount = Array.isArray(agentOutput?.stream) ? agentOutput.stream.length : 0; const itemCount = Number(agentOutput?.itemCount || (Array.isArray(agentOutput?.items) ? agentOutput.items.length : 0) || 0); return streamCount > 0 || itemCount > 0 || (!!normalizedOutput && !placeholderOutput); })()}}", - "agentItemCount": "{{$ctx.getNodeOutput('run-agent')?.itemCount || (Array.isArray($ctx.getNodeOutput('run-agent')?.items) ? $ctx.getNodeOutput('run-agent')?.items.length : 0) || 0}}", - "agentStreamCount": "{{Array.isArray($ctx.getNodeOutput('run-agent')?.stream) ? $ctx.getNodeOutput('run-agent')?.stream.length : 0}}", "progressSnapshot": "{{$ctx.getNodeOutput('capture-progress')?.output || ''}}", "lastAgentSuccess": "{{$ctx.getNodeOutput('run-agent')?.success === true}}", "lastAgentOutput": "{{$ctx.getNodeOutput('run-agent')?.output || ''}}" @@ -10604,7 +9700,6 @@ "sdk": "{{sdk}}", "model": "{{model}}", "timeoutMs": "{{timeoutMs}}", - "requireTaskPromptCompleteness": false, "failOnError": false }, "position": { @@ -10638,7 +9733,7 @@ "label": "Escalate Stuck Session", "config": { "level": "warn", - "message": "session-stuck: escalation requested for task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}}, stuckForMs={{stuckForMs}}, stuckRetryCount={{stuckRetryCount}}/{{maxStuckAutoRetries}}, lastProgressSignature={{lastProgressSignature}}, currentProgressSignature={{currentProgressSignature}})" + "message": "session-stuck: escalation requested for task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}}, stuckForMs={{Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))}}, stuckRetryCount={{stuckRetryCount}}/{{maxStuckAutoRetries}}, lastProgressSignature={{lastProgressSignature}}, currentProgressSignature={{currentProgressSignature}})" }, "position": { "x": 980, @@ -10654,7 +9749,7 @@ "label": "Escalate Stuck Session (Retry Limit)", "config": { "level": "warn", - "message": "session-stuck: retry budget exhausted for task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}}, stuckForMs={{stuckForMs}}, stuckRetryCount={{stuckRetryCount}}/{{maxStuckAutoRetries}}, lastProgressSignature={{lastProgressSignature}}, currentProgressSignature={{currentProgressSignature}})" + "message": "session-stuck: retry budget exhausted for task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}}, stuckForMs={{Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))}}, stuckRetryCount={{stuckRetryCount}}/{{maxStuckAutoRetries}}, lastProgressSignature={{lastProgressSignature}}, currentProgressSignature={{currentProgressSignature}})" }, "position": { "x": 760, @@ -10875,14 +9970,8 @@ "sourcePort": "default" }, { - "id": "derive-signature->derive-stuck-ms", + "id": "derive-signature->progress-changed", "source": "derive-signature", - "target": "derive-stuck-ms", - "sourcePort": "default" - }, - { - "id": "derive-stuck-ms->progress-changed", - "source": "derive-stuck-ms", "target": "progress-changed", "sourcePort": "default" }, @@ -11029,682 +10118,682 @@ ] }, { - "id": "template-continuation-loop", - "name": "Continuation Loop", - "description": "Issue-state continuation loop. Fires automatically for any available task (trigger.task_available), drives the agent until a terminal state or max turns, and handles stuck sessions with retry/escalate/pause. taskId and worktreePath are auto-populated from the picked task — no manual input required.", + "id": "template-error-recovery", + "name": "Error Recovery", + "description": "Automated error recovery flow when an agent crashes or fails. Analyzes logs, attempts auto-fix, and escalates if needed.", "category": "reliability", "categoryLabel": "Reliability", "categoryIcon": ":shield:", "categoryOrder": 5, "tags": [ - "continuation", - "loop", - "linear", - "external-status", - "stuck-detection" + "error", + "recovery", + "autofix" ], - "nodeCount": 34, - "edgeCount": 37, - "recommended": false, + "nodeCount": 8, + "edgeCount": 8, + "recommended": true, "enabled": true, - "trigger": "trigger.task_available", + "trigger": "trigger.event", "variables": { - "maxParallel": 1, - "taskId": "", - "worktreePath": "", - "maxTurns": 8, - "pollIntervalMs": 30000, - "terminalStates": [ - "done", - "cancelled" - ], - "stuckThresholdMs": 300000, - "maxStuckAutoRetries": 1, - "onStuck": "escalate", - "continuePrompt": "Continue this task from the current state. Focus on the next missing step and push toward completion.", - "retryPrompt": "No progress was detected recently. Try a different approach and make concrete progress (commit or file updates).", - "sdk": "auto", - "model": "", - "timeoutMs": 1800000 + "maxRetries": 3 }, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2026-03-10T00:00:00Z", - "templateVersion": "1.3.0", + "createdAt": "2025-02-24T00:00:00Z", + "templateVersion": "1.1.0", "tags": [ - "continuation", - "loop", - "linear", - "external-status", - "stuck-detection" + "error", + "recovery", + "autofix" ], - "configType": "continuation-loop" + "requiredTemplates": [ + "template-task-repair-worktree" + ], + "replaces": { + "module": "monitor.mjs", + "functions": [ + "runCodexRecovery" + ], + "calledFrom": [ + "monitor.mjs:runMonitorMonitorCycle" + ], + "description": "Replaces hardcoded error recovery logic. Retry/escalate decisions are now visual workflow branches." + } }, "nodes": [ { "id": "trigger", - "type": "trigger.task_available", - "label": "Pick Available Task", + "type": "trigger.event", + "label": "Agent Failed", "config": { - "maxParallel": "{{maxParallel}}", - "status": "inprogress", - "statuses": [ - "inprogress", - "todo" - ], - "filterCodexScoped": true, - "filterDrafts": true + "eventType": "task.failed" }, "position": { - "x": 420, - "y": 60 + "x": 400, + "y": 50 }, "outputs": [ "default" ] }, { - "id": "init-turn", - "type": "action.set_variable", - "label": "Initialize Turn Counter", + "id": "check-retries", + "type": "condition.expression", + "label": "Retries Left?", "config": { - "key": "continuationTurn", - "value": "0", - "isExpression": true + "expression": "($data?.retryCount || 0) < ($data?.maxRetries || 3)" }, "position": { - "x": 420, - "y": 170 + "x": 400, + "y": 180 }, "outputs": [ "default" ] }, { - "id": "init-progress-at", - "type": "action.set_variable", - "label": "Initialize Progress Clock", + "id": "analyze-error", + "type": "action.run_agent", + "label": "Analyze Failure", "config": { - "key": "lastProgressAt", - "value": "Date.now()", - "isExpression": true + "prompt": "Analyze the following task failure and suggest the most likely minimal fix.\n\nTask: {{taskTitle}} ({{taskId}})\nRetry attempt: {{$data?.retryCount || 0}}/{{$data?.maxRetries || 3}}\nBranch: {{branch}}\nBase branch: {{baseBranch}}\nWorktree: {{worktreePath}}\n\nLast error:\n{{lastError}}", + "timeoutMs": 300000 }, "position": { - "x": 420, - "y": 280 + "x": 200, + "y": 330 }, "outputs": [ "default" ] }, { - "id": "init-signature", - "type": "action.set_variable", - "label": "Initialize Progress Signature", + "id": "retry-task", + "type": "action.run_agent", + "label": "Retry Task", "config": { - "key": "lastProgressSignature", - "value": "''", - "isExpression": true + "prompt": "{{taskExecutorRetryPrompt}}\n\nFailure context:\n- taskId: {{taskId}}\n- taskTitle: {{taskTitle}}\n- branch: {{branch}}\n- baseBranch: {{baseBranch}}\n- worktreePath: {{worktreePath}}\n- retryCount: {{$data?.retryCount || 0}}/{{$data?.maxRetries || 3}}\n- lastError: {{lastError}}\n- recoveryAnalysis: {{$ctx.getNodeOutput('analyze-error')?.output || ''}}\n\nUse the analysis to choose a different approach if the previous attempt failed.", + "timeoutMs": 3600000, + "failOnError": true, + "maxRetries": "{{maxRetries}}", + "retryDelayMs": 15000, + "continueOnError": true }, "position": { - "x": 420, - "y": 390 + "x": 200, + "y": 480 }, "outputs": [ "default" ] }, { - "id": "init-stuck-retry-count", - "type": "action.set_variable", - "label": "Initialize Stuck Retry Count", + "id": "retry-succeeded", + "type": "condition.expression", + "label": "Retry Succeeded?", "config": { - "key": "stuckRetryCount", - "value": "0", - "isExpression": true + "expression": "$ctx.getNodeOutput('retry-task')?.success === true" }, "position": { - "x": 420, - "y": 450 + "x": 200, + "y": 620 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "poll-task", - "type": "action.bosun_function", - "label": "Poll External Task State", + "id": "notify-recovered", + "type": "notify.log", + "label": "Log Recovery Success", "config": { - "function": "tasks.get", - "args": { - "taskId": "{{taskId}}" - }, - "outputVariable": "continuationTask" + "message": "Task {{taskId}} recovered automatically by error-recovery workflow", + "level": "info" }, "position": { - "x": 420, - "y": 500 + "x": 90, + "y": 760 }, "outputs": [ "default" ] }, { - "id": "derive-status", - "type": "action.set_variable", - "label": "Derive External Status", + "id": "escalate", + "type": "notify.telegram", + "label": "Escalate to Human", "config": { - "key": "currentExternalStatus", - "value": "String(($data?.continuationTask?.externalStatus ?? $data?.continuationTask?.status ?? '') || '').trim().toLowerCase()", - "isExpression": true + "message": ":alert: Task **{{taskTitle}}** failed after {{maxRetries}} attempts. Manual intervention needed.\n\nLast error: {{lastError}}\n\nRecovery analysis: {{$ctx.getNodeOutput('analyze-error')?.output || ''}}" }, "position": { - "x": 420, - "y": 610 + "x": 600, + "y": 620 }, "outputs": [ "default" ] }, { - "id": "terminal-check", - "type": "condition.expression", - "label": "Terminal State Reached?", + "id": "chain-repair", + "type": "action.execute_workflow", + "label": "Trigger Repair Workflow", "config": { - "expression": "(() => { const s = String($data?.currentExternalStatus || '').trim().toLowerCase(); const t = Array.isArray($data?.terminalStates) ? $data.terminalStates.map(v => String(v || '').trim().toLowerCase()).filter(Boolean) : []; return Boolean(s) && t.includes(s); })()" + "workflowId": "template-task-repair-worktree", + "mode": "dispatch", + "input": "(() => { const analysisRaw = String($ctx.getNodeOutput('analyze-error')?.output || '').trim(); const retryOutputRaw = String($ctx.getNodeOutput('retry-task')?.output || '').trim(); const retryErrorRaw = String($ctx.getNodeOutput('retry-task')?.error || '').trim(); const truncate = (value, limit = 2000) => value.length > limit ? `${value.slice(0, limit)}...` : value; const diagnostics = [String($data?.lastError || '').trim(), analysisRaw ? `Recovery analysis:\n${truncate(analysisRaw)}` : '', retryOutputRaw ? `Retry output:\n${truncate(retryOutputRaw)}` : '', retryErrorRaw ? `Retry error:\n${truncate(retryErrorRaw)}` : ''].filter(Boolean).join('\n\n'); return { taskId: $data?.taskId, taskTitle: $data?.taskTitle, worktreePath: $data?.worktreePath, branch: $data?.branch, baseBranch: $data?.baseBranch, error: diagnostics || String($data?.lastError || ''), recoveryAnalysis: truncate(analysisRaw), retryResult: { success: $ctx.getNodeOutput('retry-task')?.success === true, output: truncate(retryOutputRaw), error: truncate(retryErrorRaw) } }; })()" }, "position": { - "x": 420, - "y": 720 + "x": 400, + "y": 760 }, "outputs": [ - "yes", - "no" + "default" ] + } + ], + "edges": [ + { + "id": "trigger->check-retries", + "source": "trigger", + "target": "check-retries", + "sourcePort": "default" }, { - "id": "end-terminal", - "type": "flow.end", - "label": "End: Terminal State", - "config": { - "status": "completed", - "message": "Continuation loop completed: terminal external state '{{currentExternalStatus}}' reached for task {{taskId}}.", - "output": { - "reason": "terminal_state", - "taskId": "{{taskId}}", - "externalStatus": "{{currentExternalStatus}}" - } - }, - "position": { - "x": 160, - "y": 860 - }, - "outputs": [ - "default" - ] + "id": "check-retries->analyze-error", + "source": "check-retries", + "target": "analyze-error", + "sourcePort": "default", + "condition": "$output?.result === true" }, { - "id": "max-turns-check", - "type": "condition.expression", - "label": "Max Turns Reached?", - "config": { - "expression": "Number($data?.continuationTurn || 0) >= Number($data?.maxTurns || 0)" - }, - "position": { - "x": 620, - "y": 860 - }, - "outputs": [ - "yes", - "no" - ] + "id": "check-retries->escalate", + "source": "check-retries", + "target": "escalate", + "sourcePort": "default", + "condition": "$output?.result !== true" }, { - "id": "end-max-turns", - "type": "flow.end", - "label": "End: Max Turns", - "config": { - "status": "failed", - "message": "Continuation loop stopped after reaching maxTurns={{maxTurns}} for task {{taskId}}.", - "output": { - "reason": "max_turns", - "taskId": "{{taskId}}", - "turns": "{{continuationTurn}}" - } - }, - "position": { - "x": 460, - "y": 1000 - }, - "outputs": [ - "default" - ] + "id": "analyze-error->retry-task", + "source": "analyze-error", + "target": "retry-task", + "sourcePort": "default" }, { - "id": "run-agent", - "type": "action.run_agent", - "label": "Drive Agent", - "config": { - "prompt": "{{continuePrompt}}", - "taskId": "{{taskId}}", - "cwd": "{{worktreePath}}", - "sdk": "{{sdk}}", - "model": "{{model}}", - "timeoutMs": "{{timeoutMs}}", - "requireTaskPromptCompleteness": false, - "failOnError": false - }, - "position": { - "x": 800, - "y": 1000 - }, - "outputs": [ - "default" - ] + "id": "retry-task->retry-succeeded", + "source": "retry-task", + "target": "retry-succeeded", + "sourcePort": "default" }, { - "id": "capture-progress", - "type": "action.run_command", - "label": "Capture Progress Signature", + "id": "retry-succeeded->notify-recovered", + "source": "retry-succeeded", + "target": "notify-recovered", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "retry-succeeded->chain-repair", + "source": "retry-succeeded", + "target": "chain-repair", + "sourcePort": "no", + "condition": "$output?.result !== true" + }, + { + "id": "chain-repair->escalate", + "source": "chain-repair", + "target": "escalate", + "sourcePort": "default" + } + ] + }, + { + "id": "template-health-check", + "name": "Health Check", + "description": "Periodic system health check: validates config, verifies SDK availability, checks git state, and reports any issues found.", + "category": "reliability", + "categoryLabel": "Reliability", + "categoryIcon": ":shield:", + "categoryOrder": 5, + "tags": [ + "health", + "config", + "doctor", + "monitoring" + ], + "nodeCount": 7, + "edgeCount": 8, + "recommended": false, + "enabled": true, + "trigger": "trigger.schedule", + "variables": { + "intervalMs": 3600000 + }, + "metadata": { + "author": "bosun", + "version": 1, + "createdAt": "2025-02-25T00:00:00Z", + "templateVersion": "1.0.1", + "tags": [ + "health", + "config", + "doctor", + "monitoring" + ], + "replaces": { + "module": "config-doctor.mjs", + "functions": [ + "runConfigDoctor" + ], + "calledFrom": [ + "cli.mjs:doctor command" + ], + "description": "Replaces manual config-doctor runs with a scheduled health check workflow. Config validation, git state, and agent status checks run in parallel with automatic alerting." + } + }, + "nodes": [ + { + "id": "trigger", + "type": "trigger.schedule", + "label": "Hourly Health Check", "config": { - "command": "node -e \"const cp=require('node:child_process');const crypto=require('node:crypto');const head=(cp.execSync('git rev-parse HEAD',{encoding:'utf8'}).trim()||'');const dirtyRaw=cp.execSync('git status --porcelain=v1',{encoding:'utf8'});const dirtyCount=dirtyRaw.split(/\\r?\\n/).filter(Boolean).length;const statusDigest=crypto.createHash('sha1').update(dirtyRaw).digest('hex').slice(0,16);process.stdout.write(JSON.stringify({head,dirtyCount,statusDigest}));\"", - "cwd": "{{worktreePath}}", - "failOnError": false + "intervalMs": "{{intervalMs}}", + "cron": "0 * * * *" }, "position": { - "x": 800, - "y": 1120 + "x": 400, + "y": 50 }, "outputs": [ "default" ] }, { - "id": "derive-signature", - "type": "action.set_variable", - "label": "Derive Signature", + "id": "check-config", + "type": "action.bosun_cli", + "label": "Check Config", "config": { - "key": "currentProgressSignature", - "value": "(() => { const raw = String($ctx.getNodeOutput('capture-progress')?.output || '').trim(); try { const parsed = JSON.parse(raw); const head = String(parsed?.head || ''); const dirty = Number(parsed?.dirtyCount || 0); const statusDigest = String(parsed?.statusDigest || ''); return `${head}:${dirty}:${statusDigest}`; } catch { return ''; } })()", - "isExpression": true + "subcommand": "doctor", + "args": "--json" }, "position": { - "x": 800, - "y": 1240 + "x": 150, + "y": 200 }, "outputs": [ "default" ] }, { - "id": "derive-stuck-ms", - "type": "action.set_variable", - "label": "Derive Stuck Duration", + "id": "check-git", + "type": "action.run_command", + "label": "Check Git State", "config": { - "key": "stuckForMs", - "value": "Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))", - "isExpression": true + "command": "node -e \"const cp=require('node:child_process');const status=cp.execSync('git status --porcelain',{encoding:'utf8'});const wt=cp.execSync('git worktree list --porcelain',{encoding:'utf8'});const count=(wt.match(/^worktree /gm)||[]).length;process.stdout.write(status + (status.endsWith('\\\\n') ? '' : '\\\\n') + count + '\\\\n');\"", + "continueOnError": true }, "position": { - "x": 1080, - "y": 1230 + "x": 400, + "y": 200 }, "outputs": [ "default" ] }, { - "id": "progress-changed", - "type": "condition.expression", - "label": "Progress Changed?", + "id": "check-agents", + "type": "action.run_command", + "label": "Check Agent Status", "config": { - "expression": "String($data?.currentProgressSignature || '') !== String($data?.lastProgressSignature || '')" + "command": "node -e \"const cp=require('node:child_process');try{process.stdout.write(cp.execSync('bosun --daemon-status',{encoding:'utf8'}));}catch{process.stdout.write('daemon not running\\\\n');}\"", + "continueOnError": true }, "position": { - "x": 800, - "y": 1360 + "x": 650, + "y": 200 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "mark-progress-at", - "type": "action.set_variable", - "label": "Update Progress Clock", + "id": "has-issues", + "type": "condition.expression", + "label": "Any Issues?", "config": { - "key": "lastProgressAt", - "value": "(() => { const changed = String($data?.currentProgressSignature || '') !== String($data?.lastProgressSignature || ''); return changed ? Date.now() : Number($data?.lastProgressAt || 0); })()", - "isExpression": true + "expression": "($ctx.getNodeOutput('check-config')?.success === false) || (($ctx.getNodeOutput('check-config')?.output || '').includes('ERROR')) || (($ctx.getNodeOutput('check-config')?.output || '').includes('CRITICAL')) || ($ctx.getNodeOutput('check-git')?.success === false) || ($ctx.getNodeOutput('check-agents')?.success === false)" }, "position": { - "x": 680, - "y": 1490 + "x": 400, + "y": 380 }, "outputs": [ "default" ] }, { - "id": "mark-progress-sig", - "type": "action.set_variable", - "label": "Update Progress Signature", + "id": "alert", + "type": "notify.telegram", + "label": "Alert Issues Found", "config": { - "key": "lastProgressSignature", - "value": "$data?.currentProgressSignature || ''", - "isExpression": true + "message": ":heart: Health check found issues — run `bosun doctor` for details" }, "position": { - "x": 680, - "y": 1600 + "x": 200, + "y": 540 }, "outputs": [ "default" ] }, { - "id": "reset-stuck-retry-count", - "type": "action.set_variable", - "label": "Reset Stuck Retry Count On Progress", + "id": "all-ok", + "type": "notify.telegram", + "label": "All Healthy", "config": { - "key": "stuckRetryCount", - "value": "(() => { const changed = String($data?.currentProgressSignature || '') !== String($data?.lastProgressSignature || ''); return changed ? 0 : Number($data?.stuckRetryCount || 0); })()", - "isExpression": true + "message": "Health check passed — all systems operational", + "level": "info" }, "position": { - "x": 680, - "y": 1710 + "x": 600, + "y": 540 }, "outputs": [ "default" ] + } + ], + "edges": [ + { + "id": "trigger->check-config", + "source": "trigger", + "target": "check-config", + "sourcePort": "default" }, { - "id": "stuck-check", - "type": "condition.expression", - "label": "Session Stuck?", - "config": { - "expression": "(() => { const agentOutput = $ctx.getNodeOutput('run-agent') || {}; const normalizedOutput = String(agentOutput?.output || '').replace(/\\s+/g, ' ').trim().toLowerCase(); const placeholderOutput = normalizedOutput === 'continued' || normalizedOutput === 'model response continued' || normalizedOutput === '(agent completed with no text output)'; const streamCount = Array.isArray(agentOutput?.stream) ? agentOutput.stream.length : 0; const itemCount = Number(agentOutput?.itemCount || (Array.isArray(agentOutput?.items) ? agentOutput.items.length : 0) || 0); const meaningfulAgentActivity = streamCount > 0 || itemCount > 0 || (!!normalizedOutput && !placeholderOutput); const noProgressChange = String($data?.currentProgressSignature || '') === String($data?.lastProgressSignature || ''); if (noProgressChange && !meaningfulAgentActivity) return true; if (placeholderOutput && noProgressChange) return true; const lastProgressAt = Number($data?.lastProgressAt || 0); const stuckThresholdMs = Number($data?.stuckThresholdMs || 0); if (stuckThresholdMs <= 0) return noProgressChange; if (lastProgressAt <= 0) return false; return noProgressChange && (Date.now() - lastProgressAt) >= stuckThresholdMs; })()" - }, - "position": { - "x": 980, - "y": 1820 - }, - "outputs": [ - "yes", - "no" - ] + "id": "trigger->check-git", + "source": "trigger", + "target": "check-git", + "sourcePort": "default" }, { - "id": "emit-stuck", - "type": "action.emit_event", - "label": "Emit session-stuck", - "config": { - "eventType": "session-stuck", - "payload": { - "taskId": "{{taskId}}", - "turn": "{{continuationTurn}}", - "externalStatus": "{{currentExternalStatus}}", - "stuckThresholdMs": "{{stuckThresholdMs}}", - "stuckForMs": "{{stuckForMs}}", - "onStuck": "{{onStuck}}", - "stuckRetryCount": "{{stuckRetryCount}}", - "maxStuckAutoRetries": "{{maxStuckAutoRetries}}", - "lastProgressAt": "{{lastProgressAt}}", - "lastProgressSignature": "{{lastProgressSignature}}", - "currentProgressSignature": "{{currentProgressSignature}}", - "placeholderResponse": "{{(() => { const normalizedOutput = String($ctx.getNodeOutput('run-agent')?.output || '').replace(/\\s+/g, ' ').trim().toLowerCase(); return normalizedOutput === 'continued' || normalizedOutput === 'model response continued'; })()}}", - "agentActivityDetected": "{{(() => { const agentOutput = $ctx.getNodeOutput('run-agent') || {}; const normalizedOutput = String(agentOutput?.output || '').replace(/\\s+/g, ' ').trim().toLowerCase(); const placeholderOutput = normalizedOutput === 'continued' || normalizedOutput === 'model response continued' || normalizedOutput === '(agent completed with no text output)'; const streamCount = Array.isArray(agentOutput?.stream) ? agentOutput.stream.length : 0; const itemCount = Number(agentOutput?.itemCount || (Array.isArray(agentOutput?.items) ? agentOutput.items.length : 0) || 0); return streamCount > 0 || itemCount > 0 || (!!normalizedOutput && !placeholderOutput); })()}}", - "agentItemCount": "{{$ctx.getNodeOutput('run-agent')?.itemCount || (Array.isArray($ctx.getNodeOutput('run-agent')?.items) ? $ctx.getNodeOutput('run-agent')?.items.length : 0) || 0}}", - "agentStreamCount": "{{Array.isArray($ctx.getNodeOutput('run-agent')?.stream) ? $ctx.getNodeOutput('run-agent')?.stream.length : 0}}", - "progressSnapshot": "{{$ctx.getNodeOutput('capture-progress')?.output || ''}}", - "lastAgentSuccess": "{{$ctx.getNodeOutput('run-agent')?.success === true}}", - "lastAgentOutput": "{{$ctx.getNodeOutput('run-agent')?.output || ''}}" - }, - "outputVariable": "sessionStuckEvent" - }, - "position": { - "x": 980, - "y": 1600 - }, - "outputs": [ - "default" - ] + "id": "trigger->check-agents", + "source": "trigger", + "target": "check-agents", + "sourcePort": "default" }, { - "id": "stuck-route", - "type": "condition.switch", - "label": "Route onStuck Action", - "config": { - "value": "$data?.onStuck || 'escalate'", - "cases": { - "retry": "retry", - "escalate": "escalate", - "pause": "pause" - } - }, - "position": { - "x": 980, - "y": 1710 - }, - "outputs": [ - "retry", - "escalate", - "pause", - "default" - ] + "id": "check-config->has-issues", + "source": "check-config", + "target": "has-issues", + "sourcePort": "default" }, { - "id": "stuck-retry-budget", - "type": "condition.expression", - "label": "Stuck Retry Budget Remaining?", - "config": { - "expression": "Number($data?.stuckRetryCount || 0) < Number($data?.maxStuckAutoRetries || 0)" - }, - "position": { - "x": 760, - "y": 1820 - }, - "outputs": [ - "yes", - "no" - ] + "id": "check-git->has-issues", + "source": "check-git", + "target": "has-issues", + "sourcePort": "default" }, { - "id": "stuck-retry", - "type": "action.run_agent", - "label": "Retry After Stuck", + "id": "check-agents->has-issues", + "source": "check-agents", + "target": "has-issues", + "sourcePort": "default" + }, + { + "id": "has-issues->alert", + "source": "has-issues", + "target": "alert", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "has-issues->all-ok", + "source": "has-issues", + "target": "all-ok", + "sourcePort": "default", + "condition": "$output?.result !== true" + } + ] + }, + { + "id": "template-incident-response", + "name": "Incident Response", + "description": "Automated incident management: detects error spikes or anomalous patterns, creates an incident task, assigns an agent for investigation, collects evidence, and escalates via notification channels.", + "category": "reliability", + "categoryLabel": "Reliability", + "categoryIcon": ":shield:", + "categoryOrder": 5, + "tags": [ + "incident", + "response", + "detection", + "escalation", + "reliability" + ], + "nodeCount": 11, + "edgeCount": 12, + "recommended": true, + "enabled": true, + "trigger": "trigger.anomaly", + "variables": { + "errorThreshold": 5, + "escalationDelayMs": 600000, + "autoAssignAgent": true + }, + "metadata": { + "author": "bosun", + "version": 1, + "createdAt": "2025-02-25T00:00:00Z", + "templateVersion": "1.0.1", + "tags": [ + "incident", + "response", + "detection", + "escalation", + "reliability" + ], + "replaces": { + "module": "error-detector.mjs", + "functions": [ + "handleErrorSpike", + "escalateAnomaly" + ], + "calledFrom": [ + "anomaly-detector.mjs:onAnomaly" + ], + "description": "Replaces reactive error handling with a structured incident response workflow. Evidence collection, classification, task creation, and agent assignment become explicit, auditable steps." + } + }, + "nodes": [ + { + "id": "trigger", + "type": "trigger.anomaly", + "label": "Error Spike Detected", "config": { - "prompt": "{{retryPrompt}}\n\nStuck context:\n- taskId: {{taskId}}\n- externalStatus: {{currentExternalStatus}}\n- turn: {{continuationTurn}}\n- stuckRetryCount: {{stuckRetryCount}}/{{maxStuckAutoRetries}}\n- stuckForMs: {{Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))}}\n- lastProgressSignature: {{lastProgressSignature}}\n- currentProgressSignature: {{currentProgressSignature}}\n- progressSnapshot: {{$ctx.getNodeOutput('capture-progress')?.output || ''}}\n- lastAgentOutput: {{$ctx.getNodeOutput('run-agent')?.output || ''}}\n\nTry a materially different approach. If you cannot create progress, explain the specific blocker.", - "taskId": "{{taskId}}", - "cwd": "{{worktreePath}}", - "sdk": "{{sdk}}", - "model": "{{model}}", - "timeoutMs": "{{timeoutMs}}", - "requireTaskPromptCompleteness": false, - "failOnError": false + "anomalyTypes": [ + "error-spike", + "death-loop", + "agent-stall" + ], + "threshold": "{{errorThreshold}}" }, "position": { - "x": 760, - "y": 1830 + "x": 400, + "y": 50 }, "outputs": [ "default" ] }, { - "id": "increment-stuck-retry-count", - "type": "action.set_variable", - "label": "Increment Stuck Retry Count", + "id": "should-assign", + "type": "condition.expression", + "label": "Auto Assign Agent?", "config": { - "key": "stuckRetryCount", - "value": "Number($data?.stuckRetryCount || 0) + 1", - "isExpression": true + "expression": "Boolean($data?.autoAssignAgent !== false)" }, "position": { - "x": 760, - "y": 1940 + "x": 250, + "y": 690 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "stuck-escalate", - "type": "notify.log", - "label": "Escalate Stuck Session", + "id": "delay-escalation", + "type": "action.delay", + "label": "Escalation Delay", "config": { - "level": "warn", - "message": "session-stuck: escalation requested for task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}}, stuckForMs={{stuckForMs}}, stuckRetryCount={{stuckRetryCount}}/{{maxStuckAutoRetries}}, lastProgressSignature={{lastProgressSignature}}, currentProgressSignature={{currentProgressSignature}})" + "ms": "{{escalationDelayMs}}", + "reason": "Allowing automatic mitigation window before escalation" }, "position": { - "x": 980, - "y": 1830 + "x": 150, + "y": 620 }, "outputs": [ "default" ] }, { - "id": "stuck-escalate-budget", - "type": "notify.log", - "label": "Escalate Stuck Session (Retry Limit)", + "id": "collect-evidence", + "type": "agent.evidence_collect", + "label": "Collect Evidence", "config": { - "level": "warn", - "message": "session-stuck: retry budget exhausted for task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}}, stuckForMs={{stuckForMs}}, stuckRetryCount={{stuckRetryCount}}/{{maxStuckAutoRetries}}, lastProgressSignature={{lastProgressSignature}}, currentProgressSignature={{currentProgressSignature}})" + "sources": [ + "logs", + "git-status", + "process-list", + "recent-errors" + ], + "lookbackMinutes": 30 }, "position": { - "x": 760, - "y": 2050 + "x": 400, + "y": 200 }, "outputs": [ "default" ] }, { - "id": "stuck-pause", - "type": "notify.log", - "label": "Pause Stuck Session", + "id": "classify-incident", + "type": "action.run_agent", + "label": "Classify Incident", "config": { - "level": "warn", - "message": "session-stuck: paused task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}})" + "prompt": "# Incident Classification\n\nAnalyze the collected evidence:\n{{evidence}}\n\nClassify the incident:\n1. **SEVERITY**: critical / high / medium / low\n2. **CATEGORY**: agent-crash / build-failure / resource-exhaustion / stuck-process / unknown\n3. **ROOT CAUSE**: One-line hypothesis\n4. **IMPACT**: What is affected and who is impacted\n5. **RECOMMENDED ACTION**: Immediate steps to mitigate\n\nOutput as JSON: { \"severity\": \"...\", \"category\": \"...\", \"rootCause\": \"...\", \"impact\": \"...\", \"action\": \"...\" }", + "sdk": "auto", + "timeoutMs": 300000 }, "position": { - "x": 1200, - "y": 1830 + "x": 400, + "y": 370 }, "outputs": [ "default" ] }, { - "id": "end-escalated", - "type": "flow.end", - "label": "End: Escalated", + "id": "is-critical", + "type": "condition.expression", + "label": "Is Critical?", "config": { - "status": "failed", - "message": "Continuation loop escalated due to session-stuck for task {{taskId}}.", - "output": { - "reason": "stuck_escalated", - "taskId": "{{taskId}}", - "event": "{{sessionStuckEvent.eventType}}", - "stuckRetryCount": "{{stuckRetryCount}}", - "maxStuckAutoRetries": "{{maxStuckAutoRetries}}" - } + "expression": "($ctx.getNodeOutput('classify-incident')?.output || '').includes('\"severity\": \"critical\"') || ($ctx.getNodeOutput('classify-incident')?.output || '').includes('\"severity\":\"critical\"')" }, "position": { - "x": 980, - "y": 1950 + "x": 400, + "y": 540 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "end-paused", - "type": "flow.end", - "label": "End: Paused", + "id": "create-incident-task", + "type": "action.create_task", + "label": "Create Incident Task", "config": { - "status": "completed", - "message": "Continuation loop paused due to session-stuck for task {{taskId}}.", - "output": { - "reason": "stuck_paused", - "taskId": "{{taskId}}", - "event": "{{sessionStuckEvent.eventType}}" - } + "title": ":alert: Incident: {{incidentCategory}}", + "description": "Auto-detected incident.\n\nEvidence: {{evidence}}\n\nClassification: {{classification}}", + "tags": [ + "incident", + "auto-detected" + ], + "priority": "high" }, "position": { - "x": 1200, - "y": 1950 + "x": 400, + "y": 690 }, "outputs": [ "default" ] }, { - "id": "wait-next-turn", - "type": "action.delay", - "label": "Wait Poll Interval", + "id": "assign-agent", + "type": "action.run_agent", + "label": "Investigate & Mitigate", "config": { - "ms": "{{pollIntervalMs}}", - "reason": "Waiting before next external status poll" + "prompt": "# Incident Investigation\n\nAn incident has been detected and classified:\n{{classification}}\n\nEvidence collected:\n{{evidence}}\n\nYour task:\n1. Investigate the root cause in detail\n2. Apply immediate mitigation if safe to do so\n3. Document what you find and what you changed\n4. If you cannot resolve it, document what you know for human review\n\nBe conservative — prefer safe mitigations over aggressive fixes.", + "sdk": "auto", + "timeoutMs": 1800000 }, "position": { - "x": 760, - "y": 1950 + "x": 250, + "y": 840 }, "outputs": [ "default" ] }, { - "id": "increment-turn", - "type": "action.set_variable", - "label": "Increment Turn", + "id": "alert-critical", + "type": "notify.telegram", + "label": "Critical Incident Alert", "config": { - "key": "continuationTurn", - "value": "Number($data?.continuationTurn || 0) + 1", - "isExpression": true + "message": ":alert: **CRITICAL INCIDENT**\n\nCategory: {{incidentCategory}}\nRoot cause: {{rootCause}}\n\nAgent investigating. Immediate attention may be required." }, "position": { - "x": 760, - "y": 2060 + "x": 150, + "y": 540 }, "outputs": [ "default" ] }, { - "id": "wait-next-turn-no-stuck", - "type": "action.delay", - "label": "Wait (No Stuck)", + "id": "alert-standard", + "type": "notify.log", + "label": "Log Incident", "config": { - "ms": "{{pollIntervalMs}}", - "reason": "Waiting before next external status poll" + "message": "Incident detected (non-critical): {{incidentCategory}} — agent assigned", + "level": "warn" }, "position": { - "x": 1080, - "y": 1950 + "x": 600, + "y": 690 }, "outputs": [ "default" ] }, { - "id": "increment-turn-no-stuck", - "type": "action.set_variable", - "label": "Increment Turn (No Stuck)", + "id": "resolution-log", + "type": "notify.log", + "label": "Log Resolution", "config": { - "key": "continuationTurn", - "value": "Number($data?.continuationTurn || 0) + 1", - "isExpression": true + "message": "Incident response complete — see task for details", + "level": "info" }, "position": { - "x": 1080, - "y": 2060 + "x": 400, + "y": 990 }, "outputs": [ "default" @@ -11713,423 +10802,597 @@ ], "edges": [ { - "id": "trigger->init-turn", + "id": "trigger->collect-evidence", "source": "trigger", - "target": "init-turn", - "sourcePort": "default" - }, - { - "id": "init-turn->init-progress-at", - "source": "init-turn", - "target": "init-progress-at", - "sourcePort": "default" - }, - { - "id": "init-progress-at->init-signature", - "source": "init-progress-at", - "target": "init-signature", - "sourcePort": "default" - }, - { - "id": "init-signature->init-stuck-retry-count", - "source": "init-signature", - "target": "init-stuck-retry-count", - "sourcePort": "default" - }, - { - "id": "init-stuck-retry-count->poll-task", - "source": "init-stuck-retry-count", - "target": "poll-task", + "target": "collect-evidence", "sourcePort": "default" }, { - "id": "poll-task->derive-status", - "source": "poll-task", - "target": "derive-status", + "id": "collect-evidence->classify-incident", + "source": "collect-evidence", + "target": "classify-incident", "sourcePort": "default" }, { - "id": "derive-status->terminal-check", - "source": "derive-status", - "target": "terminal-check", + "id": "classify-incident->is-critical", + "source": "classify-incident", + "target": "is-critical", "sourcePort": "default" }, { - "id": "terminal-check->end-terminal", - "source": "terminal-check", - "target": "end-terminal", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "terminal-check->max-turns-check", - "source": "terminal-check", - "target": "max-turns-check", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "max-turns-check->end-max-turns", - "source": "max-turns-check", - "target": "end-max-turns", + "id": "is-critical->delay-escalation", + "source": "is-critical", + "target": "delay-escalation", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "max-turns-check->run-agent", - "source": "max-turns-check", - "target": "run-agent", + "id": "is-critical->create-incident-task", + "source": "is-critical", + "target": "create-incident-task", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "run-agent->capture-progress", - "source": "run-agent", - "target": "capture-progress", - "sourcePort": "default" - }, - { - "id": "capture-progress->derive-signature", - "source": "capture-progress", - "target": "derive-signature", - "sourcePort": "default" - }, - { - "id": "derive-signature->derive-stuck-ms", - "source": "derive-signature", - "target": "derive-stuck-ms", - "sourcePort": "default" - }, - { - "id": "derive-stuck-ms->progress-changed", - "source": "derive-stuck-ms", - "target": "progress-changed", - "sourcePort": "default" - }, - { - "id": "progress-changed->mark-progress-at", - "source": "progress-changed", - "target": "mark-progress-at", + "id": "delay-escalation->alert-critical", + "source": "delay-escalation", + "target": "alert-critical", "sourcePort": "default" }, { - "id": "mark-progress-at->mark-progress-sig", - "source": "mark-progress-at", - "target": "mark-progress-sig", + "id": "alert-critical->create-incident-task", + "source": "alert-critical", + "target": "create-incident-task", "sourcePort": "default" }, { - "id": "mark-progress-sig->reset-stuck-retry-count", - "source": "mark-progress-sig", - "target": "reset-stuck-retry-count", + "id": "create-incident-task->alert-standard", + "source": "create-incident-task", + "target": "alert-standard", "sourcePort": "default" }, { - "id": "reset-stuck-retry-count->stuck-check", - "source": "reset-stuck-retry-count", - "target": "stuck-check", + "id": "create-incident-task->should-assign", + "source": "create-incident-task", + "target": "should-assign", "sourcePort": "default" }, { - "id": "stuck-check->emit-stuck", - "source": "stuck-check", - "target": "emit-stuck", + "id": "should-assign->assign-agent", + "source": "should-assign", + "target": "assign-agent", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "stuck-check->wait-next-turn-no-stuck", - "source": "stuck-check", - "target": "wait-next-turn-no-stuck", + "id": "should-assign->resolution-log", + "source": "should-assign", + "target": "resolution-log", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "emit-stuck->stuck-route", - "source": "emit-stuck", - "target": "stuck-route", + "id": "assign-agent->resolution-log", + "source": "assign-agent", + "target": "resolution-log", "sourcePort": "default" - }, + } + ] + }, + { + "id": "template-sync-engine", + "name": "Kanban Sync Engine", + "description": "Two-way synchronisation between internal task store and external kanban backends (GitHub Issues, Jira). Pulls new/changed tasks from the external board, pushes internal status updates outward, detects conflicts, and handles rate-limit back-off.", + "category": "reliability", + "categoryLabel": "Reliability", + "categoryIcon": ":shield:", + "categoryOrder": 5, + "tags": [ + "sync", + "kanban", + "github", + "jira", + "bidirectional" + ], + "nodeCount": 12, + "edgeCount": 14, + "recommended": true, + "enabled": true, + "trigger": "trigger.event", + "variables": { + "syncPolicy": "internal-primary", + "syncIntervalMs": 60000, + "failureAlertThreshold": 3, + "rateLimitAlertThreshold": 3, + "backoffIntervalMs": 300000, + "backoffThreshold": 5 + }, + "metadata": { + "author": "bosun", + "version": 1, + "createdAt": "2025-06-01T00:00:00Z", + "templateVersion": "1.0.1", + "tags": [ + "sync", + "kanban", + "github", + "jira", + "bidirectional" + ], + "replaces": { + "module": "sync-engine.mjs", + "functions": [ + "SyncEngine.pullFromExternal", + "SyncEngine.pushToExternal", + "SyncEngine.sync" + ], + "calledFrom": [ + "monitor.mjs:initSyncEngine", + "sync-engine.mjs:SyncEngine.start" + ], + "description": "Replaces the SyncEngine class lifecycle with a workflow. Pull/push/rate-limit steps become visible, auditable nodes. Event-driven triggers replace the fixed-interval timer, and failure alerting is built into the flow." + } + }, + "nodes": [ { - "id": "stuck-route->stuck-retry-budget", - "source": "stuck-route", - "target": "stuck-retry-budget", - "sourcePort": "retry" + "id": "trigger", + "type": "trigger.event", + "label": "Sync Trigger", + "config": { + "eventType": "sync.requested", + "description": "Fires on task status changes, startup, or periodic heartbeat", + "intervalMs": "{{syncIntervalMs}}" + }, + "position": { + "x": 400, + "y": 50 + }, + "outputs": [ + "default" + ] }, { - "id": "stuck-route->stuck-escalate", - "source": "stuck-route", - "target": "stuck-escalate", - "sourcePort": "escalate" + "id": "pull-external", + "type": "action.run_command", + "label": "Pull from External", + "config": { + "command": "node -e \"const {createSyncEngine} = await import('./sync-engine.mjs'); const engine = createSyncEngine({projectId: '{{projectId}}'}); const result = await engine.pullFromExternal(); console.log(JSON.stringify(result));\" ", + "timeoutMs": 120000, + "continueOnError": true + }, + "position": { + "x": 200, + "y": 200 + }, + "outputs": [ + "default" + ] }, { - "id": "stuck-route->stuck-pause", - "source": "stuck-route", - "target": "stuck-pause", - "sourcePort": "pause" + "id": "pull-ok", + "type": "condition.expression", + "label": "Pull Succeeded?", + "config": { + "expression": "(() => { const out = $ctx.getNodeOutput('pull-external'); return out?.success !== false && (!out?.errors || out.errors.length === 0); })()" + }, + "position": { + "x": 200, + "y": 380 + }, + "outputs": [ + "yes", + "no" + ] }, { - "id": "stuck-route->stuck-escalate", - "source": "stuck-route", - "target": "stuck-escalate", + "id": "push-internal", + "type": "action.run_command", + "label": "Push to External", + "config": { + "command": "node -e \"const {createSyncEngine} = await import('./sync-engine.mjs'); const engine = createSyncEngine({projectId: '{{projectId}}'}); const result = await engine.pushToExternal(); console.log(JSON.stringify(result));\" ", + "timeoutMs": 120000, + "continueOnError": true + }, + "position": { + "x": 200, + "y": 530 + }, + "outputs": [ + "default" + ] + }, + { + "id": "push-ok", + "type": "condition.expression", + "label": "Push Succeeded?", + "config": { + "expression": "(() => { const out = $ctx.getNodeOutput('push-internal'); return out?.success !== false && (!out?.errors || out.errors.length === 0); })()" + }, + "position": { + "x": 200, + "y": 700 + }, + "outputs": [ + "yes", + "no" + ] + }, + { + "id": "check-rate-limit", + "type": "condition.expression", + "label": "Rate Limited?", + "config": { + "expression": "(() => { const pull = $ctx.getNodeOutput('pull-external'); const push = $ctx.getNodeOutput('push-internal'); const allErrors = [...(pull?.errors || []), ...(push?.errors || [])]; const rateLimitHits = allErrors.filter(e => /rate.limit|429|throttl/i.test(String(e))).length; return rateLimitHits >= ($data?.rateLimitAlertThreshold || 3); })()" + }, + "position": { + "x": 500, + "y": 700 + }, + "outputs": [ + "yes", + "no" + ] + }, + { + "id": "handle-rate-limit", + "type": "action.handle_rate_limit", + "label": "Back-off & Retry", + "config": { + "delayMs": "{{backoffIntervalMs}}", + "maxRetries": "{{backoffThreshold}}", + "reason": "External kanban rate limit hit during sync" + }, + "position": { + "x": 700, + "y": 700 + }, + "outputs": [ + "default" + ] + }, + { + "id": "count-failures", + "type": "action.set_variable", + "label": "Track Consecutive Failures", + "config": { + "key": "consecutiveFailures", + "value": "(() => { const prev = Number($data?.consecutiveFailures || 0); return prev + 1; })()", + "isExpression": true + }, + "position": { + "x": 500, + "y": 380 + }, + "outputs": [ + "default" + ] + }, + { + "id": "should-alert", + "type": "condition.expression", + "label": "Alert Threshold?", + "config": { + "expression": "Number($data?.consecutiveFailures || 0) >= Number($data?.failureAlertThreshold || 3)" + }, + "position": { + "x": 500, + "y": 530 + }, + "outputs": [ + "yes", + "no" + ] + }, + { + "id": "alert-failures", + "type": "notify.telegram", + "label": "Sync Failure Alert", + "config": { + "message": ":warning: Kanban sync has failed **{{consecutiveFailures}}** consecutive times.\nPolicy: {{syncPolicy}}\nLast errors: {{lastSyncErrors}}" + }, + "position": { + "x": 700, + "y": 530 + }, + "outputs": [ + "default" + ] + }, + { + "id": "log-success", + "type": "notify.log", + "label": "Log Sync Success", + "config": { + "message": "Kanban sync complete — pulled: {{pullCount}}, pushed: {{pushCount}}, conflicts: {{conflictCount}}", + "level": "info" + }, + "position": { + "x": 200, + "y": 880 + }, + "outputs": [ + "default" + ] + }, + { + "id": "log-partial", + "type": "notify.log", + "label": "Log Partial Sync", + "config": { + "message": "Kanban sync partial — some operations failed. Errors: {{lastSyncErrors}}", + "level": "warn" + }, + "position": { + "x": 500, + "y": 880 + }, + "outputs": [ + "default" + ] + } + ], + "edges": [ + { + "id": "trigger->pull-external", + "source": "trigger", + "target": "pull-external", "sourcePort": "default" }, { - "id": "stuck-retry-budget->stuck-retry", - "source": "stuck-retry-budget", - "target": "stuck-retry", + "id": "pull-external->pull-ok", + "source": "pull-external", + "target": "pull-ok", + "sourcePort": "default" + }, + { + "id": "pull-ok->push-internal", + "source": "pull-ok", + "target": "push-internal", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "stuck-retry-budget->stuck-escalate-budget", - "source": "stuck-retry-budget", - "target": "stuck-escalate-budget", + "id": "pull-ok->count-failures", + "source": "pull-ok", + "target": "count-failures", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "stuck-retry->increment-stuck-retry-count", - "source": "stuck-retry", - "target": "increment-stuck-retry-count", + "id": "push-internal->push-ok", + "source": "push-internal", + "target": "push-ok", "sourcePort": "default" }, { - "id": "increment-stuck-retry-count->wait-next-turn", - "source": "increment-stuck-retry-count", - "target": "wait-next-turn", - "sourcePort": "default" + "id": "push-ok->check-rate-limit", + "source": "push-ok", + "target": "check-rate-limit", + "sourcePort": "no", + "condition": "$output?.result !== true" }, { - "id": "stuck-escalate->end-escalated", - "source": "stuck-escalate", - "target": "end-escalated", - "sourcePort": "default" + "id": "push-ok->log-success", + "source": "push-ok", + "target": "log-success", + "sourcePort": "yes", + "condition": "$output?.result === true" }, { - "id": "stuck-escalate-budget->end-escalated", - "source": "stuck-escalate-budget", - "target": "end-escalated", - "sourcePort": "default" + "id": "check-rate-limit->handle-rate-limit", + "source": "check-rate-limit", + "target": "handle-rate-limit", + "sourcePort": "yes", + "condition": "$output?.result === true" }, { - "id": "stuck-pause->end-paused", - "source": "stuck-pause", - "target": "end-paused", - "sourcePort": "default" + "id": "check-rate-limit->count-failures", + "source": "check-rate-limit", + "target": "count-failures", + "sourcePort": "no", + "condition": "$output?.result !== true" }, { - "id": "wait-next-turn->increment-turn", - "source": "wait-next-turn", - "target": "increment-turn", + "id": "handle-rate-limit->log-partial", + "source": "handle-rate-limit", + "target": "log-partial", "sourcePort": "default" }, { - "id": "wait-next-turn-no-stuck->increment-turn-no-stuck", - "source": "wait-next-turn-no-stuck", - "target": "increment-turn-no-stuck", + "id": "count-failures->should-alert", + "source": "count-failures", + "target": "should-alert", "sourcePort": "default" }, { - "id": "increment-turn->poll-task", - "source": "increment-turn", - "target": "poll-task", - "sourcePort": "default", - "backEdge": true, - "maxIterations": 500 + "id": "should-alert->alert-failures", + "source": "should-alert", + "target": "alert-failures", + "sourcePort": "yes", + "condition": "$output?.result === true" }, { - "id": "increment-turn-no-stuck->poll-task", - "source": "increment-turn-no-stuck", - "target": "poll-task", - "sourcePort": "default", - "backEdge": true, - "maxIterations": 500 + "id": "should-alert->log-partial", + "source": "should-alert", + "target": "log-partial", + "sourcePort": "no", + "condition": "$output?.result !== true" + }, + { + "id": "alert-failures->log-partial", + "source": "alert-failures", + "target": "log-partial", + "sourcePort": "default" } ] }, { - "id": "template-continuation-loop-manual", - "name": "Continuation Loop (Manual)", - "description": "Issue-state continuation loop for a specific task. Provide taskId and worktreePath at install time. Drives the agent until a terminal state or max turns, and handles stuck sessions with retry/escalate/pause.", + "id": "template-task-archiver", + "name": "Task Archiver", + "description": "Automated archival of completed tasks — migrates old completed/cancelled tasks to local archives, cleans up agent sessions, prunes archives beyond retention, and optionally chains into Sprint Retrospective.", "category": "reliability", "categoryLabel": "Reliability", "categoryIcon": ":shield:", "categoryOrder": 5, "tags": [ - "continuation", - "loop", - "linear", - "external-status", - "stuck-detection", - "manual" + "archive", + "cleanup", + "task", + "maintenance", + "reliability" ], - "nodeCount": 34, - "edgeCount": 37, - "recommended": false, + "nodeCount": 11, + "edgeCount": 11, + "recommended": true, "enabled": true, - "trigger": "trigger.manual", + "trigger": "trigger.event", "variables": { - "taskId": "", - "worktreePath": "", - "maxTurns": 8, - "pollIntervalMs": 30000, - "terminalStates": [ - "done", - "cancelled" - ], - "stuckThresholdMs": 300000, - "maxStuckAutoRetries": 1, - "onStuck": "escalate", - "continuePrompt": "Continue this task from the current state. Focus on the next missing step and push toward completion.", - "retryPrompt": "No progress was detected recently. Try a different approach and make concrete progress (commit or file updates).", - "sdk": "auto", - "model": "", - "timeoutMs": 1800000 + "ageHours": 24, + "maxArchivePerSweep": 50, + "retentionDays": 90, + "pruneEnabled": true, + "dryRun": false }, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2026-03-10T00:00:00Z", - "templateVersion": "1.3.0", + "createdAt": "2025-06-01T00:00:00Z", + "templateVersion": "1.0.1", "tags": [ - "continuation", - "loop", - "linear", - "external-status", - "stuck-detection", - "manual" + "archive", + "cleanup", + "task", + "maintenance", + "reliability" ], - "configType": "continuation-loop" + "replaces": { + "module": "task-archiver.mjs", + "functions": [ + "archiveCompletedTasks", + "archiveTaskToFile", + "cleanupAgentSessions", + "pruneOldArchives", + "deleteTaskFromVK" + ], + "calledFrom": [ + "monitor.mjs:startup", + "monitor.mjs:safeSetInterval(archiveCompletedTasks)" + ], + "description": "Replaces the monolithic archiveCompletedTasks sweep with an event-driven workflow. Each task completion fires the archiver instead of a periodic cron sweep, enabling per-task auditing and eliminating batch-scan overhead." + } }, "nodes": [ { "id": "trigger", - "type": "trigger.manual", - "label": "Start Continuation Loop", - "config": {}, - "position": { - "x": 420, - "y": 60 - }, - "outputs": [ - "default" - ] - }, - { - "id": "init-turn", - "type": "action.set_variable", - "label": "Initialize Turn Counter", + "type": "trigger.event", + "label": "Task Completed", "config": { - "key": "continuationTurn", - "value": "0", - "isExpression": true + "eventType": "task.status_changed", + "filter": "($event?.newStatus === 'done' || $event?.newStatus === 'cancelled')" }, "position": { - "x": 420, - "y": 170 + "x": 400, + "y": 50 }, "outputs": [ "default" ] }, { - "id": "init-progress-at", - "type": "action.set_variable", - "label": "Initialize Progress Clock", + "id": "check-age", + "type": "condition.expression", + "label": "Old Enough to Archive?", "config": { - "key": "lastProgressAt", - "value": "Date.now()", - "isExpression": true + "expression": "(() => { const completedAt = new Date($data?.completedAt || $data?.updatedAt || 0); if (isNaN(completedAt.getTime())) return false; const ageHours = (Date.now() - completedAt.getTime()) / (1000 * 60 * 60); return ageHours >= ($data?.ageHours || 24); })()" }, "position": { - "x": 420, - "y": 280 + "x": 400, + "y": 200 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "init-signature", - "type": "action.set_variable", - "label": "Initialize Progress Signature", + "id": "check-already-archived", + "type": "condition.expression", + "label": "Already Archived?", "config": { - "key": "lastProgressSignature", - "value": "''", - "isExpression": true + "expression": "$data?.alreadyArchived === true" }, "position": { - "x": 420, - "y": 390 + "x": 400, + "y": 350 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "init-stuck-retry-count", - "type": "action.set_variable", - "label": "Initialize Stuck Retry Count", + "id": "archive-to-file", + "type": "action.run_command", + "label": "Archive to Daily File", "config": { - "key": "stuckRetryCount", - "value": "0", - "isExpression": true + "command": "node -e \"const {archiveTaskToFile} = await import('./task-archiver.mjs'); const result = await archiveTaskToFile(JSON.parse(process.env.TASK_JSON)); console.log(JSON.stringify({success: !!result, path: result}));\" ", + "env": { + "TASK_JSON": "{{taskJson}}", + "MAX_PER_SWEEP": "{{maxArchivePerSweep}}", + "DRY_RUN": "{{dryRun}}" + }, + "continueOnError": true }, "position": { - "x": 420, - "y": 450 + "x": 200, + "y": 500 }, "outputs": [ "default" ] }, { - "id": "poll-task", - "type": "action.bosun_function", - "label": "Poll External Task State", + "id": "cleanup-sessions", + "type": "action.run_command", + "label": "Cleanup Agent Sessions", "config": { - "function": "tasks.get", - "args": { - "taskId": "{{taskId}}" - }, - "outputVariable": "continuationTask" + "command": "node -e \"const {cleanupAgentSessions} = await import('./task-archiver.mjs'); const count = await cleanupAgentSessions('{{taskId}}', '{{attemptId}}'); console.log(JSON.stringify({cleaned: count}));\" ", + "continueOnError": true }, "position": { - "x": 420, - "y": 500 + "x": 200, + "y": 650 }, "outputs": [ "default" ] }, { - "id": "derive-status", - "type": "action.set_variable", - "label": "Derive External Status", + "id": "delete-from-backend", + "type": "action.run_command", + "label": "Delete from Backend", "config": { - "key": "currentExternalStatus", - "value": "String(($data?.continuationTask?.externalStatus ?? $data?.continuationTask?.status ?? '') || '').trim().toLowerCase()", - "isExpression": true + "command": "node -e \"const {deleteTaskFromVK} = await import('./task-archiver.mjs'); const ok = await deleteTaskFromVK(null, '{{taskId}}'); console.log(JSON.stringify({deleted: ok}));\" ", + "continueOnError": true }, "position": { - "x": 420, - "y": 610 + "x": 200, + "y": 800 }, "outputs": [ "default" ] }, { - "id": "terminal-check", + "id": "should-prune", "type": "condition.expression", - "label": "Terminal State Reached?", + "label": "Prune Old Archives?", "config": { - "expression": "(() => { const s = String($data?.currentExternalStatus || '').trim().toLowerCase(); const t = Array.isArray($data?.terminalStates) ? $data.terminalStates.map(v => String(v || '').trim().toLowerCase()).filter(Boolean) : []; return Boolean(s) && t.includes(s); })()" + "expression": "Boolean($data?.pruneEnabled !== false)" }, "position": { - "x": 420, - "y": 720 + "x": 500, + "y": 800 }, "outputs": [ "yes", @@ -12137,213 +11400,308 @@ ] }, { - "id": "end-terminal", - "type": "flow.end", - "label": "End: Terminal State", + "id": "prune-archives", + "type": "action.run_command", + "label": "Prune Expired Archives", "config": { - "status": "completed", - "message": "Continuation loop completed: terminal external state '{{currentExternalStatus}}' reached for task {{taskId}}.", - "output": { - "reason": "terminal_state", - "taskId": "{{taskId}}", - "externalStatus": "{{currentExternalStatus}}" - } + "command": "node -e \"const {pruneOldArchives} = await import('./task-archiver.mjs'); const count = await pruneOldArchives({retentionDays: {{retentionDays}}}); console.log(JSON.stringify({pruned: count}));\" ", + "continueOnError": true }, "position": { - "x": 160, - "y": 860 + "x": 500, + "y": 950 }, "outputs": [ "default" ] }, { - "id": "max-turns-check", - "type": "condition.expression", - "label": "Max Turns Reached?", + "id": "log-result", + "type": "notify.log", + "label": "Log Archive Result", "config": { - "expression": "Number($data?.continuationTurn || 0) >= Number($data?.maxTurns || 0)" + "message": "Task {{taskId}} archived successfully. Sessions cleaned, backend updated.", + "level": "info" }, "position": { - "x": 620, - "y": 860 + "x": 400, + "y": 1100 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "end-max-turns", - "type": "flow.end", - "label": "End: Max Turns", + "id": "skip-log", + "type": "notify.log", + "label": "Skip — Not Ready", "config": { - "status": "failed", - "message": "Continuation loop stopped after reaching maxTurns={{maxTurns}} for task {{taskId}}.", - "output": { - "reason": "max_turns", - "taskId": "{{taskId}}", - "turns": "{{continuationTurn}}" - } + "message": "Task {{taskId}} not yet old enough to archive (threshold: {{ageHours}}h)", + "level": "debug" }, "position": { - "x": 460, - "y": 1000 + "x": 600, + "y": 350 }, "outputs": [ "default" ] }, { - "id": "run-agent", - "type": "action.run_agent", - "label": "Drive Agent", + "id": "already-archived-log", + "type": "notify.log", + "label": "Already Archived", "config": { - "prompt": "{{continuePrompt}}", - "taskId": "{{taskId}}", - "cwd": "{{worktreePath}}", - "sdk": "{{sdk}}", - "model": "{{model}}", - "timeoutMs": "{{timeoutMs}}", - "requireTaskPromptCompleteness": false, - "failOnError": false + "message": "Task {{taskId}} was already archived — skipping", + "level": "debug" }, "position": { - "x": 800, - "y": 1000 + "x": 600, + "y": 500 }, "outputs": [ "default" ] + } + ], + "edges": [ + { + "id": "trigger->check-age", + "source": "trigger", + "target": "check-age", + "sourcePort": "default" }, { - "id": "capture-progress", - "type": "action.run_command", - "label": "Capture Progress Signature", - "config": { - "command": "node -e \"const cp=require('node:child_process');const crypto=require('node:crypto');const head=(cp.execSync('git rev-parse HEAD',{encoding:'utf8'}).trim()||'');const dirtyRaw=cp.execSync('git status --porcelain=v1',{encoding:'utf8'});const dirtyCount=dirtyRaw.split(/\\r?\\n/).filter(Boolean).length;const statusDigest=crypto.createHash('sha1').update(dirtyRaw).digest('hex').slice(0,16);process.stdout.write(JSON.stringify({head,dirtyCount,statusDigest}));\"", - "cwd": "{{worktreePath}}", - "failOnError": false - }, - "position": { - "x": 800, - "y": 1120 - }, - "outputs": [ - "default" - ] + "id": "check-age->check-already-archived", + "source": "check-age", + "target": "check-already-archived", + "sourcePort": "yes", + "condition": "$output?.result === true" }, { - "id": "derive-signature", - "type": "action.set_variable", - "label": "Derive Signature", + "id": "check-age->skip-log", + "source": "check-age", + "target": "skip-log", + "sourcePort": "no", + "condition": "$output?.result !== true" + }, + { + "id": "check-already-archived->already-archived-log", + "source": "check-already-archived", + "target": "already-archived-log", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "check-already-archived->archive-to-file", + "source": "check-already-archived", + "target": "archive-to-file", + "sourcePort": "no", + "condition": "$output?.result !== true" + }, + { + "id": "archive-to-file->cleanup-sessions", + "source": "archive-to-file", + "target": "cleanup-sessions", + "sourcePort": "default" + }, + { + "id": "cleanup-sessions->delete-from-backend", + "source": "cleanup-sessions", + "target": "delete-from-backend", + "sourcePort": "default" + }, + { + "id": "delete-from-backend->should-prune", + "source": "delete-from-backend", + "target": "should-prune", + "sourcePort": "default" + }, + { + "id": "should-prune->prune-archives", + "source": "should-prune", + "target": "prune-archives", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "should-prune->log-result", + "source": "should-prune", + "target": "log-result", + "sourcePort": "no", + "condition": "$output?.result !== true" + }, + { + "id": "prune-archives->log-result", + "source": "prune-archives", + "target": "log-result", + "sourcePort": "default" + } + ] + }, + { + "id": "template-task-finalization-guard", + "name": "Task Finalization Guard", + "description": "Shared post-completion quality gate for all agents. Runs pre-push validation in the task worktree, normalizes status transitions, and hands off failures to a dedicated repair workflow.", + "category": "reliability", + "categoryLabel": "Reliability", + "categoryIcon": ":shield:", + "categoryOrder": 5, + "tags": [ + "finalization", + "quality-gate", + "prepush", + "handoff", + "reliability" + ], + "nodeCount": 18, + "edgeCount": 21, + "recommended": true, + "enabled": true, + "trigger": "trigger.event", + "variables": { + "finalizationTimeoutMs": 3600000, + "baseBranch": "main", + "finalizationCommand": "node -e \"const cp=require('node:child_process');const cmds=['npm run prepush --if-present','npm run prepush:check --if-present','npm run build','npm test','npm run lint --if-present'];for(const cmd of cmds){cp.execSync(cmd,{stdio:'inherit'});} \"" + }, + "metadata": { + "author": "bosun", + "version": 1, + "createdAt": "2026-02-26T00:00:00Z", + "templateVersion": "1.0.1", + "tags": [ + "finalization", + "quality-gate", + "prepush", + "handoff", + "reliability" + ], + "requiredTemplates": [ + "template-task-archiver", + "template-bosun-pr-progressor" + ], + "replaces": { + "module": "task-executor.mjs", + "functions": [ + "_handleTaskResult finalization gate" + ], + "calledFrom": [ + "task-executor.mjs:_handleTaskResult" + ], + "description": "Adds a shared post-completion finalization workflow so task quality checks and status transitions are consistent across all agents." + } + }, + "nodes": [ + { + "id": "trigger", + "type": "trigger.event", + "label": "Task Completed", "config": { - "key": "currentProgressSignature", - "value": "(() => { const raw = String($ctx.getNodeOutput('capture-progress')?.output || '').trim(); try { const parsed = JSON.parse(raw); const head = String(parsed?.head || ''); const dirty = Number(parsed?.dirtyCount || 0); const statusDigest = String(parsed?.statusDigest || ''); return `${head}:${dirty}:${statusDigest}`; } catch { return ''; } })()", - "isExpression": true + "eventType": "task.completed" }, "position": { - "x": 800, - "y": 1240 + "x": 400, + "y": 50 }, "outputs": [ "default" ] }, { - "id": "derive-stuck-ms", - "type": "action.set_variable", - "label": "Derive Stuck Duration", + "id": "has-worktree", + "type": "condition.expression", + "label": "Worktree Context Available?", "config": { - "key": "stuckForMs", - "value": "Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))", - "isExpression": true + "expression": "Boolean($data?.worktreePath)" }, "position": { - "x": 1080, - "y": 1230 + "x": 400, + "y": 190 }, "outputs": [ "default" ] }, { - "id": "progress-changed", - "type": "condition.expression", - "label": "Progress Changed?", + "id": "run-finalization", + "type": "action.run_command", + "label": "Run Finalization Checks", "config": { - "expression": "String($data?.currentProgressSignature || '') !== String($data?.lastProgressSignature || '')" + "command": "{{finalizationCommand}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{finalizationTimeoutMs}}", + "continueOnError": true }, "position": { - "x": 800, - "y": 1360 + "x": 220, + "y": 330 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "mark-progress-at", - "type": "action.set_variable", - "label": "Update Progress Clock", + "id": "checks-passed", + "type": "condition.expression", + "label": "Checks Passed?", "config": { - "key": "lastProgressAt", - "value": "(() => { const changed = String($data?.currentProgressSignature || '') !== String($data?.lastProgressSignature || ''); return changed ? Date.now() : Number($data?.lastProgressAt || 0); })()", - "isExpression": true + "expression": "$ctx.getNodeOutput('run-finalization')?.success === true" }, "position": { - "x": 680, - "y": 1490 + "x": 220, + "y": 470 }, "outputs": [ "default" ] }, { - "id": "mark-progress-sig", - "type": "action.set_variable", - "label": "Update Progress Signature", + "id": "has-pr", + "type": "condition.expression", + "label": "Lifecycle Already Linked?", "config": { - "key": "lastProgressSignature", - "value": "$data?.currentProgressSignature || ''", - "isExpression": true + "expression": "Boolean($data?.prNumber || $data?.prUrl)" }, "position": { - "x": 680, - "y": 1600 + "x": 120, + "y": 620 }, "outputs": [ "default" ] }, { - "id": "reset-stuck-retry-count", - "type": "action.set_variable", - "label": "Reset Stuck Retry Count On Progress", + "id": "create-pr", + "type": "action.create_pr", + "label": "Handoff Lifecycle If Missing", "config": { - "key": "stuckRetryCount", - "value": "(() => { const changed = String($data?.currentProgressSignature || '') !== String($data?.lastProgressSignature || ''); return changed ? 0 : Number($data?.stuckRetryCount || 0); })()", - "isExpression": true + "title": "{{taskTitle}}", + "body": "Bosun-managed PR lifecycle handoff from task finalization guard for task {{taskId}}.", + "base": "{{baseBranch}}", + "branch": "{{branch}}", + "failOnError": true, + "maxRetries": 3, + "retryDelayMs": 15000, + "continueOnError": true }, "position": { - "x": 680, - "y": 1710 + "x": 120, + "y": 760 }, "outputs": [ "default" ] }, { - "id": "stuck-check", + "id": "create-pr-success", "type": "condition.expression", - "label": "Session Stuck?", + "label": "Lifecycle Handoff Recorded?", "config": { - "expression": "(() => { const agentOutput = $ctx.getNodeOutput('run-agent') || {}; const normalizedOutput = String(agentOutput?.output || '').replace(/\\s+/g, ' ').trim().toLowerCase(); const placeholderOutput = normalizedOutput === 'continued' || normalizedOutput === 'model response continued' || normalizedOutput === '(agent completed with no text output)'; const streamCount = Array.isArray(agentOutput?.stream) ? agentOutput.stream.length : 0; const itemCount = Number(agentOutput?.itemCount || (Array.isArray(agentOutput?.items) ? agentOutput.items.length : 0) || 0); const meaningfulAgentActivity = streamCount > 0 || itemCount > 0 || (!!normalizedOutput && !placeholderOutput); const noProgressChange = String($data?.currentProgressSignature || '') === String($data?.lastProgressSignature || ''); if (noProgressChange && !meaningfulAgentActivity) return true; if (placeholderOutput && noProgressChange) return true; const lastProgressAt = Number($data?.lastProgressAt || 0); const stuckThresholdMs = Number($data?.stuckThresholdMs || 0); if (stuckThresholdMs <= 0) return noProgressChange; if (lastProgressAt <= 0) return false; return noProgressChange && (Date.now() - lastProgressAt) >= stuckThresholdMs; })()" + "expression": "$ctx.getNodeOutput('create-pr')?.success === true" }, "position": { - "x": 980, - "y": 1820 + "x": 120, + "y": 830 }, "outputs": [ "yes", @@ -12351,272 +11709,223 @@ ] }, { - "id": "emit-stuck", - "type": "action.emit_event", - "label": "Emit session-stuck", + "id": "mark-inreview", + "type": "action.update_task_status", + "label": "Set In Review", "config": { - "eventType": "session-stuck", - "payload": { - "taskId": "{{taskId}}", - "turn": "{{continuationTurn}}", - "externalStatus": "{{currentExternalStatus}}", - "stuckThresholdMs": "{{stuckThresholdMs}}", - "stuckForMs": "{{stuckForMs}}", - "onStuck": "{{onStuck}}", - "stuckRetryCount": "{{stuckRetryCount}}", - "maxStuckAutoRetries": "{{maxStuckAutoRetries}}", - "lastProgressAt": "{{lastProgressAt}}", - "lastProgressSignature": "{{lastProgressSignature}}", - "currentProgressSignature": "{{currentProgressSignature}}", - "placeholderResponse": "{{(() => { const normalizedOutput = String($ctx.getNodeOutput('run-agent')?.output || '').replace(/\\s+/g, ' ').trim().toLowerCase(); return normalizedOutput === 'continued' || normalizedOutput === 'model response continued'; })()}}", - "agentActivityDetected": "{{(() => { const agentOutput = $ctx.getNodeOutput('run-agent') || {}; const normalizedOutput = String(agentOutput?.output || '').replace(/\\s+/g, ' ').trim().toLowerCase(); const placeholderOutput = normalizedOutput === 'continued' || normalizedOutput === 'model response continued' || normalizedOutput === '(agent completed with no text output)'; const streamCount = Array.isArray(agentOutput?.stream) ? agentOutput.stream.length : 0; const itemCount = Number(agentOutput?.itemCount || (Array.isArray(agentOutput?.items) ? agentOutput.items.length : 0) || 0); return streamCount > 0 || itemCount > 0 || (!!normalizedOutput && !placeholderOutput); })()}}", - "agentItemCount": "{{$ctx.getNodeOutput('run-agent')?.itemCount || (Array.isArray($ctx.getNodeOutput('run-agent')?.items) ? $ctx.getNodeOutput('run-agent')?.items.length : 0) || 0}}", - "agentStreamCount": "{{Array.isArray($ctx.getNodeOutput('run-agent')?.stream) ? $ctx.getNodeOutput('run-agent')?.stream.length : 0}}", - "progressSnapshot": "{{$ctx.getNodeOutput('capture-progress')?.output || ''}}", - "lastAgentSuccess": "{{$ctx.getNodeOutput('run-agent')?.success === true}}", - "lastAgentOutput": "{{$ctx.getNodeOutput('run-agent')?.output || ''}}" - }, - "outputVariable": "sessionStuckEvent" + "taskId": "{{taskId}}", + "status": "inreview", + "taskTitle": "{{taskTitle}}", + "workflowEvent": "task.finalization_passed", + "workflowData": { + "stage": "finalization", + "result": "passed", + "branch": "{{branch}}", + "worktreePath": "{{worktreePath}}", + "prNumber": "{{prNumber}}", + "prUrl": "{{prUrl}}" + } }, "position": { - "x": 980, - "y": 1600 + "x": 240, + "y": 900 }, "outputs": [ "default" ] }, { - "id": "stuck-route", - "type": "condition.switch", - "label": "Route onStuck Action", + "id": "handoff-pr-progressor", + "type": "action.execute_workflow", + "label": "Dispatch PR Progressor", "config": { - "value": "$data?.onStuck || 'escalate'", - "cases": { - "retry": "retry", - "escalate": "escalate", - "pause": "pause" + "workflowId": "template-bosun-pr-progressor", + "mode": "dispatch", + "input": { + "taskId": "{{taskId}}", + "taskTitle": "{{taskTitle}}", + "branch": "{{branch}}", + "baseBranch": "{{baseBranch}}", + "prNumber": "{{$data?.prNumber ?? $ctx.getNodeOutput('create-pr')?.prNumber ?? null}}", + "prUrl": "{{$data?.prUrl || $ctx.getNodeOutput('create-pr')?.prUrl || ''}}", + "repo": "{{$data?.repo || $data?.repoSlug || $data?.repository || $ctx.getNodeOutput('create-pr')?.repoSlug || ''}}" } }, "position": { - "x": 980, - "y": 1710 + "x": 240, + "y": 1040 }, "outputs": [ - "retry", - "escalate", - "pause", "default" ] }, { - "id": "stuck-retry-budget", - "type": "condition.expression", - "label": "Stuck Retry Budget Remaining?", + "id": "mark-todo-failed", + "type": "action.update_task_status", + "label": "Mark Todo (Checks Failed)", "config": { - "expression": "Number($data?.stuckRetryCount || 0) < Number($data?.maxStuckAutoRetries || 0)" + "taskId": "{{taskId}}", + "status": "todo", + "taskTitle": "{{taskTitle}}", + "workflowEvent": "task.finalization_failed", + "workflowData": { + "stage": "finalization", + "reason": "verification_failed", + "branch": "{{branch}}", + "worktreePath": "{{worktreePath}}", + "baseBranch": "{{baseBranch}}" + } }, "position": { - "x": 760, - "y": 1820 + "x": 480, + "y": 620 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "stuck-retry", - "type": "action.run_agent", - "label": "Retry After Stuck", + "id": "mark-todo-missing", + "type": "action.update_task_status", + "label": "Mark Todo (Missing Context)", "config": { - "prompt": "{{retryPrompt}}\n\nStuck context:\n- taskId: {{taskId}}\n- externalStatus: {{currentExternalStatus}}\n- turn: {{continuationTurn}}\n- stuckRetryCount: {{stuckRetryCount}}/{{maxStuckAutoRetries}}\n- stuckForMs: {{Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))}}\n- lastProgressSignature: {{lastProgressSignature}}\n- currentProgressSignature: {{currentProgressSignature}}\n- progressSnapshot: {{$ctx.getNodeOutput('capture-progress')?.output || ''}}\n- lastAgentOutput: {{$ctx.getNodeOutput('run-agent')?.output || ''}}\n\nTry a materially different approach. If you cannot create progress, explain the specific blocker.", "taskId": "{{taskId}}", - "cwd": "{{worktreePath}}", - "sdk": "{{sdk}}", - "model": "{{model}}", - "timeoutMs": "{{timeoutMs}}", - "requireTaskPromptCompleteness": false, - "failOnError": false + "status": "todo", + "taskTitle": "{{taskTitle}}", + "workflowEvent": "task.finalization_failed", + "workflowData": { + "stage": "finalization", + "reason": "missing_worktree_context", + "branch": "{{branch}}", + "worktreePath": "{{worktreePath}}", + "baseBranch": "{{baseBranch}}" + } }, "position": { - "x": 760, - "y": 1830 + "x": 620, + "y": 330 }, "outputs": [ "default" ] }, { - "id": "increment-stuck-retry-count", - "type": "action.set_variable", - "label": "Increment Stuck Retry Count", + "id": "has-pr-missing-context", + "type": "condition.expression", + "label": "PR Linked Without Worktree?", "config": { - "key": "stuckRetryCount", - "value": "Number($data?.stuckRetryCount || 0) + 1", - "isExpression": true + "expression": "Boolean($data?.prNumber || $data?.prUrl)" }, "position": { - "x": 760, - "y": 1940 + "x": 620, + "y": 450 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "stuck-escalate", + "id": "notify-skip-missing-context", "type": "notify.log", - "label": "Escalate Stuck Session", + "label": "Skip Missing Context With PR", "config": { - "level": "warn", - "message": "session-stuck: escalation requested for task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}}, stuckForMs={{stuckForMs}}, stuckRetryCount={{stuckRetryCount}}/{{maxStuckAutoRetries}}, lastProgressSignature={{lastProgressSignature}}, currentProgressSignature={{currentProgressSignature}})" + "message": "Task {{taskId}} finalization skipped quality gate: missing worktree context but PR linkage exists", + "level": "warn" }, "position": { - "x": 980, - "y": 1830 + "x": 620, + "y": 560 }, "outputs": [ "default" ] }, { - "id": "stuck-escalate-budget", + "id": "notify-pass", "type": "notify.log", - "label": "Escalate Stuck Session (Retry Limit)", + "label": "Log Finalization Success", "config": { - "level": "warn", - "message": "session-stuck: retry budget exhausted for task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}}, stuckForMs={{stuckForMs}}, stuckRetryCount={{stuckRetryCount}}/{{maxStuckAutoRetries}}, lastProgressSignature={{lastProgressSignature}}, currentProgressSignature={{currentProgressSignature}})" + "message": "Task {{taskId}} finalization passed — moved to inreview", + "level": "info" }, "position": { - "x": 760, - "y": 2050 + "x": 240, + "y": 1180 }, "outputs": [ "default" ] }, { - "id": "stuck-pause", - "type": "notify.log", - "label": "Pause Stuck Session", + "id": "chain-archiver", + "type": "flow.universal", + "label": "Queue Archival", "config": { - "level": "warn", - "message": "session-stuck: paused task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}})" + "workflowId": "template-task-archiver", + "mode": "dispatch", + "input": "({taskId: $data?.taskId, taskTitle: $data?.taskTitle, completedAt: new Date().toISOString(), taskJson: JSON.stringify($data?.task || {id: $data?.taskId, title: $data?.taskTitle})})" }, "position": { - "x": 1200, - "y": 1830 + "x": 240, + "y": 1320 }, "outputs": [ "default" ] }, { - "id": "end-escalated", + "id": "end-success", "type": "flow.end", - "label": "End: Escalated", + "label": "End Success", "config": { - "status": "failed", - "message": "Continuation loop escalated due to session-stuck for task {{taskId}}.", + "status": "completed", + "message": "Task finalization guard completed successfully for {{taskId}}", "output": { - "reason": "stuck_escalated", + "outcome": "passed", "taskId": "{{taskId}}", - "event": "{{sessionStuckEvent.eventType}}", - "stuckRetryCount": "{{stuckRetryCount}}", - "maxStuckAutoRetries": "{{maxStuckAutoRetries}}" + "taskTitle": "{{taskTitle}}" } }, "position": { - "x": 980, - "y": 1950 + "x": 240, + "y": 1450 }, "outputs": [ "default" ] }, { - "id": "end-paused", - "type": "flow.end", - "label": "End: Paused", + "id": "notify-fail", + "type": "notify.telegram", + "label": "Notify Finalization Failure", "config": { - "status": "completed", - "message": "Continuation loop paused due to session-stuck for task {{taskId}}.", - "output": { - "reason": "stuck_paused", - "taskId": "{{taskId}}", - "event": "{{sessionStuckEvent.eventType}}" - } + "message": ":alert: Task finalization failed for **{{taskTitle}}** ({{taskId}}). Repair workflow handoff triggered." }, "position": { - "x": 1200, - "y": 1950 + "x": 540, + "y": 900 }, "outputs": [ "default" ] }, { - "id": "wait-next-turn", - "type": "action.delay", - "label": "Wait Poll Interval", + "id": "end-failed", + "type": "flow.end", + "label": "End Failed", "config": { - "ms": "{{pollIntervalMs}}", - "reason": "Waiting before next external status poll" + "status": "failed", + "message": "Task finalization guard failed for {{taskId}}", + "output": { + "outcome": "failed", + "taskId": "{{taskId}}", + "taskTitle": "{{taskTitle}}" + } }, "position": { - "x": 760, - "y": 1950 - }, - "outputs": [ - "default" - ] - }, - { - "id": "increment-turn", - "type": "action.set_variable", - "label": "Increment Turn", - "config": { - "key": "continuationTurn", - "value": "Number($data?.continuationTurn || 0) + 1", - "isExpression": true - }, - "position": { - "x": 760, - "y": 2060 - }, - "outputs": [ - "default" - ] - }, - { - "id": "wait-next-turn-no-stuck", - "type": "action.delay", - "label": "Wait (No Stuck)", - "config": { - "ms": "{{pollIntervalMs}}", - "reason": "Waiting before next external status poll" - }, - "position": { - "x": 1080, - "y": 1950 - }, - "outputs": [ - "default" - ] - }, - { - "id": "increment-turn-no-stuck", - "type": "action.set_variable", - "label": "Increment Turn (No Stuck)", - "config": { - "key": "continuationTurn", - "value": "Number($data?.continuationTurn || 0) + 1", - "isExpression": true - }, - "position": { - "x": 1080, - "y": 2060 + "x": 540, + "y": 1040 }, "outputs": [ "default" @@ -12625,296 +11934,202 @@ ], "edges": [ { - "id": "trigger->init-turn", + "id": "trigger->has-worktree", "source": "trigger", - "target": "init-turn", - "sourcePort": "default" - }, - { - "id": "init-turn->init-progress-at", - "source": "init-turn", - "target": "init-progress-at", - "sourcePort": "default" - }, - { - "id": "init-progress-at->init-signature", - "source": "init-progress-at", - "target": "init-signature", - "sourcePort": "default" - }, - { - "id": "init-signature->init-stuck-retry-count", - "source": "init-signature", - "target": "init-stuck-retry-count", - "sourcePort": "default" - }, - { - "id": "init-stuck-retry-count->poll-task", - "source": "init-stuck-retry-count", - "target": "poll-task", - "sourcePort": "default" - }, - { - "id": "poll-task->derive-status", - "source": "poll-task", - "target": "derive-status", - "sourcePort": "default" - }, - { - "id": "derive-status->terminal-check", - "source": "derive-status", - "target": "terminal-check", + "target": "has-worktree", "sourcePort": "default" }, { - "id": "terminal-check->end-terminal", - "source": "terminal-check", - "target": "end-terminal", - "sourcePort": "yes", + "id": "has-worktree->run-finalization", + "source": "has-worktree", + "target": "run-finalization", + "sourcePort": "default", "condition": "$output?.result === true" }, { - "id": "terminal-check->max-turns-check", - "source": "terminal-check", - "target": "max-turns-check", - "sourcePort": "no", + "id": "has-worktree->has-pr-missing-context", + "source": "has-worktree", + "target": "has-pr-missing-context", + "sourcePort": "default", "condition": "$output?.result !== true" }, { - "id": "max-turns-check->end-max-turns", - "source": "max-turns-check", - "target": "end-max-turns", + "id": "has-pr-missing-context->notify-skip-missing-context", + "source": "has-pr-missing-context", + "target": "notify-skip-missing-context", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "max-turns-check->run-agent", - "source": "max-turns-check", - "target": "run-agent", + "id": "has-pr-missing-context->mark-todo-missing", + "source": "has-pr-missing-context", + "target": "mark-todo-missing", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "run-agent->capture-progress", - "source": "run-agent", - "target": "capture-progress", - "sourcePort": "default" - }, - { - "id": "capture-progress->derive-signature", - "source": "capture-progress", - "target": "derive-signature", - "sourcePort": "default" - }, - { - "id": "derive-signature->derive-stuck-ms", - "source": "derive-signature", - "target": "derive-stuck-ms", - "sourcePort": "default" - }, - { - "id": "derive-stuck-ms->progress-changed", - "source": "derive-stuck-ms", - "target": "progress-changed", - "sourcePort": "default" - }, - { - "id": "progress-changed->mark-progress-at", - "source": "progress-changed", - "target": "mark-progress-at", - "sourcePort": "default" - }, - { - "id": "mark-progress-at->mark-progress-sig", - "source": "mark-progress-at", - "target": "mark-progress-sig", - "sourcePort": "default" - }, - { - "id": "mark-progress-sig->reset-stuck-retry-count", - "source": "mark-progress-sig", - "target": "reset-stuck-retry-count", - "sourcePort": "default" - }, - { - "id": "reset-stuck-retry-count->stuck-check", - "source": "reset-stuck-retry-count", - "target": "stuck-check", + "id": "run-finalization->checks-passed", + "source": "run-finalization", + "target": "checks-passed", "sourcePort": "default" }, { - "id": "stuck-check->emit-stuck", - "source": "stuck-check", - "target": "emit-stuck", - "sourcePort": "yes", + "id": "checks-passed->has-pr", + "source": "checks-passed", + "target": "has-pr", + "sourcePort": "default", "condition": "$output?.result === true" }, { - "id": "stuck-check->wait-next-turn-no-stuck", - "source": "stuck-check", - "target": "wait-next-turn-no-stuck", - "sourcePort": "no", + "id": "checks-passed->mark-todo-failed", + "source": "checks-passed", + "target": "mark-todo-failed", + "sourcePort": "default", "condition": "$output?.result !== true" }, { - "id": "emit-stuck->stuck-route", - "source": "emit-stuck", - "target": "stuck-route", - "sourcePort": "default" - }, - { - "id": "stuck-route->stuck-retry-budget", - "source": "stuck-route", - "target": "stuck-retry-budget", - "sourcePort": "retry" - }, - { - "id": "stuck-route->stuck-escalate", - "source": "stuck-route", - "target": "stuck-escalate", - "sourcePort": "escalate" + "id": "has-pr->mark-inreview", + "source": "has-pr", + "target": "mark-inreview", + "sourcePort": "default", + "condition": "$output?.result === true" }, { - "id": "stuck-route->stuck-pause", - "source": "stuck-route", - "target": "stuck-pause", - "sourcePort": "pause" + "id": "has-pr->create-pr", + "source": "has-pr", + "target": "create-pr", + "sourcePort": "default", + "condition": "$output?.result !== true" }, { - "id": "stuck-route->stuck-escalate", - "source": "stuck-route", - "target": "stuck-escalate", + "id": "create-pr->create-pr-success", + "source": "create-pr", + "target": "create-pr-success", "sourcePort": "default" }, { - "id": "stuck-retry-budget->stuck-retry", - "source": "stuck-retry-budget", - "target": "stuck-retry", + "id": "create-pr-success->mark-inreview", + "source": "create-pr-success", + "target": "mark-inreview", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "stuck-retry-budget->stuck-escalate-budget", - "source": "stuck-retry-budget", - "target": "stuck-escalate-budget", + "id": "create-pr-success->mark-todo-failed", + "source": "create-pr-success", + "target": "mark-todo-failed", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "stuck-retry->increment-stuck-retry-count", - "source": "stuck-retry", - "target": "increment-stuck-retry-count", + "id": "mark-inreview->handoff-pr-progressor", + "source": "mark-inreview", + "target": "handoff-pr-progressor", "sourcePort": "default" }, { - "id": "increment-stuck-retry-count->wait-next-turn", - "source": "increment-stuck-retry-count", - "target": "wait-next-turn", + "id": "handoff-pr-progressor->notify-pass", + "source": "handoff-pr-progressor", + "target": "notify-pass", "sourcePort": "default" }, { - "id": "stuck-escalate->end-escalated", - "source": "stuck-escalate", - "target": "end-escalated", + "id": "notify-skip-missing-context->end-success", + "source": "notify-skip-missing-context", + "target": "end-success", "sourcePort": "default" }, { - "id": "stuck-escalate-budget->end-escalated", - "source": "stuck-escalate-budget", - "target": "end-escalated", + "id": "notify-pass->chain-archiver", + "source": "notify-pass", + "target": "chain-archiver", "sourcePort": "default" }, { - "id": "stuck-pause->end-paused", - "source": "stuck-pause", - "target": "end-paused", + "id": "chain-archiver->end-success", + "source": "chain-archiver", + "target": "end-success", "sourcePort": "default" }, { - "id": "wait-next-turn->increment-turn", - "source": "wait-next-turn", - "target": "increment-turn", + "id": "mark-todo-failed->notify-fail", + "source": "mark-todo-failed", + "target": "notify-fail", "sourcePort": "default" }, { - "id": "wait-next-turn-no-stuck->increment-turn-no-stuck", - "source": "wait-next-turn-no-stuck", - "target": "increment-turn-no-stuck", + "id": "mark-todo-missing->notify-fail", + "source": "mark-todo-missing", + "target": "notify-fail", "sourcePort": "default" }, { - "id": "increment-turn->poll-task", - "source": "increment-turn", - "target": "poll-task", - "sourcePort": "default", - "backEdge": true, - "maxIterations": 500 - }, - { - "id": "increment-turn-no-stuck->poll-task", - "source": "increment-turn-no-stuck", - "target": "poll-task", - "sourcePort": "default", - "backEdge": true, - "maxIterations": 500 + "id": "notify-fail->end-failed", + "source": "notify-fail", + "target": "end-failed", + "sourcePort": "default" } ] }, { - "id": "template-error-recovery", - "name": "Error Recovery", - "description": "Automated error recovery flow when an agent crashes or fails. Analyzes logs, attempts auto-fix, and escalates if needed.", + "id": "template-task-orphan-worktree-recovery", + "name": "Task Orphan Worktree Recovery", + "description": "Scheduled workflow-owned recovery for orphaned task worktrees. Scans .cache/worktrees for abandoned task branches, auto-commits pending changes, pushes recoverable branches, records PR handoff, and updates task status to inreview when successful.", "category": "reliability", "categoryLabel": "Reliability", "categoryIcon": ":shield:", "categoryOrder": 5, "tags": [ - "error", + "orphan", "recovery", - "autofix" + "worktree", + "lifecycle", + "reliability" ], "nodeCount": 8, - "edgeCount": 8, + "edgeCount": 7, "recommended": true, "enabled": true, - "trigger": "trigger.event", + "trigger": "trigger.schedule", "variables": { - "maxRetries": 3 + "intervalMs": 1800000, + "baseBranch": "origin/main", + "maxRecoverPerSweep": 20 }, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2025-02-24T00:00:00Z", - "templateVersion": "1.1.0", + "createdAt": "2026-03-04T00:00:00Z", + "templateVersion": "1.0.1", "tags": [ - "error", + "orphan", "recovery", - "autofix" - ], - "requiredTemplates": [ - "template-task-repair-worktree" + "worktree", + "lifecycle", + "reliability" ], "replaces": { - "module": "monitor.mjs", + "module": "task-executor.mjs", "functions": [ - "runCodexRecovery" + "_recoverOrphanedWorktrees" ], "calledFrom": [ - "monitor.mjs:runMonitorMonitorCycle" + "task-executor.mjs:start" ], - "description": "Replaces hardcoded error recovery logic. Retry/escalate decisions are now visual workflow branches." + "description": "Moves orphaned worktree recovery out of the legacy task-executor startup path and into a dedicated scheduled workflow." } }, "nodes": [ { "id": "trigger", - "type": "trigger.event", - "label": "Agent Failed", + "type": "trigger.schedule", + "label": "Scheduled Recovery Sweep", "config": { - "eventType": "task.failed" + "intervalMs": "{{intervalMs}}", + "cron": "*/30 * * * *" }, "position": { - "x": 400, + "x": 420, "y": 50 }, "outputs": [ @@ -12922,30 +12137,31 @@ ] }, { - "id": "check-retries", - "type": "condition.expression", - "label": "Retries Left?", + "id": "recover", + "type": "action.run_command", + "label": "Recover Orphan Worktrees", "config": { - "expression": "($data?.retryCount || 0) < ($data?.maxRetries || 3)" + "command": "node tools/workflow-orphan-worktree-recovery.mjs --base \"{{baseBranch}}\" --max \"{{maxRecoverPerSweep}}\"", + "failOnError": false }, "position": { - "x": 400, - "y": 180 + "x": 420, + "y": 190 }, "outputs": [ "default" ] }, { - "id": "analyze-error", - "type": "action.run_agent", - "label": "Analyze Failure", + "id": "parse-recovery", + "type": "transform.json_parse", + "label": "Parse Recovery Summary", "config": { - "prompt": "Analyze the following task failure and suggest the most likely minimal fix.\n\nTask: {{taskTitle}} ({{taskId}})\nRetry attempt: {{$data?.retryCount || 0}}/{{$data?.maxRetries || 3}}\nBranch: {{branch}}\nBase branch: {{baseBranch}}\nWorktree: {{worktreePath}}\n\nLast error:\n{{lastError}}", - "timeoutMs": 300000 + "input": "recover", + "field": "output" }, "position": { - "x": 200, + "x": 420, "y": 330 }, "outputs": [ @@ -12953,35 +12169,31 @@ ] }, { - "id": "retry-task", - "type": "action.run_agent", - "label": "Retry Task", + "id": "parse-ok", + "type": "condition.expression", + "label": "Recovery Summary Valid?", "config": { - "prompt": "{{taskExecutorRetryPrompt}}\n\nFailure context:\n- taskId: {{taskId}}\n- taskTitle: {{taskTitle}}\n- branch: {{branch}}\n- baseBranch: {{baseBranch}}\n- worktreePath: {{worktreePath}}\n- retryCount: {{$data?.retryCount || 0}}/{{$data?.maxRetries || 3}}\n- lastError: {{lastError}}\n- recoveryAnalysis: {{$ctx.getNodeOutput('analyze-error')?.output || ''}}\n\nUse the analysis to choose a different approach if the previous attempt failed.", - "timeoutMs": 3600000, - "failOnError": true, - "maxRetries": "{{maxRetries}}", - "retryDelayMs": 15000, - "continueOnError": true + "expression": "$ctx.getNodeOutput('parse-recovery')?.success === true" }, "position": { - "x": 200, - "y": 480 + "x": 420, + "y": 470 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "retry-succeeded", + "id": "has-recovered", "type": "condition.expression", - "label": "Retry Succeeded?", + "label": "Recovered Branches?", "config": { - "expression": "$ctx.getNodeOutput('retry-task')?.success === true" + "expression": "Number($ctx.getNodeOutput('parse-recovery')?.data?.recovered || 0) > 0" }, "position": { - "x": 200, - "y": 620 + "x": 420, + "y": 610 }, "outputs": [ "yes", @@ -12989,15 +12201,15 @@ ] }, { - "id": "notify-recovered", + "id": "log-recovered", "type": "notify.log", "label": "Log Recovery Success", "config": { - "message": "Task {{taskId}} recovered automatically by error-recovery workflow", + "message": "Orphan recovery: recovered={{parse-recovery.data.recovered}} skipped={{parse-recovery.data.skipped}} failed={{parse-recovery.data.failed}}", "level": "info" }, "position": { - "x": 90, + "x": 250, "y": 760 }, "outputs": [ @@ -13005,32 +12217,32 @@ ] }, { - "id": "escalate", - "type": "notify.telegram", - "label": "Escalate to Human", + "id": "log-idle", + "type": "notify.log", + "label": "Log No Work", "config": { - "message": ":alert: Task **{{taskTitle}}** failed after {{maxRetries}} attempts. Manual intervention needed.\n\nLast error: {{lastError}}\n\nRecovery analysis: {{$ctx.getNodeOutput('analyze-error')?.output || ''}}" + "message": "Orphan recovery: no recoverable orphaned worktrees found (scanned={{parse-recovery.data.scanned}}, skipped={{parse-recovery.data.skipped}}).", + "level": "debug" }, "position": { - "x": 600, - "y": 620 + "x": 560, + "y": 760 }, "outputs": [ "default" ] }, { - "id": "chain-repair", - "type": "action.execute_workflow", - "label": "Trigger Repair Workflow", + "id": "log-parse-failed", + "type": "notify.log", + "label": "Log Recovery Parse Failure", "config": { - "workflowId": "template-task-repair-worktree", - "mode": "dispatch", - "input": "(() => { const analysisRaw = String($ctx.getNodeOutput('analyze-error')?.output || '').trim(); const retryOutputRaw = String($ctx.getNodeOutput('retry-task')?.output || '').trim(); const retryErrorRaw = String($ctx.getNodeOutput('retry-task')?.error || '').trim(); const truncate = (value, limit = 2000) => value.length > limit ? `${value.slice(0, limit)}...` : value; const diagnostics = [String($data?.lastError || '').trim(), analysisRaw ? `Recovery analysis:\n${truncate(analysisRaw)}` : '', retryOutputRaw ? `Retry output:\n${truncate(retryOutputRaw)}` : '', retryErrorRaw ? `Retry error:\n${truncate(retryErrorRaw)}` : ''].filter(Boolean).join('\n\n'); return { taskId: $data?.taskId, taskTitle: $data?.taskTitle, worktreePath: $data?.worktreePath, branch: $data?.branch, baseBranch: $data?.baseBranch, error: diagnostics || String($data?.lastError || ''), recoveryAnalysis: truncate(analysisRaw), retryResult: { success: $ctx.getNodeOutput('retry-task')?.success === true, output: truncate(retryOutputRaw), error: truncate(retryErrorRaw) } }; })()" + "message": "Orphan recovery workflow produced invalid JSON output. Check tools/workflow-orphan-worktree-recovery.mjs execution logs.", + "level": "warn" }, "position": { - "x": 400, - "y": 760 + "x": 760, + "y": 610 }, "outputs": [ "default" @@ -13039,114 +12251,116 @@ ], "edges": [ { - "id": "trigger->check-retries", + "id": "trigger->recover", "source": "trigger", - "target": "check-retries", + "target": "recover", "sourcePort": "default" }, { - "id": "check-retries->analyze-error", - "source": "check-retries", - "target": "analyze-error", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "check-retries->escalate", - "source": "check-retries", - "target": "escalate", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "analyze-error->retry-task", - "source": "analyze-error", - "target": "retry-task", + "id": "recover->parse-recovery", + "source": "recover", + "target": "parse-recovery", "sourcePort": "default" }, { - "id": "retry-task->retry-succeeded", - "source": "retry-task", - "target": "retry-succeeded", + "id": "parse-recovery->parse-ok", + "source": "parse-recovery", + "target": "parse-ok", "sourcePort": "default" }, { - "id": "retry-succeeded->notify-recovered", - "source": "retry-succeeded", - "target": "notify-recovered", + "id": "parse-ok->has-recovered", + "source": "parse-ok", + "target": "has-recovered", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "retry-succeeded->chain-repair", - "source": "retry-succeeded", - "target": "chain-repair", + "id": "parse-ok->log-parse-failed", + "source": "parse-ok", + "target": "log-parse-failed", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "chain-repair->escalate", - "source": "chain-repair", - "target": "escalate", - "sourcePort": "default" + "id": "has-recovered->log-recovered", + "source": "has-recovered", + "target": "log-recovered", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "has-recovered->log-idle", + "source": "has-recovered", + "target": "log-idle", + "sourcePort": "no", + "condition": "$output?.result !== true" } ] }, { - "id": "template-health-check", - "name": "Health Check", - "description": "Periodic system health check: validates config, verifies SDK availability, checks git state, and reports any issues found.", + "id": "template-task-repair-worktree", + "name": "Task Repair Worktree", + "description": "Recovery workflow for tasks that fail execution or finalization. Refreshes worktree state, runs a repair agent, re-validates quality gates, and escalates only after automated repair fails.", "category": "reliability", "categoryLabel": "Reliability", "categoryIcon": ":shield:", "categoryOrder": 5, "tags": [ - "health", - "config", - "doctor", - "monitoring" + "repair", + "recovery", + "worktree", + "resilience", + "automation" ], - "nodeCount": 7, - "edgeCount": 8, - "recommended": false, + "nodeCount": 15, + "edgeCount": 16, + "recommended": true, "enabled": true, - "trigger": "trigger.schedule", + "trigger": "trigger.event", "variables": { - "intervalMs": 3600000 + "repairTimeoutMs": 5400000, + "verificationTimeoutMs": 3600000, + "baseBranch": "main", + "verificationCommand": "node -e \"const cp=require('node:child_process');const cmds=['npm run prepush --if-present','npm run prepush:check --if-present','npm run build','npm test','npm run lint --if-present'];for(const cmd of cmds){cp.execSync(cmd,{stdio:'inherit'});} \"", + "repairPrompt": "Task {{taskId}} ({{taskTitle}}) failed. Error: {{error}}. Repair the implementation in {{worktreePath}} without bypassing tests, then leave the branch ready for Bosun PR lifecycle handoff." }, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2025-02-25T00:00:00Z", + "createdAt": "2026-02-26T00:00:00Z", "templateVersion": "1.0.1", "tags": [ - "health", - "config", - "doctor", - "monitoring" + "repair", + "recovery", + "worktree", + "resilience", + "automation" + ], + "requiredTemplates": [ + "template-bosun-pr-progressor" ], "replaces": { - "module": "config-doctor.mjs", + "module": "task-executor.mjs", "functions": [ - "runConfigDoctor" + "retry/escalation recovery path" ], "calledFrom": [ - "cli.mjs:doctor command" + "task-executor.mjs:_handleTaskResult" ], - "description": "Replaces manual config-doctor runs with a scheduled health check workflow. Config validation, git state, and agent status checks run in parallel with automatic alerting." + "description": "Introduces a dedicated automated repair workflow that takes over when task execution or finalization fails." } }, "nodes": [ { - "id": "trigger", - "type": "trigger.schedule", - "label": "Hourly Health Check", + "id": "trigger-failed", + "type": "trigger.event", + "label": "Task Failed", "config": { - "intervalMs": "{{intervalMs}}", - "cron": "0 * * * *" + "eventType": "task.failed" }, "position": { - "x": 400, + "x": 250, "y": 50 }, "outputs": [ @@ -13154,233 +12368,134 @@ ] }, { - "id": "check-config", - "type": "action.bosun_cli", - "label": "Check Config", + "id": "trigger-finalization", + "type": "trigger.event", + "label": "Finalization Failed", "config": { - "subcommand": "doctor", - "args": "--json" + "eventType": "task.finalization_failed" }, "position": { - "x": 150, - "y": 200 + "x": 550, + "y": 50 }, "outputs": [ "default" ] }, { - "id": "check-git", - "type": "action.run_command", - "label": "Check Git State", + "id": "has-worktree", + "type": "condition.expression", + "label": "Worktree Context Available?", "config": { - "command": "node -e \"const cp=require('node:child_process');const status=cp.execSync('git status --porcelain',{encoding:'utf8'});const wt=cp.execSync('git worktree list --porcelain',{encoding:'utf8'});const count=(wt.match(/^worktree /gm)||[]).length;process.stdout.write(status + (status.endsWith('\\\\n') ? '' : '\\\\n') + count + '\\\\n');\"", - "continueOnError": true + "expression": "Boolean($data?.worktreePath)" }, "position": { "x": 400, - "y": 200 + "y": 180 }, "outputs": [ "default" ] }, { - "id": "check-agents", - "type": "action.run_command", - "label": "Check Agent Status", + "id": "refresh-worktree", + "type": "action.refresh_worktree", + "label": "Refresh Worktree", "config": { - "command": "node -e \"const cp=require('node:child_process');try{process.stdout.write(cp.execSync('bosun --daemon-status',{encoding:'utf8'}));}catch{process.stdout.write('daemon not running\\\\n');}\"", + "operation": "fetch", + "cwd": "{{worktreePath}}", "continueOnError": true }, "position": { - "x": 650, - "y": 200 + "x": 400, + "y": 320 }, "outputs": [ "default" ] }, { - "id": "has-issues", - "type": "condition.expression", - "label": "Any Issues?", + "id": "repair-agent", + "type": "action.run_agent", + "label": "Repair Task", "config": { - "expression": "($ctx.getNodeOutput('check-config')?.success === false) || (($ctx.getNodeOutput('check-config')?.output || '').includes('ERROR')) || (($ctx.getNodeOutput('check-config')?.output || '').includes('CRITICAL')) || ($ctx.getNodeOutput('check-git')?.success === false) || ($ctx.getNodeOutput('check-agents')?.success === false)" + "prompt": "{{repairPrompt}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{repairTimeoutMs}}" }, "position": { "x": 400, - "y": 380 + "y": 460 }, "outputs": [ "default" ] }, { - "id": "alert", - "type": "notify.telegram", - "label": "Alert Issues Found", + "id": "verify", + "type": "action.run_command", + "label": "Re-run Quality Gates", "config": { - "message": ":heart: Health check found issues — run `bosun doctor` for details" + "command": "{{verificationCommand}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{verificationTimeoutMs}}", + "continueOnError": true }, "position": { - "x": 200, - "y": 540 + "x": 400, + "y": 600 }, "outputs": [ "default" ] }, { - "id": "all-ok", - "type": "notify.telegram", - "label": "All Healthy", + "id": "verify-passed", + "type": "condition.expression", + "label": "Repair Passed?", "config": { - "message": "Health check passed — all systems operational", - "level": "info" + "expression": "$ctx.getNodeOutput('verify')?.success === true" }, "position": { - "x": 600, - "y": 540 + "x": 400, + "y": 740 }, "outputs": [ "default" ] - } - ], - "edges": [ - { - "id": "trigger->check-config", - "source": "trigger", - "target": "check-config", - "sourcePort": "default" - }, - { - "id": "trigger->check-git", - "source": "trigger", - "target": "check-git", - "sourcePort": "default" - }, - { - "id": "trigger->check-agents", - "source": "trigger", - "target": "check-agents", - "sourcePort": "default" - }, - { - "id": "check-config->has-issues", - "source": "check-config", - "target": "has-issues", - "sourcePort": "default" - }, - { - "id": "check-git->has-issues", - "source": "check-git", - "target": "has-issues", - "sourcePort": "default" - }, - { - "id": "check-agents->has-issues", - "source": "check-agents", - "target": "has-issues", - "sourcePort": "default" }, { - "id": "has-issues->alert", - "source": "has-issues", - "target": "alert", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "has-issues->all-ok", - "source": "has-issues", - "target": "all-ok", - "sourcePort": "default", - "condition": "$output?.result !== true" - } - ] - }, - { - "id": "template-incident-response", - "name": "Incident Response", - "description": "Automated incident management: detects error spikes or anomalous patterns, creates an incident task, assigns an agent for investigation, collects evidence, and escalates via notification channels.", - "category": "reliability", - "categoryLabel": "Reliability", - "categoryIcon": ":shield:", - "categoryOrder": 5, - "tags": [ - "incident", - "response", - "detection", - "escalation", - "reliability" - ], - "nodeCount": 11, - "edgeCount": 12, - "recommended": true, - "enabled": true, - "trigger": "trigger.anomaly", - "variables": { - "errorThreshold": 5, - "escalationDelayMs": 600000, - "autoAssignAgent": true - }, - "metadata": { - "author": "bosun", - "version": 1, - "createdAt": "2025-02-25T00:00:00Z", - "templateVersion": "1.0.1", - "tags": [ - "incident", - "response", - "detection", - "escalation", - "reliability" - ], - "replaces": { - "module": "error-detector.mjs", - "functions": [ - "handleErrorSpike", - "escalateAnomaly" - ], - "calledFrom": [ - "anomaly-detector.mjs:onAnomaly" - ], - "description": "Replaces reactive error handling with a structured incident response workflow. Evidence collection, classification, task creation, and agent assignment become explicit, auditable steps." - } - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.anomaly", - "label": "Error Spike Detected", + "id": "create-pr", + "type": "action.create_pr", + "label": "Handoff/Refresh Lifecycle", "config": { - "anomalyTypes": [ - "error-spike", - "death-loop", - "agent-stall" - ], - "threshold": "{{errorThreshold}}" + "title": "{{taskTitle}}", + "body": "Automated repair run for task {{taskId}}. Bosun lifecycle handoff context.", + "base": "{{baseBranch}}", + "branch": "{{branch}}", + "failOnError": true, + "maxRetries": 3, + "retryDelayMs": 15000, + "continueOnError": true }, "position": { - "x": 400, - "y": 50 + "x": 250, + "y": 880 }, "outputs": [ "default" ] }, { - "id": "should-assign", + "id": "create-pr-success", "type": "condition.expression", - "label": "Auto Assign Agent?", + "label": "Lifecycle Handoff Ready?", "config": { - "expression": "Boolean($data?.autoAssignAgent !== false)" + "expression": "$ctx.getNodeOutput('create-pr')?.success === true" }, "position": { "x": 250, - "y": 690 + "y": 950 }, "outputs": [ "yes", @@ -13388,155 +12503,121 @@ ] }, { - "id": "delay-escalation", - "type": "action.delay", - "label": "Escalation Delay", - "config": { - "ms": "{{escalationDelayMs}}", - "reason": "Allowing automatic mitigation window before escalation" - }, - "position": { - "x": 150, - "y": 620 - }, - "outputs": [ - "default" - ] - }, - { - "id": "collect-evidence", - "type": "agent.evidence_collect", - "label": "Collect Evidence", + "id": "mark-inreview", + "type": "action.update_task_status", + "label": "Set In Review", "config": { - "sources": [ - "logs", - "git-status", - "process-list", - "recent-errors" - ], - "lookbackMinutes": 30 + "taskId": "{{taskId}}", + "status": "inreview", + "taskTitle": "{{taskTitle}}", + "workflowEvent": "task.repair_succeeded", + "workflowData": { + "stage": "repair", + "result": "passed", + "branch": "{{branch}}", + "worktreePath": "{{worktreePath}}" + } }, "position": { - "x": 400, - "y": 200 + "x": 250, + "y": 1020 }, "outputs": [ "default" ] }, { - "id": "classify-incident", - "type": "action.run_agent", - "label": "Classify Incident", + "id": "handoff-pr-progressor", + "type": "action.execute_workflow", + "label": "Dispatch PR Progressor", "config": { - "prompt": "# Incident Classification\n\nAnalyze the collected evidence:\n{{evidence}}\n\nClassify the incident:\n1. **SEVERITY**: critical / high / medium / low\n2. **CATEGORY**: agent-crash / build-failure / resource-exhaustion / stuck-process / unknown\n3. **ROOT CAUSE**: One-line hypothesis\n4. **IMPACT**: What is affected and who is impacted\n5. **RECOMMENDED ACTION**: Immediate steps to mitigate\n\nOutput as JSON: { \"severity\": \"...\", \"category\": \"...\", \"rootCause\": \"...\", \"impact\": \"...\", \"action\": \"...\" }", - "sdk": "auto", - "timeoutMs": 300000 + "workflowId": "template-bosun-pr-progressor", + "mode": "dispatch", + "input": { + "taskId": "{{taskId}}", + "taskTitle": "{{taskTitle}}", + "branch": "{{branch}}", + "baseBranch": "{{baseBranch}}", + "prNumber": "{{$data?.prNumber ?? $ctx.getNodeOutput('create-pr')?.prNumber ?? null}}", + "prUrl": "{{$data?.prUrl || $ctx.getNodeOutput('create-pr')?.prUrl || ''}}", + "repo": "{{$data?.repo || $data?.repoSlug || $data?.repository || $ctx.getNodeOutput('create-pr')?.repoSlug || ''}}" + } }, "position": { - "x": 400, - "y": 370 + "x": 250, + "y": 1160 }, "outputs": [ "default" ] }, { - "id": "is-critical", - "type": "condition.expression", - "label": "Is Critical?", - "config": { - "expression": "($ctx.getNodeOutput('classify-incident')?.output || '').includes('\"severity\": \"critical\"') || ($ctx.getNodeOutput('classify-incident')?.output || '').includes('\"severity\":\"critical\"')" - }, - "position": { - "x": 400, - "y": 540 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "create-incident-task", - "type": "action.create_task", - "label": "Create Incident Task", + "id": "mark-todo", + "type": "action.update_task_status", + "label": "Mark Todo (Repair Failed)", "config": { - "title": ":alert: Incident: {{incidentCategory}}", - "description": "Auto-detected incident.\n\nEvidence: {{evidence}}\n\nClassification: {{classification}}", - "tags": [ - "incident", - "auto-detected" - ], - "priority": "high" + "taskId": "{{taskId}}", + "status": "todo", + "taskTitle": "{{taskTitle}}", + "workflowEvent": "task.repair_failed", + "workflowData": { + "stage": "repair", + "reason": "verification_failed", + "branch": "{{branch}}", + "worktreePath": "{{worktreePath}}", + "baseBranch": "{{baseBranch}}" + } }, "position": { - "x": 400, - "y": 690 + "x": 560, + "y": 880 }, "outputs": [ "default" ] }, { - "id": "assign-agent", - "type": "action.run_agent", - "label": "Investigate & Mitigate", + "id": "notify-success", + "type": "notify.telegram", + "label": "Notify Repair Success", "config": { - "prompt": "# Incident Investigation\n\nAn incident has been detected and classified:\n{{classification}}\n\nEvidence collected:\n{{evidence}}\n\nYour task:\n1. Investigate the root cause in detail\n2. Apply immediate mitigation if safe to do so\n3. Document what you find and what you changed\n4. If you cannot resolve it, document what you know for human review\n\nBe conservative — prefer safe mitigations over aggressive fixes.", - "sdk": "auto", - "timeoutMs": 1800000 + "message": ":check: Repair workflow recovered **{{taskTitle}}** ({{taskId}}) and moved it to inreview.", + "silent": true }, "position": { "x": 250, - "y": 840 + "y": 1300 }, "outputs": [ "default" ] }, { - "id": "alert-critical", + "id": "notify-escalate", "type": "notify.telegram", - "label": "Critical Incident Alert", + "label": "Escalate Repair Failure", "config": { - "message": ":alert: **CRITICAL INCIDENT**\n\nCategory: {{incidentCategory}}\nRoot cause: {{rootCause}}\n\nAgent investigating. Immediate attention may be required." + "message": ":alert: Repair workflow could not recover **{{taskTitle}}** ({{taskId}}). Manual intervention required." }, "position": { - "x": 150, - "y": 540 + "x": 560, + "y": 1020 }, "outputs": [ "default" ] }, { - "id": "alert-standard", + "id": "no-worktree", "type": "notify.log", - "label": "Log Incident", + "label": "Missing Worktree Context", "config": { - "message": "Incident detected (non-critical): {{incidentCategory}} — agent assigned", + "message": "Task repair skipped for {{taskId}} — missing worktreePath in event payload", "level": "warn" }, "position": { - "x": 600, - "y": 690 - }, - "outputs": [ - "default" - ] - }, - { - "id": "resolution-log", - "type": "notify.log", - "label": "Log Resolution", - "config": { - "message": "Incident response complete — see task for details", - "level": "info" - }, - "position": { - "x": 400, - "y": 990 + "x": 700, + "y": 320 }, "outputs": [ "default" @@ -13545,329 +12626,273 @@ ], "edges": [ { - "id": "trigger->collect-evidence", - "source": "trigger", - "target": "collect-evidence", - "sourcePort": "default" - }, - { - "id": "collect-evidence->classify-incident", - "source": "collect-evidence", - "target": "classify-incident", + "id": "trigger-failed->has-worktree", + "source": "trigger-failed", + "target": "has-worktree", "sourcePort": "default" }, { - "id": "classify-incident->is-critical", - "source": "classify-incident", - "target": "is-critical", + "id": "trigger-finalization->has-worktree", + "source": "trigger-finalization", + "target": "has-worktree", "sourcePort": "default" }, { - "id": "is-critical->delay-escalation", - "source": "is-critical", - "target": "delay-escalation", - "sourcePort": "yes", + "id": "has-worktree->refresh-worktree", + "source": "has-worktree", + "target": "refresh-worktree", + "sourcePort": "default", "condition": "$output?.result === true" }, { - "id": "is-critical->create-incident-task", - "source": "is-critical", - "target": "create-incident-task", - "sourcePort": "no", + "id": "has-worktree->no-worktree", + "source": "has-worktree", + "target": "no-worktree", + "sourcePort": "default", "condition": "$output?.result !== true" }, { - "id": "delay-escalation->alert-critical", - "source": "delay-escalation", - "target": "alert-critical", + "id": "refresh-worktree->repair-agent", + "source": "refresh-worktree", + "target": "repair-agent", "sourcePort": "default" }, { - "id": "alert-critical->create-incident-task", - "source": "alert-critical", - "target": "create-incident-task", + "id": "repair-agent->verify", + "source": "repair-agent", + "target": "verify", "sourcePort": "default" }, { - "id": "create-incident-task->alert-standard", - "source": "create-incident-task", - "target": "alert-standard", + "id": "verify->verify-passed", + "source": "verify", + "target": "verify-passed", "sourcePort": "default" }, { - "id": "create-incident-task->should-assign", - "source": "create-incident-task", - "target": "should-assign", + "id": "verify-passed->create-pr", + "source": "verify-passed", + "target": "create-pr", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "verify-passed->mark-todo", + "source": "verify-passed", + "target": "mark-todo", + "sourcePort": "default", + "condition": "$output?.result !== true" + }, + { + "id": "create-pr->create-pr-success", + "source": "create-pr", + "target": "create-pr-success", "sourcePort": "default" }, { - "id": "should-assign->assign-agent", - "source": "should-assign", - "target": "assign-agent", + "id": "create-pr-success->mark-inreview", + "source": "create-pr-success", + "target": "mark-inreview", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "should-assign->resolution-log", - "source": "should-assign", - "target": "resolution-log", + "id": "create-pr-success->mark-todo", + "source": "create-pr-success", + "target": "mark-todo", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "assign-agent->resolution-log", - "source": "assign-agent", - "target": "resolution-log", + "id": "mark-inreview->handoff-pr-progressor", + "source": "mark-inreview", + "target": "handoff-pr-progressor", + "sourcePort": "default" + }, + { + "id": "handoff-pr-progressor->notify-success", + "source": "handoff-pr-progressor", + "target": "notify-success", + "sourcePort": "default" + }, + { + "id": "mark-todo->notify-escalate", + "source": "mark-todo", + "target": "notify-escalate", + "sourcePort": "default" + }, + { + "id": "no-worktree->notify-escalate", + "source": "no-worktree", + "target": "notify-escalate", "sourcePort": "default" } ] }, { - "id": "template-sync-engine", - "name": "Kanban Sync Engine", - "description": "Two-way synchronisation between internal task store and external kanban backends (GitHub Issues, Jira). Pulls new/changed tasks from the external board, pushes internal status updates outward, detects conflicts, and handles rate-limit back-off.", - "category": "reliability", - "categoryLabel": "Reliability", + "id": "template-task-status-transition-manager", + "name": "Task Status Transition Manager", + "description": "Central workflow-owned task status transitions. Consumes task lifecycle transition requests from executors/monitor and applies canonical status updates.", + "category": "reliability", + "categoryLabel": "Reliability", "categoryIcon": ":shield:", "categoryOrder": 5, "tags": [ - "sync", - "kanban", - "github", - "jira", - "bidirectional" + "task", + "status", + "lifecycle", + "workflow-owned" ], - "nodeCount": 12, - "edgeCount": 14, + "nodeCount": 7, + "edgeCount": 6, "recommended": true, "enabled": true, "trigger": "trigger.event", - "variables": { - "syncPolicy": "internal-primary", - "syncIntervalMs": 60000, - "failureAlertThreshold": 3, - "rateLimitAlertThreshold": 3, - "backoffIntervalMs": 300000, - "backoffThreshold": 5 - }, + "variables": {}, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2025-06-01T00:00:00Z", + "createdAt": "2026-02-27T00:00:00Z", "templateVersion": "1.0.1", "tags": [ - "sync", - "kanban", - "github", - "jira", - "bidirectional" + "task", + "status", + "lifecycle", + "workflow-owned" ], "replaces": { - "module": "sync-engine.mjs", + "module": "task-executor.mjs", "functions": [ - "SyncEngine.pullFromExternal", - "SyncEngine.pushToExternal", - "SyncEngine.sync" + "direct status transition writes" ], "calledFrom": [ - "monitor.mjs:initSyncEngine", - "sync-engine.mjs:SyncEngine.start" + "task-executor.mjs:executeTask", + "task-executor.mjs:_recoverInterruptedInProgressTasks", + "task-executor.mjs:_handleTaskResult" ], - "description": "Replaces the SyncEngine class lifecycle with a workflow. Pull/push/rate-limit steps become visible, auditable nodes. Event-driven triggers replace the fixed-interval timer, and failure alerting is built into the flow." + "description": "Moves task state mutations from executor code into a dedicated workflow so all status changes are auditable and event-driven." } }, "nodes": [ { "id": "trigger", "type": "trigger.event", - "label": "Sync Trigger", - "config": { - "eventType": "sync.requested", - "description": "Fires on task status changes, startup, or periodic heartbeat", - "intervalMs": "{{syncIntervalMs}}" - }, - "position": { - "x": 400, - "y": 50 - }, - "outputs": [ - "default" - ] - }, - { - "id": "pull-external", - "type": "action.run_command", - "label": "Pull from External", + "label": "Transition Requested", "config": { - "command": "node -e \"const {createSyncEngine} = await import('./sync-engine.mjs'); const engine = createSyncEngine({projectId: '{{projectId}}'}); const result = await engine.pullFromExternal(); console.log(JSON.stringify(result));\" ", - "timeoutMs": 120000, - "continueOnError": true + "eventType": "task.transition.requested" }, "position": { - "x": 200, - "y": 200 + "x": 420, + "y": 60 }, "outputs": [ "default" ] }, { - "id": "pull-ok", - "type": "condition.expression", - "label": "Pull Succeeded?", - "config": { - "expression": "(() => { const out = $ctx.getNodeOutput('pull-external'); return out?.success !== false && (!out?.errors || out.errors.length === 0); })()" - }, - "position": { - "x": 200, - "y": 380 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "push-internal", - "type": "action.run_command", - "label": "Push to External", + "id": "route-status", + "type": "condition.switch", + "label": "Route Target Status", "config": { - "command": "node -e \"const {createSyncEngine} = await import('./sync-engine.mjs'); const engine = createSyncEngine({projectId: '{{projectId}}'}); const result = await engine.pushToExternal(); console.log(JSON.stringify(result));\" ", - "timeoutMs": 120000, - "continueOnError": true + "value": "$data?.targetStatus || $data?.status || ''", + "cases": { + "inprogress": "inprogress", + "inreview": "inreview", + "done": "done", + "todo": "todo" + } }, "position": { - "x": 200, - "y": 530 + "x": 420, + "y": 220 }, "outputs": [ + "inprogress", + "inreview", + "done", + "todo", "default" ] }, { - "id": "push-ok", - "type": "condition.expression", - "label": "Push Succeeded?", - "config": { - "expression": "(() => { const out = $ctx.getNodeOutput('push-internal'); return out?.success !== false && (!out?.errors || out.errors.length === 0); })()" - }, - "position": { - "x": 200, - "y": 700 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "check-rate-limit", - "type": "condition.expression", - "label": "Rate Limited?", - "config": { - "expression": "(() => { const pull = $ctx.getNodeOutput('pull-external'); const push = $ctx.getNodeOutput('push-internal'); const allErrors = [...(pull?.errors || []), ...(push?.errors || [])]; const rateLimitHits = allErrors.filter(e => /rate.limit|429|throttl/i.test(String(e))).length; return rateLimitHits >= ($data?.rateLimitAlertThreshold || 3); })()" - }, - "position": { - "x": 500, - "y": 700 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "handle-rate-limit", - "type": "action.handle_rate_limit", - "label": "Back-off & Retry", + "id": "set-inprogress", + "type": "action.update_task_status", + "label": "Set In Progress", "config": { - "delayMs": "{{backoffIntervalMs}}", - "maxRetries": "{{backoffThreshold}}", - "reason": "External kanban rate limit hit during sync" + "taskId": "{{taskId}}", + "status": "inprogress", + "taskTitle": "{{taskTitle}}" }, "position": { - "x": 700, - "y": 700 + "x": 120, + "y": 390 }, "outputs": [ "default" ] }, { - "id": "count-failures", - "type": "action.set_variable", - "label": "Track Consecutive Failures", + "id": "set-inreview", + "type": "action.update_task_status", + "label": "Set In Review", "config": { - "key": "consecutiveFailures", - "value": "(() => { const prev = Number($data?.consecutiveFailures || 0); return prev + 1; })()", - "isExpression": true + "taskId": "{{taskId}}", + "status": "inreview", + "taskTitle": "{{taskTitle}}" }, "position": { - "x": 500, - "y": 380 + "x": 320, + "y": 390 }, "outputs": [ "default" ] }, { - "id": "should-alert", - "type": "condition.expression", - "label": "Alert Threshold?", - "config": { - "expression": "Number($data?.consecutiveFailures || 0) >= Number($data?.failureAlertThreshold || 3)" - }, - "position": { - "x": 500, - "y": 530 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "alert-failures", - "type": "notify.telegram", - "label": "Sync Failure Alert", + "id": "set-done", + "type": "action.update_task_status", + "label": "Set Done", "config": { - "message": ":warning: Kanban sync has failed **{{consecutiveFailures}}** consecutive times.\nPolicy: {{syncPolicy}}\nLast errors: {{lastSyncErrors}}" + "taskId": "{{taskId}}", + "status": "done", + "taskTitle": "{{taskTitle}}" }, "position": { - "x": 700, - "y": 530 + "x": 520, + "y": 390 }, "outputs": [ "default" ] }, { - "id": "log-success", - "type": "notify.log", - "label": "Log Sync Success", + "id": "set-todo", + "type": "action.update_task_status", + "label": "Set Todo", "config": { - "message": "Kanban sync complete — pulled: {{pullCount}}, pushed: {{pushCount}}, conflicts: {{conflictCount}}", - "level": "info" + "taskId": "{{taskId}}", + "status": "todo", + "taskTitle": "{{taskTitle}}" }, "position": { - "x": 200, - "y": 880 + "x": 720, + "y": 390 }, "outputs": [ "default" ] }, { - "id": "log-partial", + "id": "unknown-status", "type": "notify.log", - "label": "Log Partial Sync", + "label": "Unknown Status Requested", "config": { - "message": "Kanban sync partial — some operations failed. Errors: {{lastSyncErrors}}", + "message": "Task {{taskId}} transition ignored: unsupported target status '{{targetStatus}}'", "level": "warn" }, "position": { - "x": 500, - "y": 880 + "x": 420, + "y": 520 }, "outputs": [ "default" @@ -13876,143 +12901,100 @@ ], "edges": [ { - "id": "trigger->pull-external", + "id": "trigger->route-status", "source": "trigger", - "target": "pull-external", - "sourcePort": "default" - }, - { - "id": "pull-external->pull-ok", - "source": "pull-external", - "target": "pull-ok", - "sourcePort": "default" - }, - { - "id": "pull-ok->push-internal", - "source": "pull-ok", - "target": "push-internal", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "pull-ok->count-failures", - "source": "pull-ok", - "target": "count-failures", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "push-internal->push-ok", - "source": "push-internal", - "target": "push-ok", + "target": "route-status", "sourcePort": "default" }, { - "id": "push-ok->check-rate-limit", - "source": "push-ok", - "target": "check-rate-limit", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "push-ok->log-success", - "source": "push-ok", - "target": "log-success", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "check-rate-limit->handle-rate-limit", - "source": "check-rate-limit", - "target": "handle-rate-limit", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "check-rate-limit->count-failures", - "source": "check-rate-limit", - "target": "count-failures", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "handle-rate-limit->log-partial", - "source": "handle-rate-limit", - "target": "log-partial", - "sourcePort": "default" + "id": "route-status->set-inprogress", + "source": "route-status", + "target": "set-inprogress", + "sourcePort": "inprogress" }, { - "id": "count-failures->should-alert", - "source": "count-failures", - "target": "should-alert", - "sourcePort": "default" + "id": "route-status->set-inreview", + "source": "route-status", + "target": "set-inreview", + "sourcePort": "inreview" }, { - "id": "should-alert->alert-failures", - "source": "should-alert", - "target": "alert-failures", - "sourcePort": "yes", - "condition": "$output?.result === true" + "id": "route-status->set-done", + "source": "route-status", + "target": "set-done", + "sourcePort": "done" }, { - "id": "should-alert->log-partial", - "source": "should-alert", - "target": "log-partial", - "sourcePort": "no", - "condition": "$output?.result !== true" + "id": "route-status->set-todo", + "source": "route-status", + "target": "set-todo", + "sourcePort": "todo" }, { - "id": "alert-failures->log-partial", - "source": "alert-failures", - "target": "log-partial", + "id": "route-status->unknown-status", + "source": "route-status", + "target": "unknown-status", "sourcePort": "default" } ] }, { - "id": "template-recover-blocked-task", - "name": "Recover Blocked Task (Worktree)", - "description": "Sub-workflow invoked once per blocked task by template-recover-blocked-worktrees. Sweeps stale worktrees for the task, acquires a clean one, and unblocks the task so it re-enters the normal task lifecycle. Works across all workspace repos — repo context is sourced entirely from the task's own stored metadata.", + "id": "template-workspace-hygiene", + "name": "Workspace Hygiene", + "description": "Scheduled maintenance sweep: prune orphaned worktrees, kill stale processes, rotate logs, and clean up old agent evidence. Keeps your dev environment lean.", "category": "reliability", "categoryLabel": "Reliability", "categoryIcon": ":shield:", "categoryOrder": 5, "tags": [ - "recovery", + "maintenance", + "cleanup", "worktree", - "blocked", - "resilience", - "sub-workflow" + "hygiene" ], - "nodeCount": 10, + "nodeCount": 8, "edgeCount": 9, "recommended": true, "enabled": true, - "trigger": "trigger.event", + "trigger": "trigger.schedule", "variables": { - "baseBranch": "main", - "defaultTargetBranch": "origin/main" + "staleProcessMaxAge": "15m", + "worktreeMaxAge": "48h", + "logRetentionDays": 7 }, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2026-06-01T00:00:00Z", - "templateVersion": "1.0.0", + "createdAt": "2025-02-25T00:00:00Z", + "templateVersion": "1.0.1", "tags": [ - "recovery", + "maintenance", + "cleanup", "worktree", - "blocked", - "resilience", - "sub-workflow" - ] + "hygiene" + ], + "replaces": { + "module": "maintenance.mjs", + "functions": [ + "runMaintenanceSweep", + "killStaleOrchestrators", + "reapStuckGitPushes", + "cleanupWorktrees" + ], + "calledFrom": [ + "monitor.mjs:startProcess" + ], + "description": "Replaces the hardcoded maintenance sweep with a visual workflow. Worktree pruning, stale process cleanup, log rotation, and git gc become explicit, configurable workflow steps." + } }, "nodes": [ { "id": "trigger", - "type": "trigger.event", - "label": "Recovery Requested", + "type": "trigger.schedule", + "label": "Daily Cleanup", "config": { - "eventType": "task.blocked.recovery_requested" + "intervalMs": 86400000, + "cron": "0 3 * * *" }, "position": { "x": 400, @@ -14023,163 +13005,110 @@ ] }, { - "id": "check-context", - "type": "condition.expression", - "label": "Has Task Context?", - "config": { - "expression": "Boolean($data?.item?.taskId || $data?.taskId) && Boolean($data?.item?.branch || $data?.item?.branchName || $data?.branch || $data?.branchName || $data?.item?.meta?.worktreeFailure?.branch || $data?.meta?.worktreeFailure?.branch) && Boolean($data?.item?.repoRoot || $data?.item?.workspace || $data?.repoRoot || $data?.workspace || $data?.item?.meta?.worktreeFailure?.repoRoot || $data?.meta?.worktreeFailure?.repoRoot)" - }, - "position": { - "x": 400, - "y": 190 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "recover-wt", - "type": "action.recover_worktree", - "label": "Reset Broken Worktree", + "id": "prune-worktrees", + "type": "action.run_command", + "label": "Prune Worktrees", "config": { - "taskId": "{{$data?.item?.taskId || $data?.taskId || ''}}", - "branch": "{{$data?.item?.branch || $data?.item?.branchName || $data?.branch || $data?.branchName || $data?.item?.meta?.worktreeFailure?.branch || $data?.meta?.worktreeFailure?.branch || ''}}", - "repoRoot": "{{$data?.item?.repoRoot || $data?.item?.workspace || $data?.repoRoot || $data?.workspace || $data?.item?.meta?.worktreeFailure?.repoRoot || $data?.meta?.worktreeFailure?.repoRoot || ''}}", - "worktreePath": "{{$data?.item?.worktreePath || $data?.worktreePath || $data?.item?.meta?.worktreeFailure?.worktreePath || $data?.meta?.worktreeFailure?.worktreePath || ''}}" + "command": "node -e \"const cp=require('node:child_process');cp.execSync('git worktree prune',{stdio:'ignore'});const wt=cp.execSync('git worktree list --porcelain',{encoding:'utf8'});const count=(wt.match(/^worktree /gm)||[]).length;process.stdout.write(String(count)+'\\\\n');\"" }, "position": { - "x": 250, - "y": 340 + "x": 150, + "y": 200 }, "outputs": [ "default" ] }, { - "id": "acquire-wt", - "type": "action.acquire_worktree", - "label": "Acquire Clean Worktree", + "id": "kill-stale", + "type": "action.run_command", + "label": "Kill Stale Processes", "config": { - "taskId": "{{$data?.item?.taskId || $data?.taskId || ''}}", - "branch": "{{$data?.item?.branch || $data?.item?.branchName || $data?.branch || $data?.branchName || $data?.item?.meta?.worktreeFailure?.branch || $data?.meta?.worktreeFailure?.branch || ''}}", - "repoRoot": "{{$data?.item?.repoRoot || $data?.item?.workspace || $data?.repoRoot || $data?.workspace || $data?.item?.meta?.worktreeFailure?.repoRoot || $data?.meta?.worktreeFailure?.repoRoot || ''}}", - "baseBranch": "{{$data?.item?.baseBranch || $data?.baseBranch || $data?.item?.meta?.worktreeFailure?.baseBranch || $data?.meta?.worktreeFailure?.baseBranch || baseBranch}}", - "defaultTargetBranch": "{{$data?.item?.defaultTargetBranch || $data?.defaultTargetBranch || $data?.item?.meta?.worktreeFailure?.defaultTargetBranch || $data?.meta?.worktreeFailure?.defaultTargetBranch || defaultTargetBranch}}" + "command": "bosun maintenance --kill-stale --max-age {{staleProcessMaxAge}}", + "continueOnError": true }, "position": { - "x": 250, - "y": 490 + "x": 400, + "y": 200 }, "outputs": [ "default" ] }, { - "id": "check-acquired", - "type": "condition.expression", - "label": "Worktree Acquired?", - "config": { - "expression": "$ctx.getNodeOutput('acquire-wt')?.success === true" - }, - "position": { - "x": 250, - "y": 640 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "unblock-task", - "type": "action.update_task_status", - "label": "Unblock Task", + "id": "rotate-logs", + "type": "action.run_command", + "label": "Rotate Agent Logs", "config": { - "taskId": "{{$data?.item?.taskId || $data?.taskId || ''}}", - "status": "todo", - "taskTitle": "{{$data?.item?.taskTitle || $data?.taskTitle || $data?.item?.taskId || $data?.taskId || ''}}", - "workflowEvent": "task.blocked.recovery_succeeded", - "workflowData": { - "stage": "worktree_recovery", - "result": "recovered", - "branch": "{{$data?.item?.branch || $data?.item?.branchName || $data?.branch || $data?.branchName || $data?.item?.meta?.worktreeFailure?.branch || $data?.meta?.worktreeFailure?.branch || ''}}", - "worktreePath": "{{$ctx.getNodeOutput('acquire-wt')?.worktreePath || ''}}" - } + "command": "find .bosun/logs -name '*.log' -mtime +{{logRetentionDays}} -delete 2>/dev/null; echo 'Rotated'", + "continueOnError": true }, "position": { - "x": 250, - "y": 790 + "x": 650, + "y": 200 }, "outputs": [ "default" ] }, { - "id": "clear-blocked-meta", - "type": "action.bosun_function", - "label": "Clear Blocked Metadata", + "id": "clean-evidence", + "type": "action.run_command", + "label": "Clean Old Evidence", "config": { - "function": "tasks.update", - "args": { - "taskId": "{{$data?.item?.taskId || $data?.taskId || ''}}", - "fields": { - "blockedReason": null, - "meta": "{{(() => { const cur = Object.assign({}, $data?.item?.meta || $data?.meta || {}); delete cur.autoRecovery; delete cur.worktreeFailure; delete cur.consecutiveRecoveryFailures; delete cur.blockedReason; return cur; })()}}" - } - } + "command": "find .bosun/evidence -type f -mtime +{{logRetentionDays}} -delete 2>/dev/null; echo 'Cleaned'", + "continueOnError": true }, "position": { - "x": 250, - "y": 940 + "x": 150, + "y": 380 }, "outputs": [ "default" ] }, { - "id": "log-success", - "type": "notify.log", - "label": "Log Recovery Success", + "id": "check-disk", + "type": "action.run_command", + "label": "Check Disk Usage", "config": { - "message": ":check: Worktree recovery succeeded for task {{$data?.item?.taskId || $data?.taskId}} ({{$data?.item?.taskTitle || $data?.taskTitle || 'unknown'}}). Task unblocked and returned to todo.", - "level": "info" + "command": "du -sh .bosun/ 2>/dev/null || dir /s .bosun 2>nul" }, "position": { - "x": 250, - "y": 1090 + "x": 400, + "y": 380 }, "outputs": [ "default" ] }, { - "id": "log-no-context", - "type": "notify.log", - "label": "Log Missing Context", + "id": "gc-git", + "type": "action.run_command", + "label": "Git GC", "config": { - "message": "Blocked task recovery skipped — missing taskId or branch in dispatch payload. Item: {{JSON.stringify($data?.item || {})}}", - "level": "warn" + "command": "git gc --auto --quiet", + "continueOnError": true }, "position": { - "x": 620, - "y": 340 + "x": 650, + "y": 380 }, "outputs": [ "default" ] }, { - "id": "log-acquire-failed", + "id": "summary", "type": "notify.log", - "label": "Log Acquire Failure", + "label": "Log Summary", "config": { - "message": ":warning: Worktree recovery failed for task {{$data?.item?.taskId || $data?.taskId}} — could not acquire a clean worktree. Branch: {{$data?.item?.branch || $data?.branch || 'unknown'}}. Manual intervention may be required.", - "level": "warn" + "message": "Workspace hygiene sweep completed (max worktree age target: {{worktreeMaxAge}})", + "level": "info" }, "position": { - "x": 620, - "y": 790 + "x": 400, + "y": 540 }, "outputs": [ "default" @@ -14188,117 +13117,102 @@ ], "edges": [ { - "id": "trigger->check-context", + "id": "trigger->prune-worktrees", "source": "trigger", - "target": "check-context", + "target": "prune-worktrees", "sourcePort": "default" }, { - "id": "check-context->recover-wt", - "source": "check-context", - "target": "recover-wt", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "check-context->log-no-context", - "source": "check-context", - "target": "log-no-context", - "sourcePort": "no", - "condition": "$output?.result !== true" + "id": "trigger->kill-stale", + "source": "trigger", + "target": "kill-stale", + "sourcePort": "default" }, { - "id": "recover-wt->acquire-wt", - "source": "recover-wt", - "target": "acquire-wt", + "id": "trigger->rotate-logs", + "source": "trigger", + "target": "rotate-logs", "sourcePort": "default" }, { - "id": "acquire-wt->check-acquired", - "source": "acquire-wt", - "target": "check-acquired", + "id": "prune-worktrees->clean-evidence", + "source": "prune-worktrees", + "target": "clean-evidence", "sourcePort": "default" }, { - "id": "check-acquired->unblock-task", - "source": "check-acquired", - "target": "unblock-task", - "sourcePort": "yes", - "condition": "$output?.result === true" + "id": "kill-stale->check-disk", + "source": "kill-stale", + "target": "check-disk", + "sourcePort": "default" }, { - "id": "check-acquired->log-acquire-failed", - "source": "check-acquired", - "target": "log-acquire-failed", - "sourcePort": "no", - "condition": "$output?.result !== true" + "id": "rotate-logs->gc-git", + "source": "rotate-logs", + "target": "gc-git", + "sourcePort": "default" }, { - "id": "unblock-task->clear-blocked-meta", - "source": "unblock-task", - "target": "clear-blocked-meta", + "id": "clean-evidence->summary", + "source": "clean-evidence", + "target": "summary", "sourcePort": "default" }, { - "id": "clear-blocked-meta->log-success", - "source": "clear-blocked-meta", - "target": "log-success", + "id": "check-disk->summary", + "source": "check-disk", + "target": "summary", + "sourcePort": "default" + }, + { + "id": "gc-git->summary", + "source": "gc-git", + "target": "summary", "sourcePort": "default" } ] }, { - "id": "template-recover-blocked-worktrees", - "name": "Recover Blocked Worktree Tasks", - "description": "Scheduled operator-assist workflow that finds all tasks blocked due to worktree failures, sweeps their stale worktrees, and re-queues each as todo. Works across every repo in the workspace — repo context is read from each task's own metadata, so no repo configuration is needed here.", - "category": "reliability", - "categoryLabel": "Reliability", - "categoryIcon": ":shield:", - "categoryOrder": 5, + "id": "template-research-agent", + "name": "Iterative Research Agent", + "description": "An iterative research agent inspired by Google DeepMind's Aletheia. Generates a candidate solution, verifies it with an independent model, and routes through revision (minor fixes) or full regeneration (critical flaws) cycles until the solution converges or max iterations are reached. Supports web search for literature navigation.", + "category": "research", + "categoryLabel": "Research", + "categoryIcon": ":search:", + "categoryOrder": 6, "tags": [ - "recovery", - "worktree", - "blocked", - "resilience", - "automation", - "scheduled" + "research", + "aletheia", + "convergence-loop", + "back-edge" ], - "nodeCount": 7, - "edgeCount": 6, - "recommended": true, + "nodeCount": 10, + "edgeCount": 11, + "recommended": false, "enabled": true, - "trigger": "trigger.schedule", + "trigger": "trigger.manual", "variables": { - "scheduleIntervalMs": 1800000, - "maxPerSweep": 20, - "maxConcurrent": 2 + "maxIterations": 10, + "problem": "", + "domain": "mathematics" }, "metadata": { - "author": "bosun", + "createdAt": "2026-03-03T00:00:00.000Z", "version": 1, - "createdAt": "2026-06-01T00:00:00Z", - "templateVersion": "1.0.0", + "author": "bosun", "tags": [ - "recovery", - "worktree", - "blocked", - "resilience", - "automation", - "scheduled" - ], - "requiredTemplates": [ - "template-recover-blocked-task" + "research", + "aletheia", + "convergence-loop", + "back-edge" ] }, "nodes": [ { "id": "trigger", - "type": "trigger.schedule", - "label": "Scheduled Worktree Recovery Sweep", - "config": { - "intervalMs": "{{scheduleIntervalMs}}", - "cron": "*/30 * * * *" - }, + "type": "trigger.manual", + "label": "Start Research", + "config": {}, "position": { "x": 400, "y": 50 @@ -14308,112 +13222,165 @@ ] }, { - "id": "query-blocked", - "type": "action.run_command", - "label": "Query Blocked Tasks", + "id": "literature-search", + "type": "action.web_search", + "label": "Search Literature", "config": { - "command": "node", - "args": [ - "-e", - "\n const fs = require(\"node:fs\");\n const path = require(\"node:path\");\n const { pathToFileURL } = require(\"node:url\");\n let repoRoot = process.cwd();\n const mirrorMarker = (path.sep + \".bosun\" + path.sep + \"workspaces\" + path.sep).toLowerCase();\n if (repoRoot.toLowerCase().includes(mirrorMarker)) {\n const r = path.resolve(repoRoot, \"..\", \"..\", \"..\", \"..\");\n if (fs.existsSync(path.join(r, \"kanban\", \"kanban-adapter.mjs\"))) repoRoot = r;\n }\n const kanbanUrl = pathToFileURL(path.join(repoRoot, \"kanban\", \"kanban-adapter.mjs\")).href;\n import(kanbanUrl)\n .then(k => k.listTasks(undefined, { status: \"blocked\" }))\n .then(tasks => {\n const limit = parseInt(process.env.MAX_PER_SWEEP || \"20\");\n const blocked = (tasks || [])\n .map(t => {\n const meta = t && typeof t.meta === \"object\" ? t.meta : {};\n const worktreeFailure = meta && typeof meta.worktreeFailure === \"object\" ? meta.worktreeFailure : {};\n const branch = t?.branch || t?.branchName || t?.metadata?.branch || meta?.branch || worktreeFailure?.branch || null;\n const repoRoot = t?.repoRoot || t?.workspace || t?.metadata?.repoRoot || t?.metadata?.workspace || meta?.repoRoot || meta?.workspace || worktreeFailure?.repoRoot || null;\n const worktreePath = t?.worktreePath || t?.metadata?.worktreePath || meta?.worktreePath || worktreeFailure?.worktreePath || null;\n const baseBranch = t?.baseBranch || t?.metadata?.baseBranch || meta?.baseBranch || worktreeFailure?.baseBranch || null;\n const defaultTargetBranch = t?.defaultTargetBranch || t?.metadata?.defaultTargetBranch || meta?.defaultTargetBranch || worktreeFailure?.defaultTargetBranch || null;\n return {\n taskId: t?.id,\n taskTitle: t?.title || t?.id,\n branch,\n repoRoot,\n worktreePath,\n repository: t?.repository || t?.metadata?.repository || meta?.repository || null,\n baseBranch,\n defaultTargetBranch,\n meta,\n };\n })\n .filter(t => t && t.taskId && t.branch && t.repoRoot)\n .slice(0, limit)\n ;\n console.log(JSON.stringify(blocked));\n })\n .catch(e => { console.error(e.message); process.exit(1); });\n " - ], - "env": { - "MAX_PER_SWEEP": "{{maxPerSweep}}" - }, - "parseJson": true + "query": "{{problem}} {{domain}} research papers", + "maxResults": 5, + "engine": "fetch" }, "position": { "x": 400, - "y": 190 + "y": 160 }, "outputs": [ "default" ] }, { - "id": "check-has-tasks", - "type": "condition.expression", - "label": "Any Blocked Tasks?", + "id": "generator", + "type": "action.run_agent", + "label": "Generate Solution", "config": { - "expression": "Array.isArray($ctx.getNodeOutput('query-blocked')?.output) && $ctx.getNodeOutput('query-blocked').output.length > 0" + "prompt": "# Research Problem — Generate a Candidate Solution\n\n## Problem\n{{problem}}\n\n## Domain\n{{domain}}\n\n## Configuration\nMax verification cycles: {{maxIterations}}\n\n## Literature Context\n{{literature-search.results}}\n\n## Previous Attempts\n{{_previousFeedback}}\n\n## Instructions\nYou are a research agent solving a challenging problem in {{domain}}.\nProduce a rigorous, well-structured candidate solution. Show your\nreasoning step-by-step. If this is a retry after a critical flaw,\ntake a fundamentally different approach.\n\nProvide your solution in a clear format with:\n1. Approach overview\n2. Detailed proof/derivation/analysis\n3. Verification of key steps\n4. Final answer/conclusion", + "sdk": "auto", + "timeoutMs": 1800000, + "failOnError": false }, "position": { "x": 400, - "y": 360 + "y": 280 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "recover-each", - "type": "loop.for_each", - "label": "Recover Each Blocked Task", + "id": "verifier", + "type": "action.run_agent", + "label": "Verify Solution", "config": { - "items": "$ctx.getNodeOutput('query-blocked')?.output || []", - "variable": "item", - "indexVariable": "recoveryIndex", - "maxConcurrent": "{{maxConcurrent}}", - "workflowId": "template-recover-blocked-task", - "mode": "dispatch" + "prompt": "# Independent Verification\n\n## Original Problem\n{{problem}}\n\n## Candidate Solution\n{{generator.output}}\n\n## Instructions\nYou are an independent verifier. Rigorously check the candidate solution:\n1. Is the logic/proof valid at every step?\n2. Are there any gaps, errors, or unjustified assumptions?\n3. Is the conclusion correct and complete?\n\nProvide your assessment with ONE of these verdicts:\n\n**VERDICT: CORRECT** — The solution is rigorous and complete.\n**VERDICT: MINOR** — The solution has the right approach but needs fixes. List specific issues.\n**VERDICT: CRITICAL** — The solution is fundamentally flawed. Explain why.\n\nAfter the verdict, provide detailed feedback explaining your reasoning.", + "sdk": "auto", + "timeoutMs": 900000, + "failOnError": false }, "position": { "x": 400, - "y": 510 + "y": 420 }, "outputs": [ "default" ] }, { - "id": "prune-worktrees", - "type": "action.run_command", - "label": "Prune Stale Worktree Refs", + "id": "parse-verdict", + "type": "transform.llm_parse", + "label": "Parse Verdict", "config": { - "command": "git", - "args": [ - "worktree", - "prune", - "--verbose" - ], - "continueOnError": true + "input": "verifier", + "field": "output", + "patterns": { + "verdict": "VERDICT:\\s*(CORRECT|MINOR|CRITICAL)" + }, + "keywords": { + "severity": [ + "correct", + "minor", + "critical" + ] + }, + "outputPort": "verdict" }, "position": { "x": 400, - "y": 650 + "y": 540 }, "outputs": [ "default" ] }, { - "id": "log-summary", + "id": "output-result", "type": "notify.log", - "label": "Log Recovery Summary", + "label": "Solution Found!", "config": { - "message": ":broom: Blocked worktree recovery sweep dispatched for {{$ctx.getNodeOutput('query-blocked')?.output?.length || 0}} task(s). maxConcurrent={{maxConcurrent}} maxPerSweep={{maxPerSweep}}", + "message": "Research complete! Solution verified as correct.\n\nProblem: {{problem}}\nSolution: {{generator.output}}", "level": "info" }, "position": { - "x": 250, - "y": 790 + "x": 100, + "y": 680 }, "outputs": [ "default" ] }, { - "id": "log-idle", + "id": "end-success", + "type": "flow.end", + "label": "End Research (Success)", + "config": { + "status": "completed", + "message": "Research workflow converged to a verified solution", + "output": { + "verdict": "correct", + "problem": "{{problem}}" + } + }, + "position": { + "x": 100, + "y": 810 + }, + "outputs": [ + "default" + ] + }, + { + "id": "reviser", + "type": "action.continue_session", + "label": "Revise Solution", + "config": { + "prompt": "The verifier found minor issues with your solution:\n\n{{verifier.output}}\n\nPlease fix these specific issues while keeping your overall approach.\nProvide the corrected solution in the same format.", + "strategy": "refine", + "timeoutMs": 900000 + }, + "position": { + "x": 400, + "y": 680 + }, + "outputs": [ + "default" + ] + }, + { + "id": "critical-log", "type": "notify.log", - "label": "Log No Blocked Tasks", + "label": "Critical Flaw Detected", "config": { - "message": "Blocked worktree recovery sweep: no blocked tasks with branch context found.", - "level": "debug" + "message": "Critical flaw in solution — restarting generator with new approach.\nFeedback: {{verifier.output}}", + "level": "warn" }, "position": { - "x": 620, - "y": 510 + "x": 700, + "y": 680 + }, + "outputs": [ + "default" + ] + }, + { + "id": "store-feedback", + "type": "action.set_variable", + "label": "Store Feedback", + "config": { + "variable": "_previousFeedback", + "value": "Previous attempt was critically flawed: {{verifier.output}}. Take a fundamentally different approach." + }, + "position": { + "x": 700, + "y": 800 }, "outputs": [ "default" @@ -14422,109 +13389,116 @@ ], "edges": [ { - "id": "trigger->query-blocked", + "id": "trigger->literature-search", "source": "trigger", - "target": "query-blocked", + "target": "literature-search", "sourcePort": "default" }, { - "id": "query-blocked->check-has-tasks", - "source": "query-blocked", - "target": "check-has-tasks", + "id": "literature-search->generator", + "source": "literature-search", + "target": "generator", "sourcePort": "default" }, { - "id": "check-has-tasks->recover-each", - "source": "check-has-tasks", - "target": "recover-each", - "sourcePort": "yes", - "condition": "$output?.result === true" + "id": "generator->verifier", + "source": "generator", + "target": "verifier", + "sourcePort": "default" }, { - "id": "check-has-tasks->log-idle", - "source": "check-has-tasks", - "target": "log-idle", - "sourcePort": "no", - "condition": "$output?.result !== true" + "id": "verifier->parse-verdict", + "source": "verifier", + "target": "parse-verdict", + "sourcePort": "default" }, { - "id": "recover-each->prune-worktrees", - "source": "recover-each", - "target": "prune-worktrees", + "id": "parse-verdict->output-result", + "source": "parse-verdict", + "target": "output-result", + "sourcePort": "correct" + }, + { + "id": "parse-verdict->reviser", + "source": "parse-verdict", + "target": "reviser", + "sourcePort": "minor" + }, + { + "id": "parse-verdict->critical-log", + "source": "parse-verdict", + "target": "critical-log", + "sourcePort": "critical" + }, + { + "id": "output-result->end-success", + "source": "output-result", + "target": "end-success", "sourcePort": "default" }, { - "id": "prune-worktrees->log-summary", - "source": "prune-worktrees", - "target": "log-summary", + "id": "reviser->verifier", + "source": "reviser", + "target": "verifier", + "sourcePort": "default", + "backEdge": true, + "maxIterations": 5 + }, + { + "id": "critical-log->store-feedback", + "source": "critical-log", + "target": "store-feedback", "sourcePort": "default" + }, + { + "id": "store-feedback->generator", + "source": "store-feedback", + "target": "generator", + "sourcePort": "default", + "backEdge": true, + "maxIterations": 5 } ] }, { - "id": "template-task-archiver", - "name": "Task Archiver", - "description": "Automated archival of completed tasks — migrates old completed/cancelled tasks to local archives, cleans up agent sessions, prunes archives beyond retention, and optionally chains into Sprint Retrospective.", - "category": "reliability", - "categoryLabel": "Reliability", - "categoryIcon": ":shield:", - "categoryOrder": 5, + "id": "template-research-loop", + "name": "Research Loop (While-Based)", + "description": "An iterative research agent using loop.while to repeatedly execute a generate→verify sub-workflow until the solution converges. Alternative to the back-edge approach — useful when you want the iteration logic centralized in a single node.", + "category": "research", + "categoryLabel": "Research", + "categoryIcon": ":search:", + "categoryOrder": 6, "tags": [ - "archive", - "cleanup", - "task", - "maintenance", - "reliability" + "research", + "loop-while", + "convergence" ], - "nodeCount": 11, - "edgeCount": 11, - "recommended": true, + "nodeCount": 5, + "edgeCount": 4, + "recommended": false, "enabled": true, - "trigger": "trigger.event", + "trigger": "trigger.manual", "variables": { - "ageHours": 24, - "maxArchivePerSweep": 50, - "retentionDays": 90, - "pruneEnabled": true, - "dryRun": false + "maxIterations": 10, + "problem": "", + "domain": "mathematics" }, "metadata": { - "author": "bosun", + "createdAt": "2026-03-03T00:00:00.000Z", "version": 1, - "createdAt": "2025-06-01T00:00:00Z", - "templateVersion": "1.0.1", + "author": "bosun", "tags": [ - "archive", - "cleanup", - "task", - "maintenance", - "reliability" - ], - "replaces": { - "module": "task-archiver.mjs", - "functions": [ - "archiveCompletedTasks", - "archiveTaskToFile", - "cleanupAgentSessions", - "pruneOldArchives", - "deleteTaskFromVK" - ], - "calledFrom": [ - "monitor.mjs:startup", - "monitor.mjs:safeSetInterval(archiveCompletedTasks)" - ], - "description": "Replaces the monolithic archiveCompletedTasks sweep with an event-driven workflow. Each task completion fires the archiver instead of a periodic cron sweep, enabling per-task auditing and eliminating batch-scan overhead." - } + "research", + "loop-while", + "convergence" + ] }, "nodes": [ { "id": "trigger", - "type": "trigger.event", - "label": "Task Completed", - "config": { - "eventType": "task.status_changed", - "filter": "($event?.newStatus === 'done' || $event?.newStatus === 'cancelled')" - }, + "type": "trigger.manual", + "label": "Start Research", + "config": {}, "position": { "x": 400, "y": 50 @@ -14534,165 +13508,348 @@ ] }, { - "id": "check-age", - "type": "condition.expression", - "label": "Old Enough to Archive?", + "id": "search", + "type": "action.web_search", + "label": "Search Literature", "config": { - "expression": "(() => { const completedAt = new Date($data?.completedAt || $data?.updatedAt || 0); if (isNaN(completedAt.getTime())) return false; const ageHours = (Date.now() - completedAt.getTime()) / (1000 * 60 * 60); return ageHours >= ($data?.ageHours || 24); })()" + "query": "{{problem}} {{domain}} research", + "maxResults": 5 }, "position": { "x": 400, - "y": 200 + "y": 160 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "check-already-archived", - "type": "condition.expression", - "label": "Already Archived?", + "id": "iterate", + "type": "loop.while", + "label": "Iterate Until Converged", "config": { - "expression": "$data?.alreadyArchived === true" + "condition": "$state._lastSuccess !== true || $state._verdict !== 'correct'", + "workflowId": "{{_researchSubWorkflowId}}", + "maxIterations": "{{maxIterations}}", + "stateVariable": "researchState", + "earlyExitOn": "never" }, "position": { "x": 400, - "y": 350 + "y": 280 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "archive-to-file", - "type": "action.run_command", - "label": "Archive to Daily File", + "id": "output", + "type": "notify.log", + "label": "Research Complete", "config": { - "command": "node -e \"const {archiveTaskToFile} = await import('./task-archiver.mjs'); const result = await archiveTaskToFile(JSON.parse(process.env.TASK_JSON)); console.log(JSON.stringify({success: !!result, path: result}));\" ", - "env": { - "TASK_JSON": "{{taskJson}}", - "MAX_PER_SWEEP": "{{maxArchivePerSweep}}", - "DRY_RUN": "{{dryRun}}" - }, - "continueOnError": true + "message": "Research loop completed after {{iterate.iterations}} iteration(s). Converged: {{iterate.converged}}", + "level": "info" }, "position": { - "x": 200, - "y": 500 + "x": 400, + "y": 400 }, "outputs": [ "default" ] }, { - "id": "cleanup-sessions", - "type": "action.run_command", - "label": "Cleanup Agent Sessions", + "id": "end", + "type": "flow.end", + "label": "End Loop", "config": { - "command": "node -e \"const {cleanupAgentSessions} = await import('./task-archiver.mjs'); const count = await cleanupAgentSessions('{{taskId}}', '{{attemptId}}'); console.log(JSON.stringify({cleaned: count}));\" ", - "continueOnError": true + "status": "completed", + "message": "Research loop workflow completed", + "output": { + "converged": "{{iterate.converged}}", + "iterations": "{{iterate.iterations}}" + } }, "position": { - "x": 200, - "y": 650 + "x": 400, + "y": 520 }, "outputs": [ "default" ] + } + ], + "edges": [ + { + "id": "trigger->search", + "source": "trigger", + "target": "search", + "sourcePort": "default" }, { - "id": "delete-from-backend", - "type": "action.run_command", - "label": "Delete from Backend", + "id": "search->iterate", + "source": "search", + "target": "iterate", + "sourcePort": "default" + }, + { + "id": "iterate->output", + "source": "iterate", + "target": "output", + "sourcePort": "default" + }, + { + "id": "output->end", + "source": "output", + "target": "end", + "sourcePort": "default" + } + ] + }, + { + "id": "template-dependency-audit", + "name": "Dependency Audit", + "description": "Scheduled scan for vulnerable dependencies using npm audit. Classifies findings by severity, prepares fix branches, and hands off fixable packages, and alerts on critical vulnerabilities that require manual intervention.", + "category": "security", + "categoryLabel": "Security", + "categoryIcon": ":lock:", + "categoryOrder": 7, + "tags": [ + "security", + "audit", + "dependencies", + "npm", + "vulnerability" + ], + "nodeCount": 12, + "edgeCount": 14, + "recommended": true, + "enabled": true, + "trigger": "trigger.schedule", + "variables": { + "auditLevel": "moderate", + "autoFixEnabled": true, + "maxAutoFixPRs": 3 + }, + "metadata": { + "author": "bosun", + "version": 1, + "createdAt": "2025-02-25T00:00:00Z", + "templateVersion": "1.0.0", + "tags": [ + "security", + "audit", + "dependencies", + "npm", + "vulnerability" + ], + "replaces": { + "module": "preflight.mjs", + "functions": [ + "checkDependencyHealth" + ], + "calledFrom": [ + "monitor.mjs:startProcess" + ], + "description": "Replaces ad-hoc dependency health checks with a scheduled audit workflow. Severity classification, auto-fix, and Bosun-managed lifecycle handoff become explicit, configurable workflow steps." + } + }, + "nodes": [ + { + "id": "trigger", + "type": "trigger.schedule", + "label": "Daily Audit", "config": { - "command": "node -e \"const {deleteTaskFromVK} = await import('./task-archiver.mjs'); const ok = await deleteTaskFromVK(null, '{{taskId}}'); console.log(JSON.stringify({deleted: ok}));\" ", - "continueOnError": true + "intervalMs": 86400000, + "cron": "0 6 * * *" }, "position": { - "x": 200, - "y": 800 + "x": 400, + "y": 50 }, "outputs": [ "default" ] }, { - "id": "should-prune", - "type": "condition.expression", - "label": "Prune Old Archives?", + "id": "run-audit", + "type": "action.run_command", + "label": "Run npm audit", "config": { - "expression": "Boolean($data?.pruneEnabled !== false)" + "command": "npm audit --json 2>/dev/null || echo '{\"vulnerabilities\":{}}'", + "continueOnError": true }, "position": { - "x": 500, - "y": 800 + "x": 400, + "y": 180 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "prune-archives", - "type": "action.run_command", - "label": "Prune Expired Archives", - "config": { - "command": "node -e \"const {pruneOldArchives} = await import('./task-archiver.mjs'); const count = await pruneOldArchives({retentionDays: {{retentionDays}}}); console.log(JSON.stringify({pruned: count}));\" ", - "continueOnError": true + "id": "parse-results", + "type": "transform.json_parse", + "label": "Parse Audit Results", + "config": { + "input": "$ctx.getNodeOutput('run-audit')?.output || '{}'" }, "position": { - "x": 500, - "y": 950 + "x": 400, + "y": 310 }, "outputs": [ "default" ] }, { - "id": "log-result", - "type": "notify.log", - "label": "Log Archive Result", + "id": "has-vulns", + "type": "condition.expression", + "label": "Vulnerabilities Found?", "config": { - "message": "Task {{taskId}} archived successfully. Sessions cleaned, backend updated.", - "level": "info" + "expression": "(() => { const out = $ctx.getNodeOutput('run-audit')?.output || '{}'; try { const d = JSON.parse(out); const v = d.vulnerabilities || {}; return Object.keys(v).length > 0; } catch { return out.includes('vulnerability') || out.includes('moderate') || out.includes('high') || out.includes('critical'); } })()" }, "position": { "x": 400, - "y": 1100 + "y": 440 + }, + "outputs": [ + "yes", + "no" + ] + }, + { + "id": "classify-severity", + "type": "condition.switch", + "label": "Classify Severity", + "config": { + "value": "(() => { const out = $ctx.getNodeOutput('run-audit')?.output || '{}'; try { const d = JSON.parse(out); const v = d.metadata || {}; if ((v.vulnerabilities?.critical || 0) > 0) return 'critical'; if ((v.vulnerabilities?.high || 0) > 0) return 'high'; return 'moderate'; } catch { if (out.includes('critical')) return 'critical'; if (out.includes('high')) return 'high'; return 'moderate'; } })()", + "cases": { + "critical": "critical", + "high": "high", + "moderate": "moderate" + } + }, + "position": { + "x": 200, + "y": 590 }, "outputs": [ + "critical", + "high", + "moderate", "default" ] }, { - "id": "skip-log", + "id": "auto-fix-enabled", + "type": "condition.expression", + "label": "Auto Fix Enabled?", + "config": { + "expression": "Boolean($data?.autoFixEnabled !== false)" + }, + "position": { + "x": 50, + "y": 670 + }, + "outputs": [ + "yes", + "no" + ] + }, + { + "id": "auto-fix", + "type": "action.run_agent", + "label": "Auto-Fix Vulnerabilities", + "config": { + "prompt": "# Dependency Vulnerability Fix\n\nRun `npm audit fix` to resolve automatically fixable vulnerabilities.\nIf some vulnerabilities require breaking changes:\n1. Review the changelog for each affected package\n2. Only apply `npm audit fix --force` for packages where the breaking change is safe\n3. Run `npm test` after each fix to verify nothing breaks\n4. Create one commit per fixed package group\n\nDo NOT blindly force-fix everything. Test after each change.\nLimit auto-generated fix PRs to {{maxAutoFixPRs}} in this run.", + "sdk": "auto", + "timeoutMs": 1800000 + }, + "position": { + "x": 50, + "y": 750 + }, + "outputs": [ + "default" + ] + }, + { + "id": "create-fix-pr", + "type": "action.create_pr", + "label": "Handoff Fix Lifecycle", + "config": { + "title": "fix(deps): resolve {{auditLevel}}+ vulnerabilities", + "body": "Automated dependency audit fix. Resolves vulnerabilities flagged by `npm audit`.\n\nBosun PR lifecycle handoff context included.", + "branch": "fix/dep-audit-{{_runId}}", + "baseBranch": "main" + }, + "position": { + "x": 50, + "y": 900 + }, + "outputs": [ + "default" + ] + }, + { + "id": "alert-critical", + "type": "notify.telegram", + "label": "Alert: Critical Vuln", + "config": { + "message": ":alert: **CRITICAL vulnerability** found in dependencies!\n\nRun `npm audit` for details. Manual review required." + }, + "position": { + "x": 350, + "y": 750 + }, + "outputs": [ + "default" + ] + }, + { + "id": "alert-high", + "type": "notify.telegram", + "label": "Alert: High Severity", + "config": { + "message": ":alert: **High severity** dependency vulnerability detected.\n\nAuto-fix changes prepared and handed off to Bosun PR lifecycle management. Please review and merge when ready.", + "silent": true + }, + "position": { + "x": 550, + "y": 750 + }, + "outputs": [ + "default" + ] + }, + { + "id": "log-clean", "type": "notify.log", - "label": "Skip — Not Ready", + "label": "No Vulnerabilities", "config": { - "message": "Task {{taskId}} not yet old enough to archive (threshold: {{ageHours}}h)", - "level": "debug" + "message": "Dependency audit clean — no vulnerabilities found", + "level": "info" }, "position": { - "x": 600, - "y": 350 + "x": 650, + "y": 440 }, "outputs": [ "default" ] }, { - "id": "already-archived-log", + "id": "log-done", "type": "notify.log", - "label": "Already Archived", + "label": "Audit Complete", "config": { - "message": "Task {{taskId}} was already archived — skipping", - "level": "debug" + "message": "Dependency audit complete — fixes applied where possible", + "level": "info" }, "position": { - "x": 600, - "y": 500 + "x": 300, + "y": 1050 }, "outputs": [ "default" @@ -14701,138 +13858,150 @@ ], "edges": [ { - "id": "trigger->check-age", + "id": "trigger->run-audit", "source": "trigger", - "target": "check-age", + "target": "run-audit", "sourcePort": "default" }, { - "id": "check-age->check-already-archived", - "source": "check-age", - "target": "check-already-archived", - "sourcePort": "yes", - "condition": "$output?.result === true" + "id": "run-audit->parse-results", + "source": "run-audit", + "target": "parse-results", + "sourcePort": "default" }, { - "id": "check-age->skip-log", - "source": "check-age", - "target": "skip-log", - "sourcePort": "no", - "condition": "$output?.result !== true" + "id": "parse-results->has-vulns", + "source": "parse-results", + "target": "has-vulns", + "sourcePort": "default" }, { - "id": "check-already-archived->already-archived-log", - "source": "check-already-archived", - "target": "already-archived-log", + "id": "has-vulns->classify-severity", + "source": "has-vulns", + "target": "classify-severity", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "check-already-archived->archive-to-file", - "source": "check-already-archived", - "target": "archive-to-file", + "id": "has-vulns->log-clean", + "source": "has-vulns", + "target": "log-clean", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "archive-to-file->cleanup-sessions", - "source": "archive-to-file", - "target": "cleanup-sessions", - "sourcePort": "default" + "id": "classify-severity->alert-critical", + "source": "classify-severity", + "target": "alert-critical", + "sourcePort": "critical" }, { - "id": "cleanup-sessions->delete-from-backend", - "source": "cleanup-sessions", - "target": "delete-from-backend", - "sourcePort": "default" + "id": "classify-severity->auto-fix-enabled", + "source": "classify-severity", + "target": "auto-fix-enabled", + "sourcePort": "high" }, { - "id": "delete-from-backend->should-prune", - "source": "delete-from-backend", - "target": "should-prune", + "id": "classify-severity->auto-fix-enabled", + "source": "classify-severity", + "target": "auto-fix-enabled", + "sourcePort": "moderate" + }, + { + "id": "alert-critical->auto-fix-enabled", + "source": "alert-critical", + "target": "auto-fix-enabled", "sourcePort": "default" }, { - "id": "should-prune->prune-archives", - "source": "should-prune", - "target": "prune-archives", + "id": "auto-fix-enabled->auto-fix", + "source": "auto-fix-enabled", + "target": "auto-fix", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "should-prune->log-result", - "source": "should-prune", - "target": "log-result", + "id": "auto-fix-enabled->log-done", + "source": "auto-fix-enabled", + "target": "log-done", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "prune-archives->log-result", - "source": "prune-archives", - "target": "log-result", + "id": "auto-fix->create-fix-pr", + "source": "auto-fix", + "target": "create-fix-pr", + "sourcePort": "default" + }, + { + "id": "create-fix-pr->alert-high", + "source": "create-fix-pr", + "target": "alert-high", + "sourcePort": "default" + }, + { + "id": "alert-high->log-done", + "source": "alert-high", + "target": "log-done", "sourcePort": "default" } ] }, { - "id": "template-task-finalization-guard", - "name": "Task Finalization Guard", - "description": "Shared post-completion quality gate for all agents. Runs pre-push validation in the task worktree, normalizes status transitions, and hands off failures to a dedicated repair workflow.", - "category": "reliability", - "categoryLabel": "Reliability", - "categoryIcon": ":shield:", - "categoryOrder": 5, + "id": "template-secret-scanner", + "name": "Secret Scanner", + "description": "Scans the repository for accidentally committed secrets, API keys, tokens, and credentials. Alerts immediately on detection and can auto-rotate exposed secrets via an agent.", + "category": "security", + "categoryLabel": "Security", + "categoryIcon": ":lock:", + "categoryOrder": 7, "tags": [ - "finalization", - "quality-gate", - "prepush", - "handoff", - "reliability" + "security", + "secrets", + "scanner", + "credentials", + "rotation" ], - "nodeCount": 18, - "edgeCount": 21, - "recommended": true, - "enabled": true, - "trigger": "trigger.event", + "nodeCount": 9, + "edgeCount": 8, + "recommended": false, + "enabled": false, + "trigger": "trigger.schedule", "variables": { - "finalizationTimeoutMs": 3600000, - "baseBranch": "main", - "finalizationCommand": "node -e \"const cp=require('node:child_process');const cmds=['npm run prepush --if-present','npm run prepush:check --if-present','npm run build','npm test','npm run lint --if-present'];for(const cmd of cmds){cp.execSync(cmd,{stdio:'inherit'});} \"" + "scanPatterns": "PRIVATE_KEY|SECRET|TOKEN|PASSWORD|API_KEY|CREDENTIAL", + "excludePaths": "node_modules,.git,*.lock,*.min.js" }, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2026-02-26T00:00:00Z", - "templateVersion": "1.0.1", + "createdAt": "2025-02-25T00:00:00Z", + "templateVersion": "1.0.0", "tags": [ - "finalization", - "quality-gate", - "prepush", - "handoff", - "reliability" - ], - "requiredTemplates": [ - "template-task-archiver", - "template-bosun-pr-progressor" + "security", + "secrets", + "scanner", + "credentials", + "rotation" ], "replaces": { - "module": "task-executor.mjs", + "module": "preflight.mjs", "functions": [ - "_handleTaskResult finalization gate" + "checkGitSecrets" ], "calledFrom": [ - "task-executor.mjs:_handleTaskResult" + "preflight.mjs:runAllChecks" ], - "description": "Adds a shared post-completion finalization workflow so task quality checks and status transitions are consistent across all agents." + "description": "Replaces manual secret scanning with an automated workflow. Regex scanning, AI-powered classification, and alerting become structured, scheduled workflow steps." } }, "nodes": [ { "id": "trigger", - "type": "trigger.event", - "label": "Task Completed", + "type": "trigger.schedule", + "label": "Hourly Scan", "config": { - "eventType": "task.completed" + "intervalMs": 3600000, + "cron": "0 * * * *" }, "position": { "x": 400, @@ -14843,100 +14012,63 @@ ] }, { - "id": "has-worktree", - "type": "condition.expression", - "label": "Worktree Context Available?", - "config": { - "expression": "Boolean($data?.worktreePath)" - }, - "position": { - "x": 400, - "y": 190 - }, - "outputs": [ - "default" - ] - }, - { - "id": "run-finalization", + "id": "scan-repo", "type": "action.run_command", - "label": "Run Finalization Checks", + "label": "Scan for Secrets", "config": { - "command": "{{finalizationCommand}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{finalizationTimeoutMs}}", + "command": "git log --diff-filter=A -p HEAD~5..HEAD -- . ':!node_modules' ':!*.lock' ':!*.min.js' | grep -iE '({{scanPatterns}})\\s*[:=]\\s*[\"\\x27][^\"\\x27]{8,}' || echo 'CLEAN'", "continueOnError": true }, "position": { - "x": 220, - "y": 330 - }, - "outputs": [ - "default" - ] - }, - { - "id": "checks-passed", - "type": "condition.expression", - "label": "Checks Passed?", - "config": { - "expression": "$ctx.getNodeOutput('run-finalization')?.success === true" - }, - "position": { - "x": 220, - "y": 470 + "x": 400, + "y": 180 }, "outputs": [ "default" ] }, { - "id": "has-pr", + "id": "has-secrets", "type": "condition.expression", - "label": "Lifecycle Already Linked?", + "label": "Secrets Found?", "config": { - "expression": "Boolean($data?.prNumber || $data?.prUrl)" + "expression": "!($ctx.getNodeOutput('scan-repo')?.output || '').includes('CLEAN') && ($ctx.getNodeOutput('scan-repo')?.output || '').trim().length > 0" }, "position": { - "x": 120, - "y": 620 + "x": 400, + "y": 330 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "create-pr", - "type": "action.create_pr", - "label": "Handoff Lifecycle If Missing", + "id": "classify-secret", + "type": "action.run_agent", + "label": "Classify & Assess Risk", "config": { - "title": "{{taskTitle}}", - "body": "Bosun-managed PR lifecycle handoff from task finalization guard for task {{taskId}}.", - "base": "{{baseBranch}}", - "branch": "{{branch}}", - "failOnError": true, - "maxRetries": 3, - "retryDelayMs": 15000, - "continueOnError": true + "prompt": "# Secret Detection Analysis\n\nThe following content was flagged as potentially containing secrets:\n\n```\n{{scanOutput}}\n```\n\nAnalyze each finding and classify:\n1. **TRUE POSITIVE** — Real secret/credential that needs rotation\n2. **FALSE POSITIVE** — Not a real secret (example value, test data, etc.)\n\nFor each true positive:\n- Identify the type (API key, password, token, private key, etc.)\n- Assess the blast radius (what services could be compromised)\n- Recommend immediate action (rotate, revoke, etc.)\n\nRespond as JSON: { \"findings\": [{ \"type\": \"...\", \"severity\": \"critical|high|low\", \"truePositive\": true/false, \"recommendation\": \"...\" }] }", + "timeoutMs": 300000 }, "position": { - "x": 120, - "y": 760 + "x": 200, + "y": 490 }, "outputs": [ "default" ] }, { - "id": "create-pr-success", + "id": "has-true-positive", "type": "condition.expression", - "label": "Lifecycle Handoff Recorded?", + "label": "Any True Positives?", "config": { - "expression": "$ctx.getNodeOutput('create-pr')?.success === true" + "expression": "($ctx.getNodeOutput('classify-secret')?.output || '').includes('\"truePositive\": true') || ($ctx.getNodeOutput('classify-secret')?.output || '').includes('\"truePositive\":true')" }, "position": { - "x": 120, - "y": 830 + "x": 200, + "y": 650 }, "outputs": [ "yes", @@ -14944,427 +14076,441 @@ ] }, { - "id": "mark-inreview", - "type": "action.update_task_status", - "label": "Set In Review", + "id": "alert-secret", + "type": "notify.telegram", + "label": "Alert: Secret Exposed!", "config": { - "taskId": "{{taskId}}", - "status": "inreview", - "taskTitle": "{{taskTitle}}", - "workflowEvent": "task.finalization_passed", - "workflowData": { - "stage": "finalization", - "result": "passed", - "branch": "{{branch}}", - "worktreePath": "{{worktreePath}}", - "prNumber": "{{prNumber}}", - "prUrl": "{{prUrl}}" - } + "message": ":lock: **SECRET EXPOSED** in recent commits!\n\nThe secret scanner found credentials in the repository. Immediate rotation required.\n\nCheck agent output for classification details." }, "position": { - "x": 240, - "y": 900 + "x": 100, + "y": 810 }, "outputs": [ "default" ] }, { - "id": "handoff-pr-progressor", - "type": "action.execute_workflow", - "label": "Dispatch PR Progressor", + "id": "create-issue", + "type": "action.run_command", + "label": "Create Remediation Issue", "config": { - "workflowId": "template-bosun-pr-progressor", - "mode": "dispatch", - "input": { - "taskId": "{{taskId}}", - "taskTitle": "{{taskTitle}}", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "prNumber": "{{$data?.prNumber ?? $ctx.getNodeOutput('create-pr')?.prNumber ?? null}}", - "prUrl": "{{$data?.prUrl || $ctx.getNodeOutput('create-pr')?.prUrl || ''}}", - "repo": "{{$data?.repo || $data?.repoSlug || $data?.repository || $ctx.getNodeOutput('create-pr')?.repoSlug || ''}}" - } + "command": "gh issue create --title 'security: exposed credential detected by scanner' --body 'The secret scanner detected a potentially exposed credential. See Bosun workflow run for details. Rotate affected keys immediately.' --label security", + "continueOnError": true }, "position": { - "x": 240, - "y": 1040 + "x": 100, + "y": 960 }, "outputs": [ "default" ] }, { - "id": "mark-todo-failed", - "type": "action.update_task_status", - "label": "Mark Todo (Checks Failed)", + "id": "log-false-positive", + "type": "notify.log", + "label": "Log False Positives", "config": { - "taskId": "{{taskId}}", - "status": "todo", - "taskTitle": "{{taskTitle}}", - "workflowEvent": "task.finalization_failed", - "workflowData": { - "stage": "finalization", - "reason": "verification_failed", - "branch": "{{branch}}", - "worktreePath": "{{worktreePath}}", - "baseBranch": "{{baseBranch}}" - } + "message": "Secret scanner flagged findings but all classified as false positives", + "level": "info" }, "position": { - "x": 480, - "y": 620 + "x": 450, + "y": 650 }, "outputs": [ "default" ] }, { - "id": "mark-todo-missing", - "type": "action.update_task_status", - "label": "Mark Todo (Missing Context)", + "id": "log-clean", + "type": "notify.log", + "label": "Repository Clean", "config": { - "taskId": "{{taskId}}", - "status": "todo", - "taskTitle": "{{taskTitle}}", - "workflowEvent": "task.finalization_failed", - "workflowData": { - "stage": "finalization", - "reason": "missing_worktree_context", - "branch": "{{branch}}", - "worktreePath": "{{worktreePath}}", - "baseBranch": "{{baseBranch}}" - } + "message": "Secret scanner: no secrets found in recent commits (exclude paths: {{excludePaths}})", + "level": "info" }, "position": { - "x": 620, + "x": 650, "y": 330 }, "outputs": [ "default" ] + } + ], + "edges": [ + { + "id": "trigger->scan-repo", + "source": "trigger", + "target": "scan-repo", + "sourcePort": "default" }, { - "id": "has-pr-missing-context", - "type": "condition.expression", - "label": "PR Linked Without Worktree?", - "config": { - "expression": "Boolean($data?.prNumber || $data?.prUrl)" - }, - "position": { - "x": 620, - "y": 450 - }, - "outputs": [ - "yes", - "no" - ] + "id": "scan-repo->has-secrets", + "source": "scan-repo", + "target": "has-secrets", + "sourcePort": "default" }, { - "id": "notify-skip-missing-context", - "type": "notify.log", - "label": "Skip Missing Context With PR", + "id": "has-secrets->classify-secret", + "source": "has-secrets", + "target": "classify-secret", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "has-secrets->log-clean", + "source": "has-secrets", + "target": "log-clean", + "sourcePort": "no", + "condition": "$output?.result !== true" + }, + { + "id": "classify-secret->has-true-positive", + "source": "classify-secret", + "target": "has-true-positive", + "sourcePort": "default" + }, + { + "id": "has-true-positive->alert-secret", + "source": "has-true-positive", + "target": "alert-secret", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "has-true-positive->log-false-positive", + "source": "has-true-positive", + "target": "log-false-positive", + "sourcePort": "no", + "condition": "$output?.result !== true" + }, + { + "id": "alert-secret->create-issue", + "source": "alert-secret", + "target": "create-issue", + "sourcePort": "default" + } + ] + }, + { + "id": "template-agent-execution-pipeline", + "name": "Agent Execution Pipeline", + "description": "Full agent execution lifecycle: resolves executor, builds prompt, continues/restarts session, handles rate limits, pushes branch, releases claim, dispatches finalization workflow. Exercises many rarely-used action nodes.", + "category": "coverage", + "categoryLabel": "Coverage", + "categoryIcon": ":settings:", + "categoryOrder": 99, + "tags": [ + "coverage", + "agent", + "pipeline" + ], + "nodeCount": 10, + "edgeCount": 9, + "recommended": false, + "enabled": true, + "trigger": "trigger.event", + "variables": { + "taskId": "TASK-10", + "taskTitle": "Coverage test task", + "taskDescription": "Test task for coverage", + "branch": "feat/pipeline-test", + "baseBranch": "origin/main", + "worktreePath": "/tmp/wt-pipeline-test", + "sessionId": "session-coverage-1", + "finalizationWorkflow": "template-health-check" + }, + "metadata": { + "author": "virtengine", + "tags": [ + "coverage", + "agent", + "pipeline" + ], + "requiredTemplates": [ + "template-health-check" + ] + }, + "nodes": [ + { + "id": "trigger", + "type": "trigger.event", + "label": "Event Trigger", "config": { - "message": "Task {{taskId}} finalization skipped quality gate: missing worktree context but PR linkage exists", - "level": "warn" + "eventType": "task.assigned" }, "position": { - "x": 620, - "y": 560 + "x": 100, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "notify-pass", - "type": "notify.log", - "label": "Log Finalization Success", + "id": "resolve-executor", + "type": "action.resolve_executor", + "label": "Resolve Executor", "config": { - "message": "Task {{taskId}} finalization passed — moved to inreview", - "level": "info" + "taskId": "{{taskId}}", + "continueOnError": true }, "position": { - "x": 240, - "y": 1180 + "x": 380, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "chain-archiver", - "type": "flow.universal", - "label": "Queue Archival", + "id": "build-prompt", + "type": "action.build_task_prompt", + "label": "Build Task Prompt", "config": { - "workflowId": "template-task-archiver", - "mode": "dispatch", - "input": "({taskId: $data?.taskId, taskTitle: $data?.taskTitle, completedAt: new Date().toISOString(), taskJson: JSON.stringify($data?.task || {id: $data?.taskId, title: $data?.taskTitle})})" + "taskId": "{{taskId}}", + "taskTitle": "{{taskTitle}}", + "taskDescription": "{{taskDescription}}", + "continueOnError": true }, "position": { - "x": 240, - "y": 1320 + "x": 660, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "end-success", - "type": "flow.end", - "label": "End Success", + "id": "continue-session", + "type": "action.continue_session", + "label": "Continue Session", "config": { - "status": "completed", - "message": "Task finalization guard completed successfully for {{taskId}}", - "output": { - "outcome": "passed", - "taskId": "{{taskId}}", - "taskTitle": "{{taskTitle}}" - } + "sessionId": "{{sessionId}}", + "prompt": "Continue executing task {{taskTitle}}", + "strategy": "continue", + "timeoutMs": 1000, + "continueOnError": true }, "position": { - "x": 240, - "y": 1450 + "x": 940, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "notify-fail", - "type": "notify.telegram", - "label": "Notify Finalization Failure", + "id": "handle-rate-limit", + "type": "action.handle_rate_limit", + "label": "Handle Rate Limit", "config": { - "message": ":alert: Task finalization failed for **{{taskTitle}}** ({{taskId}}). Repair workflow handoff triggered." + "strategy": "skip", + "continueOnError": true }, "position": { - "x": 540, - "y": 900 + "x": 1220, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "end-failed", - "type": "flow.end", - "label": "End Failed", + "id": "restart-agent", + "type": "action.restart_agent", + "label": "Restart Agent", "config": { - "status": "failed", - "message": "Task finalization guard failed for {{taskId}}", - "output": { - "outcome": "failed", - "taskId": "{{taskId}}", - "taskTitle": "{{taskTitle}}" - } + "agentId": "{{sessionId}}", + "continueOnError": true }, "position": { - "x": 540, - "y": 1040 + "x": 1500, + "y": 100 }, "outputs": [ "default" ] - } - ], - "edges": [ - { - "id": "trigger->has-worktree", - "source": "trigger", - "target": "has-worktree", - "sourcePort": "default" - }, - { - "id": "has-worktree->run-finalization", - "source": "has-worktree", - "target": "run-finalization", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "has-worktree->has-pr-missing-context", - "source": "has-worktree", - "target": "has-pr-missing-context", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "has-pr-missing-context->notify-skip-missing-context", - "source": "has-pr-missing-context", - "target": "notify-skip-missing-context", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "has-pr-missing-context->mark-todo-missing", - "source": "has-pr-missing-context", - "target": "mark-todo-missing", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "run-finalization->checks-passed", - "source": "run-finalization", - "target": "checks-passed", - "sourcePort": "default" }, { - "id": "checks-passed->has-pr", - "source": "checks-passed", - "target": "has-pr", - "sourcePort": "default", - "condition": "$output?.result === true" + "id": "push-branch", + "type": "action.push_branch", + "label": "Push Branch", + "config": { + "branch": "{{branch}}", + "baseBranch": "{{baseBranch}}", + "worktreePath": "{{worktreePath}}", + "rebaseBeforePush": false, + "emptyDiffGuard": false, + "continueOnError": true + }, + "position": { + "x": 1780, + "y": 100 + }, + "outputs": [ + "default" + ] }, { - "id": "checks-passed->mark-todo-failed", - "source": "checks-passed", - "target": "mark-todo-failed", - "sourcePort": "default", - "condition": "$output?.result !== true" + "id": "release-claim", + "type": "action.release_claim", + "label": "Release Claim", + "config": { + "taskId": "{{taskId}}", + "continueOnError": true + }, + "position": { + "x": 2060, + "y": 100 + }, + "outputs": [ + "default" + ] }, { - "id": "has-pr->mark-inreview", - "source": "has-pr", - "target": "mark-inreview", - "sourcePort": "default", - "condition": "$output?.result === true" + "id": "dispatch-finalize", + "type": "flow.universal", + "label": "Dispatch Finalization", + "config": { + "workflowId": "{{finalizationWorkflow}}", + "mode": "dispatch", + "continueOnError": true + }, + "position": { + "x": 2340, + "y": 100 + }, + "outputs": [ + "default" + ] }, { - "id": "has-pr->create-pr", - "source": "has-pr", - "target": "create-pr", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, + "id": "log-done", + "type": "notify.log", + "label": "Log Dispatched", + "config": { + "message": "Pipeline complete for task {{taskId}}", + "level": "info" + }, + "position": { + "x": 2620, + "y": 100 + }, + "outputs": [ + "default" + ] + } + ], + "edges": [ { - "id": "create-pr->create-pr-success", - "source": "create-pr", - "target": "create-pr-success", + "id": "trigger->resolve-executor", + "source": "trigger", + "target": "resolve-executor", "sourcePort": "default" }, { - "id": "create-pr-success->mark-inreview", - "source": "create-pr-success", - "target": "mark-inreview", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "create-pr-success->mark-todo-failed", - "source": "create-pr-success", - "target": "mark-todo-failed", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "mark-inreview->handoff-pr-progressor", - "source": "mark-inreview", - "target": "handoff-pr-progressor", + "id": "resolve-executor->build-prompt", + "source": "resolve-executor", + "target": "build-prompt", "sourcePort": "default" }, { - "id": "handoff-pr-progressor->notify-pass", - "source": "handoff-pr-progressor", - "target": "notify-pass", + "id": "build-prompt->continue-session", + "source": "build-prompt", + "target": "continue-session", "sourcePort": "default" }, { - "id": "notify-skip-missing-context->end-success", - "source": "notify-skip-missing-context", - "target": "end-success", + "id": "continue-session->handle-rate-limit", + "source": "continue-session", + "target": "handle-rate-limit", "sourcePort": "default" }, { - "id": "notify-pass->chain-archiver", - "source": "notify-pass", - "target": "chain-archiver", + "id": "handle-rate-limit->restart-agent", + "source": "handle-rate-limit", + "target": "restart-agent", "sourcePort": "default" }, { - "id": "chain-archiver->end-success", - "source": "chain-archiver", - "target": "end-success", + "id": "restart-agent->push-branch", + "source": "restart-agent", + "target": "push-branch", "sourcePort": "default" }, { - "id": "mark-todo-failed->notify-fail", - "source": "mark-todo-failed", - "target": "notify-fail", + "id": "push-branch->release-claim", + "source": "push-branch", + "target": "release-claim", "sourcePort": "default" }, { - "id": "mark-todo-missing->notify-fail", - "source": "mark-todo-missing", - "target": "notify-fail", + "id": "release-claim->dispatch-finalize", + "source": "release-claim", + "target": "dispatch-finalize", "sourcePort": "default" }, { - "id": "notify-fail->end-failed", - "source": "notify-fail", - "target": "end-failed", + "id": "dispatch-finalize->log-done", + "source": "dispatch-finalize", + "target": "log-done", "sourcePort": "default" } ] }, { - "id": "template-task-orphan-worktree-recovery", - "name": "Task Orphan Worktree Recovery", - "description": "Scheduled workflow-owned recovery for orphaned task worktrees. Scans .cache/worktrees for abandoned task branches, auto-commits pending changes, pushes recoverable branches, records PR handoff, and updates task status to inreview when successful.", - "category": "reliability", - "categoryLabel": "Reliability", - "categoryIcon": ":shield:", - "categoryOrder": 5, + "id": "template-task-backend", + "name": "Backend Task Workflow", + "description": "Specialised for server-side tasks — APIs, databases, services, middleware. Runs three phases: plan, implement with TDD, and verify with full test suite.", + "category": "task-execution", + "categoryLabel": "Task Execution", + "categoryIcon": ":settings:", + "categoryOrder": 99, "tags": [ - "orphan", - "recovery", - "worktree", - "lifecycle", - "reliability" + "backend", + "api", + "server", + "task-type" ], - "nodeCount": 8, - "edgeCount": 7, + "nodeCount": 5, + "edgeCount": 4, "recommended": true, "enabled": true, - "trigger": "trigger.schedule", + "trigger": "trigger.task_assigned", "variables": { - "intervalMs": 1800000, - "baseBranch": "origin/main", - "maxRecoverPerSweep": 20 + "taskTimeoutMs": 21600000, + "maxRetries": 2, + "maxContinues": 3, + "testCommand": "auto", + "buildCommand": "auto", + "lintCommand": "auto" }, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2026-03-04T00:00:00Z", - "templateVersion": "1.0.1", + "createdAt": "2025-06-01T00:00:00Z", + "templateVersion": "1.0.0", "tags": [ - "orphan", - "recovery", - "worktree", - "lifecycle", - "reliability" + "backend", + "api", + "server", + "task-type" ], - "replaces": { - "module": "task-executor.mjs", - "functions": [ - "_recoverOrphanedWorktrees" - ], - "calledFrom": [ - "task-executor.mjs:start" - ], - "description": "Moves orphaned worktree recovery out of the legacy task-executor startup path and into a dedicated scheduled workflow." - } + "resolveMode": "library" }, "nodes": [ { "id": "trigger", - "type": "trigger.schedule", - "label": "Scheduled Recovery Sweep", + "type": "trigger.task_assigned", + "label": "Task Assigned", "config": { - "intervalMs": "{{intervalMs}}", - "cron": "*/30 * * * *" + "taskPattern": "api|server|backend|database|model|migration|endpoint|middleware|service|graphql|rest|grpc" }, "position": { - "x": 420, + "x": 400, "y": 50 }, "outputs": [ @@ -15372,112 +14518,102 @@ ] }, { - "id": "recover", - "type": "action.run_command", - "label": "Recover Orphan Worktrees", + "id": "plan", + "type": "action.run_agent", + "label": "Plan Backend", "config": { - "command": "node tools/workflow-orphan-worktree-recovery.mjs --base \"{{baseBranch}}\" --max \"{{maxRecoverPerSweep}}\"", - "failOnError": false + "prompt": "## Phase: Backend Planning\n\nAnalyse the task and produce a plan:\n1. Data model / schema changes\n2. API endpoint design (routes, request/response shapes)\n3. Service layer logic\n4. Database queries or migrations\n5. Test plan (unit + integration)\n\nDo NOT write code yet.", + "taskId": "{{taskId}}", + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "repoMapQuery": "{{taskTitle}} {{taskDescription}}", + "repoMapFileLimit": 8, + "mode": "plan", + "executionRole": "architect" }, "position": { - "x": 420, - "y": 190 + "x": 400, + "y": 180 }, "outputs": [ "default" ] }, { - "id": "parse-recovery", - "type": "transform.json_parse", - "label": "Parse Recovery Summary", + "id": "implement-tdd", + "type": "action.run_agent", + "label": "Implement (TDD)", "config": { - "input": "recover", - "field": "output" + "prompt": "## Phase: Test-Driven Implementation\n\n1. Write tests FIRST for the planned changes\n2. Verify tests fail (red)\n3. Implement the backend logic to make tests pass (green)\n4. Refactor for clarity and performance\n5. Run full test suite: {{testCommand}}\n6. Run build: {{buildCommand}}\n7. Run lint: {{lintCommand}}\n\nCommit with descriptive messages.", + "taskId": "{{taskId}}", + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "repoMapQuery": "{{taskTitle}} {{taskDescription}}", + "repoMapFileLimit": 8, + "executionRole": "editor", + "architectPlan": "{{$ctx.getNodeOutput('plan')?.summary || $ctx.getNodeOutput('plan')?.output || ''}}" }, "position": { - "x": 420, - "y": 330 + "x": 400, + "y": 340 }, "outputs": [ "default" ] }, { - "id": "parse-ok", - "type": "condition.expression", - "label": "Recovery Summary Valid?", + "id": "verify", + "type": "action.run_agent", + "label": "Verify & PR", "config": { - "expression": "$ctx.getNodeOutput('parse-recovery')?.success === true" - }, - "position": { - "x": 420, - "y": 470 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "has-recovered", - "type": "condition.expression", - "label": "Recovered Branches?", - "config": { - "expression": "Number($ctx.getNodeOutput('parse-recovery')?.data?.recovered || 0) > 0" - }, - "position": { - "x": 420, - "y": 610 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "log-recovered", - "type": "notify.log", - "label": "Log Recovery Success", - "config": { - "message": "Orphan recovery: recovered={{parse-recovery.data.recovered}} skipped={{parse-recovery.data.skipped}} failed={{parse-recovery.data.failed}}", - "level": "info" - }, - "position": { - "x": 250, - "y": 760 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-idle", - "type": "notify.log", - "label": "Log No Work", - "config": { - "message": "Orphan recovery: no recoverable orphaned worktrees found (scanned={{parse-recovery.data.scanned}}, skipped={{parse-recovery.data.skipped}}).", - "level": "debug" + "prompt": "## Phase: Verification\n\n1. Run the complete test suite: {{testCommand}}\n2. Run build: {{buildCommand}}\n3. Ensure no regressions\n4. Push changes and create/update PR\n5. Include test results summary in PR description", + "taskId": "{{taskId}}", + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "repoMapQuery": "{{taskTitle}} {{taskDescription}}", + "repoMapFileLimit": 8, + "executionRole": "editor", + "architectPlan": "{{$ctx.getNodeOutput('plan')?.summary || $ctx.getNodeOutput('plan')?.output || ''}}" }, "position": { - "x": 560, - "y": 760 + "x": 400, + "y": 500 }, "outputs": [ "default" ] }, { - "id": "log-parse-failed", + "id": "done", "type": "notify.log", - "label": "Log Recovery Parse Failure", + "label": "Complete", "config": { - "message": "Orphan recovery workflow produced invalid JSON output. Check tools/workflow-orphan-worktree-recovery.mjs execution logs.", - "level": "warn" + "message": "Backend task completed — API/service implemented and tested." }, "position": { - "x": 760, - "y": 610 + "x": 400, + "y": 660 }, "outputs": [ "default" @@ -15486,323 +14622,498 @@ ], "edges": [ { - "id": "trigger->recover", + "id": "trigger->plan", "source": "trigger", - "target": "recover", + "target": "plan", "sourcePort": "default" }, { - "id": "recover->parse-recovery", - "source": "recover", - "target": "parse-recovery", + "id": "plan->implement-tdd", + "source": "plan", + "target": "implement-tdd", "sourcePort": "default" }, { - "id": "parse-recovery->parse-ok", - "source": "parse-recovery", - "target": "parse-ok", + "id": "implement-tdd->verify", + "source": "implement-tdd", + "target": "verify", "sourcePort": "default" }, { - "id": "parse-ok->has-recovered", - "source": "parse-ok", - "target": "has-recovered", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "parse-ok->log-parse-failed", - "source": "parse-ok", - "target": "log-parse-failed", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "has-recovered->log-recovered", - "source": "has-recovered", - "target": "log-recovered", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "has-recovered->log-idle", - "source": "has-recovered", - "target": "log-idle", - "sourcePort": "no", - "condition": "$output?.result !== true" + "id": "verify->done", + "source": "verify", + "target": "done", + "sourcePort": "default" } ] }, { - "id": "template-task-repair-worktree", - "name": "Task Repair Worktree", - "description": "Recovery workflow for tasks that fail execution or finalization. Refreshes worktree state, runs a repair agent, re-validates quality gates, and escalates only after automated repair fails.", - "category": "reliability", - "categoryLabel": "Reliability", - "categoryIcon": ":shield:", - "categoryOrder": 5, + "id": "template-bosun-tool-pipeline", + "name": "Bosun Tool Pipeline", + "description": "Run Bosun built-in or custom tools from a workflow with structured output piping. Discovers available tools, invokes a selected tool, extracts specific data fields, and forwards them to downstream nodes. Combines action.bosun_function and action.bosun_tool for full tool integration.", + "category": "mcp-integration", + "categoryLabel": "Mcp Integration", + "categoryIcon": ":settings:", + "categoryOrder": 99, "tags": [ - "repair", - "recovery", - "worktree", - "resilience", - "automation" + "bosun", + "tools", + "pipeline", + "structured-output" ], - "nodeCount": 21, - "edgeCount": 24, - "recommended": true, + "nodeCount": 7, + "edgeCount": 6, + "recommended": false, "enabled": true, - "trigger": "trigger.event", + "trigger": "trigger.manual", "variables": { - "repairTimeoutMs": 5400000, - "verificationTimeoutMs": 3600000, - "repoRoot": "", - "defaultTargetBranch": "main", - "baseBranch": "main", - "verificationCommand": "node -e \"const cp=require('node:child_process');const cmds=['npm run prepush --if-present','npm run prepush:check --if-present','npm run build','npm test','npm run lint --if-present'];for(const cmd of cmds){cp.execSync(cmd,{stdio:'inherit'});} \"", - "repairPrompt": "Task {{taskId}} ({{taskTitle}}) failed. Error: {{error}}. Repair the implementation in {{worktreePath}} without bypassing tests, then leave the branch ready for Bosun PR lifecycle handoff." + "targetTool": "list-todos", + "toolArgs": "" }, "metadata": { - "author": "bosun", - "version": 1, - "createdAt": "2026-02-26T00:00:00Z", - "templateVersion": "1.0.1", + "author": "virtengine", "tags": [ - "repair", - "recovery", - "worktree", - "resilience", - "automation" - ], - "requiredTemplates": [ - "template-bosun-pr-progressor" - ], - "replaces": { - "module": "task-executor.mjs", - "functions": [ - "retry/escalation recovery path" - ], - "calledFrom": [ - "task-executor.mjs:_handleTaskResult" - ], - "description": "Introduces a dedicated automated repair workflow that takes over when task execution or finalization fails." - } + "bosun", + "tools", + "pipeline", + "structured-output" + ] }, "nodes": [ { - "id": "trigger-failed", - "type": "trigger.event", - "label": "Task Failed", - "config": { - "eventType": "task.failed" - }, + "id": "trigger", + "type": "trigger.manual", + "label": "Start", + "config": {}, "position": { - "x": 250, - "y": 50 + "x": 100, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "trigger-finalization", - "type": "trigger.event", - "label": "Finalization Failed", + "id": "list-tools", + "type": "action.bosun_function", + "label": "List Available Tools", "config": { - "eventType": "task.finalization_failed" + "function": "tools.list", + "outputVariable": "availableTools" }, "position": { - "x": 550, - "y": 50 + "x": 380, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "has-branch-context", - "type": "condition.expression", - "label": "Branch Context Available?", + "id": "get-tool-info", + "type": "action.bosun_function", + "label": "Get Tool Info", "config": { - "expression": "Boolean($data?.repoRoot) && Boolean($data?.branch) && Boolean($data?.taskId)" + "function": "tools.get", + "args": { + "toolId": "{{targetTool}}" + }, + "outputVariable": "toolInfo" }, "position": { - "x": 400, - "y": 180 + "x": 660, + "y": 100 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "recover-repair-worktree", - "type": "action.recover_worktree", - "label": "Reset Broken Worktree", + "id": "tool-exists", + "type": "condition.expression", + "label": "Tool Exists?", "config": { - "worktreePath": "{{worktreePath}}", - "branch": "{{branch}}", - "repoRoot": "{{repoRoot}}", - "taskId": "{{taskId}}" + "expression": "{{get-tool-info.found}}", + "trueLabel": "Found", + "falseLabel": "Not Found" }, "position": { - "x": 220, - "y": 320 + "x": 940, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "acquire-repair-worktree", - "type": "action.acquire_worktree", - "label": "Acquire Clean Worktree", + "id": "run-tool", + "type": "action.bosun_tool", + "label": "Run Tool", "config": { - "repoRoot": "{{repoRoot}}", - "branch": "{{branch}}", - "taskId": "{{taskId}}", - "baseBranch": "{{baseBranch}}", - "defaultTargetBranch": "{{defaultTargetBranch}}" + "toolId": "{{targetTool}}", + "args": [ + "{{toolArgs}}" + ], + "parseJson": true, + "extract": { + "fields": { + "itemCount": "length", + "items": "[*]" + }, + "defaults": { + "itemCount": 0, + "items": [] + }, + "types": { + "itemCount": "number" + } + }, + "outputVariable": "toolOutput" }, "position": { - "x": 220, - "y": 460 + "x": 1220, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "acquired-repair-worktree", - "type": "condition.expression", - "label": "Clean Worktree Ready?", + "id": "log-results", + "type": "notify.log", + "label": "Log Results", "config": { - "expression": "$ctx.getNodeOutput('acquire-repair-worktree')?.success === true" + "message": "Tool Pipeline: Found {{list-tools.data.length}} tools. Ran '{{targetTool}}': {{run-tool.itemCount}} results (exit {{run-tool.exitCode}})", + "level": "info" }, "position": { - "x": 220, - "y": 600 + "x": 1500, + "y": 100 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "has-worktree", - "type": "condition.expression", - "label": "Fallback Worktree Context Available?", + "id": "log-not-found", + "type": "notify.log", + "label": "Tool Not Found", "config": { - "expression": "Boolean($data?.worktreePath)" + "message": "Tool '{{targetTool}}' not found. Available tools: {{list-tools.data.length}}", + "level": "warn" }, "position": { - "x": 560, - "y": 320 + "x": 1780, + "y": 100 }, "outputs": [ - "yes", - "no" + "default" ] + } + ], + "edges": [ + { + "id": "trigger->list-tools", + "source": "trigger", + "target": "list-tools", + "sourcePort": "default" }, { - "id": "refresh-worktree", - "type": "action.refresh_worktree", - "label": "Refresh Worktree", + "id": "list-tools->get-tool-info", + "source": "list-tools", + "target": "get-tool-info", + "sourcePort": "default" + }, + { + "id": "get-tool-info->tool-exists", + "source": "get-tool-info", + "target": "tool-exists", + "sourcePort": "default" + }, + { + "id": "tool-exists->run-tool", + "source": "tool-exists", + "target": "run-tool", + "sourcePort": "true" + }, + { + "id": "tool-exists->log-not-found", + "source": "tool-exists", + "target": "log-not-found", + "sourcePort": "false" + }, + { + "id": "run-tool->log-results", + "source": "run-tool", + "target": "log-results", + "sourcePort": "default" + } + ] + }, + { + "id": "template-task-cicd", + "name": "CI/CD Task Workflow", + "description": "For pipeline, deployment, infrastructure, and build-system tasks. Plans the change, implements with validation steps, then verifies the pipeline works end-to-end.", + "category": "task-execution", + "categoryLabel": "Task Execution", + "categoryIcon": ":settings:", + "categoryOrder": 99, + "tags": [ + "ci", + "cd", + "pipeline", + "deploy", + "infrastructure", + "task-type" + ], + "nodeCount": 5, + "edgeCount": 4, + "recommended": true, + "enabled": true, + "trigger": "trigger.task_assigned", + "variables": { + "taskTimeoutMs": 21600000, + "maxRetries": 2, + "maxContinues": 3, + "testCommand": "auto", + "buildCommand": "auto", + "lintCommand": "auto" + }, + "metadata": { + "author": "bosun", + "version": 1, + "createdAt": "2025-06-01T00:00:00Z", + "templateVersion": "1.0.0", + "tags": [ + "ci", + "cd", + "pipeline", + "deploy", + "infrastructure", + "task-type" + ], + "resolveMode": "library" + }, + "nodes": [ + { + "id": "trigger", + "type": "trigger.task_assigned", + "label": "Task Assigned", "config": { - "operation": "fetch", - "cwd": "{{$ctx.getNodeOutput('acquire-repair-worktree')?.worktreePath || $data?.worktreePath || ''}}", - "continueOnError": true + "taskPattern": "ci|cd|pipeline|deploy|infrastructure|docker|kubernetes|k8s|terraform|github.action|build.system|release|devops" }, "position": { "x": 400, - "y": 740 + "y": 50 }, "outputs": [ "default" ] }, { - "id": "repair-agent", + "id": "plan-pipeline", "type": "action.run_agent", - "label": "Repair Task", + "label": "Plan Pipeline Change", "config": { - "prompt": "{{repairPrompt}}", - "cwd": "{{$ctx.getNodeOutput('acquire-repair-worktree')?.worktreePath || $data?.worktreePath || ''}}", - "timeoutMs": "{{repairTimeoutMs}}" + "prompt": "## Phase: CI/CD Planning\n\nAnalyse the pipeline/infrastructure task:\n1. Current CI/CD configuration\n2. What needs to change and why\n3. Impact on existing workflows/pipelines\n4. Rollback strategy\n5. Test plan for verifying the change\n\nDo NOT make changes yet.", + "taskId": "{{taskId}}", + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "repoMapQuery": "{{taskTitle}} {{taskDescription}}", + "repoMapFileLimit": 8, + "mode": "plan", + "executionRole": "architect" }, "position": { "x": 400, - "y": 880 + "y": 180 }, "outputs": [ "default" ] }, { - "id": "verify", - "type": "action.run_command", - "label": "Re-run Quality Gates", + "id": "implement-pipeline", + "type": "action.run_agent", + "label": "Implement Pipeline", "config": { - "command": "{{verificationCommand}}", - "cwd": "{{$ctx.getNodeOutput('acquire-repair-worktree')?.worktreePath || $data?.worktreePath || ''}}", - "timeoutMs": "{{verificationTimeoutMs}}", - "continueOnError": true + "prompt": "## Phase: Pipeline Implementation\n\n1. Make the CI/CD / infrastructure changes per the plan\n2. Update configuration files (workflows, Dockerfiles, Terraform, etc.)\n3. Add or update pipeline tests where applicable\n4. Run build: {{buildCommand}}\n5. Run lint: {{lintCommand}}\n6. Validate configuration syntax\n\nCommit changes with clear descriptions.", + "taskId": "{{taskId}}", + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "repoMapQuery": "{{taskTitle}} {{taskDescription}}", + "repoMapFileLimit": 8, + "executionRole": "editor", + "architectPlan": "{{$ctx.getNodeOutput('plan-pipeline')?.summary || $ctx.getNodeOutput('plan-pipeline')?.output || ''}}" }, "position": { "x": 400, - "y": 1020 + "y": 340 }, "outputs": [ "default" ] }, { - "id": "verify-passed", - "type": "condition.expression", - "label": "Repair Passed?", + "id": "verify-pipeline", + "type": "action.run_agent", + "label": "Verify & PR", "config": { - "expression": "$ctx.getNodeOutput('verify')?.success === true" + "prompt": "## Phase: Pipeline Verification\n\n1. Run full test suite: {{testCommand}}\n2. Run build: {{buildCommand}}\n3. Verify pipeline configuration is valid\n4. Push and create/update PR\n5. Include deployment / rollback instructions in PR description", + "taskId": "{{taskId}}", + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "repoMapQuery": "{{taskTitle}} {{taskDescription}}", + "repoMapFileLimit": 8, + "executionRole": "editor", + "architectPlan": "{{$ctx.getNodeOutput('plan-pipeline')?.summary || $ctx.getNodeOutput('plan-pipeline')?.output || ''}}" }, "position": { "x": 400, - "y": 1160 + "y": 500 }, "outputs": [ "default" ] }, { - "id": "create-pr", - "type": "action.create_pr", - "label": "Handoff/Refresh Lifecycle", + "id": "done", + "type": "notify.log", + "label": "Complete", "config": { - "title": "{{taskTitle}}", - "body": "Automated repair run for task {{taskId}}. Bosun lifecycle handoff context.", - "base": "{{baseBranch}}", - "branch": "{{branch}}", - "failOnError": true, - "maxRetries": 3, - "retryDelayMs": 15000, - "continueOnError": true + "message": "CI/CD task completed — pipeline updated and verified." }, "position": { - "x": 250, - "y": 1300 + "x": 400, + "y": 660 }, "outputs": [ "default" ] + } + ], + "edges": [ + { + "id": "trigger->plan-pipeline", + "source": "trigger", + "target": "plan-pipeline", + "sourcePort": "default" }, { - "id": "create-pr-success", - "type": "condition.expression", - "label": "Lifecycle Handoff Ready?", - "config": { - "expression": "$ctx.getNodeOutput('create-pr')?.success === true" - }, - "position": { - "x": 250, - "y": 1370 + "id": "plan-pipeline->implement-pipeline", + "source": "plan-pipeline", + "target": "implement-pipeline", + "sourcePort": "default" + }, + { + "id": "implement-pipeline->verify-pipeline", + "source": "implement-pipeline", + "target": "verify-pipeline", + "sourcePort": "default" + }, + { + "id": "verify-pipeline->done", + "source": "verify-pipeline", + "target": "done", + "sourcePort": "default" + } + ] + }, + { + "id": "template-code-quality-striker", + "name": "Code Quality Striker", + "description": "Recurring autonomous refactoring agent that improves codebase structure for long-term agentic development. Runs every 2 hours with a hard 90-minute session cap. Each session MUST produce a passing PR before terminating. Scope is strictly limited to structural quality: module decomposition, deduplication, function splitting. Zero functional changes allowed.", + "category": "maintenance", + "categoryLabel": "Maintenance", + "categoryIcon": ":settings:", + "categoryOrder": 99, + "tags": [ + "refactor", + "code-quality", + "maintenance", + "scheduled", + "agentic" + ], + "nodeCount": 12, + "edgeCount": 12, + "recommended": true, + "enabled": true, + "trigger": "trigger.schedule", + "variables": { + "sessionTimeoutMs": 5400000, + "branch": "chore/code-quality-striker", + "baseBranch": "main", + "sessionLogPath": ".bosun-monitor/code-quality-striker.md", + "maxFilesPerSession": 6, + "minFileSizeKb": 30, + "testCommand": "npm test", + "buildCommand": "npm run build", + "syntaxCheckCommand": "node --check", + "lintCommand": "", + "sourceExtensions": ".mjs,.js,.ts,.tsx,.py,.go,.rs,.java,.cs,.rb,.php" + }, + "metadata": { + "author": "bosun", + "version": 1, + "createdAt": "2026-03-09T00:00:00Z", + "templateVersion": "1.0.0", + "tags": [ + "refactor", + "code-quality", + "maintenance", + "scheduled", + "agentic" + ], + "sessionLog": ".bosun-monitor/code-quality-striker.md" + }, + "nodes": [ + { + "id": "trigger", + "type": "trigger.schedule", + "label": "Every 2 Hours", + "config": { + "intervalMs": 7200000, + "cron": "0 */2 * * *" + }, + "position": { + "x": 400, + "y": 50 + }, + "outputs": [ + "default" + ] + }, + { + "id": "check-active-pr", + "type": "condition.expression", + "label": "Active Striker PR?", + "config": { + "expression": "(() => { try { const r = $ctx.runCommand('git branch -r'); return (r?.output || '').includes('code-quality-striker'); } catch { return false; } })()" + }, + "position": { + "x": 400, + "y": 180 }, "outputs": [ "yes", @@ -15810,120 +15121,119 @@ ] }, { - "id": "mark-inreview", - "type": "action.update_task_status", - "label": "Set In Review", + "id": "skip-already-running", + "type": "notify.log", + "label": "Skip — PR Already Open", "config": { - "taskId": "{{taskId}}", - "status": "inreview", - "taskTitle": "{{taskTitle}}", - "workflowEvent": "task.repair_succeeded", - "workflowData": { - "stage": "repair", - "result": "passed", - "branch": "{{branch}}", - "worktreePath": "{{worktreePath}}" - } + "message": "Code quality striker skipped: an open quality striker PR already exists. Will retry next cycle.", + "level": "info" }, "position": { - "x": 250, - "y": 1440 + "x": 650, + "y": 310 }, "outputs": [ "default" ] }, { - "id": "clear-repair-blocked-success", - "type": "action.bosun_function", - "label": "Clear Repair Blocked State", + "id": "scan-candidates", + "type": "action.run_command", + "label": "Scan Large Files", "config": { - "function": "tasks.update", - "args": { - "taskId": "{{taskId}}", - "fields": { - "cooldownUntil": null, - "blockedReason": null, - "meta": "{{(() => { const current = ($data?.meta && typeof $data.meta === 'object') ? $data.meta : {}; const next = { ...current }; delete next.autoRecovery; delete next.worktreeFailure; delete next.blockedReason; return next; })()}}" - } - } + "command": "node -e \"const{readdirSync,statSync}=require('fs');const{join,relative}=require('path');const base=process.cwd();const exts=new Set('{{sourceExtensions}}'.split(',').map(e=>e.trim()));function walk(d){const out=[];for(const f of readdirSync(d,{withFileTypes:true})){if(f.name==='node_modules'||f.name==='.cache'||f.name==='.git'||f.name==='worktrees'||f.name==='__pycache__'||f.name==='.venv'||f.name==='target'||f.name==='vendor'||f.name==='dist'||f.name==='build')continue;const p=join(d,f.name);if(f.isDirectory())out.push(...walk(p));else{const ext='.'+f.name.split('.').pop();if(exts.has(ext)){const s=statSync(p);out.push({p,kb:Math.round(s.size/1024)})}}}return out}const files=walk(base).filter(x=>x.kb>={{minFileSizeKb}}).sort((a,b)=>b.kb-a.kb).slice(0,20);console.log(files.map(x=>x.kb+'kb\\t'+relative(base,x.p)).join('\\n'))\"", + "continueOnError": true }, "position": { - "x": 250, - "y": 1510 + "x": 400, + "y": 310 }, "outputs": [ "default" ] }, { - "id": "handoff-pr-progressor", - "type": "action.execute_workflow", - "label": "Dispatch PR Progressor", + "id": "run-striker", + "type": "action.run_agent", + "label": "Code Quality Striker Agent", "config": { - "workflowId": "template-bosun-pr-progressor", - "mode": "dispatch", - "input": { - "taskId": "{{taskId}}", - "taskTitle": "{{taskTitle}}", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "prNumber": "{{$data?.prNumber ?? $ctx.getNodeOutput('create-pr')?.prNumber ?? null}}", - "prUrl": "{{$data?.prUrl || $ctx.getNodeOutput('create-pr')?.prUrl || ''}}", - "repo": "{{$data?.repo || $data?.repoSlug || $data?.repository || $ctx.getNodeOutput('create-pr')?.repoSlug || ''}}" - } + "timeoutMs": "{{sessionTimeoutMs}}", + "sdk": "auto", + "prompt": "# Code Quality Striker\n\nYou are a **structural quality agent**. Your sole mandate is to improve the\ninternal structure of the codebase so that future agentic models can work on\nit more efficiently — smaller files, clearer module boundaries, zero\nduplication, and self-contained functions.\n\n## Session Constraints\n\n- **Hard session cap**: you have at most 90 minutes total. Budget your time.\n- **You MUST open a PR before ending** — a session with no PR is a failed\n session. If you run out of time mid-refactor, commit what you have, push,\n and open the PR immediately even if the work is partial, AS LONG AS all\n tests pass.\n- **Maximum {{maxFilesPerSession}} source files changed** in a single PR.\n Keep diffs small and reviewable. Better to do one clean split per session\n than attempt a mega-refactor.\n- You may run multiple sessions and PRs over time. Prefer incremental progress.\n\n## ✅ Allowed Changes (ONLY these)\n\n1. **Module decomposition** — extract a large file into smaller, focused\n modules. The extracted module must be imported back so the public surface\n is identical.\n2. **Function splitting** — break functions > ~80 lines into smaller,\n well-named helpers within the same file or a co-located util module.\n3. **Deduplication** — extract identical or near-identical logic blocks into\n a shared helper. Must not change call-site behaviour.\n4. **Dead code removal** — remove functions, variables, or imports that are\n verifiably unreferenced (no callers anywhere in the repo).\n5. **Import cleanup** — remove unused imports, deduplicate import statements,\n consolidate barrel imports.\n\n## ❌ Forbidden Changes (HARD STOPS — never do these)\n\n- Adding, removing, or changing any exported function signature or return value\n- Changing any HTTP route path, method, or response shape\n- Changing any config key names or default values\n- Adding new features, flags, or options of any kind\n- Changing test assertions or test logic\n- Renaming exported symbols (only rename internal/private symbols)\n- Adding comments, JSDoc, or inline documentation (unless minimal and necessary)\n- Changing error messages visible to users or logs (string literals)\n- Any change to .json, .sh, .md, .yaml, .html, .css, or non-.mjs/.js files\n (unless you are only touching an import path string that is broken by a move)\n\n## Workflow\n\n### Step 1 — Identify your target\n\nUse the candidate file list provided (sorted by size, largest first):\n\n```\n{{scan-candidates.output}}\n```\n\nPick **1–3 files** for this session. Prioritise:\n- Files > 500 lines used by multiple modules (high parallel-conflict risk)\n- Files with clearly repeated logic blocks\n- Files with functions > 100 lines that have distinct sub-responsibilities\n\nRead each target file in full before making any decision. Do NOT edit\nanything you have not fully read.\n\n### Step 2 — Plan your split in writing\n\nBefore touching the file, write a short plan (to yourself, as a comment in\nyour reasoning — DO NOT add it to the code):\n- What gets extracted and where\n- New file names (follow existing naming conventions in that directory)\n- Which exports stay vs. move\n- Any callers that will need their import paths updated\n\n### Step 3 — Extract and wire up\n\n- Create the new module file(s) under the same directory as the source file.\n- Update the source file to re-export or directly import the extracted piece\n so every existing call-site continues to work without modification.\n- Update any OTHER files that directly imported from the source file, if and\n only if you moved an export that those files reference. Use\n `grep -r 'importedName' --include='*.mjs' --include='*.js'` to find callers.\n- **Do not touch callers unless strictly required by the move.**\n\n### Step 4 — Validate before committing\n\nRun ALL of the following in order. Do not commit if any fail:\n\n```bash\n# 1. Syntax check every file you touched\n{{syntaxCheckCommand}} ...\n\n# 2. Lint check (if configured)\n{{lintCommand}}\n\n# 3. Full test suite — must be 0 failures, 0 unexpected skips\n{{testCommand}}\n\n# 4. Build — must pass clean\n{{buildCommand}}\n```\n\nIf tests fail, **revert your change** (`git checkout -- `) and either:\n- Attempt a smaller, safer split of the same file, OR\n- Move to a different target file\n\n**Never push a failing test suite.**\n\n### Step 5 — Commit, push, and open the PR\n\nBranch name: `{{branch}}`\nBase branch: `{{baseBranch}}`\n\nCommit message format:\n```\nrefactor(): split \n\n- extracted into \n- \n\nNo functional changes. All tests pass.\n```\n\nPR title: `refactor: code quality pass — `\n\nPR body template:\n```markdown\n## Code Quality Pass\n\n**Session**: {{branch}}\n**Scope**: structural refactor only — zero functional changes\n\n### Changes\n- \n\n### Validation\n- `{{syntaxCheckCommand}}` passed on all touched files\n- `{{testCommand}}` passed (N tests)\n- `{{buildCommand}}` passed\n\n### Why\n\n```\n\n### Step 6 — Write session log\n\nAppend a new entry to `{{sessionLogPath}}` using this\nexact format (create the file if it does not exist):\n\n```markdown\n## \n\n- Scope: \n- Files changed: \n- Strategy: \n- Validation evidence:\n - `{{syntaxCheckCommand}}` passed on all touched files\n - `{{testCommand}}` passed (N tests)\n - `{{buildCommand}}` passed\n- PR: # — ``\n```\n\n## Time Budget Warning\n\nIf you have fewer than 15 minutes remaining:\n- Stop new analysis immediately\n- Commit and push whatever passing changes you have\n- Open the PR even if the scope is smaller than planned\n- Write the session log\n- Stop\n\nA small, clean, tested PR is always better than nothing." }, "position": { - "x": 250, - "y": 1650 + "x": 400, + "y": 450 }, "outputs": [ "default" ] }, { - "id": "mark-todo", - "type": "action.update_task_status", - "label": "Mark Todo (Repair Failed)", + "id": "verify-tests", + "type": "validation.tests", + "label": "Verify — Tests", "config": { - "taskId": "{{taskId}}", - "status": "todo", - "taskTitle": "{{taskTitle}}", - "workflowEvent": "task.repair_failed", - "workflowData": { - "stage": "repair", - "reason": "verification_failed", - "branch": "{{branch}}", - "worktreePath": "{{worktreePath}}", - "baseBranch": "{{baseBranch}}" - } + "command": "{{testCommand}}" }, "position": { - "x": 560, - "y": 1300 + "x": 200, + "y": 610 }, "outputs": [ "default" ] }, { - "id": "clear-repair-blocked-failure", - "type": "action.bosun_function", - "label": "Clear Failed Repair Blocked State", + "id": "verify-build", + "type": "validation.build", + "label": "Verify — Build", "config": { - "function": "tasks.update", - "args": { - "taskId": "{{taskId}}", - "fields": { - "cooldownUntil": null, - "blockedReason": null, - "meta": "{{(() => { const current = ($data?.meta && typeof $data.meta === 'object') ? $data.meta : {}; const next = { ...current }; delete next.autoRecovery; delete next.worktreeFailure; delete next.blockedReason; return next; })()}}" - } - } + "command": "{{buildCommand}}", + "zeroWarnings": false }, "position": { - "x": 560, - "y": 1440 + "x": 600, + "y": 610 + }, + "outputs": [ + "default" + ] + }, + { + "id": "check-validation", + "type": "condition.expression", + "label": "Validation Passed?", + "config": { + "expression": "$ctx.getNodeOutput('verify-tests')?.success === true && $ctx.getNodeOutput('verify-build')?.success === true" + }, + "position": { + "x": 400, + "y": 750 + }, + "outputs": [ + "yes", + "no" + ] + }, + { + "id": "create-pr", + "type": "action.create_pr", + "label": "Open Quality PR", + "config": { + "title": "refactor: code quality pass", + "body": "Automated code-quality session. Structural refactor only — zero functional changes. See `.bosun-monitor/code-quality-striker.md` for session details.", + "branch": "{{branch}}", + "baseBranch": "{{baseBranch}}", + "labels": [ + "refactor", + "code-quality", + "automated" + ] + }, + "position": { + "x": 200, + "y": 890 }, "outputs": [ "default" @@ -15932,45 +15242,45 @@ { "id": "notify-success", "type": "notify.telegram", - "label": "Notify Repair Success", + "label": "Notify PR Opened", "config": { - "message": ":check: Repair workflow recovered **{{taskTitle}}** ({{taskId}}) and moved it to inreview.", + "message": ":check: Code quality striker session complete.\nPR opened: **{{branch}}**", "silent": true }, "position": { - "x": 250, - "y": 1790 + "x": 200, + "y": 1030 }, "outputs": [ "default" ] }, { - "id": "notify-escalate", + "id": "notify-failure", "type": "notify.telegram", - "label": "Escalate Repair Failure", + "label": "Notify — Validation Failed", "config": { - "message": ":alert: Repair workflow could not recover **{{taskTitle}}** ({{taskId}}). Manual intervention required." + "message": ":alert: Code quality striker **validation failed**.\n\nThe agent produced changes that broke tests or build. No PR was created.\nCheck `.bosun-monitor/code-quality-striker.md` for details." }, "position": { - "x": 560, - "y": 1580 + "x": 600, + "y": 890 }, "outputs": [ "default" ] }, { - "id": "no-worktree", + "id": "log-failure", "type": "notify.log", - "label": "Missing Worktree Context", + "label": "Log Failure", "config": { - "message": "Task repair skipped for {{taskId}} — missing worktreePath in event payload", + "message": "Code quality striker validation failed — no PR created.", "level": "warn" }, "position": { - "x": 720, - "y": 460 + "x": 600, + "y": 1030 }, "outputs": [ "default" @@ -15979,325 +15289,238 @@ ], "edges": [ { - "id": "trigger-failed->has-branch-context", - "source": "trigger-failed", - "target": "has-branch-context", - "sourcePort": "default" - }, - { - "id": "trigger-finalization->has-branch-context", - "source": "trigger-finalization", - "target": "has-branch-context", + "id": "trigger->check-active-pr", + "source": "trigger", + "target": "check-active-pr", "sourcePort": "default" }, { - "id": "has-branch-context->recover-repair-worktree", - "source": "has-branch-context", - "target": "recover-repair-worktree", + "id": "check-active-pr->skip-already-running", + "source": "check-active-pr", + "target": "skip-already-running", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "has-branch-context->has-worktree", - "source": "has-branch-context", - "target": "has-worktree", + "id": "check-active-pr->scan-candidates", + "source": "check-active-pr", + "target": "scan-candidates", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "recover-repair-worktree->acquire-repair-worktree", - "source": "recover-repair-worktree", - "target": "acquire-repair-worktree", + "id": "scan-candidates->run-striker", + "source": "scan-candidates", + "target": "run-striker", "sourcePort": "default" }, { - "id": "acquire-repair-worktree->acquired-repair-worktree", - "source": "acquire-repair-worktree", - "target": "acquired-repair-worktree", + "id": "run-striker->verify-tests", + "source": "run-striker", + "target": "verify-tests", "sourcePort": "default" }, { - "id": "acquired-repair-worktree->refresh-worktree", - "source": "acquired-repair-worktree", - "target": "refresh-worktree", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "acquired-repair-worktree->no-worktree", - "source": "acquired-repair-worktree", - "target": "no-worktree", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "has-worktree->refresh-worktree", - "source": "has-worktree", - "target": "refresh-worktree", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "has-worktree->no-worktree", - "source": "has-worktree", - "target": "no-worktree", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "refresh-worktree->repair-agent", - "source": "refresh-worktree", - "target": "repair-agent", + "id": "run-striker->verify-build", + "source": "run-striker", + "target": "verify-build", "sourcePort": "default" }, { - "id": "repair-agent->verify", - "source": "repair-agent", - "target": "verify", + "id": "verify-tests->check-validation", + "source": "verify-tests", + "target": "check-validation", "sourcePort": "default" }, { - "id": "verify->verify-passed", - "source": "verify", - "target": "verify-passed", + "id": "verify-build->check-validation", + "source": "verify-build", + "target": "check-validation", "sourcePort": "default" }, { - "id": "verify-passed->create-pr", - "source": "verify-passed", + "id": "check-validation->create-pr", + "source": "check-validation", "target": "create-pr", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "verify-passed->mark-todo", - "source": "verify-passed", - "target": "mark-todo", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "create-pr->create-pr-success", - "source": "create-pr", - "target": "create-pr-success", - "sourcePort": "default" - }, - { - "id": "create-pr-success->mark-inreview", - "source": "create-pr-success", - "target": "mark-inreview", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "create-pr-success->mark-todo", - "source": "create-pr-success", - "target": "mark-todo", + "id": "check-validation->notify-failure", + "source": "check-validation", + "target": "notify-failure", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "mark-inreview->clear-repair-blocked-success", - "source": "mark-inreview", - "target": "clear-repair-blocked-success", - "sourcePort": "default" - }, - { - "id": "clear-repair-blocked-success->handoff-pr-progressor", - "source": "clear-repair-blocked-success", - "target": "handoff-pr-progressor", - "sourcePort": "default" - }, - { - "id": "handoff-pr-progressor->notify-success", - "source": "handoff-pr-progressor", + "id": "create-pr->notify-success", + "source": "create-pr", "target": "notify-success", "sourcePort": "default" }, { - "id": "mark-todo->clear-repair-blocked-failure", - "source": "mark-todo", - "target": "clear-repair-blocked-failure", - "sourcePort": "default" - }, - { - "id": "clear-repair-blocked-failure->notify-escalate", - "source": "clear-repair-blocked-failure", - "target": "notify-escalate", - "sourcePort": "default" - }, - { - "id": "no-worktree->notify-escalate", - "source": "no-worktree", - "target": "notify-escalate", + "id": "notify-failure->log-failure", + "source": "notify-failure", + "target": "log-failure", "sourcePort": "default" } ] }, { - "id": "template-task-status-transition-manager", - "name": "Task Status Transition Manager", - "description": "Central workflow-owned task status transitions. Consumes task lifecycle transition requests from executors/monitor and applies canonical status updates.", - "category": "reliability", - "categoryLabel": "Reliability", - "categoryIcon": ":shield:", - "categoryOrder": 5, + "id": "template-task-debug", + "name": "Debug Task Workflow", + "description": "Bug investigation and fix workflow. Starts with reproduction and root-cause analysis, then implements a targeted fix with regression tests.", + "category": "task-execution", + "categoryLabel": "Task Execution", + "categoryIcon": ":settings:", + "categoryOrder": 99, "tags": [ - "task", - "status", - "lifecycle", - "workflow-owned" + "debug", + "bug", + "fix", + "error", + "task-type" ], - "nodeCount": 7, - "edgeCount": 6, + "nodeCount": 5, + "edgeCount": 4, "recommended": true, "enabled": true, - "trigger": "trigger.event", - "variables": {}, + "trigger": "trigger.task_assigned", + "variables": { + "taskTimeoutMs": 21600000, + "maxRetries": 3, + "maxContinues": 4, + "testCommand": "auto", + "buildCommand": "auto", + "lintCommand": "auto" + }, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2026-02-27T00:00:00Z", - "templateVersion": "1.0.1", + "createdAt": "2025-06-01T00:00:00Z", + "templateVersion": "1.0.0", "tags": [ - "task", - "status", - "lifecycle", - "workflow-owned" + "debug", + "bug", + "fix", + "error", + "task-type" ], - "replaces": { - "module": "task-executor.mjs", - "functions": [ - "direct status transition writes" - ], - "calledFrom": [ - "task-executor.mjs:executeTask", - "task-executor.mjs:_recoverInterruptedInProgressTasks", - "task-executor.mjs:_handleTaskResult" - ], - "description": "Moves task state mutations from executor code into a dedicated workflow so all status changes are auditable and event-driven." - } + "resolveMode": "library" }, "nodes": [ { "id": "trigger", - "type": "trigger.event", - "label": "Transition Requested", + "type": "trigger.task_assigned", + "label": "Task Assigned", "config": { - "eventType": "task.transition.requested" + "taskPattern": "bug|fix|error|crash|regression|broken|debug|issue|defect|hotfix|patch" }, "position": { - "x": 420, - "y": 60 + "x": 400, + "y": 50 }, "outputs": [ "default" ] }, { - "id": "route-status", - "type": "condition.switch", - "label": "Route Target Status", + "id": "reproduce", + "type": "action.run_agent", + "label": "Reproduce & Analyse", "config": { - "value": "$data?.targetStatus || $data?.status || ''", - "cases": { - "inprogress": "inprogress", - "inreview": "inreview", - "done": "done", - "todo": "todo" - } + "prompt": "## Phase: Bug Reproduction & Root Cause Analysis\n\n1. Read the bug report carefully\n2. Find the relevant code area\n3. Reproduce the issue (write a failing test if possible)\n4. Trace the root cause through the codebase\n5. Document: what fails, where, why, and the minimal fix needed\n\nDo NOT fix the bug yet — only diagnose.", + "taskId": "{{taskId}}", + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "repoMapQuery": "{{taskTitle}} {{taskDescription}}", + "repoMapFileLimit": 8, + "mode": "plan", + "executionRole": "architect" }, "position": { - "x": 420, - "y": 220 + "x": 400, + "y": 180 }, "outputs": [ - "inprogress", - "inreview", - "done", - "todo", "default" ] }, { - "id": "set-inprogress", - "type": "action.update_task_status", - "label": "Set In Progress", + "id": "fix-and-test", + "type": "action.run_agent", + "label": "Fix & Regression Test", "config": { + "prompt": "## Phase: Fix Implementation with Regression Tests\n\n1. Write a regression test that demonstrates the bug (must fail before fix)\n2. Apply the minimal, surgical fix\n3. Verify the regression test now passes\n4. Run the full test suite: {{testCommand}}\n5. Run build: {{buildCommand}}\n6. Run lint: {{lintCommand}}\n7. Ensure no other tests broke\n\nCommit fix and test together with a clear commit message.", "taskId": "{{taskId}}", - "status": "inprogress", - "taskTitle": "{{taskTitle}}" + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "repoMapQuery": "{{taskTitle}} {{taskDescription}}", + "repoMapFileLimit": 8, + "executionRole": "editor", + "architectPlan": "{{$ctx.getNodeOutput('reproduce')?.summary || $ctx.getNodeOutput('reproduce')?.output || ''}}" }, "position": { - "x": 120, - "y": 390 + "x": 400, + "y": 340 }, "outputs": [ "default" ] }, { - "id": "set-inreview", - "type": "action.update_task_status", - "label": "Set In Review", - "config": { - "taskId": "{{taskId}}", - "status": "inreview", - "taskTitle": "{{taskTitle}}" - }, - "position": { - "x": 320, - "y": 390 - }, - "outputs": [ - "default" - ] - }, - { - "id": "set-done", - "type": "action.update_task_status", - "label": "Set Done", - "config": { - "taskId": "{{taskId}}", - "status": "done", - "taskTitle": "{{taskTitle}}" - }, - "position": { - "x": 520, - "y": 390 - }, - "outputs": [ - "default" - ] - }, - { - "id": "set-todo", - "type": "action.update_task_status", - "label": "Set Todo", + "id": "verify", + "type": "action.run_agent", + "label": "Verify & PR", "config": { + "prompt": "## Phase: Final Verification\n\n1. Run complete test suite: {{testCommand}}\n2. Run build: {{buildCommand}}\n3. Confirm the original bug is fixed\n4. Confirm no regressions\n5. Push and create/update PR with root cause analysis in description", "taskId": "{{taskId}}", - "status": "todo", - "taskTitle": "{{taskTitle}}" + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "repoMapQuery": "{{taskTitle}} {{taskDescription}}", + "repoMapFileLimit": 8, + "executionRole": "editor", + "architectPlan": "{{$ctx.getNodeOutput('reproduce')?.summary || $ctx.getNodeOutput('reproduce')?.output || ''}}" }, "position": { - "x": 720, - "y": 390 + "x": 400, + "y": 500 }, "outputs": [ "default" ] }, { - "id": "unknown-status", + "id": "done", "type": "notify.log", - "label": "Unknown Status Requested", + "label": "Complete", "config": { - "message": "Task {{taskId}} transition ignored: unsupported target status '{{targetStatus}}'", - "level": "warn" + "message": "Debug task completed — bug fixed with regression test." }, "position": { - "x": 420, - "y": 520 + "x": 400, + "y": 660 }, "outputs": [ "default" @@ -16306,100 +15529,80 @@ ], "edges": [ { - "id": "trigger->route-status", + "id": "trigger->reproduce", "source": "trigger", - "target": "route-status", + "target": "reproduce", "sourcePort": "default" }, { - "id": "route-status->set-inprogress", - "source": "route-status", - "target": "set-inprogress", - "sourcePort": "inprogress" - }, - { - "id": "route-status->set-inreview", - "source": "route-status", - "target": "set-inreview", - "sourcePort": "inreview" - }, - { - "id": "route-status->set-done", - "source": "route-status", - "target": "set-done", - "sourcePort": "done" + "id": "reproduce->fix-and-test", + "source": "reproduce", + "target": "fix-and-test", + "sourcePort": "default" }, { - "id": "route-status->set-todo", - "source": "route-status", - "target": "set-todo", - "sourcePort": "todo" + "id": "fix-and-test->verify", + "source": "fix-and-test", + "target": "verify", + "sourcePort": "default" }, { - "id": "route-status->unknown-status", - "source": "route-status", - "target": "unknown-status", + "id": "verify->done", + "source": "verify", + "target": "done", "sourcePort": "default" } ] }, { - "id": "template-workspace-hygiene", - "name": "Workspace Hygiene", - "description": "Scheduled maintenance sweep: prune orphaned worktrees, kill stale processes, rotate logs, and clean up old agent evidence. Keeps your dev environment lean.", - "category": "reliability", - "categoryLabel": "Reliability", - "categoryIcon": ":shield:", - "categoryOrder": 5, + "id": "template-task-design", + "name": "Design Task Workflow", + "description": "For design-related tasks — mockups, wireframes, design tokens, component library work. Analyses design requirements, implements the design system changes, and verifies visual output.", + "category": "task-execution", + "categoryLabel": "Task Execution", + "categoryIcon": ":settings:", + "categoryOrder": 99, "tags": [ - "maintenance", - "cleanup", - "worktree", - "hygiene" + "design", + "mockup", + "wireframe", + "design-system", + "task-type" ], - "nodeCount": 8, - "edgeCount": 9, + "nodeCount": 5, + "edgeCount": 4, "recommended": true, "enabled": true, - "trigger": "trigger.schedule", + "trigger": "trigger.task_assigned", "variables": { - "staleProcessMaxAge": "15m", - "worktreeMaxAge": "48h", - "logRetentionDays": 7 + "taskTimeoutMs": 21600000, + "maxRetries": 2, + "maxContinues": 3, + "testCommand": "auto", + "buildCommand": "auto", + "lintCommand": "auto" }, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2025-02-25T00:00:00Z", - "templateVersion": "1.0.1", + "createdAt": "2025-06-01T00:00:00Z", + "templateVersion": "1.0.0", "tags": [ - "maintenance", - "cleanup", - "worktree", - "hygiene" + "design", + "mockup", + "wireframe", + "design-system", + "task-type" ], - "replaces": { - "module": "maintenance.mjs", - "functions": [ - "runMaintenanceSweep", - "killStaleOrchestrators", - "reapStuckGitPushes", - "cleanupWorktrees" - ], - "calledFrom": [ - "monitor.mjs:startProcess" - ], - "description": "Replaces the hardcoded maintenance sweep with a visual workflow. Worktree pruning, stale process cleanup, log rotation, and git gc become explicit, configurable workflow steps." - } + "resolveMode": "library" }, "nodes": [ { "id": "trigger", - "type": "trigger.schedule", - "label": "Daily Cleanup", + "type": "trigger.task_assigned", + "label": "Task Assigned", "config": { - "intervalMs": 86400000, - "cron": "0 3 * * *" + "taskPattern": "design|mockup|wireframe|prototype|design.system|theme|color|typography|icon|illustration|ux" }, "position": { "x": 400, @@ -16410,110 +15613,102 @@ ] }, { - "id": "prune-worktrees", - "type": "action.run_command", - "label": "Prune Worktrees", - "config": { - "command": "node -e \"const cp=require('node:child_process');cp.execSync('git worktree prune',{stdio:'ignore'});const wt=cp.execSync('git worktree list --porcelain',{encoding:'utf8'});const count=(wt.match(/^worktree /gm)||[]).length;process.stdout.write(String(count)+'\\\\n');\"" - }, - "position": { - "x": 150, - "y": 200 - }, - "outputs": [ - "default" - ] - }, - { - "id": "kill-stale", - "type": "action.run_command", - "label": "Kill Stale Processes", + "id": "analyse-requirements", + "type": "action.run_agent", + "label": "Analyse Design Req", "config": { - "command": "bosun maintenance --kill-stale --max-age {{staleProcessMaxAge}}", - "continueOnError": true + "prompt": "## Phase: Design Requirements Analysis\n\n1. Review the design task requirements\n2. Identify affected design tokens, components, or patterns\n3. Check existing design system for reusable pieces\n4. Plan the implementation approach\n5. List affected files and components\n\nDo NOT make changes yet.", + "taskId": "{{taskId}}", + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "repoMapQuery": "{{taskTitle}} {{taskDescription}}", + "repoMapFileLimit": 8, + "mode": "plan", + "executionRole": "architect" }, "position": { "x": 400, - "y": 200 - }, - "outputs": [ - "default" - ] - }, - { - "id": "rotate-logs", - "type": "action.run_command", - "label": "Rotate Agent Logs", - "config": { - "command": "node -e \"const fs=require('node:fs');const path=require('node:path');const root=path.resolve('.bosun','logs');const cutoff=Date.now()-((Number('{{logRetentionDays}}')||7)*86400000);let removed=0;const walk=(dir)=>{if(!fs.existsSync(dir))return;for(const entry of fs.readdirSync(dir,{withFileTypes:true})){const full=path.join(dir,entry.name);if(entry.isDirectory())walk(full);else if(entry.isFile()&&entry.name.endsWith('.log')){const stat=fs.statSync(full);if(Number(stat.mtimeMs||0){if(!fs.existsSync(dir))return;for(const entry of fs.readdirSync(dir,{withFileTypes:true})){const full=path.join(dir,entry.name);if(entry.isDirectory())walk(full);else if(entry.isFile()){const stat=fs.statSync(full);if(Number(stat.mtimeMs||0)/dev/null || dir /s .bosun 2>nul" + "prompt": "## Phase: Design Implementation\n\n1. Update design tokens (colors, spacing, typography) if needed\n2. Create / update components per the design specification\n3. Ensure consistency with existing design system\n4. Add visual tests or snapshots where applicable\n5. Run build: {{buildCommand}}\n6. Run lint: {{lintCommand}}\n\nCommit changes with descriptive messages.", + "taskId": "{{taskId}}", + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "repoMapQuery": "{{taskTitle}} {{taskDescription}}", + "repoMapFileLimit": 8, + "executionRole": "editor", + "architectPlan": "{{$ctx.getNodeOutput('analyse-requirements')?.summary || $ctx.getNodeOutput('analyse-requirements')?.output || ''}}" }, "position": { "x": 400, - "y": 380 + "y": 340 }, "outputs": [ "default" ] }, { - "id": "gc-git", - "type": "action.run_command", - "label": "Git GC", + "id": "verify-design", + "type": "action.run_agent", + "label": "Verify & PR", "config": { - "command": "git gc --auto --quiet", - "continueOnError": true + "prompt": "## Phase: Design Verification\n\n1. Run tests: {{testCommand}}\n2. Run build: {{buildCommand}}\n3. Verify visual consistency\n4. Check design token values are correct\n5. Push and create/update PR", + "taskId": "{{taskId}}", + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "repoMapQuery": "{{taskTitle}} {{taskDescription}}", + "repoMapFileLimit": 8, + "executionRole": "editor", + "architectPlan": "{{$ctx.getNodeOutput('analyse-requirements')?.summary || $ctx.getNodeOutput('analyse-requirements')?.output || ''}}" }, "position": { - "x": 650, - "y": 380 + "x": 400, + "y": 500 }, "outputs": [ "default" ] }, { - "id": "summary", + "id": "done", "type": "notify.log", - "label": "Log Summary", + "label": "Complete", "config": { - "message": "Workspace hygiene sweep completed (max worktree age target: {{worktreeMaxAge}})", - "level": "info" + "message": "Design task completed — design changes implemented and verified." }, "position": { "x": 400, - "y": 540 + "y": 660 }, "outputs": [ "default" @@ -16522,270 +15717,170 @@ ], "edges": [ { - "id": "trigger->prune-worktrees", - "source": "trigger", - "target": "prune-worktrees", - "sourcePort": "default" - }, - { - "id": "trigger->kill-stale", - "source": "trigger", - "target": "kill-stale", - "sourcePort": "default" - }, - { - "id": "trigger->rotate-logs", + "id": "trigger->analyse-requirements", "source": "trigger", - "target": "rotate-logs", - "sourcePort": "default" - }, - { - "id": "prune-worktrees->clean-evidence", - "source": "prune-worktrees", - "target": "clean-evidence", - "sourcePort": "default" - }, - { - "id": "kill-stale->check-disk", - "source": "kill-stale", - "target": "check-disk", - "sourcePort": "default" - }, - { - "id": "rotate-logs->gc-git", - "source": "rotate-logs", - "target": "gc-git", + "target": "analyse-requirements", "sourcePort": "default" }, { - "id": "clean-evidence->summary", - "source": "clean-evidence", - "target": "summary", + "id": "analyse-requirements->implement-design", + "source": "analyse-requirements", + "target": "implement-design", "sourcePort": "default" }, { - "id": "check-disk->summary", - "source": "check-disk", - "target": "summary", + "id": "implement-design->verify-design", + "source": "implement-design", + "target": "verify-design", "sourcePort": "default" }, { - "id": "gc-git->summary", - "source": "gc-git", - "target": "summary", + "id": "verify-design->done", + "source": "verify-design", + "target": "done", "sourcePort": "default" } ] }, { - "id": "template-research-agent", - "name": "Iterative Research Agent", - "description": "An iterative research agent inspired by Google DeepMind's Aletheia. Generates a candidate solution, verifies it with an independent model, and routes through revision (minor fixes) or full regeneration (critical flaws) cycles until the solution converges or max iterations are reached. Supports web search for literature navigation.", - "category": "research", - "categoryLabel": "Research", - "categoryIcon": ":search:", - "categoryOrder": 6, + "id": "template-flow-control-suite", + "name": "Flow Control Suite", + "description": "Exercises flow-control primitives in a single short workflow: join, while-loop (0 iters), universal dispatch, and meeting finalization.", + "category": "coverage", + "categoryLabel": "Coverage", + "categoryIcon": ":settings:", + "categoryOrder": 99, "tags": [ - "research", - "aletheia", - "convergence-loop", - "back-edge" + "coverage", + "flow", + "control" ], - "nodeCount": 10, - "edgeCount": 11, + "nodeCount": 7, + "edgeCount": 6, "recommended": false, "enabled": true, "trigger": "trigger.manual", "variables": { - "maxIterations": 10, - "problem": "", - "domain": "mathematics" + "subWorkflowId": "template-health-check", + "sessionId": "session-flow-test", + "maxLoopIterations": 1 }, "metadata": { - "createdAt": "2026-03-03T00:00:00.000Z", - "version": 1, - "author": "bosun", + "author": "virtengine", "tags": [ - "research", - "aletheia", - "convergence-loop", - "back-edge" + "coverage", + "flow", + "control" + ], + "requiredTemplates": [ + "template-health-check" ] }, "nodes": [ { "id": "trigger", "type": "trigger.manual", - "label": "Start Research", + "label": "Manual Trigger", "config": {}, "position": { - "x": 400, - "y": 50 + "x": 100, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "literature-search", - "type": "action.web_search", - "label": "Search Literature", + "id": "join", + "type": "flow.join", + "label": "Join Branches", "config": { - "query": "{{problem}} {{domain}} research papers", - "maxResults": 5, - "engine": "fetch" + "mode": "any", + "sourceNodeIds": [] }, "position": { - "x": 400, - "y": 160 + "x": 380, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "generator", - "type": "action.run_agent", - "label": "Generate Solution", + "id": "loop", + "type": "loop.while", + "label": "While Loop", "config": { - "prompt": "# Research Problem — Generate a Candidate Solution\n\n## Problem\n{{problem}}\n\n## Domain\n{{domain}}\n\n## Configuration\nMax verification cycles: {{maxIterations}}\n\n## Literature Context\n{{literature-search.results}}\n\n## Previous Attempts\n{{_previousFeedback}}\n\n## Instructions\nYou are a research agent solving a challenging problem in {{domain}}.\nProduce a rigorous, well-structured candidate solution. Show your\nreasoning step-by-step. If this is a retry after a critical flaw,\ntake a fundamentally different approach.\n\nProvide your solution in a clear format with:\n1. Approach overview\n2. Detailed proof/derivation/analysis\n3. Verification of key steps\n4. Final answer/conclusion", - "sdk": "auto", - "timeoutMs": 1800000, - "failOnError": false + "condition": "$iteration < 0", + "maxIterations": "{{maxLoopIterations}}" }, "position": { - "x": 400, - "y": 280 + "x": 660, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "verifier", - "type": "action.run_agent", - "label": "Verify Solution", + "id": "dispatch1", + "type": "flow.universal", + "label": "Universal Dispatch 1", "config": { - "prompt": "# Independent Verification\n\n## Original Problem\n{{problem}}\n\n## Candidate Solution\n{{generator.output}}\n\n## Instructions\nYou are an independent verifier. Rigorously check the candidate solution:\n1. Is the logic/proof valid at every step?\n2. Are there any gaps, errors, or unjustified assumptions?\n3. Is the conclusion correct and complete?\n\nProvide your assessment with ONE of these verdicts:\n\n**VERDICT: CORRECT** — The solution is rigorous and complete.\n**VERDICT: MINOR** — The solution has the right approach but needs fixes. List specific issues.\n**VERDICT: CRITICAL** — The solution is fundamentally flawed. Explain why.\n\nAfter the verdict, provide detailed feedback explaining your reasoning.", - "sdk": "auto", - "timeoutMs": 900000, - "failOnError": false + "mode": "dispatch", + "workflowId": "{{subWorkflowId}}" }, "position": { - "x": 400, - "y": 420 + "x": 940, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "parse-verdict", - "type": "transform.llm_parse", - "label": "Parse Verdict", + "id": "dispatch2", + "type": "flow.universial", + "label": "Universal Dispatch 2", "config": { - "input": "verifier", - "field": "output", - "patterns": { - "verdict": "VERDICT:\\s*(CORRECT|MINOR|CRITICAL)" - }, - "keywords": { - "severity": [ - "correct", - "minor", - "critical" - ] - }, - "outputPort": "verdict" + "workflowId": "{{subWorkflowId}}", + "mode": "dispatch" }, "position": { - "x": 400, - "y": 540 + "x": 1220, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "output-result", - "type": "notify.log", - "label": "Solution Found!", + "id": "finalize-meeting", + "type": "meeting.finalize", + "label": "Finalize Meeting", "config": { - "message": "Research complete! Solution verified as correct.\n\nProblem: {{problem}}\nSolution: {{generator.output}}", - "level": "info" + "sessionId": "{{sessionId}}", + "continueOnError": true }, "position": { - "x": 100, - "y": 680 + "x": 1500, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "end-success", - "type": "flow.end", - "label": "End Research (Success)", + "id": "done", + "type": "notify.log", + "label": "Done", "config": { - "status": "completed", - "message": "Research workflow converged to a verified solution", - "output": { - "verdict": "correct", - "problem": "{{problem}}" - } + "message": "Flow control suite complete", + "level": "info" }, "position": { - "x": 100, - "y": 810 - }, - "outputs": [ - "default" - ] - }, - { - "id": "reviser", - "type": "action.continue_session", - "label": "Revise Solution", - "config": { - "prompt": "The verifier found minor issues with your solution:\n\n{{verifier.output}}\n\nPlease fix these specific issues while keeping your overall approach.\nProvide the corrected solution in the same format.", - "strategy": "refine", - "timeoutMs": 900000 - }, - "position": { - "x": 400, - "y": 680 - }, - "outputs": [ - "default" - ] - }, - { - "id": "critical-log", - "type": "notify.log", - "label": "Critical Flaw Detected", - "config": { - "message": "Critical flaw in solution — restarting generator with new approach.\nFeedback: {{verifier.output}}", - "level": "warn" - }, - "position": { - "x": 700, - "y": 680 - }, - "outputs": [ - "default" - ] - }, - { - "id": "store-feedback", - "type": "action.set_variable", - "label": "Store Feedback", - "config": { - "variable": "_previousFeedback", - "value": "Previous attempt was critically flawed: {{verifier.output}}. Take a fundamentally different approach." - }, - "position": { - "x": 700, - "y": 800 + "x": 1780, + "y": 100 }, "outputs": [ "default" @@ -16794,116 +15889,93 @@ ], "edges": [ { - "id": "trigger->literature-search", + "id": "trigger->join", "source": "trigger", - "target": "literature-search", + "target": "join", "sourcePort": "default" }, { - "id": "literature-search->generator", - "source": "literature-search", - "target": "generator", + "id": "join->loop", + "source": "join", + "target": "loop", "sourcePort": "default" }, { - "id": "generator->verifier", - "source": "generator", - "target": "verifier", + "id": "loop->dispatch1", + "source": "loop", + "target": "dispatch1", "sourcePort": "default" }, { - "id": "verifier->parse-verdict", - "source": "verifier", - "target": "parse-verdict", + "id": "dispatch1->dispatch2", + "source": "dispatch1", + "target": "dispatch2", "sourcePort": "default" }, { - "id": "parse-verdict->output-result", - "source": "parse-verdict", - "target": "output-result", - "sourcePort": "correct" - }, - { - "id": "parse-verdict->reviser", - "source": "parse-verdict", - "target": "reviser", - "sourcePort": "minor" - }, - { - "id": "parse-verdict->critical-log", - "source": "parse-verdict", - "target": "critical-log", - "sourcePort": "critical" - }, - { - "id": "output-result->end-success", - "source": "output-result", - "target": "end-success", + "id": "dispatch2->finalize-meeting", + "source": "dispatch2", + "target": "finalize-meeting", "sourcePort": "default" }, { - "id": "reviser->verifier", - "source": "reviser", - "target": "verifier", - "sourcePort": "default", - "backEdge": true, - "maxIterations": 5 - }, - { - "id": "critical-log->store-feedback", - "source": "critical-log", - "target": "store-feedback", + "id": "finalize-meeting->done", + "source": "finalize-meeting", + "target": "done", "sourcePort": "default" - }, - { - "id": "store-feedback->generator", - "source": "store-feedback", - "target": "generator", - "sourcePort": "default", - "backEdge": true, - "maxIterations": 5 } ] }, { - "id": "template-research-loop", - "name": "Research Loop (While-Based)", - "description": "An iterative research agent using loop.while to repeatedly execute a generate→verify sub-workflow until the solution converges. Alternative to the back-edge approach — useful when you want the iteration logic centralized in a single node.", - "category": "research", - "categoryLabel": "Research", - "categoryIcon": ":search:", - "categoryOrder": 6, + "id": "template-task-frontend", + "name": "Frontend Task Workflow", + "description": "Specialised for UI tasks — components, pages, styling, accessibility. Runs three phases: design analysis, implement with component tests, and visual verification.", + "category": "task-execution", + "categoryLabel": "Task Execution", + "categoryIcon": ":settings:", + "categoryOrder": 99, "tags": [ - "research", - "loop-while", - "convergence" + "frontend", + "ui", + "css", + "component", + "task-type" ], "nodeCount": 5, "edgeCount": 4, - "recommended": false, + "recommended": true, "enabled": true, - "trigger": "trigger.manual", + "trigger": "trigger.task_assigned", "variables": { - "maxIterations": 10, - "problem": "", - "domain": "mathematics" + "taskTimeoutMs": 21600000, + "maxRetries": 2, + "maxContinues": 3, + "testCommand": "auto", + "buildCommand": "auto", + "lintCommand": "auto" }, "metadata": { - "createdAt": "2026-03-03T00:00:00.000Z", - "version": 1, "author": "bosun", + "version": 1, + "createdAt": "2025-06-01T00:00:00Z", + "templateVersion": "1.0.0", "tags": [ - "research", - "loop-while", - "convergence" - ] + "frontend", + "ui", + "css", + "component", + "task-type" + ], + "resolveMode": "library" }, "nodes": [ { "id": "trigger", - "type": "trigger.manual", - "label": "Start Research", - "config": {}, + "type": "trigger.task_assigned", + "label": "Task Assigned", + "config": { + "taskPattern": "frontend|ui|component|page|layout|style|css|responsive|accessibility|a11y|design.system" + }, "position": { "x": 400, "y": 50 @@ -16913,71 +15985,102 @@ ] }, { - "id": "search", - "type": "action.web_search", - "label": "Search Literature", + "id": "analyse-design", + "type": "action.run_agent", + "label": "Analyse Design", "config": { - "query": "{{problem}} {{domain}} research", - "maxResults": 5 + "prompt": "## Phase: Design Analysis\n\nAnalyse the UI task requirements:\n1. Component hierarchy and structure\n2. Layout and responsive breakpoints\n3. State management needs\n4. Accessibility requirements (ARIA, keyboard nav)\n5. Styling approach (CSS modules, Tailwind, styled-components)\n6. Component test plan\n\nDo NOT write code yet.", + "taskId": "{{taskId}}", + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "repoMapQuery": "{{taskTitle}} {{taskDescription}}", + "repoMapFileLimit": 8, + "mode": "plan", + "executionRole": "architect" }, "position": { "x": 400, - "y": 160 + "y": 180 }, "outputs": [ "default" ] }, { - "id": "iterate", - "type": "loop.while", - "label": "Iterate Until Converged", + "id": "implement-ui", + "type": "action.run_agent", + "label": "Implement UI", "config": { - "condition": "$state._lastSuccess !== true || $state._verdict !== 'correct'", - "workflowId": "{{_researchSubWorkflowId}}", - "maxIterations": "{{maxIterations}}", - "stateVariable": "researchState", - "earlyExitOn": "never" + "prompt": "## Phase: UI Implementation\n\n1. Create / update components per the design plan\n2. Implement layouts, styling, and responsive design\n3. Add proper accessibility attributes\n4. Write component tests\n5. Run tests: {{testCommand}}\n6. Run build: {{buildCommand}}\n7. Run lint: {{lintCommand}}\n\nCommit with descriptive messages.", + "taskId": "{{taskId}}", + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "repoMapQuery": "{{taskTitle}} {{taskDescription}}", + "repoMapFileLimit": 8, + "executionRole": "editor", + "architectPlan": "{{$ctx.getNodeOutput('analyse-design')?.summary || $ctx.getNodeOutput('analyse-design')?.output || ''}}" }, "position": { "x": 400, - "y": 280 + "y": 340 }, "outputs": [ "default" ] }, { - "id": "output", - "type": "notify.log", - "label": "Research Complete", + "id": "verify-visual", + "type": "action.run_agent", + "label": "Verify & PR", "config": { - "message": "Research loop completed after {{iterate.iterations}} iteration(s). Converged: {{iterate.converged}}", - "level": "info" + "prompt": "## Phase: Visual Verification\n\n1. Run the full test suite: {{testCommand}}\n2. Run build: {{buildCommand}}\n3. Verify components render correctly\n4. Check responsive breakpoints\n5. Verify accessibility (screen reader, keyboard)\n6. Push changes and create/update PR", + "taskId": "{{taskId}}", + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "repoMapQuery": "{{taskTitle}} {{taskDescription}}", + "repoMapFileLimit": 8, + "executionRole": "editor", + "architectPlan": "{{$ctx.getNodeOutput('analyse-design')?.summary || $ctx.getNodeOutput('analyse-design')?.output || ''}}" }, "position": { "x": 400, - "y": 400 + "y": 500 }, "outputs": [ "default" ] }, { - "id": "end", - "type": "flow.end", - "label": "End Loop", + "id": "done", + "type": "notify.log", + "label": "Complete", "config": { - "status": "completed", - "message": "Research loop workflow completed", - "output": { - "converged": "{{iterate.converged}}", - "iterations": "{{iterate.iterations}}" - } + "message": "Frontend task completed — UI implemented and verified." }, "position": { "x": 400, - "y": 520 + "y": 660 }, "outputs": [ "default" @@ -16986,87 +16089,74 @@ ], "edges": [ { - "id": "trigger->search", + "id": "trigger->analyse-design", "source": "trigger", - "target": "search", + "target": "analyse-design", "sourcePort": "default" }, { - "id": "search->iterate", - "source": "search", - "target": "iterate", + "id": "analyse-design->implement-ui", + "source": "analyse-design", + "target": "implement-ui", "sourcePort": "default" }, { - "id": "iterate->output", - "source": "iterate", - "target": "output", + "id": "implement-ui->verify-visual", + "source": "implement-ui", + "target": "verify-visual", "sourcePort": "default" }, { - "id": "output->end", - "source": "output", - "target": "end", + "id": "verify-visual->done", + "source": "verify-visual", + "target": "done", "sourcePort": "default" } ] }, { - "id": "template-dependency-audit", - "name": "Dependency Audit", - "description": "Scheduled scan for vulnerable dependencies using npm audit. Classifies findings by severity, prepares fix branches, and hands off fixable packages, and alerts on critical vulnerabilities that require manual intervention.", - "category": "security", - "categoryLabel": "Security", - "categoryIcon": ":lock:", - "categoryOrder": 7, + "id": "template-task-fullstack", + "name": "Fullstack Task Workflow", + "description": "Handles tasks that span frontend and backend — API endpoints, database models, and UI components. Runs four agent phases: architecture planning, backend implementation, frontend implementation, and integration testing.", + "category": "task-execution", + "categoryLabel": "Task Execution", + "categoryIcon": ":settings:", + "categoryOrder": 99, "tags": [ - "security", - "audit", - "dependencies", - "npm", - "vulnerability" + "fullstack", + "task-type" ], - "nodeCount": 12, - "edgeCount": 14, + "nodeCount": 6, + "edgeCount": 5, "recommended": true, "enabled": true, - "trigger": "trigger.schedule", + "trigger": "trigger.task_assigned", "variables": { - "auditLevel": "moderate", - "autoFixEnabled": true, - "maxAutoFixPRs": 3 + "taskTimeoutMs": 21600000, + "maxRetries": 2, + "maxContinues": 3, + "testCommand": "auto", + "buildCommand": "auto", + "lintCommand": "auto" }, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2025-02-25T00:00:00Z", + "createdAt": "2025-06-01T00:00:00Z", "templateVersion": "1.0.0", "tags": [ - "security", - "audit", - "dependencies", - "npm", - "vulnerability" + "fullstack", + "task-type" ], - "replaces": { - "module": "preflight.mjs", - "functions": [ - "checkDependencyHealth" - ], - "calledFrom": [ - "monitor.mjs:startProcess" - ], - "description": "Replaces ad-hoc dependency health checks with a scheduled audit workflow. Severity classification, auto-fix, and Bosun-managed lifecycle handoff become explicit, configurable workflow steps." - } + "resolveMode": "library" }, "nodes": [ { "id": "trigger", - "type": "trigger.schedule", - "label": "Daily Audit", + "type": "trigger.task_assigned", + "label": "Task Assigned", "config": { - "intervalMs": 86400000, - "cron": "0 6 * * *" + "taskPattern": "full.?stack|end.to.end|api.*ui|server.*client|frontend.*backend|database.*component" }, "position": { "x": 400, @@ -17077,12 +16167,25 @@ ] }, { - "id": "run-audit", - "type": "action.run_command", - "label": "Run npm audit", + "id": "plan-architecture", + "type": "action.run_agent", + "label": "Plan Architecture", "config": { - "command": "npm audit --json 2>/dev/null || echo '{\"vulnerabilities\":{}}'", - "continueOnError": true + "prompt": "## Phase: Architecture Planning\n\nAnalyse the task and produce a concrete plan covering:\n1. Backend changes: API routes, models, services, migrations\n2. Frontend changes: components, pages, state management\n3. Shared types / contracts between layers\n4. Test strategy for each layer\n5. Integration points and data flow\n\nDo NOT write code yet — produce only the plan.", + "taskId": "{{taskId}}", + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "repoMapQuery": "{{taskTitle}} {{taskDescription}}", + "repoMapFileLimit": 8, + "mode": "plan", + "executionRole": "architect" }, "position": { "x": 400, @@ -17093,451 +16196,329 @@ ] }, { - "id": "parse-results", - "type": "transform.json_parse", - "label": "Parse Audit Results", + "id": "implement-backend", + "type": "action.run_agent", + "label": "Implement Backend", "config": { - "input": "$ctx.getNodeOutput('run-audit')?.output || '{}'" + "prompt": "## Phase: Backend Implementation\n\nImplement the server-side / API changes from the architecture plan:\n- Models, schemas, database migrations\n- API routes and controllers\n- Service / business logic\n- Unit tests for backend logic\n- Run tests: {{testCommand}}\n\nCommit backend changes separately.", + "taskId": "{{taskId}}", + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "repoMapQuery": "{{taskTitle}} {{taskDescription}}", + "repoMapFileLimit": 8, + "executionRole": "editor", + "architectPlan": "{{$ctx.getNodeOutput('plan-architecture')?.summary || $ctx.getNodeOutput('plan-architecture')?.output || ''}}" }, "position": { "x": 400, - "y": 310 + "y": 340 }, "outputs": [ "default" ] }, { - "id": "has-vulns", - "type": "condition.expression", - "label": "Vulnerabilities Found?", + "id": "implement-frontend", + "type": "action.run_agent", + "label": "Implement Frontend", "config": { - "expression": "(() => { const out = $ctx.getNodeOutput('run-audit')?.output || '{}'; try { const d = JSON.parse(out); const v = d.vulnerabilities || {}; return Object.keys(v).length > 0; } catch { return out.includes('vulnerability') || out.includes('moderate') || out.includes('high') || out.includes('critical'); } })()" + "prompt": "## Phase: Frontend Implementation\n\nImplement the client-side / UI changes:\n- Components, pages, layouts\n- State management and API integration\n- Styling and responsive design\n- Component tests\n- Run build: {{buildCommand}}\n\nCommit frontend changes separately.", + "taskId": "{{taskId}}", + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "repoMapQuery": "{{taskTitle}} {{taskDescription}}", + "repoMapFileLimit": 8, + "executionRole": "editor", + "architectPlan": "{{$ctx.getNodeOutput('plan-architecture')?.summary || $ctx.getNodeOutput('plan-architecture')?.output || ''}}" }, "position": { "x": 400, - "y": 440 + "y": 500 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "classify-severity", - "type": "condition.switch", - "label": "Classify Severity", + "id": "integration-test", + "type": "action.run_agent", + "label": "Integration Test", "config": { - "value": "(() => { const out = $ctx.getNodeOutput('run-audit')?.output || '{}'; try { const d = JSON.parse(out); const v = d.metadata || {}; if ((v.vulnerabilities?.critical || 0) > 0) return 'critical'; if ((v.vulnerabilities?.high || 0) > 0) return 'high'; return 'moderate'; } catch { if (out.includes('critical')) return 'critical'; if (out.includes('high')) return 'high'; return 'moderate'; } })()", - "cases": { - "critical": "critical", - "high": "high", - "moderate": "moderate" - } + "prompt": "## Phase: Integration Testing\n\nVerify the full stack works end-to-end:\n1. Run the full test suite: {{testCommand}}\n2. Run the build: {{buildCommand}}\n3. Run lint: {{lintCommand}}\n4. Fix any integration issues between frontend and backend\n5. Ensure all tests pass before completing\n\nPush all changes and create/update the PR.", + "taskId": "{{taskId}}", + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "repoMapQuery": "{{taskTitle}} {{taskDescription}}", + "repoMapFileLimit": 8, + "executionRole": "editor", + "architectPlan": "{{$ctx.getNodeOutput('plan-architecture')?.summary || $ctx.getNodeOutput('plan-architecture')?.output || ''}}" }, "position": { - "x": 200, - "y": 590 + "x": 400, + "y": 660 }, "outputs": [ - "critical", - "high", - "moderate", "default" ] }, { - "id": "auto-fix-enabled", - "type": "condition.expression", - "label": "Auto Fix Enabled?", + "id": "done", + "type": "notify.log", + "label": "Complete", "config": { - "expression": "Boolean($data?.autoFixEnabled !== false)" + "message": "Fullstack task completed — all layers implemented and tested." }, "position": { - "x": 50, - "y": 670 + "x": 400, + "y": 820 }, "outputs": [ - "yes", - "no" + "default" ] + } + ], + "edges": [ + { + "id": "trigger->plan-architecture", + "source": "trigger", + "target": "plan-architecture", + "sourcePort": "default" }, { - "id": "auto-fix", - "type": "action.run_agent", - "label": "Auto-Fix Vulnerabilities", - "config": { - "prompt": "# Dependency Vulnerability Fix\n\nRun `npm audit fix` to resolve automatically fixable vulnerabilities.\nIf some vulnerabilities require breaking changes:\n1. Review the changelog for each affected package\n2. Only apply `npm audit fix --force` for packages where the breaking change is safe\n3. Run `npm test` after each fix to verify nothing breaks\n4. Create one commit per fixed package group\n\nDo NOT blindly force-fix everything. Test after each change.\nLimit auto-generated fix PRs to {{maxAutoFixPRs}} in this run.", - "sdk": "auto", - "timeoutMs": 1800000 - }, - "position": { - "x": 50, - "y": 750 - }, - "outputs": [ - "default" - ] + "id": "plan-architecture->implement-backend", + "source": "plan-architecture", + "target": "implement-backend", + "sourcePort": "default" }, { - "id": "create-fix-pr", - "type": "action.create_pr", - "label": "Handoff Fix Lifecycle", - "config": { - "title": "fix(deps): resolve {{auditLevel}}+ vulnerabilities", - "body": "Automated dependency audit fix. Resolves vulnerabilities flagged by `npm audit`.\n\nBosun PR lifecycle handoff context included.", - "branch": "fix/dep-audit-{{_runId}}", - "baseBranch": "main" - }, - "position": { - "x": 50, - "y": 900 - }, - "outputs": [ - "default" - ] - }, - { - "id": "alert-critical", - "type": "notify.telegram", - "label": "Alert: Critical Vuln", - "config": { - "message": ":alert: **CRITICAL vulnerability** found in dependencies!\n\nRun `npm audit` for details. Manual review required." - }, - "position": { - "x": 350, - "y": 750 - }, - "outputs": [ - "default" - ] - }, - { - "id": "alert-high", - "type": "notify.telegram", - "label": "Alert: High Severity", - "config": { - "message": ":alert: **High severity** dependency vulnerability detected.\n\nAuto-fix changes prepared and handed off to Bosun PR lifecycle management. Please review and merge when ready.", - "silent": true - }, - "position": { - "x": 550, - "y": 750 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-clean", - "type": "notify.log", - "label": "No Vulnerabilities", - "config": { - "message": "Dependency audit clean — no vulnerabilities found", - "level": "info" - }, - "position": { - "x": 650, - "y": 440 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-done", - "type": "notify.log", - "label": "Audit Complete", - "config": { - "message": "Dependency audit complete — fixes applied where possible", - "level": "info" - }, - "position": { - "x": 300, - "y": 1050 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->run-audit", - "source": "trigger", - "target": "run-audit", - "sourcePort": "default" - }, - { - "id": "run-audit->parse-results", - "source": "run-audit", - "target": "parse-results", - "sourcePort": "default" - }, - { - "id": "parse-results->has-vulns", - "source": "parse-results", - "target": "has-vulns", - "sourcePort": "default" - }, - { - "id": "has-vulns->classify-severity", - "source": "has-vulns", - "target": "classify-severity", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "has-vulns->log-clean", - "source": "has-vulns", - "target": "log-clean", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "classify-severity->alert-critical", - "source": "classify-severity", - "target": "alert-critical", - "sourcePort": "critical" - }, - { - "id": "classify-severity->auto-fix-enabled", - "source": "classify-severity", - "target": "auto-fix-enabled", - "sourcePort": "high" - }, - { - "id": "classify-severity->auto-fix-enabled", - "source": "classify-severity", - "target": "auto-fix-enabled", - "sourcePort": "moderate" - }, - { - "id": "alert-critical->auto-fix-enabled", - "source": "alert-critical", - "target": "auto-fix-enabled", - "sourcePort": "default" - }, - { - "id": "auto-fix-enabled->auto-fix", - "source": "auto-fix-enabled", - "target": "auto-fix", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "auto-fix-enabled->log-done", - "source": "auto-fix-enabled", - "target": "log-done", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "auto-fix->create-fix-pr", - "source": "auto-fix", - "target": "create-fix-pr", + "id": "implement-backend->implement-frontend", + "source": "implement-backend", + "target": "implement-frontend", "sourcePort": "default" }, { - "id": "create-fix-pr->alert-high", - "source": "create-fix-pr", - "target": "alert-high", + "id": "implement-frontend->integration-test", + "source": "implement-frontend", + "target": "integration-test", "sourcePort": "default" }, { - "id": "alert-high->log-done", - "source": "alert-high", - "target": "log-done", + "id": "integration-test->done", + "source": "integration-test", + "target": "done", "sourcePort": "default" } ] }, { - "id": "template-secret-scanner", - "name": "Secret Scanner", - "description": "Scans the repository for accidentally committed secrets, API keys, tokens, and credentials. Alerts immediately on detection and can auto-rotate exposed secrets via an agent.", - "category": "security", - "categoryLabel": "Security", - "categoryIcon": ":lock:", - "categoryOrder": 7, + "id": "template-git-health-pipeline", + "name": "Git Health Pipeline", + "description": "Automated git health check pipeline. Uses Bosun functions for git status and branch info, runs the git-hot-files tool to identify churn hotspots, and dispatches a cleanup workflow if issues are found. Full Bosun-native orchestration pattern.", + "category": "mcp-integration", + "categoryLabel": "Mcp Integration", + "categoryIcon": ":settings:", + "categoryOrder": 99, "tags": [ - "security", - "secrets", - "scanner", - "credentials", - "rotation" + "git", + "health", + "churn", + "tools", + "sub-workflow", + "automation" ], - "nodeCount": 9, - "edgeCount": 8, + "nodeCount": 8, + "edgeCount": 7, "recommended": false, - "enabled": false, + "enabled": true, "trigger": "trigger.schedule", "variables": { - "scanPatterns": "PRIVATE_KEY|SECRET|TOKEN|PASSWORD|API_KEY|CREDENTIAL", - "excludePaths": "node_modules,.git,*.lock,*.min.js" + "cleanupWorkflow": "template-health-check", + "churnThreshold": "10" }, "metadata": { - "author": "bosun", - "version": 1, - "createdAt": "2025-02-25T00:00:00Z", - "templateVersion": "1.0.0", + "author": "virtengine", "tags": [ - "security", - "secrets", - "scanner", - "credentials", - "rotation" - ], - "replaces": { - "module": "preflight.mjs", - "functions": [ - "checkGitSecrets" - ], - "calledFrom": [ - "preflight.mjs:runAllChecks" - ], - "description": "Replaces manual secret scanning with an automated workflow. Regex scanning, AI-powered classification, and alerting become structured, scheduled workflow steps." - } + "git", + "health", + "churn", + "tools", + "sub-workflow", + "automation" + ] }, "nodes": [ { "id": "trigger", "type": "trigger.schedule", - "label": "Hourly Scan", + "label": "Scheduled", "config": { - "intervalMs": 3600000, - "cron": "0 * * * *" + "cron": "0 6 * * 1" }, "position": { - "x": 400, - "y": 50 + "x": 100, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "scan-repo", - "type": "action.run_command", - "label": "Scan for Secrets", + "id": "git-status", + "type": "action.bosun_function", + "label": "Git Status", "config": { - "command": "git log --diff-filter=A -p HEAD~5..HEAD -- . ':!node_modules' ':!*.lock' ':!*.min.js' | grep -iE '({{scanPatterns}})\\s*[:=]\\s*[\"\\x27][^\"\\x27]{8,}' || echo 'CLEAN'", - "continueOnError": true + "function": "git.status", + "outputVariable": "status" }, "position": { - "x": 400, - "y": 180 + "x": 380, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "has-secrets", - "type": "condition.expression", - "label": "Secrets Found?", - "config": { - "expression": "!($ctx.getNodeOutput('scan-repo')?.output || '').includes('CLEAN') && ($ctx.getNodeOutput('scan-repo')?.output || '').trim().length > 0" - }, - "position": { - "x": 400, - "y": 330 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "classify-secret", - "type": "action.run_agent", - "label": "Classify & Assess Risk", + "id": "git-branch", + "type": "action.bosun_function", + "label": "Branch Info", "config": { - "prompt": "# Secret Detection Analysis\n\nThe following content was flagged as potentially containing secrets:\n\n```\n{{scanOutput}}\n```\n\nAnalyze each finding and classify:\n1. **TRUE POSITIVE** — Real secret/credential that needs rotation\n2. **FALSE POSITIVE** — Not a real secret (example value, test data, etc.)\n\nFor each true positive:\n- Identify the type (API key, password, token, private key, etc.)\n- Assess the blast radius (what services could be compromised)\n- Recommend immediate action (rotate, revoke, etc.)\n\nRespond as JSON: { \"findings\": [{ \"type\": \"...\", \"severity\": \"critical|high|low\", \"truePositive\": true/false, \"recommendation\": \"...\" }] }", - "timeoutMs": 300000 + "function": "git.branch", + "outputVariable": "branches" }, "position": { - "x": 200, - "y": 490 + "x": 660, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "has-true-positive", - "type": "condition.expression", - "label": "Any True Positives?", + "id": "git-log", + "type": "action.bosun_function", + "label": "Recent Commits", "config": { - "expression": "($ctx.getNodeOutput('classify-secret')?.output || '').includes('\"truePositive\": true') || ($ctx.getNodeOutput('classify-secret')?.output || '').includes('\"truePositive\":true')" + "function": "git.log", + "args": { + "count": "20" + }, + "outputVariable": "recentCommits" }, "position": { - "x": 200, - "y": 650 + "x": 940, + "y": 100 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "alert-secret", - "type": "notify.telegram", - "label": "Alert: Secret Exposed!", + "id": "hot-files", + "type": "action.bosun_tool", + "label": "Churn Analysis", "config": { - "message": ":lock: **SECRET EXPOSED** in recent commits!\n\nThe secret scanner found credentials in the repository. Immediate rotation required.\n\nCheck agent output for classification details." + "toolId": "git-hot-files", + "args": [ + "--days", + "30", + "--top", + "20" + ], + "parseJson": true, + "extract": { + "fields": { + "hotFiles": "[*].file", + "maxChurn": "[0].commits" + }, + "defaults": { + "hotFiles": [], + "maxChurn": 0 + }, + "types": { + "maxChurn": "number" + } + }, + "outputVariable": "churnData" }, "position": { - "x": 100, - "y": 810 + "x": 1220, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "create-issue", - "type": "action.run_command", - "label": "Create Remediation Issue", + "id": "churn-check", + "type": "condition.expression", + "label": "High Churn?", "config": { - "command": "gh issue create --title 'security: exposed credential detected by scanner' --body 'The secret scanner detected a potentially exposed credential. See Bosun workflow run for details. Rotate affected keys immediately.' --label security", - "continueOnError": true + "expression": "{{hot-files.maxChurn}} > {{churnThreshold}}" }, "position": { - "x": 100, - "y": 960 + "x": 1500, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "log-false-positive", - "type": "notify.log", - "label": "Log False Positives", + "id": "dispatch-cleanup", + "type": "action.invoke_workflow", + "label": "Dispatch Cleanup", "config": { - "message": "Secret scanner flagged findings but all classified as false positives", - "level": "info" + "workflowId": "{{cleanupWorkflow}}", + "input": { + "hotFiles": "{{hot-files.hotFiles}}", + "maxChurn": "{{hot-files.maxChurn}}", + "currentBranch": "{{git-branch.current}}", + "changedFiles": "{{git-status.changedFiles}}" + }, + "mode": "sync", + "failOnError": false }, "position": { - "x": 450, - "y": 650 + "x": 1780, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "log-clean", + "id": "log-healthy", "type": "notify.log", - "label": "Repository Clean", + "label": "Healthy", "config": { - "message": "Secret scanner: no secrets found in recent commits (exclude paths: {{excludePaths}})", + "message": "Git health OK: branch={{git-branch.current}}, changed={{git-status.changedFiles}}, maxChurn={{hot-files.maxChurn}}", "level": "info" }, "position": { - "x": 650, - "y": 330 + "x": 2060, + "y": 100 }, "outputs": [ "default" @@ -17546,106 +16527,89 @@ ], "edges": [ { - "id": "trigger->scan-repo", + "id": "trigger->git-status", "source": "trigger", - "target": "scan-repo", + "target": "git-status", "sourcePort": "default" }, { - "id": "scan-repo->has-secrets", - "source": "scan-repo", - "target": "has-secrets", + "id": "git-status->git-branch", + "source": "git-status", + "target": "git-branch", "sourcePort": "default" }, { - "id": "has-secrets->classify-secret", - "source": "has-secrets", - "target": "classify-secret", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "has-secrets->log-clean", - "source": "has-secrets", - "target": "log-clean", - "sourcePort": "no", - "condition": "$output?.result !== true" + "id": "git-branch->git-log", + "source": "git-branch", + "target": "git-log", + "sourcePort": "default" }, { - "id": "classify-secret->has-true-positive", - "source": "classify-secret", - "target": "has-true-positive", + "id": "git-log->hot-files", + "source": "git-log", + "target": "hot-files", "sourcePort": "default" }, { - "id": "has-true-positive->alert-secret", - "source": "has-true-positive", - "target": "alert-secret", - "sourcePort": "yes", - "condition": "$output?.result === true" + "id": "hot-files->churn-check", + "source": "hot-files", + "target": "churn-check", + "sourcePort": "default" }, { - "id": "has-true-positive->log-false-positive", - "source": "has-true-positive", - "target": "log-false-positive", - "sourcePort": "no", - "condition": "$output?.result !== true" + "id": "churn-check->dispatch-cleanup", + "source": "churn-check", + "target": "dispatch-cleanup", + "sourcePort": "true" }, { - "id": "alert-secret->create-issue", - "source": "alert-secret", - "target": "create-issue", - "sourcePort": "default" + "id": "churn-check->log-healthy", + "source": "churn-check", + "target": "log-healthy", + "sourcePort": "false" } ] }, { - "id": "template-agent-execution-pipeline", - "name": "Agent Execution Pipeline", - "description": "Full agent execution lifecycle: resolves executor, builds prompt, continues/restarts session, handles rate limits, pushes branch, releases claim, dispatches finalization workflow. Exercises many rarely-used action nodes.", - "category": "coverage", - "categoryLabel": "Coverage", + "id": "template-inline-workflow-composition", + "name": "Inline Workflow Composition", + "description": "Compose a parent workflow from embedded child workflows using action.inline_workflow. Demonstrates bounded sequential stages that stay inside the parent workflow while preserving child run/context boundaries and structured output handoff.", + "category": "mcp-integration", + "categoryLabel": "Mcp Integration", "categoryIcon": ":settings:", "categoryOrder": 99, "tags": [ - "coverage", - "agent", - "pipeline" + "workflow", + "composition", + "inline", + "parent-workflow", + "embedded" ], - "nodeCount": 10, - "edgeCount": 9, + "nodeCount": 5, + "edgeCount": 4, "recommended": false, "enabled": true, - "trigger": "trigger.event", + "trigger": "trigger.manual", "variables": { - "taskId": "TASK-10", - "taskTitle": "Coverage test task", - "taskDescription": "Test task for coverage", - "branch": "feat/pipeline-test", - "baseBranch": "origin/main", - "worktreePath": "/tmp/wt-pipeline-test", - "sessionId": "session-coverage-1", - "finalizationWorkflow": "template-health-check" + "inputPayload": "{\"steps\":[\"lint\",\"test\",\"build\"],\"strict\":true}", + "defaultStageOwner": "bosun" }, "metadata": { "author": "virtengine", "tags": [ - "coverage", - "agent", - "pipeline" - ], - "requiredTemplates": [ - "template-health-check" + "workflow", + "composition", + "inline", + "parent-workflow", + "embedded" ] }, "nodes": [ { "id": "trigger", - "type": "trigger.event", - "label": "Event Trigger", - "config": { - "eventType": "task.assigned" - }, + "type": "trigger.manual", + "label": "Start", + "config": {}, "position": { "x": 100, "y": 100 @@ -17655,33 +16619,76 @@ ] }, { - "id": "resolve-executor", - "type": "action.resolve_executor", - "label": "Resolve Executor", - "config": { - "taskId": "{{taskId}}", - "continueOnError": true - }, - "position": { - "x": 380, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "build-prompt", - "type": "action.build_task_prompt", - "label": "Build Task Prompt", + "id": "inline-prepare", + "type": "action.inline_workflow", + "label": "Inline Prepare", "config": { - "taskId": "{{taskId}}", - "taskTitle": "{{taskTitle}}", - "taskDescription": "{{taskDescription}}", - "continueOnError": true + "mode": "sync", + "outputVariable": "inlinePrepareResult", + "input": { + "inputPayload": "{{inputPayload}}", + "defaultStageOwner": "{{defaultStageOwner}}" + }, + "workflow": { + "trigger": "trigger.workflow_call", + "nodes": [ + { + "id": "trigger", + "type": "trigger.workflow_call", + "label": "Inline Trigger", + "config": { + "inputs": { + "inputPayload": { + "type": "string", + "required": false + }, + "defaultStageOwner": { + "type": "string", + "required": false + } + } + } + }, + { + "id": "normalize-payload", + "type": "action.set_variable", + "label": "Normalize Payload", + "config": { + "key": "normalizedPayload", + "value": "(() => {const raw = $data?.inputPayload;if (raw && typeof raw === 'object') return raw;const text = String(raw || '').trim();if (!text) return { steps: [] };try { return JSON.parse(text); } catch { return { steps: [text] }; }})()", + "isExpression": true + } + }, + { + "id": "finish", + "type": "flow.end", + "label": "Finish Prepare", + "config": { + "status": "completed", + "output": { + "stageOwner": "{{defaultStageOwner}}", + "normalizedPayload": "{{$data?.normalizedPayload || { steps: [] }}}", + "stepCount": "{{$data?.normalizedPayload && Array.isArray($data.normalizedPayload.steps) ? $data.normalizedPayload.steps.length : 0}}" + } + } + } + ], + "edges": [ + { + "id": "e1", + "source": "trigger", + "target": "normalize-payload" + }, + { + "id": "e2", + "source": "normalize-payload", + "target": "finish" + } + ] + } }, "position": { - "x": 660, + "x": 380, "y": 100 }, "outputs": [ @@ -17689,18 +16696,75 @@ ] }, { - "id": "continue-session", - "type": "action.continue_session", - "label": "Continue Session", + "id": "inline-plan", + "type": "action.inline_workflow", + "label": "Inline Stage Plan", "config": { - "sessionId": "{{sessionId}}", - "prompt": "Continue executing task {{taskTitle}}", - "strategy": "continue", - "timeoutMs": 1000, - "continueOnError": true + "mode": "sync", + "outputVariable": "inlinePlanResult", + "input": { + "stageOwner": "{{$ctx.getNodeOutput('inline-prepare')?.stageOwner || $data?.defaultStageOwner || 'bosun'}}", + "normalizedPayload": "{{$ctx.getNodeOutput('inline-prepare')?.normalizedPayload || { steps: [] }}}" + }, + "workflow": { + "trigger": "trigger.workflow_call", + "nodes": [ + { + "id": "trigger", + "type": "trigger.workflow_call", + "label": "Inline Trigger", + "config": { + "inputs": { + "stageOwner": { + "type": "string", + "required": false + }, + "normalizedPayload": { + "type": "object", + "required": false + } + } + } + }, + { + "id": "build-plan", + "type": "action.set_variable", + "label": "Build Stage Plan", + "config": { + "key": "stagePlan", + "value": "(() => {const steps = Array.isArray($data?.normalizedPayload?.steps) ? $data.normalizedPayload.steps : [];return steps.map((step, index) => ({ index: index + 1, step: String(step || ''), owner: String($data?.stageOwner || 'bosun') }));})()", + "isExpression": true + } + }, + { + "id": "finish", + "type": "flow.end", + "label": "Finish Plan", + "config": { + "status": "completed", + "output": { + "stagePlan": "{{$data?.stagePlan || []}}", + "stageCount": "{{$data?.stagePlan?.length || 0}}" + } + } + } + ], + "edges": [ + { + "id": "e1", + "source": "trigger", + "target": "build-plan" + }, + { + "id": "e2", + "source": "build-plan", + "target": "finish" + } + ] + } }, "position": { - "x": 940, + "x": 660, "y": 100 }, "outputs": [ @@ -17708,15 +16772,72 @@ ] }, { - "id": "handle-rate-limit", - "type": "action.handle_rate_limit", - "label": "Handle Rate Limit", + "id": "inline-summarize", + "type": "action.inline_workflow", + "label": "Inline Summary", "config": { - "strategy": "skip", - "continueOnError": true + "mode": "sync", + "outputVariable": "inlineSummaryResult", + "input": { + "stagePlan": "{{$ctx.getNodeOutput('inline-plan')?.stagePlan || []}}", + "stepCount": "{{$ctx.getNodeOutput('inline-prepare')?.stepCount || 0}}" + }, + "workflow": { + "trigger": "trigger.workflow_call", + "nodes": [ + { + "id": "trigger", + "type": "trigger.workflow_call", + "label": "Inline Trigger", + "config": { + "inputs": { + "stagePlan": { + "type": "array", + "required": false + }, + "stepCount": { + "type": "number", + "required": false + } + } + } + }, + { + "id": "summarize", + "type": "action.set_variable", + "label": "Summarize Plan", + "config": { + "key": "summary", + "value": "(() => {const plan = Array.isArray($data?.stagePlan) ? $data.stagePlan : [];const labels = plan.map((entry) => String(entry.index) + ':' + String(entry.step || '')).join(', ');return { summaryMessage: 'Prepared ' + String(Number($data?.stepCount || 0)) + ' inline stage(s)' + (labels ? ' -> ' + labels : ''), plannedSteps: plan,};})()", + "isExpression": true + } + }, + { + "id": "finish", + "type": "flow.end", + "label": "Finish Summary", + "config": { + "status": "completed", + "output": "{{$data?.summary || { summaryMessage: 'Prepared 0 inline stage(s)', plannedSteps: [] }}}" + } + } + ], + "edges": [ + { + "id": "e1", + "source": "trigger", + "target": "summarize" + }, + { + "id": "e2", + "source": "summarize", + "target": "finish" + } + ] + } }, "position": { - "x": 1220, + "x": 940, "y": 100 }, "outputs": [ @@ -17724,51 +16845,89 @@ ] }, { - "id": "restart-agent", - "type": "action.restart_agent", - "label": "Restart Agent", + "id": "log-summary", + "type": "notify.log", + "label": "Log Inline Summary", "config": { - "agentId": "{{sessionId}}", - "continueOnError": true + "message": "{{inline-summarize.summaryMessage}}", + "level": "info" }, "position": { - "x": 1500, + "x": 1220, "y": 100 }, "outputs": [ "default" ] + } + ], + "edges": [ + { + "id": "trigger->inline-prepare", + "source": "trigger", + "target": "inline-prepare", + "sourcePort": "default" }, { - "id": "push-branch", - "type": "action.push_branch", - "label": "Push Branch", - "config": { - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "worktreePath": "{{worktreePath}}", - "rebaseBeforePush": false, - "emptyDiffGuard": false, - "continueOnError": true - }, - "position": { - "x": 1780, - "y": 100 - }, - "outputs": [ - "default" - ] + "id": "inline-prepare->inline-plan", + "source": "inline-prepare", + "target": "inline-plan", + "sourcePort": "default" }, { - "id": "release-claim", - "type": "action.release_claim", - "label": "Release Claim", - "config": { - "taskId": "{{taskId}}", - "continueOnError": true - }, + "id": "inline-plan->inline-summarize", + "source": "inline-plan", + "target": "inline-summarize", + "sourcePort": "default" + }, + { + "id": "inline-summarize->log-summary", + "source": "inline-summarize", + "target": "log-summary", + "sourcePort": "default" + } + ] + }, + { + "id": "template-mcp-cross-server-pipeline", + "name": "MCP Cross-Server Pipeline", + "description": "Execute a multi-step pipeline that chains tools across different MCP servers. For example: GitHub PRs → extract data → Context7 docs lookup → aggregate results. Demonstrates action.mcp_pipeline with inputMap piping.", + "category": "mcp-integration", + "categoryLabel": "Mcp Integration", + "categoryIcon": ":settings:", + "categoryOrder": 99, + "tags": [ + "mcp", + "pipeline", + "cross-server", + "data-flow" + ], + "nodeCount": 3, + "edgeCount": 2, + "recommended": false, + "enabled": true, + "trigger": "trigger.manual", + "variables": { + "githubOwner": "virtengine", + "githubRepo": "bosun" + }, + "metadata": { + "author": "virtengine", + "tags": [ + "mcp", + "pipeline", + "cross-server", + "data-flow" + ] + }, + "nodes": [ + { + "id": "trigger", + "type": "trigger.manual", + "label": "Start Pipeline", + "config": {}, "position": { - "x": 2060, + "x": 100, "y": 100 }, "outputs": [ @@ -17776,16 +16935,65 @@ ] }, { - "id": "dispatch-finalize", - "type": "flow.universal", - "label": "Dispatch Finalization", + "id": "pipeline", + "type": "action.mcp_pipeline", + "label": "MCP Pipeline", "config": { - "workflowId": "{{finalizationWorkflow}}", - "mode": "dispatch", - "continueOnError": true + "outputVariable": "pipelineResult", + "steps": [ + { + "id": "get-prs", + "server": "github", + "tool": "list_pull_requests", + "input": { + "owner": "{{githubOwner}}", + "repo": "{{githubRepo}}", + "state": "open" + }, + "extract": { + "fields": { + "prCount": "length", + "firstPrTitle": "[0].title", + "firstPrBody": "[0].body" + }, + "types": { + "prCount": "number" + } + }, + "continueOnError": true + }, + { + "id": "lookup-docs", + "server": "context7", + "tool": "resolve-library-id", + "inputMap": { + "libraryName": { + "_literal": "express" + } + }, + "continueOnError": true + }, + { + "id": "search-web", + "server": "exa", + "tool": "web_search_exa", + "inputMap": { + "query": { + "_template": "{{githubRepo}} open pull requests best practices" + } + }, + "extract": { + "fields": { + "resultCount": "results.length", + "topResult": "results[0].title" + } + }, + "continueOnError": true + } + ] }, "position": { - "x": 2340, + "x": 380, "y": 100 }, "outputs": [ @@ -17793,15 +17001,15 @@ ] }, { - "id": "log-done", + "id": "report", "type": "notify.log", - "label": "Log Dispatched", + "label": "Pipeline Report", "config": { - "message": "Pipeline complete for task {{taskId}}", + "message": "Pipeline complete: {{pipeline.completedSteps}}/{{pipeline.stepCount}} steps succeeded. Final output type: {{pipeline.finalOutput.contentType}}", "level": "info" }, "position": { - "x": 2620, + "x": 660, "y": 100 }, "outputs": [ @@ -17811,214 +17019,161 @@ ], "edges": [ { - "id": "trigger->resolve-executor", + "id": "trigger->pipeline", "source": "trigger", - "target": "resolve-executor", - "sourcePort": "default" - }, - { - "id": "resolve-executor->build-prompt", - "source": "resolve-executor", - "target": "build-prompt", - "sourcePort": "default" - }, - { - "id": "build-prompt->continue-session", - "source": "build-prompt", - "target": "continue-session", - "sourcePort": "default" - }, - { - "id": "continue-session->handle-rate-limit", - "source": "continue-session", - "target": "handle-rate-limit", - "sourcePort": "default" - }, - { - "id": "handle-rate-limit->restart-agent", - "source": "handle-rate-limit", - "target": "restart-agent", - "sourcePort": "default" - }, - { - "id": "restart-agent->push-branch", - "source": "restart-agent", - "target": "push-branch", - "sourcePort": "default" - }, - { - "id": "push-branch->release-claim", - "source": "push-branch", - "target": "release-claim", - "sourcePort": "default" - }, - { - "id": "release-claim->dispatch-finalize", - "source": "release-claim", - "target": "dispatch-finalize", + "target": "pipeline", "sourcePort": "default" }, { - "id": "dispatch-finalize->log-done", - "source": "dispatch-finalize", - "target": "log-done", + "id": "pipeline->report", + "source": "pipeline", + "target": "report", "sourcePort": "default" } ] }, { - "id": "template-task-backend", - "name": "Backend Task Workflow", - "description": "Specialised for server-side tasks — APIs, databases, services, middleware. Runs three phases: plan, implement with TDD, and verify with full test suite.", - "category": "task-execution", - "categoryLabel": "Task Execution", + "id": "template-mcp-github-pr-monitor", + "name": "MCP GitHub PR Monitor", + "description": "Periodically fetches open PRs from GitHub via MCP, extracts PR metadata (titles, authors, labels, review status), routes based on PR count, and sends notifications. Demonstrates MCP → extract → condition → notify.", + "category": "mcp-integration", + "categoryLabel": "Mcp Integration", "categoryIcon": ":settings:", "categoryOrder": 99, "tags": [ - "backend", - "api", - "server", - "task-type" + "mcp", + "github", + "monitoring", + "pr" ], "nodeCount": 5, "edgeCount": 4, - "recommended": true, + "recommended": false, "enabled": true, - "trigger": "trigger.task_assigned", + "trigger": "trigger.schedule", "variables": { - "taskTimeoutMs": 21600000, - "maxRetries": 2, - "maxContinues": 3, - "testCommand": "auto", - "buildCommand": "auto", - "lintCommand": "auto" + "owner": "virtengine", + "repo": "bosun", + "checkInterval": "*/30 * * * *", + "prThreshold": 5 }, "metadata": { - "author": "bosun", - "version": 1, - "createdAt": "2025-06-01T00:00:00Z", - "templateVersion": "1.0.0", + "author": "virtengine", "tags": [ - "backend", - "api", - "server", - "task-type" - ], - "resolveMode": "library" + "mcp", + "github", + "monitoring", + "pr" + ] }, "nodes": [ { "id": "trigger", - "type": "trigger.task_assigned", - "label": "Task Assigned", + "type": "trigger.schedule", + "label": "Check PRs", "config": { - "taskPattern": "api|server|backend|database|model|migration|endpoint|middleware|service|graphql|rest|grpc" + "schedule": "{{checkInterval}}" }, "position": { - "x": 400, - "y": 50 + "x": 100, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "plan", - "type": "action.run_agent", - "label": "Plan Backend", + "id": "fetch-prs", + "type": "action.mcp_tool_call", + "label": "Fetch Open PRs", "config": { - "prompt": "## Phase: Backend Planning\n\nAnalyse the task and produce a plan:\n1. Data model / schema changes\n2. API endpoint design (routes, request/response shapes)\n3. Service layer logic\n4. Database queries or migrations\n5. Test plan (unit + integration)\n\nDo NOT write code yet.", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "repoMapQuery": "{{taskTitle}} {{taskDescription}}", - "repoMapFileLimit": 8, - "mode": "plan", - "executionRole": "architect" + "server": "github", + "tool": "list_pull_requests", + "input": { + "owner": "{{owner}}", + "repo": "{{repo}}", + "state": "open" + }, + "outputVariable": "prData", + "extract": { + "fields": { + "prCount": "length", + "prTitles": "[*].title", + "prAuthors": "[*].user.login", + "prNumbers": "[*].number", + "oldestPr": "[0].created_at", + "newestPr": "[-1].created_at" + }, + "defaults": { + "prCount": 0, + "prTitles": [], + "prAuthors": [] + }, + "types": { + "prCount": "number", + "prTitles": "array", + "prAuthors": "array", + "prNumbers": "array" + } + }, + "portConfig": { + "field": "prCount", + "map": { + "0": "none" + }, + "default": "has_prs" + } }, "position": { - "x": 400, - "y": 180 + "x": 380, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "implement-tdd", - "type": "action.run_agent", - "label": "Implement (TDD)", + "id": "check-threshold", + "type": "condition.expression", + "label": "Too Many PRs?", "config": { - "prompt": "## Phase: Test-Driven Implementation\n\n1. Write tests FIRST for the planned changes\n2. Verify tests fail (red)\n3. Implement the backend logic to make tests pass (green)\n4. Refactor for clarity and performance\n5. Run full test suite: {{testCommand}}\n6. Run build: {{buildCommand}}\n7. Run lint: {{lintCommand}}\n\nCommit with descriptive messages.", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "repoMapQuery": "{{taskTitle}} {{taskDescription}}", - "repoMapFileLimit": 8, - "executionRole": "editor", - "architectPlan": "{{$ctx.getNodeOutput('plan')?.summary || $ctx.getNodeOutput('plan')?.output || ''}}" + "expression": "$output.prCount >= $data.prThreshold" }, "position": { - "x": 400, - "y": 340 + "x": 660, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "verify", - "type": "action.run_agent", - "label": "Verify & PR", + "id": "log-normal", + "type": "notify.log", + "label": "PR Count Normal", "config": { - "prompt": "## Phase: Verification\n\n1. Run the complete test suite: {{testCommand}}\n2. Run build: {{buildCommand}}\n3. Ensure no regressions\n4. Push changes and create/update PR\n5. Include test results summary in PR description", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "repoMapQuery": "{{taskTitle}} {{taskDescription}}", - "repoMapFileLimit": 8, - "executionRole": "editor", - "architectPlan": "{{$ctx.getNodeOutput('plan')?.summary || $ctx.getNodeOutput('plan')?.output || ''}}" + "message": "{{fetch-prs.prCount}} open PRs — within threshold", + "level": "info" }, "position": { - "x": 400, - "y": 500 + "x": 940, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "done", + "id": "alert-high", "type": "notify.log", - "label": "Complete", + "label": "PR Count High", "config": { - "message": "Backend task completed — API/service implemented and tested." + "message": "⚠️ {{fetch-prs.prCount}} open PRs (threshold: {{prThreshold}}). Authors: {{fetch-prs.prAuthors}}. Oldest: {{fetch-prs.oldestPr}}", + "level": "warn" }, "position": { - "x": 400, - "y": 660 + "x": 1220, + "y": 100 }, "outputs": [ "default" @@ -18027,68 +17182,69 @@ ], "edges": [ { - "id": "trigger->plan", + "id": "trigger->fetch-prs", "source": "trigger", - "target": "plan", + "target": "fetch-prs", "sourcePort": "default" }, { - "id": "plan->implement-tdd", - "source": "plan", - "target": "implement-tdd", + "id": "fetch-prs->check-threshold", + "source": "fetch-prs", + "target": "check-threshold", "sourcePort": "default" }, { - "id": "implement-tdd->verify", - "source": "implement-tdd", - "target": "verify", - "sourcePort": "default" + "id": "check-threshold->log-normal", + "source": "check-threshold", + "target": "log-normal", + "sourcePort": "false" }, { - "id": "verify->done", - "source": "verify", - "target": "done", - "sourcePort": "default" + "id": "check-threshold->alert-high", + "source": "check-threshold", + "target": "alert-high", + "sourcePort": "true" } ] }, { - "id": "template-bosun-tool-pipeline", - "name": "Bosun Tool Pipeline", - "description": "Run Bosun built-in or custom tools from a workflow with structured output piping. Discovers available tools, invokes a selected tool, extracts specific data fields, and forwards them to downstream nodes. Combines action.bosun_function and action.bosun_tool for full tool integration.", + "id": "template-mcp-iterative-research", + "name": "MCP Iterative Research", + "description": "Accepts a list of topics, iterates over them, calls an MCP tool for each, extracts structured results, and aggregates everything. Shows how to combine loop.for_each with MCP tool calls for batch processing.", "category": "mcp-integration", "categoryLabel": "Mcp Integration", "categoryIcon": ":settings:", "categoryOrder": 99, "tags": [ - "bosun", - "tools", - "pipeline", - "structured-output" + "mcp", + "research", + "iteration", + "batch" ], - "nodeCount": 7, - "edgeCount": 6, + "nodeCount": 6, + "edgeCount": 5, "recommended": false, "enabled": true, - "trigger": "trigger.manual", + "trigger": "trigger.workflow_call", "variables": { - "targetTool": "list-todos", - "toolArgs": "" + "topics": "[\"node.js best practices\", \"typescript generics\", \"vitest testing\"]", + "mcpServer": "context7", + "mcpTool": "resolve-library-id" }, "metadata": { "author": "virtengine", "tags": [ - "bosun", - "tools", - "pipeline", - "structured-output" + "mcp", + "research", + "iteration", + "batch" ] }, "nodes": [ { "id": "trigger", - "type": "trigger.manual", - "label": "Start", + "type": "trigger.workflow_call", + "label": "Research Request", "config": {}, "position": { "x": 100, @@ -18099,12 +17255,11 @@ ] }, { - "id": "list-tools", - "type": "action.bosun_function", - "label": "List Available Tools", + "id": "parse-topics", + "type": "transform.json_parse", + "label": "Parse Topics", "config": { - "function": "tools.list", - "outputVariable": "availableTools" + "value": "{{topics}}" }, "position": { "x": 380, @@ -18115,15 +17270,13 @@ ] }, { - "id": "get-tool-info", - "type": "action.bosun_function", - "label": "Get Tool Info", + "id": "loop", + "type": "loop.for_each", + "label": "For Each Topic", "config": { - "function": "tools.get", - "args": { - "toolId": "{{targetTool}}" - }, - "outputVariable": "toolInfo" + "items": "$data.parse_topics?.data || []", + "variable": "topic", + "maxIterations": 20 }, "position": { "x": 660, @@ -18134,49 +17287,26 @@ ] }, { - "id": "tool-exists", - "type": "condition.expression", - "label": "Tool Exists?", - "config": { - "expression": "{{get-tool-info.found}}", - "trueLabel": "Found", - "falseLabel": "Not Found" - }, - "position": { - "x": 940, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "run-tool", - "type": "action.bosun_tool", - "label": "Run Tool", + "id": "research", + "type": "action.mcp_tool_call", + "label": "Research Topic", "config": { - "toolId": "{{targetTool}}", - "args": [ - "{{toolArgs}}" - ], - "parseJson": true, + "server": "{{mcpServer}}", + "tool": "{{mcpTool}}", + "input": { + "libraryName": "{{topic}}" + }, "extract": { "fields": { - "itemCount": "length", - "items": "[*]" - }, - "defaults": { - "itemCount": 0, - "items": [] - }, - "types": { - "itemCount": "number" + "libraryId": "id", + "libraryName": "name", + "description": "description" } }, - "outputVariable": "toolOutput" + "continueOnError": true }, "position": { - "x": 1220, + "x": 940, "y": 100 }, "outputs": [ @@ -18184,15 +17314,16 @@ ] }, { - "id": "log-results", - "type": "notify.log", - "label": "Log Results", + "id": "aggregate", + "type": "transform.aggregate", + "label": "Aggregate Results", "config": { - "message": "Tool Pipeline: Found {{list-tools.data.length}} tools. Ran '{{targetTool}}': {{run-tool.itemCount}} results (exit {{run-tool.exitCode}})", - "level": "info" + "sources": [ + "research" + ] }, "position": { - "x": 1500, + "x": 1220, "y": 100 }, "outputs": [ @@ -18200,15 +17331,15 @@ ] }, { - "id": "log-not-found", + "id": "report", "type": "notify.log", - "label": "Tool Not Found", + "label": "Research Complete", "config": { - "message": "Tool '{{targetTool}}' not found. Available tools: {{list-tools.data.length}}", - "level": "warn" + "message": "Research pipeline completed. Topics processed: {{parse-topics.data.length}}", + "level": "info" }, "position": { - "x": 1780, + "x": 1500, "y": 100 }, "outputs": [ @@ -18218,185 +17349,112 @@ ], "edges": [ { - "id": "trigger->list-tools", + "id": "trigger->parse-topics", "source": "trigger", - "target": "list-tools", + "target": "parse-topics", "sourcePort": "default" }, { - "id": "list-tools->get-tool-info", - "source": "list-tools", - "target": "get-tool-info", + "id": "parse-topics->loop", + "source": "parse-topics", + "target": "loop", "sourcePort": "default" }, { - "id": "get-tool-info->tool-exists", - "source": "get-tool-info", - "target": "tool-exists", + "id": "loop->research", + "source": "loop", + "target": "research", "sourcePort": "default" }, { - "id": "tool-exists->run-tool", - "source": "tool-exists", - "target": "run-tool", - "sourcePort": "true" - }, - { - "id": "tool-exists->log-not-found", - "source": "tool-exists", - "target": "log-not-found", - "sourcePort": "false" + "id": "research->aggregate", + "source": "research", + "target": "aggregate", + "sourcePort": "default" }, { - "id": "run-tool->log-results", - "source": "run-tool", - "target": "log-results", + "id": "aggregate->report", + "source": "aggregate", + "target": "report", "sourcePort": "default" } ] }, { - "id": "template-task-cicd", - "name": "CI/CD Task Workflow", - "description": "For pipeline, deployment, infrastructure, and build-system tasks. Plans the change, implements with validation steps, then verifies the pipeline works end-to-end.", - "category": "task-execution", - "categoryLabel": "Task Execution", + "id": "template-mcp-research-probe", + "name": "MCP Research Probe", + "description": "Called by another workflow to ask for user confirmation and open a PR with findings. Exercises workflow_call trigger, ask_user, create_pr, flow.end.", + "category": "coverage", + "categoryLabel": "Coverage", "categoryIcon": ":settings:", "categoryOrder": 99, "tags": [ - "ci", - "cd", - "pipeline", - "deploy", - "infrastructure", - "task-type" + "coverage", + "mcp", + "research" ], - "nodeCount": 5, - "edgeCount": 4, - "recommended": true, + "nodeCount": 4, + "edgeCount": 3, + "recommended": false, "enabled": true, - "trigger": "trigger.task_assigned", + "trigger": "trigger.workflow_call", "variables": { - "taskTimeoutMs": 21600000, - "maxRetries": 2, - "maxContinues": 3, - "testCommand": "auto", - "buildCommand": "auto", - "lintCommand": "auto" + "query": "express.js middleware", + "prBranch": "research/mcp-test", + "prBaseBranch": "main" }, "metadata": { - "author": "bosun", - "version": 1, - "createdAt": "2025-06-01T00:00:00Z", - "templateVersion": "1.0.0", + "author": "virtengine", "tags": [ - "ci", - "cd", - "pipeline", - "deploy", - "infrastructure", - "task-type" - ], - "resolveMode": "library" + "coverage", + "mcp", + "research" + ] }, "nodes": [ { "id": "trigger", - "type": "trigger.task_assigned", - "label": "Task Assigned", - "config": { - "taskPattern": "ci|cd|pipeline|deploy|infrastructure|docker|kubernetes|k8s|terraform|github.action|build.system|release|devops" - }, - "position": { - "x": 400, - "y": 50 - }, - "outputs": [ - "default" - ] - }, - { - "id": "plan-pipeline", - "type": "action.run_agent", - "label": "Plan Pipeline Change", - "config": { - "prompt": "## Phase: CI/CD Planning\n\nAnalyse the pipeline/infrastructure task:\n1. Current CI/CD configuration\n2. What needs to change and why\n3. Impact on existing workflows/pipelines\n4. Rollback strategy\n5. Test plan for verifying the change\n\nDo NOT make changes yet.", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "repoMapQuery": "{{taskTitle}} {{taskDescription}}", - "repoMapFileLimit": 8, - "mode": "plan", - "executionRole": "architect" - }, + "type": "trigger.workflow_call", + "label": "Workflow Call Trigger", + "config": {}, "position": { - "x": 400, - "y": 180 + "x": 100, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "implement-pipeline", - "type": "action.run_agent", - "label": "Implement Pipeline", + "id": "ask-user", + "type": "action.ask_user", + "label": "Ask User for Confirmation", "config": { - "prompt": "## Phase: Pipeline Implementation\n\n1. Make the CI/CD / infrastructure changes per the plan\n2. Update configuration files (workflows, Dockerfiles, Terraform, etc.)\n3. Add or update pipeline tests where applicable\n4. Run build: {{buildCommand}}\n5. Run lint: {{lintCommand}}\n6. Validate configuration syntax\n\nCommit changes with clear descriptions.", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "repoMapQuery": "{{taskTitle}} {{taskDescription}}", - "repoMapFileLimit": 8, - "executionRole": "editor", - "architectPlan": "{{$ctx.getNodeOutput('plan-pipeline')?.summary || $ctx.getNodeOutput('plan-pipeline')?.output || ''}}" + "question": "Research complete. Proceed with PR?", + "outputVariable": "userConfirmation", + "continueOnError": true }, "position": { - "x": 400, - "y": 340 + "x": 380, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "verify-pipeline", - "type": "action.run_agent", - "label": "Verify & PR", + "id": "create-pr", + "type": "action.create_pr", + "label": "Create Research PR", "config": { - "prompt": "## Phase: Pipeline Verification\n\n1. Run full test suite: {{testCommand}}\n2. Run build: {{buildCommand}}\n3. Verify pipeline configuration is valid\n4. Push and create/update PR\n5. Include deployment / rollback instructions in PR description", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "repoMapQuery": "{{taskTitle}} {{taskDescription}}", - "repoMapFileLimit": 8, - "executionRole": "editor", - "architectPlan": "{{$ctx.getNodeOutput('plan-pipeline')?.summary || $ctx.getNodeOutput('plan-pipeline')?.output || ''}}" + "title": "research: {{query}}", + "branch": "{{prBranch}}", + "baseBranch": "{{prBaseBranch}}", + "continueOnError": true }, "position": { - "x": 400, - "y": 500 + "x": 660, + "y": 100 }, "outputs": [ "default" @@ -18404,14 +17462,12 @@ }, { "id": "done", - "type": "notify.log", - "label": "Complete", - "config": { - "message": "CI/CD task completed — pipeline updated and verified." - }, + "type": "flow.end", + "label": "End", + "config": {}, "position": { - "x": 400, - "y": 660 + "x": 940, + "y": 100 }, "outputs": [ "default" @@ -18420,272 +17476,367 @@ ], "edges": [ { - "id": "trigger->plan-pipeline", + "id": "trigger->ask-user", "source": "trigger", - "target": "plan-pipeline", - "sourcePort": "default" - }, - { - "id": "plan-pipeline->implement-pipeline", - "source": "plan-pipeline", - "target": "implement-pipeline", + "target": "ask-user", "sourcePort": "default" }, { - "id": "implement-pipeline->verify-pipeline", - "source": "implement-pipeline", - "target": "verify-pipeline", + "id": "ask-user->create-pr", + "source": "ask-user", + "target": "create-pr", "sourcePort": "default" }, { - "id": "verify-pipeline->done", - "source": "verify-pipeline", + "id": "create-pr->done", + "source": "create-pr", "target": "done", "sourcePort": "default" } ] }, { - "id": "template-code-quality-striker", - "name": "Code Quality Striker", - "description": "Recurring autonomous refactoring agent that improves codebase structure for long-term agentic development. Runs every 2 hours with a hard 90-minute session cap. Each session MUST produce a passing PR before terminating. Scope is strictly limited to structural quality: module decomposition, deduplication, function splitting. Zero functional changes allowed.", - "category": "maintenance", - "categoryLabel": "Maintenance", + "id": "template-mcp-tool-chain", + "name": "MCP Tool Chain", + "description": "Chain MCP tools together with structured data extraction. Discovers available tools on a server, calls a selected tool, extracts specific data fields from the output, and forwards them to downstream nodes. Demonstrates the full MCP-to-workflow data piping pattern.", + "category": "mcp-integration", + "categoryLabel": "Mcp Integration", "categoryIcon": ":settings:", "categoryOrder": 99, "tags": [ - "refactor", - "code-quality", - "maintenance", - "scheduled", - "agentic" + "mcp", + "integration", + "pipeline", + "data-extraction" ], - "nodeCount": 12, - "edgeCount": 12, - "recommended": true, + "nodeCount": 5, + "edgeCount": 4, + "recommended": false, "enabled": true, - "trigger": "trigger.schedule", + "trigger": "trigger.manual", "variables": { - "sessionTimeoutMs": 5400000, - "branch": "chore/code-quality-striker", - "baseBranch": "main", - "sessionLogPath": ".bosun-monitor/code-quality-striker.md", - "maxFilesPerSession": 6, - "minFileSizeKb": 30, - "testCommand": "npm test", - "buildCommand": "npm run build", - "syntaxCheckCommand": "node --check", - "lintCommand": "", - "sourceExtensions": ".mjs,.js,.ts,.tsx,.py,.go,.rs,.java,.cs,.rb,.php" + "mcpServer": "github", + "toolName": "list_pull_requests", + "toolInput": "{}" }, "metadata": { - "author": "bosun", - "version": 1, - "createdAt": "2026-03-09T00:00:00Z", - "templateVersion": "1.0.0", + "author": "virtengine", "tags": [ - "refactor", - "code-quality", - "maintenance", - "scheduled", - "agentic" - ], - "sessionLog": ".bosun-monitor/code-quality-striker.md" + "mcp", + "integration", + "pipeline", + "data-extraction" + ] }, "nodes": [ { "id": "trigger", - "type": "trigger.schedule", - "label": "Every 2 Hours", - "config": { - "intervalMs": 7200000, - "cron": "0 */2 * * *" - }, + "type": "trigger.manual", + "label": "Start", + "config": {}, "position": { - "x": 400, - "y": 50 + "x": 100, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "check-active-pr", - "type": "condition.expression", - "label": "Active Striker PR?", + "id": "discover-tools", + "type": "action.mcp_list_tools", + "label": "Discover MCP Tools", "config": { - "expression": "(() => { try { const r = $ctx.runCommand('git branch -r'); return (r?.output || '').includes('code-quality-striker'); } catch { return false; } })()" + "server": "{{mcpServer}}", + "outputVariable": "availableTools", + "includeSchemas": true }, "position": { - "x": 400, - "y": 180 + "x": 380, + "y": 100 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "skip-already-running", - "type": "notify.log", - "label": "Skip — PR Already Open", + "id": "call-tool", + "type": "action.mcp_tool_call", + "label": "Call MCP Tool", "config": { - "message": "Code quality striker skipped: an open quality striker PR already exists. Will retry next cycle.", - "level": "info" + "server": "{{mcpServer}}", + "tool": "{{toolName}}", + "input": "{{toolInput}}", + "outputVariable": "toolResult", + "extract": { + "fields": { + "itemCount": "length", + "firstItem": "[0]", + "allTitles": "[*].title" + }, + "defaults": { + "itemCount": 0, + "firstItem": null, + "allTitles": [] + }, + "types": { + "itemCount": "number", + "allTitles": "array" + } + } }, "position": { - "x": 650, - "y": 310 + "x": 660, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "scan-candidates", - "type": "action.run_command", - "label": "Scan Large Files", + "id": "extract-data", + "type": "transform.mcp_extract", + "label": "Extract Data Points", "config": { - "command": "node -e \"const{readdirSync,statSync}=require('fs');const{join,relative}=require('path');const base=process.cwd();const exts=new Set('{{sourceExtensions}}'.split(',').map(e=>e.trim()));function walk(d){const out=[];for(const f of readdirSync(d,{withFileTypes:true})){if(f.name==='node_modules'||f.name==='.cache'||f.name==='.git'||f.name==='worktrees'||f.name==='__pycache__'||f.name==='.venv'||f.name==='target'||f.name==='vendor'||f.name==='dist'||f.name==='build')continue;const p=join(d,f.name);if(f.isDirectory())out.push(...walk(p));else{const ext='.'+f.name.split('.').pop();if(exts.has(ext)){const s=statSync(p);out.push({p,kb:Math.round(s.size/1024)})}}}return out}const files=walk(base).filter(x=>x.kb>={{minFileSizeKb}}).sort((a,b)=>b.kb-a.kb).slice(0,20);console.log(files.map(x=>x.kb+'kb\\t'+relative(base,x.p)).join('\\n'))\"", - "continueOnError": true + "source": "call-tool", + "sourceField": "data", + "fields": { + "totalItems": "length", + "summary": "[0].title" + }, + "defaults": { + "totalItems": 0, + "summary": "No items found" + }, + "types": { + "totalItems": "number", + "summary": "string" + } }, "position": { - "x": 400, - "y": 310 + "x": 940, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "run-striker", - "type": "action.run_agent", - "label": "Code Quality Striker Agent", + "id": "log-results", + "type": "notify.log", + "label": "Log Results", "config": { - "timeoutMs": "{{sessionTimeoutMs}}", - "sdk": "auto", - "prompt": "# Code Quality Striker\n\nYou are a **structural quality agent**. Your sole mandate is to improve the\ninternal structure of the codebase so that future agentic models can work on\nit more efficiently — smaller files, clearer module boundaries, zero\nduplication, and self-contained functions.\n\n## Session Constraints\n\n- **Hard session cap**: you have at most 90 minutes total. Budget your time.\n- **You MUST open a PR before ending** — a session with no PR is a failed\n session. If you run out of time mid-refactor, commit what you have, push,\n and open the PR immediately even if the work is partial, AS LONG AS all\n tests pass.\n- **Maximum {{maxFilesPerSession}} source files changed** in a single PR.\n Keep diffs small and reviewable. Better to do one clean split per session\n than attempt a mega-refactor.\n- You may run multiple sessions and PRs over time. Prefer incremental progress.\n\n## ✅ Allowed Changes (ONLY these)\n\n1. **Module decomposition** — extract a large file into smaller, focused\n modules. The extracted module must be imported back so the public surface\n is identical.\n2. **Function splitting** — break functions > ~80 lines into smaller,\n well-named helpers within the same file or a co-located util module.\n3. **Deduplication** — extract identical or near-identical logic blocks into\n a shared helper. Must not change call-site behaviour.\n4. **Dead code removal** — remove functions, variables, or imports that are\n verifiably unreferenced (no callers anywhere in the repo).\n5. **Import cleanup** — remove unused imports, deduplicate import statements,\n consolidate barrel imports.\n\n## ❌ Forbidden Changes (HARD STOPS — never do these)\n\n- Adding, removing, or changing any exported function signature or return value\n- Changing any HTTP route path, method, or response shape\n- Changing any config key names or default values\n- Adding new features, flags, or options of any kind\n- Changing test assertions or test logic\n- Renaming exported symbols (only rename internal/private symbols)\n- Adding comments, JSDoc, or inline documentation (unless minimal and necessary)\n- Changing error messages visible to users or logs (string literals)\n- Any change to .json, .sh, .md, .yaml, .html, .css, or non-.mjs/.js files\n (unless you are only touching an import path string that is broken by a move)\n\n## Workflow\n\n### Step 1 — Identify your target\n\nUse the candidate file list provided (sorted by size, largest first):\n\n```\n{{scan-candidates.output}}\n```\n\nPick **1–3 files** for this session. Prioritise:\n- Files > 500 lines used by multiple modules (high parallel-conflict risk)\n- Files with clearly repeated logic blocks\n- Files with functions > 100 lines that have distinct sub-responsibilities\n\nRead each target file in full before making any decision. Do NOT edit\nanything you have not fully read.\n\n### Step 2 — Plan your split in writing\n\nBefore touching the file, write a short plan (to yourself, as a comment in\nyour reasoning — DO NOT add it to the code):\n- What gets extracted and where\n- New file names (follow existing naming conventions in that directory)\n- Which exports stay vs. move\n- Any callers that will need their import paths updated\n\n### Step 3 — Extract and wire up\n\n- Create the new module file(s) under the same directory as the source file.\n- Update the source file to re-export or directly import the extracted piece\n so every existing call-site continues to work without modification.\n- Update any OTHER files that directly imported from the source file, if and\n only if you moved an export that those files reference. Use\n `grep -r 'importedName' --include='*.mjs' --include='*.js'` to find callers.\n- **Do not touch callers unless strictly required by the move.**\n\n### Step 4 — Validate before committing\n\nRun ALL of the following in order. Do not commit if any fail:\n\n```bash\n# 1. Syntax check every file you touched\n{{syntaxCheckCommand}} ...\n\n# 2. Lint check (if configured)\n{{lintCommand}}\n\n# 3. Full test suite — must be 0 failures, 0 unexpected skips\n{{testCommand}}\n\n# 4. Build — must pass clean\n{{buildCommand}}\n```\n\nIf tests fail, **revert your change** (`git checkout -- `) and either:\n- Attempt a smaller, safer split of the same file, OR\n- Move to a different target file\n\n**Never push a failing test suite.**\n\n### Step 5 — Commit, push, and open the PR\n\nBranch name: `{{branch}}`\nBase branch: `{{baseBranch}}`\n\nCommit message format:\n```\nrefactor(): split \n\n- extracted into \n- \n\nNo functional changes. All tests pass.\n```\n\nPR title: `refactor: code quality pass — `\n\nPR body template:\n```markdown\n## Code Quality Pass\n\n**Session**: {{branch}}\n**Scope**: structural refactor only — zero functional changes\n\n### Changes\n- \n\n### Validation\n- `{{syntaxCheckCommand}}` passed on all touched files\n- `{{testCommand}}` passed (N tests)\n- `{{buildCommand}}` passed\n\n### Why\n\n```\n\n### Step 6 — Write session log\n\nAppend a new entry to `{{sessionLogPath}}` using this\nexact format (create the file if it does not exist):\n\n```markdown\n## \n\n- Scope: \n- Files changed: \n- Strategy: \n- Validation evidence:\n - `{{syntaxCheckCommand}}` passed on all touched files\n - `{{testCommand}}` passed (N tests)\n - `{{buildCommand}}` passed\n- PR: # — ``\n```\n\n## Time Budget Warning\n\nIf you have fewer than 15 minutes remaining:\n- Stop new analysis immediately\n- Commit and push whatever passing changes you have\n- Open the PR even if the scope is smaller than planned\n- Write the session log\n- Stop\n\nA small, clean, tested PR is always better than nothing." + "message": "MCP Pipeline: {{discover-tools.toolCount}} tools available, {{call-tool.itemCount}} items returned, first: {{extract-data.summary}}", + "level": "info" }, "position": { - "x": 400, - "y": 450 + "x": 1220, + "y": 100 }, "outputs": [ "default" ] + } + ], + "edges": [ + { + "id": "trigger->discover-tools", + "source": "trigger", + "target": "discover-tools", + "sourcePort": "default" }, { - "id": "verify-tests", - "type": "validation.tests", - "label": "Verify — Tests", - "config": { - "command": "{{testCommand}}" - }, + "id": "discover-tools->call-tool", + "source": "discover-tools", + "target": "call-tool", + "sourcePort": "default" + }, + { + "id": "call-tool->extract-data", + "source": "call-tool", + "target": "extract-data", + "sourcePort": "default" + }, + { + "id": "extract-data->log-results", + "source": "extract-data", + "target": "log-results", + "sourcePort": "default" + } + ] + }, + { + "id": "template-mcp-to-bosun-bridge", + "name": "MCP-to-Bosun Bridge", + "description": "Bridge external MCP tools with Bosun internal capabilities. Calls an MCP tool (e.g. GitHub), extracts structured data, creates Bosun tasks from the results, and optionally dispatches sub-workflows for each item. Full integration pattern: External Data → Internal Action → Workflow.", + "category": "mcp-integration", + "categoryLabel": "Mcp Integration", + "categoryIcon": ":settings:", + "categoryOrder": 99, + "tags": [ + "mcp", + "bosun", + "bridge", + "tasks", + "integration", + "orchestration" + ], + "nodeCount": 7, + "edgeCount": 7, + "recommended": false, + "enabled": true, + "trigger": "trigger.manual", + "variables": { + "mcpServer": "github", + "mcpTool": "list_pull_requests", + "mcpInput": "{}", + "processingWorkflow": "" + }, + "metadata": { + "author": "virtengine", + "tags": [ + "mcp", + "bosun", + "bridge", + "tasks", + "integration", + "orchestration" + ] + }, + "nodes": [ + { + "id": "trigger", + "type": "trigger.manual", + "label": "Start", + "config": {}, "position": { - "x": 200, - "y": 610 + "x": 100, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "verify-build", - "type": "validation.build", - "label": "Verify — Build", + "id": "fetch-external", + "type": "action.mcp_tool_call", + "label": "Fetch External Data", "config": { - "command": "{{buildCommand}}", - "zeroWarnings": false + "server": "{{mcpServer}}", + "tool": "{{mcpTool}}", + "input": "{{mcpInput}}", + "outputVariable": "externalData", + "extract": { + "fields": { + "items": "[*]", + "totalCount": "length", + "firstTitle": "[0].title" + }, + "defaults": { + "items": [], + "totalCount": 0, + "firstTitle": "N/A" + }, + "types": { + "totalCount": "number" + } + } }, "position": { - "x": 600, - "y": 610 + "x": 380, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "check-validation", - "type": "condition.expression", - "label": "Validation Passed?", + "id": "git-check", + "type": "action.bosun_function", + "label": "Check Git Status", "config": { - "expression": "$ctx.getNodeOutput('verify-tests')?.success === true && $ctx.getNodeOutput('verify-build')?.success === true" + "function": "git.status", + "outputVariable": "gitStatus" }, "position": { - "x": 400, - "y": 750 + "x": 660, + "y": 100 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "create-pr", - "type": "action.create_pr", - "label": "Open Quality PR", + "id": "create-task", + "type": "action.bosun_function", + "label": "Create Summary Task", "config": { - "title": "refactor: code quality pass", - "body": "Automated code-quality session. Structural refactor only — zero functional changes. See `.bosun-monitor/code-quality-striker.md` for session details.", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "labels": [ - "refactor", - "code-quality", - "automated" - ] + "function": "tasks.create", + "args": { + "title": "External data: {{fetch-external.totalCount}} items from {{mcpServer}}/{{mcpTool}}", + "description": "First item: {{fetch-external.firstTitle}}. Git clean: {{git-check.clean}}", + "priority": "medium", + "labels": [ + "mcp-bridge", + "{{mcpServer}}" + ] + } }, "position": { - "x": 200, - "y": 890 + "x": 940, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "notify-success", - "type": "notify.telegram", - "label": "Notify PR Opened", + "id": "has-processing-wf", + "type": "condition.expression", + "label": "Has Processing Workflow?", "config": { - "message": ":check: Code quality striker session complete.\nPR opened: **{{branch}}**", - "silent": true + "expression": "{{processingWorkflow}}" }, "position": { - "x": 200, - "y": 1030 + "x": 1220, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "notify-failure", - "type": "notify.telegram", - "label": "Notify — Validation Failed", + "id": "dispatch-processing", + "type": "action.invoke_workflow", + "label": "Dispatch Processing", "config": { - "message": ":alert: Code quality striker **validation failed**.\n\nThe agent produced changes that broke tests or build. No PR was created.\nCheck `.bosun-monitor/code-quality-striker.md` for details." + "workflowId": "{{processingWorkflow}}", + "input": { + "externalData": "{{fetch-external.data}}", + "itemCount": "{{fetch-external.totalCount}}", + "gitClean": "{{git-check.clean}}" + }, + "mode": "dispatch" }, "position": { - "x": 600, - "y": 890 + "x": 1500, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "log-failure", + "id": "log-complete", "type": "notify.log", - "label": "Log Failure", + "label": "Bridge Complete", "config": { - "message": "Code quality striker validation failed — no PR created.", - "level": "warn" + "message": "MCP-to-Bosun bridge: {{fetch-external.totalCount}} items fetched, task created, processing {{has-processing-wf.result}}", + "level": "info" }, "position": { - "x": 600, - "y": 1030 + "x": 1780, + "y": 100 }, "outputs": [ "default" @@ -18694,223 +17845,173 @@ ], "edges": [ { - "id": "trigger->check-active-pr", + "id": "trigger->fetch-external", "source": "trigger", - "target": "check-active-pr", - "sourcePort": "default" - }, - { - "id": "check-active-pr->skip-already-running", - "source": "check-active-pr", - "target": "skip-already-running", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "check-active-pr->scan-candidates", - "source": "check-active-pr", - "target": "scan-candidates", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "scan-candidates->run-striker", - "source": "scan-candidates", - "target": "run-striker", - "sourcePort": "default" - }, - { - "id": "run-striker->verify-tests", - "source": "run-striker", - "target": "verify-tests", + "target": "fetch-external", "sourcePort": "default" }, { - "id": "run-striker->verify-build", - "source": "run-striker", - "target": "verify-build", + "id": "fetch-external->git-check", + "source": "fetch-external", + "target": "git-check", "sourcePort": "default" }, { - "id": "verify-tests->check-validation", - "source": "verify-tests", - "target": "check-validation", + "id": "git-check->create-task", + "source": "git-check", + "target": "create-task", "sourcePort": "default" }, { - "id": "verify-build->check-validation", - "source": "verify-build", - "target": "check-validation", + "id": "create-task->has-processing-wf", + "source": "create-task", + "target": "has-processing-wf", "sourcePort": "default" }, { - "id": "check-validation->create-pr", - "source": "check-validation", - "target": "create-pr", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "check-validation->notify-failure", - "source": "check-validation", - "target": "notify-failure", - "sourcePort": "no", - "condition": "$output?.result !== true" + "id": "has-processing-wf->dispatch-processing", + "source": "has-processing-wf", + "target": "dispatch-processing", + "sourcePort": "true" }, { - "id": "create-pr->notify-success", - "source": "create-pr", - "target": "notify-success", - "sourcePort": "default" + "id": "has-processing-wf->log-complete", + "source": "has-processing-wf", + "target": "log-complete", + "sourcePort": "false" }, { - "id": "notify-failure->log-failure", - "source": "notify-failure", - "target": "log-failure", + "id": "dispatch-processing->log-complete", + "source": "dispatch-processing", + "target": "log-complete", "sourcePort": "default" } ] }, { - "id": "template-task-debug", - "name": "Debug Task Workflow", - "description": "Bug investigation and fix workflow. Starts with reproduction and root-cause analysis, then implements a targeted fix with regression tests.", - "category": "task-execution", - "categoryLabel": "Task Execution", + "id": "template-scheduled-maintenance", + "name": "Scheduled Maintenance", + "description": "Runs a one-time maintenance window: reads config, waits, acquires a worktree through a safety gate, performs work, then releases. Exercises scheduled_once, read_file, delay, flow.gate, acquire/release_worktree.", + "category": "coverage", + "categoryLabel": "Coverage", "categoryIcon": ":settings:", "categoryOrder": 99, "tags": [ - "debug", - "bug", - "fix", - "error", - "task-type" + "coverage", + "maintenance", + "worktree" ], - "nodeCount": 5, - "edgeCount": 4, - "recommended": true, + "nodeCount": 7, + "edgeCount": 6, + "recommended": false, "enabled": true, - "trigger": "trigger.task_assigned", + "trigger": "trigger.scheduled_once", "variables": { - "taskTimeoutMs": 21600000, - "maxRetries": 3, - "maxContinues": 4, - "testCommand": "auto", - "buildCommand": "auto", - "lintCommand": "auto" + "taskId": "MAINT-01", + "maintenanceConfigPath": "/nonexistent/maintenance.json", + "targetBranch": "feat/maintenance-test", + "baseBranch": "origin/main" }, "metadata": { - "author": "bosun", - "version": 1, - "createdAt": "2025-06-01T00:00:00Z", - "templateVersion": "1.0.0", + "author": "virtengine", "tags": [ - "debug", - "bug", - "fix", - "error", - "task-type" - ], - "resolveMode": "library" + "coverage", + "maintenance", + "worktree" + ] }, "nodes": [ { "id": "trigger", - "type": "trigger.task_assigned", - "label": "Task Assigned", + "type": "trigger.scheduled_once", + "label": "Scheduled Trigger", "config": { - "taskPattern": "bug|fix|error|crash|regression|broken|debug|issue|defect|hotfix|patch" + "runAt": "2020-01-01T00:00:00Z" }, "position": { - "x": 400, - "y": 50 + "x": 100, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "reproduce", - "type": "action.run_agent", - "label": "Reproduce & Analyse", + "id": "read-config", + "type": "action.read_file", + "label": "Read Config", "config": { - "prompt": "## Phase: Bug Reproduction & Root Cause Analysis\n\n1. Read the bug report carefully\n2. Find the relevant code area\n3. Reproduce the issue (write a failing test if possible)\n4. Trace the root cause through the codebase\n5. Document: what fails, where, why, and the minimal fix needed\n\nDo NOT fix the bug yet — only diagnose.", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "repoMapQuery": "{{taskTitle}} {{taskDescription}}", - "repoMapFileLimit": 8, - "mode": "plan", - "executionRole": "architect" + "path": "{{maintenanceConfigPath}}", + "continueOnError": true }, "position": { - "x": 400, - "y": 180 + "x": 380, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "fix-and-test", - "type": "action.run_agent", - "label": "Fix & Regression Test", + "id": "wait", + "type": "action.delay", + "label": "Short Delay", "config": { - "prompt": "## Phase: Fix Implementation with Regression Tests\n\n1. Write a regression test that demonstrates the bug (must fail before fix)\n2. Apply the minimal, surgical fix\n3. Verify the regression test now passes\n4. Run the full test suite: {{testCommand}}\n5. Run build: {{buildCommand}}\n6. Run lint: {{lintCommand}}\n7. Ensure no other tests broke\n\nCommit fix and test together with a clear commit message.", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "repoMapQuery": "{{taskTitle}} {{taskDescription}}", - "repoMapFileLimit": 8, - "executionRole": "editor", - "architectPlan": "{{$ctx.getNodeOutput('reproduce')?.summary || $ctx.getNodeOutput('reproduce')?.output || ''}}" + "ms": 1 }, "position": { - "x": 400, - "y": 340 + "x": 660, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "verify", - "type": "action.run_agent", - "label": "Verify & PR", + "id": "safety-gate", + "type": "flow.gate", + "label": "Safety Gate", "config": { - "prompt": "## Phase: Final Verification\n\n1. Run complete test suite: {{testCommand}}\n2. Run build: {{buildCommand}}\n3. Confirm the original bug is fixed\n4. Confirm no regressions\n5. Push and create/update PR with root cause analysis in description", + "mode": "timeout", + "timeoutMs": 1, + "reason": "maintenance safety gate" + }, + "position": { + "x": 940, + "y": 100 + }, + "outputs": [ + "default" + ] + }, + { + "id": "acquire", + "type": "action.acquire_worktree", + "label": "Acquire Worktree", + "config": { + "branch": "{{targetBranch}}", + "baseBranch": "{{baseBranch}}", "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "repoMapQuery": "{{taskTitle}} {{taskDescription}}", - "repoMapFileLimit": 8, - "executionRole": "editor", - "architectPlan": "{{$ctx.getNodeOutput('reproduce')?.summary || $ctx.getNodeOutput('reproduce')?.output || ''}}" + "continueOnError": true }, "position": { - "x": 400, - "y": 500 + "x": 1220, + "y": 100 + }, + "outputs": [ + "default" + ] + }, + { + "id": "release", + "type": "action.release_worktree", + "label": "Release Worktree", + "config": { + "continueOnError": true + }, + "position": { + "x": 1500, + "y": 100 }, "outputs": [ "default" @@ -18919,13 +18020,14 @@ { "id": "done", "type": "notify.log", - "label": "Complete", + "label": "Maintenance Done", "config": { - "message": "Debug task completed — bug fixed with regression test." + "message": "Maintenance complete", + "level": "info" }, "position": { - "x": 400, - "y": 660 + "x": 1780, + "y": 100 }, "outputs": [ "default" @@ -18934,80 +18036,95 @@ ], "edges": [ { - "id": "trigger->reproduce", + "id": "trigger->read-config", "source": "trigger", - "target": "reproduce", + "target": "read-config", "sourcePort": "default" }, { - "id": "reproduce->fix-and-test", - "source": "reproduce", - "target": "fix-and-test", + "id": "read-config->wait", + "source": "read-config", + "target": "wait", "sourcePort": "default" }, { - "id": "fix-and-test->verify", - "source": "fix-and-test", - "target": "verify", + "id": "wait->safety-gate", + "source": "wait", + "target": "safety-gate", "sourcePort": "default" }, { - "id": "verify->done", - "source": "verify", + "id": "safety-gate->acquire", + "source": "safety-gate", + "target": "acquire", + "sourcePort": "default" + }, + { + "id": "acquire->release", + "source": "acquire", + "target": "release", + "sourcePort": "default" + }, + { + "id": "release->done", + "source": "release", "target": "done", "sourcePort": "default" } ] }, { - "id": "template-task-design", - "name": "Design Task Workflow", - "description": "For design-related tasks — mockups, wireframes, design tokens, component library work. Analyses design requirements, implements the design system changes, and verifies visual output.", + "id": "template-task-batch-pr", + "name": "Task Batch → PR", + "description": "Simplified batch processor that picks todo tasks, runs the agent on each, and creates pull requests for any that produce commits. Ideal for autonomous mode where tasks should flow straight to PRs.", "category": "task-execution", "categoryLabel": "Task Execution", "categoryIcon": ":settings:", "categoryOrder": 99, "tags": [ - "design", - "mockup", - "wireframe", - "design-system", - "task-type" + "task", + "batch", + "pr", + "agent", + "autonomous" ], - "nodeCount": 5, - "edgeCount": 4, - "recommended": true, + "nodeCount": 12, + "edgeCount": 12, + "recommended": false, "enabled": true, - "trigger": "trigger.task_assigned", + "trigger": "trigger.task_available", "variables": { - "taskTimeoutMs": 21600000, - "maxRetries": 2, - "maxContinues": 3, - "testCommand": "auto", - "buildCommand": "auto", - "lintCommand": "auto" + "maxConcurrent": 2, + "pollStatus": "todo", + "maxBatchSize": 5, + "defaultBaseBranch": "main", + "draftPR": true }, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2025-06-01T00:00:00Z", + "createdAt": "2026-03-15T00:00:00Z", "templateVersion": "1.0.0", "tags": [ - "design", - "mockup", - "wireframe", - "design-system", - "task-type" + "task", + "batch", + "pr", + "agent", + "autonomous" ], - "resolveMode": "library" + "requiredTemplates": [ + "template-bosun-pr-progressor" + ] }, "nodes": [ { "id": "trigger", - "type": "trigger.task_assigned", - "label": "Task Assigned", + "type": "trigger.task_available", + "label": "Tasks Available?", "config": { - "taskPattern": "design|mockup|wireframe|prototype|design.system|theme|color|typography|icon|illustration|ux" + "maxParallel": "{{maxConcurrent}}", + "pollIntervalMs": 15000, + "status": "{{pollStatus}}" }, "position": { "x": 400, @@ -19018,25 +18135,19 @@ ] }, { - "id": "analyse-requirements", - "type": "action.run_agent", - "label": "Analyse Design Req", + "id": "query-tasks", + "type": "action.run_command", + "label": "List Todo Tasks", "config": { - "prompt": "## Phase: Design Requirements Analysis\n\n1. Review the design task requirements\n2. Identify affected design tokens, components, or patterns\n3. Check existing design system for reusable pieces\n4. Plan the implementation approach\n5. List affected files and components\n\nDo NOT make changes yet.", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "repoMapQuery": "{{taskTitle}} {{taskDescription}}", - "repoMapFileLimit": 8, - "mode": "plan", - "executionRole": "architect" + "command": "node", + "args": [ + "-e", + "\n const fs = require(\"node:fs\");\n const path = require(\"node:path\");\n const { pathToFileURL } = require(\"node:url\");\n const cwd = process.cwd();\n const mirrorMarker = (path.sep + \".bosun\" + path.sep + \"workspaces\" + path.sep).toLowerCase();\n let repoRoot = cwd;\n if (cwd.toLowerCase().includes(mirrorMarker)) {\n const sourceRepoRoot = path.resolve(cwd, \"..\", \"..\", \"..\", \"..\");\n if (fs.existsSync(path.join(sourceRepoRoot, \"kanban\", \"kanban-adapter.mjs\"))) repoRoot = sourceRepoRoot;\n }\n const kanbanModuleUrl = pathToFileURL(path.join(repoRoot, \"kanban\", \"kanban-adapter.mjs\")).href;\n import(kanbanModuleUrl)\n .then(k => k.listTasks(undefined, { status: \"todo\" }))\n .then(tasks => {\n const filtered = (tasks || []).filter((task) => task && task.status === \"todo\" && !task.draft);\n const batch = filtered.slice(0, parseInt(process.env.MAX_BATCH || \"5\"));\n console.log(JSON.stringify(batch.map(t => ({\n taskId: t.id,\n taskTitle: t.title || t.id,\n branch: t.branch || t.metadata?.branch || null,\n repository: typeof t?.repository === \"string\" ? t.repository.trim() : null,\n workspace: typeof t?.workspace === \"string\" ? t.workspace.trim() : null,\n }))));\n })\n .catch(e => { console.error(e.message); process.exit(1); });\n " + ], + "env": { + "MAX_BATCH": "{{maxBatchSize}}" + }, + "parseJson": true }, "position": { "x": 400, @@ -19047,245 +18158,180 @@ ] }, { - "id": "implement-design", - "type": "action.run_agent", - "label": "Implement Design", + "id": "for-each-task", + "type": "loop.for_each", + "label": "Process Each Task", "config": { - "prompt": "## Phase: Design Implementation\n\n1. Update design tokens (colors, spacing, typography) if needed\n2. Create / update components per the design specification\n3. Ensure consistency with existing design system\n4. Add visual tests or snapshots where applicable\n5. Run build: {{buildCommand}}\n6. Run lint: {{lintCommand}}\n\nCommit changes with descriptive messages.", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "repoMapQuery": "{{taskTitle}} {{taskDescription}}", - "repoMapFileLimit": 8, - "executionRole": "editor", - "architectPlan": "{{$ctx.getNodeOutput('analyse-requirements')?.summary || $ctx.getNodeOutput('analyse-requirements')?.output || ''}}" + "items": "$ctx.getNodeOutput('query-tasks')?.output || []", + "variable": "task", + "indexVariable": "idx", + "maxConcurrent": "{{maxConcurrent}}" }, "position": { "x": 400, - "y": 340 + "y": 310 }, "outputs": [ "default" ] }, { - "id": "verify-design", - "type": "action.run_agent", - "label": "Verify & PR", + "id": "set-inprogress", + "type": "action.update_task_status", + "label": "Mark In-Progress", "config": { - "prompt": "## Phase: Design Verification\n\n1. Run tests: {{testCommand}}\n2. Run build: {{buildCommand}}\n3. Verify visual consistency\n4. Check design token values are correct\n5. Push and create/update PR", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "repoMapQuery": "{{taskTitle}} {{taskDescription}}", - "repoMapFileLimit": 8, - "executionRole": "editor", - "architectPlan": "{{$ctx.getNodeOutput('analyse-requirements')?.summary || $ctx.getNodeOutput('analyse-requirements')?.output || ''}}" + "taskId": "{{task.taskId}}", + "status": "inprogress" }, "position": { "x": 400, - "y": 500 + "y": 440 }, "outputs": [ "default" ] }, { - "id": "done", - "type": "notify.log", - "label": "Complete", + "id": "run-agent", + "type": "action.run_agent", + "label": "Run Agent", "config": { - "message": "Design task completed — design changes implemented and verified." + "taskId": "{{task.taskId}}", + "taskTitle": "{{task.taskTitle}}", + "branch": "{{task.branch}}" }, "position": { "x": 400, - "y": 660 + "y": 570 }, "outputs": [ "default" ] - } - ], - "edges": [ - { - "id": "trigger->analyse-requirements", - "source": "trigger", - "target": "analyse-requirements", - "sourcePort": "default" - }, - { - "id": "analyse-requirements->implement-design", - "source": "analyse-requirements", - "target": "implement-design", - "sourcePort": "default" - }, - { - "id": "implement-design->verify-design", - "source": "implement-design", - "target": "verify-design", - "sourcePort": "default" }, { - "id": "verify-design->done", - "source": "verify-design", - "target": "done", - "sourcePort": "default" - } - ] - }, - { - "id": "template-flow-control-suite", - "name": "Flow Control Suite", - "description": "Exercises flow-control primitives in a single short workflow: join, while-loop (0 iters), universal dispatch, and meeting finalization.", - "category": "coverage", - "categoryLabel": "Coverage", - "categoryIcon": ":settings:", - "categoryOrder": 99, - "tags": [ - "coverage", - "flow", - "control" - ], - "nodeCount": 7, - "edgeCount": 6, - "recommended": false, - "enabled": true, - "trigger": "trigger.manual", - "variables": { - "subWorkflowId": "template-health-check", - "sessionId": "session-flow-test", - "maxLoopIterations": 1 - }, - "metadata": { - "author": "virtengine", - "tags": [ - "coverage", - "flow", - "control" - ], - "requiredTemplates": [ - "template-health-check" - ] - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.manual", - "label": "Manual Trigger", - "config": {}, + "id": "detect-commits", + "type": "action.detect_new_commits", + "label": "Check Commits", + "config": { + "taskId": "{{task.taskId}}", + "worktreePath": "{{worktreePath}}", + "failOnError": false + }, "position": { - "x": 100, - "y": 100 + "x": 400, + "y": 700 }, "outputs": [ "default" ] }, { - "id": "join", - "type": "flow.join", - "label": "Join Branches", + "id": "push-branch", + "type": "action.git_operations", + "label": "Push Branch", "config": { - "mode": "any", - "sourceNodeIds": [] + "operation": "push", + "cwd": "{{worktreePath}}" }, "position": { - "x": 380, - "y": 100 + "x": 400, + "y": 830 }, "outputs": [ "default" ] }, { - "id": "loop", - "type": "loop.while", - "label": "While Loop", + "id": "create-pr", + "type": "action.create_pr", + "label": "Create PR", "config": { - "condition": "$iteration < 0", - "maxIterations": "{{maxLoopIterations}}" + "title": "{{task.taskTitle}}", + "body": "Task-ID: {{task.taskId}}\n\nAutomated PR for task {{task.taskId}}", + "base": "{{defaultBaseBranch}}", + "branch": "{{task.branch}}", + "draft": "{{draftPR}}" }, "position": { - "x": 660, - "y": 100 + "x": 400, + "y": 960 }, "outputs": [ "default" ] }, { - "id": "dispatch1", - "type": "flow.universal", - "label": "Universal Dispatch 1", + "id": "set-inreview", + "type": "action.update_task_status", + "label": "Mark In-Review", "config": { - "mode": "dispatch", - "workflowId": "{{subWorkflowId}}" + "taskId": "{{task.taskId}}", + "status": "inreview" }, "position": { - "x": 940, - "y": 100 + "x": 400, + "y": 1090 }, "outputs": [ "default" ] }, { - "id": "dispatch2", - "type": "flow.universial", - "label": "Universal Dispatch 2", + "id": "handoff-pr-progressor", + "type": "action.execute_workflow", + "label": "Dispatch PR Progressor", "config": { - "workflowId": "{{subWorkflowId}}", - "mode": "dispatch" + "workflowId": "template-bosun-pr-progressor", + "mode": "dispatch", + "input": { + "taskId": "{{task.taskId}}", + "taskTitle": "{{task.taskTitle}}", + "branch": "{{task.branch}}", + "baseBranch": "{{defaultBaseBranch}}", + "prNumber": "{{$ctx.getNodeOutput('create-pr')?.prNumber ?? null}}", + "prUrl": "{{$ctx.getNodeOutput('create-pr')?.prUrl || ''}}", + "repo": "{{$ctx.getNodeOutput('create-pr')?.repoSlug || $data?.repo || $data?.repoSlug || $data?.repository || ''}}" + } }, "position": { - "x": 1220, - "y": 100 + "x": 400, + "y": 1160 }, "outputs": [ "default" ] }, { - "id": "finalize-meeting", - "type": "meeting.finalize", - "label": "Finalize Meeting", + "id": "join-batch-outcomes", + "type": "flow.join", + "label": "Join Batch Outcomes", "config": { - "sessionId": "{{sessionId}}", - "continueOnError": true + "mode": "all", + "sourceNodeIds": [ + "detect-commits", + "handoff-pr-progressor" + ], + "includeSkipped": true }, "position": { - "x": 1500, - "y": 100 + "x": 400, + "y": 1230 }, "outputs": [ "default" ] }, { - "id": "done", + "id": "notify", "type": "notify.log", - "label": "Done", + "label": "Batch Complete", "config": { - "message": "Flow control suite complete", + "message": "Task batch PR pipeline complete", "level": "info" }, "position": { - "x": 1780, - "y": 100 + "x": 400, + "y": 1220 }, "outputs": [ "default" @@ -19294,92 +18340,130 @@ ], "edges": [ { - "id": "trigger->join", + "id": "trigger->query-tasks", "source": "trigger", - "target": "join", + "target": "query-tasks", "sourcePort": "default" }, { - "id": "join->loop", - "source": "join", - "target": "loop", + "id": "query-tasks->for-each-task", + "source": "query-tasks", + "target": "for-each-task", "sourcePort": "default" }, { - "id": "loop->dispatch1", - "source": "loop", - "target": "dispatch1", + "id": "for-each-task->set-inprogress", + "source": "for-each-task", + "target": "set-inprogress", "sourcePort": "default" }, { - "id": "dispatch1->dispatch2", - "source": "dispatch1", - "target": "dispatch2", + "id": "set-inprogress->run-agent", + "source": "set-inprogress", + "target": "run-agent", "sourcePort": "default" }, { - "id": "dispatch2->finalize-meeting", - "source": "dispatch2", - "target": "finalize-meeting", + "id": "run-agent->detect-commits", + "source": "run-agent", + "target": "detect-commits", "sourcePort": "default" }, { - "id": "finalize-meeting->done", - "source": "finalize-meeting", - "target": "done", + "id": "detect-commits->push-branch", + "source": "detect-commits", + "target": "push-branch", + "sourcePort": "default", + "condition": "result.hasNewCommits === true" + }, + { + "id": "push-branch->create-pr", + "source": "push-branch", + "target": "create-pr", "sourcePort": "default" - } - ] - }, - { - "id": "template-task-frontend", - "name": "Frontend Task Workflow", - "description": "Specialised for UI tasks — components, pages, styling, accessibility. Runs three phases: design analysis, implement with component tests, and visual verification.", - "category": "task-execution", - "categoryLabel": "Task Execution", - "categoryIcon": ":settings:", - "categoryOrder": 99, - "tags": [ - "frontend", - "ui", - "css", - "component", - "task-type" - ], - "nodeCount": 5, - "edgeCount": 4, - "recommended": true, - "enabled": true, - "trigger": "trigger.task_assigned", - "variables": { - "taskTimeoutMs": 21600000, - "maxRetries": 2, - "maxContinues": 3, - "testCommand": "auto", - "buildCommand": "auto", - "lintCommand": "auto" + }, + { + "id": "create-pr->set-inreview", + "source": "create-pr", + "target": "set-inreview", + "sourcePort": "default" + }, + { + "id": "detect-commits->join-batch-outcomes", + "source": "detect-commits", + "target": "join-batch-outcomes", + "sourcePort": "default", + "condition": "result.hasNewCommits !== true" + }, + { + "id": "set-inreview->handoff-pr-progressor", + "source": "set-inreview", + "target": "handoff-pr-progressor", + "sourcePort": "default" + }, + { + "id": "handoff-pr-progressor->join-batch-outcomes", + "source": "handoff-pr-progressor", + "target": "join-batch-outcomes", + "sourcePort": "default" + }, + { + "id": "join-batch-outcomes->notify", + "source": "join-batch-outcomes", + "target": "notify", + "sourcePort": "default" + } + ] + }, + { + "id": "template-task-batch-processor", + "name": "Task Batch Processor", + "description": "Monitors the task backlog and dispatches multiple tasks in parallel using the Task Lifecycle sub-workflow. Automatically picks up tasks when backlog drops below threshold, fans out execution across available slots, and reports batch results.", + "category": "task-execution", + "categoryLabel": "Task Execution", + "categoryIcon": ":settings:", + "categoryOrder": 99, + "tags": [ + "task", + "batch", + "parallel", + "dispatch", + "lifecycle" + ], + "nodeCount": 9, + "edgeCount": 8, + "recommended": true, + "enabled": true, + "trigger": "trigger.task_available", + "variables": { + "maxConcurrent": 3, + "pollStatus": "todo", + "maxBatchSize": 10, + "subWorkflow": "template-task-lifecycle", + "notifyChannel": "telegram" }, "metadata": { "author": "bosun", "version": 1, - "createdAt": "2025-06-01T00:00:00Z", + "createdAt": "2026-03-15T00:00:00Z", "templateVersion": "1.0.0", "tags": [ - "frontend", - "ui", - "css", - "component", - "task-type" - ], - "resolveMode": "library" + "task", + "batch", + "parallel", + "dispatch", + "lifecycle" + ] }, "nodes": [ { "id": "trigger", - "type": "trigger.task_assigned", - "label": "Task Assigned", + "type": "trigger.task_available", + "label": "Tasks Available?", "config": { - "taskPattern": "frontend|ui|component|page|layout|style|css|responsive|accessibility|a11y|design.system" + "maxParallel": "{{maxConcurrent}}", + "pollIntervalMs": 15000, + "status": "{{pollStatus}}" }, "position": { "x": 400, @@ -19390,25 +18474,11 @@ ] }, { - "id": "analyse-design", - "type": "action.run_agent", - "label": "Analyse Design", + "id": "check-coordinator", + "type": "condition.expression", + "label": "Is Coordinator?", "config": { - "prompt": "## Phase: Design Analysis\n\nAnalyse the UI task requirements:\n1. Component hierarchy and structure\n2. Layout and responsive breakpoints\n3. State management needs\n4. Accessibility requirements (ARIA, keyboard nav)\n5. Styling approach (CSS modules, Tailwind, styled-components)\n6. Component test plan\n\nDo NOT write code yet.", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "repoMapQuery": "{{taskTitle}} {{taskDescription}}", - "repoMapFileLimit": 8, - "mode": "plan", - "executionRole": "architect" + "expression": "$data?.isCoordinator !== false" }, "position": { "x": 400, @@ -19419,73 +18489,125 @@ ] }, { - "id": "implement-ui", - "type": "action.run_agent", - "label": "Implement UI", + "id": "query-tasks", + "type": "action.run_command", + "label": "Query Task Backlog", "config": { - "prompt": "## Phase: UI Implementation\n\n1. Create / update components per the design plan\n2. Implement layouts, styling, and responsive design\n3. Add proper accessibility attributes\n4. Write component tests\n5. Run tests: {{testCommand}}\n6. Run build: {{buildCommand}}\n7. Run lint: {{lintCommand}}\n\nCommit with descriptive messages.", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "repoMapQuery": "{{taskTitle}} {{taskDescription}}", - "repoMapFileLimit": 8, - "executionRole": "editor", - "architectPlan": "{{$ctx.getNodeOutput('analyse-design')?.summary || $ctx.getNodeOutput('analyse-design')?.output || ''}}" + "command": "node", + "args": [ + "-e", + "\n const fs = require(\"node:fs\");\n const path = require(\"node:path\");\n const { pathToFileURL } = require(\"node:url\");\n const cwd = process.cwd();\n const mirrorMarker = (path.sep + \".bosun\" + path.sep + \"workspaces\" + path.sep).toLowerCase();\n let repoRoot = cwd;\n if (cwd.toLowerCase().includes(mirrorMarker)) {\n const sourceRepoRoot = path.resolve(cwd, \"..\", \"..\", \"..\", \"..\");\n if (fs.existsSync(path.join(sourceRepoRoot, \"kanban\", \"kanban-adapter.mjs\"))) repoRoot = sourceRepoRoot;\n }\n const kanbanModuleUrl = pathToFileURL(path.join(repoRoot, \"kanban\", \"kanban-adapter.mjs\")).href;\n import(kanbanModuleUrl)\n .then(k => k.listTasks(undefined, { status: \"todo\" }))\n .then(tasks => {\n const filtered = (tasks || []).filter((task) => task && task.status === \"todo\" && !task.draft);\n const batch = filtered.slice(0, parseInt(process.env.MAX_BATCH || \"10\"));\n console.log(JSON.stringify(batch.map(t => ({\n taskId: t.id,\n taskTitle: t.title || t.id,\n status: t.status,\n branch: t.branch || t.metadata?.branch || null,\n scope: t.scope || t.metadata?.scope || null,\n repository: typeof t?.repository === \"string\" ? t.repository.trim() : null,\n workspace: typeof t?.workspace === \"string\" ? t.workspace.trim() : null,\n }))));\n })\n .catch(e => { console.error(e.message); process.exit(1); });\n " + ], + "env": { + "MAX_BATCH": "{{maxBatchSize}}" + }, + "parseJson": true }, "position": { "x": 400, - "y": 340 + "y": 310 }, "outputs": [ "default" ] }, { - "id": "verify-visual", - "type": "action.run_agent", - "label": "Verify & PR", + "id": "dispatch-tasks", + "type": "loop.for_each", + "label": "Dispatch Tasks", "config": { - "prompt": "## Phase: Visual Verification\n\n1. Run the full test suite: {{testCommand}}\n2. Run build: {{buildCommand}}\n3. Verify components render correctly\n4. Check responsive breakpoints\n5. Verify accessibility (screen reader, keyboard)\n6. Push changes and create/update PR", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "repoMapQuery": "{{taskTitle}} {{taskDescription}}", - "repoMapFileLimit": 8, - "executionRole": "editor", - "architectPlan": "{{$ctx.getNodeOutput('analyse-design')?.summary || $ctx.getNodeOutput('analyse-design')?.output || ''}}" + "items": "$ctx.getNodeOutput('query-tasks')?.output || []", + "itemVariable": "currentTask", + "indexVariable": "taskIndex", + "maxConcurrent": "{{maxConcurrent}}", + "workflowId": "{{subWorkflow}}", + "mode": "dispatch" }, "position": { "x": 400, - "y": 500 + "y": 440 }, "outputs": [ "default" ] }, { - "id": "done", - "type": "notify.log", - "label": "Complete", + "id": "join-dispatch", + "type": "flow.join", + "label": "Join Dispatch Branches", "config": { - "message": "Frontend task completed — UI implemented and verified." + "mode": "all", + "sourceNodeIds": [ + "dispatch-tasks" + ], + "includeSkipped": true }, "position": { "x": 400, - "y": 660 + "y": 505 + }, + "outputs": [ + "default" + ] + }, + { + "id": "record-results", + "type": "action.set_variable", + "label": "Record Results", + "config": { + "key": "batchResult", + "value": "{{dispatch-tasks}}" + }, + "position": { + "x": 400, + "y": 570 + }, + "outputs": [ + "default" + ] + }, + { + "id": "has-batch-failures", + "type": "condition.expression", + "label": "Any Batch Failures?", + "config": { + "expression": "Number($data?.batchResult?.failCount || 0) > 0" + }, + "position": { + "x": 400, + "y": 700 + }, + "outputs": [ + "default" + ] + }, + { + "id": "notify-failures", + "type": "notify.telegram", + "label": "Batch Failure Alert", + "config": { + "channel": "{{notifyChannel}}", + "message": "Task batch needs attention: {{batchResult.failCount}} failed out of {{batchResult.totalItems}} ({{batchResult.successCount}} succeeded)" + }, + "position": { + "x": 220, + "y": 830 + }, + "outputs": [ + "default" + ] + }, + { + "id": "log-summary", + "type": "notify.log", + "label": "Batch Summary", + "config": { + "message": "Task batch completed: {{batchResult.successCount}}/{{batchResult.totalItems}} succeeded ({{batchResult.failCount}} failed)", + "level": "info" + }, + "position": { + "x": 580, + "y": 830 }, "outputs": [ "default" @@ -19494,74 +18616,147 @@ ], "edges": [ { - "id": "trigger->analyse-design", + "id": "trigger->check-coordinator", "source": "trigger", - "target": "analyse-design", + "target": "check-coordinator", "sourcePort": "default" }, { - "id": "analyse-design->implement-ui", - "source": "analyse-design", - "target": "implement-ui", + "id": "check-coordinator->query-tasks", + "source": "check-coordinator", + "target": "query-tasks", + "sourcePort": "default", + "condition": "$output === true || $output?.result === true || $output?.value === true" + }, + { + "id": "query-tasks->dispatch-tasks", + "source": "query-tasks", + "target": "dispatch-tasks", "sourcePort": "default" }, { - "id": "implement-ui->verify-visual", - "source": "implement-ui", - "target": "verify-visual", + "id": "dispatch-tasks->join-dispatch", + "source": "dispatch-tasks", + "target": "join-dispatch", "sourcePort": "default" }, { - "id": "verify-visual->done", - "source": "verify-visual", - "target": "done", + "id": "join-dispatch->record-results", + "source": "join-dispatch", + "target": "record-results", + "sourcePort": "default" + }, + { + "id": "record-results->has-batch-failures", + "source": "record-results", + "target": "has-batch-failures", "sourcePort": "default" + }, + { + "id": "has-batch-failures->notify-failures", + "source": "has-batch-failures", + "target": "notify-failures", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "has-batch-failures->log-summary", + "source": "has-batch-failures", + "target": "log-summary", + "sourcePort": "default", + "condition": "$output?.result !== true" } ] }, { - "id": "template-task-fullstack", - "name": "Fullstack Task Workflow", - "description": "Handles tasks that span frontend and backend — API endpoints, database models, and UI components. Runs four agent phases: architecture planning, backend implementation, frontend implementation, and integration testing.", + "id": "template-task-lifecycle", + "name": "Task Lifecycle", + "description": "Complete task execution pipeline: poll for tasks → claim → worktree → agent dispatch → commit detection → PR creation → status transition. Replaces the monolithic TaskExecutor.executeTask() method with a composable workflow DAG.", "category": "task-execution", "categoryLabel": "Task Execution", "categoryIcon": ":settings:", "categoryOrder": 99, "tags": [ - "fullstack", - "task-type" + "task", + "lifecycle", + "executor", + "workflow-first", + "core" ], - "nodeCount": 6, - "edgeCount": 5, + "nodeCount": 59, + "edgeCount": 67, "recommended": true, "enabled": true, - "trigger": "trigger.task_assigned", + "trigger": "trigger.task_available", "variables": { + "maxParallel": 3, + "baseBranchLimit": 0, + "pollIntervalMs": 30000, + "claimTtlMinutes": 180, + "claimRenewIntervalMs": 60000, + "defaultSdk": "auto", + "defaultTargetBranch": "origin/main", "taskTimeoutMs": 21600000, + "delegationWatchdogTimeoutMs": 300000, + "delegationWatchdogMaxRecoveries": 1, + "prePrValidationEnabled": true, + "prePrValidationCommand": "auto", + "autoMergeOnCreate": false, + "autoMergeMethod": "squash", "maxRetries": 2, "maxContinues": 3, - "testCommand": "auto", - "buildCommand": "auto", - "lintCommand": "auto" + "protectedBranches": [ + "main", + "master", + "develop", + "production" + ] }, "metadata": { "author": "bosun", - "version": 1, - "createdAt": "2025-06-01T00:00:00Z", - "templateVersion": "1.0.0", + "version": 2, + "createdAt": "2026-03-01T00:00:00Z", + "templateVersion": "2.1.0", "tags": [ - "fullstack", - "task-type" + "task", + "lifecycle", + "executor", + "workflow-first", + "core" ], - "resolveMode": "library" + "requiredTemplates": [ + "template-bosun-pr-progressor" + ], + "replaces": { + "module": "task-executor.mjs", + "functions": [ + "executeTask", + "_pollLoop", + "_handleTaskResult", + "_buildTaskPrompt", + "_processBacklogReplenishment" + ], + "calledFrom": [ + "monitor.mjs:startProcess", + "monitor.mjs:runMonitorMonitorCycle" + ], + "description": "Replaces the entire TaskExecutor.executeTask() monolith with a composable DAG workflow. Each step (claim, worktree, agent, PR) is an independent workflow node with explicit success/failure branches." + } }, "nodes": [ { "id": "trigger", - "type": "trigger.task_assigned", - "label": "Task Assigned", + "type": "trigger.task_available", + "label": "Poll for Tasks", "config": { - "taskPattern": "full.?stack|end.to.end|api.*ui|server.*client|frontend.*backend|database.*component" + "maxParallel": "{{maxParallel}}", + "pollIntervalMs": "{{pollIntervalMs}}", + "statuses": [ + "inreview", + "todo" + ], + "filterCodexScoped": true, + "filterDrafts": true }, "position": { "x": 400, @@ -19572,25 +18767,13 @@ ] }, { - "id": "plan-architecture", - "type": "action.run_agent", - "label": "Plan Architecture", + "id": "check-slots", + "type": "condition.slot_available", + "label": "Slots Available?", "config": { - "prompt": "## Phase: Architecture Planning\n\nAnalyse the task and produce a concrete plan covering:\n1. Backend changes: API routes, models, services, migrations\n2. Frontend changes: components, pages, state management\n3. Shared types / contracts between layers\n4. Test strategy for each layer\n5. Integration points and data flow\n\nDo NOT write code yet — produce only the plan.", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "repoMapQuery": "{{taskTitle}} {{taskDescription}}", - "repoMapFileLimit": 8, - "mode": "plan", - "executionRole": "architect" + "maxParallel": "{{maxParallel}}", + "baseBranchLimit": "{{baseBranchLimit}}", + "baseBranch": "{{defaultTargetBranch}}" }, "position": { "x": 400, @@ -19601,1647 +18784,1024 @@ ] }, { - "id": "implement-backend", - "type": "action.run_agent", - "label": "Implement Backend", + "id": "allocate-slot", + "type": "action.allocate_slot", + "label": "Allocate Slot", "config": { - "prompt": "## Phase: Backend Implementation\n\nImplement the server-side / API changes from the architecture plan:\n- Models, schemas, database migrations\n- API routes and controllers\n- Service / business logic\n- Unit tests for backend logic\n- Run tests: {{testCommand}}\n\nCommit backend changes separately.", "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "repoMapQuery": "{{taskTitle}} {{taskDescription}}", - "repoMapFileLimit": 8, - "executionRole": "editor", - "architectPlan": "{{$ctx.getNodeOutput('plan-architecture')?.summary || $ctx.getNodeOutput('plan-architecture')?.output || ''}}" + "taskTitle": "{{taskTitle}}", + "branch": "{{branch}}", + "baseBranch": "{{baseBranch}}" }, "position": { "x": 400, - "y": 340 + "y": 310 }, "outputs": [ "default" ] }, { - "id": "implement-frontend", - "type": "action.run_agent", - "label": "Implement Frontend", + "id": "claim-task", + "type": "action.claim_task", + "label": "Claim Task", "config": { - "prompt": "## Phase: Frontend Implementation\n\nImplement the client-side / UI changes:\n- Components, pages, layouts\n- State management and API integration\n- Styling and responsive design\n- Component tests\n- Run build: {{buildCommand}}\n\nCommit frontend changes separately.", "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "repoMapQuery": "{{taskTitle}} {{taskDescription}}", - "repoMapFileLimit": 8, - "executionRole": "editor", - "architectPlan": "{{$ctx.getNodeOutput('plan-architecture')?.summary || $ctx.getNodeOutput('plan-architecture')?.output || ''}}" + "taskTitle": "{{taskTitle}}", + "ttlMinutes": "{{claimTtlMinutes}}", + "renewIntervalMs": "{{claimRenewIntervalMs}}", + "branch": "{{branch}}" }, "position": { "x": 400, - "y": 500 + "y": 440 }, "outputs": [ "default" ] }, { - "id": "integration-test", - "type": "action.run_agent", - "label": "Integration Test", + "id": "claim-ok", + "type": "condition.expression", + "label": "Claim Succeeded?", "config": { - "prompt": "## Phase: Integration Testing\n\nVerify the full stack works end-to-end:\n1. Run the full test suite: {{testCommand}}\n2. Run the build: {{buildCommand}}\n3. Run lint: {{lintCommand}}\n4. Fix any integration issues between frontend and backend\n5. Ensure all tests pass before completing\n\nPush all changes and create/update the PR.", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "repoMapQuery": "{{taskTitle}} {{taskDescription}}", - "repoMapFileLimit": 8, - "executionRole": "editor", - "architectPlan": "{{$ctx.getNodeOutput('plan-architecture')?.summary || $ctx.getNodeOutput('plan-architecture')?.output || ''}}" + "expression": "$ctx.getNodeOutput('claim-task')?.success === true" }, "position": { "x": 400, - "y": 660 + "y": 570 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "done", - "type": "notify.log", - "label": "Complete", + "id": "set-inprogress", + "type": "action.update_task_status", + "label": "Set In-Progress", "config": { - "message": "Fullstack task completed — all layers implemented and tested." + "taskId": "{{taskId}}", + "status": "inprogress", + "taskTitle": "{{taskTitle}}" }, "position": { - "x": 400, - "y": 820 + "x": 300, + "y": 700 }, "outputs": [ "default" ] - } - ], - "edges": [ - { - "id": "trigger->plan-architecture", - "source": "trigger", - "target": "plan-architecture", - "sourcePort": "default" - }, - { - "id": "plan-architecture->implement-backend", - "source": "plan-architecture", - "target": "implement-backend", - "sourcePort": "default" - }, - { - "id": "implement-backend->implement-frontend", - "source": "implement-backend", - "target": "implement-frontend", - "sourcePort": "default" }, { - "id": "implement-frontend->integration-test", - "source": "implement-frontend", - "target": "integration-test", - "sourcePort": "default" + "id": "acquire-worktree", + "type": "action.acquire_worktree", + "label": "Acquire Worktree", + "config": { + "repoRoot": "{{repoRoot}}", + "branch": "{{branch}}", + "taskId": "{{taskId}}", + "baseBranch": "{{baseBranch}}", + "defaultTargetBranch": "{{defaultTargetBranch}}" + }, + "position": { + "x": 300, + "y": 830 + }, + "outputs": [ + "default" + ] }, { - "id": "integration-test->done", - "source": "integration-test", - "target": "done", - "sourcePort": "default" - } - ] - }, - { - "id": "template-git-health-pipeline", - "name": "Git Health Pipeline", - "description": "Automated git health check pipeline. Uses Bosun functions for git status and branch info, runs the git-hot-files tool to identify churn hotspots, and dispatches a cleanup workflow if issues are found. Full Bosun-native orchestration pattern.", - "category": "mcp-integration", - "categoryLabel": "Mcp Integration", - "categoryIcon": ":settings:", - "categoryOrder": 99, - "tags": [ - "git", - "health", - "churn", - "tools", - "sub-workflow", - "automation" - ], - "nodeCount": 8, - "edgeCount": 7, - "recommended": false, - "enabled": true, - "trigger": "trigger.schedule", - "variables": { - "cleanupWorkflow": "template-health-check", - "churnThreshold": "10" - }, - "metadata": { - "author": "virtengine", - "tags": [ - "git", - "health", - "churn", - "tools", - "sub-workflow", - "automation" - ] - }, - "nodes": [ + "id": "worktree-ok", + "type": "condition.expression", + "label": "Worktree OK?", + "config": { + "expression": "$ctx.getNodeOutput('acquire-worktree')?.success === true" + }, + "position": { + "x": 300, + "y": 960 + }, + "outputs": [ + "yes", + "no" + ] + }, { - "id": "trigger", - "type": "trigger.schedule", - "label": "Scheduled", + "id": "resolve-executor", + "type": "action.resolve_executor", + "label": "Resolve Executor", "config": { - "cron": "0 6 * * 1" + "taskId": "{{taskId}}", + "taskTitle": "{{taskTitle}}", + "taskDescription": "{{taskDescription}}", + "repoRoot": "{{repoRoot}}", + "workspace": "{{workspace}}", + "defaultSdk": "{{defaultSdk}}" }, "position": { - "x": 100, - "y": 100 + "x": 200, + "y": 1090 }, "outputs": [ "default" ] }, { - "id": "git-status", - "type": "action.bosun_function", - "label": "Git Status", + "id": "record-head", + "type": "action.run_command", + "label": "Record HEAD", "config": { - "function": "git.status", - "outputVariable": "status" + "command": "git rev-parse HEAD", + "cwd": "{{worktreePath}}" }, "position": { - "x": 380, - "y": 100 + "x": 200, + "y": 1220 }, "outputs": [ "default" ] }, { - "id": "git-branch", - "type": "action.bosun_function", - "label": "Branch Info", + "id": "read-workflow-contract", + "type": "read-workflow-contract", + "label": "Read WORKFLOW.md", "config": { - "function": "git.branch", - "outputVariable": "branches" + "repoRoot": "{{repoRoot}}", + "worktreePath": "{{worktreePath}}" }, "position": { - "x": 660, - "y": 100 + "x": 200, + "y": 1350 }, "outputs": [ "default" ] }, { - "id": "git-log", - "type": "action.bosun_function", - "label": "Recent Commits", + "id": "workflow-contract-validation", + "type": "workflow-contract-validation", + "label": "Validate WORKFLOW.md", "config": { - "function": "git.log", - "args": { - "count": "20" - }, - "outputVariable": "recentCommits" + "repoRoot": "{{repoRoot}}", + "worktreePath": "{{worktreePath}}" }, "position": { - "x": 940, - "y": 100 + "x": 200, + "y": 1480 }, "outputs": [ "default" ] }, { - "id": "hot-files", - "type": "action.bosun_tool", - "label": "Churn Analysis", + "id": "build-prompt", + "type": "action.build_task_prompt", + "label": "Build Prompt", "config": { - "toolId": "git-hot-files", - "args": [ - "--days", - "30", - "--top", - "20" - ], - "parseJson": true, - "extract": { - "fields": { - "hotFiles": "[*].file", - "maxChurn": "[0].commits" - }, - "defaults": { - "hotFiles": [], - "maxChurn": 0 - }, - "types": { - "maxChurn": "number" - } - }, - "outputVariable": "churnData" + "taskId": "{{taskId}}", + "taskTitle": "{{taskTitle}}", + "taskDescription": "{{taskDescription}}", + "branch": "{{branch}}", + "baseBranch": "{{baseBranch}}", + "worktreePath": "{{worktreePath}}", + "repoRoot": "{{repoRoot}}", + "repoSlug": "{{repoSlug}}", + "workspace": "{{workspace}}", + "repository": "{{repository}}", + "repositories": "{{repositories}}" }, "position": { - "x": 1220, - "y": 100 + "x": 200, + "y": 1610 }, "outputs": [ "default" ] }, { - "id": "churn-check", - "type": "condition.expression", - "label": "High Churn?", + "id": "run-agent-plan", + "type": "action.run_agent", + "label": "Agent Plan", "config": { - "expression": "{{hot-files.maxChurn}} > {{churnThreshold}}" + "prompt": "{{_taskPrompt}}\n\nExecution phase: planning. Produce a concrete implementation plan and identify required tests. Do not make code changes in this phase.", + "taskId": "{{taskId}}", + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "delegationWatchdogTimeoutMs": "{{delegationWatchdogTimeoutMs}}", + "delegationWatchdogMaxRecoveries": "{{delegationWatchdogMaxRecoveries}}" }, "position": { - "x": 1500, - "y": 100 + "x": 200, + "y": 1740 }, "outputs": [ "default" ] }, { - "id": "dispatch-cleanup", - "type": "action.invoke_workflow", - "label": "Dispatch Cleanup", + "id": "run-agent-tests", + "type": "action.run_agent", + "label": "Agent Tests", "config": { - "workflowId": "{{cleanupWorkflow}}", - "input": { - "hotFiles": "{{hot-files.hotFiles}}", - "maxChurn": "{{hot-files.maxChurn}}", - "currentBranch": "{{git-branch.current}}", - "changedFiles": "{{git-status.changedFiles}}" - }, - "mode": "sync", - "failOnError": false + "prompt": "{{_taskPrompt}}\n\nExecution phase: tests. Write or update tests first for the target behavior, then validate failures/pass criteria before implementation changes.", + "taskId": "{{taskId}}", + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "delegationWatchdogTimeoutMs": "{{delegationWatchdogTimeoutMs}}", + "delegationWatchdogMaxRecoveries": "{{delegationWatchdogMaxRecoveries}}" }, "position": { - "x": 1780, - "y": 100 + "x": 200, + "y": 1545 }, "outputs": [ "default" ] }, { - "id": "log-healthy", - "type": "notify.log", - "label": "Healthy", + "id": "run-agent-implement", + "type": "action.run_agent", + "label": "Agent Implement", "config": { - "message": "Git health OK: branch={{git-branch.current}}, changed={{git-status.changedFiles}}, maxChurn={{hot-files.maxChurn}}", - "level": "info" + "prompt": "{{_taskPrompt}}\n\nExecution phase: implementation. Complete implementation after tests exist, run required verification (tests/lint/build), then commit, push, and create/update PR.", + "taskId": "{{taskId}}", + "sdk": "{{resolvedSdk}}", + "model": "{{resolvedModel}}", + "agentProfile": "{{agentProfile}}", + "cwd": "{{worktreePath}}", + "timeoutMs": "{{taskTimeoutMs}}", + "maxRetries": "{{maxRetries}}", + "maxContinues": "{{maxContinues}}", + "resolveMode": "library", + "failOnError": false, + "delegationWatchdogTimeoutMs": "{{delegationWatchdogTimeoutMs}}", + "delegationWatchdogMaxRecoveries": "{{delegationWatchdogMaxRecoveries}}" }, "position": { - "x": 2060, - "y": 100 + "x": 200, + "y": 1610 }, "outputs": [ "default" ] - } - ], - "edges": [ - { - "id": "trigger->git-status", - "source": "trigger", - "target": "git-status", - "sourcePort": "default" }, { - "id": "git-status->git-branch", - "source": "git-status", - "target": "git-branch", - "sourcePort": "default" + "id": "claim-stolen", + "type": "condition.expression", + "label": "Claim Stolen?", + "config": { + "expression": "$data._claimStolen === true" + }, + "position": { + "x": 200, + "y": 1610 + }, + "outputs": [ + "yes", + "no" + ] }, { - "id": "git-branch->git-log", - "source": "git-branch", - "target": "git-log", - "sourcePort": "default" + "id": "auto-commit-dirty", + "type": "action.auto_commit_dirty", + "label": "Auto Commit Dirty", + "config": { + "worktreePath": "{{worktreePath}}", + "taskId": "{{taskId}}" + }, + "position": { + "x": 120, + "y": 1680 + }, + "outputs": [ + "default" + ] }, { - "id": "git-log->hot-files", - "source": "git-log", - "target": "hot-files", - "sourcePort": "default" + "id": "detect-commits", + "type": "action.detect_new_commits", + "label": "Detect Commits", + "config": { + "worktreePath": "{{worktreePath}}", + "baseBranch": "{{baseBranch}}" + }, + "position": { + "x": 120, + "y": 1740 + }, + "outputs": [ + "default" + ] }, { - "id": "hot-files->churn-check", - "source": "hot-files", - "target": "churn-check", - "sourcePort": "default" + "id": "has-commits", + "type": "condition.expression", + "label": "Has Commits?", + "config": { + "expression": "$ctx.getNodeOutput('detect-commits')?.hasCommits === true" + }, + "position": { + "x": 120, + "y": 1870 + }, + "outputs": [ + "yes", + "no" + ] }, { - "id": "churn-check->dispatch-cleanup", - "source": "churn-check", - "target": "dispatch-cleanup", - "sourcePort": "true" + "id": "pre-pr-validation", + "type": "action.run_command", + "label": "Pre-PR Validation", + "config": { + "command": "{{prePrValidationCommand}}", + "commandType": "qualityGate", + "cwd": "{{worktreePath}}", + "failOnError": false + }, + "position": { + "x": -120, + "y": 1940 + }, + "outputs": [ + "default" + ] }, { - "id": "churn-check->log-healthy", - "source": "churn-check", - "target": "log-healthy", - "sourcePort": "false" - } - ] - }, - { - "id": "template-inline-workflow-composition", - "name": "Inline Workflow Composition", - "description": "Compose a parent workflow from embedded child workflows using action.inline_workflow. Demonstrates bounded sequential stages that stay inside the parent workflow while preserving child run/context boundaries and structured output handoff.", - "category": "mcp-integration", - "categoryLabel": "Mcp Integration", - "categoryIcon": ":settings:", - "categoryOrder": 99, - "tags": [ - "workflow", - "composition", - "inline", - "parent-workflow", - "embedded" - ], - "nodeCount": 5, - "edgeCount": 4, - "recommended": false, - "enabled": true, - "trigger": "trigger.manual", - "variables": { - "inputPayload": "{\"steps\":[\"lint\",\"test\",\"build\"],\"strict\":true}", - "defaultStageOwner": "bosun" - }, - "metadata": { - "author": "virtengine", - "tags": [ - "workflow", - "composition", - "inline", - "parent-workflow", - "embedded" - ] - }, - "nodes": [ + "id": "pre-pr-validation-ok", + "type": "condition.expression", + "label": "Validation Passed?", + "config": { + "expression": "(() => {const enabled = $data?.prePrValidationEnabled !== false;if (!enabled) return true;const out = $ctx.getNodeOutput('pre-pr-validation');if (!out) return false;if (out.success === true) return true;const code = Number(out.exitCode);return Number.isFinite(code) && code === 0;})()" + }, + "position": { + "x": -120, + "y": 2060 + }, + "outputs": [ + "yes", + "no" + ] + }, { - "id": "trigger", - "type": "trigger.manual", - "label": "Start", - "config": {}, + "id": "log-validation-failed", + "type": "notify.log", + "label": "Log Validation Failed", + "config": { + "message": "Task \"{{taskTitle}}\" ({{taskId}}) — pre-PR validation failed, returning to todo", + "level": "warn" + }, "position": { - "x": 100, - "y": 100 + "x": 300, + "y": 2000 }, "outputs": [ "default" ] }, { - "id": "inline-prepare", - "type": "action.inline_workflow", - "label": "Inline Prepare", + "id": "set-todo-validation-failed", + "type": "action.update_task_status", + "label": "Set Todo (Validation Fail)", "config": { - "mode": "sync", - "outputVariable": "inlinePrepareResult", - "input": { - "inputPayload": "{{inputPayload}}", - "defaultStageOwner": "{{defaultStageOwner}}" - }, - "workflow": { - "trigger": "trigger.workflow_call", - "nodes": [ - { - "id": "trigger", - "type": "trigger.workflow_call", - "label": "Inline Trigger", - "config": { - "inputs": { - "inputPayload": { - "type": "string", - "required": false - }, - "defaultStageOwner": { - "type": "string", - "required": false - } - } - } - }, - { - "id": "normalize-payload", - "type": "action.set_variable", - "label": "Normalize Payload", - "config": { - "key": "normalizedPayload", - "value": "(() => {const raw = $data?.inputPayload;if (raw && typeof raw === 'object') return raw;const text = String(raw || '').trim();if (!text) return { steps: [] };try { return JSON.parse(text); } catch { return { steps: [text] }; }})()", - "isExpression": true - } - }, - { - "id": "finish", - "type": "flow.end", - "label": "Finish Prepare", - "config": { - "status": "completed", - "output": { - "stageOwner": "{{defaultStageOwner}}", - "normalizedPayload": "{{$data?.normalizedPayload || { steps: [] }}}", - "stepCount": "{{$data?.normalizedPayload && Array.isArray($data.normalizedPayload.steps) ? $data.normalizedPayload.steps.length : 0}}" - } - } - } - ], - "edges": [ - { - "id": "e1", - "source": "trigger", - "target": "normalize-payload" - }, - { - "id": "e2", - "source": "normalize-payload", - "target": "finish" - } - ] - } + "taskId": "{{taskId}}", + "status": "todo", + "taskTitle": "{{taskTitle}}" }, "position": { - "x": 380, - "y": 100 + "x": 300, + "y": 2130 }, "outputs": [ "default" ] }, { - "id": "inline-plan", - "type": "action.inline_workflow", - "label": "Inline Stage Plan", + "id": "push-branch", + "type": "action.push_branch", + "label": "Push Branch", "config": { - "mode": "sync", - "outputVariable": "inlinePlanResult", - "input": { - "stageOwner": "{{$ctx.getNodeOutput('inline-prepare')?.stageOwner || $data?.defaultStageOwner || 'bosun'}}", - "normalizedPayload": "{{$ctx.getNodeOutput('inline-prepare')?.normalizedPayload || { steps: [] }}}" - }, - "workflow": { - "trigger": "trigger.workflow_call", - "nodes": [ - { - "id": "trigger", - "type": "trigger.workflow_call", - "label": "Inline Trigger", - "config": { - "inputs": { - "stageOwner": { - "type": "string", - "required": false - }, - "normalizedPayload": { - "type": "object", - "required": false - } - } - } - }, - { - "id": "build-plan", - "type": "action.set_variable", - "label": "Build Stage Plan", - "config": { - "key": "stagePlan", - "value": "(() => {const steps = Array.isArray($data?.normalizedPayload?.steps) ? $data.normalizedPayload.steps : [];return steps.map((step, index) => ({ index: index + 1, step: String(step || ''), owner: String($data?.stageOwner || 'bosun') }));})()", - "isExpression": true - } - }, - { - "id": "finish", - "type": "flow.end", - "label": "Finish Plan", - "config": { - "status": "completed", - "output": { - "stagePlan": "{{$data?.stagePlan || []}}", - "stageCount": "{{$data?.stagePlan?.length || 0}}" - } - } - } - ], - "edges": [ - { - "id": "e1", - "source": "trigger", - "target": "build-plan" - }, - { - "id": "e2", - "source": "build-plan", - "target": "finish" - } - ] - } + "worktreePath": "{{worktreePath}}", + "branch": "{{branch}}", + "baseBranch": "{{baseBranch}}", + "rebaseBeforePush": true, + "emptyDiffGuard": true, + "protectedBranches": "{{protectedBranches}}" }, "position": { - "x": 660, - "y": 100 + "x": 0, + "y": 2000 }, "outputs": [ "default" ] }, { - "id": "inline-summarize", - "type": "action.inline_workflow", - "label": "Inline Summary", + "id": "push-ok", + "type": "condition.expression", + "label": "Push OK?", "config": { - "mode": "sync", - "outputVariable": "inlineSummaryResult", - "input": { - "stagePlan": "{{$ctx.getNodeOutput('inline-plan')?.stagePlan || []}}", - "stepCount": "{{$ctx.getNodeOutput('inline-prepare')?.stepCount || 0}}" - }, - "workflow": { - "trigger": "trigger.workflow_call", - "nodes": [ - { - "id": "trigger", - "type": "trigger.workflow_call", - "label": "Inline Trigger", - "config": { - "inputs": { - "stagePlan": { - "type": "array", - "required": false - }, - "stepCount": { - "type": "number", - "required": false - } - } - } - }, - { - "id": "summarize", - "type": "action.set_variable", - "label": "Summarize Plan", - "config": { - "key": "summary", - "value": "(() => {const plan = Array.isArray($data?.stagePlan) ? $data.stagePlan : [];const labels = plan.map((entry) => String(entry.index) + ':' + String(entry.step || '')).join(', ');return { summaryMessage: 'Prepared ' + String(Number($data?.stepCount || 0)) + ' inline stage(s)' + (labels ? ' -> ' + labels : ''), plannedSteps: plan,};})()", - "isExpression": true - } - }, - { - "id": "finish", - "type": "flow.end", - "label": "Finish Summary", - "config": { - "status": "completed", - "output": "{{$data?.summary || { summaryMessage: 'Prepared 0 inline stage(s)', plannedSteps: [] }}}" - } - } - ], - "edges": [ - { - "id": "e1", - "source": "trigger", - "target": "summarize" - }, - { - "id": "e2", - "source": "summarize", - "target": "finish" - } - ] - } + "expression": "$ctx.getNodeOutput('push-branch')?.pushed === true" }, "position": { - "x": 940, - "y": 100 + "x": 0, + "y": 2130 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "log-summary", - "type": "notify.log", - "label": "Log Inline Summary", + "id": "create-pr", + "type": "action.create_pr", + "label": "Create PR", "config": { - "message": "{{inline-summarize.summaryMessage}}", - "level": "info" + "title": "{{taskTitle}}", + "body": "Task-ID: {{taskId}}\n\nAutomated PR for task {{taskId}}", + "base": "{{baseBranch}}", + "branch": "{{branch}}", + "cwd": "{{worktreePath}}", + "enableAutoMerge": "{{autoMergeOnCreate}}", + "autoMergeMethod": "{{autoMergeMethod}}" }, "position": { - "x": 1220, - "y": 100 + "x": 0, + "y": 2260 }, "outputs": [ "default" ] - } - ], - "edges": [ - { - "id": "trigger->inline-prepare", - "source": "trigger", - "target": "inline-prepare", - "sourcePort": "default" - }, - { - "id": "inline-prepare->inline-plan", - "source": "inline-prepare", - "target": "inline-plan", - "sourcePort": "default" }, { - "id": "inline-plan->inline-summarize", - "source": "inline-plan", - "target": "inline-summarize", - "sourcePort": "default" + "id": "pr-created", + "type": "condition.expression", + "label": "PR Linked?", + "config": { + "expression": "Boolean($ctx.getNodeOutput('create-pr')?.success === true && ($ctx.getNodeOutput('create-pr')?.prNumber || $ctx.getNodeOutput('create-pr')?.prUrl))" + }, + "position": { + "x": 0, + "y": 2325 + }, + "outputs": [ + "yes", + "no" + ] }, { - "id": "inline-summarize->log-summary", - "source": "inline-summarize", - "target": "log-summary", - "sourcePort": "default" - } - ] - }, - { - "id": "template-mcp-cross-server-pipeline", - "name": "MCP Cross-Server Pipeline", - "description": "Execute a multi-step pipeline that chains tools across different MCP servers. For example: GitHub PRs → extract data → Context7 docs lookup → aggregate results. Demonstrates action.mcp_pipeline with inputMap piping.", - "category": "mcp-integration", - "categoryLabel": "Mcp Integration", - "categoryIcon": ":settings:", - "categoryOrder": 99, - "tags": [ - "mcp", - "pipeline", - "cross-server", - "data-flow" - ], - "nodeCount": 3, - "edgeCount": 2, - "recommended": false, - "enabled": true, - "trigger": "trigger.manual", - "variables": { - "githubOwner": "virtengine", - "githubRepo": "bosun" - }, - "metadata": { - "author": "virtengine", - "tags": [ - "mcp", - "pipeline", - "cross-server", - "data-flow" - ] - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.manual", - "label": "Start Pipeline", - "config": {}, + "id": "set-inreview", + "type": "action.update_task_status", + "label": "Set In-Review", + "config": { + "taskId": "{{taskId}}", + "status": "inreview", + "taskTitle": "{{taskTitle}}" + }, "position": { - "x": 100, - "y": 100 + "x": 0, + "y": 2390 }, "outputs": [ "default" ] }, { - "id": "pipeline", - "type": "action.mcp_pipeline", - "label": "MCP Pipeline", + "id": "handoff-pr-progressor", + "type": "action.execute_workflow", + "label": "Handoff PR Progressor", "config": { - "outputVariable": "pipelineResult", - "steps": [ - { - "id": "get-prs", - "server": "github", - "tool": "list_pull_requests", - "input": { - "owner": "{{githubOwner}}", - "repo": "{{githubRepo}}", - "state": "open" - }, - "extract": { - "fields": { - "prCount": "length", - "firstPrTitle": "[0].title", - "firstPrBody": "[0].body" - }, - "types": { - "prCount": "number" - } - }, - "continueOnError": true - }, - { - "id": "lookup-docs", - "server": "context7", - "tool": "resolve-library-id", - "inputMap": { - "libraryName": { - "_literal": "express" - } - }, - "continueOnError": true - }, - { - "id": "search-web", - "server": "exa", - "tool": "web_search_exa", - "inputMap": { - "query": { - "_template": "{{githubRepo}} open pull requests best practices" - } - }, - "extract": { - "fields": { - "resultCount": "results.length", - "topResult": "results[0].title" - } - }, - "continueOnError": true - } - ] + "workflowId": "template-bosun-pr-progressor", + "mode": "dispatch", + "input": { + "taskId": "{{taskId}}", + "taskTitle": "{{taskTitle}}", + "branch": "{{branch}}", + "baseBranch": "{{baseBranch}}", + "prNumber": "{{$ctx.getNodeOutput('create-pr')?.prNumber ?? $data?.prNumber ?? null}}", + "prUrl": "{{$ctx.getNodeOutput('create-pr')?.prUrl || $data?.prUrl || ''}}", + "repo": "{{$ctx.getNodeOutput('create-pr')?.repoSlug || $data?.repo || $data?.repoSlug || $data?.repository || ''}}" + } }, "position": { - "x": 380, - "y": 100 + "x": -120, + "y": 2520 }, "outputs": [ "default" ] }, { - "id": "report", + "id": "log-success", "type": "notify.log", - "label": "Pipeline Report", + "label": "Log Success", "config": { - "message": "Pipeline complete: {{pipeline.completedSteps}}/{{pipeline.stepCount}} steps succeeded. Final output type: {{pipeline.finalOutput.contentType}}", + "message": "Task \"{{taskTitle}}\" ({{taskId}}) completed — PR created", "level": "info" }, "position": { - "x": 660, - "y": 100 + "x": -120, + "y": 2650 }, "outputs": [ "default" ] - } - ], - "edges": [ - { - "id": "trigger->pipeline", - "source": "trigger", - "target": "pipeline", - "sourcePort": "default" }, { - "id": "pipeline->report", - "source": "pipeline", - "target": "report", - "sourcePort": "default" - } - ] - }, - { - "id": "template-mcp-github-pr-monitor", - "name": "MCP GitHub PR Monitor", - "description": "Periodically fetches open PRs from GitHub via MCP, extracts PR metadata (titles, authors, labels, review status), routes based on PR count, and sends notifications. Demonstrates MCP → extract → condition → notify.", - "category": "mcp-integration", - "categoryLabel": "Mcp Integration", - "categoryIcon": ":settings:", - "categoryOrder": 99, - "tags": [ - "mcp", - "github", - "monitoring", - "pr" - ], - "nodeCount": 5, - "edgeCount": 4, - "recommended": false, - "enabled": true, - "trigger": "trigger.schedule", - "variables": { - "owner": "virtengine", - "repo": "bosun", - "checkInterval": "*/30 * * * *", - "prThreshold": 5 - }, - "metadata": { - "author": "virtengine", - "tags": [ - "mcp", - "github", - "monitoring", - "pr" - ] - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.schedule", - "label": "Check PRs", + "id": "log-no-commits", + "type": "notify.log", + "label": "Log No Commits", "config": { - "schedule": "{{checkInterval}}" + "message": "Task \"{{taskTitle}}\" ({{taskId}}) — no new commits, returning to todo", + "level": "warn" }, "position": { - "x": 100, - "y": 100 + "x": 350, + "y": 2000 }, "outputs": [ "default" ] }, { - "id": "fetch-prs", - "type": "action.mcp_tool_call", - "label": "Fetch Open PRs", + "id": "set-todo-cooldown", + "type": "action.update_task_status", + "label": "Set Todo (Cooldown)", "config": { - "server": "github", - "tool": "list_pull_requests", - "input": { - "owner": "{{owner}}", - "repo": "{{repo}}", - "state": "open" - }, - "outputVariable": "prData", - "extract": { - "fields": { - "prCount": "length", - "prTitles": "[*].title", - "prAuthors": "[*].user.login", - "prNumbers": "[*].number", - "oldestPr": "[0].created_at", - "newestPr": "[-1].created_at" - }, - "defaults": { - "prCount": 0, - "prTitles": [], - "prAuthors": [] - }, - "types": { - "prCount": "number", - "prTitles": "array", - "prAuthors": "array", - "prNumbers": "array" - } - }, - "portConfig": { - "field": "prCount", - "map": { - "0": "none" - }, - "default": "has_prs" - } + "taskId": "{{taskId}}", + "status": "todo", + "taskTitle": "{{taskTitle}}" }, "position": { - "x": 380, - "y": 100 + "x": 350, + "y": 2130 }, "outputs": [ "default" ] }, { - "id": "check-threshold", - "type": "condition.expression", - "label": "Too Many PRs?", + "id": "set-todo-push-failed", + "type": "action.update_task_status", + "label": "Set Todo (Push Fail)", "config": { - "expression": "$output.prCount >= $data.prThreshold" + "taskId": "{{taskId}}", + "status": "todo", + "taskTitle": "{{taskTitle}}" }, "position": { - "x": 660, - "y": 100 + "x": 180, + "y": 2260 }, "outputs": [ "default" ] }, { - "id": "log-normal", - "type": "notify.log", - "label": "PR Count Normal", + "id": "create-pr-retry", + "type": "action.create_pr", + "label": "Recover PR Link", "config": { - "message": "{{fetch-prs.prCount}} open PRs — within threshold", - "level": "info" + "title": "{{taskTitle}}", + "body": "Task-ID: {{taskId}}\n\nAutomated PR for task {{taskId}}", + "base": "{{baseBranch}}", + "branch": "{{branch}}", + "cwd": "{{worktreePath}}", + "failOnError": false, + "enableAutoMerge": "{{autoMergeOnCreate}}", + "autoMergeMethod": "{{autoMergeMethod}}" }, "position": { - "x": 940, - "y": 100 + "x": 400, + "y": 1740 }, "outputs": [ "default" ] }, { - "id": "alert-high", - "type": "notify.log", - "label": "PR Count High", + "id": "pr-created-stolen", + "type": "condition.expression", + "label": "PR Linked After Claim Loss?", "config": { - "message": "⚠️ {{fetch-prs.prCount}} open PRs (threshold: {{prThreshold}}). Authors: {{fetch-prs.prAuthors}}. Oldest: {{fetch-prs.oldestPr}}", - "level": "warn" + "expression": "Boolean($ctx.getNodeOutput('create-pr-retry')?.success === true && ($ctx.getNodeOutput('create-pr-retry')?.prNumber || $ctx.getNodeOutput('create-pr-retry')?.prUrl))" }, "position": { - "x": 1220, - "y": 100 + "x": 400, + "y": 1870 }, "outputs": [ - "default" + "yes", + "no" ] - } - ], - "edges": [ - { - "id": "trigger->fetch-prs", - "source": "trigger", - "target": "fetch-prs", - "sourcePort": "default" }, { - "id": "fetch-prs->check-threshold", - "source": "fetch-prs", - "target": "check-threshold", - "sourcePort": "default" - }, - { - "id": "check-threshold->log-normal", - "source": "check-threshold", - "target": "log-normal", - "sourcePort": "false" - }, - { - "id": "check-threshold->alert-high", - "source": "check-threshold", - "target": "alert-high", - "sourcePort": "true" - } - ] - }, - { - "id": "template-mcp-iterative-research", - "name": "MCP Iterative Research", - "description": "Accepts a list of topics, iterates over them, calls an MCP tool for each, extracts structured results, and aggregates everything. Shows how to combine loop.for_each with MCP tool calls for batch processing.", - "category": "mcp-integration", - "categoryLabel": "Mcp Integration", - "categoryIcon": ":settings:", - "categoryOrder": 99, - "tags": [ - "mcp", - "research", - "iteration", - "batch" - ], - "nodeCount": 6, - "edgeCount": 5, - "recommended": false, - "enabled": true, - "trigger": "trigger.workflow_call", - "variables": { - "topics": "[\"node.js best practices\", \"typescript generics\", \"vitest testing\"]", - "mcpServer": "context7", - "mcpTool": "resolve-library-id" - }, - "metadata": { - "author": "virtengine", - "tags": [ - "mcp", - "research", - "iteration", - "batch" - ] - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.workflow_call", - "label": "Research Request", - "config": {}, + "id": "set-inreview-stolen", + "type": "action.update_task_status", + "label": "Set In-Review (Recovered)", + "config": { + "taskId": "{{taskId}}", + "status": "inreview", + "taskTitle": "{{taskTitle}}" + }, "position": { - "x": 100, - "y": 100 + "x": 250, + "y": 2000 }, "outputs": [ "default" ] }, { - "id": "parse-topics", - "type": "transform.json_parse", - "label": "Parse Topics", + "id": "handoff-pr-progressor-stolen", + "type": "action.execute_workflow", + "label": "Handoff PR Progressor (Recovered)", "config": { - "value": "{{topics}}" + "workflowId": "template-bosun-pr-progressor", + "mode": "dispatch", + "input": { + "taskId": "{{taskId}}", + "taskTitle": "{{taskTitle}}", + "branch": "{{branch}}", + "baseBranch": "{{baseBranch}}", + "prNumber": "{{$ctx.getNodeOutput('create-pr-retry')?.prNumber ?? $data?.prNumber ?? null}}", + "prUrl": "{{$ctx.getNodeOutput('create-pr-retry')?.prUrl || $data?.prUrl || ''}}", + "repo": "{{$ctx.getNodeOutput('create-pr-retry')?.repoSlug || $data?.repo || $data?.repoSlug || $data?.repository || ''}}" + } }, "position": { - "x": 380, - "y": 100 + "x": 120, + "y": 2130 }, "outputs": [ "default" ] }, { - "id": "loop", - "type": "loop.for_each", - "label": "For Each Topic", + "id": "log-claim-stolen-recovered", + "type": "notify.log", + "label": "Log Claim Loss Recovery", "config": { - "items": "$data.parse_topics?.data || []", - "variable": "topic", - "maxIterations": 20 + "message": "Task \"{{taskTitle}}\" ({{taskId}}) — claim lost after PR link recovery, keeping inreview", + "level": "warn" }, "position": { - "x": 660, - "y": 100 + "x": 120, + "y": 2260 }, "outputs": [ "default" ] }, { - "id": "research", - "type": "action.mcp_tool_call", - "label": "Research Topic", + "id": "log-claim-stolen", + "type": "notify.log", + "label": "Log Claim Stolen", "config": { - "server": "{{mcpServer}}", - "tool": "{{mcpTool}}", - "input": { - "libraryName": "{{topic}}" - }, - "extract": { - "fields": { - "libraryId": "id", - "libraryName": "name", - "description": "description" - } - }, - "continueOnError": true + "message": "Task \"{{taskTitle}}\" ({{taskId}}) — claim was stolen, aborting", + "level": "warn" }, "position": { - "x": 940, - "y": 100 + "x": 550, + "y": 2000 }, "outputs": [ "default" ] }, { - "id": "aggregate", - "type": "transform.aggregate", - "label": "Aggregate Results", + "id": "set-todo-stolen", + "type": "action.update_task_status", + "label": "Set Todo (Stolen)", "config": { - "sources": [ - "research" - ] + "taskId": "{{taskId}}", + "status": "todo", + "taskTitle": "{{taskTitle}}" }, "position": { - "x": 1220, - "y": 100 + "x": 550, + "y": 2130 }, "outputs": [ "default" ] }, { - "id": "report", - "type": "notify.log", - "label": "Research Complete", + "id": "join-outcomes", + "type": "flow.join", + "label": "Join Outcome Paths", "config": { - "message": "Research pipeline completed. Topics processed: {{parse-topics.data.length}}", - "level": "info" + "mode": "all", + "sourceNodeIds": [ + "log-success", + "set-todo-push-failed", + "set-todo-cooldown", + "set-todo-validation-failed", + "set-todo-stolen", + "log-claim-stolen-recovered" + ], + "includeSkipped": true }, "position": { - "x": 1500, - "y": 100 + "x": 200, + "y": 2560 }, "outputs": [ "default" ] - } - ], - "edges": [ - { - "id": "trigger->parse-topics", - "source": "trigger", - "target": "parse-topics", - "sourcePort": "default" - }, - { - "id": "parse-topics->loop", - "source": "parse-topics", - "target": "loop", - "sourcePort": "default" - }, - { - "id": "loop->research", - "source": "loop", - "target": "research", - "sourcePort": "default" }, { - "id": "research->aggregate", - "source": "research", - "target": "aggregate", - "sourcePort": "default" + "id": "release-worktree", + "type": "action.release_worktree", + "label": "Release Worktree", + "config": { + "worktreePath": "{{worktreePath}}", + "repoRoot": "{{repoRoot}}", + "taskId": "{{taskId}}" + }, + "position": { + "x": 200, + "y": 2700 + }, + "outputs": [ + "default" + ] }, { - "id": "aggregate->report", - "source": "aggregate", - "target": "report", - "sourcePort": "default" - } - ] - }, - { - "id": "template-mcp-research-probe", - "name": "MCP Research Probe", - "description": "Called by another workflow to ask for user confirmation and open a PR with findings. Exercises workflow_call trigger, ask_user, create_pr, flow.end.", - "category": "coverage", - "categoryLabel": "Coverage", - "categoryIcon": ":settings:", - "categoryOrder": 99, - "tags": [ - "coverage", - "mcp", - "research" - ], - "nodeCount": 4, - "edgeCount": 3, - "recommended": false, - "enabled": true, - "trigger": "trigger.workflow_call", - "variables": { - "query": "express.js middleware", - "prBranch": "research/mcp-test", - "prBaseBranch": "main" - }, - "metadata": { - "author": "virtengine", - "tags": [ - "coverage", - "mcp", - "research" - ] - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.workflow_call", - "label": "Workflow Call Trigger", - "config": {}, + "id": "release-claim", + "type": "action.release_claim", + "label": "Release Claim", + "config": { + "taskId": "{{taskId}}" + }, "position": { - "x": 100, - "y": 100 + "x": 200, + "y": 2830 }, "outputs": [ "default" ] }, { - "id": "ask-user", - "type": "action.ask_user", - "label": "Ask User for Confirmation", + "id": "release-slot", + "type": "action.release_slot", + "label": "Release Slot", "config": { - "question": "Research complete. Proceed with PR?", - "outputVariable": "userConfirmation", - "continueOnError": true + "taskId": "{{taskId}}" }, "position": { - "x": 380, - "y": 100 + "x": 200, + "y": 2960 }, "outputs": [ "default" ] }, { - "id": "create-pr", - "type": "action.create_pr", - "label": "Create Research PR", + "id": "release-slot-claim-failed", + "type": "action.release_slot", + "label": "Release Slot (Claim Fail)", "config": { - "title": "research: {{query}}", - "branch": "{{prBranch}}", - "baseBranch": "{{prBaseBranch}}", - "continueOnError": true + "taskId": "{{taskId}}" }, "position": { - "x": 660, - "y": 100 + "x": 650, + "y": 700 }, "outputs": [ "default" ] }, { - "id": "done", - "type": "flow.end", - "label": "End", - "config": {}, + "id": "log-claim-failed", + "type": "notify.log", + "label": "Log Claim Failed", + "config": { + "message": "Task \"{{taskTitle}}\" ({{taskId}}) — already claimed, skipping", + "level": "info" + }, "position": { - "x": 940, - "y": 100 + "x": 650, + "y": 830 }, "outputs": [ "default" ] - } - ], - "edges": [ - { - "id": "trigger->ask-user", - "source": "trigger", - "target": "ask-user", - "sourcePort": "default" }, { - "id": "ask-user->create-pr", - "source": "ask-user", - "target": "create-pr", - "sourcePort": "default" + "id": "release-claim-wt-failed", + "type": "action.release_claim", + "label": "Release Claim (WT Fail)", + "config": { + "taskId": "{{taskId}}" + }, + "position": { + "x": 600, + "y": 1090 + }, + "outputs": [ + "default" + ] }, { - "id": "create-pr->done", - "source": "create-pr", - "target": "done", - "sourcePort": "default" - } - ] - }, - { - "id": "template-mcp-tool-chain", - "name": "MCP Tool Chain", - "description": "Chain MCP tools together with structured data extraction. Discovers available tools on a server, calls a selected tool, extracts specific data fields from the output, and forwards them to downstream nodes. Demonstrates the full MCP-to-workflow data piping pattern.", - "category": "mcp-integration", - "categoryLabel": "Mcp Integration", - "categoryIcon": ":settings:", - "categoryOrder": 99, - "tags": [ - "mcp", - "integration", - "pipeline", - "data-extraction" - ], - "nodeCount": 5, - "edgeCount": 4, - "recommended": false, - "enabled": true, - "trigger": "trigger.manual", - "variables": { - "mcpServer": "github", - "toolName": "list_pull_requests", - "toolInput": "{}" - }, - "metadata": { - "author": "virtengine", - "tags": [ - "mcp", - "integration", - "pipeline", - "data-extraction" - ] - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.manual", - "label": "Start", - "config": {}, + "id": "wt-failure-blocking", + "type": "condition.expression", + "label": "Non-Retryable WT Failure?", + "config": { + "expression": "$ctx.getNodeOutput('acquire-worktree')?.retryable === false" + }, "position": { - "x": 100, - "y": 100 + "x": 600, + "y": 1220 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "discover-tools", - "type": "action.mcp_list_tools", - "label": "Discover MCP Tools", + "id": "set-blocked-wt-failed", + "type": "action.update_task_status", + "label": "Set Blocked (WT Fail)", "config": { - "server": "{{mcpServer}}", - "outputVariable": "availableTools", - "includeSchemas": true + "taskId": "{{taskId}}", + "status": "blocked", + "taskTitle": "{{taskTitle}}" }, "position": { - "x": 380, - "y": 100 + "x": 470, + "y": 1350 }, "outputs": [ "default" ] }, { - "id": "call-tool", - "type": "action.mcp_tool_call", - "label": "Call MCP Tool", + "id": "annotate-blocked-wt-failed", + "type": "action.bosun_function", + "label": "Annotate Blocked (WT Fail)", "config": { - "server": "{{mcpServer}}", - "tool": "{{toolName}}", - "input": "{{toolInput}}", - "outputVariable": "toolResult", - "extract": { + "function": "tasks.update", + "args": { + "taskId": "{{taskId}}", "fields": { - "itemCount": "length", - "firstItem": "[0]", - "allTitles": "[*].title" - }, - "defaults": { - "itemCount": 0, - "firstItem": null, - "allTitles": [] - }, - "types": { - "itemCount": "number", - "allTitles": "array" + "cooldownUntil": "{{acquire-worktree.retryAt}}", + "blockedReason": "{{acquire-worktree.blockedReason}}", + "meta": "{{(() => { const current = ($data.taskMeta && typeof $data.taskMeta === 'object') ? $data.taskMeta : {}; const output = $ctx.getNodeOutput('acquire-worktree') || {}; return { ...current, autoRecovery: { active: true, reason: 'worktree_failure', failureKind: output.failureKind || 'branch_refresh_conflict', retryAt: output.retryAt || null, recoveryDelayMs: output.autoRecoverDelayMs || null, error: output.error || '', recordedAt: output.recordedAt || null }, worktreeFailure: { failureKind: output.failureKind || 'branch_refresh_conflict', retryable: output.retryable !== false, retryAt: output.retryAt || null, blockedReason: output.blockedReason || '', error: output.error || '', recordedAt: output.recordedAt || null, repairArtifacts: output.repairArtifacts || null } }; })()}}" } } }, "position": { - "x": 660, - "y": 100 + "x": 470, + "y": 1480 }, "outputs": [ "default" ] }, { - "id": "extract-data", - "type": "transform.mcp_extract", - "label": "Extract Data Points", + "id": "set-todo-wt-failed", + "type": "action.update_task_status", + "label": "Set Todo (WT Fail)", "config": { - "source": "call-tool", - "sourceField": "data", - "fields": { - "totalItems": "length", - "summary": "[0].title" - }, - "defaults": { - "totalItems": 0, - "summary": "No items found" - }, - "types": { - "totalItems": "number", - "summary": "string" - } + "taskId": "{{taskId}}", + "status": "todo", + "taskTitle": "{{taskTitle}}" }, "position": { - "x": 940, - "y": 100 + "x": 730, + "y": 1350 }, "outputs": [ "default" ] }, { - "id": "log-results", - "type": "notify.log", - "label": "Log Results", + "id": "release-slot-wt-failed", + "type": "action.release_slot", + "label": "Release Slot (WT Fail)", "config": { - "message": "MCP Pipeline: {{discover-tools.toolCount}} tools available, {{call-tool.itemCount}} items returned, first: {{extract-data.summary}}", - "level": "info" + "taskId": "{{taskId}}" }, "position": { - "x": 1220, - "y": 100 + "x": 600, + "y": 1480 }, "outputs": [ "default" ] - } - ], - "edges": [ - { - "id": "trigger->discover-tools", - "source": "trigger", - "target": "discover-tools", - "sourcePort": "default" - }, - { - "id": "discover-tools->call-tool", - "source": "discover-tools", - "target": "call-tool", - "sourcePort": "default" }, { - "id": "call-tool->extract-data", - "source": "call-tool", - "target": "extract-data", - "sourcePort": "default" + "id": "notify-wt-failed", + "type": "notify.telegram", + "label": "Notify WT Failed", + "config": { + "message": "⚠️ Worktree failed for \"{{taskTitle}}\" ({{taskId}}){{acquire-worktree.recoveryNote}}" + }, + "position": { + "x": 600, + "y": 1740 + }, + "outputs": [ + "default" + ] }, { - "id": "extract-data->log-results", - "source": "extract-data", - "target": "log-results", - "sourcePort": "default" - } - ] - }, - { - "id": "template-mcp-to-bosun-bridge", - "name": "MCP-to-Bosun Bridge", - "description": "Bridge external MCP tools with Bosun internal capabilities. Calls an MCP tool (e.g. GitHub), extracts structured data, creates Bosun tasks from the results, and optionally dispatches sub-workflows for each item. Full integration pattern: External Data → Internal Action → Workflow.", - "category": "mcp-integration", - "categoryLabel": "Mcp Integration", - "categoryIcon": ":settings:", - "categoryOrder": 99, - "tags": [ - "mcp", - "bosun", - "bridge", - "tasks", - "integration", - "orchestration" - ], - "nodeCount": 7, - "edgeCount": 7, - "recommended": false, - "enabled": true, - "trigger": "trigger.manual", - "variables": { - "mcpServer": "github", - "mcpTool": "list_pull_requests", - "mcpInput": "{}", - "processingWorkflow": "" - }, - "metadata": { - "author": "virtengine", - "tags": [ - "mcp", - "bosun", - "bridge", - "tasks", - "integration", - "orchestration" - ] - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.manual", - "label": "Start", - "config": {}, - "position": { - "x": 100, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "fetch-external", - "type": "action.mcp_tool_call", - "label": "Fetch External Data", + "id": "wt-retry-eligible", + "type": "condition.expression", + "label": "Retryable WT Failure?", "config": { - "server": "{{mcpServer}}", - "tool": "{{mcpTool}}", - "input": "{{mcpInput}}", - "outputVariable": "externalData", - "extract": { - "fields": { - "items": "[*]", - "totalCount": "length", - "firstTitle": "[0].title" - }, - "defaults": { - "items": [], - "totalCount": 0, - "firstTitle": "N/A" - }, - "types": { - "totalCount": "number" - } - } + "expression": "$ctx.getNodeOutput('acquire-worktree')?.retryable !== false" }, "position": { - "x": 380, - "y": 100 + "x": 850, + "y": 960 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "git-check", - "type": "action.bosun_function", - "label": "Check Git Status", + "id": "recover-worktree", + "type": "action.recover_worktree", + "label": "Clean Broken WT", "config": { - "function": "git.status", - "outputVariable": "gitStatus" + "repoRoot": "{{repoRoot}}", + "branch": "{{branch}}", + "taskId": "{{taskId}}" }, "position": { - "x": 660, - "y": 100 + "x": 850, + "y": 1090 }, "outputs": [ "default" ] }, { - "id": "create-task", - "type": "action.bosun_function", - "label": "Create Summary Task", + "id": "retry-acquire-wt", + "type": "action.acquire_worktree", + "label": "Retry Acquire WT", "config": { - "function": "tasks.create", - "args": { - "title": "External data: {{fetch-external.totalCount}} items from {{mcpServer}}/{{mcpTool}}", - "description": "First item: {{fetch-external.firstTitle}}. Git clean: {{git-check.clean}}", - "priority": "medium", - "labels": [ - "mcp-bridge", - "{{mcpServer}}" - ] - } + "repoRoot": "{{repoRoot}}", + "branch": "{{branch}}", + "taskId": "{{taskId}}", + "baseBranch": "{{baseBranch}}", + "defaultTargetBranch": "{{defaultTargetBranch}}" }, "position": { - "x": 940, - "y": 100 + "x": 850, + "y": 1220 }, "outputs": [ "default" ] }, { - "id": "has-processing-wf", + "id": "retry-wt-ok", "type": "condition.expression", - "label": "Has Processing Workflow?", - "config": { - "expression": "{{processingWorkflow}}" - }, - "position": { - "x": 1220, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "dispatch-processing", - "type": "action.invoke_workflow", - "label": "Dispatch Processing", + "label": "Retry WT OK?", "config": { - "workflowId": "{{processingWorkflow}}", - "input": { - "externalData": "{{fetch-external.data}}", - "itemCount": "{{fetch-external.totalCount}}", - "gitClean": "{{git-check.clean}}" - }, - "mode": "dispatch" + "expression": "$ctx.getNodeOutput('retry-acquire-wt')?.success === true" }, "position": { - "x": 1500, - "y": 100 + "x": 850, + "y": 1350 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "log-complete", - "type": "notify.log", - "label": "Bridge Complete", + "id": "sweep-task-wts", + "type": "action.sweep_task_worktrees", + "label": "Sweep Task WTs", "config": { - "message": "MCP-to-Bosun bridge: {{fetch-external.totalCount}} items fetched, task created, processing {{has-processing-wf.result}}", - "level": "info" + "repoRoot": "{{repoRoot}}", + "taskId": "{{taskId}}" }, "position": { - "x": 1780, - "y": 100 + "x": 200, + "y": 3090 }, "outputs": [ "default" @@ -21250,5687 +19810,477 @@ ], "edges": [ { - "id": "trigger->fetch-external", + "id": "trigger->check-slots", "source": "trigger", - "target": "fetch-external", + "target": "check-slots", "sourcePort": "default" }, { - "id": "fetch-external->git-check", - "source": "fetch-external", - "target": "git-check", - "sourcePort": "default" + "id": "check-slots->allocate-slot", + "source": "check-slots", + "target": "allocate-slot", + "sourcePort": "default", + "condition": "$output?.result === true" }, { - "id": "git-check->create-task", - "source": "git-check", - "target": "create-task", + "id": "allocate-slot->claim-task", + "source": "allocate-slot", + "target": "claim-task", "sourcePort": "default" }, { - "id": "create-task->has-processing-wf", - "source": "create-task", - "target": "has-processing-wf", + "id": "claim-task->claim-ok", + "source": "claim-task", + "target": "claim-ok", "sourcePort": "default" }, { - "id": "has-processing-wf->dispatch-processing", - "source": "has-processing-wf", - "target": "dispatch-processing", - "sourcePort": "true" + "id": "claim-ok->set-inprogress", + "source": "claim-ok", + "target": "set-inprogress", + "sourcePort": "yes", + "condition": "$output?.result === true" }, { - "id": "has-processing-wf->log-complete", - "source": "has-processing-wf", - "target": "log-complete", - "sourcePort": "false" + "id": "set-inprogress->acquire-worktree", + "source": "set-inprogress", + "target": "acquire-worktree", + "sourcePort": "default" }, { - "id": "dispatch-processing->log-complete", - "source": "dispatch-processing", - "target": "log-complete", + "id": "acquire-worktree->worktree-ok", + "source": "acquire-worktree", + "target": "worktree-ok", "sourcePort": "default" - } - ] - }, - { - "id": "template-pr-review-quality-striker", - "name": "PR Review Quality Striker", - "description": "Reactive PR quality workflow that responds to GitHub review activity, falls back to scheduled sweeps, pulls GitHub review comments, reviews, inline review comments, and quality-related checks, then dispatches a constrained repair agent against actionable findings.", - "category": "maintenance", - "categoryLabel": "Maintenance", - "categoryIcon": ":settings:", - "categoryOrder": 99, - "tags": [ - "maintenance", - "github", - "pr", - "review", - "quality", - "reactive" - ], - "nodeCount": 8, - "edgeCount": 7, - "recommended": false, - "enabled": true, - "trigger": "trigger.pr_event", - "variables": { - "repoScope": "auto", - "maxPrs": 12, - "intervalMs": 300000, - "trustedAuthors": "", - "allowTrustedFixes": false - }, - "metadata": { - "author": "bosun", - "version": 1, - "createdAt": "2026-03-27T00:00:00Z", - "templateVersion": "1.0.0", - "tags": [ - "maintenance", - "github", - "pr", - "review", - "quality", - "reactive" - ] - }, - "nodes": [ + }, { - "id": "trigger", - "type": "trigger.pr_event", - "label": "PR Review Activity", - "config": { - "event": "review_requested", - "events": [ - "review_requested", - "changes_requested", - "approved", - "opened" - ] - }, - "position": { - "x": 220, - "y": 50 - }, - "outputs": [ - "default" - ] + "id": "worktree-ok->resolve-executor", + "source": "worktree-ok", + "target": "resolve-executor", + "sourcePort": "yes", + "condition": "$output?.result === true" }, { - "id": "trigger-review-comment", - "type": "trigger.event", - "label": "PR Review Comment", - "config": { - "eventType": "github:pull_request_review_comment", - "filter": "['created','edited'].includes(String($event?.action || '').toLowerCase())" - }, - "position": { - "x": 420, - "y": 50 - }, - "outputs": [ - "default" - ] + "id": "resolve-executor->record-head", + "source": "resolve-executor", + "target": "record-head", + "sourcePort": "default" }, { - "id": "trigger-fallback", - "type": "trigger.schedule", - "label": "Poll PR Quality Signals", - "config": { - "intervalMs": "{{intervalMs}}" - }, - "position": { - "x": 620, - "y": 50 - }, - "outputs": [ - "default" - ] + "id": "record-head->read-workflow-contract", + "source": "record-head", + "target": "read-workflow-contract", + "sourcePort": "default" }, { - "id": "fetch-review-signals", - "type": "action.run_command", - "label": "Fetch Review Quality Signals", - "config": { - "command": "node", - "args": [ - "-e", - "const fs=require('fs'); const path=require('path'); const {execFileSync}=require('child_process'); const MAX_PRS=Math.max(1,Number('{{maxPrs}}')||12); const REPO_SCOPE=String('{{repoScope}}'||'auto').trim(); const TRUSTED_AUTHORS=new Set(String('{{trustedAuthors}}'||'').split(',').map((entry)=>entry.trim().toLowerCase()).filter(Boolean)); const ALLOW_TRUSTED_FIXES=String('{{allowTrustedFixes}}'||'false').trim().toLowerCase()==='true'; function runGh(args){return execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();} function parseJson(raw,fallback){try{return JSON.parse(raw||'')}catch{return fallback;}} function ghJson(args){return parseJson(runGh(args),[]);} function readLabelNames(pr){return Array.isArray(pr?.labels)?pr.labels.map((entry)=>typeof entry==='string'?entry:entry?.name).filter(Boolean):[];} function isBosunCreated(pr){return readLabelNames(pr).includes('bosun-pr-bosun-created');} function readAuthorLogin(pr){return String(pr?.author?.login||pr?.author?.name||'').trim().toLowerCase();} function configPath(){const home=String(process.env.BOSUN_HOME||process.env.BOSUN_PROJECT_DIR||'').trim();return home?path.join(home,'bosun.config.json'):path.join(process.cwd(),'bosun.config.json');} function readBosunConfig(){try{return JSON.parse(fs.readFileSync(configPath(),'utf8'));}catch{return {};}} function collectReposFromConfig(){const repos=[];try{const cfg=readBosunConfig();const workspaces=Array.isArray(cfg?.workspaces)?cfg.workspaces:[];if(workspaces.length>0){const active=String(cfg?.activeWorkspace||'').trim().toLowerCase();const activeWs=active?workspaces.find((ws)=>String(ws?.id||'').trim().toLowerCase()===active):null;const wsList=activeWs?[activeWs]:workspaces;for(const ws of wsList){for(const repo of (Array.isArray(ws?.repos)?ws.repos:[])){const slug=typeof repo==='string'?String(repo).trim():String(repo?.slug||'').trim();if(slug)repos.push(slug);}}}if(repos.length===0){for(const repo of (Array.isArray(cfg?.repos)?cfg.repos:[])){const slug=typeof repo==='string'?String(repo).trim():String(repo?.slug||'').trim();if(slug)repos.push(slug);}}}catch{}return repos;} function resolveRepoTargets(){if(REPO_SCOPE&&REPO_SCOPE!=='auto'&&REPO_SCOPE!=='current'){return [...new Set(REPO_SCOPE.split(',').map((entry)=>entry.trim()).filter(Boolean))];}if(REPO_SCOPE==='current')return [''];const fromConfig=collectReposFromConfig();if(fromConfig.length>0)return [...new Set(fromConfig)];const envRepo=String(process.env.GITHUB_REPOSITORY||'').trim();return envRepo?[envRepo]:[''];} function parseRepoFromUrl(url){const raw=String(url||'');const marker='github.com/';const idx=raw.toLowerCase().indexOf(marker);if(idx<0)return '';const tail=raw.slice(idx+marker.length).split('/');if(tail.length<2)return '';const owner=String(tail[0]||'').trim();const repo=String(tail[1]||'').trim();return owner&&repo?(owner+'/'+repo):'';} function isEligible(pr){const bosunCreated=isBosunCreated(pr);if(bosunCreated)return true;return ALLOW_TRUSTED_FIXES&&TRUSTED_AUTHORS.has(readAuthorLogin(pr));} const QUALITY_FAIL_STATES=new Set(['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE','FAIL']); const QUALITY_PENDING_STATES=new Set(['QUEUED','IN_PROGRESS','PENDING','WAITING','REQUESTED']); const SONAR_CHECK_RE=/(^|[^a-z])(sonarqube|sonarcloud|sonar)([^a-z]|$)/i; function readCheckName(check){return String(check?.name||check?.context||check?.workflowName||check?.displayTitle||'').trim();} function safeGhJson(args,fallback,runner){try{const invoke=typeof runner==='function'?runner:runGh;const out=invoke(args);return out?JSON.parse(out):fallback;}catch{return fallback;}} function truncateText(value,max){const text=String(value||'').replace(/\\r/g,'').trim();if(!text)return '';return text.length>max?text.slice(0,Math.max(0,max-19))+'\\n...[truncated]':text;} function compactUser(user){const login=String(user?.login||user?.name||'').trim();return login?{login,url:String(user?.url||user?.html_url||'').trim()||null}:null;} function compactCheck(check){const name=readCheckName(check);const state=String(check?.state||check?.conclusion||'').trim().toUpperCase();const bucket=String(check?.bucket||'').trim().toUpperCase();if(!name&&!state&&!bucket)return null;return {name:name||null,state:state||null,bucket:bucket||null,workflow:String(check?.workflowName||'').trim()||null};} function compactIssueComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactReview(review){return {id:Number(review?.id||0)||null,author:compactUser(review?.user||review?.author),state:String(review?.state||'').trim()||null,submittedAt:String(review?.submitted_at||review?.submittedAt||'').trim()||null,body:truncateText(review?.body,1200)};} function compactReviewComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),path:String(comment?.path||'').trim()||null,line:Number(comment?.line||0)||Number(comment?.original_line||0)||null,side:String(comment?.side||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactFile(file){const filePath=String(file?.filename||file?.path||'').trim();return filePath?{path:filePath,status:String(file?.status||'').trim()||null,additions:Number(file?.additions||0)||0,deletions:Number(file?.deletions||0)||0,changes:Number(file?.changes||0)||0}:null;} function collectPrDigest(repo,number,fallback,runner){const pr=safeGhJson(['pr','view',String(number),'--repo',repo,'--json','number,title,body,url,headRefName,baseRefName,isDraft,mergeable,statusCheckRollup,author,labels,reviewDecision'],{},runner);const issueComments=safeGhJson(['api','repos/'+repo+'/issues/'+number+'/comments?per_page=100'],[],runner).map(compactIssueComment).slice(0,40);const reviews=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/reviews?per_page=100'],[],runner).map(compactReview).slice(0,40);const reviewComments=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/comments?per_page=100'],[],runner).map(compactReviewComment).slice(0,60);const files=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/files?per_page=100'],[],runner).map(compactFile).filter(Boolean).slice(0,80);const requested=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/requested_reviewers'],{},runner);const requestedReviewers=[...(Array.isArray(requested?.users)?requested.users:[]).map(compactUser),...(Array.isArray(requested?.teams)?requested.teams:[]).map((team)=>{const slug=String(team?.slug||team?.name||'').trim();return slug?{team:slug,url:String(team?.html_url||team?.url||'').trim()||null}:null;})].filter(Boolean);const checks=(Array.isArray(pr?.statusCheckRollup)?pr.statusCheckRollup:[]).map(compactCheck).filter(Boolean);const labels=(Array.isArray(pr?.labels)?pr.labels:[]).map((label)=>String(label?.name||label||'').trim()).filter(Boolean);const failingChecks=checks.filter((check)=>QUALITY_FAIL_STATES.has(String(check?.state||'').toUpperCase())||QUALITY_FAIL_STATES.has(String(check?.bucket||'').toUpperCase()));const pendingChecks=checks.filter((check)=>QUALITY_PENDING_STATES.has(String(check?.state||'').toUpperCase()));const digestSummary=['PR #'+String(pr?.number||number)+' '+String(pr?.title||fallback?.title||''),'repo='+repo+' branch='+(String(pr?.headRefName||fallback?.branch||'').trim()||'unknown'),'checks='+checks.length+' fail='+failingChecks.length+' pending='+pendingChecks.length,'comments='+issueComments.length+' reviews='+reviews.length+' reviewComments='+reviewComments.length+' files='+files.length,labels.length?'labels='+labels.join(', '):''].filter(Boolean).join('\\n');return {core:{number:Number(pr?.number||number)||number,title:String(pr?.title||fallback?.title||''),url:String(pr?.url||fallback?.url||'').trim()||null,body:truncateText(pr?.body,4000),branch:String(pr?.headRefName||fallback?.branch||'').trim()||null,baseBranch:String(pr?.baseRefName||fallback?.base||'').trim()||null,isDraft:pr?.isDraft===true,mergeable:String(pr?.mergeable||'').trim()||null,author:compactUser(pr?.author),reviewDecision:String(pr?.reviewDecision||'').trim()||null},labels,requestedReviewers,checks,ciSummary:{total:checks.length,failing:failingChecks.length,pending:pendingChecks.length,passing:Math.max(0,checks.length-failingChecks.length-pendingChecks.length)},issueComments,reviews,reviewComments,files,digestSummary};} function isActionableText(value){const text=String(value||'').trim();if(!text)return false;return /(fix|please|should|must|needs?|issue|bug|error|warning|sonar|lint|review|nit|suggest|change|request|fail)/i.test(text);} function collectActionableReviewSignals(prDigest){const digest=prDigest&&typeof prDigest==='object'?prDigest:{};const reviewComments=Array.isArray(digest.reviewComments)?digest.reviewComments:[];const reviews=Array.isArray(digest.reviews)?digest.reviews:[];const issueComments=Array.isArray(digest.issueComments)?digest.issueComments:[];const checks=Array.isArray(digest.checks)?digest.checks:[];const commentFindings=[];for(const comment of reviewComments){if(!isActionableText(comment?.body))continue;commentFindings.push({kind:'review_comment',path:String(comment?.path||'').trim()||null,line:Number(comment?.line||0)||null,author:String(comment?.author?.login||'').trim()||null,body:String(comment?.body||'').trim(),url:String(comment?.url||'').trim()||null});}for(const review of reviews){const state=String(review?.state||'').trim().toUpperCase();if(state!=='CHANGES_REQUESTED'&&!isActionableText(review?.body))continue;commentFindings.push({kind:'review',state:state||null,author:String(review?.author?.login||'').trim()||null,body:String(review?.body||'').trim(),url:String(review?.url||'').trim()||null});}for(const comment of issueComments){if(!isActionableText(comment?.body))continue;commentFindings.push({kind:'issue_comment',author:String(comment?.author?.login||'').trim()||null,body:String(comment?.body||'').trim(),url:String(comment?.url||'').trim()||null});}const failingChecks=checks.filter((check)=>QUALITY_FAIL_STATES.has(String(check?.state||'').toUpperCase())||QUALITY_FAIL_STATES.has(String(check?.bucket||'').toUpperCase()));const sonarChecks=failingChecks.filter((check)=>SONAR_CHECK_RE.test(String(readCheckName(check)||'')));const qualityChecks=failingChecks.map((check)=>({name:readCheckName(check),state:String(check?.state||check?.bucket||'').trim()||null,workflow:String(check?.workflow||'').trim()||null}));const summary=['commentFindings='+commentFindings.length,'qualityChecks='+qualityChecks.length,sonarChecks.length?'sonarChecks='+sonarChecks.length:''].filter(Boolean).join(' ');return {commentFindings,qualityChecks,sonarChecks,summary};} const DIRECT_PR_NUMBER=Number('{{prNumber}}')||0; const DIRECT_PR_URL=String('{{prUrl}}'||'').trim(); const DIRECT_REPO=String('{{repo}}'||'{{repoSlug}}'||'{{repository}}'||'').trim()||parseRepoFromUrl(DIRECT_PR_URL); const DIRECT_BRANCH=String('{{branch}}'||'').trim(); const DIRECT_BASE=String('{{baseBranch}}'||'').trim(); const DIRECT_EVENT=String('{{prEvent}}'||'').trim().toLowerCase(); const actionables=[]; function appendActionable(repo,prNumber,fallback,sourceKind){const number=Number(prNumber)||0;if(!repo||!number)return false;const prDigest=collectPrDigest(repo,number,fallback,runGh);if(prDigest?.core?.isDraft===true)return false;if(!isEligible({author:prDigest?.core?.author,labels:prDigest?.labels,body:prDigest?.core?.body,title:prDigest?.core?.title}))return false;const signals=collectActionableReviewSignals(prDigest);if(signals.commentFindings.length===0&&signals.qualityChecks.length===0)return false;actionables.push({repo,number,branch:String(prDigest?.core?.branch||fallback?.branch||'').trim(),base:String(prDigest?.core?.baseBranch||fallback?.base||'').trim(),url:String(prDigest?.core?.url||fallback?.url||'').trim(),title:String(prDigest?.core?.title||fallback?.title||'').trim(),sourceKind,prEvent:DIRECT_EVENT||null,commentFindings:signals.commentFindings,qualityChecks:signals.qualityChecks,sonarChecks:signals.sonarChecks,summary:signals.summary,digestSummary:prDigest.digestSummary,prDigest});return true;} let total=0; if(DIRECT_REPO&&DIRECT_PR_NUMBER>0){total=1;appendActionable(DIRECT_REPO,DIRECT_PR_NUMBER,{branch:DIRECT_BRANCH,base:DIRECT_BASE,url:DIRECT_PR_URL},'event');}else{const prs=[];for(const target of resolveRepoTargets()){const repo=String(target||'').trim();const args=['pr','list','--state','open','--json','number,title,body,author,headRefName,baseRefName,isDraft,statusCheckRollup,labels,url','--limit',String(MAX_PRS)];if(repo)args.push('--repo',repo);try{const list=ghJson(args);for(const pr of (Array.isArray(list)?list:[])){prs.push({...pr,__repo:repo||parseRepoFromUrl(pr?.url)});}}catch{}}total=prs.length;for(const pr of prs){if(pr?.isDraft===true)continue;if(!isEligible(pr))continue;const repo=String(pr?.__repo||'').trim();if(!repo)continue;if(appendActionable(repo,pr.number,{branch:pr.headRefName,base:pr.baseRefName,title:pr.title,url:pr.url},'schedule')&&actionables.length>=5)break;}} console.log(JSON.stringify({total,actionableCount:actionables.length,mode:DIRECT_REPO&&DIRECT_PR_NUMBER>0?'event':'schedule',actionables}));" - ], - "continueOnError": false, - "failOnError": true - }, - "position": { - "x": 420, - "y": 210 - }, - "outputs": [ - "default" - ] + "id": "read-workflow-contract->workflow-contract-validation", + "source": "read-workflow-contract", + "target": "workflow-contract-validation", + "sourcePort": "default" }, { - "id": "has-review-work", - "type": "condition.expression", - "label": "Actionable Review Signals?", - "config": { - "expression": "(()=>{try{const raw=$ctx.getNodeOutput('fetch-review-signals')?.output||'{}';return (JSON.parse(raw).actionableCount||0)>0;}catch{return false;}})()" - }, - "position": { - "x": 420, - "y": 370 - }, - "outputs": [ - "yes", - "no" - ] + "id": "workflow-contract-validation->build-prompt", + "source": "workflow-contract-validation", + "target": "build-prompt", + "sourcePort": "default" }, { - "id": "run-review-striker", - "type": "action.run_agent", - "label": "Repair PR Quality Findings", - "config": { - "sdk": "auto", - "timeoutMs": 1800000, - "prompt": "You are a Bosun PR quality repair agent. Work only the PRs in this JSON:\n\n{{$ctx.getNodeOutput('fetch-review-signals')?.output}}\n\nEach item contains prDigest with the PR body, files, issue comments, reviews, review comments, and checks. Address only the listed commentFindings and qualityChecks on the existing PR branch. Make the smallest safe code change, run targeted validation, and push updates to the same PR branch.\n\nSTRICT RULES:\n- Focus on actionable review feedback and failing quality checks only.\n- Do not create a new PR, close the PR, or perform unrelated cleanup.\n- Prioritize commentFindings before generic lint or static-analysis cleanup.\n- Preserve runtime behavior unless a reviewer-requested fix requires otherwise.\n- If a check is listed but the cause is unclear, inspect the relevant file paths from prDigest.files and the referenced review comment paths before editing." - }, - "position": { - "x": 220, - "y": 540 - }, - "outputs": [ - "default" - ] + "id": "build-prompt->run-agent-plan", + "source": "build-prompt", + "target": "run-agent-plan", + "sourcePort": "default" }, { - "id": "log-review-idle", - "type": "notify.log", - "label": "No Review Work", - "config": { - "message": "PR Review Quality Striker found no actionable review or quality findings.", - "level": "info" - }, - "position": { - "x": 620, - "y": 540 - }, - "outputs": [ - "default" - ] + "id": "run-agent-plan->run-agent-tests", + "source": "run-agent-plan", + "target": "run-agent-tests", + "sourcePort": "default" }, { - "id": "notify-review-run", - "type": "notify.log", - "label": "Log Review Dispatch", - "config": { - "message": "PR Review Quality Striker dispatched remediation for actionable GitHub review signals.", - "level": "info" - }, - "position": { - "x": 220, - "y": 700 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ + "id": "run-agent-tests->run-agent-implement", + "source": "run-agent-tests", + "target": "run-agent-implement", + "sourcePort": "default" + }, { - "id": "trigger->fetch-review-signals", - "source": "trigger", - "target": "fetch-review-signals", + "id": "run-agent-implement->claim-stolen", + "source": "run-agent-implement", + "target": "claim-stolen", "sourcePort": "default" }, { - "id": "trigger-review-comment->fetch-review-signals", - "source": "trigger-review-comment", - "target": "fetch-review-signals", + "id": "claim-stolen->auto-commit-dirty", + "source": "claim-stolen", + "target": "auto-commit-dirty", + "sourcePort": "no", + "condition": "$output?.result !== true" + }, + { + "id": "auto-commit-dirty->detect-commits", + "source": "auto-commit-dirty", + "target": "detect-commits", "sourcePort": "default" }, { - "id": "trigger-fallback->fetch-review-signals", - "source": "trigger-fallback", - "target": "fetch-review-signals", + "id": "detect-commits->has-commits", + "source": "detect-commits", + "target": "has-commits", "sourcePort": "default" }, { - "id": "fetch-review-signals->has-review-work", - "source": "fetch-review-signals", - "target": "has-review-work", + "id": "has-commits->pre-pr-validation", + "source": "has-commits", + "target": "pre-pr-validation", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "pre-pr-validation->pre-pr-validation-ok", + "source": "pre-pr-validation", + "target": "pre-pr-validation-ok", "sourcePort": "default" }, { - "id": "has-review-work->run-review-striker", - "source": "has-review-work", - "target": "run-review-striker", + "id": "pre-pr-validation-ok->push-branch", + "source": "pre-pr-validation-ok", + "target": "push-branch", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "has-review-work->log-review-idle", - "source": "has-review-work", - "target": "log-review-idle", + "id": "pre-pr-validation-ok->log-validation-failed", + "source": "pre-pr-validation-ok", + "target": "log-validation-failed", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "run-review-striker->notify-review-run", - "source": "run-review-striker", - "target": "notify-review-run", + "id": "log-validation-failed->set-todo-validation-failed", + "source": "log-validation-failed", + "target": "set-todo-validation-failed", "sourcePort": "default" - } - ] - }, - { - "id": "template-scheduled-maintenance", - "name": "Scheduled Maintenance", - "description": "Runs a one-time maintenance window: reads config, waits, acquires a worktree through a safety gate, performs work, then releases. Exercises scheduled_once, read_file, delay, flow.gate, acquire/release_worktree.", - "category": "coverage", - "categoryLabel": "Coverage", - "categoryIcon": ":settings:", - "categoryOrder": 99, - "tags": [ - "coverage", - "maintenance", - "worktree" - ], - "nodeCount": 7, - "edgeCount": 6, - "recommended": false, - "enabled": true, - "trigger": "trigger.scheduled_once", - "variables": { - "taskId": "MAINT-01", - "maintenanceConfigPath": "/nonexistent/maintenance.json", - "targetBranch": "feat/maintenance-test", - "baseBranch": "origin/main" - }, - "metadata": { - "author": "virtengine", - "tags": [ - "coverage", - "maintenance", - "worktree" - ] - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.scheduled_once", - "label": "Scheduled Trigger", - "config": { - "runAt": "2020-01-01T00:00:00Z" - }, - "position": { - "x": 100, - "y": 100 - }, - "outputs": [ - "default" - ] }, { - "id": "read-config", - "type": "action.read_file", - "label": "Read Config", - "config": { - "path": "{{maintenanceConfigPath}}", - "continueOnError": true - }, - "position": { - "x": 380, - "y": 100 - }, - "outputs": [ - "default" - ] + "id": "set-todo-validation-failed->join-outcomes", + "source": "set-todo-validation-failed", + "target": "join-outcomes", + "sourcePort": "default" }, { - "id": "wait", - "type": "action.delay", - "label": "Short Delay", - "config": { - "ms": 1 - }, - "position": { - "x": 660, - "y": 100 - }, - "outputs": [ - "default" - ] + "id": "push-branch->push-ok", + "source": "push-branch", + "target": "push-ok", + "sourcePort": "default" }, { - "id": "safety-gate", - "type": "flow.gate", - "label": "Safety Gate", - "config": { - "mode": "timeout", - "timeoutMs": 1, - "reason": "maintenance safety gate" - }, - "position": { - "x": 940, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "acquire", - "type": "action.acquire_worktree", - "label": "Acquire Worktree", - "config": { - "branch": "{{targetBranch}}", - "baseBranch": "{{baseBranch}}", - "taskId": "{{taskId}}", - "continueOnError": true - }, - "position": { - "x": 1220, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "release", - "type": "action.release_worktree", - "label": "Release Worktree", - "config": { - "continueOnError": true - }, - "position": { - "x": 1500, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "done", - "type": "notify.log", - "label": "Maintenance Done", - "config": { - "message": "Maintenance complete", - "level": "info" - }, - "position": { - "x": 1780, - "y": 100 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->read-config", - "source": "trigger", - "target": "read-config", - "sourcePort": "default" - }, - { - "id": "read-config->wait", - "source": "read-config", - "target": "wait", - "sourcePort": "default" - }, - { - "id": "wait->safety-gate", - "source": "wait", - "target": "safety-gate", - "sourcePort": "default" - }, - { - "id": "safety-gate->acquire", - "source": "safety-gate", - "target": "acquire", - "sourcePort": "default" - }, - { - "id": "acquire->release", - "source": "acquire", - "target": "release", - "sourcePort": "default" - }, - { - "id": "release->done", - "source": "release", - "target": "done", - "sourcePort": "default" - } - ] - }, - { - "id": "template-sonarqube-pr-striker", - "name": "SonarQube PR Striker", - "description": "Scheduled PR quality workflow that detects failing SonarQube or SonarCloud checks through GitHub-native status checks, enriches them with the same compact PR digest used by Bosun's PR workflows, and dispatches a constrained static-analysis remediation agent.", - "category": "maintenance", - "categoryLabel": "Maintenance", - "categoryIcon": ":settings:", - "categoryOrder": 99, - "tags": [ - "maintenance", - "sonarqube", - "sonarcloud", - "pr", - "quality" - ], - "nodeCount": 6, - "edgeCount": 5, - "recommended": false, - "enabled": true, - "trigger": "trigger.schedule", - "variables": { - "repoScope": "auto", - "maxPrs": 12, - "intervalMs": 600000, - "trustedAuthors": "", - "allowTrustedFixes": false - }, - "metadata": { - "author": "bosun", - "version": 1, - "createdAt": "2026-03-27T00:00:00Z", - "templateVersion": "1.0.0", - "tags": [ - "maintenance", - "sonarqube", - "sonarcloud", - "pr", - "quality" - ] - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.schedule", - "label": "Poll Sonar Signals", - "config": { - "intervalMs": "{{intervalMs}}" - }, - "position": { - "x": 420, - "y": 50 - }, - "outputs": [ - "default" - ] - }, - { - "id": "fetch-sonar-signals", - "type": "action.run_command", - "label": "Fetch SonarQube Signals", - "config": { - "command": "node", - "args": [ - "-e", - "const fs=require('fs'); const path=require('path'); const {execFileSync}=require('child_process'); const MAX_PRS=Math.max(1,Number('{{maxPrs}}')||12); const REPO_SCOPE=String('{{repoScope}}'||'auto').trim(); const TRUSTED_AUTHORS=new Set(String('{{trustedAuthors}}'||'').split(',').map((entry)=>entry.trim().toLowerCase()).filter(Boolean)); const ALLOW_TRUSTED_FIXES=String('{{allowTrustedFixes}}'||'false').trim().toLowerCase()==='true'; function runGh(args){return execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();} function parseJson(raw,fallback){try{return JSON.parse(raw||'')}catch{return fallback;}} function ghJson(args){return parseJson(runGh(args),[]);} function readLabelNames(pr){return Array.isArray(pr?.labels)?pr.labels.map((entry)=>typeof entry==='string'?entry:entry?.name).filter(Boolean):[];} function isBosunCreated(pr){return readLabelNames(pr).includes('bosun-pr-bosun-created');} function readAuthorLogin(pr){return String(pr?.author?.login||pr?.author?.name||'').trim().toLowerCase();} function configPath(){const home=String(process.env.BOSUN_HOME||process.env.BOSUN_PROJECT_DIR||'').trim();return home?path.join(home,'bosun.config.json'):path.join(process.cwd(),'bosun.config.json');} function readBosunConfig(){try{return JSON.parse(fs.readFileSync(configPath(),'utf8'));}catch{return {};}} function collectReposFromConfig(){const repos=[];try{const cfg=readBosunConfig();const workspaces=Array.isArray(cfg?.workspaces)?cfg.workspaces:[];if(workspaces.length>0){const active=String(cfg?.activeWorkspace||'').trim().toLowerCase();const activeWs=active?workspaces.find((ws)=>String(ws?.id||'').trim().toLowerCase()===active):null;const wsList=activeWs?[activeWs]:workspaces;for(const ws of wsList){for(const repo of (Array.isArray(ws?.repos)?ws.repos:[])){const slug=typeof repo==='string'?String(repo).trim():String(repo?.slug||'').trim();if(slug)repos.push(slug);}}}if(repos.length===0){for(const repo of (Array.isArray(cfg?.repos)?cfg.repos:[])){const slug=typeof repo==='string'?String(repo).trim():String(repo?.slug||'').trim();if(slug)repos.push(slug);}}}catch{}return repos;} function resolveRepoTargets(){if(REPO_SCOPE&&REPO_SCOPE!=='auto'&&REPO_SCOPE!=='current'){return [...new Set(REPO_SCOPE.split(',').map((entry)=>entry.trim()).filter(Boolean))];}if(REPO_SCOPE==='current')return [''];const fromConfig=collectReposFromConfig();if(fromConfig.length>0)return [...new Set(fromConfig)];const envRepo=String(process.env.GITHUB_REPOSITORY||'').trim();return envRepo?[envRepo]:[''];} function parseRepoFromUrl(url){const raw=String(url||'');const marker='github.com/';const idx=raw.toLowerCase().indexOf(marker);if(idx<0)return '';const tail=raw.slice(idx+marker.length).split('/');if(tail.length<2)return '';const owner=String(tail[0]||'').trim();const repo=String(tail[1]||'').trim();return owner&&repo?(owner+'/'+repo):'';} function isEligible(pr){const bosunCreated=isBosunCreated(pr);if(bosunCreated)return true;return ALLOW_TRUSTED_FIXES&&TRUSTED_AUTHORS.has(readAuthorLogin(pr));} const QUALITY_FAIL_STATES=new Set(['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE','FAIL']); const QUALITY_PENDING_STATES=new Set(['QUEUED','IN_PROGRESS','PENDING','WAITING','REQUESTED']); const SONAR_CHECK_RE=/(^|[^a-z])(sonarqube|sonarcloud|sonar)([^a-z]|$)/i; function readCheckName(check){return String(check?.name||check?.context||check?.workflowName||check?.displayTitle||'').trim();} function safeGhJson(args,fallback,runner){try{const invoke=typeof runner==='function'?runner:runGh;const out=invoke(args);return out?JSON.parse(out):fallback;}catch{return fallback;}} function truncateText(value,max){const text=String(value||'').replace(/\\r/g,'').trim();if(!text)return '';return text.length>max?text.slice(0,Math.max(0,max-19))+'\\n...[truncated]':text;} function compactUser(user){const login=String(user?.login||user?.name||'').trim();return login?{login,url:String(user?.url||user?.html_url||'').trim()||null}:null;} function compactCheck(check){const name=readCheckName(check);const state=String(check?.state||check?.conclusion||'').trim().toUpperCase();const bucket=String(check?.bucket||'').trim().toUpperCase();if(!name&&!state&&!bucket)return null;return {name:name||null,state:state||null,bucket:bucket||null,workflow:String(check?.workflowName||'').trim()||null};} function compactIssueComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactReview(review){return {id:Number(review?.id||0)||null,author:compactUser(review?.user||review?.author),state:String(review?.state||'').trim()||null,submittedAt:String(review?.submitted_at||review?.submittedAt||'').trim()||null,body:truncateText(review?.body,1200)};} function compactReviewComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),path:String(comment?.path||'').trim()||null,line:Number(comment?.line||0)||Number(comment?.original_line||0)||null,side:String(comment?.side||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactFile(file){const filePath=String(file?.filename||file?.path||'').trim();return filePath?{path:filePath,status:String(file?.status||'').trim()||null,additions:Number(file?.additions||0)||0,deletions:Number(file?.deletions||0)||0,changes:Number(file?.changes||0)||0}:null;} function collectPrDigest(repo,number,fallback,runner){const pr=safeGhJson(['pr','view',String(number),'--repo',repo,'--json','number,title,body,url,headRefName,baseRefName,isDraft,mergeable,statusCheckRollup,author,labels,reviewDecision'],{},runner);const issueComments=safeGhJson(['api','repos/'+repo+'/issues/'+number+'/comments?per_page=100'],[],runner).map(compactIssueComment).slice(0,40);const reviews=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/reviews?per_page=100'],[],runner).map(compactReview).slice(0,40);const reviewComments=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/comments?per_page=100'],[],runner).map(compactReviewComment).slice(0,60);const files=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/files?per_page=100'],[],runner).map(compactFile).filter(Boolean).slice(0,80);const requested=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/requested_reviewers'],{},runner);const requestedReviewers=[...(Array.isArray(requested?.users)?requested.users:[]).map(compactUser),...(Array.isArray(requested?.teams)?requested.teams:[]).map((team)=>{const slug=String(team?.slug||team?.name||'').trim();return slug?{team:slug,url:String(team?.html_url||team?.url||'').trim()||null}:null;})].filter(Boolean);const checks=(Array.isArray(pr?.statusCheckRollup)?pr.statusCheckRollup:[]).map(compactCheck).filter(Boolean);const labels=(Array.isArray(pr?.labels)?pr.labels:[]).map((label)=>String(label?.name||label||'').trim()).filter(Boolean);const failingChecks=checks.filter((check)=>QUALITY_FAIL_STATES.has(String(check?.state||'').toUpperCase())||QUALITY_FAIL_STATES.has(String(check?.bucket||'').toUpperCase()));const pendingChecks=checks.filter((check)=>QUALITY_PENDING_STATES.has(String(check?.state||'').toUpperCase()));const digestSummary=['PR #'+String(pr?.number||number)+' '+String(pr?.title||fallback?.title||''),'repo='+repo+' branch='+(String(pr?.headRefName||fallback?.branch||'').trim()||'unknown'),'checks='+checks.length+' fail='+failingChecks.length+' pending='+pendingChecks.length,'comments='+issueComments.length+' reviews='+reviews.length+' reviewComments='+reviewComments.length+' files='+files.length,labels.length?'labels='+labels.join(', '):''].filter(Boolean).join('\\n');return {core:{number:Number(pr?.number||number)||number,title:String(pr?.title||fallback?.title||''),url:String(pr?.url||fallback?.url||'').trim()||null,body:truncateText(pr?.body,4000),branch:String(pr?.headRefName||fallback?.branch||'').trim()||null,baseBranch:String(pr?.baseRefName||fallback?.base||'').trim()||null,isDraft:pr?.isDraft===true,mergeable:String(pr?.mergeable||'').trim()||null,author:compactUser(pr?.author),reviewDecision:String(pr?.reviewDecision||'').trim()||null},labels,requestedReviewers,checks,ciSummary:{total:checks.length,failing:failingChecks.length,pending:pendingChecks.length,passing:Math.max(0,checks.length-failingChecks.length-pendingChecks.length)},issueComments,reviews,reviewComments,files,digestSummary};} function isActionableText(value){const text=String(value||'').trim();if(!text)return false;return /(fix|please|should|must|needs?|issue|bug|error|warning|sonar|lint|review|nit|suggest|change|request|fail)/i.test(text);} function collectActionableReviewSignals(prDigest){const digest=prDigest&&typeof prDigest==='object'?prDigest:{};const reviewComments=Array.isArray(digest.reviewComments)?digest.reviewComments:[];const reviews=Array.isArray(digest.reviews)?digest.reviews:[];const issueComments=Array.isArray(digest.issueComments)?digest.issueComments:[];const checks=Array.isArray(digest.checks)?digest.checks:[];const commentFindings=[];for(const comment of reviewComments){if(!isActionableText(comment?.body))continue;commentFindings.push({kind:'review_comment',path:String(comment?.path||'').trim()||null,line:Number(comment?.line||0)||null,author:String(comment?.author?.login||'').trim()||null,body:String(comment?.body||'').trim(),url:String(comment?.url||'').trim()||null});}for(const review of reviews){const state=String(review?.state||'').trim().toUpperCase();if(state!=='CHANGES_REQUESTED'&&!isActionableText(review?.body))continue;commentFindings.push({kind:'review',state:state||null,author:String(review?.author?.login||'').trim()||null,body:String(review?.body||'').trim(),url:String(review?.url||'').trim()||null});}for(const comment of issueComments){if(!isActionableText(comment?.body))continue;commentFindings.push({kind:'issue_comment',author:String(comment?.author?.login||'').trim()||null,body:String(comment?.body||'').trim(),url:String(comment?.url||'').trim()||null});}const failingChecks=checks.filter((check)=>QUALITY_FAIL_STATES.has(String(check?.state||'').toUpperCase())||QUALITY_FAIL_STATES.has(String(check?.bucket||'').toUpperCase()));const sonarChecks=failingChecks.filter((check)=>SONAR_CHECK_RE.test(String(readCheckName(check)||'')));const qualityChecks=failingChecks.map((check)=>({name:readCheckName(check),state:String(check?.state||check?.bucket||'').trim()||null,workflow:String(check?.workflow||'').trim()||null}));const summary=['commentFindings='+commentFindings.length,'qualityChecks='+qualityChecks.length,sonarChecks.length?'sonarChecks='+sonarChecks.length:''].filter(Boolean).join(' ');return {commentFindings,qualityChecks,sonarChecks,summary};} const prs=[]; for(const target of resolveRepoTargets()){const repo=String(target||'').trim();const args=['pr','list','--state','open','--json','number,title,body,author,headRefName,baseRefName,isDraft,statusCheckRollup,labels,url','--limit',String(MAX_PRS)];if(repo)args.push('--repo',repo);try{const list=ghJson(args);for(const pr of (Array.isArray(list)?list:[])){prs.push({...pr,__repo:repo||parseRepoFromUrl(pr?.url)});}}catch{}} const actionables=[]; for(const pr of prs){if(pr?.isDraft===true)continue;if(!isEligible(pr))continue;const repo=String(pr?.__repo||'').trim();if(!repo)continue;const listedChecks=Array.isArray(pr?.statusCheckRollup)?pr.statusCheckRollup:[];const hasSonarFailure=listedChecks.some((check)=>SONAR_CHECK_RE.test(String(readCheckName(check)||''))&&(QUALITY_FAIL_STATES.has(String(check?.conclusion||check?.state||'').toUpperCase())||QUALITY_FAIL_STATES.has(String(check?.bucket||'').toUpperCase())));if(!hasSonarFailure)continue;const prDigest=collectPrDigest(repo,pr.number,{branch:pr.headRefName,base:pr.baseRefName,title:pr.title,url:pr.url},runGh);const signals=collectActionableReviewSignals(prDigest);if(signals.sonarChecks.length===0)continue;actionables.push({repo,number:pr.number,branch:String(pr?.headRefName||'').trim(),base:String(pr?.baseRefName||'').trim(),url:String(pr?.url||'').trim(),title:String(pr?.title||'').trim(),sonarChecks:signals.sonarChecks,qualityChecks:signals.qualityChecks,commentFindings:signals.commentFindings,digestSummary:prDigest.digestSummary,summary:signals.summary,prDigest});if(actionables.length>=5)break;} console.log(JSON.stringify({total:prs.length,actionableCount:actionables.length,actionables}));" - ], - "continueOnError": false, - "failOnError": true - }, - "position": { - "x": 420, - "y": 210 - }, - "outputs": [ - "default" - ] - }, - { - "id": "has-sonar-work", - "type": "condition.expression", - "label": "Actionable Sonar Findings?", - "config": { - "expression": "(()=>{try{const raw=$ctx.getNodeOutput('fetch-sonar-signals')?.output||'{}';return (JSON.parse(raw).actionableCount||0)>0;}catch{return false;}})()" - }, - "position": { - "x": 420, - "y": 370 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "run-sonar-striker", - "type": "action.run_agent", - "label": "Repair SonarQube Findings", - "config": { - "sdk": "auto", - "timeoutMs": 1800000, - "prompt": "You are a Bosun SonarQube remediation agent. Work only the PRs in this JSON:\n\n{{$ctx.getNodeOutput('fetch-sonar-signals')?.output}}\n\nEach item contains sonarChecks plus prDigest with files, comments, reviews, review comments, and all checks. Fix only the listed SonarQube or SonarCloud findings on the existing PR branch, using the smallest safe code change.\n\nSTRICT RULES:\n- Use GitHub-native Sonar checks as the source of truth for this run.\n- Do not create a new PR or perform unrelated refactors.\n- If reviewer comments overlap with the Sonar issue, incorporate them only when they point at the same root cause.\n- Run targeted validation before pushing the branch update.\n- Preserve behavior while satisfying the static-analysis requirement." - }, - "position": { - "x": 220, - "y": 540 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-sonar-idle", - "type": "notify.log", - "label": "No Sonar Work", - "config": { - "message": "SonarQube PR Striker found no actionable SonarQube or SonarCloud failures.", - "level": "info" - }, - "position": { - "x": 620, - "y": 540 - }, - "outputs": [ - "default" - ] - }, - { - "id": "notify-sonar-run", - "type": "notify.log", - "label": "Log Sonar Dispatch", - "config": { - "message": "SonarQube PR Striker dispatched remediation for Sonar-native quality failures.", - "level": "info" - }, - "position": { - "x": 220, - "y": 700 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->fetch-sonar-signals", - "source": "trigger", - "target": "fetch-sonar-signals", - "sourcePort": "default" - }, - { - "id": "fetch-sonar-signals->has-sonar-work", - "source": "fetch-sonar-signals", - "target": "has-sonar-work", - "sourcePort": "default" - }, - { - "id": "has-sonar-work->run-sonar-striker", - "source": "has-sonar-work", - "target": "run-sonar-striker", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "has-sonar-work->log-sonar-idle", - "source": "has-sonar-work", - "target": "log-sonar-idle", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "run-sonar-striker->notify-sonar-run", - "source": "run-sonar-striker", - "target": "notify-sonar-run", - "sourcePort": "default" - } - ] - }, - { - "id": "template-task-batch-pr", - "name": "Task Batch → PR", - "description": "Simplified batch processor that picks todo tasks, runs the agent on each, and creates pull requests for any that produce commits. Ideal for autonomous mode where tasks should flow straight to PRs.", - "category": "task-execution", - "categoryLabel": "Task Execution", - "categoryIcon": ":settings:", - "categoryOrder": 99, - "tags": [ - "task", - "batch", - "pr", - "agent", - "autonomous" - ], - "nodeCount": 12, - "edgeCount": 12, - "recommended": false, - "enabled": true, - "trigger": "trigger.task_available", - "variables": { - "maxConcurrent": 2, - "pollStatus": "todo", - "maxBatchSize": 5, - "defaultBaseBranch": "main", - "draftPR": true - }, - "metadata": { - "author": "bosun", - "version": 1, - "createdAt": "2026-03-15T00:00:00Z", - "templateVersion": "1.0.0", - "tags": [ - "task", - "batch", - "pr", - "agent", - "autonomous" - ], - "requiredTemplates": [ - "template-bosun-pr-progressor" - ] - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.task_available", - "label": "Tasks Available?", - "config": { - "maxParallel": "{{maxConcurrent}}", - "pollIntervalMs": 15000, - "status": "{{pollStatus}}" - }, - "position": { - "x": 400, - "y": 50 - }, - "outputs": [ - "default" - ] - }, - { - "id": "query-tasks", - "type": "action.run_command", - "label": "List Todo Tasks", - "config": { - "command": "node", - "args": [ - "-e", - "\n const fs = require(\"node:fs\");\n const path = require(\"node:path\");\n const { pathToFileURL } = require(\"node:url\");\n const cwd = process.cwd();\n const mirrorMarker = (path.sep + \".bosun\" + path.sep + \"workspaces\" + path.sep).toLowerCase();\n let repoRoot = cwd;\n if (cwd.toLowerCase().includes(mirrorMarker)) {\n const sourceRepoRoot = path.resolve(cwd, \"..\", \"..\", \"..\", \"..\");\n if (fs.existsSync(path.join(sourceRepoRoot, \"kanban\", \"kanban-adapter.mjs\"))) repoRoot = sourceRepoRoot;\n }\n const kanbanModuleUrl = pathToFileURL(path.join(repoRoot, \"kanban\", \"kanban-adapter.mjs\")).href;\n import(kanbanModuleUrl)\n .then(k => k.listTasks(undefined, { status: \"todo\" }))\n .then(tasks => {\n const filtered = (tasks || []).filter((task) => task && task.status === \"todo\" && !task.draft);\n const batch = filtered.slice(0, parseInt(process.env.MAX_BATCH || \"5\"));\n console.log(JSON.stringify(batch.map(t => ({\n taskId: t.id,\n taskTitle: t.title || t.id,\n branch: t.branch || t.metadata?.branch || null,\n repository: typeof t?.repository === \"string\" ? t.repository.trim() : null,\n workspace: typeof t?.workspace === \"string\" ? t.workspace.trim() : null,\n }))));\n })\n .catch(e => { console.error(e.message); process.exit(1); });\n " - ], - "env": { - "MAX_BATCH": "{{maxBatchSize}}" - }, - "parseJson": true - }, - "position": { - "x": 400, - "y": 180 - }, - "outputs": [ - "default" - ] - }, - { - "id": "for-each-task", - "type": "loop.for_each", - "label": "Process Each Task", - "config": { - "items": "$ctx.getNodeOutput('query-tasks')?.output || []", - "variable": "task", - "indexVariable": "idx", - "maxConcurrent": "{{maxConcurrent}}" - }, - "position": { - "x": 400, - "y": 310 - }, - "outputs": [ - "default" - ] - }, - { - "id": "set-inprogress", - "type": "action.update_task_status", - "label": "Mark In-Progress", - "config": { - "taskId": "{{task.taskId}}", - "status": "inprogress" - }, - "position": { - "x": 400, - "y": 440 - }, - "outputs": [ - "default" - ] - }, - { - "id": "run-agent", - "type": "action.run_agent", - "label": "Run Agent", - "config": { - "taskId": "{{task.taskId}}", - "taskTitle": "{{task.taskTitle}}", - "branch": "{{task.branch}}" - }, - "position": { - "x": 400, - "y": 570 - }, - "outputs": [ - "default" - ] - }, - { - "id": "detect-commits", - "type": "action.detect_new_commits", - "label": "Check Commits", - "config": { - "taskId": "{{task.taskId}}", - "worktreePath": "{{worktreePath}}", - "failOnError": false - }, - "position": { - "x": 400, - "y": 700 - }, - "outputs": [ - "default" - ] - }, - { - "id": "push-branch", - "type": "action.git_operations", - "label": "Push Branch", - "config": { - "operation": "push", - "cwd": "{{worktreePath}}" - }, - "position": { - "x": 400, - "y": 830 - }, - "outputs": [ - "default" - ] - }, - { - "id": "create-pr", - "type": "action.create_pr", - "label": "Create PR", - "config": { - "title": "{{task.taskTitle}}", - "body": "Task-ID: {{task.taskId}}\n\nAutomated PR for task {{task.taskId}}", - "base": "{{defaultBaseBranch}}", - "branch": "{{task.branch}}", - "draft": "{{draftPR}}" - }, - "position": { - "x": 400, - "y": 960 - }, - "outputs": [ - "default" - ] - }, - { - "id": "set-inreview", - "type": "action.update_task_status", - "label": "Mark In-Review", - "config": { - "taskId": "{{task.taskId}}", - "status": "inreview" - }, - "position": { - "x": 400, - "y": 1090 - }, - "outputs": [ - "default" - ] - }, - { - "id": "handoff-pr-progressor", - "type": "action.execute_workflow", - "label": "Dispatch PR Progressor", - "config": { - "workflowId": "template-bosun-pr-progressor", - "mode": "dispatch", - "input": { - "taskId": "{{task.taskId}}", - "taskTitle": "{{task.taskTitle}}", - "branch": "{{task.branch}}", - "baseBranch": "{{defaultBaseBranch}}", - "prNumber": "{{$ctx.getNodeOutput('create-pr')?.prNumber ?? null}}", - "prUrl": "{{$ctx.getNodeOutput('create-pr')?.prUrl || ''}}", - "repo": "{{$ctx.getNodeOutput('create-pr')?.repoSlug || $data?.repo || $data?.repoSlug || $data?.repository || ''}}" - } - }, - "position": { - "x": 400, - "y": 1160 - }, - "outputs": [ - "default" - ] - }, - { - "id": "join-batch-outcomes", - "type": "flow.join", - "label": "Join Batch Outcomes", - "config": { - "mode": "all", - "sourceNodeIds": [ - "detect-commits", - "handoff-pr-progressor" - ], - "includeSkipped": true - }, - "position": { - "x": 400, - "y": 1230 - }, - "outputs": [ - "default" - ] - }, - { - "id": "notify", - "type": "notify.log", - "label": "Batch Complete", - "config": { - "message": "Task batch PR pipeline complete", - "level": "info" - }, - "position": { - "x": 400, - "y": 1220 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->query-tasks", - "source": "trigger", - "target": "query-tasks", - "sourcePort": "default" - }, - { - "id": "query-tasks->for-each-task", - "source": "query-tasks", - "target": "for-each-task", - "sourcePort": "default" - }, - { - "id": "for-each-task->set-inprogress", - "source": "for-each-task", - "target": "set-inprogress", - "sourcePort": "default" - }, - { - "id": "set-inprogress->run-agent", - "source": "set-inprogress", - "target": "run-agent", - "sourcePort": "default" - }, - { - "id": "run-agent->detect-commits", - "source": "run-agent", - "target": "detect-commits", - "sourcePort": "default" - }, - { - "id": "detect-commits->push-branch", - "source": "detect-commits", - "target": "push-branch", - "sourcePort": "default", - "condition": "result.hasNewCommits === true" - }, - { - "id": "push-branch->create-pr", - "source": "push-branch", - "target": "create-pr", - "sourcePort": "default" - }, - { - "id": "create-pr->set-inreview", - "source": "create-pr", - "target": "set-inreview", - "sourcePort": "default" - }, - { - "id": "detect-commits->join-batch-outcomes", - "source": "detect-commits", - "target": "join-batch-outcomes", - "sourcePort": "default", - "condition": "result.hasNewCommits !== true" - }, - { - "id": "set-inreview->handoff-pr-progressor", - "source": "set-inreview", - "target": "handoff-pr-progressor", - "sourcePort": "default" - }, - { - "id": "handoff-pr-progressor->join-batch-outcomes", - "source": "handoff-pr-progressor", - "target": "join-batch-outcomes", - "sourcePort": "default" - }, - { - "id": "join-batch-outcomes->notify", - "source": "join-batch-outcomes", - "target": "notify", - "sourcePort": "default" - } - ] - }, - { - "id": "template-task-batch-processor", - "name": "Task Batch Processor", - "description": "Monitors the task backlog and dispatches multiple tasks in parallel using the Task Lifecycle sub-workflow. Automatically picks up tasks when backlog drops below threshold, fans out execution across available slots, and reports batch results.", - "category": "task-execution", - "categoryLabel": "Task Execution", - "categoryIcon": ":settings:", - "categoryOrder": 99, - "tags": [ - "task", - "batch", - "parallel", - "dispatch", - "lifecycle" - ], - "nodeCount": 9, - "edgeCount": 8, - "recommended": true, - "enabled": true, - "trigger": "trigger.task_available", - "variables": { - "maxConcurrent": 3, - "pollStatus": "todo", - "maxBatchSize": 10, - "subWorkflow": "template-task-lifecycle", - "notifyChannel": "telegram" - }, - "metadata": { - "author": "bosun", - "version": 1, - "createdAt": "2026-03-15T00:00:00Z", - "templateVersion": "1.0.0", - "tags": [ - "task", - "batch", - "parallel", - "dispatch", - "lifecycle" - ] - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.task_available", - "label": "Tasks Available?", - "config": { - "maxParallel": "{{maxConcurrent}}", - "pollIntervalMs": 15000, - "status": "{{pollStatus}}" - }, - "position": { - "x": 400, - "y": 50 - }, - "outputs": [ - "default" - ] - }, - { - "id": "check-coordinator", - "type": "condition.expression", - "label": "Is Coordinator?", - "config": { - "expression": "$data?.isCoordinator !== false" - }, - "position": { - "x": 400, - "y": 180 - }, - "outputs": [ - "default" - ] - }, - { - "id": "query-tasks", - "type": "action.run_command", - "label": "Query Task Backlog", - "config": { - "command": "node", - "args": [ - "-e", - "\n const fs = require(\"node:fs\");\n const path = require(\"node:path\");\n const { pathToFileURL } = require(\"node:url\");\n const cwd = process.cwd();\n const mirrorMarker = (path.sep + \".bosun\" + path.sep + \"workspaces\" + path.sep).toLowerCase();\n let repoRoot = cwd;\n if (cwd.toLowerCase().includes(mirrorMarker)) {\n const sourceRepoRoot = path.resolve(cwd, \"..\", \"..\", \"..\", \"..\");\n if (fs.existsSync(path.join(sourceRepoRoot, \"kanban\", \"kanban-adapter.mjs\"))) repoRoot = sourceRepoRoot;\n }\n const kanbanModuleUrl = pathToFileURL(path.join(repoRoot, \"kanban\", \"kanban-adapter.mjs\")).href;\n import(kanbanModuleUrl)\n .then(k => k.listTasks(undefined, { status: \"todo\" }))\n .then(tasks => {\n const filtered = (tasks || []).filter((task) => task && task.status === \"todo\" && !task.draft);\n const batch = filtered.slice(0, parseInt(process.env.MAX_BATCH || \"10\"));\n console.log(JSON.stringify(batch.map(t => ({\n taskId: t.id,\n taskTitle: t.title || t.id,\n status: t.status,\n branch: t.branch || t.metadata?.branch || null,\n scope: t.scope || t.metadata?.scope || null,\n repository: typeof t?.repository === \"string\" ? t.repository.trim() : null,\n workspace: typeof t?.workspace === \"string\" ? t.workspace.trim() : null,\n }))));\n })\n .catch(e => { console.error(e.message); process.exit(1); });\n " - ], - "env": { - "MAX_BATCH": "{{maxBatchSize}}" - }, - "parseJson": true - }, - "position": { - "x": 400, - "y": 310 - }, - "outputs": [ - "default" - ] - }, - { - "id": "dispatch-tasks", - "type": "loop.for_each", - "label": "Dispatch Tasks", - "config": { - "items": "$ctx.getNodeOutput('query-tasks')?.output || []", - "itemVariable": "currentTask", - "indexVariable": "taskIndex", - "maxConcurrent": "{{maxConcurrent}}", - "workflowId": "{{subWorkflow}}", - "mode": "dispatch" - }, - "position": { - "x": 400, - "y": 440 - }, - "outputs": [ - "default" - ] - }, - { - "id": "join-dispatch", - "type": "flow.join", - "label": "Join Dispatch Branches", - "config": { - "mode": "all", - "sourceNodeIds": [ - "dispatch-tasks" - ], - "includeSkipped": true - }, - "position": { - "x": 400, - "y": 505 - }, - "outputs": [ - "default" - ] - }, - { - "id": "record-results", - "type": "action.set_variable", - "label": "Record Results", - "config": { - "key": "batchResult", - "value": "{{dispatch-tasks}}" - }, - "position": { - "x": 400, - "y": 570 - }, - "outputs": [ - "default" - ] - }, - { - "id": "has-batch-failures", - "type": "condition.expression", - "label": "Any Batch Failures?", - "config": { - "expression": "Number($data?.batchResult?.failCount || 0) > 0" - }, - "position": { - "x": 400, - "y": 700 - }, - "outputs": [ - "default" - ] - }, - { - "id": "notify-failures", - "type": "notify.telegram", - "label": "Batch Failure Alert", - "config": { - "channel": "{{notifyChannel}}", - "message": "Task batch needs attention: {{batchResult.failCount}} failed out of {{batchResult.totalItems}} ({{batchResult.successCount}} succeeded)" - }, - "position": { - "x": 220, - "y": 830 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-summary", - "type": "notify.log", - "label": "Batch Summary", - "config": { - "message": "Task batch completed: {{batchResult.successCount}}/{{batchResult.totalItems}} succeeded ({{batchResult.failCount}} failed)", - "level": "info" - }, - "position": { - "x": 580, - "y": 830 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->check-coordinator", - "source": "trigger", - "target": "check-coordinator", - "sourcePort": "default" - }, - { - "id": "check-coordinator->query-tasks", - "source": "check-coordinator", - "target": "query-tasks", - "sourcePort": "default", - "condition": "$output === true || $output?.result === true || $output?.value === true" - }, - { - "id": "query-tasks->dispatch-tasks", - "source": "query-tasks", - "target": "dispatch-tasks", - "sourcePort": "default" - }, - { - "id": "dispatch-tasks->join-dispatch", - "source": "dispatch-tasks", - "target": "join-dispatch", - "sourcePort": "default" - }, - { - "id": "join-dispatch->record-results", - "source": "join-dispatch", - "target": "record-results", - "sourcePort": "default" - }, - { - "id": "record-results->has-batch-failures", - "source": "record-results", - "target": "has-batch-failures", - "sourcePort": "default" - }, - { - "id": "has-batch-failures->notify-failures", - "source": "has-batch-failures", - "target": "notify-failures", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "has-batch-failures->log-summary", - "source": "has-batch-failures", - "target": "log-summary", - "sourcePort": "default", - "condition": "$output?.result !== true" - } - ] - }, - { - "id": "template-task-lifecycle", - "name": "Task Lifecycle", - "description": "Complete task execution pipeline: poll for tasks → claim → worktree → agent dispatch → commit detection → PR creation → status transition. Replaces the monolithic TaskExecutor.executeTask() method with a composable workflow DAG.", - "category": "task-execution", - "categoryLabel": "Task Execution", - "categoryIcon": ":settings:", - "categoryOrder": 99, - "tags": [ - "task", - "lifecycle", - "executor", - "workflow-first", - "core", - "multi-remediation" - ], - "nodeCount": 71, - "edgeCount": 82, - "recommended": true, - "enabled": true, - "trigger": "trigger.task_available", - "variables": { - "maxParallel": 3, - "baseBranchLimit": 0, - "pollIntervalMs": 30000, - "claimTtlMinutes": 180, - "claimRenewIntervalMs": 60000, - "defaultSdk": "auto", - "defaultTargetBranch": "origin/main", - "taskTimeoutMs": 21600000, - "delegationWatchdogTimeoutMs": 300000, - "delegationWatchdogMaxRecoveries": 1, - "prePrValidationEnabled": true, - "prePrValidationCommand": "auto", - "autoMergeOnCreate": false, - "autoMergeMethod": "squash", - "maxRetries": 2, - "maxContinues": 3, - "protectedBranches": [ - "main", - "master", - "develop", - "production" - ] - }, - "metadata": { - "author": "bosun", - "version": 4, - "createdAt": "2026-03-01T00:00:00Z", - "templateVersion": "4.0.0", - "tags": [ - "task", - "lifecycle", - "executor", - "workflow-first", - "core", - "multi-remediation" - ], - "requiredTemplates": [ - "template-bosun-pr-progressor", - "template-task-repair-worktree" - ], - "replaces": { - "module": "task-executor.mjs", - "functions": [ - "executeTask", - "_pollLoop", - "_handleTaskResult", - "_buildTaskPrompt", - "_processBacklogReplenishment" - ], - "calledFrom": [ - "monitor.mjs:startProcess", - "monitor.mjs:runMonitorMonitorCycle" - ], - "description": "Replaces the entire TaskExecutor.executeTask() monolith with a composable DAG workflow. Each step (claim, worktree, agent, PR) is an independent workflow node with explicit success/failure branches." - } - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.task_available", - "label": "Poll for Tasks", - "config": { - "maxParallel": "{{maxParallel}}", - "pollIntervalMs": "{{pollIntervalMs}}", - "statuses": [ - "inreview", - "todo" - ], - "filterCodexScoped": true, - "filterDrafts": true - }, - "position": { - "x": 400, - "y": 50 - }, - "outputs": [ - "default" - ] - }, - { - "id": "check-slots", - "type": "condition.slot_available", - "label": "Slots Available?", - "config": { - "maxParallel": "{{maxParallel}}", - "baseBranchLimit": "{{baseBranchLimit}}", - "baseBranch": "{{defaultTargetBranch}}" - }, - "position": { - "x": 400, - "y": 180 - }, - "outputs": [ - "default" - ] - }, - { - "id": "allocate-slot", - "type": "action.allocate_slot", - "label": "Allocate Slot", - "config": { - "taskId": "{{taskId}}", - "taskTitle": "{{taskTitle}}", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}" - }, - "position": { - "x": 400, - "y": 310 - }, - "outputs": [ - "default" - ] - }, - { - "id": "claim-task", - "type": "action.claim_task", - "label": "Claim Task", - "config": { - "taskId": "{{taskId}}", - "taskTitle": "{{taskTitle}}", - "ttlMinutes": "{{claimTtlMinutes}}", - "renewIntervalMs": "{{claimRenewIntervalMs}}", - "branch": "{{branch}}" - }, - "position": { - "x": 400, - "y": 440 - }, - "outputs": [ - "default" - ] - }, - { - "id": "claim-ok", - "type": "condition.expression", - "label": "Claim Succeeded?", - "config": { - "expression": "$ctx.getNodeOutput('claim-task')?.success === true" - }, - "position": { - "x": 400, - "y": 570 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "set-inprogress", - "type": "action.update_task_status", - "label": "Set In-Progress", - "config": { - "taskId": "{{taskId}}", - "status": "inprogress", - "taskTitle": "{{taskTitle}}" - }, - "position": { - "x": 300, - "y": 700 - }, - "outputs": [ - "default" - ] - }, - { - "id": "acquire-worktree", - "type": "action.acquire_worktree", - "label": "Acquire Worktree", - "config": { - "repoRoot": "{{repoRoot}}", - "branch": "{{branch}}", - "taskId": "{{taskId}}", - "baseBranch": "{{baseBranch}}", - "defaultTargetBranch": "{{defaultTargetBranch}}" - }, - "position": { - "x": 300, - "y": 830 - }, - "outputs": [ - "default" - ] - }, - { - "id": "worktree-ok", - "type": "condition.expression", - "label": "Worktree OK?", - "config": { - "expression": "$ctx.getNodeOutput('acquire-worktree')?.success === true" - }, - "position": { - "x": 300, - "y": 960 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "resolve-executor", - "type": "action.resolve_executor", - "label": "Resolve Executor", - "config": { - "taskId": "{{taskId}}", - "taskTitle": "{{taskTitle}}", - "taskDescription": "{{taskDescription}}", - "repoRoot": "{{repoRoot}}", - "workspace": "{{workspace}}", - "defaultSdk": "{{defaultSdk}}" - }, - "position": { - "x": 200, - "y": 1090 - }, - "outputs": [ - "default" - ] - }, - { - "id": "record-head", - "type": "action.run_command", - "label": "Record HEAD", - "config": { - "command": "git rev-parse HEAD", - "cwd": "{{worktreePath}}" - }, - "position": { - "x": 200, - "y": 1220 - }, - "outputs": [ - "default" - ] - }, - { - "id": "read-workflow-contract", - "type": "read-workflow-contract", - "label": "Read WORKFLOW.md", - "config": { - "repoRoot": "{{repoRoot}}", - "worktreePath": "{{worktreePath}}" - }, - "position": { - "x": 200, - "y": 1350 - }, - "outputs": [ - "default" - ] - }, - { - "id": "workflow-contract-validation", - "type": "workflow-contract-validation", - "label": "Validate WORKFLOW.md", - "config": { - "repoRoot": "{{repoRoot}}", - "worktreePath": "{{worktreePath}}" - }, - "position": { - "x": 200, - "y": 1480 - }, - "outputs": [ - "default" - ] - }, - { - "id": "build-prompt", - "type": "action.build_task_prompt", - "label": "Build Prompt", - "config": { - "taskId": "{{taskId}}", - "taskTitle": "{{taskTitle}}", - "taskDescription": "{{taskDescription}}", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "worktreePath": "{{worktreePath}}", - "repoRoot": "{{repoRoot}}", - "repoSlug": "{{repoSlug}}", - "workspace": "{{workspace}}", - "repository": "{{repository}}", - "repositories": "{{repositories}}" - }, - "position": { - "x": 200, - "y": 1610 - }, - "outputs": [ - "default" - ] - }, - { - "id": "run-agent-plan", - "type": "action.run_agent", - "label": "Agent Plan", - "config": { - "prompt": "{{_taskPrompt}}\n\nExecution phase: planning. Produce a concrete implementation plan and identify required tests. Do not make code changes in this phase.", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "delegationWatchdogTimeoutMs": "{{delegationWatchdogTimeoutMs}}", - "delegationWatchdogMaxRecoveries": "{{delegationWatchdogMaxRecoveries}}" - }, - "position": { - "x": 200, - "y": 1740 - }, - "outputs": [ - "default" - ] - }, - { - "id": "run-agent-tests", - "type": "action.run_agent", - "label": "Agent Tests", - "config": { - "prompt": "{{_taskPrompt}}\n\nExecution phase: tests. Write or update tests first for the target behavior, then validate failures/pass criteria before implementation changes.", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "delegationWatchdogTimeoutMs": "{{delegationWatchdogTimeoutMs}}", - "delegationWatchdogMaxRecoveries": "{{delegationWatchdogMaxRecoveries}}" - }, - "position": { - "x": 200, - "y": 1545 - }, - "outputs": [ - "default" - ] - }, - { - "id": "run-agent-implement", - "type": "action.run_agent", - "label": "Agent Implement", - "config": { - "prompt": "{{_taskPrompt}}\n\nExecution phase: implementation. Complete implementation after tests exist, run required verification (tests/lint/build), then commit, push, and create/update PR.", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false, - "delegationWatchdogTimeoutMs": "{{delegationWatchdogTimeoutMs}}", - "delegationWatchdogMaxRecoveries": "{{delegationWatchdogMaxRecoveries}}" - }, - "position": { - "x": 200, - "y": 1610 - }, - "outputs": [ - "default" - ] - }, - { - "id": "claim-stolen", - "type": "condition.expression", - "label": "Claim Stolen?", - "config": { - "expression": "$data._claimStolen === true" - }, - "position": { - "x": 200, - "y": 1610 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "auto-commit-dirty", - "type": "action.auto_commit_dirty", - "label": "Auto Commit Dirty", - "config": { - "worktreePath": "{{worktreePath}}", - "taskId": "{{taskId}}" - }, - "position": { - "x": 120, - "y": 1680 - }, - "outputs": [ - "default" - ] - }, - { - "id": "detect-commits", - "type": "action.detect_new_commits", - "label": "Detect Commits", - "config": { - "worktreePath": "{{worktreePath}}", - "baseBranch": "{{baseBranch}}" - }, - "position": { - "x": 120, - "y": 1740 - }, - "outputs": [ - "default" - ] - }, - { - "id": "has-commits", - "type": "condition.expression", - "label": "Has Commits?", - "config": { - "expression": "$ctx.getNodeOutput('detect-commits')?.hasCommits === true" - }, - "position": { - "x": 120, - "y": 1870 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "pre-pr-validation", - "type": "action.run_command", - "label": "Pre-PR Validation", - "config": { - "command": "{{prePrValidationCommand}}", - "commandType": "qualityGate", - "cwd": "{{worktreePath}}", - "failOnError": false - }, - "position": { - "x": -120, - "y": 1940 - }, - "outputs": [ - "default" - ] - }, - { - "id": "pre-pr-validation-ok", - "type": "condition.expression", - "label": "Validation Passed?", - "config": { - "expression": "(() => {const enabled = $data?.prePrValidationEnabled !== false;if (!enabled) return true;const out = $ctx.getNodeOutput('pre-pr-validation');if (!out) return false;if (out.success === true) return true;const code = Number(out.exitCode);return Number.isFinite(code) && code === 0;})()" - }, - "position": { - "x": -120, - "y": 2060 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "set-fix-summary", - "type": "action.set_variable", - "label": "Summarize Validation Output", - "config": { - "key": "fixSummary", - "value": "(() => { const out = $ctx.getNodeOutput('pre-pr-validation') || {}; const diag = out.outputDiagnostics || {}; const sections = []; sections.push('## Validation Result'); sections.push('- Exit code: ' + (out.exitCode ?? 'unknown')); sections.push('- Runner: ' + (diag.family || diag.runner || 'unknown')); if (diag.summary) sections.push('- Summary: ' + diag.summary); const targets = diag.failedTargets || []; if (targets.length) { sections.push(''); sections.push('## Failed Targets (' + targets.length + ')'); targets.slice(0, 30).forEach(t => sections.push(' - ' + t)); if (targets.length > 30) sections.push(' ... and ' + (targets.length - 30) + ' more'); } const rerun = out.outputSuggestedRerun || diag.suggestedRerun || ''; if (rerun) { sections.push(''); sections.push('## Suggested Rerun Command'); sections.push('```'); sections.push(rerun); sections.push('```'); } const hint = out.outputHint || diag.hint || ''; if (hint) sections.push('\\nHint: ' + hint); sections.push(''); sections.push('## Full Command Output'); sections.push(String(out.output || '').slice(0, 12000)); return sections.join('\\n'); })()", - "isExpression": true - }, - "position": { - "x": 300, - "y": 2000 - }, - "outputs": [ - "default" - ] - }, - { - "id": "auto-fix-validation", - "type": "action.run_agent", - "label": "Auto-Fix Validation (Pass 1)", - "config": { - "prompt": "# Fix Pre-PR Validation Failures — Pass 1\n\nTask: **{{taskTitle}}**\n\nThe pre-PR validation command failed. Your job is to fix EVERY error so validation passes.\n\n{{fixSummary}}\n\nSTRATEGY:\n1. Start from the **Failed Targets** list above — these are the exact files/tests/packages that broke.\n2. Fix compilation and syntax errors FIRST (missing imports, typos, type errors).\n3. Then fix test failures — open each failing test file, read what it asserts, and fix your code or the test expectation.\n4. If a **Suggested Rerun Command** is shown above, use it to re-run only the failing targets and iterate faster.\n5. Once targeted failures are fixed, run the full validation command to confirm everything passes.\n\nRULES:\n- Do NOT weaken, remove, or skip tests. Do NOT add --force or --no-verify flags.\n- Keep the original task scope — do not revert the feature.\n- Create a descriptive commit: \"fix: \"", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false - }, - "position": { - "x": 300, - "y": 2080 - }, - "outputs": [ - "default" - ] - }, - { - "id": "retry-pre-pr-validation", - "type": "action.run_command", - "label": "Retry Pre-PR Validation", - "config": { - "command": "{{prePrValidationCommand}}", - "commandType": "qualityGate", - "cwd": "{{worktreePath}}", - "failOnError": false - }, - "position": { - "x": 300, - "y": 2160 - }, - "outputs": [ - "default" - ] - }, - { - "id": "retry-validation-ok", - "type": "condition.expression", - "label": "Retry Validation Passed?", - "config": { - "expression": "(() => {const enabled = $data?.prePrValidationEnabled !== false;if (!enabled) return true;const out = $ctx.getNodeOutput('retry-pre-pr-validation');if (!out) return false;if (out.success === true) return true;const code = Number(out.exitCode);return Number.isFinite(code) && code === 0;})()" - }, - "position": { - "x": 300, - "y": 2240 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "set-fix2-summary", - "type": "action.set_variable", - "label": "Summarize Both Validation Outputs", - "config": { - "key": "fix2Summary", - "value": "(() => { function summarizeRun(label, out) { const diag = out.outputDiagnostics || {}; const lines = ['### ' + label]; lines.push('- Exit code: ' + (out.exitCode ?? 'unknown')); lines.push('- Runner: ' + (diag.family || diag.runner || 'unknown')); if (diag.summary) lines.push('- Summary: ' + diag.summary); const targets = diag.failedTargets || []; if (targets.length) { lines.push('- Failed targets (' + targets.length + '):'); targets.slice(0, 20).forEach(t => lines.push(' - ' + t)); if (targets.length > 20) lines.push(' ... and ' + (targets.length - 20) + ' more'); } const rerun = out.outputSuggestedRerun || diag.suggestedRerun || ''; if (rerun) lines.push('- Rerun: `' + rerun + '`'); const hint = out.outputHint || diag.hint || ''; if (hint) lines.push('- Hint: ' + hint); if (diag.deltaSummary) lines.push('- Delta: ' + diag.deltaSummary); lines.push(''); lines.push('Full output:'); lines.push(String(out.output || '').slice(0, 8000)); return lines.join('\\n'); } const v1 = $ctx.getNodeOutput('pre-pr-validation') || {}; const v2 = $ctx.getNodeOutput('retry-pre-pr-validation') || {}; return [ '## Validation History (both passes failed)', '', summarizeRun('Pass 1 — Original Validation', v1), '', summarizeRun('Pass 2 — After First Auto-Fix', v2), ].join('\\n'); })()", - "isExpression": true - }, - "position": { - "x": 500, - "y": 2300 - }, - "outputs": [ - "default" - ] - }, - { - "id": "auto-fix-validation-2", - "type": "action.run_agent", - "label": "Auto-Fix Validation (Pass 2 — Escalated)", - "config": { - "prompt": "# Fix Validation Failures — FINAL AUTOMATED ATTEMPT\n\nThis is the SECOND and LAST automated remediation pass for task **{{taskTitle}}**.\nThe first auto-fix attempt DID NOT resolve all issues. You MUST take a different approach.\n\n{{fix2Summary}}\n\nANALYSIS STEPS:\n1. Compare the **Failed Targets** between Pass 1 and Pass 2.\n - If the SAME targets still fail → your previous fix was wrong. Revert it and try a different approach.\n - If NEW targets appeared → your fix broke something else. Fix both.\n - If some targets were RESOLVED → the approach was partially right. Focus on the remaining ones.\n2. Use the **Delta** field (if present) to see exactly what changed between runs.\n3. Use the **Suggested Rerun Command** to iterate on just the failing targets.\n\nCRITICAL RULES:\n- Do NOT repeat the same fix that already failed.\n- If a test is genuinely wrong or testing stale behavior your change invalidated, fix the test AND the code.\n- If the build/lint/test commands are misconfigured for your changes, fix the config.\n- Do NOT weaken, remove, or skip tests. Do NOT add --force or --no-verify flags.\n- Keep the original task scope — do not revert the feature.\n\nRun the full validation command locally and confirm ALL checks pass before finishing.\nCreate a descriptive commit: \"fix: \"", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false - }, - "position": { - "x": 500, - "y": 2380 - }, - "outputs": [ - "default" - ] - }, - { - "id": "retry2-pre-pr-validation", - "type": "action.run_command", - "label": "Retry-2 Pre-PR Validation", - "config": { - "command": "{{prePrValidationCommand}}", - "commandType": "qualityGate", - "cwd": "{{worktreePath}}", - "failOnError": false - }, - "position": { - "x": 500, - "y": 2460 - }, - "outputs": [ - "default" - ] - }, - { - "id": "retry2-validation-ok", - "type": "condition.expression", - "label": "Retry-2 Validation Passed?", - "config": { - "expression": "(() => {const enabled = $data?.prePrValidationEnabled !== false;if (!enabled) return true;const out = $ctx.getNodeOutput('retry2-pre-pr-validation');if (!out) return false;if (out.success === true) return true;const code = Number(out.exitCode);return Number.isFinite(code) && code === 0;})()" - }, - "position": { - "x": 500, - "y": 2540 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "log-validation-failed", - "type": "notify.log", - "label": "Log Validation Failed", - "config": { - "message": "Task \"{{taskTitle}}\" ({{taskId}}) — pre-PR validation failed after 2 auto-fix remediation passes, blocking task", - "level": "warn" - }, - "position": { - "x": 700, - "y": 2600 - }, - "outputs": [ - "default" - ] - }, - { - "id": "set-blocked-validation-failed", - "type": "action.update_task_status", - "label": "Block Task (Validation Fail)", - "config": { - "taskId": "{{taskId}}", - "status": "blocked", - "taskTitle": "{{taskTitle}}", - "blockedReason": "Pre-PR validation failed after 2 automated remediation passes" - }, - "position": { - "x": 700, - "y": 2680 - }, - "outputs": [ - "default" - ] - }, - { - "id": "notify-validation-blocked", - "type": "notify.telegram", - "label": "Notify Validation Blocked", - "config": { - "message": ":alert: Task \"{{taskTitle}}\" blocked — pre-PR validation failed after 2 automated remediation attempts. Manual review needed." - }, - "position": { - "x": 700, - "y": 2760 - }, - "outputs": [ - "default" - ] - }, - { - "id": "push-branch", - "type": "action.push_branch", - "label": "Push Branch", - "config": { - "worktreePath": "{{worktreePath}}", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "rebaseBeforePush": true, - "mergeBaseBeforePush": true, - "autoResolveMergeConflicts": true, - "conflictResolverSdk": "auto", - "emptyDiffGuard": true, - "protectedBranches": "{{protectedBranches}}" - }, - "position": { - "x": 0, - "y": 2000 - }, - "outputs": [ - "default" - ] - }, - { - "id": "push-ok", - "type": "condition.expression", - "label": "Push OK?", - "config": { - "expression": "$ctx.getNodeOutput('push-branch')?.pushed === true" - }, - "position": { - "x": 0, - "y": 2130 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "create-pr", - "type": "action.create_pr", - "label": "Create PR", - "config": { - "title": "{{taskTitle}}", - "body": "Task-ID: {{taskId}}\n\nAutomated PR for task {{taskId}}", - "base": "{{baseBranch}}", - "branch": "{{branch}}", - "cwd": "{{worktreePath}}", - "enableAutoMerge": "{{autoMergeOnCreate}}", - "autoMergeMethod": "{{autoMergeMethod}}" - }, - "position": { - "x": 0, - "y": 2260 - }, - "outputs": [ - "default" - ] - }, - { - "id": "pr-created", - "type": "condition.expression", - "label": "PR Linked?", - "config": { - "expression": "Boolean($ctx.getNodeOutput('create-pr')?.success === true && ($ctx.getNodeOutput('create-pr')?.prNumber || $ctx.getNodeOutput('create-pr')?.prUrl))" - }, - "position": { - "x": 0, - "y": 2325 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "set-inreview", - "type": "action.update_task_status", - "label": "Set In-Review", - "config": { - "taskId": "{{taskId}}", - "status": "inreview", - "taskTitle": "{{taskTitle}}" - }, - "position": { - "x": 0, - "y": 2390 - }, - "outputs": [ - "default" - ] - }, - { - "id": "handoff-pr-progressor", - "type": "action.execute_workflow", - "label": "Handoff PR Progressor", - "config": { - "workflowId": "template-bosun-pr-progressor", - "mode": "dispatch", - "input": { - "taskId": "{{taskId}}", - "taskTitle": "{{taskTitle}}", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "prNumber": "{{$ctx.getNodeOutput('create-pr')?.prNumber ?? $data?.prNumber ?? null}}", - "prUrl": "{{$ctx.getNodeOutput('create-pr')?.prUrl || $data?.prUrl || ''}}", - "repo": "{{$ctx.getNodeOutput('create-pr')?.repoSlug || $data?.repo || $data?.repoSlug || $data?.repository || ''}}" - } - }, - "position": { - "x": -120, - "y": 2520 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-success", - "type": "notify.log", - "label": "Log Success", - "config": { - "message": "Task \"{{taskTitle}}\" ({{taskId}}) completed — PR created", - "level": "info" - }, - "position": { - "x": -120, - "y": 2650 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-no-commits", - "type": "notify.log", - "label": "Log No Commits", - "config": { - "message": "Task \"{{taskTitle}}\" ({{taskId}}) — no new commits, returning to todo", - "level": "warn" - }, - "position": { - "x": 350, - "y": 2000 - }, - "outputs": [ - "default" - ] - }, - { - "id": "set-todo-cooldown", - "type": "action.update_task_status", - "label": "Set Todo (Cooldown)", - "config": { - "taskId": "{{taskId}}", - "status": "todo", - "taskTitle": "{{taskTitle}}" - }, - "position": { - "x": 350, - "y": 2130 - }, - "outputs": [ - "default" - ] - }, - { - "id": "set-todo-push-failed", - "type": "action.update_task_status", - "label": "Set Todo (Push Fail)", - "config": { - "taskId": "{{taskId}}", - "status": "todo", - "taskTitle": "{{taskTitle}}" - }, - "position": { - "x": 180, - "y": 2260 - }, - "outputs": [ - "default" - ] - }, - { - "id": "push-failure-blocking", - "type": "condition.expression", - "label": "Push Failure Blocks?", - "config": { - "expression": "$ctx.getNodeOutput('push-branch')?.implementationDone === true" - }, - "position": { - "x": 360, - "y": 2195 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "set-blocked-push-failed", - "type": "action.update_task_status", - "label": "Set Blocked (Push Fail)", - "config": { - "taskId": "{{taskId}}", - "status": "blocked", - "taskTitle": "{{taskTitle}}", - "blockedReason": "{{$ctx.getNodeOutput('push-branch')?.blockedReason || $ctx.getNodeOutput('push-branch')?.error || 'implementation_done_commit_blocked'}}" - }, - "position": { - "x": 360, - "y": 2325 - }, - "outputs": [ - "default" - ] - }, - { - "id": "create-pr-retry", - "type": "action.create_pr", - "label": "Recover PR Link", - "config": { - "title": "{{taskTitle}}", - "body": "Task-ID: {{taskId}}\n\nAutomated PR for task {{taskId}}", - "base": "{{baseBranch}}", - "branch": "{{branch}}", - "cwd": "{{worktreePath}}", - "failOnError": false, - "enableAutoMerge": "{{autoMergeOnCreate}}", - "autoMergeMethod": "{{autoMergeMethod}}" - }, - "position": { - "x": 400, - "y": 1740 - }, - "outputs": [ - "default" - ] - }, - { - "id": "pr-created-stolen", - "type": "condition.expression", - "label": "PR Linked After Claim Loss?", - "config": { - "expression": "Boolean($ctx.getNodeOutput('create-pr-retry')?.success === true && ($ctx.getNodeOutput('create-pr-retry')?.prNumber || $ctx.getNodeOutput('create-pr-retry')?.prUrl))" - }, - "position": { - "x": 400, - "y": 1870 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "set-inreview-stolen", - "type": "action.update_task_status", - "label": "Set In-Review (Recovered)", - "config": { - "taskId": "{{taskId}}", - "status": "inreview", - "taskTitle": "{{taskTitle}}" - }, - "position": { - "x": 250, - "y": 2000 - }, - "outputs": [ - "default" - ] - }, - { - "id": "handoff-pr-progressor-stolen", - "type": "action.execute_workflow", - "label": "Handoff PR Progressor (Recovered)", - "config": { - "workflowId": "template-bosun-pr-progressor", - "mode": "dispatch", - "input": { - "taskId": "{{taskId}}", - "taskTitle": "{{taskTitle}}", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "prNumber": "{{$ctx.getNodeOutput('create-pr-retry')?.prNumber ?? $data?.prNumber ?? null}}", - "prUrl": "{{$ctx.getNodeOutput('create-pr-retry')?.prUrl || $data?.prUrl || ''}}", - "repo": "{{$ctx.getNodeOutput('create-pr-retry')?.repoSlug || $data?.repo || $data?.repoSlug || $data?.repository || ''}}" - } - }, - "position": { - "x": 120, - "y": 2130 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-claim-stolen-recovered", - "type": "notify.log", - "label": "Log Claim Loss Recovery", - "config": { - "message": "Task \"{{taskTitle}}\" ({{taskId}}) — claim lost after PR link recovery, keeping inreview", - "level": "warn" - }, - "position": { - "x": 120, - "y": 2260 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-claim-stolen", - "type": "notify.log", - "label": "Log Claim Stolen", - "config": { - "message": "Task \"{{taskTitle}}\" ({{taskId}}) — claim was stolen, aborting", - "level": "warn" - }, - "position": { - "x": 550, - "y": 2000 - }, - "outputs": [ - "default" - ] - }, - { - "id": "set-todo-stolen", - "type": "action.update_task_status", - "label": "Set Todo (Stolen)", - "config": { - "taskId": "{{taskId}}", - "status": "todo", - "taskTitle": "{{taskTitle}}" - }, - "position": { - "x": 550, - "y": 2130 - }, - "outputs": [ - "default" - ] - }, - { - "id": "join-outcomes", - "type": "flow.join", - "label": "Join Outcome Paths", - "config": { - "mode": "all", - "sourceNodeIds": [ - "log-success", - "set-todo-push-failed", - "set-blocked-push-failed", - "set-todo-cooldown", - "notify-validation-blocked", - "set-todo-stolen", - "log-claim-stolen-recovered" - ], - "includeSkipped": true - }, - "position": { - "x": 200, - "y": 2560 - }, - "outputs": [ - "default" - ] - }, - { - "id": "release-worktree", - "type": "action.release_worktree", - "label": "Release Worktree", - "config": { - "worktreePath": "{{worktreePath}}", - "repoRoot": "{{repoRoot}}", - "taskId": "{{taskId}}" - }, - "position": { - "x": 200, - "y": 2700 - }, - "outputs": [ - "default" - ] - }, - { - "id": "release-claim", - "type": "action.release_claim", - "label": "Release Claim", - "config": { - "taskId": "{{taskId}}" - }, - "position": { - "x": 200, - "y": 2830 - }, - "outputs": [ - "default" - ] - }, - { - "id": "release-slot", - "type": "action.release_slot", - "label": "Release Slot", - "config": { - "taskId": "{{taskId}}" - }, - "position": { - "x": 200, - "y": 2960 - }, - "outputs": [ - "default" - ] - }, - { - "id": "release-slot-claim-failed", - "type": "action.release_slot", - "label": "Release Slot (Claim Fail)", - "config": { - "taskId": "{{taskId}}" - }, - "position": { - "x": 650, - "y": 700 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-claim-failed", - "type": "notify.log", - "label": "Log Claim Failed", - "config": { - "message": "Task \"{{taskTitle}}\" ({{taskId}}) — already claimed, skipping", - "level": "info" - }, - "position": { - "x": 650, - "y": 830 - }, - "outputs": [ - "default" - ] - }, - { - "id": "release-claim-wt-failed", - "type": "action.release_claim", - "label": "Release Claim (WT Fail)", - "config": { - "taskId": "{{taskId}}" - }, - "position": { - "x": 600, - "y": 1090 - }, - "outputs": [ - "default" - ] - }, - { - "id": "wt-failure-blocking", - "type": "condition.expression", - "label": "Non-Retryable WT Failure?", - "config": { - "expression": "(() => { const retry = $ctx.getNodeOutput('retry-acquire-wt'); const latest = retry && retry.success === false ? retry : $ctx.getNodeOutput('acquire-worktree'); return latest?.retryable === false; })()" - }, - "position": { - "x": 600, - "y": 1220 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "set-blocked-wt-failed", - "type": "action.update_task_status", - "label": "Set Blocked (WT Fail)", - "config": { - "taskId": "{{taskId}}", - "status": "blocked", - "taskTitle": "{{taskTitle}}", - "blockedReason": "{{$ctx.getNodeOutput('retry-acquire-wt')?.success === false ? ($ctx.getNodeOutput('retry-acquire-wt')?.blockedReason || $ctx.getNodeOutput('retry-acquire-wt')?.error || '') : ($ctx.getNodeOutput('acquire-worktree')?.blockedReason || $ctx.getNodeOutput('acquire-worktree')?.error || '')}}" - }, - "position": { - "x": 470, - "y": 1350 - }, - "outputs": [ - "default" - ] - }, - { - "id": "annotate-blocked-wt-failed", - "type": "action.bosun_function", - "label": "Annotate Blocked (WT Fail)", - "config": { - "function": "tasks.update", - "args": { - "taskId": "{{taskId}}", - "fields": { - "cooldownUntil": "{{(() => { const retry = $ctx.getNodeOutput('retry-acquire-wt'); const output = retry && retry.success === false ? retry : ($ctx.getNodeOutput('acquire-worktree') || {}); return output.retryAt || null; })()}}", - "blockedReason": "{{(() => { const retry = $ctx.getNodeOutput('retry-acquire-wt'); const output = retry && retry.success === false ? retry : ($ctx.getNodeOutput('acquire-worktree') || {}); return output.blockedReason || output.error || null; })()}}", - "meta": "{{(() => { const current = ($data.meta && typeof $data.meta === 'object') ? $data.meta : (($data.taskMeta && typeof $data.taskMeta === 'object') ? $data.taskMeta : {}); const retry = $ctx.getNodeOutput('retry-acquire-wt'); const output = retry && retry.success === false ? retry : ($ctx.getNodeOutput('acquire-worktree') || {}); const worktreePath = output.worktreePath || $data.worktreePath || ''; const repoRoot = $data.repoRoot || $data.workspace || current.repoRoot || current.workspace || ''; const branch = $data.branch || $data.branchName || current.branch || current.branchName || ''; const baseBranch = $data.baseBranch || current.baseBranch || ''; const defaultTargetBranch = $data.defaultTargetBranch || current.defaultTargetBranch || ''; return { ...current, autoRecovery: { active: true, reason: 'worktree_failure', failureKind: output.failureKind || 'branch_refresh_conflict', retryAt: output.retryAt || null, recoveryDelayMs: output.autoRecoverDelayMs || null, error: output.error || '', recordedAt: output.recordedAt || null }, worktreeFailure: { failureKind: output.failureKind || 'branch_refresh_conflict', retryable: output.retryable !== false, retryAt: output.retryAt || null, blockedReason: output.blockedReason || output.error || '', error: output.error || '', recordedAt: output.recordedAt || null, repairArtifacts: output.repairArtifacts || null, branch, repoRoot, baseBranch, defaultTargetBranch, worktreePath } }; })()}}" - } - } - }, - "position": { - "x": 470, - "y": 1480 - }, - "outputs": [ - "default" - ] - }, - { - "id": "dispatch-wt-repair", - "type": "action.execute_workflow", - "label": "Dispatch WT Repair", - "config": { - "workflowId": "template-task-repair-worktree", - "mode": "dispatch", - "input": { - "taskId": "{{taskId}}", - "taskTitle": "{{taskTitle}}", - "repoRoot": "{{repoRoot}}", - "worktreePath": "{{$ctx.getNodeOutput('retry-acquire-wt')?.success === false ? ($ctx.getNodeOutput('retry-acquire-wt')?.worktreePath || $data.worktreePath || '') : ($ctx.getNodeOutput('acquire-worktree')?.worktreePath || $data.worktreePath || '')}}", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "defaultTargetBranch": "{{defaultTargetBranch}}", - "error": "{{$ctx.getNodeOutput('retry-acquire-wt')?.success === false ? ($ctx.getNodeOutput('retry-acquire-wt')?.error || $ctx.getNodeOutput('retry-acquire-wt')?.blockedReason || 'worktree acquisition failed') : ($ctx.getNodeOutput('acquire-worktree')?.error || $ctx.getNodeOutput('acquire-worktree')?.blockedReason || 'worktree acquisition failed')}}", - "failureKind": "{{$ctx.getNodeOutput('retry-acquire-wt')?.success === false ? ($ctx.getNodeOutput('retry-acquire-wt')?.failureKind || 'branch_refresh_conflict') : ($ctx.getNodeOutput('acquire-worktree')?.failureKind || 'branch_refresh_conflict')}}", - "repairArtifacts": "{{$ctx.getNodeOutput('retry-acquire-wt')?.success === false ? ($ctx.getNodeOutput('retry-acquire-wt')?.repairArtifacts || null) : ($ctx.getNodeOutput('acquire-worktree')?.repairArtifacts || null)}}" - } - }, - "position": { - "x": 470, - "y": 1610 - }, - "outputs": [ - "default" - ] - }, - { - "id": "set-todo-wt-failed", - "type": "action.update_task_status", - "label": "Set Todo (WT Fail)", - "config": { - "taskId": "{{taskId}}", - "status": "todo", - "taskTitle": "{{taskTitle}}" - }, - "position": { - "x": 730, - "y": 1350 - }, - "outputs": [ - "default" - ] - }, - { - "id": "release-slot-wt-failed", - "type": "action.release_slot", - "label": "Release Slot (WT Fail)", - "config": { - "taskId": "{{taskId}}" - }, - "position": { - "x": 600, - "y": 1480 - }, - "outputs": [ - "default" - ] - }, - { - "id": "notify-wt-failed", - "type": "notify.telegram", - "label": "Notify WT Failed", - "config": { - "message": "⚠️ Worktree failed for \"{{taskTitle}}\" ({{taskId}}){{$ctx.getNodeOutput('retry-acquire-wt')?.success === false ? ($ctx.getNodeOutput('retry-acquire-wt')?.recoveryNote || '') : ($ctx.getNodeOutput('acquire-worktree')?.recoveryNote || '')}}" - }, - "position": { - "x": 600, - "y": 1740 - }, - "outputs": [ - "default" - ] - }, - { - "id": "wt-retry-eligible", - "type": "condition.expression", - "label": "Retryable WT Failure?", - "config": { - "expression": "$ctx.getNodeOutput('acquire-worktree')?.retryable !== false" - }, - "position": { - "x": 850, - "y": 960 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "recover-worktree", - "type": "action.recover_worktree", - "label": "Clean Broken WT", - "config": { - "repoRoot": "{{repoRoot}}", - "branch": "{{branch}}", - "taskId": "{{taskId}}" - }, - "position": { - "x": 850, - "y": 1090 - }, - "outputs": [ - "default" - ] - }, - { - "id": "retry-acquire-wt", - "type": "action.acquire_worktree", - "label": "Retry Acquire WT", - "config": { - "repoRoot": "{{repoRoot}}", - "branch": "{{branch}}", - "taskId": "{{taskId}}", - "baseBranch": "{{baseBranch}}", - "defaultTargetBranch": "{{defaultTargetBranch}}" - }, - "position": { - "x": 850, - "y": 1220 - }, - "outputs": [ - "default" - ] - }, - { - "id": "retry-wt-ok", - "type": "condition.expression", - "label": "Retry WT OK?", - "config": { - "expression": "$ctx.getNodeOutput('retry-acquire-wt')?.success === true" - }, - "position": { - "x": 850, - "y": 1350 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "sweep-task-wts", - "type": "action.sweep_task_worktrees", - "label": "Sweep Task WTs", - "config": { - "repoRoot": "{{repoRoot}}", - "taskId": "{{taskId}}" - }, - "position": { - "x": 200, - "y": 3090 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->check-slots", - "source": "trigger", - "target": "check-slots", - "sourcePort": "default" - }, - { - "id": "check-slots->allocate-slot", - "source": "check-slots", - "target": "allocate-slot", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "allocate-slot->claim-task", - "source": "allocate-slot", - "target": "claim-task", - "sourcePort": "default" - }, - { - "id": "claim-task->claim-ok", - "source": "claim-task", - "target": "claim-ok", - "sourcePort": "default" - }, - { - "id": "claim-ok->set-inprogress", - "source": "claim-ok", - "target": "set-inprogress", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "set-inprogress->acquire-worktree", - "source": "set-inprogress", - "target": "acquire-worktree", - "sourcePort": "default" - }, - { - "id": "acquire-worktree->worktree-ok", - "source": "acquire-worktree", - "target": "worktree-ok", - "sourcePort": "default" - }, - { - "id": "worktree-ok->resolve-executor", - "source": "worktree-ok", - "target": "resolve-executor", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "resolve-executor->record-head", - "source": "resolve-executor", - "target": "record-head", - "sourcePort": "default" - }, - { - "id": "record-head->read-workflow-contract", - "source": "record-head", - "target": "read-workflow-contract", - "sourcePort": "default" - }, - { - "id": "read-workflow-contract->workflow-contract-validation", - "source": "read-workflow-contract", - "target": "workflow-contract-validation", - "sourcePort": "default" - }, - { - "id": "workflow-contract-validation->build-prompt", - "source": "workflow-contract-validation", - "target": "build-prompt", - "sourcePort": "default" - }, - { - "id": "build-prompt->run-agent-plan", - "source": "build-prompt", - "target": "run-agent-plan", - "sourcePort": "default" - }, - { - "id": "run-agent-plan->run-agent-tests", - "source": "run-agent-plan", - "target": "run-agent-tests", - "sourcePort": "default" - }, - { - "id": "run-agent-tests->run-agent-implement", - "source": "run-agent-tests", - "target": "run-agent-implement", - "sourcePort": "default" - }, - { - "id": "run-agent-implement->claim-stolen", - "source": "run-agent-implement", - "target": "claim-stolen", - "sourcePort": "default" - }, - { - "id": "claim-stolen->auto-commit-dirty", - "source": "claim-stolen", - "target": "auto-commit-dirty", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "auto-commit-dirty->detect-commits", - "source": "auto-commit-dirty", - "target": "detect-commits", - "sourcePort": "default" - }, - { - "id": "detect-commits->has-commits", - "source": "detect-commits", - "target": "has-commits", - "sourcePort": "default" - }, - { - "id": "has-commits->pre-pr-validation", - "source": "has-commits", - "target": "pre-pr-validation", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "pre-pr-validation->pre-pr-validation-ok", - "source": "pre-pr-validation", - "target": "pre-pr-validation-ok", - "sourcePort": "default" - }, - { - "id": "pre-pr-validation-ok->push-branch", - "source": "pre-pr-validation-ok", - "target": "push-branch", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "pre-pr-validation-ok->set-fix-summary", - "source": "pre-pr-validation-ok", - "target": "set-fix-summary", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "set-fix-summary->auto-fix-validation", - "source": "set-fix-summary", - "target": "auto-fix-validation", - "sourcePort": "default" - }, - { - "id": "auto-fix-validation->retry-pre-pr-validation", - "source": "auto-fix-validation", - "target": "retry-pre-pr-validation", - "sourcePort": "default" - }, - { - "id": "retry-pre-pr-validation->retry-validation-ok", - "source": "retry-pre-pr-validation", - "target": "retry-validation-ok", - "sourcePort": "default" - }, - { - "id": "retry-validation-ok->push-branch", - "source": "retry-validation-ok", - "target": "push-branch", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "retry-validation-ok->set-fix2-summary", - "source": "retry-validation-ok", - "target": "set-fix2-summary", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "set-fix2-summary->auto-fix-validation-2", - "source": "set-fix2-summary", - "target": "auto-fix-validation-2", - "sourcePort": "default" - }, - { - "id": "auto-fix-validation-2->retry2-pre-pr-validation", - "source": "auto-fix-validation-2", - "target": "retry2-pre-pr-validation", - "sourcePort": "default" - }, - { - "id": "retry2-pre-pr-validation->retry2-validation-ok", - "source": "retry2-pre-pr-validation", - "target": "retry2-validation-ok", - "sourcePort": "default" - }, - { - "id": "retry2-validation-ok->push-branch", - "source": "retry2-validation-ok", - "target": "push-branch", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "retry2-validation-ok->log-validation-failed", - "source": "retry2-validation-ok", - "target": "log-validation-failed", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "log-validation-failed->set-blocked-validation-failed", - "source": "log-validation-failed", - "target": "set-blocked-validation-failed", - "sourcePort": "default" - }, - { - "id": "set-blocked-validation-failed->notify-validation-blocked", - "source": "set-blocked-validation-failed", - "target": "notify-validation-blocked", - "sourcePort": "default" - }, - { - "id": "notify-validation-blocked->join-outcomes", - "source": "notify-validation-blocked", - "target": "join-outcomes", - "sourcePort": "default" - }, - { - "id": "push-branch->push-ok", - "source": "push-branch", - "target": "push-ok", - "sourcePort": "default" - }, - { - "id": "push-ok->create-pr", - "source": "push-ok", - "target": "create-pr", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "create-pr->pr-created", - "source": "create-pr", - "target": "pr-created", - "sourcePort": "default" - }, - { - "id": "pr-created->set-inreview", - "source": "pr-created", - "target": "set-inreview", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "pr-created->set-todo-push-failed", - "source": "pr-created", - "target": "set-todo-push-failed", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "set-inreview->handoff-pr-progressor", - "source": "set-inreview", - "target": "handoff-pr-progressor", - "sourcePort": "default" - }, - { - "id": "handoff-pr-progressor->log-success", - "source": "handoff-pr-progressor", - "target": "log-success", - "sourcePort": "default" - }, - { - "id": "log-success->join-outcomes", - "source": "log-success", - "target": "join-outcomes", - "sourcePort": "default" - }, - { - "id": "push-ok->push-failure-blocking", - "source": "push-ok", - "target": "push-failure-blocking", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "push-failure-blocking->set-blocked-push-failed", - "source": "push-failure-blocking", - "target": "set-blocked-push-failed", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "push-failure-blocking->set-todo-push-failed", - "source": "push-failure-blocking", - "target": "set-todo-push-failed", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "set-blocked-push-failed->join-outcomes", - "source": "set-blocked-push-failed", - "target": "join-outcomes", - "sourcePort": "default" - }, - { - "id": "set-todo-push-failed->join-outcomes", - "source": "set-todo-push-failed", - "target": "join-outcomes", - "sourcePort": "default" - }, - { - "id": "has-commits->log-no-commits", - "source": "has-commits", - "target": "log-no-commits", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "log-no-commits->set-todo-cooldown", - "source": "log-no-commits", - "target": "set-todo-cooldown", - "sourcePort": "default" - }, - { - "id": "set-todo-cooldown->join-outcomes", - "source": "set-todo-cooldown", - "target": "join-outcomes", - "sourcePort": "default" - }, - { - "id": "claim-stolen->create-pr-retry", - "source": "claim-stolen", - "target": "create-pr-retry", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "create-pr-retry->pr-created-stolen", - "source": "create-pr-retry", - "target": "pr-created-stolen", - "sourcePort": "default" - }, - { - "id": "pr-created-stolen->set-inreview-stolen", - "source": "pr-created-stolen", - "target": "set-inreview-stolen", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "set-inreview-stolen->handoff-pr-progressor-stolen", - "source": "set-inreview-stolen", - "target": "handoff-pr-progressor-stolen", - "sourcePort": "default" - }, - { - "id": "handoff-pr-progressor-stolen->log-claim-stolen-recovered", - "source": "handoff-pr-progressor-stolen", - "target": "log-claim-stolen-recovered", - "sourcePort": "default" - }, - { - "id": "log-claim-stolen-recovered->join-outcomes", - "source": "log-claim-stolen-recovered", - "target": "join-outcomes", - "sourcePort": "default" - }, - { - "id": "pr-created-stolen->log-claim-stolen", - "source": "pr-created-stolen", - "target": "log-claim-stolen", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "log-claim-stolen->set-todo-stolen", - "source": "log-claim-stolen", - "target": "set-todo-stolen", - "sourcePort": "default" - }, - { - "id": "set-todo-stolen->join-outcomes", - "source": "set-todo-stolen", - "target": "join-outcomes", - "sourcePort": "default" - }, - { - "id": "join-outcomes->release-worktree", - "source": "join-outcomes", - "target": "release-worktree", - "sourcePort": "default" - }, - { - "id": "release-worktree->release-claim", - "source": "release-worktree", - "target": "release-claim", - "sourcePort": "default" - }, - { - "id": "release-claim->release-slot", - "source": "release-claim", - "target": "release-slot", - "sourcePort": "default" - }, - { - "id": "release-slot->sweep-task-wts", - "source": "release-slot", - "target": "sweep-task-wts", - "sourcePort": "default" - }, - { - "id": "claim-ok->release-slot-claim-failed", - "source": "claim-ok", - "target": "release-slot-claim-failed", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "release-slot-claim-failed->log-claim-failed", - "source": "release-slot-claim-failed", - "target": "log-claim-failed", - "sourcePort": "default" - }, - { - "id": "worktree-ok->wt-retry-eligible", - "source": "worktree-ok", - "target": "wt-retry-eligible", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "wt-retry-eligible->recover-worktree", - "source": "wt-retry-eligible", - "target": "recover-worktree", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "recover-worktree->retry-acquire-wt", - "source": "recover-worktree", - "target": "retry-acquire-wt", - "sourcePort": "default" - }, - { - "id": "retry-acquire-wt->retry-wt-ok", - "source": "retry-acquire-wt", - "target": "retry-wt-ok", - "sourcePort": "default" - }, - { - "id": "retry-wt-ok->resolve-executor", - "source": "retry-wt-ok", - "target": "resolve-executor", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "retry-wt-ok->release-claim-wt-failed", - "source": "retry-wt-ok", - "target": "release-claim-wt-failed", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "wt-retry-eligible->release-claim-wt-failed", - "source": "wt-retry-eligible", - "target": "release-claim-wt-failed", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "release-claim-wt-failed->wt-failure-blocking", - "source": "release-claim-wt-failed", - "target": "wt-failure-blocking", - "sourcePort": "default" - }, - { - "id": "wt-failure-blocking->set-blocked-wt-failed", - "source": "wt-failure-blocking", - "target": "set-blocked-wt-failed", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "wt-failure-blocking->set-todo-wt-failed", - "source": "wt-failure-blocking", - "target": "set-todo-wt-failed", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "set-blocked-wt-failed->annotate-blocked-wt-failed", - "source": "set-blocked-wt-failed", - "target": "annotate-blocked-wt-failed", - "sourcePort": "default" - }, - { - "id": "annotate-blocked-wt-failed->dispatch-wt-repair", - "source": "annotate-blocked-wt-failed", - "target": "dispatch-wt-repair", - "sourcePort": "default" - }, - { - "id": "dispatch-wt-repair->release-slot-wt-failed", - "source": "dispatch-wt-repair", - "target": "release-slot-wt-failed", - "sourcePort": "default" - }, - { - "id": "set-todo-wt-failed->release-slot-wt-failed", - "source": "set-todo-wt-failed", - "target": "release-slot-wt-failed", - "sourcePort": "default" - }, - { - "id": "release-slot-wt-failed->notify-wt-failed", - "source": "release-slot-wt-failed", - "target": "notify-wt-failed", - "sourcePort": "default" - } - ] - }, - { - "id": "template-webhook-task-router", - "name": "Webhook Task Router", - "description": "Routes inbound webhook events to tasks, exercising webhook trigger, tag checks, file-exists conditions, template transforms, task creation, and webhook acknowledgements.", - "category": "coverage", - "categoryLabel": "Coverage", - "categoryIcon": ":settings:", - "categoryOrder": 99, - "tags": [ - "coverage", - "webhook", - "routing" - ], - "nodeCount": 7, - "edgeCount": 7, - "recommended": false, - "enabled": true, - "trigger": "trigger.webhook", - "variables": { - "taskTags": [ - "priority" - ], - "webhookEventType": "task.created", - "requiredTag": "priority", - "configFile": "/nonexistent/config.json", - "webhookCallbackUrl": "http://localhost:65000/webhook/ack" - }, - "metadata": { - "author": "virtengine", - "tags": [ - "coverage", - "webhook", - "routing" - ] - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.webhook", - "label": "Webhook Trigger", - "config": { - "eventType": "{{webhookEventType}}" - }, - "position": { - "x": 100, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "render-msg", - "type": "transform.template", - "label": "Render Message", - "config": { - "template": "Task created: {{webhook.payload.title || 'unknown'}}" - }, - "position": { - "x": 380, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "check-tag", - "type": "condition.task_has_tag", - "label": "Has Priority Tag?", - "config": { - "tag": "{{requiredTag}}", - "field": "tags" - }, - "position": { - "x": 660, - "y": 100 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "check-config", - "type": "condition.file_exists", - "label": "Config Exists?", - "config": { - "path": "{{configFile}}" - }, - "position": { - "x": 940, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-skip", - "type": "notify.log", - "label": "Log Skipped", - "config": { - "message": "Skipped — no priority tag", - "level": "info" - }, - "position": { - "x": 1220, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "create-task", - "type": "action.create_task", - "label": "Create Task", - "config": { - "title": "Webhook task: {{webhookEventType}}", - "tags": "{{taskTags}}" - }, - "position": { - "x": 1500, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "notify-out", - "type": "notify.webhook_out", - "label": "Acknowledge Webhook", - "config": { - "url": "{{webhookCallbackUrl}}", - "payload": { - "status": "processed" - } - }, - "position": { - "x": 1780, - "y": 100 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->render-msg", - "source": "trigger", - "target": "render-msg", - "sourcePort": "default" - }, - { - "id": "render-msg->check-tag", - "source": "render-msg", - "target": "check-tag", - "sourcePort": "default" - }, - { - "id": "check-tag->check-config", - "source": "check-tag", - "target": "check-config", - "sourcePort": "yes" - }, - { - "id": "check-tag->log-skip", - "source": "check-tag", - "target": "log-skip", - "sourcePort": "no" - }, - { - "id": "check-config->create-task", - "source": "check-config", - "target": "create-task", - "sourcePort": "default" - }, - { - "id": "log-skip->create-task", - "source": "log-skip", - "target": "create-task", - "sourcePort": "default" - }, - { - "id": "create-task->notify-out", - "source": "create-task", - "target": "notify-out", - "sourcePort": "default" - } - ] - }, - { - "id": "template-workflow-composition", - "name": "Workflow Composition", - "description": "Compose workflows from smaller sub-workflows using action.invoke_workflow. Demonstrates workflow-to-workflow data piping: the parent workflow invokes a child workflow, extracts specific output fields, and forwards them to downstream nodes. Supports both sync and dispatch modes.", - "category": "mcp-integration", - "categoryLabel": "Mcp Integration", - "categoryIcon": ":settings:", - "categoryOrder": 99, - "tags": [ - "workflow", - "composition", - "sub-workflow", - "piping", - "orchestration" - ], - "nodeCount": 6, - "edgeCount": 5, - "recommended": false, - "enabled": true, - "trigger": "trigger.manual", - "variables": { - "childWorkflowId": "template-health-check", - "inputPayload": "{}" - }, - "metadata": { - "author": "virtengine", - "tags": [ - "workflow", - "composition", - "sub-workflow", - "piping", - "orchestration" - ] - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.manual", - "label": "Start", - "config": {}, - "position": { - "x": 100, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "list-workflows", - "type": "action.bosun_function", - "label": "List Workflows", - "config": { - "function": "workflows.list", - "outputVariable": "allWorkflows" - }, - "position": { - "x": 380, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "invoke-child", - "type": "action.invoke_workflow", - "label": "Invoke Sub-Workflow", - "config": { - "workflowId": "{{childWorkflowId}}", - "input": "{{inputPayload}}", - "mode": "sync", - "timeout": 120000, - "failOnError": false, - "outputVariable": "childResult" - }, - "position": { - "x": 660, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "check-success", - "type": "condition.expression", - "label": "Success?", - "config": { - "expression": "{{invoke-child.success}}" - }, - "position": { - "x": 940, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "process-output", - "type": "notify.log", - "label": "Process Output", - "config": { - "message": "Sub-workflow '{{childWorkflowId}}' succeeded. Run ID: {{invoke-child.runId}}", - "level": "info" - }, - "position": { - "x": 1220, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "handle-failure", - "type": "notify.log", - "label": "Handle Failure", - "config": { - "message": "Sub-workflow '{{childWorkflowId}}' failed with {{invoke-child.errorCount}} error(s). First error: {{invoke-child.errors}}", - "level": "error" - }, - "position": { - "x": 1500, - "y": 100 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->list-workflows", - "source": "trigger", - "target": "list-workflows", - "sourcePort": "default" - }, - { - "id": "list-workflows->invoke-child", - "source": "list-workflows", - "target": "invoke-child", - "sourcePort": "default" - }, - { - "id": "invoke-child->check-success", - "source": "invoke-child", - "target": "check-success", - "sourcePort": "default" - }, - { - "id": "check-success->process-output", - "source": "check-success", - "target": "process-output", - "sourcePort": "true" - }, - { - "id": "check-success->handle-failure", - "source": "check-success", - "target": "handle-failure", - "sourcePort": "false" - } - ] - } - ], - "workflows": [ - { - "id": "wf-bosun-pr-progressor", - "name": "Bosun PR Progressor", - "description": "Direct per-PR progression workflow for bosun-managed tasks. Runs immediately after PR handoff, evaluates a single PR, retries simple CI failures, dispatches focused repair when needed, and performs the first merge-review pass without waiting for the periodic watchdog.", - "category": "github", - "enabled": true, - "nodeCount": 17, - "trigger": "trigger.workflow_call", - "variables": { - "mergeMethod": "merge", - "labelNeedsFix": "bosun-needs-fix", - "labelNeedsReview": "bosun-needs-human-review", - "suspiciousDeletionRatio": 3, - "minDestructiveDeletions": 500 - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.workflow_call", - "label": "PR Handoff", - "config": { - "inputs": { - "taskId": { - "type": "string", - "required": false - }, - "taskTitle": { - "type": "string", - "required": false - }, - "branch": { - "type": "string", - "required": false - }, - "baseBranch": { - "type": "string", - "required": false, - "default": "main" - }, - "prNumber": { - "type": "number", - "required": false - }, - "prUrl": { - "type": "string", - "required": false - }, - "repo": { - "type": "string", - "required": false - } - } - }, - "position": { - "x": 400, - "y": 50 - }, - "outputs": [ - "default" - ] - }, - { - "id": "normalize-context", - "type": "action.set_variable", - "label": "Normalize PR Context", - "config": { - "key": "prProgressContext", - "value": "/* */ (() => { const prOut = $ctx.getNodeOutput('create-pr') || $ctx.getNodeOutput('create-pr-retry') || {}; const prUrl = String($data?.prUrl || prOut?.prUrl || prOut?.url || '').trim(); const repoMatch = prUrl.match(/github\\.com\\/([^/]+\\/[^/?#]+)/i); const repo = String($data?.repo || (repoMatch ? repoMatch[1] : '')).trim(); const rawPrNumber = $data?.prNumber ?? prOut?.prNumber ?? null; const parsedPrNumber = Number.parseInt(String(rawPrNumber || ''), 10); return { taskId: String($data?.taskId || '').trim() || null, taskTitle: String($data?.taskTitle || '').trim() || null, repo: repo || null, branch: String($data?.branch || prOut?.branch || '').trim() || null, baseBranch: String($data?.baseBranch || prOut?.base || 'main').trim() || 'main', prNumber: Number.isFinite(parsedPrNumber) && parsedPrNumber > 0 ? parsedPrNumber : null, prUrl: prUrl || null, };})()", - "isExpression": true - }, - "position": { - "x": 400, - "y": 180 - }, - "outputs": [ - "default" - ] - }, - { - "id": "has-pr-target", - "type": "condition.expression", - "label": "Has PR Target?", - "config": { - "expression": "Boolean($data?.prProgressContext?.prNumber && ($data?.prProgressContext?.repo || $data?.prProgressContext?.prUrl))" - }, - "position": { - "x": 400, - "y": 300 - }, - "outputs": [ - "default" - ] - }, - { - "id": "inspect-pr", - "type": "action.run_command", - "label": "Inspect Single PR", - "config": { - "command": "node", - "args": [ - "-e", - "const {execFileSync}=require('child_process'); const ctx=(()=>{try{return JSON.parse(String(process.env.BOSUN_PR_CONTEXT||'{}'))}catch{return {}}})(); const repo=String(ctx.repo||'').trim(); const branch=String(ctx.branch||'').trim(); const baseBranch=String(ctx.baseBranch||'main').trim()||'main'; const rawNumber=String(ctx.prNumber||'').trim(); const prNumber=Number.parseInt(rawNumber,10); if(!repo||!Number.isFinite(prNumber)||prNumber<=0){ console.log(JSON.stringify({success:false,classification:'missing',reason:'missing_repo_or_pr',repo,prNumber:Number.isFinite(prNumber)?prNumber:null,branch,baseBranch})); process.exit(0); } function gh(args){return execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();} function safeGhJson(args,fallback){try{const out=gh(args);return out?JSON.parse(out):fallback;}catch{return fallback;}} function truncateText(value,max){const text=String(value||'').replace(/\\r/g,'').trim();if(!text)return '';return text.length>max?text.slice(0,Math.max(0,max-19))+'\\n...[truncated]':text;} function compactUser(user){const login=String(user?.login||user?.name||'').trim();return login?{login,url:String(user?.url||user?.html_url||'').trim()||null}:null;} function compactCheck(check){const name=String(check?.name||check?.context||check?.workflowName||'').trim();const state=String(check?.state||check?.conclusion||'').toUpperCase();const bucket=String(check?.bucket||'').toUpperCase();if(!name&&!state&&!bucket)return null;return {name:name||null,state:state||null,bucket:bucket||null,workflow:String(check?.workflowName||'').trim()||null};} function compactIssueComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,updatedAt:String(comment?.updated_at||comment?.updatedAt||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactReview(review){return {id:Number(review?.id||0)||null,author:compactUser(review?.user||review?.author),state:String(review?.state||'').trim()||null,submittedAt:String(review?.submitted_at||review?.submittedAt||'').trim()||null,commitId:String(review?.commit_id||review?.commitId||'').trim()||null,body:truncateText(review?.body,1200)};} function compactReviewComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),path:String(comment?.path||'').trim()||null,line:Number(comment?.line||0)||Number(comment?.original_line||0)||null,startLine:Number(comment?.start_line||0)||null,side:String(comment?.side||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactFile(file){const path=String(file?.filename||file?.path||'').trim();return path?{path,status:String(file?.status||'').trim()||null,additions:Number(file?.additions||0)||0,deletions:Number(file?.deletions||0)||0,changes:Number(file?.changes||0)||0}:null;} function collectPrDigest(fallback){ const pr=safeGhJson(['pr','view',String(prNumber),'--repo',repo,'--json','number,title,body,url,headRefName,baseRefName,isDraft,mergeable,statusCheckRollup,author,labels,reviewDecision'],{}); const issueComments=safeGhJson(['api','repos/'+repo+'/issues/'+prNumber+'/comments?per_page=100'],[]).map(compactIssueComment).slice(0,40); const reviews=safeGhJson(['api','repos/'+repo+'/pulls/'+prNumber+'/reviews?per_page=100'],[]).map(compactReview).slice(0,40); const reviewComments=safeGhJson(['api','repos/'+repo+'/pulls/'+prNumber+'/comments?per_page=100'],[]).map(compactReviewComment).slice(0,60); const files=safeGhJson(['api','repos/'+repo+'/pulls/'+prNumber+'/files?per_page=100'],[]).map(compactFile).filter(Boolean).slice(0,80); const requested=safeGhJson(['api','repos/'+repo+'/pulls/'+prNumber+'/requested_reviewers'],{}); const requestedReviewers=[...(Array.isArray(requested?.users)?requested.users:[]).map(compactUser),...(Array.isArray(requested?.teams)?requested.teams:[]).map((team)=>{const slug=String(team?.slug||team?.name||'').trim();return slug?{team:slug,url:String(team?.html_url||team?.url||'').trim()||null}:null;})].filter(Boolean); const checks=(Array.isArray(pr.statusCheckRollup)?pr.statusCheckRollup:[]).map(compactCheck).filter(Boolean); const labels=(Array.isArray(pr.labels)?pr.labels:[]).map((label)=>String(label?.name||label||'').trim()).filter(Boolean); const passingChecks=checks.filter((check)=>check.state==='SUCCESS' || check.bucket==='PASS'); const failingChecks=checks.filter((check)=>['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE'].includes(check.state)||check.bucket==='FAIL'); const pendingChecks=checks.filter((check)=>['QUEUED','IN_PROGRESS','PENDING','WAITING','REQUESTED'].includes(check.state)); const digestSummary=[ 'PR #'+String(pr?.number||prNumber)+' '+String(pr?.title||fallback?.taskTitle||''), 'repo='+repo+' branch='+(String(pr?.headRefName||branch||'').trim()||'unknown')+' base='+(String(pr?.baseRefName||baseBranch||'main').trim()||'main'), 'mergeable='+(String(pr?.mergeable||'').trim()||'unknown')+' reviewDecision='+(String(pr?.reviewDecision||'').trim()||'none'), 'checks='+checks.length+' pass='+passingChecks.length+' fail='+failingChecks.length+' pending='+pendingChecks.length, 'comments='+issueComments.length+' reviews='+reviews.length+' reviewComments='+reviewComments.length+' files='+files.length, labels.length?'labels='+labels.join(', '):'', ].filter(Boolean).join('\\n'); return {core:{number:Number(pr?.number||prNumber)||prNumber,title:String(pr?.title||fallback?.taskTitle||''),url:String(pr?.url||ctx.prUrl||fallback?.prUrl||'').trim()||null,body:truncateText(pr?.body,4000),branch:String(pr?.headRefName||branch||'').trim()||null,baseBranch:String(pr?.baseRefName||baseBranch||'main').trim()||'main',isDraft:pr?.isDraft===true,mergeable:String(pr?.mergeable||'').trim()||null,author:compactUser(pr?.author),reviewDecision:String(pr?.reviewDecision||'').trim()||null},labels,requestedReviewers,checks,ciSummary:{total:checks.length,passing:passingChecks.length,failing:failingChecks.length,pending:pendingChecks.length},issueComments,reviews,reviewComments,files,digestSummary}; } const prDigest=collectPrDigest(ctx||{}); const pr=prDigest.core||{}; const checks=Array.isArray(prDigest.checks)?prDigest.checks:[]; const failStates=new Set(['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE']); const pendingStates=new Set(['QUEUED','IN_PROGRESS','PENDING','WAITING','REQUESTED']); const conflictMergeables=new Set(['CONFLICTING','DIRTY','UNKNOWN']); const failedCheckNames=checks.filter((c)=>{const s=String(c?.state||'').toUpperCase();const b=String(c?.bucket||'').toUpperCase();return failStates.has(s)||b==='FAIL';}).map((c)=>String(c?.name||'').trim()).filter(Boolean); const hasFailure=checks.some((c)=>{const s=String(c?.state||'').toUpperCase();const b=String(c?.bucket||'').toUpperCase();return failStates.has(s)||b==='FAIL';}); const hasPending=checks.some((c)=>pendingStates.has(String(c?.state||'').toUpperCase())); let classification='ready'; let reason='ready_for_review'; let ciKicked=false; if(pr?.isDraft===true){classification='draft';reason='draft_pr';} else if(conflictMergeables.has(String(pr?.mergeable||'').toUpperCase())){classification='conflict';reason='merge_conflict';} else if(hasFailure){classification='ci_failure';reason='ci_failed';} else if(hasPending){classification='pending';reason='ci_pending';} else if(checks.length===0 && branch){ try{gh(['workflow','run','ci.yaml','--repo',repo,'--ref',branch]);ciKicked=true;classification='pending';reason='ci_kicked';} catch{classification='ready';reason='ready_without_checks';} } console.log(JSON.stringify({success:true,repo,prNumber,url:String(pr?.url||ctx.prUrl||''),branch:String(pr?.branch||branch||''),baseBranch:String(pr?.baseBranch||baseBranch||'main'),title:String(pr?.title||ctx.taskTitle||''),mergeable:String(pr?.mergeable||''),reviewDecision:String(pr?.reviewDecision||'').trim()||null,labels:Array.isArray(prDigest.labels)?prDigest.labels:[],classification,reason,ciKicked,hasFailure,hasPending,failedCheckNames,checks,ciSummary:prDigest.ciSummary||null,prDigest,digestSummary:String(prDigest.digestSummary||'')}));" - ], - "continueOnError": true, - "failOnError": false, - "env": { - "BOSUN_PR_CONTEXT": "{{$data?.prProgressContext ? JSON.stringify($data.prProgressContext) : '{}'}}" - } - }, - "position": { - "x": 400, - "y": 430 - }, - "outputs": [ - "default" - ] - }, - { - "id": "fix-needed", - "type": "condition.expression", - "label": "Needs Repair?", - "config": { - "expression": "(()=>{try{const d=JSON.parse($ctx.getNodeOutput('inspect-pr')?.output||'{}');return d?.classification==='ci_failure' || d?.classification==='conflict';}catch{return false;}})()" - }, - "position": { - "x": 220, - "y": 560 - }, - "outputs": [ - "default" - ] - }, - { - "id": "programmatic-fix", - "type": "action.run_command", - "label": "Repair Attempt", - "config": { - "command": "node", - "args": [ - "-e", - "const {execFileSync}=require('child_process'); const data=(()=>{try{return JSON.parse(String(process.env.BOSUN_PR_INSPECT||'{}'))}catch{return {}}})(); const repo=String(data.repo||'').trim(); const branch=String(data.branch||'').trim(); const prNumber=Number.parseInt(String(data.prNumber||''),10); const classification=String(data.classification||'').trim(); const failedCheckNames=Array.isArray(data.failedCheckNames)?data.failedCheckNames:[]; const labelFix=String('{{labelNeedsFix}}'||'bosun-needs-fix'); const FAIL_STATES=new Set(['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE']); const MAX_AUTO_RERUN_ATTEMPT=1; function gh(args){return execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();} function normalizeRun(run){if(!run||typeof run!=='object')return null;return {databaseId:Number(run.databaseId||0)||null,attempt:Number(run.attempt||0)||0,conclusion:String(run.conclusion||''),status:String(run.status||''),workflowName:String(run.workflowName||run.name||''),displayTitle:String(run.displayTitle||run.name||''),url:String(run.url||''),createdAt:String(run.createdAt||''),updatedAt:String(run.updatedAt||'')}} function normalizeJob(job){if(!job||typeof job!=='object')return null;const steps=Array.isArray(job.steps)?job.steps:[];return {databaseId:Number(job.databaseId||job.id||0)||null,name:String(job.name||''),status:String(job.status||''),conclusion:String(job.conclusion||''),url:String(job.url||job.html_url||''),checkRunUrl:String(job.check_run_url||job.checkRunUrl||''),failedSteps:steps.filter((step)=>FAIL_STATES.has(String(step?.conclusion||step?.status||'').toUpperCase())).map((step)=>({name:String(step?.name||''),number:Number(step?.number||0)||null,status:String(step?.status||''),conclusion:String(step?.conclusion||'')})).filter((step)=>step.name).slice(0,10)}} function truncateText(value,max){const text=String(value||'').replace(/\\r/g,'').trim();if(!text)return '';return text.length>max?text.slice(0,Math.max(0,max-19))+'\\n...[truncated]':text;} const CI_LOG_EXCERPT_MAX_CHARS=12000;const CI_MAX_JOB_DIAGNOSTICS=10;const CI_MAX_ANNOTATIONS=60;function safeGhJsonRunner(runner,args,fallback){try{const out=runner(args);return out?JSON.parse(out):fallback;}catch{return fallback;}}function parseCheckRunId(value){const match=String(value||'').match(/\\/check-runs\\/(\\d+)/i);return match?Number(match[1]||0)||0:0;}function normalizeAnnotation(annotation){if(!annotation||typeof annotation!=='object')return null;const path=String(annotation.path||'').trim();const message=truncateText(annotation.message,1200);if(!path&&!message)return null;return {path:path||null,startLine:Number(annotation.start_line||0)||null,endLine:Number(annotation.end_line||0)||null,startColumn:Number(annotation.start_column||0)||null,endColumn:Number(annotation.end_column||0)||null,level:String(annotation.annotation_level||'').trim()||null,title:truncateText(annotation.title,300)||null,message,rawDetails:truncateText(annotation.raw_details,800)||null};}function collectCheckRunAnnotations(repo,checkRunId,runner){if(!repo||!checkRunId)return [];const annotations=[];for(let page=1;page<=3&&annotations.length=CI_MAX_ANNOTATIONS)break;}if(batch.length<50)break;}return annotations.slice(0,CI_MAX_ANNOTATIONS);}function collectCiDiagnostics(repo,run,runner){const info={failedRun:normalizeRun(run),failedJobs:[],failedAnnotations:[],failedLogExcerpt:'',diagnosticsError:''};const runId=Number(run?.databaseId||0)||0;if(!runId||!repo)return info;let workflowJobs=[];try{const viewRaw=runner(['run','view',String(runId),'--repo',repo,'--json','attempt,conclusion,status,workflowName,displayTitle,url,createdAt,updatedAt,jobs']);const view=(()=>{try{return JSON.parse(viewRaw||'{}')}catch{return {}}})();info.failedRun=normalizeRun({...run,...view});const apiJobs=safeGhJsonRunner(runner,['api','repos/'+repo+'/actions/runs/'+runId+'/jobs?per_page=100'],{});workflowJobs=Array.isArray(apiJobs?.jobs)?apiJobs.jobs:(Array.isArray(view.jobs)?view.jobs:[]);info.failedJobs=workflowJobs.map(normalizeJob).filter((job)=>job&&(FAIL_STATES.has(String(job.conclusion||'').toUpperCase())||job.failedSteps.length>0)).slice(0,CI_MAX_JOB_DIAGNOSTICS);}catch(e){info.diagnosticsError=String(e?.message||e);}try{for(const job of info.failedJobs){const checkRunId=parseCheckRunId(job?.checkRunUrl);const annotations=collectCheckRunAnnotations(repo,checkRunId,runner);if(annotations.length===0)continue;info.failedAnnotations.push({name:String(job?.name||''),checkRunId,annotations});if(info.failedAnnotations.length>=CI_MAX_JOB_DIAGNOSTICS)break;}}catch(e){const message=String(e?.message||e);if(message&&message!==info.diagnosticsError){info.diagnosticsError=info.diagnosticsError?info.diagnosticsError+' | '+message:message;}}try{info.failedLogExcerpt=truncateText(runner(['run','view',String(runId),'--repo',repo,'--log-failed']),CI_LOG_EXCERPT_MAX_CHARS);}catch(e){const message=String(e?.message||e);if(message&&message!==info.diagnosticsError){info.diagnosticsError=info.diagnosticsError?info.diagnosticsError+' | '+message:message;}}return info;} if(repo&&Number.isFinite(prNumber)&&prNumber>0){ try{gh(['pr','edit',String(prNumber),'--repo',repo,'--add-label',labelFix]);}catch{} } if(classification==='ci_failure'&&repo&&branch){ try{ const listRaw=gh(['run','list','--repo',repo,'--branch',branch,'--json','databaseId,attempt,conclusion,status,workflowName,displayTitle,url,createdAt,updatedAt','--limit','8']); const runs=(()=>{try{return JSON.parse(listRaw||'[]')}catch{return []}})(); const failed=(Array.isArray(runs)?runs:[]).find((r)=>FAIL_STATES.has(String(r?.conclusion||'').toUpperCase())); const failedRun=normalizeRun(failed); if(failedRun?.databaseId&&failedRun.attempt<=MAX_AUTO_RERUN_ATTEMPT){gh(['run','rerun',String(failedRun.databaseId),'--repo',repo]);console.log(JSON.stringify({success:true,rerunRequested:true,needsAgent:false,reason:'rerun_requested',failedCheckNames,failedRun}));process.exit(0);} if(failedRun?.databaseId){const diagnostics=collectCiDiagnostics(repo,failedRun,gh);console.log(JSON.stringify({success:false,rerunRequested:false,needsAgent:true,reason:'auto_rerun_limit_reached',failedCheckNames,rerunAttempts:failedRun.attempt||0,...diagnostics}));process.exit(0);} console.log(JSON.stringify({success:false,rerunRequested:false,needsAgent:true,reason:'no_rerunnable_failed_run_found',failedCheckNames,recentRuns:(Array.isArray(runs)?runs:[]).map(normalizeRun).filter(Boolean).slice(0,5)})); process.exit(0); }catch(e){ console.log(JSON.stringify({success:false,rerunRequested:false,needsAgent:true,reason:'ci_rerun_failed',failedCheckNames,error:String(e?.message||e)})); process.exit(0); } } if(classification==='conflict'&&repo&&Number.isFinite(prNumber)&&prNumber>0){ const mergeable=String(data.mergeable||'').toUpperCase(); if(mergeable==='BEHIND'){ try{ const headSha=JSON.parse(gh(['pr','view',String(prNumber),'--repo',repo,'--json','headRefOid'])).headRefOid; gh(['api','-X','PUT','repos/'+repo+'/pulls/'+prNumber+'/update-branch','--field','expected_head_sha='+headSha]); console.log(JSON.stringify({success:true,branchUpdated:true,needsAgent:false,reason:'branch_updated_from_base',mergeable})); process.exit(0); }catch(e){ console.log(JSON.stringify({success:false,needsAgent:true,reason:'branch_update_failed',mergeable,error:String(e?.message||e)})); process.exit(0); } } } console.log(JSON.stringify({success:false,rerunRequested:false,needsAgent:true,reason:classification==='conflict'?'merge_conflict_requires_code_resolution':'repair_required',failedCheckNames}));" - ], - "continueOnError": true, - "failOnError": false, - "env": { - "BOSUN_PR_INSPECT": "{{$ctx.getNodeOutput('inspect-pr')?.output || '{}'}}" - } - }, - "position": { - "x": 220, - "y": 690 - }, - "outputs": [ - "default" - ] - }, - { - "id": "fix-agent-needed", - "type": "condition.expression", - "label": "Needs Fix Agent?", - "config": { - "expression": "(()=>{try{const d=JSON.parse($ctx.getNodeOutput('programmatic-fix')?.output||'{}');return d?.needsAgent===true;}catch{return false;}})()" - }, - "position": { - "x": 220, - "y": 820 - }, - "outputs": [ - "default" - ] - }, - { - "id": "setup-pr-worktree", - "type": "action.run_command", - "label": "Clone & Checkout PR Branch", - "config": { - "command": "node", - "args": [ - "-e", - "const os=require('os'); const path=require('path'); const fs=require('fs'); const {execFileSync}=require('child_process'); const repo=String(process.env.PR_REPO||'').trim(); const branch=String(process.env.PR_BRANCH||'').trim(); const base=String(process.env.PR_BASE||'main').trim(); const num=String(process.env.PR_NUMBER||'0').trim(); if(!repo||!branch){console.log(JSON.stringify({error:'missing repo or branch',repo,branch}));process.exit(1);} const wt=path.join(os.tmpdir(),'bosun-progfix-'+num.replace(/[^0-9a-z]/gi,'-')); let reused=false; if(fs.existsSync(path.join(wt,'.git'))){ try{ const cur=execFileSync('git',['rev-parse','--abbrev-ref','HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(cur===branch){ execFileSync('git',['fetch','origin',branch],{cwd:wt,encoding:'utf8',timeout:120000,stdio:['ignore','pipe','pipe']}); execFileSync('git',['reset','--hard','origin/'+branch],{cwd:wt,encoding:'utf8',timeout:30000}); execFileSync('git',['clean','-fdx'],{cwd:wt,encoding:'utf8',timeout:30000}); try{execFileSync('git',['fetch','origin',base],{cwd:wt,encoding:'utf8',timeout:60000,stdio:['ignore','pipe','pipe']});}catch{} reused=true; }else{fs.rmSync(wt,{recursive:true,force:true});} }catch{try{fs.rmSync(wt,{recursive:true,force:true});}catch{}} } if(!reused){ if(fs.existsSync(wt)){try{fs.rmSync(wt,{recursive:true,force:true});}catch{}} execFileSync('gh',['repo','clone',repo,wt,'--','--branch',branch],{encoding:'utf8',timeout:300000,stdio:'inherit'}); execFileSync('git',['fetch','origin',branch],{cwd:wt,encoding:'utf8',timeout:120000,stdio:['ignore','pipe','pipe']}); execFileSync('git',['reset','--hard','origin/'+branch],{cwd:wt,encoding:'utf8',timeout:30000}); try{execFileSync('git',['fetch','origin',base],{cwd:wt,encoding:'utf8',timeout:60000,stdio:['ignore','pipe','pipe']});}catch{} } const finalBranch=execFileSync('git',['rev-parse','--abbrev-ref','HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(finalBranch!==branch){console.error('Branch mismatch: expected '+branch+' got '+finalBranch);process.exit(1);} console.log(JSON.stringify({worktreePath:wt,branch:finalBranch,base,repo,number:num,reused}));" - ], - "parseJson": true, - "failOnError": true, - "timeoutMs": 600000, - "env": { - "PR_REPO": "(()=>{ const d=JSON.parse($ctx.getNodeOutput('inspect-pr')?.output||'{}'); return String(d.repo||$data?.prProgressContext?.repo||''); })()", - "PR_BRANCH": "(()=>{ const d=JSON.parse($ctx.getNodeOutput('inspect-pr')?.output||'{}'); return String(d.branch||d.prDigest?.core?.branch||$data?.prProgressContext?.branch||''); })()", - "PR_BASE": "(()=>{ const d=JSON.parse($ctx.getNodeOutput('inspect-pr')?.output||'{}'); return String(d.baseBranch||d.prDigest?.core?.baseBranch||$data?.prProgressContext?.baseBranch||'main'); })()", - "PR_NUMBER": "(()=>{ const d=JSON.parse($ctx.getNodeOutput('inspect-pr')?.output||'{}'); return String(d.prNumber||$data?.prProgressContext?.prNumber||'0'); })()" - } - }, - "position": { - "x": 220, - "y": 880 - }, - "outputs": [ - "default" - ] - }, - { - "id": "set-pr-worktree-path", - "type": "action.set_variable", - "label": "Set Agent Working Directory", - "config": { - "key": "worktreePath", - "value": "{{setup-pr-worktree.output.worktreePath}}" - }, - "position": { - "x": 220, - "y": 920 - }, - "outputs": [ - "default" - ] - }, - { - "id": "dispatch-fix-agent", - "type": "action.run_agent", - "label": "Dispatch Focused Fix Agent", - "config": { - "prompt": "You are a Bosun PR repair fallback agent working one PR only.\n\n## CRITICAL RULES — Read Before Doing Anything\n\nYour working directory is already a git clone of the target repo, checked out on the PR's HEAD branch (`{{setup-pr-worktree.output.branch}}`). The base branch (`{{setup-pr-worktree.output.base}}`) has been fetched.\n\n- Do NOT clone the repo. Do NOT create branches. Do NOT push.\n- Work ONLY in the current directory on the current branch.\n- The workflow will commit and push your changes automatically after you finish.\n\n## PR Context\n\n{{$ctx.getNodeOutput('inspect-pr')?.output}}\n\n## Repair Attempt Output\n\n{{$ctx.getNodeOutput('programmatic-fix')?.output}}\n\nUse prDigest.body, prDigest.files, prDigest.issueComments, prDigest.reviews, prDigest.reviewComments, prDigest.checks, failedAnnotations, and any failedLogExcerpt before making changes.\n\n## Fix Instructions\n\n- Only fix this PR's CI or merge-conflict issue.\n- For merge conflicts: `git merge origin/{{setup-pr-worktree.output.base}}` and resolve.\n- For CI failures: study the error output and apply the MINIMAL code fix.\n- Do not merge, approve, or close the PR.\n- Keep the patch minimal and scoped to the reported failure.\n- After fixing, remove the label:\n `gh pr edit {{setup-pr-worktree.output.number}} --repo {{setup-pr-worktree.output.repo}} --remove-label bosun-needs-fix`\n", - "sdk": "auto", - "timeoutMs": 1800000, - "delegationWatchdogTimeoutMs": "{{delegationWatchdogTimeoutMs}}", - "delegationWatchdogMaxRecoveries": "{{delegationWatchdogMaxRecoveries}}", - "maxRetries": 2, - "retryDelayMs": 30000, - "continueOnError": true - }, - "position": { - "x": 220, - "y": 970 - }, - "outputs": [ - "default" - ] - }, - { - "id": "push-pr-fixes", - "type": "action.run_command", - "label": "Push Fixes to PR Branch", - "config": { - "command": "node", - "args": [ - "-e", - "const {execFileSync}=require('child_process'); const wt=String(process.env.WORKTREE_PATH||'').trim(); const expectedBranch=String(process.env.PR_BRANCH||'').trim(); if(!wt){console.log(JSON.stringify({pushed:false,reason:'no worktree path'}));process.exit(0);} const branch=execFileSync('git',['rev-parse','--abbrev-ref','HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(expectedBranch&&branch!==expectedBranch){console.log(JSON.stringify({pushed:false,reason:'branch mismatch',expected:expectedBranch,actual:branch}));process.exit(1);} const status=execFileSync('git',['status','--porcelain'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); const diff=execFileSync('git',['diff','--stat','HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); const ahead=execFileSync('git',['rev-list','--count','origin/'+branch+'..HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(!status&&!diff&&ahead==='0'){console.log(JSON.stringify({pushed:false,reason:'nothing to push'}));process.exit(0);} if(status){execFileSync('git',['add','-A'],{cwd:wt,timeout:30000});execFileSync('git',['commit','-m','fix: bosun PR repair (progressor)'],{cwd:wt,timeout:30000});} execFileSync('git',['push','--force-with-lease','origin',branch],{cwd:wt,encoding:'utf8',timeout:120000,stdio:'inherit'}); console.log(JSON.stringify({pushed:true,branch}));" - ], - "continueOnError": true, - "failOnError": false, - "timeoutMs": 300000, - "env": { - "WORKTREE_PATH": "{{setup-pr-worktree.output.worktreePath}}", - "PR_BRANCH": "{{setup-pr-worktree.output.branch}}" - } - }, - "position": { - "x": 220, - "y": 1020 - }, - "outputs": [ - "default" - ] - }, - { - "id": "cleanup-pr-worktree", - "type": "action.run_command", - "label": "Cleanup Temp Clone", - "config": { - "command": "node", - "args": [ - "-e", - "const fs=require('fs'); const wt=String(process.env.WORKTREE_PATH||'').trim(); if(wt&&fs.existsSync(wt)){try{fs.rmSync(wt,{recursive:true,force:true});console.log('cleaned up '+wt);}catch(e){console.warn('cleanup failed: '+e.message);}} else{console.log('nothing to clean');}" - ], - "continueOnError": true, - "failOnError": false, - "timeoutMs": 60000, - "env": { - "WORKTREE_PATH": "{{setup-pr-worktree.output.worktreePath}}" - } - }, - "position": { - "x": 220, - "y": 1060 - }, - "outputs": [ - "default" - ] - }, - { - "id": "review-needed", - "type": "condition.expression", - "label": "Ready For Review?", - "config": { - "expression": "(()=>{try{const d=JSON.parse($ctx.getNodeOutput('inspect-pr')?.output||'{}');return d?.classification==='ready';}catch{return false;}})()" - }, - "position": { - "x": 620, - "y": 560 - }, - "outputs": [ - "default" - ] - }, - { - "id": "programmatic-review", - "type": "action.run_command", - "label": "Review Gate: Merge Single PR", - "config": { - "command": "node", - "args": [ - "-e", - "const {execFileSync}=require('child_process'); const pr=(()=>{try{return JSON.parse(String(process.env.BOSUN_PR_INSPECT||'{}'))}catch{return {}}})(); const repo=String(pr.repo||'').trim(); const n=String(pr.prNumber||'').trim(); const ratio=Number('{{suspiciousDeletionRatio}}')||3; const minDel=Number('{{minDestructiveDeletions}}')||500; const labelReview=String('{{labelNeedsReview}}'||'bosun-needs-human-review'); const method=String('{{mergeMethod}}'||'merge').toLowerCase(); function gh(args){return execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();} if(!repo||!n){console.log(JSON.stringify({mergedCount:0,heldCount:0,skippedCount:1,skipped:[{repo,number:n,reason:'missing_repo_or_pr'}]}));process.exit(0);} try{ const viewRaw=gh(['pr','view',n,'--repo',repo,'--json','number,title,additions,deletions,changedFiles,isDraft']); const view=(()=>{try{return JSON.parse(viewRaw||'{}')}catch{return {}}})(); if(view?.isDraft===true){console.log(JSON.stringify({mergedCount:0,heldCount:0,skippedCount:1,skipped:[{repo,number:n,reason:'draft'}]}));process.exit(0);} const add=Number(view?.additions||0); const del=Number(view?.deletions||0); const changed=Number(view?.changedFiles||0); const destructive=(del>(add*ratio))&&(del>minDel); const tooWide=changed>250; if(destructive||tooWide){ gh(['pr','edit',n,'--repo',repo,'--add-label',labelReview]); gh(['pr','comment',n,'--repo',repo,'--body',':warning: Bosun held this PR for human review due to suspicious diff footprint.']); console.log(JSON.stringify({mergedCount:0,heldCount:1,skippedCount:0,held:[{repo,number:n,reason:destructive?'destructive_diff':'changed_files_too_large',additions:add,deletions:del,changedFiles:changed}]})); process.exit(0); } const checksRaw=gh(['pr','checks',n,'--repo',repo,'--json','name,state,bucket']); const checks=(()=>{try{return JSON.parse(checksRaw||'[]')}catch{return []}})(); const hasFailure=(Array.isArray(checks)?checks:[]).some((x)=>{const s=String(x?.state||'').toUpperCase();const b=String(x?.bucket||'').toUpperCase();return ['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE'].includes(s)||b==='FAIL';}); const hasPending=(Array.isArray(checks)?checks:[]).some((x)=>['QUEUED','IN_PROGRESS','PENDING','WAITING','REQUESTED'].includes(String(x?.state||'').toUpperCase())); if(hasFailure){console.log(JSON.stringify({mergedCount:0,heldCount:0,skippedCount:1,skipped:[{repo,number:n,reason:'ci_failed'}]}));process.exit(0);} if(hasPending){console.log(JSON.stringify({mergedCount:0,heldCount:0,skippedCount:1,skipped:[{repo,number:n,reason:'ci_pending'}]}));process.exit(0);} const mergeArgs=['pr','merge',n,'--repo',repo,'--delete-branch']; if(method==='rebase') mergeArgs.push('--rebase'); else if(method==='merge') mergeArgs.push('--merge'); else mergeArgs.push('--squash'); try{gh(mergeArgs);}catch(directErr){mergeArgs.push('--auto');gh(mergeArgs);} console.log(JSON.stringify({mergedCount:1,heldCount:0,skippedCount:0,merged:[{repo,number:n,title:String(view?.title||'')}] })); }catch(e){ console.log(JSON.stringify({mergedCount:0,heldCount:1,skippedCount:0,held:[{repo,number:n,reason:'merge_attempt_failed',error:String(e?.message||e)}]})); }" - ], - "continueOnError": true, - "failOnError": false, - "env": { - "BOSUN_PR_INSPECT": "{{$ctx.getNodeOutput('inspect-pr')?.output || '{}'}}" - } - }, - "position": { - "x": 620, - "y": 690 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-deferred", - "type": "notify.log", - "label": "Deferred", - "config": { - "message": "Bosun PR Progressor deferred PR #{{prProgressContext.prNumber}}: {{$ctx.getNodeOutput('inspect-pr')?.output || '{}'}}", - "level": "info" - }, - "position": { - "x": 620, - "y": 820 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-missing", - "type": "notify.log", - "label": "Missing PR Context", - "config": { - "message": "Bosun PR Progressor skipped: missing PR context for task {{taskId}}", - "level": "warn" - }, - "position": { - "x": 400, - "y": 560 - }, - "outputs": [ - "default" - ] - }, - { - "id": "notify-complete", - "type": "notify.log", - "label": "Log Outcome", - "config": { - "message": "Bosun PR Progressor finished for task {{taskId}} / PR {{prProgressContext.prNumber}}", - "level": "info" - }, - "position": { - "x": 400, - "y": 1090 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->normalize-context", - "source": "trigger", - "target": "normalize-context", - "sourcePort": "default" - }, - { - "id": "normalize-context->has-pr-target", - "source": "normalize-context", - "target": "has-pr-target", - "sourcePort": "default" - }, - { - "id": "has-pr-target->inspect-pr", - "source": "has-pr-target", - "target": "inspect-pr", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "has-pr-target->log-missing", - "source": "has-pr-target", - "target": "log-missing", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "inspect-pr->fix-needed", - "source": "inspect-pr", - "target": "fix-needed", - "sourcePort": "default" - }, - { - "id": "fix-needed->programmatic-fix", - "source": "fix-needed", - "target": "programmatic-fix", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "fix-needed->review-needed", - "source": "fix-needed", - "target": "review-needed", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "programmatic-fix->fix-agent-needed", - "source": "programmatic-fix", - "target": "fix-agent-needed", - "sourcePort": "default" - }, - { - "id": "fix-agent-needed->setup-pr-worktree", - "source": "fix-agent-needed", - "target": "setup-pr-worktree", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "fix-agent-needed->notify-complete", - "source": "fix-agent-needed", - "target": "notify-complete", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "setup-pr-worktree->set-pr-worktree-path", - "source": "setup-pr-worktree", - "target": "set-pr-worktree-path", - "sourcePort": "default" - }, - { - "id": "set-pr-worktree-path->dispatch-fix-agent", - "source": "set-pr-worktree-path", - "target": "dispatch-fix-agent", - "sourcePort": "default" - }, - { - "id": "dispatch-fix-agent->push-pr-fixes", - "source": "dispatch-fix-agent", - "target": "push-pr-fixes", - "sourcePort": "default" - }, - { - "id": "push-pr-fixes->cleanup-pr-worktree", - "source": "push-pr-fixes", - "target": "cleanup-pr-worktree", - "sourcePort": "default" - }, - { - "id": "cleanup-pr-worktree->notify-complete", - "source": "cleanup-pr-worktree", - "target": "notify-complete", - "sourcePort": "default" - }, - { - "id": "review-needed->programmatic-review", - "source": "review-needed", - "target": "programmatic-review", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "review-needed->log-deferred", - "source": "review-needed", - "target": "log-deferred", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "programmatic-review->notify-complete", - "source": "programmatic-review", - "target": "notify-complete", - "sourcePort": "default" - }, - { - "id": "log-deferred->notify-complete", - "source": "log-deferred", - "target": "notify-complete", - "sourcePort": "default" - }, - { - "id": "log-missing->notify-complete", - "source": "log-missing", - "target": "notify-complete", - "sourcePort": "default" - } - ], - "metadata": { - "author": "bosun-demo", - "createdAt": "2026-03-01T12:00:00.000Z", - "updatedAt": "2026-03-01T12:00:00.000Z", - "templateState": { - "templateId": "template-bosun-pr-progressor", - "templateName": "Bosun PR Progressor", - "templateVersion": "2.0.0", - "installedTemplateVersion": "2.0.0", - "isCustomized": false, - "updateAvailable": false - } - } - }, - { - "id": "wf-bosun-pr-watchdog", - "name": "Bosun PR Watchdog", - "description": "Scans open bosun-attached PRs on a schedule. Makes one gh pr list call per target repo to fetch and classify PRs, then: labels conflicting or failing-CI PRs with bosun-needs-fix and dispatches a repair agent; sends merge candidates through a MANDATORY agent review gate that checks diff stats before any merge — preventing destructive PRs (e.g. -183k lines) from being silently auto-merged. Attached PRs that are not Bosun-created are skipped by default unless explicitly trusted in config.", - "category": "github", - "enabled": true, - "nodeCount": 23, - "trigger": "trigger.schedule", - "variables": { - "mergeMethod": "merge", - "labelNeedsFix": "bosun-needs-fix", - "labelNeedsReview": "bosun-needs-human-review", - "repoScope": "auto", - "maxPrs": 25, - "intervalMs": 1800000, - "suspiciousDeletionRatio": 3, - "minDestructiveDeletions": 500, - "autoApplySuggestions": true, - "trustedAuthors": "", - "allowTrustedFixes": false, - "allowTrustedMerges": false, - "maxConcurrentFixes": 3, - "prFixTtlMinutes": 120 - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.schedule", - "label": "Poll Every 90s", - "config": { - "intervalMs": "{{intervalMs}}" - }, - "position": { - "x": 400, - "y": 50 - }, - "outputs": [ - "default" - ] - }, - { - "id": "fetch-and-classify", - "type": "action.run_command", - "label": "Fetch, Classify & Label PRs", - "config": { - "command": "node", - "args": [ - "-e", - "const fs=require('fs'); const path=require('path'); const {execFileSync}=require('child_process'); const LABEL_FIX='{{labelNeedsFix}}'; const MAX_PRS=Math.max(1,Number('{{maxPrs}}')||25); const REPO_SCOPE=String('{{repoScope}}'||'auto').trim(); const FIELDS='number,title,body,author,headRefName,baseRefName,isDraft,mergeable,statusCheckRollup,labels,url'; const FAIL_STATES=new Set(['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE']); const PEND_STATES=new Set(['PENDING','IN_PROGRESS','QUEUED','WAITING','REQUESTED','EXPECTED']); const CONFLICT_MERGEABLES=new Set(['CONFLICTING','DIRTY']); const BEHIND_MERGEABLES=new Set(['BEHIND']); const SECURITY_CHECK_RE=/(^|[^a-z])(codeql|code scanning|security|sarif|codacy)([^a-z]|$)/i; const BOSUN_CREATED_LABEL='bosun-pr-bosun-created'; function readCheckName(check){return String(check?.name||check?.context||check?.workflowName||check?.displayTitle||'').trim();} function isFailedCheck(check){return FAIL_STATES.has(check?.conclusion||check?.state||'');} function isSecurityCheckName(name){return SECURITY_CHECK_RE.test(String(name||''));} const GH_MAX_BUFFER=25*1024*1024;const GH_CACHE_TTL_MS=30000;const ghReadCache=new Map();let ghRateLimitUntil=0;function ghSleep(ms){if(!Number.isFinite(ms)||ms<=0)return;Atomics.wait(new Int32Array(new SharedArrayBuffer(4)),0,0,Math.min(ms,5000));}function ghCacheKey(args){return JSON.stringify(Array.isArray(args)?args:[]);}function isGhReadOnly(args){const list=Array.isArray(args)?args.map((item)=>String(item||'').trim().toLowerCase()):[];if(list.length===0)return false;const joined=' '+list.join(' ')+' ';return !/( edit | merge | close | reopen | rerun | delete | create | ready | cancel )/.test(joined);}function readGhMessage(error){return String(error?.stderr||error?.stdout||error?.message||error||'');}function runGh(args){const cacheable=isGhReadOnly(args);const key=cacheable?ghCacheKey(args):'';const now=Date.now();if(cacheable){const cached=ghReadCache.get(key);if(cached&&cached.expiresAt>now)return cached.output;if(nowString(entry||'').trim().toLowerCase()).filter(Boolean); return String(value||'').split(',').map((entry)=>entry.trim().toLowerCase()).filter(Boolean);} function parseBool(value,fallback){if(value===undefined||value===null||value==='') return fallback; const raw=String(value).trim().toLowerCase(); if(['1','true','yes','on'].includes(raw)) return true; if(['0','false','no','off'].includes(raw)) return false; return fallback;} function normalizeCheckKey(name){return String(name||'').trim().toLowerCase().replace(/\\s+/g,' ');} function matchesCheckPattern(name,pattern){const text=String(name||'').trim().toLowerCase();const token=String(pattern||'').trim().toLowerCase();if(!text||!token)return false;if(token==='*')return true;if(!token.includes('*'))return text.includes(token);const parts=token.split('*').filter(Boolean);if(parts.length===0)return true;let cursor=0;for(const part of parts){const idx=text.indexOf(part,cursor);if(idx===-1)return false;cursor=idx+part.length;}if(!token.startsWith('*')&&!text.startsWith(parts[0]||''))return false;if(!token.endsWith('*')&&!text.endsWith(parts[parts.length-1]||''))return false;return true;} function matchesAnyPattern(name,patterns){return (Array.isArray(patterns)?patterns:[]).some((pattern)=>matchesCheckPattern(name,pattern));} function readCheckState(check){return String(check?.conclusion||check?.state||check?.status||check?.bucket||'').trim().toUpperCase();} function isPassingCheckState(state,treatNeutralAsPass){if(!state)return true;if(['SUCCESS','PASS','PASSED','COMPLETED'].includes(state))return true;if(treatNeutralAsPass&&['NEUTRAL','SKIPPED'].includes(state))return true;return !FAIL_STATES.has(state)&&!PEND_STATES.has(state);} function evaluateCheckGates(checks,policy){const normalized=(Array.isArray(checks)?checks:[]).map((check)=>({raw:check,name:readCheckName(check),state:readCheckState(check)})).filter((check)=>check.name);const considered=normalized.filter((check)=>!matchesAnyPattern(check.name,policy.ignorePatterns));let required=considered;if(policy.mode==='required-only'){required=considered.filter((check)=>matchesAnyPattern(check.name,policy.requiredPatterns));}if((Array.isArray(policy.optionalPatterns)?policy.optionalPatterns:[]).length>0){required=required.filter((check)=>!matchesAnyPattern(check.name,policy.optionalPatterns));}const missingRequired=policy.requireAnyRequiredCheck&&required.length===0;const failedRequiredChecks=required.filter((check)=>FAIL_STATES.has(check.state));const pendingRequiredChecks=required.filter((check)=>PEND_STATES.has(check.state));const hasRequiredFailure=failedRequiredChecks.length>0;const hasBlockingPending=policy.treatPendingRequiredAsBlocking&&pendingRequiredChecks.length>0;const isReady=!missingRequired&&!hasRequiredFailure&&!hasBlockingPending&&required.every((check)=>isPassingCheckState(check.state,policy.treatNeutralAsPass));return {consideredCount:considered.length,requiredCount:required.length,failedRequiredChecks:failedRequiredChecks.map((check)=>check.raw),pendingRequiredChecks:pendingRequiredChecks.map((check)=>check.raw),hasRequiredFailure,hasBlockingPending,blocksForMissingRequired:missingRequired,isReady,shouldKickCi:considered.length===0};} function buildFailureFingerprint(names){const normalized=[...new Set((Array.isArray(names)?names:[]).map(normalizeCheckKey).filter(Boolean))].sort();return normalized.join('|');} function readLabelNames(pr){return Array.isArray(pr?.labels)?pr.labels.map((entry)=>typeof entry==='string'?entry:entry?.name).filter(Boolean):[];} function isBosunCreated(pr){return readLabelNames(pr).includes(BOSUN_CREATED_LABEL);} function readAuthorLogin(pr){return String(pr?.author?.login||pr?.author?.name||'').trim().toLowerCase();} function configPath(){ const home=String(process.env.BOSUN_HOME||process.env.BOSUN_PROJECT_DIR||'').trim(); return home?path.join(home,'bosun.config.json'):path.join(process.cwd(),'bosun.config.json'); } function readBosunConfig(){ try { return JSON.parse(fs.readFileSync(configPath(),'utf8')); } catch { return {}; } } function collectReposFromConfig(){ const repos=[]; try{ const cfg=readBosunConfig(); const workspaces=Array.isArray(cfg?.workspaces)?cfg.workspaces:[]; if(workspaces.length>0){ const active=String(cfg?.activeWorkspace||'').trim().toLowerCase(); const activeWs=active?workspaces.find(w=>String(w?.id||'').trim().toLowerCase()===active):null; const wsList=activeWs?[activeWs]:workspaces; for(const ws of wsList){ for(const repo of (Array.isArray(ws?.repos)?ws.repos:[])){ const slug=typeof repo==='string'?String(repo).trim():String(repo?.slug||'').trim(); if(slug) repos.push(slug); } } } if(repos.length===0){ for(const repo of (Array.isArray(cfg?.repos)?cfg.repos:[])){ const slug=typeof repo==='string'?String(repo).trim():String(repo?.slug||'').trim(); if(slug) repos.push(slug); } } }catch{} return repos; } function resolveRepoTargets(){ if(REPO_SCOPE&&REPO_SCOPE!=='auto'&&REPO_SCOPE!=='all'&&REPO_SCOPE!=='current'){ return [...new Set(REPO_SCOPE.split(',').map(v=>v.trim()).filter(Boolean))]; } if(REPO_SCOPE==='current') return ['']; const fromConfig=collectReposFromConfig(); if(fromConfig.length>0) return [...new Set(fromConfig)]; const envRepo=String(process.env.GITHUB_REPOSITORY||'').trim(); if(envRepo) return [envRepo]; return ['']; } const BOSUN_CONFIG=readBosunConfig(); const PR_AUTOMATION=(BOSUN_CONFIG&&typeof BOSUN_CONFIG.prAutomation==='object')?BOSUN_CONFIG.prAutomation:{}; const ATTACH_MODE=((String(PR_AUTOMATION?.attachMode||'all').trim().toLowerCase())||'all'); const TRUSTED_AUTHORS=new Set([...normalizeList(PR_AUTOMATION?.trustedAuthors),...normalizeList('{{trustedAuthors}}')]); const ALLOW_TRUSTED_FIXES=parseBool(PR_AUTOMATION?.allowTrustedFixes ?? '{{allowTrustedFixes}}', false); const ALLOW_TRUSTED_MERGES=parseBool(PR_AUTOMATION?.allowTrustedMerges ?? '{{allowTrustedMerges}}', false); const CHECK_GATES=(BOSUN_CONFIG&&typeof BOSUN_CONFIG.gates==='object'&&BOSUN_CONFIG.gates&&typeof BOSUN_CONFIG.gates.checks==='object')?BOSUN_CONFIG.gates.checks:{}; const CHECK_MODE=((String(CHECK_GATES?.mode||'all').trim().toLowerCase())||'all'); const REQUIRED_CHECK_PATTERNS=normalizeList(CHECK_GATES?.requiredPatterns); const OPTIONAL_CHECK_PATTERNS=normalizeList(CHECK_GATES?.optionalPatterns); const IGNORE_CHECK_PATTERNS=normalizeList(CHECK_GATES?.ignorePatterns); const REQUIRE_ANY_REQUIRED_CHECK=parseBool(CHECK_GATES?.requireAnyRequiredCheck, true); const TREAT_PENDING_REQUIRED_AS_BLOCKING=parseBool(CHECK_GATES?.treatPendingRequiredAsBlocking, true); const TREAT_NEUTRAL_AS_PASS=parseBool(CHECK_GATES?.treatNeutralAsPass, false); const defaultBranchFailureCache=new Map(); function collectDefaultBranchFailureNames(repo,baseBranch){const cacheKey=[repo,baseBranch].join('::');if(defaultBranchFailureCache.has(cacheKey))return defaultBranchFailureCache.get(cacheKey);const failedNames=new Set();try{const runs=safeGhJson(['run','list','--repo',repo,'--branch',baseBranch,'--json','databaseId,workflowName,displayTitle,conclusion,status','--limit','6'],[]);for(const run of (Array.isArray(runs)?runs:[])){const conclusion=String(run?.conclusion||'').trim().toUpperCase();if(!FAIL_STATES.has(conclusion))continue;const runId=Number(run?.databaseId||0)||0;if(runId>0){const view=safeGhJson(['run','view',String(runId),'--repo',repo,'--json','jobs'],{});const jobs=Array.isArray(view?.jobs)?view.jobs:[];for(const job of jobs){const jobState=String(job?.conclusion||job?.status||'').trim().toUpperCase();if(FAIL_STATES.has(jobState)){const normalized=normalizeCheckKey(job?.name);if(normalized)failedNames.add(normalized);}}}const workflowName=normalizeCheckKey(run?.workflowName||run?.displayTitle);if(workflowName)failedNames.add(workflowName);}}catch{}const resolved=[...failedNames];defaultBranchFailureCache.set(cacheKey,resolved);return resolved;} function parseRepoFromUrl(url){ const raw=String(url||''); const marker='github.com/'; const idx=raw.toLowerCase().indexOf(marker); if(idx<0) return ''; const tail=raw.slice(idx+marker.length).split('/'); if(tail.length<2) return ''; const owner=String(tail[0]||'').trim(); const repo=String(tail[1]||'').trim(); return owner&&repo?(owner+'/'+repo):''; } const repoTargets=resolveRepoTargets(); const prs=[]; const repoErrors=[]; for(const target of repoTargets){ const repo=String(target||'').trim(); const args=['pr','list','--state','open','--json',FIELDS,'--limit',String(MAX_PRS)]; if(repo) args.push('--repo',repo); try{ const list=ghJson(args); for(const pr of (Array.isArray(list)?list:[])){ const prRepo=repo||parseRepoFromUrl(pr?.url)||String(process.env.GITHUB_REPOSITORY||'').trim(); prs.push({...pr,__repo:prRepo}); } }catch(e){ repoErrors.push({repo:repo||'current',error:String(e?.message||e)}); } } const taskCli=path.join(process.cwd(),'task','task-cli.mjs'); const taskRunner=fs.existsSync(taskCli)?'direct':'cli'; const taskMaxBuffer=1024*1024*8; function parseJson(raw,fallback){try{return JSON.parse(raw||'')}catch{return fallback;}} function runTask(args){const cmdArgs=taskRunner==='cli'?['cli.mjs','task',...args,'--config-dir','.bosun','--repo-root','.']:[taskCli,...args];return execFileSync('node',cmdArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe'],maxBuffer:taskMaxBuffer}).trim();} let taskListCache=null; function loadTaskList(){if(taskListCache)return taskListCache;try{const raw=runTask(['list','--json']);const tasks=parseJson(raw,[]);taskListCache=Array.isArray(tasks)?tasks:[];}catch{taskListCache=[];}return taskListCache;} function normalizeTaskValue(value){return String(value||'').trim().toLowerCase();} function resolveTaskIdForPr(item){const prNumber=Number(item?.n||0)||0;const prUrl=normalizeTaskValue(item?.url);const branch=normalizeTaskValue(item?.branch);const matches=loadTaskList().filter((task)=>{if(!task||typeof task!=='object')return false;const taskPrNumber=Number(task?.prNumber||task?.pr_number||0)||0;if(prNumber>0&&taskPrNumber===prNumber)return true;const taskPrUrl=normalizeTaskValue(task?.prUrl||task?.pr_url);if(prUrl&&taskPrUrl===prUrl)return true;const taskBranch=normalizeTaskValue(task?.branchName||task?.branch||task?.meta?.branchName||task?.meta?.branch);return Boolean(branch&&taskBranch===branch);});if(matches.length===0)return null;const inReview=matches.find((task)=>normalizeTaskValue(task?.status)==='inreview');return String((inReview||matches[0])?.id||'').trim()||null;} function getTaskSnapshot(id){if(!id)return null;try{return parseJson(runTask(['get',id,'--json']),null);}catch{return null;}} function updateTaskReviewSignal(item){const taskId=resolveTaskIdForPr(item);if(!taskId)return false;const snapshot=getTaskSnapshot(taskId)||{};const existingMeta=snapshot?.meta&&typeof snapshot.meta==='object'?snapshot.meta:{};const existingReviewHealth=existingMeta.reviewHealth&&typeof existingMeta.reviewHealth==='object'?existingMeta.reviewHealth:{};const nextReviewHealth={...existingReviewHealth,status:String(item?.reviewStatus||'unknown'),failureScope:String(item?.failureScope||'none'),sharedIncidentId:item?.sharedIncidentId||null,failureFingerprint:item?.failureFingerprint||null,failingWorkflow:item?.failingWorkflow||null,failingJobs:Array.isArray(item?.failedCheckNames)?item.failedCheckNames:[],baseBranch:String(item?.base||snapshot?.baseBranch||'').trim()||null,repo:String(item?.repo||'').trim()||null,updatedAt:new Date().toISOString(),source:'pr-watchdog'};const patch={meta:{...existingMeta,reviewHealth:nextReviewHealth}};try{runTask(['update',taskId,JSON.stringify(patch)]);return true;}catch{return false;}} const sharedFailureFingerprints=new Map(); for(const pr of prs){const labels=(pr.labels||[]).map(l=>typeof l==='string'?l:l?.name).filter(Boolean);const bosunCreated=isBosunCreated(pr);const trustedAuthor=TRUSTED_AUTHORS.has(readAuthorLogin(pr));const attachEligible=bosunCreated||ATTACH_MODE==='all'||(ATTACH_MODE==='trusted-only'&&trustedAuthor);const checks=pr.statusCheckRollup||[];const gateVerdict=evaluateCheckGates(checks,{mode:CHECK_MODE,requiredPatterns:REQUIRED_CHECK_PATTERNS,optionalPatterns:OPTIONAL_CHECK_PATTERNS,ignorePatterns:IGNORE_CHECK_PATTERNS,requireAnyRequiredCheck:REQUIRE_ANY_REQUIRED_CHECK,treatPendingRequiredAsBlocking:TREAT_PENDING_REQUIRED_AS_BLOCKING,treatNeutralAsPass:TREAT_NEUTRAL_AS_PASS});const failedCheckNames=gateVerdict.failedRequiredChecks.map(readCheckName).filter(Boolean);const hasSecurityFail=failedCheckNames.some(isSecurityCheckName);const isConflict=CONFLICT_MERGEABLES.has(String(pr.mergeable||'').toUpperCase());const isDraft=pr.isDraft===true;const repo=String(pr.__repo||'').trim();const base=String(pr.baseRefName||'').trim()||'main';if(isDraft||!attachEligible||!gateVerdict.hasRequiredFailure||hasSecurityFail||isConflict)continue;const fingerprint=buildFailureFingerprint(failedCheckNames);if(!fingerprint)continue;const sharedKey=[repo,base,fingerprint].join('::');sharedFailureFingerprints.set(sharedKey,(sharedFailureFingerprints.get(sharedKey)||0)+1);} const readyCandidates=[],conflicts=[],securityFailures=[],ciFailures=[],sharedFailures=[],pending=[],drafted=[],behindBranches=[],skippedUntrusted=[]; let newlyLabeled=0,staleLabelCleared=0,ciKicked=0,taskReviewSignalsUpdated=0; for(const pr of prs){ const labels=(pr.labels||[]).map(l=>typeof l==='string'?l:l?.name).filter(Boolean); const bosunCreated=isBosunCreated(pr); const trustedAuthor=TRUSTED_AUTHORS.has(readAuthorLogin(pr)); const attachEligible=bosunCreated || ATTACH_MODE==='all' || (ATTACH_MODE==='trusted-only' && trustedAuthor); const canFix=bosunCreated || (attachEligible && ALLOW_TRUSTED_FIXES && trustedAuthor); const canMerge=bosunCreated || (attachEligible && ALLOW_TRUSTED_MERGES && trustedAuthor); const hasFixLabel=labels.includes(LABEL_FIX); const checks=pr.statusCheckRollup||[]; const gateVerdict=evaluateCheckGates(checks,{mode:CHECK_MODE,requiredPatterns:REQUIRED_CHECK_PATTERNS,optionalPatterns:OPTIONAL_CHECK_PATTERNS,ignorePatterns:IGNORE_CHECK_PATTERNS,requireAnyRequiredCheck:REQUIRE_ANY_REQUIRED_CHECK,treatPendingRequiredAsBlocking:TREAT_PENDING_REQUIRED_AS_BLOCKING,treatNeutralAsPass:TREAT_NEUTRAL_AS_PASS}); const failedChecks=gateVerdict.failedRequiredChecks; const failedCheckNames=failedChecks.map(readCheckName).filter(Boolean); const securityCheckNames=failedCheckNames.filter(isSecurityCheckName); const hasFail=gateVerdict.hasRequiredFailure; const hasSecurityFail=securityCheckNames.length>0; const hasPend=gateVerdict.hasBlockingPending; const isConflict=CONFLICT_MERGEABLES.has(String(pr.mergeable||'').toUpperCase()); const isBehind=BEHIND_MERGEABLES.has(String(pr.mergeable||'').toUpperCase()); const isDraft=pr.isDraft===true; const repo=String(pr.__repo||'').trim(); const base=String(pr.baseRefName||'').trim()||'main'; const failureFingerprint=buildFailureFingerprint(failedCheckNames); const sharedFailureKey=[repo,base,failureFingerprint].join('::'); const repeatedFailureCount=Number(sharedFailureFingerprints.get(sharedFailureKey)||0); const defaultBranchFailureNames=repo&&base?collectDefaultBranchFailureNames(repo,base):[]; const defaultBranchFailureSet=new Set((Array.isArray(defaultBranchFailureNames)?defaultBranchFailureNames:[]).map(normalizeCheckKey).filter(Boolean)); const allFailuresOnDefaultBranch=failedCheckNames.length>0&&failedCheckNames.every((name)=>defaultBranchFailureSet.has(normalizeCheckKey(name))); const isSharedFailure=hasFail&&!hasSecurityFail&&!isConflict&&(allFailuresOnDefaultBranch||repeatedFailureCount>=2); const sharedIncidentId=isSharedFailure&&failureFingerprint?[repo,base,failureFingerprint].join(':'):null; if(isDraft){drafted.push({n:pr.number,repo});continue;} if(!bosunCreated && !attachEligible){skippedUntrusted.push({n:pr.number,repo,reason:'attach_policy_excluded'});continue;} if(!bosunCreated && !trustedAuthor){skippedUntrusted.push({n:pr.number,repo,reason:'public_observation_only'});continue;} if(isBehind&&!isConflict){ if(canFix) behindBranches.push({n:pr.number,repo,branch:pr.headRefName,base:pr.baseRefName,url:pr.url}); } if(isConflict){ if(!canFix){skippedUntrusted.push({n:pr.number,repo,reason:'fix_not_allowed'});continue;} conflicts.push({n:pr.number,repo,branch:pr.headRefName,base:pr.baseRefName,url:pr.url,mergeable:String(pr.mergeable||'').toUpperCase()}); if(updateTaskReviewSignal({n:pr.number,repo,branch:pr.headRefName,base,url:pr.url,reviewStatus:'conflict',failureScope:'pr_local',failedCheckNames:[],failureFingerprint:null,failingWorkflow:null,sharedIncidentId:null}))taskReviewSignalsUpdated++; if(!hasFixLabel){ try{const editArgs=['pr','edit',String(pr.number),'--add-label',LABEL_FIX];if(repo)editArgs.push('--repo',repo);execFileSync('gh',editArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe']});newlyLabeled++;} catch(e){process.stderr.write('label err '+(repo?repo+' ':'')+'#'+pr.number+': '+(e?.message||e)+'\\\\n');} } } else if(hasSecurityFail){ if(!canFix){skippedUntrusted.push({n:pr.number,repo,reason:'security_fix_not_allowed'});continue;} securityFailures.push({n:pr.number,repo,branch:pr.headRefName,base:pr.baseRefName,url:pr.url,title:pr.title,failedCheckNames,securityCheckNames}); if(updateTaskReviewSignal({n:pr.number,repo,branch:pr.headRefName,base,url:pr.url,reviewStatus:'security_failure',failureScope:'pr_local',failedCheckNames,failureFingerprint,failingWorkflow:securityCheckNames[0]||failedCheckNames[0]||null,sharedIncidentId:null}))taskReviewSignalsUpdated++; if(!hasFixLabel){ try{const editArgs=['pr','edit',String(pr.number),'--add-label',LABEL_FIX];if(repo)editArgs.push('--repo',repo);execFileSync('gh',editArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe']});newlyLabeled++;} catch(e){process.stderr.write('label err '+(repo?repo+' ':'')+'#'+pr.number+': '+(e?.message||e)+'\\n');} } } else if(hasFail){ if(isSharedFailure){ sharedFailures.push({n:pr.number,repo,branch:pr.headRefName,base:pr.baseRefName,url:pr.url,title:pr.title,failedCheckNames,failureFingerprint,sharedIncidentId,defaultBranchFailureNames,repeatedFailureCount}); if(updateTaskReviewSignal({n:pr.number,repo,branch:pr.headRefName,base,url:pr.url,reviewStatus:'shared_ci_failure',failureScope:'shared',failedCheckNames,failureFingerprint,failingWorkflow:failedCheckNames[0]||null,sharedIncidentId}))taskReviewSignalsUpdated++; if(hasFixLabel){ try{const rmArgs=['pr','edit',String(pr.number),'--remove-label',LABEL_FIX];if(repo)rmArgs.push('--repo',repo);execFileSync('gh',rmArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe']});staleLabelCleared++;} catch(e){process.stderr.write('shared-label-rm err '+(repo?repo+' ':'')+'#'+pr.number+': '+(e?.message||e)+'\\n');} } continue; } if(!canFix){skippedUntrusted.push({n:pr.number,repo,reason:'ci_fix_not_allowed'});continue;} ciFailures.push({n:pr.number,repo,branch:pr.headRefName,url:pr.url,failedCheckNames}); if(updateTaskReviewSignal({n:pr.number,repo,branch:pr.headRefName,base,url:pr.url,reviewStatus:'ci_failure',failureScope:'pr_local',failedCheckNames,failureFingerprint,failingWorkflow:failedCheckNames[0]||null,sharedIncidentId:null}))taskReviewSignalsUpdated++; if(!hasFixLabel){ try{const editArgs=['pr','edit',String(pr.number),'--add-label',LABEL_FIX];if(repo)editArgs.push('--repo',repo);execFileSync('gh',editArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe']});newlyLabeled++;} catch(e){process.stderr.write('label err '+(repo?repo+' ':'')+'#'+pr.number+': '+(e?.message||e)+'\\\\n');} } } else { if(updateTaskReviewSignal({n:pr.number,repo,branch:pr.headRefName,base,url:pr.url,reviewStatus:hasPend?'pending':gateVerdict.isReady?'ready':'idle',failureScope:'none',failedCheckNames:[],failureFingerprint:null,failingWorkflow:null,sharedIncidentId:null}))taskReviewSignalsUpdated++; if(hasFixLabel&&!hasPend&&!gateVerdict.blocksForMissingRequired){ try{ const rmArgs=['pr','edit',String(pr.number),'--remove-label',LABEL_FIX]; if(repo)rmArgs.push('--repo',repo); execFileSync('gh',rmArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe']}); staleLabelCleared++; }catch(e){process.stderr.write('stale-label-rm err '+(repo?repo+' ':'')+'#'+pr.number+': '+(e?.message||e)+'\\\\n');} } else if(gateVerdict.isReady&&!hasFixLabel){ if(hasPend) pending.push({n:pr.number,repo}); if(canMerge){ readyCandidates.push({n:pr.number,repo,branch:pr.headRefName,base:pr.baseRefName,url:pr.url,title:pr.title,pendingChecks:hasPend}); } else { skippedUntrusted.push({n:pr.number,repo,reason:'merge_not_allowed'}); } } if(gateVerdict.shouldKickCi&&repo&&pr.headRefName&&!isDraft){ try{execFileSync('gh',['workflow','run','ci.yaml','--repo',repo,'--ref',pr.headRefName],{encoding:'utf8',stdio:['pipe','pipe','pipe']});ciKicked++;} catch{} } } } console.log(JSON.stringify({ total:prs.length, reposScanned:repoTargets.length, repoErrors, readyCandidates, conflicts, behindBranches, securityFailures, ciFailures, sharedFailures, pending:pending.length, drafted:drafted.length, skippedUntrusted, newlyLabeled, staleLabelCleared, ciKicked, fixNeeded:conflicts.length+securityFailures.length+ciFailures.length, sharedIncidentCount:sharedFailures.length, taskReviewSignalsUpdated, trustPolicy:{trustedAuthors:[...TRUSTED_AUTHORS],allowTrustedFixes:ALLOW_TRUSTED_FIXES,allowTrustedMerges:ALLOW_TRUSTED_MERGES} }));" - ], - "continueOnError": false, - "failOnError": true - }, - "position": { - "x": 400, - "y": 200 - }, - "outputs": [ - "default" - ] - }, - { - "id": "has-prs", - "type": "condition.expression", - "label": "Any Bosun PRs?", - "config": { - "expression": "(()=>{try{const r=$ctx.getNodeOutput('fetch-and-classify');if(!r||r.success===false)return false;const o=r.output;return (JSON.parse(o||'{}').total||0)>0;}catch(e){return false;}})()" - }, - "position": { - "x": 400, - "y": 370 - }, - "outputs": [ - "default" - ] - }, - { - "id": "has-behind", - "type": "condition.expression", - "label": "Behind Branches?", - "config": { - "expression": "(()=>{try{const o=$ctx.getNodeOutput('fetch-and-classify')?.output;return (JSON.parse(o||'{}').behindBranches||[]).length>0;}catch(e){return false;}})()" - }, - "position": { - "x": 400, - "y": 450 - }, - "outputs": [ - "default" - ] - }, - { - "id": "update-behind-branches", - "type": "action.run_command", - "label": "Update Behind Branches", - "config": { - "command": "node -e \" const {execFileSync}=require('child_process'); const raw=String(process.env.BOSUN_FETCH_AND_CLASSIFY||''); const payload=(()=>{try{return JSON.parse(raw||'{}')}catch{return {}}})(); const behind=Array.isArray(payload.behindBranches)?payload.behindBranches:[]; let updated=0,failed=0; for(const pr of behind){ const repo=String(pr.repo||'').trim(); if(!repo){console.log('skip PR '+pr.n+' — no repo slug');continue;} try{ execFileSync('gh',['api','repos/'+repo+'/pulls/'+pr.n+'/update-branch','--method','PUT'],{encoding:'utf8',stdio:['pipe','pipe','pipe']}); updated++; console.log('Updated PR #'+pr.n+' ('+repo+')'); }catch(e){ failed++; console.log('Failed to update PR #'+pr.n+' ('+repo+'): '+String(e.message||e).slice(0,200)); } } console.log(JSON.stringify({updated,failed,total:behind.length})); \"", - "continueOnError": true, - "failOnError": false, - "timeout": 120000, - "env": { - "BOSUN_FETCH_AND_CLASSIFY": "{{$ctx.getNodeOutput('fetch-and-classify')?.output || '{}'}}" - } - }, - "position": { - "x": 600, - "y": 450 - }, - "outputs": [ - "default" - ] - }, - { - "id": "fix-needed", - "type": "condition.expression", - "label": "Fix Needed?", - "config": { - "expression": "(()=>{try{const o=$ctx.getNodeOutput('fetch-and-classify')?.output;return (JSON.parse(o||'{}').fixNeeded||0)>0;}catch(e){return false;}})()" - }, - "position": { - "x": 200, - "y": 530 - }, - "outputs": [ - "default" - ] - }, - { - "id": "security-fix-needed", - "type": "condition.expression", - "label": "Security Fix Needed?", - "config": { - "expression": "(()=>{try{const o=$ctx.getNodeOutput('fetch-and-classify')?.output;return (JSON.parse(o||'{}').securityFailures||[]).length>0;}catch(e){return false;}})()" - }, - "position": { - "x": 120, - "y": 640 - }, - "outputs": [ - "default" - ] - }, - { - "id": "programmatic-security-fix", - "type": "action.run_command", - "label": "Collect Security Alerts", - "config": { - "command": "node", - "args": [ - "-e", - "const {execFileSync}=require('child_process'); const raw=String(process.env.BOSUN_FETCH_AND_CLASSIFY||''); const payload=(()=>{try{return JSON.parse(raw||'{}')}catch{return {}}})(); const securityFailures=Array.isArray(payload.securityFailures)?payload.securityFailures:[]; const needsAgent=[]; let alertsFetched=0; function gh(args){return execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();} function safeGhJson(args,fallback){try{const out=gh(args);return out?JSON.parse(out):fallback;}catch{return fallback;}} function truncateText(value,max){const text=String(value||'').replace(/\\r/g,'').trim();if(!text)return '';return text.length>max?text.slice(0,Math.max(0,max-19))+'\\n...[truncated]':text;} function compactUser(user){const login=String(user?.login||user?.name||'').trim();return login?{login,url:String(user?.url||user?.html_url||'').trim()||null}:null;} function compactCheck(check){const name=String(check?.name||check?.context||check?.workflowName||'').trim();const state=String(check?.state||check?.conclusion||'').toUpperCase();const bucket=String(check?.bucket||'').toUpperCase();if(!name&&!state&&!bucket)return null;return {name:name||null,state:state||null,bucket:bucket||null,workflow:String(check?.workflowName||'').trim()||null};} function compactIssueComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactReview(review){return {id:Number(review?.id||0)||null,author:compactUser(review?.user||review?.author),state:String(review?.state||'').trim()||null,submittedAt:String(review?.submitted_at||review?.submittedAt||'').trim()||null,body:truncateText(review?.body,1200)};} function compactReviewComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),path:String(comment?.path||'').trim()||null,line:Number(comment?.line||0)||Number(comment?.original_line||0)||null,side:String(comment?.side||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactFile(file){const path=String(file?.filename||file?.path||'').trim();return path?{path,status:String(file?.status||'').trim()||null,additions:Number(file?.additions||0)||0,deletions:Number(file?.deletions||0)||0,changes:Number(file?.changes||0)||0}:null;} function collectPrDigest(repo,number,fallback){const pr=safeGhJson(['pr','view',String(number),'--repo',repo,'--json','number,title,body,url,headRefName,baseRefName,isDraft,mergeable,statusCheckRollup,author,labels,reviewDecision'],{});const issueComments=safeGhJson(['api','repos/'+repo+'/issues/'+number+'/comments?per_page=100'],[]).map(compactIssueComment).slice(0,40);const reviews=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/reviews?per_page=100'],[]).map(compactReview).slice(0,40);const reviewComments=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/comments?per_page=100'],[]).map(compactReviewComment).slice(0,60);const files=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/files?per_page=100'],[]).map(compactFile).filter(Boolean).slice(0,80);const requested=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/requested_reviewers'],{});const requestedReviewers=[...(Array.isArray(requested?.users)?requested.users:[]).map(compactUser),...(Array.isArray(requested?.teams)?requested.teams:[]).map((team)=>{const slug=String(team?.slug||team?.name||'').trim();return slug?{team:slug,url:String(team?.html_url||team?.url||'').trim()||null}:null;})].filter(Boolean);const checks=(Array.isArray(pr.statusCheckRollup)?pr.statusCheckRollup:[]).map(compactCheck).filter(Boolean);const labels=(Array.isArray(pr.labels)?pr.labels:[]).map((label)=>String(label?.name||label||'').trim()).filter(Boolean);const failingChecks=checks.filter((check)=>['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE'].includes(check.state)||check.bucket==='FAIL');const pendingChecks=checks.filter((check)=>['QUEUED','IN_PROGRESS','PENDING','WAITING','REQUESTED'].includes(check.state));const digestSummary=['PR #'+String(pr?.number||number)+' '+String(pr?.title||fallback?.title||''),'repo='+repo+' branch='+(String(pr?.headRefName||fallback?.branch||'').trim()||'unknown'),'checks='+checks.length+' fail='+failingChecks.length+' pending='+pendingChecks.length,'comments='+issueComments.length+' reviews='+reviews.length+' reviewComments='+reviewComments.length+' files='+files.length,labels.length?'labels='+labels.join(', '):''].filter(Boolean).join('\\n');return {core:{number:Number(pr?.number||number)||number,title:String(pr?.title||fallback?.title||''),url:String(pr?.url||fallback?.url||'').trim()||null,body:truncateText(pr?.body,4000),branch:String(pr?.headRefName||fallback?.branch||'').trim()||null,baseBranch:String(pr?.baseRefName||fallback?.base||'').trim()||null,isDraft:pr?.isDraft===true,mergeable:String(pr?.mergeable||'').trim()||null,author:compactUser(pr?.author),reviewDecision:String(pr?.reviewDecision||'').trim()||null},labels,requestedReviewers,checks,ciSummary:{total:checks.length,failing:failingChecks.length,pending:pendingChecks.length,passing:Math.max(0,checks.length-failingChecks.length-pendingChecks.length)},issueComments,reviews,reviewComments,files,digestSummary};} function compactAlert(alert){ const instance=alert?.most_recent_instance||{}; const location=instance?.location||{}; const rule=alert?.rule||{}; const tool=alert?.tool||{}; return { number: alert?.number ?? null, state: String(alert?.state||''), ruleId: String(rule?.id||alert?.rule_id||''), ruleName: String(rule?.name||alert?.rule_name||''), severity: String(rule?.severity||alert?.severity||''), securitySeverity: String(rule?.security_severity_level||alert?.security_severity_level||''), tool: String(tool?.name||alert?.tool_name||''), path: String(location?.path||''), startLine: Number(location?.start_line||0)||null, url: String(alert?.html_url||''), }; } for(const item of securityFailures){ const repo=String(item?.repo||'').trim(); const branch=String(item?.branch||'').trim(); const n=String(item?.n||'').trim(); const securityCheckNames=Array.isArray(item?.securityCheckNames)?item.securityCheckNames:[]; const prDigest=repo&&n?collectPrDigest(repo,n,{branch,base:String(item?.base||'').trim(),title:String(item?.title||''),url:String(item?.url||'')}):null; if(!repo||!branch){needsAgent.push({repo,number:n,branch,reason:'missing_repo_or_branch',securityCheckNames,alerts:[],prDigest,digestSummary:String(prDigest?.digestSummary||'')});continue;} let alerts=[]; let fetchError=''; try{ const alertsRaw=gh(['api','--method','GET','repos/'+repo+'/code-scanning/alerts','--raw-field','state=open','--raw-field','per_page=20','--raw-field','ref=refs/heads/'+branch]); const parsed=(()=>{try{return JSON.parse(alertsRaw||'[]')}catch{return []}})(); alerts=(Array.isArray(parsed)?parsed:[]).map(compactAlert).filter(a=>a.ruleId||a.ruleName||a.path).slice(0,10); if(alerts.length>0) alertsFetched++; }catch(e){fetchError=String(e?.message||e);} needsAgent.push({repo,number:n,branch,base:String(item?.base||'').trim(),url:String(item?.url||''),title:String(item?.title||''),reason:'security_code_scanning_failure',securityCheckNames,failedCheckNames:Array.isArray(item?.failedCheckNames)?item.failedCheckNames:[],alerts,fetchError,prDigest,digestSummary:String(prDigest?.digestSummary||'')}); } console.log(JSON.stringify({securityFailureCount:securityFailures.length,alertsFetched,needsAgentCount:needsAgent.length,needsAgent}));" - ], - "continueOnError": true, - "failOnError": false, - "env": { - "BOSUN_FETCH_AND_CLASSIFY": "{{$ctx.getNodeOutput('fetch-and-classify')?.output || '{}'}}" - } - }, - "position": { - "x": 120, - "y": 750 - }, - "outputs": [ - "default" - ] - }, - { - "id": "security-agent-needed", - "type": "condition.expression", - "label": "Needs Security Agent?", - "config": { - "expression": "(()=>{try{const o=$ctx.getNodeOutput('programmatic-security-fix')?.output;return (JSON.parse(o||'{}').needsAgentCount||0)>0;}catch(e){return false;}})()" - }, - "position": { - "x": 120, - "y": 860 - }, - "outputs": [ - "default" - ] - }, - { - "id": "claim-unclaimed-security-prs", - "type": "action.run_command", - "label": "Claim Unclaimed Security PRs", - "config": { - "command": "node", - "args": [ - "-e", - "const fs=require('fs'); const path=require('path'); const raw=String(process.env.BOSUN_SECURITY_FIX||''); const payload=(()=>{try{return JSON.parse(raw||'{}')}catch{return {}}})(); const needsAgent=Array.isArray(payload.needsAgent)?payload.needsAgent:[]; const TTL_MINUTES=Math.max(5,Number(process.env.PR_FIX_TTL_MINUTES||120)); const TTL_MS=TTL_MINUTES*60*1000; const CLAIM_FILE=path.join(process.cwd(),'.cache','bosun','pr-security-fix-claims.json'); const now=Date.now(); let data={claims:{},updatedAt:new Date().toISOString()}; try{fs.mkdirSync(path.dirname(CLAIM_FILE),{recursive:true});}catch{} try{if(fs.existsSync(CLAIM_FILE))data=JSON.parse(fs.readFileSync(CLAIM_FILE,'utf8'));}catch{} if(!data.claims)data.claims={}; for(const[key,claim]of Object.entries(data.claims)){if(now-new Date(claim.claimedAt).getTime()>TTL_MS)delete data.claims[key];} const unclaimed=[]; const alreadyClaimed=[]; for(const item of needsAgent){ const key=String(item.repo||'')+'/'+String(item.number||''); if(!key||key==='/'){continue;} if(data.claims[key]){alreadyClaimed.push({key,...item});continue;} data.claims[key]={claimedAt:new Date().toISOString(),repo:item.repo,number:item.number}; unclaimed.push({...item,claimKey:key,taskId:'pr-secfix-'+String(item.repo||'').replace(/[^a-z0-9]/gi,'-')+'-'+String(item.number||'')}); } data.updatedAt=new Date().toISOString(); try{fs.writeFileSync(CLAIM_FILE,JSON.stringify(data,null,2),'utf8');}catch{} console.log(JSON.stringify({unclaimedCount:unclaimed.length,alreadyClaimedCount:alreadyClaimed.length,unclaimed,alreadyClaimed}));" - ], - "continueOnError": true, - "failOnError": false, - "env": { - "BOSUN_SECURITY_FIX": "{{$ctx.getNodeOutput('programmatic-security-fix')?.output || '{}'}}", - "PR_FIX_TTL_MINUTES": "{{prFixTtlMinutes}}" - } - }, - "position": { - "x": 120, - "y": 920 - }, - "outputs": [ - "default" - ] - }, - { - "id": "has-unclaimed-security-fixes", - "type": "condition.expression", - "label": "Unclaimed Security Fixes?", - "config": { - "expression": "(()=>{try{const o=$ctx.getNodeOutput('claim-unclaimed-security-prs');const d=typeof o?.output==='object'?o.output:JSON.parse(o?.output||'{}');return (Array.isArray(d.unclaimed)?d.unclaimed:[]).length>0;}catch(e){return false;}})()" - }, - "position": { - "x": 120, - "y": 1010 - }, - "outputs": [ - "default" - ] - }, - { - "id": "dispatch-security-fix-agents", - "type": "loop.for_each", - "label": "Dispatch Security Fix Agents (Per PR)", - "config": { - "items": "(()=>{try{const o=$ctx.getNodeOutput('claim-unclaimed-security-prs');const d=typeof o?.output==='object'?o.output:JSON.parse(o?.output||'{}');return Array.isArray(d.unclaimed)?d.unclaimed:[];}catch{return []}})();", - "variable": "item", - "maxConcurrent": "{{maxConcurrentFixes}}", - "workflowId": "template-pr-security-fix-single" - }, - "position": { - "x": 120, - "y": 1100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "generic-fix-needed", - "type": "condition.expression", - "label": "Generic Fix Needed?", - "config": { - "expression": "(()=>{try{const o=$ctx.getNodeOutput('fetch-and-classify')?.output;const d=JSON.parse(o||'{}');return ((d.conflicts||[]).length+(d.ciFailures||[]).length)>0;}catch(e){return false;}})()" - }, - "position": { - "x": 280, - "y": 640 - }, - "outputs": [ - "default" - ] - }, - { - "id": "programmatic-fix", - "type": "action.run_command", - "label": "Programmatic Fix Pass", - "config": { - "command": "node", - "args": [ - "-e", - "const {execFileSync}=require('child_process'); const raw=String(process.env.BOSUN_FETCH_AND_CLASSIFY||''); const payload=(()=>{try{return JSON.parse(raw||'{}')}catch{return {}}})(); const ciFailures=Array.isArray(payload.ciFailures)?payload.ciFailures:[]; const conflicts=Array.isArray(payload.conflicts)?payload.conflicts:[]; const needsAgent=[]; let rerunRequested=0; const FAIL_STATES=new Set(['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE']); const MAX_AUTO_RERUN_ATTEMPT=1; const GH_MAX_BUFFER=25*1024*1024;const GH_CACHE_TTL_MS=30000;const ghReadCache=new Map();let ghRateLimitUntil=0;function ghSleep(ms){if(!Number.isFinite(ms)||ms<=0)return;Atomics.wait(new Int32Array(new SharedArrayBuffer(4)),0,0,Math.min(ms,5000));}function ghCacheKey(args){return JSON.stringify(Array.isArray(args)?args:[]);}function isGhReadOnly(args){const list=Array.isArray(args)?args.map((item)=>String(item||'').trim().toLowerCase()):[];if(list.length===0)return false;const joined=' '+list.join(' ')+' ';return !/( edit | merge | close | reopen | rerun | delete | create | ready | cancel )/.test(joined);}function readGhMessage(error){return String(error?.stderr||error?.stdout||error?.message||error||'');}function runGh(args){const cacheable=isGhReadOnly(args);const key=cacheable?ghCacheKey(args):'';const now=Date.now();if(cacheable){const cached=ghReadCache.get(key);if(cached&&cached.expiresAt>now)return cached.output;if(nowFAIL_STATES.has(String(step?.conclusion||step?.status||'').toUpperCase())).map((step)=>({name:String(step?.name||''),number:Number(step?.number||0)||null,status:String(step?.status||''),conclusion:String(step?.conclusion||'')})).filter((step)=>step.name).slice(0,10)}} function truncateText(value,max){const text=String(value||'').replace(/\\r/g,'').trim();if(!text)return '';return text.length>max?text.slice(0,Math.max(0,max-19))+'\\n...[truncated]':text;} function compactUser(user){const login=String(user?.login||user?.name||'').trim();return login?{login,url:String(user?.url||user?.html_url||'').trim()||null}:null;} function compactCheck(check){const name=String(check?.name||check?.context||check?.workflowName||'').trim();const state=String(check?.state||check?.conclusion||'').toUpperCase();const bucket=String(check?.bucket||'').toUpperCase();if(!name&&!state&&!bucket)return null;return {name:name||null,state:state||null,bucket:bucket||null,workflow:String(check?.workflowName||'').trim()||null};} function compactIssueComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactReview(review){return {id:Number(review?.id||0)||null,author:compactUser(review?.user||review?.author),state:String(review?.state||'').trim()||null,submittedAt:String(review?.submitted_at||review?.submittedAt||'').trim()||null,body:truncateText(review?.body,1200)};} function compactReviewComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),path:String(comment?.path||'').trim()||null,line:Number(comment?.line||0)||Number(comment?.original_line||0)||null,side:String(comment?.side||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactFile(file){const path=String(file?.filename||file?.path||'').trim();return path?{path,status:String(file?.status||'').trim()||null,additions:Number(file?.additions||0)||0,deletions:Number(file?.deletions||0)||0,changes:Number(file?.changes||0)||0}:null;} function collectPrDigest(repo,number,fallback){const pr=safeGhJson(['pr','view',String(number),'--repo',repo,'--json','number,title,body,url,headRefName,baseRefName,isDraft,mergeable,statusCheckRollup,author,labels,reviewDecision'],{});const issueComments=safeGhJson(['api','repos/'+repo+'/issues/'+number+'/comments?per_page=100'],[]).map(compactIssueComment).slice(0,40);const reviews=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/reviews?per_page=100'],[]).map(compactReview).slice(0,40);const reviewComments=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/comments?per_page=100'],[]).map(compactReviewComment).slice(0,60);const files=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/files?per_page=100'],[]).map(compactFile).filter(Boolean).slice(0,80);const requested=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/requested_reviewers'],{});const requestedReviewers=[...(Array.isArray(requested?.users)?requested.users:[]).map(compactUser),...(Array.isArray(requested?.teams)?requested.teams:[]).map((team)=>{const slug=String(team?.slug||team?.name||'').trim();return slug?{team:slug,url:String(team?.html_url||team?.url||'').trim()||null}:null;})].filter(Boolean);const checks=(Array.isArray(pr.statusCheckRollup)?pr.statusCheckRollup:[]).map(compactCheck).filter(Boolean);const failingChecks=checks.filter((check)=>['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE'].includes(check.state)||check.bucket==='FAIL');const pendingChecks=checks.filter((check)=>['QUEUED','IN_PROGRESS','PENDING','WAITING','REQUESTED'].includes(check.state));const labels=(Array.isArray(pr.labels)?pr.labels:[]).map((label)=>String(label?.name||label||'').trim()).filter(Boolean);const digestSummary=['PR #'+String(pr?.number||number)+' '+String(pr?.title||fallback?.title||''),'repo='+repo+' branch='+(String(pr?.headRefName||fallback?.branch||'').trim()||'unknown'),'checks='+checks.length+' fail='+failingChecks.length+' pending='+pendingChecks.length,'comments='+issueComments.length+' reviews='+reviews.length+' reviewComments='+reviewComments.length+' files='+files.length,labels.length?'labels='+labels.join(', '):''].filter(Boolean).join('\\n');return {core:{number:Number(pr?.number||number)||number,title:String(pr?.title||fallback?.title||''),url:String(pr?.url||fallback?.url||'').trim()||null,body:truncateText(pr?.body,4000),branch:String(pr?.headRefName||fallback?.branch||'').trim()||null,baseBranch:String(pr?.baseRefName||fallback?.base||'').trim()||null,isDraft:pr?.isDraft===true,mergeable:String(pr?.mergeable||'').trim()||null,author:compactUser(pr?.author),reviewDecision:String(pr?.reviewDecision||'').trim()||null},labels,requestedReviewers,checks,ciSummary:{total:checks.length,failing:failingChecks.length,pending:pendingChecks.length,passing:Math.max(0,checks.length-failingChecks.length-pendingChecks.length)},issueComments,reviews,reviewComments,files,digestSummary};} const CI_LOG_EXCERPT_MAX_CHARS=12000;const CI_MAX_JOB_DIAGNOSTICS=10;const CI_MAX_ANNOTATIONS=60;function safeGhJsonRunner(runner,args,fallback){try{const out=runner(args);return out?JSON.parse(out):fallback;}catch{return fallback;}}function parseCheckRunId(value){const match=String(value||'').match(/\\/check-runs\\/(\\d+)/i);return match?Number(match[1]||0)||0:0;}function normalizeAnnotation(annotation){if(!annotation||typeof annotation!=='object')return null;const path=String(annotation.path||'').trim();const message=truncateText(annotation.message,1200);if(!path&&!message)return null;return {path:path||null,startLine:Number(annotation.start_line||0)||null,endLine:Number(annotation.end_line||0)||null,startColumn:Number(annotation.start_column||0)||null,endColumn:Number(annotation.end_column||0)||null,level:String(annotation.annotation_level||'').trim()||null,title:truncateText(annotation.title,300)||null,message,rawDetails:truncateText(annotation.raw_details,800)||null};}function collectCheckRunAnnotations(repo,checkRunId,runner){if(!repo||!checkRunId)return [];const annotations=[];for(let page=1;page<=3&&annotations.length=CI_MAX_ANNOTATIONS)break;}if(batch.length<50)break;}return annotations.slice(0,CI_MAX_ANNOTATIONS);}function collectCiDiagnostics(repo,run,runner){const info={failedRun:normalizeRun(run),failedJobs:[],failedAnnotations:[],failedLogExcerpt:'',diagnosticsError:''};const runId=Number(run?.databaseId||0)||0;if(!runId||!repo)return info;let workflowJobs=[];try{const viewRaw=runner(['run','view',String(runId),'--repo',repo,'--json','attempt,conclusion,status,workflowName,displayTitle,url,createdAt,updatedAt,jobs']);const view=(()=>{try{return JSON.parse(viewRaw||'{}')}catch{return {}}})();info.failedRun=normalizeRun({...run,...view});const apiJobs=safeGhJsonRunner(runner,['api','repos/'+repo+'/actions/runs/'+runId+'/jobs?per_page=100'],{});workflowJobs=Array.isArray(apiJobs?.jobs)?apiJobs.jobs:(Array.isArray(view.jobs)?view.jobs:[]);info.failedJobs=workflowJobs.map(normalizeJob).filter((job)=>job&&(FAIL_STATES.has(String(job.conclusion||'').toUpperCase())||job.failedSteps.length>0)).slice(0,CI_MAX_JOB_DIAGNOSTICS);}catch(e){info.diagnosticsError=String(e?.message||e);}try{for(const job of info.failedJobs){const checkRunId=parseCheckRunId(job?.checkRunUrl);const annotations=collectCheckRunAnnotations(repo,checkRunId,runner);if(annotations.length===0)continue;info.failedAnnotations.push({name:String(job?.name||''),checkRunId,annotations});if(info.failedAnnotations.length>=CI_MAX_JOB_DIAGNOSTICS)break;}}catch(e){const message=String(e?.message||e);if(message&&message!==info.diagnosticsError){info.diagnosticsError=info.diagnosticsError?info.diagnosticsError+' | '+message:message;}}try{info.failedLogExcerpt=truncateText(runner(['run','view',String(runId),'--repo',repo,'--log-failed']),CI_LOG_EXCERPT_MAX_CHARS);}catch(e){const message=String(e?.message||e);if(message&&message!==info.diagnosticsError){info.diagnosticsError=info.diagnosticsError?info.diagnosticsError+' | '+message:message;}}return info;} for(const item of ciFailures){ const repo=String(item?.repo||'').trim(); const branch=String(item?.branch||'').trim(); const n=String(item?.n||'').trim(); const failedCheckNames=Array.isArray(item?.failedCheckNames)?item.failedCheckNames:[]; const url=String(item?.url||'').trim(); const title=String(item?.title||'').trim(); const prDigest=repo&&n?collectPrDigest(repo,n,{branch,title,url}):null; if(!repo||!branch){needsAgent.push({repo,number:n,branch,url,title,failedCheckNames,reason:'missing_repo_or_branch',prDigest,digestSummary:String(prDigest?.digestSummary||'')});continue;} let runs=[]; try{ const listRaw=runGh(['run','list','--repo',repo,'--branch',branch,'--json','databaseId,attempt,conclusion,status,workflowName,displayTitle,url,createdAt,updatedAt','--limit','8']); const parsedRuns=(()=>{try{return JSON.parse(listRaw||'[]')}catch{return []}})(); runs=Array.isArray(parsedRuns)?parsedRuns:[]; }catch(e){needsAgent.push({repo,number:n,branch,url,title,failedCheckNames,reason:'ci_run_listing_failed',error:String(e?.message||e),prDigest,digestSummary:String(prDigest?.digestSummary||'')});continue;} const failed=runs.find((r)=>FAIL_STATES.has(String(r?.conclusion||'').toUpperCase())); const failedRun=normalizeRun(failed); if(failedRun?.databaseId&&failedRun.attempt<=MAX_AUTO_RERUN_ATTEMPT){ try{runGh(['run','rerun',String(failedRun.databaseId),'--repo',repo]);rerunRequested++;continue;} catch(e){needsAgent.push({repo,number:n,branch,url,title,failedCheckNames,reason:'ci_rerun_failed',error:String(e?.message||e),prDigest,digestSummary:String(prDigest?.digestSummary||''),...collectCiDiagnostics(repo,failedRun,runGh)});continue;} } if(failedRun?.databaseId){needsAgent.push({repo,number:n,branch,url,title,failedCheckNames,reason:'auto_rerun_limit_reached',rerunAttempts:failedRun.attempt||0,prDigest,digestSummary:String(prDigest?.digestSummary||''),...collectCiDiagnostics(repo,failedRun,runGh)});continue;} needsAgent.push({repo,number:n,branch,url,title,failedCheckNames,reason:'no_rerunnable_failed_run_found',recentRuns:runs.map(normalizeRun).filter(Boolean).slice(0,5),prDigest,digestSummary:String(prDigest?.digestSummary||'')}); } let branchUpdated=0; for(const item of conflicts){ const repo=String(item?.repo||'').trim(); const n=String(item?.n||'').trim(); const branch=String(item?.branch||'').trim(); const base=String(item?.base||'').trim(); const mergeable=String(item?.mergeable||'').toUpperCase(); const prDigest=repo&&n?collectPrDigest(repo,n,{branch,base,url:String(item?.url||'')}):null; if(!repo||!n){needsAgent.push({...item,reason:'missing_repo_or_pr',prDigest,digestSummary:String(prDigest?.digestSummary||'')});continue;} if(mergeable==='BEHIND'){ try{ const headSha=JSON.parse(runGh(['pr','view',n,'--repo',repo,'--json','headRefOid'])).headRefOid; const apiArgs=['api','-X','PUT','repos/'+repo+'/pulls/'+n+'/update-branch','--field','expected_head_sha='+headSha]; runGh(apiArgs); branchUpdated++; }catch(e){needsAgent.push({repo,number:n,branch,base,mergeable,reason:'branch_update_failed',error:String(e?.message||e),prDigest,digestSummary:String(prDigest?.digestSummary||'')});} continue; } needsAgent.push({repo,number:n,branch,base,mergeable,reason:'merge_conflict_requires_code_resolution',prDigest,digestSummary:String(prDigest?.digestSummary||'')}); } console.log(JSON.stringify({rerunRequested,branchUpdated,ciFailureCount:ciFailures.length,conflictCount:conflicts.length,needsAgentCount:needsAgent.length,needsAgent}));" - ], - "continueOnError": true, - "failOnError": false, - "env": { - "BOSUN_FETCH_AND_CLASSIFY": "{{$ctx.getNodeOutput('fetch-and-classify')?.output || '{}'}}" - } - }, - "position": { - "x": 280, - "y": 750 - }, - "outputs": [ - "default" - ] - }, - { - "id": "fix-agent-needed", - "type": "condition.expression", - "label": "Needs Agent Fix?", - "config": { - "expression": "(()=>{try{const o=$ctx.getNodeOutput('programmatic-fix')?.output;return (JSON.parse(o||'{}').needsAgentCount||0)>0;}catch(e){return false;}})()" - }, - "position": { - "x": 280, - "y": 860 - }, - "outputs": [ - "default" - ] - }, - { - "id": "claim-unclaimed-prs", - "type": "action.run_command", - "label": "Claim & Filter Unclaimed PRs", - "config": { - "command": "node", - "args": [ - "-e", - "const fs=require('fs'); const path=require('path'); const raw=String(process.env.BOSUN_PROGRAMMATIC_FIX||''); const payload=(()=>{try{return JSON.parse(raw||'{}')}catch{return {}}})(); const needsAgent=Array.isArray(payload.needsAgent)?payload.needsAgent:[]; const TTL_MS=Math.max(60000,Number(process.env.PR_FIX_TTL_MINUTES||'120')*60*1000); const STALE_CLAIM_MS=Math.max(10*60*1000,Math.min(TTL_MS,20*60*1000)); const CLAIM_DIR=path.join(process.cwd(),'.cache','bosun'); const CLAIM_FILE=path.join(CLAIM_DIR,'pr-fix-claims.json'); function loadClaims(){try{const d=JSON.parse(fs.readFileSync(CLAIM_FILE,'utf8'));return(d&&typeof d==='object'&&d.claims&&typeof d.claims==='object')?d.claims:{};}catch{return {};}} function saveClaims(claims){try{if(!fs.existsSync(CLAIM_DIR))fs.mkdirSync(CLAIM_DIR,{recursive:true});const data={version:1,claims,updatedAt:new Date().toISOString()};const tmp=CLAIM_FILE+'.tmp'+Date.now();fs.writeFileSync(tmp,JSON.stringify(data,null,2),'utf8');fs.renameSync(tmp,CLAIM_FILE);}catch(e){process.stderr.write('[claim] save error: '+String(e?.message||e)+'\\n');}} const now=Date.now(); const claims=loadClaims(); /* Purge expired or abandoned claims so stalled repair runs do not block retries for hours. */ for(const key of Object.keys(claims)){const claim=claims[key]||{};const expiresAt=new Date(claim.expiresAt||0).getTime();const claimedAt=new Date(claim.claimedAt||0).getTime();const staleByAge=Number.isFinite(claimedAt)&&claimedAt>0&&(now-claimedAt)>=STALE_CLAIM_MS;if(now>expiresAt||staleByAge)delete claims[key];} const unclaimed=[]; const alreadyClaimed=[]; for(const item of needsAgent){ const repo=String(item?.repo||'').trim(); const number=String(item?.number||item?.n||'').trim(); if(!repo||!number){unclaimed.push({...item,taskId:'pr-fix-unknown',taskTitle:'Unknown PR',claimKey:''});continue;} const key=repo+'#'+number; const claim=claims[key]; if(claim&&now{try{const o=$ctx.getNodeOutput('claim-unclaimed-prs');const d=typeof o?.output==='object'?o.output:JSON.parse(o?.output||'{}');return (Array.isArray(d.unclaimed)?d.unclaimed:[]).length>0;}catch(e){return false;}})()" - }, - "position": { - "x": 280, - "y": 1060 - }, - "outputs": [ - "default" - ] - }, - { - "id": "dispatch-fix-agents", - "type": "loop.for_each", - "label": "Dispatch Fix Agents (Per PR)", - "config": { - "items": "(()=>{try{const o=$ctx.getNodeOutput('claim-unclaimed-prs');const d=typeof o?.output==='object'?o.output:JSON.parse(o?.output||'{}');return Array.isArray(d.unclaimed)?d.unclaimed:[];}catch{return []}})();", - "variable": "item", - "maxConcurrent": "{{maxConcurrentFixes}}", - "workflowId": "template-pr-fix-single" - }, - "position": { - "x": 280, - "y": 1160 - }, - "outputs": [ - "default" - ] - }, - { - "id": "review-needed", - "type": "condition.expression", - "label": "Review Candidates?", - "config": { - "expression": "(()=>{try{const o=$ctx.getNodeOutput('fetch-and-classify')?.output;return (JSON.parse(o||'{}').readyCandidates||[]).length>0;}catch(e){return false;}})()" - }, - "position": { - "x": 600, - "y": 530 - }, - "outputs": [ - "default" - ] - }, - { - "id": "programmatic-review", - "type": "action.run_command", - "label": "Review Gate: Programmatic Merge", - "config": { - "command": "node", - "args": [ - "-e", - "const fs=require('fs'); const path=require('path'); const {execFileSync}=require('child_process'); const raw=String(process.env.BOSUN_FETCH_AND_CLASSIFY||''); const payload=(()=>{try{return JSON.parse(raw||'{}')}catch{return {}}})(); const candidates=Array.isArray(payload.readyCandidates)?payload.readyCandidates:[]; const ratio=Number('{{suspiciousDeletionRatio}}')||3; const minDel=Number('{{minDestructiveDeletions}}')||500; const labelReview=String('{{labelNeedsReview}}'||'bosun-needs-human-review'); const method=String('{{mergeMethod}}'||'merge').toLowerCase(); const merged=[]; const held=[]; const skipped=[]; function gh(args){return execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();} function normalizeList(value){if(Array.isArray(value)) return value.map((entry)=>String(entry||'').trim().toLowerCase()).filter(Boolean); return String(value||'').split(',').map((entry)=>entry.trim().toLowerCase()).filter(Boolean);} function parseBool(value,fallback){if(value===undefined||value===null||value==='') return fallback; const raw=String(value).trim().toLowerCase(); if(['1','true','yes','on'].includes(raw)) return true; if(['0','false','no','off'].includes(raw)) return false; return fallback;} function matchesCheckPattern(name,pattern){const text=String(name||'').trim().toLowerCase();const token=String(pattern||'').trim().toLowerCase();if(!text||!token)return false;if(token==='*')return true;if(!token.includes('*'))return text.includes(token);const parts=token.split('*').filter(Boolean);if(parts.length===0)return true;let cursor=0;for(const part of parts){const idx=text.indexOf(part,cursor);if(idx===-1)return false;cursor=idx+part.length;}if(!token.startsWith('*')&&!text.startsWith(parts[0]||''))return false;if(!token.endsWith('*')&&!text.endsWith(parts[parts.length-1]||''))return false;return true;} function matchesAnyPattern(name,patterns){return (Array.isArray(patterns)?patterns:[]).some((pattern)=>matchesCheckPattern(name,pattern));} function readCheckState(check){return String(check?.state||check?.conclusion||check?.bucket||'').trim().toUpperCase();} function isPassingCheckState(state,treatNeutralAsPass){if(!state)return true;if(['SUCCESS','PASS','PASSED','COMPLETED'].includes(state))return true;if(treatNeutralAsPass&&['NEUTRAL','SKIPPED'].includes(state))return true;return !['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE'].includes(state)&&!['QUEUED','IN_PROGRESS','PENDING','WAITING','REQUESTED'].includes(state);} function evaluateCheckGates(checks,policy){const normalized=(Array.isArray(checks)?checks:[]).map((check)=>({name:String(check?.name||'').trim(),state:readCheckState(check)})).filter((check)=>check.name);const considered=normalized.filter((check)=>!matchesAnyPattern(check.name,policy.ignorePatterns));let required=considered;if(policy.mode==='required-only'){required=considered.filter((check)=>matchesAnyPattern(check.name,policy.requiredPatterns));}if((Array.isArray(policy.optionalPatterns)?policy.optionalPatterns:[]).length>0){required=required.filter((check)=>!matchesAnyPattern(check.name,policy.optionalPatterns));}const missingRequired=policy.requireAnyRequiredCheck&&required.length===0;const hasFailure=required.some((check)=>['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE'].includes(check.state));const hasPending=policy.treatPendingRequiredAsBlocking&&required.some((check)=>['QUEUED','IN_PROGRESS','PENDING','WAITING','REQUESTED'].includes(check.state));return {hasFailure,hasPending,missingRequired,noConsideredChecks:considered.length===0,isReady:!missingRequired&&!hasFailure&&!hasPending&&required.every((check)=>isPassingCheckState(check.state,policy.treatNeutralAsPass))};} function configPath(){const home=String(process.env.BOSUN_HOME||process.env.BOSUN_PROJECT_DIR||'').trim();return home?path.join(home,'bosun.config.json'):path.join(process.cwd(),'bosun.config.json');} function readBosunConfig(){try{return JSON.parse(fs.readFileSync(configPath(),'utf8'));}catch{return {};}} const BOSUN_CONFIG=readBosunConfig(); const CHECK_GATES=(BOSUN_CONFIG&&typeof BOSUN_CONFIG.gates==='object'&&BOSUN_CONFIG.gates&&typeof BOSUN_CONFIG.gates.checks==='object')?BOSUN_CONFIG.gates.checks:{}; const CHECK_MODE=((String(CHECK_GATES?.mode||'all').trim().toLowerCase())||'all'); const REQUIRED_CHECK_PATTERNS=normalizeList(CHECK_GATES?.requiredPatterns); const OPTIONAL_CHECK_PATTERNS=normalizeList(CHECK_GATES?.optionalPatterns); const IGNORE_CHECK_PATTERNS=normalizeList(CHECK_GATES?.ignorePatterns); const REQUIRE_ANY_REQUIRED_CHECK=parseBool(CHECK_GATES?.requireAnyRequiredCheck, true); const TREAT_PENDING_REQUIRED_AS_BLOCKING=parseBool(CHECK_GATES?.treatPendingRequiredAsBlocking, true); const TREAT_NEUTRAL_AS_PASS=parseBool(CHECK_GATES?.treatNeutralAsPass, false); for(const c of candidates){ const repo=String(c?.repo||'').trim(); const n=String(c?.n||'').trim(); if(!repo||!n){skipped.push({repo,number:n,reason:'missing_repo_or_pr'});continue;} try{ const viewRaw=gh(['pr','view',n,'--repo',repo,'--json','number,title,additions,deletions,changedFiles,isDraft']); const view=(()=>{try{return JSON.parse(viewRaw||'{}')}catch{return {}}})(); if(view?.isDraft===true){skipped.push({repo,number:n,reason:'draft'});continue;} const add=Number(view?.additions||0); const del=Number(view?.deletions||0); const changed=Number(view?.changedFiles||0); const destructive=(del>(add*ratio))&&(del>minDel); const tooWide=changed>250; if(destructive||tooWide){ gh(['pr','edit',n,'--repo',repo,'--add-label',labelReview]); gh(['pr','comment',n,'--repo',repo,'--body',':warning: Bosun held this PR for human review due to suspicious diff footprint.']); held.push({repo,number:n,reason:destructive?'destructive_diff':'changed_files_too_large',additions:add,deletions:del,changedFiles:changed}); continue; } const checksRaw=gh(['pr','checks',n,'--repo',repo,'--json','name,state,bucket']); const checks=(()=>{try{return JSON.parse(checksRaw||'[]')}catch{return []}})(); const gateVerdict=evaluateCheckGates(checks,{mode:CHECK_MODE,requiredPatterns:REQUIRED_CHECK_PATTERNS,optionalPatterns:OPTIONAL_CHECK_PATTERNS,ignorePatterns:IGNORE_CHECK_PATTERNS,requireAnyRequiredCheck:REQUIRE_ANY_REQUIRED_CHECK,treatPendingRequiredAsBlocking:TREAT_PENDING_REQUIRED_AS_BLOCKING,treatNeutralAsPass:TREAT_NEUTRAL_AS_PASS}); if(gateVerdict.hasFailure){skipped.push({repo,number:n,reason:'ci_failed'});continue;} if(gateVerdict.hasPending){skipped.push({repo,number:n,reason:'ci_pending'});continue;} if(gateVerdict.missingRequired){skipped.push({repo,number:n,reason:'no_required_checks'});continue;} if(gateVerdict.noConsideredChecks){skipped.push({repo,number:n,reason:'no_checks_yet'});continue;} const doApplySuggestions=String('{{autoApplySuggestions}}'||'true')==='true'&&process.env.BOSUN_AUTO_APPLY_SUGGESTIONS!=='false'; if(doApplySuggestions){ try{ const toolPath=require('path').resolve(process.cwd(),'tools','apply-pr-suggestions.mjs'); if(require('fs').existsSync(toolPath)){ const sugOut=execFileSync('node',[toolPath,'--owner',repo.split('/')[0],'--repo',repo.split('/')[1],n,'--json'],{encoding:'utf8',timeout:60000,stdio:['pipe','pipe','pipe']}); const sugRes=(()=>{try{return JSON.parse(sugOut)}catch{return null}})(); if(sugRes?.commitSha){console.error('[watchdog] auto-applied '+sugRes.applied+' suggestion(s) on PR #'+n+' → '+sugRes.commitSha.slice(0,8));skipped.push({repo,number:n,reason:'suggestions_applied_awaiting_ci'});continue;} } }catch(sugErr){console.error('[watchdog] suggestion auto-apply skipped for PR #'+n+': '+String(sugErr?.message||sugErr).slice(0,120));} } const mergeArgs=['pr','merge',n,'--repo',repo,'--delete-branch']; if(method==='rebase') mergeArgs.push('--rebase'); else if(method==='merge') mergeArgs.push('--merge'); else mergeArgs.push('--squash'); try{gh(mergeArgs);}catch(directErr){ mergeArgs.push('--auto'); gh(mergeArgs); } merged.push({repo,number:n,title:String(view?.title||'')}); }catch(e){ held.push({repo,number:n,reason:'merge_attempt_failed',error:String(e?.message||e)}); } } console.log(JSON.stringify({mergedCount:merged.length,heldCount:held.length,skippedCount:skipped.length,merged,held,skipped}));" - ], - "continueOnError": true, - "failOnError": false, - "env": { - "BOSUN_FETCH_AND_CLASSIFY": "{{$ctx.getNodeOutput('fetch-and-classify')?.output || '{}'}}" - } - }, - "position": { - "x": 600, - "y": 700 - }, - "outputs": [ - "default" - ] - }, - { - "id": "notify", - "type": "notify.log", - "label": "Watchdog Report", - "config": { - "message": "Bosun PR Watchdog cycle complete — see live digest/status board for streaming updates", - "level": "info" - }, - "position": { - "x": 400, - "y": 900 - }, - "outputs": [ - "default" - ] - }, - { - "id": "no-prs", - "type": "notify.log", - "label": "No Bosun PRs Open", - "config": { - "message": "Bosun PR Watchdog: no open automation-eligible PRs found — idle", - "level": "info" - }, - "position": { - "x": 700, - "y": 370 - }, - "outputs": [ - "default" - ] - }, - { - "id": "cleanup-merged-branches", - "type": "action.run_command", - "label": "Prune Merged Branches", - "config": { - "command": "node", - "args": [ - "-e", - "const {execFileSync}=require('child_process'); function gh(a){return execFileSync('gh',a,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();} const repos=String(process.env.BOSUN_REPO_LIST||'').split(',').map(s=>s.trim()).filter(Boolean); let deleted=0; for(const repo of repos){ try{ const raw=gh(['pr','list','--repo',repo,'--state','merged','--json','number,headRefName,labels','--limit','50']); const prs=(()=>{try{return JSON.parse(raw||'[]')}catch{return []}})(); for(const pr of prs){ const labels=Array.isArray(pr?.labels)?pr.labels.map((entry)=>typeof entry==='string'?entry:entry?.name).filter(Boolean):[]; if(!labels.includes('bosun-pr-bosun-created')) continue; const branch=String(pr?.headRefName||'').trim(); if(!branch||branch==='main'||branch==='master')continue; try{gh(['api','repos/'+repo+'/git/refs/heads/'+branch,'--method','DELETE','--silent']);deleted++;}catch(e){} } }catch(e){} } console.log(JSON.stringify({deletedBranches:deleted}));" - ], - "continueOnError": true, - "failOnError": false, - "env": { - "BOSUN_REPO_LIST": "{{$ctx.getNodeOutput('fetch-and-classify')?.output ? (()=>{try{const o=JSON.parse($ctx.getNodeOutput('fetch-and-classify').output);return [...new Set([...(o.fixCandidates||[]),...(o.readyCandidates||[])].map(c=>c.repo).filter(Boolean))].join(',')}catch{return ''}})() : ''}}" - } - }, - "position": { - "x": 400, - "y": 1020 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->fetch-and-classify", - "source": "trigger", - "target": "fetch-and-classify", - "sourcePort": "default" - }, - { - "id": "fetch-and-classify->has-prs", - "source": "fetch-and-classify", - "target": "has-prs", - "sourcePort": "default" - }, - { - "id": "has-prs->has-behind", - "source": "has-prs", - "target": "has-behind", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "has-prs->no-prs", - "source": "has-prs", - "target": "no-prs", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "has-prs->review-needed", - "source": "has-prs", - "target": "review-needed", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "has-behind->update-behind-branches", - "source": "has-behind", - "target": "update-behind-branches", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "has-behind->fix-needed", - "source": "has-behind", - "target": "fix-needed", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "update-behind-branches->fix-needed", - "source": "update-behind-branches", - "target": "fix-needed", - "sourcePort": "default" - }, - { - "id": "fix-needed->security-fix-needed", - "source": "fix-needed", - "target": "security-fix-needed", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "fix-needed->review-needed", - "source": "fix-needed", - "target": "review-needed", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "security-fix-needed->programmatic-security-fix", - "source": "security-fix-needed", - "target": "programmatic-security-fix", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "security-fix-needed->generic-fix-needed", - "source": "security-fix-needed", - "target": "generic-fix-needed", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "programmatic-security-fix->security-agent-needed", - "source": "programmatic-security-fix", - "target": "security-agent-needed", - "sourcePort": "default" - }, - { - "id": "security-agent-needed->claim-unclaimed-security-prs", - "source": "security-agent-needed", - "target": "claim-unclaimed-security-prs", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "security-agent-needed->generic-fix-needed", - "source": "security-agent-needed", - "target": "generic-fix-needed", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "claim-unclaimed-security-prs->has-unclaimed-security-fixes", - "source": "claim-unclaimed-security-prs", - "target": "has-unclaimed-security-fixes", - "sourcePort": "default" - }, - { - "id": "has-unclaimed-security-fixes->dispatch-security-fix-agents", - "source": "has-unclaimed-security-fixes", - "target": "dispatch-security-fix-agents", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "has-unclaimed-security-fixes->generic-fix-needed", - "source": "has-unclaimed-security-fixes", - "target": "generic-fix-needed", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "dispatch-security-fix-agents->generic-fix-needed", - "source": "dispatch-security-fix-agents", - "target": "generic-fix-needed", - "sourcePort": "default" - }, - { - "id": "generic-fix-needed->programmatic-fix", - "source": "generic-fix-needed", - "target": "programmatic-fix", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "generic-fix-needed->review-needed", - "source": "generic-fix-needed", - "target": "review-needed", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "programmatic-fix->fix-agent-needed", - "source": "programmatic-fix", - "target": "fix-agent-needed", - "sourcePort": "default" - }, - { - "id": "fix-agent-needed->claim-unclaimed-prs", - "source": "fix-agent-needed", - "target": "claim-unclaimed-prs", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "fix-agent-needed->review-needed", - "source": "fix-agent-needed", - "target": "review-needed", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "claim-unclaimed-prs->has-unclaimed-fixes", - "source": "claim-unclaimed-prs", - "target": "has-unclaimed-fixes", - "sourcePort": "default" - }, - { - "id": "has-unclaimed-fixes->dispatch-fix-agents", - "source": "has-unclaimed-fixes", - "target": "dispatch-fix-agents", - "sourcePort": "default", + "id": "push-ok->create-pr", + "source": "push-ok", + "target": "create-pr", + "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "has-unclaimed-fixes->review-needed", - "source": "has-unclaimed-fixes", - "target": "review-needed", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "dispatch-fix-agents->review-needed", - "source": "dispatch-fix-agents", - "target": "review-needed", + "id": "create-pr->pr-created", + "source": "create-pr", + "target": "pr-created", "sourcePort": "default" }, { - "id": "review-needed->programmatic-review", - "source": "review-needed", - "target": "programmatic-review", - "sourcePort": "default", + "id": "pr-created->set-inreview", + "source": "pr-created", + "target": "set-inreview", + "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "review-needed->notify", - "source": "review-needed", - "target": "notify", - "sourcePort": "default", + "id": "pr-created->set-todo-push-failed", + "source": "pr-created", + "target": "set-todo-push-failed", + "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "programmatic-review->notify", - "source": "programmatic-review", - "target": "notify", - "sourcePort": "default" - }, - { - "id": "notify->cleanup-merged-branches", - "source": "notify", - "target": "cleanup-merged-branches", - "sourcePort": "default" - } - ], - "metadata": { - "author": "bosun-demo", - "createdAt": "2026-03-02T12:00:00.000Z", - "updatedAt": "2026-03-02T12:00:00.000Z", - "templateState": { - "templateId": "template-bosun-pr-watchdog", - "templateName": "Bosun PR Watchdog", - "templateVersion": "3.0.0", - "installedTemplateVersion": "3.0.0", - "isCustomized": false, - "updateAvailable": false - } - } - }, - { - "id": "wf-github-kanban-sync", - "name": "GitHub ↔ Kanban Sync", - "description": "Reconciles GitHub PR state with the bosun kanban board every 5 minutes. Marks tasks as in-review when Bosun-created PRs open, moves them to done when PRs are merged, and posts completion comments via the kanban API. Replaces the legacy github-reconciler.mjs module.", - "category": "github", - "enabled": true, - "nodeCount": 8, - "trigger": "trigger.schedule", - "variables": { - "lookbackHours": 24, - "repoScope": "auto" - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.schedule", - "label": "Sync Every 5 min", - "config": { - "intervalMs": 300000, - "cron": "*/5 * * * *" - }, - "position": { - "x": 400, - "y": 50 - }, - "outputs": [ - "default" - ] - }, - { - "id": "fetch-pr-state", - "type": "action.run_command", - "label": "Fetch Bosun PR State", - "config": { - "command": "node", - "args": [ - "-e", - "const fs=require('fs'); const path=require('path'); const {execFileSync}=require('child_process'); const hours=Number('{{lookbackHours}}')||24; const repoScope=String('{{repoScope}}'||'auto').trim(); const since=new Date(Date.now()-hours*3600000).toISOString(); function ghJson(args){ try{const o=execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();return o?JSON.parse(o):[];} catch{return [];} } function configPath(){ const home=String(process.env.BOSUN_HOME||process.env.BOSUN_PROJECT_DIR||'').trim(); return home?path.join(home,'bosun.config.json'):path.join(process.cwd(),'bosun.config.json'); } function collectReposFromConfig(){ const repos=[]; try{ const cfg=JSON.parse(fs.readFileSync(configPath(),'utf8')); const workspaces=Array.isArray(cfg?.workspaces)?cfg.workspaces:[]; if(workspaces.length>0){ const active=String(cfg?.activeWorkspace||'').trim().toLowerCase(); const activeWs=active?workspaces.find(w=>String(w?.id||'').trim().toLowerCase()===active):null; const wsList=activeWs?[activeWs]:workspaces; for(const ws of wsList){ for(const repo of (Array.isArray(ws?.repos)?ws.repos:[])){ const slug=typeof repo==='string'?String(repo).trim():String(repo?.slug||'').trim(); if(slug) repos.push(slug); } } } if(repos.length===0){ for(const repo of (Array.isArray(cfg?.repos)?cfg.repos:[])){ const slug=typeof repo==='string'?String(repo).trim():String(repo?.slug||'').trim(); if(slug) repos.push(slug); } } }catch{} return repos; } function resolveRepoTargets(){ if(repoScope&&repoScope!=='auto'&&repoScope!=='all'&&repoScope!=='current'){ return [...new Set(repoScope.split(',').map(v=>v.trim()).filter(Boolean))]; } if(repoScope==='current') return ['']; const fromConfig=collectReposFromConfig(); if(fromConfig.length>0) return [...new Set(fromConfig)]; const envRepo=String(process.env.GITHUB_REPOSITORY||'').trim(); if(envRepo) return [envRepo]; return ['']; } function parseRepoFromUrl(url){ const raw=String(url||''); const marker='github.com/'; const idx=raw.toLowerCase().indexOf(marker); if(idx<0) return ''; const tail=raw.slice(idx+marker.length).split('/'); if(tail.length<2) return ''; const owner=String(tail[0]||'').trim(); const repo=String(tail[1]||'').trim(); return owner&&repo?(owner+'/'+repo):''; } function extractTaskId(pr){ const src=String((pr.body||'')+'\\n'+(pr.title||'')); const m=src.match(/(?:Bosun-Task|VE-Task|Task-ID|task[_-]?id)[:\\s]+([a-zA-Z0-9_-]{4,64})/i); return m?m[1].trim():null; } function shouldSyncTaskPr(pr){ return Boolean(extractTaskId(pr)); } const repoTargets=resolveRepoTargets(); const merged=[]; const open=[]; for(const target of repoTargets){ const repo=String(target||'').trim(); const mergedArgs=['pr','list','--state','merged','--json','number,title,body,headRefName,mergedAt,url','--limit','50']; const openArgs=['pr','list','--state','open','--json','number,title,body,headRefName,isDraft,url','--limit','50']; if(repo){ mergedArgs.push('--repo',repo); openArgs.push('--repo',repo); } for(const pr of ghJson(mergedArgs)){ if(shouldSyncTaskPr(pr)) merged.push({...pr,__repo:repo||parseRepoFromUrl(pr?.url)||String(process.env.GITHUB_REPOSITORY||'').trim()}); } for(const pr of ghJson(openArgs)){ if(shouldSyncTaskPr(pr)) open.push({...pr,__repo:repo||parseRepoFromUrl(pr?.url)||String(process.env.GITHUB_REPOSITORY||'').trim()}); } } const recentMerged=merged.filter(p=>!p.mergedAt||new Date(p.mergedAt)>=new Date(since)); console.log(JSON.stringify({ repoScope, reposScanned: repoTargets.length, merged:recentMerged.map(p=>({n:p.number,repo:p.__repo||'',title:p.title,branch:p.headRefName,taskId:extractTaskId(p)})), open:open.filter(p=>!p.isDraft).map(p=>({n:p.number,repo:p.__repo||'',title:p.title,branch:p.headRefName,taskId:extractTaskId(p)})), }));" - ], - "continueOnError": true - }, - "position": { - "x": 400, - "y": 200 - }, - "outputs": [ - "default" - ] - }, - { - "id": "has-updates", - "type": "condition.expression", - "label": "Any Updates?", - "config": { - "expression": "(()=>{try{const o=$ctx.getNodeOutput('fetch-pr-state')?.output;const d=JSON.parse(o||'{}');return (d.merged||[]).length>0||(d.open||[]).length>0;}catch{return false;}})()" - }, - "position": { - "x": 400, - "y": 370 - }, - "outputs": [ - "default" - ] - }, - { - "id": "sync-programmatic", - "type": "action.run_command", - "label": "Sync PR State → Kanban (Programmatic)", - "config": { - "command": "node", - "args": [ - "-e", - "const {execFileSync}=require('child_process'); const fs=require('fs'); const raw=String(process.env.BOSUN_FETCH_PR_STATE||''); const data=(()=>{try{return JSON.parse(raw||'{}')}catch{return {}}})(); const merged=Array.isArray(data.merged)?data.merged:[]; const open=Array.isArray(data.open)?data.open:[]; const updates=[]; const unresolved=[]; const maxBuffer=25*1024*1024; const cliPath=fs.existsSync('cli.mjs')?'cli.mjs':''; const taskCli=['task/task-cli.mjs','task-cli.mjs'].find(p=>fs.existsSync(p))||''; const taskRunner=cliPath?'cli':(taskCli?'task-cli':''); if(!taskRunner){ console.log(JSON.stringify({updated:0,unresolved:[{reason:'task_command_missing'}],needsAgent:true})); process.exit(0); } function runTask(args){const cmdArgs=taskRunner==='cli'?['cli.mjs','task',...args,'--config-dir','.bosun','--repo-root','.']:[taskCli,...args];return execFileSync('node',cmdArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe'],maxBuffer}).trim();} function parseJsonObject(raw){const txt=String(raw||'').trim();if(!txt)return null;try{return JSON.parse(txt);}catch{}const lines=txt.split(/\\r?\\n/);for(let start=0;starts.trim()).filter(Boolean);for(let i=compact.length-1;i>=0;i--){const line=compact[i];if(!(line.startsWith('{')||line.startsWith('[')))continue;try{return JSON.parse(line);}catch{}}const start=txt.indexOf('{');const end=txt.lastIndexOf('}');if(start>=0&&end>start){try{return JSON.parse(txt.slice(start,end+1));}catch{}}return null;} let taskListCache=null; function normalizeRepo(value){return String(value||'').trim().toLowerCase();} function listTasks(){ if(Array.isArray(taskListCache)) return taskListCache; try{const raw=runTask(['list','--json']);const tasks=parseJsonObject(raw);taskListCache=Array.isArray(tasks)?tasks:[];return taskListCache;}catch{taskListCache=[];return taskListCache;} } function resolveTaskId(item){ const explicit=String(item?.taskId||'').trim(); if(explicit) return explicit; const branch=String(item?.branch||'').trim(); if(!branch) return ''; const repo=normalizeRepo(item?.repo); const matches=listTasks().filter((task)=>{ const taskBranch=String(task?.branchName||'').trim(); if(taskBranch!==branch) return false; const taskRepo=normalizeRepo(task?.repository||''); if(!repo || !taskRepo) return true; return taskRepo===repo; }); if(matches.length===1) return String(matches[0]?.id||'').trim(); const exactRepo=matches.find((task)=>normalizeRepo(task?.repository||'')===repo); return exactRepo?String(exactRepo?.id||'').trim():''; } function getTaskSnapshot(id){ try{const raw=runTask(['get',id,'--json']);const task=parseJsonObject(raw);return {status:task?.status||null,reviewStatus:task?.reviewStatus||null};}catch{return {status:null,reviewStatus:null};} } for(const item of merged){ const id=resolveTaskId(item); if(!id){unresolved.push({taskId:null,repo:String(item?.repo||''),branch:String(item?.branch||''),status:'done',reason:'task_lookup_failed'});continue;} try{runTask(['update',id,'--status','done']);updates.push({taskId:id,status:'done'});}catch(e){unresolved.push({taskId:id,status:'done',error:String(e?.message||e)});} } for(const item of open){ const id=resolveTaskId(item); if(!id){unresolved.push({taskId:null,repo:String(item?.repo||''),branch:String(item?.branch||''),status:'inreview',reason:'task_lookup_failed'});continue;} try{const snap=getTaskSnapshot(id);const current=String(snap?.status||'').trim().toLowerCase();const review=String(snap?.reviewStatus||'').toLowerCase();if(current==='inreview'||current==='done'){updates.push({taskId:id,status:current,skipped:true});continue;}runTask(['update',id,'--status','inreview']);updates.push({taskId:id,status:'inreview',fromStatus:current||null,reviewStatus:review||null});}catch(e){unresolved.push({taskId:id,status:'inreview',error:String(e?.message||e)});} } const actionableUnresolved=unresolved.filter((item)=>String(item?.taskId||'').trim()); console.log(JSON.stringify({updated:updates.length,updates,unresolved,actionableUnresolved,needsAgent:actionableUnresolved.length>0}));" - ], - "continueOnError": true, - "failOnError": false, - "env": { - "BOSUN_FETCH_PR_STATE": "{{$ctx.getNodeOutput('fetch-pr-state')?.output || '{}'}}" - } - }, - "position": { - "x": 400, - "y": 530 - }, - "outputs": [ - "default" - ] - }, - { - "id": "sync-agent-needed", - "type": "condition.expression", - "label": "Needs Agent Sync?", - "config": { - "expression": "(()=>{try{const raw=$ctx.getNodeOutput('sync-programmatic')?.output||'{}';const d=JSON.parse(raw);const actionable=Array.isArray(d?.unresolved)?d.unresolved.some((item)=>String(item?.taskId||'').trim()):false;return d?.needsAgent===true || actionable;}catch{return true;}})()" - }, - "position": { - "x": 400, - "y": 615 - }, - "outputs": [ - "default" - ] - }, - { - "id": "sync-agent", - "type": "action.run_agent", - "label": "Sync PR State → Kanban (Fallback)", - "config": { - "prompt": "You are the Bosun GitHub-Kanban sync fallback agent. A deterministic sync pass already ran.\n\nProgrammatic sync output:\n{{$ctx.getNodeOutput('sync-programmatic')?.output}}\n\nNow complete only unresolved updates.\n\nGitHub PR state:\nPR state (JSON from fetch-pr-state node output):\n{{$ctx.getNodeOutput('fetch-pr-state')?.output}}\n\nRULES:\n1. For each MERGED PR entry with a taskId: update the kanban task to done.\n Use the available bosun CLI, for example:\n node task/task-cli.mjs update --status done\n Or inspect available commands with a shell-native file listing.\n2. For each OPEN (non-draft) PR entry with a taskId: if the task is not\n already in inreview or done status, update it to inreview.\n3. Only act on entries that have a non-null taskId.\n4. Log each update and whether it succeeded.\n5. Do NOT close, merge, or modify any PR.\n6. Do NOT create new tasks — only update existing ones.", - "sdk": "auto", - "timeoutMs": 300000, - "continueOnError": true - }, - "position": { - "x": 400, - "y": 700 - }, - "outputs": [ - "default" - ] - }, - { - "id": "done", - "type": "notify.log", - "label": "Sync Complete", - "config": { - "message": "GitHub ↔ Kanban sync cycle complete", - "level": "info" - }, - "position": { - "x": 400, - "y": 700 - }, - "outputs": [ - "default" - ] - }, - { - "id": "skip", - "type": "notify.log", - "label": "No PR Updates", - "config": { - "message": "No bosun PR changes to sync this cycle", - "level": "debug" - }, - "position": { - "x": 650, - "y": 450 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->fetch-pr-state", - "source": "trigger", - "target": "fetch-pr-state", + "id": "set-inreview->handoff-pr-progressor", + "source": "set-inreview", + "target": "handoff-pr-progressor", "sourcePort": "default" }, { - "id": "fetch-pr-state->has-updates", - "source": "fetch-pr-state", - "target": "has-updates", + "id": "handoff-pr-progressor->log-success", + "source": "handoff-pr-progressor", + "target": "log-success", "sourcePort": "default" }, { - "id": "has-updates->sync-programmatic", - "source": "has-updates", - "target": "sync-programmatic", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "has-updates->skip", - "source": "has-updates", - "target": "skip", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "sync-programmatic->sync-agent-needed", - "source": "sync-programmatic", - "target": "sync-agent-needed", + "id": "log-success->join-outcomes", + "source": "log-success", + "target": "join-outcomes", "sourcePort": "default" }, { - "id": "sync-agent-needed->sync-agent", - "source": "sync-agent-needed", - "target": "sync-agent", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "sync-agent-needed->done", - "source": "sync-agent-needed", - "target": "done", - "sourcePort": "default", + "id": "push-ok->set-todo-push-failed", + "source": "push-ok", + "target": "set-todo-push-failed", + "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "sync-agent->done", - "source": "sync-agent", - "target": "done", - "sourcePort": "default" - } - ], - "metadata": { - "author": "bosun-demo", - "createdAt": "2026-03-03T12:00:00.000Z", - "updatedAt": "2026-03-03T12:00:00.000Z", - "templateState": { - "templateId": "template-github-kanban-sync", - "templateName": "GitHub ↔ Kanban Sync", - "templateVersion": "1.0.0", - "installedTemplateVersion": "1.0.0", - "isCustomized": false, - "updateAvailable": false - } - } - }, - { - "id": "wf-github-check-failure", - "name": "GitHub Check Failure Handler", - "description": "Event-driven workflow that fires the moment a GitHub check run fails. Identifies the associated PR and applies the bosun-needs-fix label instantly so the PR Watchdog can dispatch a repair agent on its next sweep. Eliminates the up-to-30-minute delay between a CI failure and Bosun's response.", - "category": "github", - "enabled": true, - "nodeCount": 5, - "trigger": "trigger.event", - "variables": { - "labelNeedsFix": "bosun-needs-fix", - "ignoredCheckNames": "codecov,dependabot,semantic-pr-title" - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.event", - "label": "Check Run Failed", - "config": { - "eventType": "github:check_run", - "filter": "$event?.action === 'completed' && $event?.checkConclusion === 'failure' && !String($event?.checkName || '').split(',').some(n => String($data?.ignoredCheckNames || '').toLowerCase().split(',').map(s => s.trim()).includes(n.trim().toLowerCase()))" - }, - "position": { - "x": 400, - "y": 50 - }, - "outputs": [ - "default" - ] - }, - { - "id": "check-has-pr", - "type": "condition.expression", - "label": "Associated PR Found?", - "config": { - "expression": "Number($data?.prNumber) > 0 && Boolean($data?.repo)" - }, - "position": { - "x": 400, - "y": 190 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "label-fix", - "type": "action.run_command", - "label": "Label PR: bosun-needs-fix", - "config": { - "command": "gh", - "args": [ - "pr", - "edit", - "{{prNumber}}", - "--add-label", - "{{labelNeedsFix}}", - "--repo", - "{{repo}}" - ], - "continueOnError": true - }, - "position": { - "x": 250, - "y": 340 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-labeled", - "type": "notify.log", - "label": "Log Fix Label Applied", - "config": { - "message": ":x: Check '{{checkName}}' failed on PR #{{prNumber}} ({{repo}}). Applied label '{{labelNeedsFix}}' — PR Watchdog will dispatch repair.", - "level": "warn" - }, - "position": { - "x": 250, - "y": 490 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-no-pr", - "type": "notify.log", - "label": "Log No Associated PR", - "config": { - "message": "Check '{{checkName}}' failed in {{repo}} (conclusion: {{checkConclusion}}) — no associated PR found.", - "level": "debug" - }, - "position": { - "x": 620, - "y": 340 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->check-has-pr", - "source": "trigger", - "target": "check-has-pr", + "id": "set-todo-push-failed->join-outcomes", + "source": "set-todo-push-failed", + "target": "join-outcomes", "sourcePort": "default" }, { - "id": "check-has-pr->label-fix", - "source": "check-has-pr", - "target": "label-fix", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "check-has-pr->log-no-pr", - "source": "check-has-pr", - "target": "log-no-pr", + "id": "has-commits->log-no-commits", + "source": "has-commits", + "target": "log-no-commits", "sourcePort": "no", "condition": "$output?.result !== true" }, - { - "id": "label-fix->log-labeled", - "source": "label-fix", - "target": "log-labeled", - "sourcePort": "default" - } - ], - "metadata": { - "author": "bosun-demo", - "createdAt": "2026-03-04T12:00:00.000Z", - "updatedAt": "2026-03-04T12:00:00.000Z", - "templateState": { - "templateId": "template-github-check-failure", - "templateName": "GitHub Check Failure Handler", - "templateVersion": "1.0.0", - "installedTemplateVersion": "1.0.0", - "isCustomized": false, - "updateAvailable": false - } - } - }, - { - "id": "wf-github-pr-event-handler", - "name": "GitHub PR Event Handler", - "description": "Event-driven workflow that fires as soon as a PR is opened, updated, or reopened via GitHub webhook. Identifies the linked Bosun task by branch name and immediately updates its status to in-review — no polling required. Complements the PR Watchdog which runs every 30 minutes as a fallback.", - "category": "github", - "enabled": true, - "nodeCount": 9, - "trigger": "trigger.event", - "variables": { - "labelInReview": "bosun/in-review", - "taskBranchPrefix": "task/" - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.event", - "label": "PR Opened / Updated", - "config": { - "eventType": "github:pull_request", - "filter": "['opened','synchronize','reopened'].includes(String($event?.action || '').toLowerCase())" - }, - "position": { - "x": 400, - "y": 50 - }, - "outputs": [ - "default" - ] - }, - { - "id": "check-bosun-branch", - "type": "condition.expression", - "label": "Is a Bosun Task Branch?", - "config": { - "expression": "Boolean($data?.prBranch) && String($data?.prBranch || '').startsWith(String($data?.taskBranchPrefix || 'task/'))" - }, - "position": { - "x": 400, - "y": 190 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "find-task", - "type": "action.run_command", - "label": "Find Linked Task", - "config": { - "command": "node", - "args": [ - "-e", - "\n const fs = require(\"node:fs\");\n const path = require(\"node:path\");\n const { pathToFileURL } = require(\"node:url\");\n let repoRoot = process.cwd();\n const mirrorMarker = (path.sep + \".bosun\" + path.sep + \"workspaces\" + path.sep).toLowerCase();\n if (repoRoot.toLowerCase().includes(mirrorMarker)) {\n const r = path.resolve(repoRoot, \"..\", \"..\", \"..\", \"..\");\n if (fs.existsSync(path.join(r, \"kanban\", \"kanban-adapter.mjs\"))) repoRoot = r;\n }\n const kanbanUrl = pathToFileURL(path.join(repoRoot, \"kanban\", \"kanban-adapter.mjs\")).href;\n const branch = process.env.PR_BRANCH || \"\";\n import(kanbanUrl)\n .then(k => k.listTasks(undefined, {}))\n .then(tasks => {\n const task = (tasks || []).find(t =>\n (t.branch || t.metadata?.branch) === branch\n );\n console.log(JSON.stringify(task || null));\n })\n .catch(e => { console.error(e.message); process.exit(1); });\n " - ], - "env": { - "PR_BRANCH": "{{prBranch}}" - }, - "parseJson": true - }, - "position": { - "x": 250, - "y": 340 - }, - "outputs": [ - "default" - ] - }, - { - "id": "check-task-found", - "type": "condition.expression", - "label": "Task Found?", - "config": { - "expression": "Boolean($ctx.getNodeOutput('find-task')?.output?.id)" - }, - "position": { - "x": 250, - "y": 490 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "update-inreview", - "type": "action.update_task_status", - "label": "Mark Task In Review", - "config": { - "taskId": "{{$ctx.getNodeOutput('find-task')?.output?.id || ''}}", - "status": "inreview", - "taskTitle": "{{$ctx.getNodeOutput('find-task')?.output?.title || prTitle || ''}}", - "workflowEvent": "task.in_review", - "workflowData": { - "source": "github:pr_opened", - "prNumber": "{{prNumber}}", - "prUrl": "{{prUrl}}", - "branch": "{{prBranch}}", - "repo": "{{repo}}" - } - }, - "position": { - "x": 250, - "y": 640 - }, - "outputs": [ - "default" - ] - }, - { - "id": "add-label-in-review", - "type": "action.run_command", - "label": "Add In-Review Label", - "config": { - "command": "node", - "args": [ - "-e", - "const {execFileSync}=require('child_process'); const n=String(process.env.PR_NUMBER||'').trim(); const repo=String(process.env.REPO||'').trim(); const label=String(process.env.LABEL_IN_REVIEW||'bosun/in-review').trim(); if(!n||!label){process.exit(0);} try{ const args=['pr','edit',n,'--add-label',label]; if(repo)args.push('--repo',repo); execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}); console.log(JSON.stringify({labeled:true,label,pr:n})); }catch(e){ process.stderr.write('label warn: '+String(e?.message||e)+'\\n'); console.log(JSON.stringify({labeled:false,label,pr:n,error:String(e?.message||e)})); }" - ], - "continueOnError": true, - "failOnError": false, - "env": { - "PR_NUMBER": "{{prNumber}}", - "REPO": "{{repo}}", - "LABEL_IN_REVIEW": "{{labelInReview}}" - } - }, - "position": { - "x": 250, - "y": 720 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-updated", - "type": "notify.log", - "label": "Log In Review", - "config": { - "message": ":rocket: Task {{$ctx.getNodeOutput('find-task')?.output?.id}} moved to in-review — PR #{{prNumber}} ({{prBranch}}) in {{repo}}", - "level": "info" - }, - "position": { - "x": 250, - "y": 790 - }, - "outputs": [ - "default" - ] + { + "id": "log-no-commits->set-todo-cooldown", + "source": "log-no-commits", + "target": "set-todo-cooldown", + "sourcePort": "default" }, { - "id": "log-no-task", - "type": "notify.log", - "label": "Log No Task Found", - "config": { - "message": "PR #{{prNumber}} opened on branch {{prBranch}} in {{repo}} — no linked Bosun task found.", - "level": "debug" - }, - "position": { - "x": 550, - "y": 490 - }, - "outputs": [ - "default" - ] + "id": "set-todo-cooldown->join-outcomes", + "source": "set-todo-cooldown", + "target": "join-outcomes", + "sourcePort": "default" }, { - "id": "log-not-bosun", - "type": "notify.log", - "label": "Log Non-Bosun Branch", - "config": { - "message": "PR #{{prNumber}} on {{prBranch}} is not a Bosun task branch — skipping.", - "level": "debug" - }, - "position": { - "x": 650, - "y": 340 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ + "id": "claim-stolen->create-pr-retry", + "source": "claim-stolen", + "target": "create-pr-retry", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, { - "id": "trigger->check-bosun-branch", - "source": "trigger", - "target": "check-bosun-branch", + "id": "create-pr-retry->pr-created-stolen", + "source": "create-pr-retry", + "target": "pr-created-stolen", "sourcePort": "default" }, { - "id": "check-bosun-branch->find-task", - "source": "check-bosun-branch", - "target": "find-task", + "id": "pr-created-stolen->set-inreview-stolen", + "source": "pr-created-stolen", + "target": "set-inreview-stolen", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "check-bosun-branch->log-not-bosun", - "source": "check-bosun-branch", - "target": "log-not-bosun", - "sourcePort": "no", - "condition": "$output?.result !== true" + "id": "set-inreview-stolen->handoff-pr-progressor-stolen", + "source": "set-inreview-stolen", + "target": "handoff-pr-progressor-stolen", + "sourcePort": "default" }, { - "id": "find-task->check-task-found", - "source": "find-task", - "target": "check-task-found", + "id": "handoff-pr-progressor-stolen->log-claim-stolen-recovered", + "source": "handoff-pr-progressor-stolen", + "target": "log-claim-stolen-recovered", "sourcePort": "default" }, { - "id": "check-task-found->update-inreview", - "source": "check-task-found", - "target": "update-inreview", - "sourcePort": "yes", - "condition": "$output?.result === true" + "id": "log-claim-stolen-recovered->join-outcomes", + "source": "log-claim-stolen-recovered", + "target": "join-outcomes", + "sourcePort": "default" }, { - "id": "check-task-found->log-no-task", - "source": "check-task-found", - "target": "log-no-task", + "id": "pr-created-stolen->log-claim-stolen", + "source": "pr-created-stolen", + "target": "log-claim-stolen", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "update-inreview->add-label-in-review", - "source": "update-inreview", - "target": "add-label-in-review", + "id": "log-claim-stolen->set-todo-stolen", + "source": "log-claim-stolen", + "target": "set-todo-stolen", "sourcePort": "default" }, { - "id": "add-label-in-review->log-updated", - "source": "add-label-in-review", - "target": "log-updated", + "id": "set-todo-stolen->join-outcomes", + "source": "set-todo-stolen", + "target": "join-outcomes", "sourcePort": "default" - } - ], - "metadata": { - "author": "bosun-demo", - "createdAt": "2026-03-05T12:00:00.000Z", - "updatedAt": "2026-03-05T12:00:00.000Z", - "templateState": { - "templateId": "template-github-pr-event-handler", - "templateName": "GitHub PR Event Handler", - "templateVersion": "1.0.0", - "installedTemplateVersion": "1.0.0", - "isCustomized": false, - "updateAvailable": false - } - } - }, - { - "id": "wf-pr-conflict-resolver", - "name": "PR Conflict Resolver", - "description": ":alert: SUPERSEDED for bosun-managed repos — use the Bosun PR Watchdog (template-bosun-pr-watchdog) instead. The Watchdog consolidates conflict resolution, CI-failure repair, diff-safety review, and merge into one cycle with a single gh API call and a mandatory review gate before any merge. This template is kept for repos that do not use the assistive bosun-attached label convention. It only touches Bosun-created PRs and never auto-merges directly — it resolves conflicts and then defers to the Watchdog's review gate for the actual merge decision.", - "category": "github", - "enabled": false, - "nodeCount": 11, - "trigger": "trigger.schedule", - "variables": { - "checkIntervalMs": 1800000, - "maxConcurrentFixes": 3, - "maxRetries": 3 - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.schedule", - "label": "Check Every 30min", - "config": { - "intervalMs": "{{checkIntervalMs}}", - "cron": "*/30 * * * *" - }, - "position": { - "x": 400, - "y": 50 - }, - "outputs": [ - "default" - ] }, { - "id": "list-prs", - "type": "action.run_command", - "label": "List Bosun-Created Conflicting PRs", - "config": { - "command": "gh pr list --state open --json number,title,body,headRefName,baseRefName,mergeable,labels --limit {{maxConcurrentFixes}}" - }, - "position": { - "x": 400, - "y": 180 - }, - "outputs": [ - "default" - ] + "id": "join-outcomes->release-worktree", + "source": "join-outcomes", + "target": "release-worktree", + "sourcePort": "default" }, { - "id": "target-pr", - "type": "action.set_variable", - "label": "Pick Conflict PR", - "config": { - "key": "targetPrNumber", - "value": "/* */ (() => { const raw = $ctx.getNodeOutput('list-prs')?.output || '[]'; let prs = []; try { prs = typeof raw === 'string' ? JSON.parse(raw) : raw; } catch { return ''; } if (!Array.isArray(prs)) return ''; const CONFLICT = new Set(['CONFLICTING', 'BEHIND', 'DIRTY']); const BOSUN_CREATED_LABEL = 'bosun-pr-bosun-created'; const readLabelNames = (pr) => Array.isArray(pr?.labels) ? pr.labels.map((entry) => typeof entry === 'string' ? entry : entry?.name).filter(Boolean) : []; const hasBosunCreatedText = (value) => { const text = String(value || ''); const taskIdMatch = text.match(/(?:Bosun-Task|VE-Task|Task-ID|task[_-]?id)[:\\s]+([a-zA-Z0-9_-]{4,64})/i); const hasLegacyTaskSignature = Boolean(taskIdMatch && text.toLowerCase().includes(`automated pr for task ${String(taskIdMatch[1] || '').trim().toLowerCase()}`)); return text.includes('') || /Bosun-Origin:\\s*created/i.test(text) || /auto-created by bosun/i.test(text) || hasLegacyTaskSignature; }; const isBosunCreated = (pr) => readLabelNames(pr).includes(BOSUN_CREATED_LABEL) || hasBosunCreatedText(pr?.body); /* Skip PRs already owned by the watchdog fix agent */ const pr = prs.find((p) => isBosunCreated(p) && CONFLICT.has(String(p?.mergeable || '').toUpperCase()) && !(p.labels || []).some((l) => l.name === 'bosun-needs-fix') ); return pr?.number ? String(pr.number) : '';})()", - "isExpression": true - }, - "position": { - "x": 400, - "y": 260 - }, - "outputs": [ - "default" - ] + "id": "release-worktree->release-claim", + "source": "release-worktree", + "target": "release-claim", + "sourcePort": "default" }, { - "id": "target-branch", - "type": "action.set_variable", - "label": "Capture Conflict Branch", - "config": { - "key": "targetPrBranch", - "value": "/* */ (() => { const raw = $ctx.getNodeOutput('list-prs')?.output || '[]'; let prs = []; try { prs = typeof raw === 'string' ? JSON.parse(raw) : raw; } catch { return ''; } if (!Array.isArray(prs)) return ''; const pr = prs.find((p) => String(p?.number || '') === String($data?.targetPrNumber || '')); return pr?.headRefName || '';})()", - "isExpression": true - }, - "position": { - "x": 400, - "y": 340 - }, - "outputs": [ - "default" - ] + "id": "release-claim->release-slot", + "source": "release-claim", + "target": "release-slot", + "sourcePort": "default" }, { - "id": "target-base", - "type": "action.set_variable", - "label": "Capture Base Branch", - "config": { - "key": "targetPrBase", - "value": "/* */ (() => { const raw = $ctx.getNodeOutput('list-prs')?.output || '[]'; let prs = []; try { prs = typeof raw === 'string' ? JSON.parse(raw) : raw; } catch { return 'main'; } if (!Array.isArray(prs)) return 'main'; const pr = prs.find((p) => String(p?.number || '') === String($data?.targetPrNumber || '')); return pr?.baseRefName || 'main';})()", - "isExpression": true - }, - "position": { - "x": 400, - "y": 420 - }, - "outputs": [ - "default" - ] + "id": "release-slot->sweep-task-wts", + "source": "release-slot", + "target": "sweep-task-wts", + "sourcePort": "default" }, { - "id": "has-conflicts", - "type": "condition.expression", - "label": "Any Conflicts?", - "config": { - "expression": "Boolean($data?.targetPrNumber)" - }, - "position": { - "x": 400, - "y": 510 - }, - "outputs": [ - "default" - ] + "id": "claim-ok->release-slot-claim-failed", + "source": "claim-ok", + "target": "release-slot-claim-failed", + "sourcePort": "no", + "condition": "$output?.result !== true" }, { - "id": "label-fixing", - "type": "action.run_command", - "label": "Label bosun-needs-fix", - "config": { - "command": "gh pr edit {{targetPrNumber}} --add-label bosun-needs-fix", - "continueOnError": true - }, - "position": { - "x": 200, - "y": 650 - }, - "outputs": [ - "default" - ] + "id": "release-slot-claim-failed->log-claim-failed", + "source": "release-slot-claim-failed", + "target": "log-claim-failed", + "sourcePort": "default" }, { - "id": "resolve-conflicts", - "type": "action.run_agent", - "label": "Resolve Conflicts", - "config": { - "prompt": "You are a merge conflict resolution agent for PR #{{targetPrNumber}} on branch {{targetPrBranch}} (base: {{targetPrBase}}).\n\nSteps:\n1. git fetch origin\n2. git checkout {{targetPrBranch}}\n3. git rebase origin/{{targetPrBase}} (fall back to merge if rebase is too complex)\n4. Resolve all merge conflicts, preserving the intent of both sides.\n5. Run the repo's build and test suite to confirm nothing is broken.\n6. git push --force-with-lease origin {{targetPrBranch}}\n7. Remove the bosun-needs-fix label: gh pr edit {{targetPrNumber}} --remove-label bosun-needs-fix\n\nRules:\n- Only make minimal conflict-resolution changes. No unrelated refactors.\n- Do NOT merge, close, or approve the PR — the Bosun PR Watchdog handles merging.\n- Do NOT touch PRs that are not Bosun-created.", - "sdk": "auto", - "timeoutMs": 1800000, - "failOnError": true, - "maxRetries": "{{maxRetries}}", - "retryDelayMs": 30000, - "continueOnError": true - }, - "position": { - "x": 200, - "y": 800 - }, - "outputs": [ - "default" - ] + "id": "worktree-ok->wt-retry-eligible", + "source": "worktree-ok", + "target": "wt-retry-eligible", + "sourcePort": "no", + "condition": "$output?.result !== true" }, { - "id": "notify-fixed", - "type": "notify.telegram", - "label": "Notify Resolved", - "config": { - "message": ":settings: PR #{{targetPrNumber}} conflict resolved — awaiting CI and Watchdog review before merge", - "silent": true - }, - "position": { - "x": 200, - "y": 960 - }, - "outputs": [ - "default" - ] + "id": "wt-retry-eligible->recover-worktree", + "source": "wt-retry-eligible", + "target": "recover-worktree", + "sourcePort": "yes", + "condition": "$output?.result === true" }, { - "id": "notify-failed", - "type": "notify.log", - "label": "Log Resolution Failed", - "config": { - "message": "PR #{{targetPrNumber}} conflict could not be resolved cleanly — manual review required", - "level": "warn" - }, - "position": { - "x": 450, - "y": 800 - }, - "outputs": [ - "default" - ] + "id": "recover-worktree->retry-acquire-wt", + "source": "recover-worktree", + "target": "retry-acquire-wt", + "sourcePort": "default" }, { - "id": "skip", - "type": "notify.log", - "label": "No Conflicts", - "config": { - "message": "PR Conflict Resolver: no unhandled Bosun-created conflicts found", - "level": "info" - }, - "position": { - "x": 620, - "y": 510 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->list-prs", - "source": "trigger", - "target": "list-prs", + "id": "retry-acquire-wt->retry-wt-ok", + "source": "retry-acquire-wt", + "target": "retry-wt-ok", "sourcePort": "default" }, { - "id": "list-prs->target-pr", - "source": "list-prs", - "target": "target-pr", - "sourcePort": "default" + "id": "retry-wt-ok->resolve-executor", + "source": "retry-wt-ok", + "target": "resolve-executor", + "sourcePort": "yes", + "condition": "$output?.result === true" }, { - "id": "target-pr->target-branch", - "source": "target-pr", - "target": "target-branch", - "sourcePort": "default" + "id": "retry-wt-ok->release-claim-wt-failed", + "source": "retry-wt-ok", + "target": "release-claim-wt-failed", + "sourcePort": "no", + "condition": "$output?.result !== true" }, { - "id": "target-branch->target-base", - "source": "target-branch", - "target": "target-base", - "sourcePort": "default" + "id": "wt-retry-eligible->release-claim-wt-failed", + "source": "wt-retry-eligible", + "target": "release-claim-wt-failed", + "sourcePort": "no", + "condition": "$output?.result !== true" }, { - "id": "target-base->has-conflicts", - "source": "target-base", - "target": "has-conflicts", + "id": "release-claim-wt-failed->wt-failure-blocking", + "source": "release-claim-wt-failed", + "target": "wt-failure-blocking", "sourcePort": "default" }, { - "id": "has-conflicts->label-fixing", - "source": "has-conflicts", - "target": "label-fixing", - "sourcePort": "default", + "id": "wt-failure-blocking->set-blocked-wt-failed", + "source": "wt-failure-blocking", + "target": "set-blocked-wt-failed", + "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "has-conflicts->skip", - "source": "has-conflicts", - "target": "skip", - "sourcePort": "default", + "id": "wt-failure-blocking->set-todo-wt-failed", + "source": "wt-failure-blocking", + "target": "set-todo-wt-failed", + "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "label-fixing->resolve-conflicts", - "source": "label-fixing", - "target": "resolve-conflicts", + "id": "set-blocked-wt-failed->annotate-blocked-wt-failed", + "source": "set-blocked-wt-failed", + "target": "annotate-blocked-wt-failed", "sourcePort": "default" }, { - "id": "resolve-conflicts->notify-fixed", - "source": "resolve-conflicts", - "target": "notify-fixed", - "sourcePort": "default", - "condition": "$ctx.getNodeOutput('resolve-conflicts')?.success === true" + "id": "annotate-blocked-wt-failed->release-slot-wt-failed", + "source": "annotate-blocked-wt-failed", + "target": "release-slot-wt-failed", + "sourcePort": "default" }, { - "id": "resolve-conflicts->notify-failed", - "source": "resolve-conflicts", - "target": "notify-failed", - "sourcePort": "default", - "condition": "$ctx.getNodeOutput('resolve-conflicts')?.success !== true" - } - ], - "metadata": { - "author": "bosun-demo", - "createdAt": "2026-03-06T12:00:00.000Z", - "updatedAt": "2026-03-06T12:00:00.000Z", - "templateState": { - "templateId": "template-pr-conflict-resolver", - "templateName": "PR Conflict Resolver", - "templateVersion": "2.0.0", - "installedTemplateVersion": "2.0.0", - "isCustomized": false, - "updateAvailable": false + "id": "set-todo-wt-failed->release-slot-wt-failed", + "source": "set-todo-wt-failed", + "target": "release-slot-wt-failed", + "sourcePort": "default" + }, + { + "id": "release-slot-wt-failed->notify-wt-failed", + "source": "release-slot-wt-failed", + "target": "notify-wt-failed", + "sourcePort": "default" } - } + ] }, { - "id": "wf-pr-fix-single", - "name": "PR Fix Agent (Single PR)", - "description": "Fixes one Bosun-attached PR using a dedicated long-running agent (up to 2 hours). Dispatched by the PR Watchdog loop for each unclaimed PR needing repair. Programmatically clones the target repo and checks out the PR's HEAD branch into a temp worktree, runs the agent there, then pushes fixes back with --force-with-lease and cleans up. The agent NEVER manages git setup or push.", - "category": "github", + "id": "template-webhook-task-router", + "name": "Webhook Task Router", + "description": "Routes inbound webhook events to tasks, exercising webhook trigger, tag checks, file-exists conditions, template transforms, task creation, and webhook acknowledgements.", + "category": "coverage", + "categoryLabel": "Coverage", + "categoryIcon": ":settings:", + "categoryOrder": 99, + "tags": [ + "coverage", + "webhook", + "routing" + ], + "nodeCount": 7, + "edgeCount": 7, + "recommended": false, "enabled": true, - "nodeCount": 11, - "trigger": "trigger.manual", - "variables": {}, + "trigger": "trigger.webhook", + "variables": { + "taskTags": [ + "priority" + ], + "webhookEventType": "task.created", + "requiredTag": "priority", + "configFile": "/nonexistent/config.json", + "webhookCallbackUrl": "http://localhost:65000/webhook/ack" + }, + "metadata": { + "author": "virtengine", + "tags": [ + "coverage", + "webhook", + "routing" + ] + }, "nodes": [ { "id": "trigger", - "type": "trigger.manual", - "label": "Start", - "config": {}, - "position": { - "x": 100, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "setup-task", - "type": "action.set_variable", - "label": "Setup PR Task ID", - "config": { - "key": "taskId", - "value": "'pr-fix-' + String($data?.item?.taskId || (String($data?.item?.repo || '').replace(/[^a-z0-9]/gi, '-').replace(/-+/g,'-').replace(/^-|-$/g,'') + '-' + String($data?.item?.number || $data?.item?.n || '0'))).replace(/^-|-$/g, '')", - "isExpression": true - }, - "position": { - "x": 380, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "setup-title", - "type": "action.set_variable", - "label": "Setup PR Task Title", - "config": { - "key": "taskTitle", - "value": "'Fix PR #' + String($data?.item?.number || $data?.item?.n || '?') + ($data?.item?.title ? ' \\'' + String($data.item.title).slice(0,60) + '\\'' : '') + ' (' + String($data?.item?.repo || '') + ')'", - "isExpression": true - }, - "position": { - "x": 660, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "setup-claim-key", - "type": "action.set_variable", - "label": "Setup Claim Key", - "config": { - "key": "claimKey", - "value": "String($data?.item?.claimKey || '')", - "isExpression": true - }, - "position": { - "x": 940, - "y": 100 - }, - "outputs": [ - "default" - ] - }, - { - "id": "setup-worktree", - "type": "action.run_command", - "label": "Clone & Checkout PR Branch", + "type": "trigger.webhook", + "label": "Webhook Trigger", "config": { - "command": "node", - "args": [ - "-e", - "const os=require('os'); const path=require('path'); const fs=require('fs'); const {execFileSync}=require('child_process'); const repo=String(process.env.PR_REPO||'').trim(); const branch=String(process.env.PR_BRANCH||'').trim(); const base=String(process.env.PR_BASE||'main').trim(); const num=String(process.env.PR_NUMBER||'0').trim(); if(!repo||!branch){console.log(JSON.stringify({error:'missing repo or branch',repo,branch}));process.exit(1);} const wt=path.join(os.tmpdir(),'bosun-prfix-'+num.replace(/[^0-9a-z]/gi,'-')); let reused=false; if(fs.existsSync(path.join(wt,'.git'))){ try{ const cur=execFileSync('git',['rev-parse','--abbrev-ref','HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(cur===branch){ execFileSync('git',['fetch','origin',branch],{cwd:wt,encoding:'utf8',timeout:120000,stdio:['ignore','pipe','pipe']}); execFileSync('git',['reset','--hard','origin/'+branch],{cwd:wt,encoding:'utf8',timeout:30000}); execFileSync('git',['clean','-fdx'],{cwd:wt,encoding:'utf8',timeout:30000}); try{execFileSync('git',['fetch','origin',base],{cwd:wt,encoding:'utf8',timeout:60000,stdio:['ignore','pipe','pipe']});}catch{} reused=true; }else{fs.rmSync(wt,{recursive:true,force:true});} }catch{try{fs.rmSync(wt,{recursive:true,force:true});}catch{}} } if(!reused){ if(fs.existsSync(wt)){try{fs.rmSync(wt,{recursive:true,force:true});}catch{}} execFileSync('gh',['repo','clone',repo,wt,'--','--branch',branch],{encoding:'utf8',timeout:300000,stdio:'inherit'}); execFileSync('git',['fetch','origin',branch],{cwd:wt,encoding:'utf8',timeout:120000,stdio:['ignore','pipe','pipe']}); execFileSync('git',['reset','--hard','origin/'+branch],{cwd:wt,encoding:'utf8',timeout:30000}); try{execFileSync('git',['fetch','origin',base],{cwd:wt,encoding:'utf8',timeout:60000,stdio:['ignore','pipe','pipe']});}catch{} } const finalBranch=execFileSync('git',['rev-parse','--abbrev-ref','HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(finalBranch!==branch){console.error('Branch mismatch: expected '+branch+' got '+finalBranch);process.exit(1);} console.log(JSON.stringify({worktreePath:wt,branch:finalBranch,base,repo,number:num,reused}));" - ], - "parseJson": true, - "failOnError": true, - "timeoutMs": 600000, - "env": { - "PR_REPO": "(()=>{ const i=$data?.item||{}; return String(i.repo||i.prDigest?.core?.repo||''); })()", - "PR_BRANCH": "(()=>{ const i=$data?.item||{}; return String(i.branch||i.prDigest?.core?.branch||''); })()", - "PR_BASE": "(()=>{ const i=$data?.item||{}; return String(i.base||i.baseBranch||i.prDigest?.core?.baseBranch||'main'); })()", - "PR_NUMBER": "(()=>{ const i=$data?.item||{}; return String(i.number||i.n||'0'); })()" - } + "eventType": "{{webhookEventType}}" }, "position": { - "x": 1220, + "x": 100, "y": 100 }, "outputs": [ @@ -26938,15 +20288,14 @@ ] }, { - "id": "set-worktree-path", - "type": "action.set_variable", - "label": "Set Agent Working Directory", + "id": "render-msg", + "type": "transform.template", + "label": "Render Message", "config": { - "key": "worktreePath", - "value": "{{setup-worktree.output.worktreePath}}" + "template": "Task created: {{webhook.payload.title || 'unknown'}}" }, "position": { - "x": 1500, + "x": 380, "y": 100 }, "outputs": [ @@ -26954,40 +20303,31 @@ ] }, { - "id": "setup-prompt", - "type": "action.set_variable", - "label": "Build Agent Prompt", + "id": "check-tag", + "type": "condition.task_has_tag", + "label": "Has Priority Tag?", "config": { - "key": "agentPrompt", - "value": "(()=>{\n const item = $data?.item || {};\n const prDigest = item.prDigest || {};\n const core = prDigest.core || {};\n const repo = String(item.repo || core.repo || '');\n const branch = String(item.branch || core.branch || '');\n const base = String(item.base || item.baseBranch || core.baseBranch || 'main');\n const number = String(item.number || item.n || '');\n const title = String(item.title || core.title || '');\n const reason = String(item.reason || '');\n const url = String(item.url || core.url || '');\n const mergeable = String(item.mergeable || core.mergeable || '');\n const failedChecks = Array.isArray(item.failedCheckNames) ? item.failedCheckNames : [];\n const failedJobs = Array.isArray(item.failedJobs) ? item.failedJobs : [];\n const annotations = Array.isArray(item.failedAnnotations) ? item.failedAnnotations : [];\n const logExcerpt = String(item.failedLogExcerpt || '').trim();\n const recentRuns = Array.isArray(item.recentRuns) ? item.recentRuns : [];\n const ciSummary = prDigest.ciSummary || {};\n const prBody = String(core.body || '').trim();\n const files = Array.isArray(prDigest.files) ? prDigest.files : [];\n const reviews = Array.isArray(prDigest.reviews) ? prDigest.reviews : [];\n const reviewComments = Array.isArray(prDigest.reviewComments) ? prDigest.reviewComments : [];\n const issueComments = Array.isArray(prDigest.issueComments) ? prDigest.issueComments : [];\n const allChecks = Array.isArray(prDigest.checks) ? prDigest.checks : [];\n let p = 'You are a Bosun PR repair agent. Your ONLY job is to fix this single PR.\\n\\n';\n p += '## PR Identity\\n\\n';\n p += '- **Repo**: ' + repo + '\\n';\n p += '- **PR Number**: #' + number + '\\n';\n p += '- **Title**: ' + title + '\\n';\n p += '- **URL**: ' + url + '\\n';\n p += '- **Head Branch**: `' + branch + '`\\n';\n p += '- **Base Branch**: `' + base + '`\\n';\n p += '- **Fix Reason**: `' + reason + '`\\n';\n if (mergeable) p += '- **Merge State**: ' + mergeable + '\\n';\n if (item.error) p += '- **Error**: ' + item.error + '\\n';\n if (item.rerunAttempts) p += '- **Rerun Attempts**: ' + item.rerunAttempts + '\\n';\n p += '\\n';\n if (failedChecks.length > 0) {\n p += '## Failed CI Checks\\n\\n';\n failedChecks.forEach(n => { p += '- `' + n + '`\\n'; });\n p += '\\n';\n }\n if (ciSummary.total > 0 || ciSummary.failing > 0) {\n p += '## CI Check Summary\\n\\n';\n p += 'Total: ' + (ciSummary.total||0) + ' | Failing: ' + (ciSummary.failing||0) + ' | Pending: ' + (ciSummary.pending||0) + ' | Passing: ' + (ciSummary.passing||0) + '\\n\\n';\n const failingAllChecks = allChecks.filter(c => ['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE'].includes(c.state));\n if (failingAllChecks.length > 0) {\n p += 'Failing checks:\\n';\n failingAllChecks.forEach(c => { p += '- `' + (c.name||c.workflow||'') + '` → ' + c.state + '\\n'; });\n p += '\\n';\n }\n }\n if (item.failedRun) {\n const run = item.failedRun;\n p += '## Failed Workflow Run\\n\\n';\n p += '- **Workflow**: ' + (run.workflowName || run.displayTitle || '') + '\\n';\n p += '- **Run ID**: ' + run.databaseId + '\\n';\n p += '- **Attempt**: ' + run.attempt + '\\n';\n p += '- **Conclusion**: ' + run.conclusion + '\\n';\n p += '- **URL**: ' + run.url + '\\n';\n p += '\\n';\n }\n if (failedJobs.length > 0) {\n p += '## Failed Jobs\\n\\n';\n failedJobs.slice(0,8).forEach(job => {\n p += '### ' + (job.name||'unknown') + '\\n';\n p += '- Conclusion: ' + job.conclusion + '\\n';\n if (job.url) p += '- URL: ' + job.url + '\\n';\n if (Array.isArray(job.failedSteps) && job.failedSteps.length > 0) {\n p += '- Failed steps: ' + job.failedSteps.map(s => '`' + s.name + '`').join(', ') + '\\n';\n }\n p += '\\n';\n });\n }\n if (annotations.length > 0) {\n p += '## Code Annotations (Errors / Warnings)\\n\\n';\n annotations.slice(0,6).forEach(annot => {\n if (Array.isArray(annot.annotations) && annot.annotations.length > 0) {\n p += '**Job: ' + (annot.name||'') + '**\\n';\n annot.annotations.slice(0,15).forEach(a => {\n p += '- `' + (a.path||'') + ':' + (a.startLine||'') + '` **' + (a.title||a.level||'error') + '**: ' + (a.message||'') + '\\n';\n });\n p += '\\n';\n }\n });\n }\n if (logExcerpt) {\n p += '## CI Log Excerpt (Failed Steps)\\n\\n```\\n' + logExcerpt.slice(0,10000) + '\\n```\\n\\n';\n }\n if (recentRuns.length > 0) {\n p += '## Recent CI Runs\\n\\n';\n recentRuns.forEach(r => { p += '- ' + (r.workflowName||r.displayTitle||'') + ' (' + r.conclusion + ') ' + (r.url||'') + '\\n'; });\n p += '\\n';\n }\n if (mergeable === 'CONFLICTING' || mergeable === 'DIRTY') {\n p += '## Merge Conflict\\n\\nThis PR has merge conflicts with base branch `' + base + '`. ';\n p += 'You must rebase or merge `origin/' + base + '` into `' + branch + '` and resolve all conflicts.\\n\\n';\n }\n if (prBody) {\n p += '## PR Description\\n\\n' + prBody.slice(0,2000) + '\\n\\n';\n }\n if (files.length > 0) {\n p += '## Changed Files (' + files.length + ')\\n\\n';\n files.slice(0,40).forEach(f => { p += '- `' + f.path + '` (+' + (f.additions||0) + '/-' + (f.deletions||0) + ')\\n'; });\n p += '\\n';\n }\n const reviewsWithBody = reviews.filter(r => r.body && r.body.trim());\n if (reviewsWithBody.length > 0 || reviewComments.length > 0) {\n p += '## Reviews & Inline Comments\\n\\n';\n reviewsWithBody.slice(0,5).forEach(r => {\n p += '**' + (r.author?.login||'reviewer') + '** (' + r.state + '): ' + r.body.slice(0,400) + '\\n\\n';\n });\n if (reviewComments.length > 0) {\n p += 'Inline comments:\\n';\n reviewComments.slice(0,12).forEach(c => {\n p += '- `' + (c.path||'') + ':' + (c.line||'') + '` (' + (c.author?.login||'') + '): ' + (c.body||'').slice(0,250) + '\\n';\n });\n p += '\\n';\n }\n }\n const issueCommentsWithBody = issueComments.filter(c => c.body && c.body.trim());\n if (issueCommentsWithBody.length > 0) {\n p += '## Issue Comments\\n\\n';\n issueCommentsWithBody.slice(0,5).forEach(c => {\n p += '**' + (c.author?.login||'user') + '**: ' + c.body.slice(0,300) + '\\n\\n';\n });\n }\n return p;\n})()", - "isExpression": true + "tag": "{{requiredTag}}", + "field": "tags" }, "position": { - "x": 1780, + "x": 660, "y": 100 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "fix-agent", - "type": "action.run_agent", - "label": "Fix PR (Dedicated Agent)", + "id": "check-config", + "type": "condition.file_exists", + "label": "Config Exists?", "config": { - "prompt": "{{agentPrompt}}\n\n## Workspace\n\nYour working directory is already a git clone of the target repo, checked out on the PR's HEAD branch (`{{setup-worktree.output.branch}}`). The base branch (`origin/{{setup-worktree.output.base}}`) has been fetched and is available for merge/rebase operations.\n\n## CRITICAL RULES — READ BEFORE DOING ANYTHING\n\n1. **Do NOT clone or re-clone the repo** — you are already in it.\n2. **Do NOT create new branches.** Stay on the current branch.\n3. **Do NOT push.** The workflow pushes for you automatically after you finish.\n4. **Do NOT switch branches** with `git checkout` or `git switch`.\n5. **Do NOT run `cd` to change to a different directory.** Stay in the cwd.\n6. Fix ONLY the specific issue listed in the Fix Reason above.\n7. Do NOT merge, approve, or close the PR.\n8. Do NOT touch any other PRs or repos.\n\n## Fix Instructions\n\nUse the PR digest (CI diagnostics, log excerpts, annotations, reviews) above to identify the root cause and apply the MINIMAL fix.\n\n**By `reason` field:**\n- `merge_conflict_requires_code_resolution`: Run `git merge origin/{{setup-worktree.output.base}}`, resolve *all* conflicts in code, run available tests, then `git commit`.\n- `auto_rerun_limit_reached` / `ci_rerun_failed`: Study the failed log excerpt and job details to find the root cause. Fix the code, run tests, `git add` and `git commit`.\n- `no_rerunnable_failed_run_found`: Look at `gh pr checks` for this PR, inspect the failure, fix the issue, and commit.\n- `branch_update_failed` / `missing_repo_or_branch`: Inspect with `gh pr view`, diagnose, fix.\n\n**After fixing:** Commit with a clear message like `fix: resolve CI failure in `.\nThen remove the fix label:\n```\ngh pr edit {{setup-worktree.output.number}} --repo {{setup-worktree.output.repo}} --remove-label bosun-needs-fix\n```\n", - "sdk": "auto", - "timeoutMs": 7200000, - "maxRetries": 1, - "retryDelayMs": 60000, - "sessionRetries": 2, - "maxContinues": 3, - "continueOnSession": true, - "continueOnError": true, - "failOnError": false + "path": "{{configFile}}" }, "position": { - "x": 2060, + "x": 940, "y": 100 }, "outputs": [ @@ -26995,27 +20335,15 @@ ] }, { - "id": "push-fixes", - "type": "action.run_command", - "label": "Push Fixes to PR Branch", + "id": "log-skip", + "type": "notify.log", + "label": "Log Skipped", "config": { - "command": "node", - "args": [ - "-e", - "const {execFileSync}=require('child_process'); const wt=String(process.env.WORKTREE_PATH||'').trim(); const branch=String(process.env.PR_BRANCH||'').trim(); const num=String(process.env.PR_NUMBER||'').trim(); if(!wt||!branch){console.log(JSON.stringify({pushed:false,reason:'missing_worktree_or_branch'}));process.exit(0);} const cur=execFileSync('git',['rev-parse','--abbrev-ref','HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(cur!==branch){console.log(JSON.stringify({pushed:false,reason:'wrong_branch',expected:branch,actual:cur}));process.exit(1);} const status=execFileSync('git',['status','--porcelain'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(status){ execFileSync('git',['add','-A'],{cwd:wt,encoding:'utf8',timeout:30000}); try{execFileSync('git',['commit','-m','bosun: commit remaining changes for PR #'+num],{cwd:wt,encoding:'utf8',timeout:30000});}catch{} } let hasDiff=false; try{const d=execFileSync('git',['rev-list','--count','origin/'+branch+'..HEAD'],{cwd:wt,encoding:'utf8',timeout:30000}).trim();hasDiff=Number(d)>0;} catch{hasDiff=true;} if(!hasDiff){console.log(JSON.stringify({pushed:false,reason:'no_new_commits'}));process.exit(0);} execFileSync('git',['push','--force-with-lease','origin','HEAD:'+branch],{cwd:wt,encoding:'utf8',timeout:120000,stdio:'inherit'}); console.log(JSON.stringify({pushed:true,branch:cur,commits:Number(execFileSync('git',['rev-list','--count','origin/'+branch+'..HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim()||0)}));" - ], - "parseJson": true, - "continueOnError": true, - "failOnError": false, - "timeoutMs": 300000, - "env": { - "WORKTREE_PATH": "{{setup-worktree.output.worktreePath}}", - "PR_BRANCH": "{{setup-worktree.output.branch}}", - "PR_NUMBER": "{{setup-worktree.output.number}}" - } + "message": "Skipped — no priority tag", + "level": "info" }, "position": { - "x": 2340, + "x": 1220, "y": 100 }, "outputs": [ @@ -27023,23 +20351,15 @@ ] }, { - "id": "cleanup-worktree", - "type": "action.run_command", - "label": "Cleanup Temp Worktree", + "id": "create-task", + "type": "action.create_task", + "label": "Create Task", "config": { - "command": "node", - "args": [ - "-e", - "const fs=require('fs'); const wt=String(process.env.WORKTREE_PATH||'').trim(); if(!wt){console.log(JSON.stringify({cleaned:false,reason:'no_path'}));process.exit(0);} try{fs.rmSync(wt,{recursive:true,force:true});console.log(JSON.stringify({cleaned:true,path:wt}));} catch(e){console.log(JSON.stringify({cleaned:false,error:String(e?.message||e)}));}" - ], - "continueOnError": true, - "failOnError": false, - "env": { - "WORKTREE_PATH": "{{setup-worktree.output.worktreePath}}" - } + "title": "Webhook task: {{webhookEventType}}", + "tags": "{{taskTags}}" }, "position": { - "x": 2620, + "x": 1500, "y": 100 }, "outputs": [ @@ -27047,23 +20367,17 @@ ] }, { - "id": "release-claim", - "type": "action.run_command", - "label": "Release PR Claim", + "id": "notify-out", + "type": "notify.webhook_out", + "label": "Acknowledge Webhook", "config": { - "command": "node", - "args": [ - "-e", - "const fs=require('fs'); const path=require('path'); const claimKey=String(process.env.PR_CLAIM_KEY||'').trim(); if(!claimKey){console.log(JSON.stringify({released:false,reason:'no_claim_key'}));process.exit(0);} const CLAIM_FILE=path.join(process.cwd(),'.cache','bosun','pr-fix-claims.json'); try{ if(!fs.existsSync(CLAIM_FILE)){console.log(JSON.stringify({released:false,reason:'no_claim_file'}));process.exit(0);} const data=JSON.parse(fs.readFileSync(CLAIM_FILE,'utf8')); if(data.claims&&data.claims[claimKey]){ delete data.claims[claimKey]; data.updatedAt=new Date().toISOString(); fs.writeFileSync(CLAIM_FILE,JSON.stringify(data,null,2),'utf8'); console.log(JSON.stringify({released:true,claimKey})); }else{ console.log(JSON.stringify({released:false,reason:'not_found',claimKey})); } }catch(e){ console.log(JSON.stringify({released:false,reason:'error',error:String(e?.message||e),claimKey})); }" - ], - "continueOnError": true, - "failOnError": false, - "env": { - "PR_CLAIM_KEY": "{{claimKey}}" + "url": "{{webhookCallbackUrl}}", + "payload": { + "status": "processed" } }, "position": { - "x": 2900, + "x": 1780, "y": 100 }, "outputs": [ @@ -27073,444 +20387,489 @@ ], "edges": [ { - "id": "trigger->setup-task", + "id": "trigger->render-msg", "source": "trigger", - "target": "setup-task", - "sourcePort": "default" - }, - { - "id": "setup-task->setup-title", - "source": "setup-task", - "target": "setup-title", - "sourcePort": "default" - }, - { - "id": "setup-title->setup-claim-key", - "source": "setup-title", - "target": "setup-claim-key", - "sourcePort": "default" - }, - { - "id": "setup-claim-key->setup-worktree", - "source": "setup-claim-key", - "target": "setup-worktree", + "target": "render-msg", "sourcePort": "default" }, { - "id": "setup-worktree->set-worktree-path", - "source": "setup-worktree", - "target": "set-worktree-path", + "id": "render-msg->check-tag", + "source": "render-msg", + "target": "check-tag", "sourcePort": "default" }, { - "id": "set-worktree-path->setup-prompt", - "source": "set-worktree-path", - "target": "setup-prompt", - "sourcePort": "default" + "id": "check-tag->check-config", + "source": "check-tag", + "target": "check-config", + "sourcePort": "yes" }, { - "id": "setup-prompt->fix-agent", - "source": "setup-prompt", - "target": "fix-agent", - "sourcePort": "default" + "id": "check-tag->log-skip", + "source": "check-tag", + "target": "log-skip", + "sourcePort": "no" }, { - "id": "fix-agent->push-fixes", - "source": "fix-agent", - "target": "push-fixes", + "id": "check-config->create-task", + "source": "check-config", + "target": "create-task", "sourcePort": "default" }, { - "id": "push-fixes->cleanup-worktree", - "source": "push-fixes", - "target": "cleanup-worktree", + "id": "log-skip->create-task", + "source": "log-skip", + "target": "create-task", "sourcePort": "default" }, { - "id": "cleanup-worktree->release-claim", - "source": "cleanup-worktree", - "target": "release-claim", + "id": "create-task->notify-out", + "source": "create-task", + "target": "notify-out", "sourcePort": "default" } - ], - "metadata": { - "author": "bosun-demo", - "createdAt": "2026-03-07T12:00:00.000Z", - "updatedAt": "2026-03-07T12:00:00.000Z", - "templateState": { - "templateId": "template-pr-fix-single", - "templateName": "PR Fix Agent (Single PR)", - "templateVersion": "2.0.0", - "installedTemplateVersion": "2.0.0", - "isCustomized": false, - "updateAvailable": false - } - } + ] }, { - "id": "wf-pr-merge-strategy", - "name": "PR Merge Strategy", - "description": "Automated PR merge decision workflow with resilient retry paths. Analyzes CI + agent output, executes merge/prompt/close/re-attempt actions, and escalates gracefully when any branch action fails.", - "category": "github", + "id": "template-workflow-composition", + "name": "Workflow Composition", + "description": "Compose workflows from smaller sub-workflows using action.invoke_workflow. Demonstrates workflow-to-workflow data piping: the parent workflow invokes a child workflow, extracts specific output fields, and forwards them to downstream nodes. Supports both sync and dispatch modes.", + "category": "mcp-integration", + "categoryLabel": "Mcp Integration", + "categoryIcon": ":settings:", + "categoryOrder": 99, + "tags": [ + "workflow", + "composition", + "sub-workflow", + "piping", + "orchestration" + ], + "nodeCount": 6, + "edgeCount": 5, + "recommended": false, "enabled": true, - "nodeCount": 20, - "trigger": "trigger.pr_event", + "trigger": "trigger.manual", "variables": { - "ciTimeoutMs": 300000, - "cooldownSec": 60, - "maxRetries": 3, - "baseBranch": "main", - "requireBosunCreatedPr": true + "childWorkflowId": "template-health-check", + "inputPayload": "{}" + }, + "metadata": { + "author": "virtengine", + "tags": [ + "workflow", + "composition", + "sub-workflow", + "piping", + "orchestration" + ] }, "nodes": [ { "id": "trigger", - "type": "trigger.pr_event", - "label": "PR Ready for Merge Decision", - "config": { - "event": "review_requested", - "events": [ - "review_requested", - "approved", - "opened" - ] - }, + "type": "trigger.manual", + "label": "Start", + "config": {}, "position": { - "x": 400, - "y": 50 + "x": 100, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "load-pr-context", - "type": "action.run_command", - "label": "Load PR Context", + "id": "list-workflows", + "type": "action.bosun_function", + "label": "List Workflows", "config": { - "command": "gh pr view {{prNumber}} --json body,author,title,labels" + "function": "workflows.list", + "outputVariable": "allWorkflows" }, "position": { - "x": 400, - "y": 140 + "x": 380, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "automation-eligible", - "type": "condition.expression", - "label": "Bosun-Created PR?", + "id": "invoke-child", + "type": "action.invoke_workflow", + "label": "Invoke Sub-Workflow", "config": { - "expression": "/* auto-created by bosun */ (() => { if ($data?.requireBosunCreatedPr !== true && String($data?.requireBosunCreatedPr || '').toLowerCase() !== 'true') return true; const raw = $ctx.getNodeOutput('load-pr-context')?.output || '{}'; let pr = {}; try { pr = typeof raw === 'string' ? JSON.parse(raw) : raw; } catch { return false; } const labels = Array.isArray(pr?.labels) ? pr.labels.map((entry) => typeof entry === 'string' ? entry : entry?.name).filter(Boolean) : []; const body = String(pr?.body || ''); return labels.includes('bosun-pr-bosun-created') || body.includes('') || /auto-created by bosun/i.test(body); })()" + "workflowId": "{{childWorkflowId}}", + "input": "{{inputPayload}}", + "mode": "sync", + "timeout": 120000, + "failOnError": false, + "outputVariable": "childResult" }, "position": { - "x": 400, - "y": 230 + "x": 660, + "y": 100 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "check-ci", - "type": "validation.build", - "label": "Check CI Status", + "id": "check-success", + "type": "condition.expression", + "label": "Success?", "config": { - "command": "gh pr checks {{prNumber}} --json name,state" + "expression": "{{invoke-child.success}}" }, "position": { - "x": 150, - "y": 320 + "x": 940, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "get-diff", - "type": "action.run_command", - "label": "Get Diff Stats", + "id": "process-output", + "type": "notify.log", + "label": "Process Output", "config": { - "command": "git diff --stat {{baseBranch}}...HEAD" + "message": "Sub-workflow '{{childWorkflowId}}' succeeded. Run ID: {{invoke-child.runId}}", + "level": "info" }, "position": { - "x": 650, - "y": 320 + "x": 1220, + "y": 100 }, "outputs": [ "default" ] }, { - "id": "ci-passed", - "type": "condition.expression", - "label": "CI Passed?", + "id": "handle-failure", + "type": "notify.log", + "label": "Handle Failure", "config": { - "expression": "(() => { const out = $ctx.getNodeOutput('check-ci'); if (!out || out.passed !== true) return false; let checks = []; try { checks = JSON.parse(out.output || '[]'); } catch { return false; } if (!Array.isArray(checks) || checks.length === 0) return false; const ok = new Set(['SUCCESS', 'PASSED', 'PASS', 'COMPLETED', 'NEUTRAL', 'SKIPPED']); return checks.every((c) => ok.has(String(c?.state || '').toUpperCase())); })()" + "message": "Sub-workflow '{{childWorkflowId}}' failed with {{invoke-child.errorCount}} error(s). First error: {{invoke-child.errors}}", + "level": "error" }, "position": { - "x": 150, - "y": 470 + "x": 1500, + "y": 100 }, "outputs": [ - "yes", - "no" + "default" ] + } + ], + "edges": [ + { + "id": "trigger->list-workflows", + "source": "trigger", + "target": "list-workflows", + "sourcePort": "default" }, { - "id": "wait-for-ci", - "type": "action.delay", - "label": "Wait for CI", - "config": { - "ms": "{{ciTimeoutMs}}", - "seconds": "{{cooldownSec}}", - "reason": "CI is still running" - }, - "position": { - "x": 150, - "y": 620 - }, - "outputs": [ - "default" - ] + "id": "list-workflows->invoke-child", + "source": "list-workflows", + "target": "invoke-child", + "sourcePort": "default" }, { - "id": "skip-untrusted-pr", - "type": "notify.log", - "label": "Skip Non-Bosun PR", + "id": "invoke-child->check-success", + "source": "invoke-child", + "target": "check-success", + "sourcePort": "default" + }, + { + "id": "check-success->process-output", + "source": "check-success", + "target": "process-output", + "sourcePort": "true" + }, + { + "id": "check-success->handle-failure", + "source": "check-success", + "target": "handle-failure", + "sourcePort": "false" + } + ] + } + ], + "workflows": [ + { + "id": "wf-bosun-pr-progressor", + "name": "Bosun PR Progressor", + "description": "Direct per-PR progression workflow for bosun-managed tasks. Runs immediately after PR handoff, evaluates a single PR, retries simple CI failures, dispatches focused repair when needed, and performs the first merge-review pass without waiting for the periodic watchdog.", + "category": "github", + "enabled": true, + "nodeCount": 13, + "trigger": "trigger.workflow_call", + "variables": { + "mergeMethod": "merge", + "labelNeedsFix": "bosun-needs-fix", + "labelNeedsReview": "bosun-needs-human-review", + "suspiciousDeletionRatio": 3, + "minDestructiveDeletions": 500 + }, + "nodes": [ + { + "id": "trigger", + "type": "trigger.workflow_call", + "label": "PR Handoff", "config": { - "message": "PR Merge Strategy: skipping PR #{{prNumber}} because it is attached but not Bosun-created", - "level": "info" + "inputs": { + "taskId": { + "type": "string", + "required": false + }, + "taskTitle": { + "type": "string", + "required": false + }, + "branch": { + "type": "string", + "required": false + }, + "baseBranch": { + "type": "string", + "required": false, + "default": "main" + }, + "prNumber": { + "type": "number", + "required": false + }, + "prUrl": { + "type": "string", + "required": false + }, + "repo": { + "type": "string", + "required": false + } + } }, "position": { - "x": 730, - "y": 230 + "x": 400, + "y": 50 }, "outputs": [ "default" ] }, { - "id": "analyze", - "type": "action.run_agent", - "label": "Analyze Merge Strategy", + "id": "normalize-context", + "type": "action.set_variable", + "label": "Normalize PR Context", "config": { - "prompt": "# PR Merge Strategy Analysis\n\nReview PR #{{prNumber}} on branch {{branch}}.\n\n## Decision Options:\n1. **merge_after_ci_pass** — Code looks correct, CI is green, merge it.\n2. **prompt** — Agent needs to do more work (provide specific instructions).\n3. **close_pr** — PR should be closed (bad approach, duplicate, etc.).\n4. **re_attempt** — Start task over with fresh agent.\n5. **manual_review** — Escalate to human reviewer.\n6. **wait** — CI still running, wait before deciding.\n7. **noop** — No action needed.\n\nRespond with JSON: { \"action\": \"\", \"reason\": \"\", \"message\": \"\" }", - "timeoutMs": 900000 + "key": "prProgressContext", + "value": "(() => { const prOut = $ctx.getNodeOutput('create-pr') || $ctx.getNodeOutput('create-pr-retry') || {}; const prUrl = String($data?.prUrl || prOut?.prUrl || prOut?.url || '').trim(); const repoMatch = prUrl.match(/github\\.com\\/([^/]+\\/[^/?#]+)/i); const repo = String($data?.repo || (repoMatch ? repoMatch[1] : '')).trim(); const rawPrNumber = $data?.prNumber ?? prOut?.prNumber ?? null; const parsedPrNumber = Number.parseInt(String(rawPrNumber || ''), 10); return { taskId: String($data?.taskId || '').trim() || null, taskTitle: String($data?.taskTitle || '').trim() || null, repo: repo || null, branch: String($data?.branch || prOut?.branch || '').trim() || null, baseBranch: String($data?.baseBranch || prOut?.base || 'main').trim() || 'main', prNumber: Number.isFinite(parsedPrNumber) && parsedPrNumber > 0 ? parsedPrNumber : null, prUrl: prUrl || null, };})()", + "isExpression": true }, "position": { "x": 400, - "y": 350 + "y": 180 }, "outputs": [ "default" ] }, { - "id": "parse-decision", - "type": "action.set_variable", - "label": "Parse Decision JSON", + "id": "has-pr-target", + "type": "condition.expression", + "label": "Has PR Target?", "config": { - "key": "decision", - "value": "(() => { const raw = $ctx.getNodeOutput('analyze')?.output || '{}'; if (raw && typeof raw === 'object') return raw; try { return JSON.parse(String(raw)); } catch { return { action: 'manual_review', reason: 'unparseable merge strategy response', message: String(raw || '') }; } })()", - "isExpression": true + "expression": "Boolean($data?.prProgressContext?.prNumber && ($data?.prProgressContext?.repo || $data?.prProgressContext?.prUrl))" }, "position": { "x": 400, - "y": 430 + "y": 300 }, "outputs": [ "default" ] }, { - "id": "decision-router", - "type": "condition.switch", - "label": "Route Decision", + "id": "inspect-pr", + "type": "action.run_command", + "label": "Inspect Single PR", "config": { - "value": "(() => { const action = String($data?.decision?.action || '').trim().toLowerCase(); return action || 'manual_review'; })()", - "cases": { - "merge_after_ci_pass": "merge", - "prompt": "prompt-agent", - "close_pr": "close", - "re_attempt": "retry", - "manual_review": "escalate", - "wait": "wait-for-ci", - "noop": "default" + "command": "node", + "args": [ + "-e", + "const {execFileSync}=require('child_process'); const ctx=(()=>{try{return JSON.parse(String(process.env.BOSUN_PR_CONTEXT||'{}'))}catch{return {}}})(); const repo=String(ctx.repo||'').trim(); const branch=String(ctx.branch||'').trim(); const baseBranch=String(ctx.baseBranch||'main').trim()||'main'; const rawNumber=String(ctx.prNumber||'').trim(); const prNumber=Number.parseInt(rawNumber,10); if(!repo||!Number.isFinite(prNumber)||prNumber<=0){ console.log(JSON.stringify({success:false,classification:'missing',reason:'missing_repo_or_pr',repo,prNumber:Number.isFinite(prNumber)?prNumber:null,branch,baseBranch})); process.exit(0); } function gh(args){return execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();} function safeGhJson(args,fallback){try{const out=gh(args);return out?JSON.parse(out):fallback;}catch{return fallback;}} function truncateText(value,max){const text=String(value||'').replace(/\\r/g,'').trim();if(!text)return '';return text.length>max?text.slice(0,Math.max(0,max-19))+'\\n...[truncated]':text;} function compactUser(user){const login=String(user?.login||user?.name||'').trim();return login?{login,url:String(user?.url||user?.html_url||'').trim()||null}:null;} function compactCheck(check){const name=String(check?.name||check?.context||check?.workflowName||'').trim();const state=String(check?.state||check?.conclusion||'').toUpperCase();const bucket=String(check?.bucket||'').toUpperCase();if(!name&&!state&&!bucket)return null;return {name:name||null,state:state||null,bucket:bucket||null,workflow:String(check?.workflowName||'').trim()||null};} function compactIssueComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,updatedAt:String(comment?.updated_at||comment?.updatedAt||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactReview(review){return {id:Number(review?.id||0)||null,author:compactUser(review?.user||review?.author),state:String(review?.state||'').trim()||null,submittedAt:String(review?.submitted_at||review?.submittedAt||'').trim()||null,commitId:String(review?.commit_id||review?.commitId||'').trim()||null,body:truncateText(review?.body,1200)};} function compactReviewComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),path:String(comment?.path||'').trim()||null,line:Number(comment?.line||0)||Number(comment?.original_line||0)||null,startLine:Number(comment?.start_line||0)||null,side:String(comment?.side||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactFile(file){const path=String(file?.filename||file?.path||'').trim();return path?{path,status:String(file?.status||'').trim()||null,additions:Number(file?.additions||0)||0,deletions:Number(file?.deletions||0)||0,changes:Number(file?.changes||0)||0}:null;} function collectPrDigest(fallback){ const pr=safeGhJson(['pr','view',String(prNumber),'--repo',repo,'--json','number,title,body,url,headRefName,baseRefName,isDraft,mergeable,statusCheckRollup,author,labels,reviewDecision'],{}); const issueComments=safeGhJson(['api','repos/'+repo+'/issues/'+prNumber+'/comments?per_page=100'],[]).map(compactIssueComment).slice(0,40); const reviews=safeGhJson(['api','repos/'+repo+'/pulls/'+prNumber+'/reviews?per_page=100'],[]).map(compactReview).slice(0,40); const reviewComments=safeGhJson(['api','repos/'+repo+'/pulls/'+prNumber+'/comments?per_page=100'],[]).map(compactReviewComment).slice(0,60); const files=safeGhJson(['api','repos/'+repo+'/pulls/'+prNumber+'/files?per_page=100'],[]).map(compactFile).filter(Boolean).slice(0,80); const requested=safeGhJson(['api','repos/'+repo+'/pulls/'+prNumber+'/requested_reviewers'],{}); const requestedReviewers=[...(Array.isArray(requested?.users)?requested.users:[]).map(compactUser),...(Array.isArray(requested?.teams)?requested.teams:[]).map((team)=>{const slug=String(team?.slug||team?.name||'').trim();return slug?{team:slug,url:String(team?.html_url||team?.url||'').trim()||null}:null;})].filter(Boolean); const checks=(Array.isArray(pr.statusCheckRollup)?pr.statusCheckRollup:[]).map(compactCheck).filter(Boolean); const labels=(Array.isArray(pr.labels)?pr.labels:[]).map((label)=>String(label?.name||label||'').trim()).filter(Boolean); const passingChecks=checks.filter((check)=>check.state==='SUCCESS' || check.bucket==='PASS'); const failingChecks=checks.filter((check)=>['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE'].includes(check.state)||check.bucket==='FAIL'); const pendingChecks=checks.filter((check)=>['QUEUED','IN_PROGRESS','PENDING','WAITING','REQUESTED'].includes(check.state)); const digestSummary=[ 'PR #'+String(pr?.number||prNumber)+' '+String(pr?.title||fallback?.taskTitle||''), 'repo='+repo+' branch='+(String(pr?.headRefName||branch||'').trim()||'unknown')+' base='+(String(pr?.baseRefName||baseBranch||'main').trim()||'main'), 'mergeable='+(String(pr?.mergeable||'').trim()||'unknown')+' reviewDecision='+(String(pr?.reviewDecision||'').trim()||'none'), 'checks='+checks.length+' pass='+passingChecks.length+' fail='+failingChecks.length+' pending='+pendingChecks.length, 'comments='+issueComments.length+' reviews='+reviews.length+' reviewComments='+reviewComments.length+' files='+files.length, labels.length?'labels='+labels.join(', '):'', ].filter(Boolean).join('\\n'); return {core:{number:Number(pr?.number||prNumber)||prNumber,title:String(pr?.title||fallback?.taskTitle||''),url:String(pr?.url||ctx.prUrl||fallback?.prUrl||'').trim()||null,body:truncateText(pr?.body,4000),branch:String(pr?.headRefName||branch||'').trim()||null,baseBranch:String(pr?.baseRefName||baseBranch||'main').trim()||'main',isDraft:pr?.isDraft===true,mergeable:String(pr?.mergeable||'').trim()||null,author:compactUser(pr?.author),reviewDecision:String(pr?.reviewDecision||'').trim()||null},labels,requestedReviewers,checks,ciSummary:{total:checks.length,passing:passingChecks.length,failing:failingChecks.length,pending:pendingChecks.length},issueComments,reviews,reviewComments,files,digestSummary}; } const prDigest=collectPrDigest(ctx||{}); const pr=prDigest.core||{}; const checks=Array.isArray(prDigest.checks)?prDigest.checks:[]; const failStates=new Set(['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE']); const pendingStates=new Set(['QUEUED','IN_PROGRESS','PENDING','WAITING','REQUESTED']); const conflictMergeables=new Set(['CONFLICTING','DIRTY','UNKNOWN']); const failedCheckNames=checks.filter((c)=>{const s=String(c?.state||'').toUpperCase();const b=String(c?.bucket||'').toUpperCase();return failStates.has(s)||b==='FAIL';}).map((c)=>String(c?.name||'').trim()).filter(Boolean); const hasFailure=checks.some((c)=>{const s=String(c?.state||'').toUpperCase();const b=String(c?.bucket||'').toUpperCase();return failStates.has(s)||b==='FAIL';}); const hasPending=checks.some((c)=>pendingStates.has(String(c?.state||'').toUpperCase())); let classification='ready'; let reason='ready_for_review'; let ciKicked=false; if(pr?.isDraft===true){classification='draft';reason='draft_pr';} else if(conflictMergeables.has(String(pr?.mergeable||'').toUpperCase())){classification='conflict';reason='merge_conflict';} else if(hasFailure){classification='ci_failure';reason='ci_failed';} else if(hasPending){classification='pending';reason='ci_pending';} else if(checks.length===0 && branch){ try{gh(['workflow','run','ci.yaml','--repo',repo,'--ref',branch]);ciKicked=true;classification='pending';reason='ci_kicked';} catch{classification='ready';reason='ready_without_checks';} } console.log(JSON.stringify({success:true,repo,prNumber,url:String(pr?.url||ctx.prUrl||''),branch:String(pr?.branch||branch||''),baseBranch:String(pr?.baseBranch||baseBranch||'main'),title:String(pr?.title||ctx.taskTitle||''),mergeable:String(pr?.mergeable||''),reviewDecision:String(pr?.reviewDecision||'').trim()||null,labels:Array.isArray(prDigest.labels)?prDigest.labels:[],classification,reason,ciKicked,hasFailure,hasPending,failedCheckNames,checks,ciSummary:prDigest.ciSummary||null,prDigest,digestSummary:String(prDigest.digestSummary||'')}));" + ], + "continueOnError": true, + "failOnError": false, + "env": { + "BOSUN_PR_CONTEXT": "{{$data?.prProgressContext ? JSON.stringify($data.prProgressContext) : '{}'}}" } }, "position": { "x": 400, - "y": 520 + "y": 430 }, "outputs": [ - "merge", - "prompt-agent", - "close", - "retry", - "escalate", - "wait-for-ci", "default" ] }, { - "id": "do-merge", - "type": "action.run_command", - "label": "Auto-Merge PR", + "id": "fix-needed", + "type": "condition.expression", + "label": "Needs Repair?", "config": { - "command": "gh pr merge {{prNumber}} --auto --merge", - "failOnError": true, - "maxRetries": "{{maxRetries}}", - "retryDelayMs": 30000, - "continueOnError": true + "expression": "(()=>{try{const d=JSON.parse($ctx.getNodeOutput('inspect-pr')?.output||'{}');return d?.classification==='ci_failure' || d?.classification==='conflict';}catch{return false;}})()" }, "position": { - "x": 100, - "y": 680 + "x": 220, + "y": 560 }, "outputs": [ "default" ] }, { - "id": "do-prompt", - "type": "action.run_agent", - "label": "Prompt Agent", + "id": "programmatic-fix", + "type": "action.run_command", + "label": "Repair Attempt", "config": { - "prompt": "Continue working on the PR. Instructions: {{decision.message}}", - "timeoutMs": 3600000, - "failOnError": true, - "maxRetries": 2, - "retryDelayMs": 15000, - "continueOnError": true + "command": "node", + "args": [ + "-e", + "const {execFileSync}=require('child_process'); const data=(()=>{try{return JSON.parse(String(process.env.BOSUN_PR_INSPECT||'{}'))}catch{return {}}})(); const repo=String(data.repo||'').trim(); const branch=String(data.branch||'').trim(); const prNumber=Number.parseInt(String(data.prNumber||''),10); const classification=String(data.classification||'').trim(); const failedCheckNames=Array.isArray(data.failedCheckNames)?data.failedCheckNames:[]; const labelFix=String('{{labelNeedsFix}}'||'bosun-needs-fix'); const FAIL_STATES=new Set(['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE']); const MAX_AUTO_RERUN_ATTEMPT=1; function gh(args){return execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();} function normalizeRun(run){if(!run||typeof run!=='object')return null;return {databaseId:Number(run.databaseId||0)||null,attempt:Number(run.attempt||0)||0,conclusion:String(run.conclusion||''),status:String(run.status||''),workflowName:String(run.workflowName||run.name||''),displayTitle:String(run.displayTitle||run.name||''),url:String(run.url||''),createdAt:String(run.createdAt||''),updatedAt:String(run.updatedAt||'')}} function normalizeJob(job){if(!job||typeof job!=='object')return null;const steps=Array.isArray(job.steps)?job.steps:[];return {databaseId:Number(job.databaseId||job.id||0)||null,name:String(job.name||''),status:String(job.status||''),conclusion:String(job.conclusion||''),url:String(job.url||job.html_url||''),checkRunUrl:String(job.check_run_url||job.checkRunUrl||''),failedSteps:steps.filter((step)=>FAIL_STATES.has(String(step?.conclusion||step?.status||'').toUpperCase())).map((step)=>({name:String(step?.name||''),number:Number(step?.number||0)||null,status:String(step?.status||''),conclusion:String(step?.conclusion||'')})).filter((step)=>step.name).slice(0,10)}} function truncateText(value,max){const text=String(value||'').replace(/\\r/g,'').trim();if(!text)return '';return text.length>max?text.slice(0,Math.max(0,max-19))+'\\n...[truncated]':text;} const CI_LOG_EXCERPT_MAX_CHARS=12000;const CI_MAX_JOB_DIAGNOSTICS=10;const CI_MAX_ANNOTATIONS=60;function safeGhJsonRunner(runner,args,fallback){try{const out=runner(args);return out?JSON.parse(out):fallback;}catch{return fallback;}}function parseCheckRunId(value){const match=String(value||'').match(/\\/check-runs\\/(\\d+)/i);return match?Number(match[1]||0)||0:0;}function normalizeAnnotation(annotation){if(!annotation||typeof annotation!=='object')return null;const path=String(annotation.path||'').trim();const message=truncateText(annotation.message,1200);if(!path&&!message)return null;return {path:path||null,startLine:Number(annotation.start_line||0)||null,endLine:Number(annotation.end_line||0)||null,startColumn:Number(annotation.start_column||0)||null,endColumn:Number(annotation.end_column||0)||null,level:String(annotation.annotation_level||'').trim()||null,title:truncateText(annotation.title,300)||null,message,rawDetails:truncateText(annotation.raw_details,800)||null};}function collectCheckRunAnnotations(repo,checkRunId,runner){if(!repo||!checkRunId)return [];const annotations=[];for(let page=1;page<=3&&annotations.length=CI_MAX_ANNOTATIONS)break;}if(batch.length<50)break;}return annotations.slice(0,CI_MAX_ANNOTATIONS);}function collectCiDiagnostics(repo,run,runner){const info={failedRun:normalizeRun(run),failedJobs:[],failedAnnotations:[],failedLogExcerpt:'',diagnosticsError:''};const runId=Number(run?.databaseId||0)||0;if(!runId||!repo)return info;let workflowJobs=[];try{const viewRaw=runner(['run','view',String(runId),'--repo',repo,'--json','attempt,conclusion,status,workflowName,displayTitle,url,createdAt,updatedAt,jobs']);const view=(()=>{try{return JSON.parse(viewRaw||'{}')}catch{return {}}})();info.failedRun=normalizeRun({...run,...view});const apiJobs=safeGhJsonRunner(runner,['api','repos/'+repo+'/actions/runs/'+runId+'/jobs?per_page=100'],{});workflowJobs=Array.isArray(apiJobs?.jobs)?apiJobs.jobs:(Array.isArray(view.jobs)?view.jobs:[]);info.failedJobs=workflowJobs.map(normalizeJob).filter((job)=>job&&(FAIL_STATES.has(String(job.conclusion||'').toUpperCase())||job.failedSteps.length>0)).slice(0,CI_MAX_JOB_DIAGNOSTICS);}catch(e){info.diagnosticsError=String(e?.message||e);}try{for(const job of info.failedJobs){const checkRunId=parseCheckRunId(job?.checkRunUrl);const annotations=collectCheckRunAnnotations(repo,checkRunId,runner);if(annotations.length===0)continue;info.failedAnnotations.push({name:String(job?.name||''),checkRunId,annotations});if(info.failedAnnotations.length>=CI_MAX_JOB_DIAGNOSTICS)break;}}catch(e){const message=String(e?.message||e);if(message&&message!==info.diagnosticsError){info.diagnosticsError=info.diagnosticsError?info.diagnosticsError+' | '+message:message;}}try{info.failedLogExcerpt=truncateText(runner(['run','view',String(runId),'--repo',repo,'--log-failed']),CI_LOG_EXCERPT_MAX_CHARS);}catch(e){const message=String(e?.message||e);if(message&&message!==info.diagnosticsError){info.diagnosticsError=info.diagnosticsError?info.diagnosticsError+' | '+message:message;}}return info;} if(repo&&Number.isFinite(prNumber)&&prNumber>0){ try{gh(['pr','edit',String(prNumber),'--repo',repo,'--add-label',labelFix]);}catch{} } if(classification==='ci_failure'&&repo&&branch){ try{ const listRaw=gh(['run','list','--repo',repo,'--branch',branch,'--json','databaseId,attempt,conclusion,status,workflowName,displayTitle,url,createdAt,updatedAt','--limit','8']); const runs=(()=>{try{return JSON.parse(listRaw||'[]')}catch{return []}})(); const failed=(Array.isArray(runs)?runs:[]).find((r)=>FAIL_STATES.has(String(r?.conclusion||'').toUpperCase())); const failedRun=normalizeRun(failed); if(failedRun?.databaseId&&failedRun.attempt<=MAX_AUTO_RERUN_ATTEMPT){gh(['run','rerun',String(failedRun.databaseId),'--repo',repo]);console.log(JSON.stringify({success:true,rerunRequested:true,needsAgent:false,reason:'rerun_requested',failedCheckNames,failedRun}));process.exit(0);} if(failedRun?.databaseId){const diagnostics=collectCiDiagnostics(repo,failedRun,gh);console.log(JSON.stringify({success:false,rerunRequested:false,needsAgent:true,reason:'auto_rerun_limit_reached',failedCheckNames,rerunAttempts:failedRun.attempt||0,...diagnostics}));process.exit(0);} console.log(JSON.stringify({success:false,rerunRequested:false,needsAgent:true,reason:'no_rerunnable_failed_run_found',failedCheckNames,recentRuns:(Array.isArray(runs)?runs:[]).map(normalizeRun).filter(Boolean).slice(0,5)})); process.exit(0); }catch(e){ console.log(JSON.stringify({success:false,rerunRequested:false,needsAgent:true,reason:'ci_rerun_failed',failedCheckNames,error:String(e?.message||e)})); process.exit(0); } } if(classification==='conflict'&&repo&&Number.isFinite(prNumber)&&prNumber>0){ const mergeable=String(data.mergeable||'').toUpperCase(); if(mergeable==='BEHIND'){ try{ const headSha=JSON.parse(gh(['pr','view',String(prNumber),'--repo',repo,'--json','headRefOid'])).headRefOid; gh(['api','-X','PUT','repos/'+repo+'/pulls/'+prNumber+'/update-branch','--field','expected_head_sha='+headSha]); console.log(JSON.stringify({success:true,branchUpdated:true,needsAgent:false,reason:'branch_updated_from_base',mergeable})); process.exit(0); }catch(e){ console.log(JSON.stringify({success:false,needsAgent:true,reason:'branch_update_failed',mergeable,error:String(e?.message||e)})); process.exit(0); } } } console.log(JSON.stringify({success:false,rerunRequested:false,needsAgent:true,reason:classification==='conflict'?'merge_conflict_requires_code_resolution':'repair_required',failedCheckNames}));" + ], + "continueOnError": true, + "failOnError": false, + "env": { + "BOSUN_PR_INSPECT": "{{$ctx.getNodeOutput('inspect-pr')?.output || '{}'}}" + } }, "position": { - "x": 300, - "y": 680 + "x": 220, + "y": 690 }, "outputs": [ "default" ] }, { - "id": "do-close", - "type": "action.run_command", - "label": "Close PR", + "id": "fix-agent-needed", + "type": "condition.expression", + "label": "Needs Fix Agent?", "config": { - "command": "gh pr close {{prNumber}} --comment \"{{decision.reason}}\"", - "failOnError": true, - "maxRetries": 2, - "retryDelayMs": 15000, - "continueOnError": true + "expression": "(()=>{try{const d=JSON.parse($ctx.getNodeOutput('programmatic-fix')?.output||'{}');return d?.needsAgent===true;}catch{return false;}})()" }, "position": { - "x": 500, - "y": 680 + "x": 220, + "y": 820 }, "outputs": [ "default" ] }, { - "id": "do-retry", + "id": "dispatch-fix-agent", "type": "action.run_agent", - "label": "Re-attempt Task", + "label": "Dispatch Focused Fix Agent", "config": { - "prompt": "Start the task over from scratch. Previous attempt failed: {{decision.reason}}", - "timeoutMs": 3600000, - "failOnError": true, + "prompt": "You are a Bosun PR repair fallback agent working one PR only.\n\nPR context:\n{{$ctx.getNodeOutput('inspect-pr')?.output}}\n\nRepair attempt output:\n{{$ctx.getNodeOutput('programmatic-fix')?.output}}\n\nUse prDigest.body, prDigest.files, prDigest.issueComments, prDigest.reviews, prDigest.reviewComments, prDigest.checks, failedAnnotations, and any failedLogExcerpt before making changes.\n\nRules:\n- Only fix this PR's CI or merge-conflict issue.\n- Do not merge, approve, or close the PR.\n- Keep the patch minimal and scoped to the reported failure.\n- If you repair the PR, remove the bosun-needs-fix label.\n", + "sdk": "auto", + "timeoutMs": 1800000, "maxRetries": 2, - "retryDelayMs": 15000, + "retryDelayMs": 30000, "continueOnError": true }, "position": { - "x": 700, - "y": 680 + "x": 220, + "y": 950 }, "outputs": [ "default" ] }, { - "id": "do-escalate", - "type": "notify.telegram", - "label": "Escalate to Human", + "id": "review-needed", + "type": "condition.expression", + "label": "Ready For Review?", "config": { - "message": ":eye: PR #{{prNumber}} needs manual review: {{decision.reason}}" + "expression": "(()=>{try{const d=JSON.parse($ctx.getNodeOutput('inspect-pr')?.output||'{}');return d?.classification==='ready';}catch{return false;}})()" }, "position": { - "x": 900, - "y": 680 + "x": 620, + "y": 560 }, "outputs": [ "default" ] }, { - "id": "action-succeeded", - "type": "condition.expression", - "label": "Action Succeeded?", + "id": "programmatic-review", + "type": "action.run_command", + "label": "Review Gate: Merge Single PR", "config": { - "expression": "(() => { const action = String($data?.decision?.action || '').trim().toLowerCase(); if (action === 'merge_after_ci_pass') return $ctx.getNodeOutput('do-merge')?.success === true; if (action === 'prompt') return $ctx.getNodeOutput('do-prompt')?.success === true; if (action === 'close_pr') return $ctx.getNodeOutput('do-close')?.success === true; if (action === 're_attempt') return $ctx.getNodeOutput('do-retry')?.success === true; if (action === 'manual_review') return $ctx.getNodeOutput('do-escalate')?.sent !== false; return true; })()" + "command": "node", + "args": [ + "-e", + "const {execFileSync}=require('child_process'); const pr=(()=>{try{return JSON.parse(String(process.env.BOSUN_PR_INSPECT||'{}'))}catch{return {}}})(); const repo=String(pr.repo||'').trim(); const n=String(pr.prNumber||'').trim(); const ratio=Number('{{suspiciousDeletionRatio}}')||3; const minDel=Number('{{minDestructiveDeletions}}')||500; const labelReview=String('{{labelNeedsReview}}'||'bosun-needs-human-review'); const method=String('{{mergeMethod}}'||'merge').toLowerCase(); function gh(args){return execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();} if(!repo||!n){console.log(JSON.stringify({mergedCount:0,heldCount:0,skippedCount:1,skipped:[{repo,number:n,reason:'missing_repo_or_pr'}]}));process.exit(0);} try{ const viewRaw=gh(['pr','view',n,'--repo',repo,'--json','number,title,additions,deletions,changedFiles,isDraft']); const view=(()=>{try{return JSON.parse(viewRaw||'{}')}catch{return {}}})(); if(view?.isDraft===true){console.log(JSON.stringify({mergedCount:0,heldCount:0,skippedCount:1,skipped:[{repo,number:n,reason:'draft'}]}));process.exit(0);} const add=Number(view?.additions||0); const del=Number(view?.deletions||0); const changed=Number(view?.changedFiles||0); const destructive=(del>(add*ratio))&&(del>minDel); const tooWide=changed>250; if(destructive||tooWide){ gh(['pr','edit',n,'--repo',repo,'--add-label',labelReview]); gh(['pr','comment',n,'--repo',repo,'--body',':warning: Bosun held this PR for human review due to suspicious diff footprint.']); console.log(JSON.stringify({mergedCount:0,heldCount:1,skippedCount:0,held:[{repo,number:n,reason:destructive?'destructive_diff':'changed_files_too_large',additions:add,deletions:del,changedFiles:changed}]})); process.exit(0); } const checksRaw=gh(['pr','checks',n,'--repo',repo,'--json','name,state,bucket']); const checks=(()=>{try{return JSON.parse(checksRaw||'[]')}catch{return []}})(); const hasFailure=(Array.isArray(checks)?checks:[]).some((x)=>{const s=String(x?.state||'').toUpperCase();const b=String(x?.bucket||'').toUpperCase();return ['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE'].includes(s)||b==='FAIL';}); const hasPending=(Array.isArray(checks)?checks:[]).some((x)=>['QUEUED','IN_PROGRESS','PENDING','WAITING','REQUESTED'].includes(String(x?.state||'').toUpperCase())); if(hasFailure){console.log(JSON.stringify({mergedCount:0,heldCount:0,skippedCount:1,skipped:[{repo,number:n,reason:'ci_failed'}]}));process.exit(0);} if(hasPending){console.log(JSON.stringify({mergedCount:0,heldCount:0,skippedCount:1,skipped:[{repo,number:n,reason:'ci_pending'}]}));process.exit(0);} const mergeArgs=['pr','merge',n,'--repo',repo,'--delete-branch']; if(method==='rebase') mergeArgs.push('--rebase'); else if(method==='merge') mergeArgs.push('--merge'); else mergeArgs.push('--squash'); try{gh(mergeArgs);}catch(directErr){mergeArgs.push('--auto');gh(mergeArgs);} console.log(JSON.stringify({mergedCount:1,heldCount:0,skippedCount:0,merged:[{repo,number:n,title:String(view?.title||'')}] })); }catch(e){ console.log(JSON.stringify({mergedCount:0,heldCount:1,skippedCount:0,held:[{repo,number:n,reason:'merge_attempt_failed',error:String(e?.message||e)}]})); }" + ], + "continueOnError": true, + "failOnError": false, + "env": { + "BOSUN_PR_INSPECT": "{{$ctx.getNodeOutput('inspect-pr')?.output || '{}'}}" + } }, "position": { - "x": 480, - "y": 770 + "x": 620, + "y": 690 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "notify-action-failed", - "type": "notify.telegram", - "label": "Escalate Action Failure", + "id": "log-deferred", + "type": "notify.log", + "label": "Deferred", "config": { - "message": ":alert: PR #{{prNumber}} workflow action failed after retries ({{decision.action}}). Reason: {{decision.reason}}. Manual follow-up required." + "message": "Bosun PR Progressor deferred PR #{{prProgressContext.prNumber}}: {{$ctx.getNodeOutput('inspect-pr')?.output || '{}'}}", + "level": "info" }, "position": { - "x": 760, - "y": 850 + "x": 620, + "y": 820 }, "outputs": [ "default" ] }, { - "id": "notify-complete", + "id": "log-missing", "type": "notify.log", - "label": "Log Result", + "label": "Missing PR Context", "config": { - "message": "PR #{{prNumber}} merge strategy: {{decision.action}} — {{decision.reason}}", - "level": "info" + "message": "Bosun PR Progressor skipped: missing PR context for task {{taskId}}", + "level": "warn" }, "position": { "x": 400, - "y": 850 + "y": 560 }, "outputs": [ "default" ] }, { - "id": "end", - "type": "flow.end", - "label": "End Merge Strategy", + "id": "notify-complete", + "type": "notify.log", + "label": "Log Outcome", "config": { - "status": "completed", - "message": "PR merge strategy flow completed for PR #{{prNumber}}", - "output": { - "prNumber": "{{prNumber}}", - "action": "{{decision.action}}" - } + "message": "Bosun PR Progressor finished for task {{taskId}} / PR {{prProgressContext.prNumber}}", + "level": "info" }, "position": { "x": 400, - "y": 950 + "y": 1090 }, "outputs": [ "default" @@ -27519,194 +20878,117 @@ ], "edges": [ { - "id": "trigger->load-pr-context", + "id": "trigger->normalize-context", "source": "trigger", - "target": "load-pr-context", + "target": "normalize-context", "sourcePort": "default" }, { - "id": "load-pr-context->automation-eligible", - "source": "load-pr-context", - "target": "automation-eligible", + "id": "normalize-context->has-pr-target", + "source": "normalize-context", + "target": "has-pr-target", "sourcePort": "default" }, { - "id": "automation-eligible->check-ci", - "source": "automation-eligible", - "target": "check-ci", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "automation-eligible->get-diff", - "source": "automation-eligible", - "target": "get-diff", - "sourcePort": "yes", + "id": "has-pr-target->inspect-pr", + "source": "has-pr-target", + "target": "inspect-pr", + "sourcePort": "default", "condition": "$output?.result === true" }, { - "id": "automation-eligible->skip-untrusted-pr", - "source": "automation-eligible", - "target": "skip-untrusted-pr", - "sourcePort": "no", + "id": "has-pr-target->log-missing", + "source": "has-pr-target", + "target": "log-missing", + "sourcePort": "default", "condition": "$output?.result !== true" }, { - "id": "check-ci->ci-passed", - "source": "check-ci", - "target": "ci-passed", + "id": "inspect-pr->fix-needed", + "source": "inspect-pr", + "target": "fix-needed", "sourcePort": "default" }, { - "id": "ci-passed->wait-for-ci", - "source": "ci-passed", - "target": "wait-for-ci", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "ci-passed->analyze", - "source": "ci-passed", - "target": "analyze", - "sourcePort": "yes", + "id": "fix-needed->programmatic-fix", + "source": "fix-needed", + "target": "programmatic-fix", + "sourcePort": "default", "condition": "$output?.result === true" }, { - "id": "get-diff->analyze", - "source": "get-diff", - "target": "analyze", - "sourcePort": "default" - }, - { - "id": "wait-for-ci->analyze", - "source": "wait-for-ci", - "target": "analyze", - "sourcePort": "default" - }, - { - "id": "analyze->parse-decision", - "source": "analyze", - "target": "parse-decision", - "sourcePort": "default" + "id": "fix-needed->review-needed", + "source": "fix-needed", + "target": "review-needed", + "sourcePort": "default", + "condition": "$output?.result !== true" }, { - "id": "parse-decision->decision-router", - "source": "parse-decision", - "target": "decision-router", + "id": "programmatic-fix->fix-agent-needed", + "source": "programmatic-fix", + "target": "fix-agent-needed", "sourcePort": "default" }, { - "id": "decision-router->do-merge", - "source": "decision-router", - "target": "do-merge", - "sourcePort": "merge" - }, - { - "id": "decision-router->do-prompt", - "source": "decision-router", - "target": "do-prompt", - "sourcePort": "prompt-agent" - }, - { - "id": "decision-router->do-close", - "source": "decision-router", - "target": "do-close", - "sourcePort": "close" - }, - { - "id": "decision-router->do-retry", - "source": "decision-router", - "target": "do-retry", - "sourcePort": "retry" - }, - { - "id": "decision-router->do-escalate", - "source": "decision-router", - "target": "do-escalate", - "sourcePort": "escalate" - }, - { - "id": "decision-router->wait-for-ci", - "source": "decision-router", - "target": "wait-for-ci", - "sourcePort": "wait-for-ci" + "id": "fix-agent-needed->dispatch-fix-agent", + "source": "fix-agent-needed", + "target": "dispatch-fix-agent", + "sourcePort": "default", + "condition": "$output?.result === true" }, { - "id": "decision-router->notify-complete", - "source": "decision-router", + "id": "fix-agent-needed->notify-complete", + "source": "fix-agent-needed", "target": "notify-complete", - "sourcePort": "default" - }, - { - "id": "do-merge->action-succeeded", - "source": "do-merge", - "target": "action-succeeded", - "sourcePort": "default" - }, - { - "id": "do-prompt->action-succeeded", - "source": "do-prompt", - "target": "action-succeeded", - "sourcePort": "default" - }, - { - "id": "do-close->action-succeeded", - "source": "do-close", - "target": "action-succeeded", - "sourcePort": "default" - }, - { - "id": "do-retry->action-succeeded", - "source": "do-retry", - "target": "action-succeeded", - "sourcePort": "default" + "sourcePort": "default", + "condition": "$output?.result !== true" }, { - "id": "do-escalate->action-succeeded", - "source": "do-escalate", - "target": "action-succeeded", + "id": "dispatch-fix-agent->notify-complete", + "source": "dispatch-fix-agent", + "target": "notify-complete", "sourcePort": "default" }, { - "id": "action-succeeded->notify-complete", - "source": "action-succeeded", - "target": "notify-complete", - "sourcePort": "yes", + "id": "review-needed->programmatic-review", + "source": "review-needed", + "target": "programmatic-review", + "sourcePort": "default", "condition": "$output?.result === true" }, { - "id": "action-succeeded->notify-action-failed", - "source": "action-succeeded", - "target": "notify-action-failed", - "sourcePort": "no", + "id": "review-needed->log-deferred", + "source": "review-needed", + "target": "log-deferred", + "sourcePort": "default", "condition": "$output?.result !== true" }, { - "id": "notify-action-failed->notify-complete", - "source": "notify-action-failed", + "id": "programmatic-review->notify-complete", + "source": "programmatic-review", "target": "notify-complete", "sourcePort": "default" }, { - "id": "notify-complete->end", - "source": "notify-complete", - "target": "end", + "id": "log-deferred->notify-complete", + "source": "log-deferred", + "target": "notify-complete", "sourcePort": "default" }, { - "id": "skip-untrusted-pr->end", - "source": "skip-untrusted-pr", - "target": "end", + "id": "log-missing->notify-complete", + "source": "log-missing", + "target": "notify-complete", "sourcePort": "default" } ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-08T12:00:00.000Z", - "updatedAt": "2026-03-08T12:00:00.000Z", + "createdAt": "2026-03-01T12:00:00.000Z", + "updatedAt": "2026-03-01T12:00:00.000Z", "templateState": { - "templateId": "template-pr-merge-strategy", - "templateName": "PR Merge Strategy", + "templateId": "template-bosun-pr-progressor", + "templateName": "Bosun PR Progressor", "templateVersion": "1.0.0", "installedTemplateVersion": "1.0.0", "isCustomized": false, @@ -27715,235 +20997,374 @@ } }, { - "id": "wf-pr-security-fix-single", - "name": "PR Security Fix Agent (Single PR)", - "description": "Fixes one Bosun-attached PR with CodeQL or code-scanning failures using a dedicated long-running agent (up to 2 hours). Programmatically clones the target repo and checks out the PR's HEAD branch into a temp worktree, runs the agent there, then pushes fixes back with --force-with-lease. The agent NEVER manages git setup or push.", + "id": "wf-bosun-pr-watchdog", + "name": "Bosun PR Watchdog", + "description": "Scans open bosun-attached PRs on a schedule. Makes one gh pr list call per target repo to fetch and classify PRs, then: labels conflicting or failing-CI PRs with bosun-needs-fix and dispatches a repair agent; sends merge candidates through a MANDATORY agent review gate that checks diff stats before any merge — preventing destructive PRs (e.g. -183k lines) from being silently auto-merged. Attached PRs that are not Bosun-created are skipped by default unless explicitly trusted in config.", "category": "github", "enabled": true, - "nodeCount": 11, - "trigger": "trigger.manual", - "variables": {}, + "nodeCount": 19, + "trigger": "trigger.schedule", + "variables": { + "mergeMethod": "merge", + "labelNeedsFix": "bosun-needs-fix", + "labelNeedsReview": "bosun-needs-human-review", + "repoScope": "auto", + "maxPrs": 25, + "intervalMs": 90000, + "suspiciousDeletionRatio": 3, + "minDestructiveDeletions": 500, + "autoApplySuggestions": true, + "trustedAuthors": "", + "allowTrustedFixes": false, + "allowTrustedMerges": false, + "delegationWatchdogTimeoutMs": 300000, + "delegationWatchdogMaxRecoveries": 1 + }, "nodes": [ { "id": "trigger", - "type": "trigger.manual", - "label": "Start", - "config": {}, + "type": "trigger.schedule", + "label": "Poll Every 90s", + "config": { + "intervalMs": "{{intervalMs}}" + }, "position": { - "x": 100, - "y": 100 + "x": 400, + "y": 50 }, "outputs": [ "default" ] }, { - "id": "setup-task", - "type": "action.set_variable", - "label": "Setup Security PR Task ID", + "id": "fetch-and-classify", + "type": "action.run_command", + "label": "Fetch, Classify & Label PRs", "config": { - "key": "taskId", - "value": "'pr-secfix-' + String($data?.item?.taskId || (String($data?.item?.repo || '').replace(/[^a-z0-9]/gi, '-').replace(/-+/g,'-').replace(/^-|-$/g,'') + '-' + String($data?.item?.number || $data?.item?.n || '0'))).replace(/^-|-$/g, '')", - "isExpression": true + "command": "node", + "args": [ + "-e", + "const fs=require('fs'); const path=require('path'); const {execFileSync}=require('child_process'); const LABEL_FIX='{{labelNeedsFix}}'; const MAX_PRS=Math.max(1,Number('{{maxPrs}}')||25); const REPO_SCOPE=String('{{repoScope}}'||'auto').trim(); const FIELDS='number,title,body,author,headRefName,baseRefName,isDraft,mergeable,statusCheckRollup,labels,url'; const FAIL_STATES=new Set(['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE']); const PEND_STATES=new Set(['PENDING','IN_PROGRESS','QUEUED','WAITING','REQUESTED','EXPECTED']); const CONFLICT_MERGEABLES=new Set(['CONFLICTING','DIRTY']); const BEHIND_MERGEABLES=new Set(['BEHIND']); const SECURITY_CHECK_RE=/(^|[^a-z])(codeql|code scanning|security|sarif|codacy)([^a-z]|$)/i; const BOSUN_CREATED_LABEL='bosun-pr-bosun-created'; function readCheckName(check){return String(check?.name||check?.context||check?.workflowName||check?.displayTitle||'').trim();} function isFailedCheck(check){return FAIL_STATES.has(check?.conclusion||check?.state||'');} function isSecurityCheckName(name){return SECURITY_CHECK_RE.test(String(name||''));} function ghJson(args){const out=execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();return out?JSON.parse(out):[];} function runGh(args){return execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();} function safeGhJson(args,fallback){try{const out=runGh(args);return out?JSON.parse(out):fallback;}catch{return fallback;}} function normalizeList(value){if(Array.isArray(value)) return value.map((entry)=>String(entry||'').trim().toLowerCase()).filter(Boolean); return String(value||'').split(',').map((entry)=>entry.trim().toLowerCase()).filter(Boolean);} function parseBool(value,fallback){if(value===undefined||value===null||value==='') return fallback; const raw=String(value).trim().toLowerCase(); if(['1','true','yes','on'].includes(raw)) return true; if(['0','false','no','off'].includes(raw)) return false; return fallback;} function normalizeCheckKey(name){return String(name||'').trim().toLowerCase().replace(/\\s+/g,' ');} function matchesCheckPattern(name,pattern){const text=String(name||'').trim().toLowerCase();const token=String(pattern||'').trim().toLowerCase();if(!text||!token)return false;if(token==='*')return true;if(!token.includes('*'))return text.includes(token);const parts=token.split('*').filter(Boolean);if(parts.length===0)return true;let cursor=0;for(const part of parts){const idx=text.indexOf(part,cursor);if(idx===-1)return false;cursor=idx+part.length;}if(!token.startsWith('*')&&!text.startsWith(parts[0]||''))return false;if(!token.endsWith('*')&&!text.endsWith(parts[parts.length-1]||''))return false;return true;} function matchesAnyPattern(name,patterns){return (Array.isArray(patterns)?patterns:[]).some((pattern)=>matchesCheckPattern(name,pattern));} function readCheckState(check){return String(check?.conclusion||check?.state||check?.status||check?.bucket||'').trim().toUpperCase();} function isPassingCheckState(state,treatNeutralAsPass){if(!state)return true;if(['SUCCESS','PASS','PASSED','COMPLETED'].includes(state))return true;if(treatNeutralAsPass&&['NEUTRAL','SKIPPED'].includes(state))return true;return !FAIL_STATES.has(state)&&!PEND_STATES.has(state);} function evaluateCheckGates(checks,policy){const normalized=(Array.isArray(checks)?checks:[]).map((check)=>({raw:check,name:readCheckName(check),state:readCheckState(check)})).filter((check)=>check.name);const considered=normalized.filter((check)=>!matchesAnyPattern(check.name,policy.ignorePatterns));let required=considered;if(policy.mode==='required-only'){required=considered.filter((check)=>matchesAnyPattern(check.name,policy.requiredPatterns));}if((Array.isArray(policy.optionalPatterns)?policy.optionalPatterns:[]).length>0){required=required.filter((check)=>!matchesAnyPattern(check.name,policy.optionalPatterns));}const missingRequired=policy.requireAnyRequiredCheck&&required.length===0;const failedRequiredChecks=required.filter((check)=>FAIL_STATES.has(check.state));const pendingRequiredChecks=required.filter((check)=>PEND_STATES.has(check.state));const hasRequiredFailure=failedRequiredChecks.length>0;const hasBlockingPending=policy.treatPendingRequiredAsBlocking&&pendingRequiredChecks.length>0;const isReady=!missingRequired&&!hasRequiredFailure&&!hasBlockingPending&&required.every((check)=>isPassingCheckState(check.state,policy.treatNeutralAsPass));return {consideredCount:considered.length,requiredCount:required.length,failedRequiredChecks:failedRequiredChecks.map((check)=>check.raw),pendingRequiredChecks:pendingRequiredChecks.map((check)=>check.raw),hasRequiredFailure,hasBlockingPending,blocksForMissingRequired:missingRequired,isReady,shouldKickCi:considered.length===0};} function buildFailureFingerprint(names){const normalized=[...new Set((Array.isArray(names)?names:[]).map(normalizeCheckKey).filter(Boolean))].sort();return normalized.join('|');} function readLabelNames(pr){return Array.isArray(pr?.labels)?pr.labels.map((entry)=>typeof entry==='string'?entry:entry?.name).filter(Boolean):[];} function isBosunCreated(pr){return readLabelNames(pr).includes(BOSUN_CREATED_LABEL);} function readAuthorLogin(pr){return String(pr?.author?.login||pr?.author?.name||'').trim().toLowerCase();} function configPath(){ const home=String(process.env.BOSUN_HOME||process.env.BOSUN_PROJECT_DIR||'').trim(); return home?path.join(home,'bosun.config.json'):path.join(process.cwd(),'bosun.config.json'); } function readBosunConfig(){ try { return JSON.parse(fs.readFileSync(configPath(),'utf8')); } catch { return {}; } } function collectReposFromConfig(){ const repos=[]; try{ const cfg=readBosunConfig(); const workspaces=Array.isArray(cfg?.workspaces)?cfg.workspaces:[]; if(workspaces.length>0){ const active=String(cfg?.activeWorkspace||'').trim().toLowerCase(); const activeWs=active?workspaces.find(w=>String(w?.id||'').trim().toLowerCase()===active):null; const wsList=activeWs?[activeWs]:workspaces; for(const ws of wsList){ for(const repo of (Array.isArray(ws?.repos)?ws.repos:[])){ const slug=typeof repo==='string'?String(repo).trim():String(repo?.slug||'').trim(); if(slug) repos.push(slug); } } } if(repos.length===0){ for(const repo of (Array.isArray(cfg?.repos)?cfg.repos:[])){ const slug=typeof repo==='string'?String(repo).trim():String(repo?.slug||'').trim(); if(slug) repos.push(slug); } } }catch{} return repos; } function resolveRepoTargets(){ if(REPO_SCOPE&&REPO_SCOPE!=='auto'&&REPO_SCOPE!=='all'&&REPO_SCOPE!=='current'){ return [...new Set(REPO_SCOPE.split(',').map(v=>v.trim()).filter(Boolean))]; } if(REPO_SCOPE==='current') return ['']; const fromConfig=collectReposFromConfig(); if(fromConfig.length>0) return [...new Set(fromConfig)]; const envRepo=String(process.env.GITHUB_REPOSITORY||'').trim(); if(envRepo) return [envRepo]; return ['']; } const BOSUN_CONFIG=readBosunConfig(); const PR_AUTOMATION=(BOSUN_CONFIG&&typeof BOSUN_CONFIG.prAutomation==='object')?BOSUN_CONFIG.prAutomation:{}; const ATTACH_MODE=((String(PR_AUTOMATION?.attachMode||'all').trim().toLowerCase())||'all'); const TRUSTED_AUTHORS=new Set([...normalizeList(PR_AUTOMATION?.trustedAuthors),...normalizeList('{{trustedAuthors}}')]); const ALLOW_TRUSTED_FIXES=parseBool(PR_AUTOMATION?.allowTrustedFixes ?? '{{allowTrustedFixes}}', false); const ALLOW_TRUSTED_MERGES=parseBool(PR_AUTOMATION?.allowTrustedMerges ?? '{{allowTrustedMerges}}', false); const CHECK_GATES=(BOSUN_CONFIG&&typeof BOSUN_CONFIG.gates==='object'&&BOSUN_CONFIG.gates&&typeof BOSUN_CONFIG.gates.checks==='object')?BOSUN_CONFIG.gates.checks:{}; const CHECK_MODE=((String(CHECK_GATES?.mode||'all').trim().toLowerCase())||'all'); const REQUIRED_CHECK_PATTERNS=normalizeList(CHECK_GATES?.requiredPatterns); const OPTIONAL_CHECK_PATTERNS=normalizeList(CHECK_GATES?.optionalPatterns); const IGNORE_CHECK_PATTERNS=normalizeList(CHECK_GATES?.ignorePatterns); const REQUIRE_ANY_REQUIRED_CHECK=parseBool(CHECK_GATES?.requireAnyRequiredCheck, true); const TREAT_PENDING_REQUIRED_AS_BLOCKING=parseBool(CHECK_GATES?.treatPendingRequiredAsBlocking, true); const TREAT_NEUTRAL_AS_PASS=parseBool(CHECK_GATES?.treatNeutralAsPass, false); const defaultBranchFailureCache=new Map(); function collectDefaultBranchFailureNames(repo,baseBranch){const cacheKey=[repo,baseBranch].join('::');if(defaultBranchFailureCache.has(cacheKey))return defaultBranchFailureCache.get(cacheKey);const failedNames=new Set();try{const runs=safeGhJson(['run','list','--repo',repo,'--branch',baseBranch,'--json','databaseId,workflowName,displayTitle,conclusion,status','--limit','6'],[]);for(const run of (Array.isArray(runs)?runs:[])){const conclusion=String(run?.conclusion||'').trim().toUpperCase();if(!FAIL_STATES.has(conclusion))continue;const runId=Number(run?.databaseId||0)||0;if(runId>0){const view=safeGhJson(['run','view',String(runId),'--repo',repo,'--json','jobs'],{});const jobs=Array.isArray(view?.jobs)?view.jobs:[];for(const job of jobs){const jobState=String(job?.conclusion||job?.status||'').trim().toUpperCase();if(FAIL_STATES.has(jobState)){const normalized=normalizeCheckKey(job?.name);if(normalized)failedNames.add(normalized);}}}const workflowName=normalizeCheckKey(run?.workflowName||run?.displayTitle);if(workflowName)failedNames.add(workflowName);}}catch{}const resolved=[...failedNames];defaultBranchFailureCache.set(cacheKey,resolved);return resolved;} function parseRepoFromUrl(url){ const raw=String(url||''); const marker='github.com/'; const idx=raw.toLowerCase().indexOf(marker); if(idx<0) return ''; const tail=raw.slice(idx+marker.length).split('/'); if(tail.length<2) return ''; const owner=String(tail[0]||'').trim(); const repo=String(tail[1]||'').trim(); return owner&&repo?(owner+'/'+repo):''; } const repoTargets=resolveRepoTargets(); const prs=[]; const repoErrors=[]; for(const target of repoTargets){ const repo=String(target||'').trim(); const args=['pr','list','--state','open','--json',FIELDS,'--limit',String(MAX_PRS)]; if(repo) args.push('--repo',repo); try{ const list=ghJson(args); for(const pr of (Array.isArray(list)?list:[])){ const prRepo=repo||parseRepoFromUrl(pr?.url)||String(process.env.GITHUB_REPOSITORY||'').trim(); prs.push({...pr,__repo:prRepo}); } }catch(e){ repoErrors.push({repo:repo||'current',error:String(e?.message||e)}); } } const taskCli=path.join(process.cwd(),'task','task-cli.mjs'); const taskRunner=fs.existsSync(taskCli)?'direct':'cli'; const taskMaxBuffer=1024*1024*8; function parseJson(raw,fallback){try{return JSON.parse(raw||'')}catch{return fallback;}} function runTask(args){const cmdArgs=taskRunner==='cli'?['cli.mjs','task',...args,'--config-dir','.bosun','--repo-root','.']:[taskCli,...args];return execFileSync('node',cmdArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe'],maxBuffer:taskMaxBuffer}).trim();} let taskListCache=null; function loadTaskList(){if(taskListCache)return taskListCache;try{const raw=runTask(['list','--json']);const tasks=parseJson(raw,[]);taskListCache=Array.isArray(tasks)?tasks:[];}catch{taskListCache=[];}return taskListCache;} function normalizeTaskValue(value){return String(value||'').trim().toLowerCase();} function resolveTaskIdForPr(item){const prNumber=Number(item?.n||0)||0;const prUrl=normalizeTaskValue(item?.url);const branch=normalizeTaskValue(item?.branch);const matches=loadTaskList().filter((task)=>{if(!task||typeof task!=='object')return false;const taskPrNumber=Number(task?.prNumber||task?.pr_number||0)||0;if(prNumber>0&&taskPrNumber===prNumber)return true;const taskPrUrl=normalizeTaskValue(task?.prUrl||task?.pr_url);if(prUrl&&taskPrUrl===prUrl)return true;const taskBranch=normalizeTaskValue(task?.branchName||task?.branch||task?.meta?.branchName||task?.meta?.branch);return Boolean(branch&&taskBranch===branch);});if(matches.length===0)return null;const inReview=matches.find((task)=>normalizeTaskValue(task?.status)==='inreview');return String((inReview||matches[0])?.id||'').trim()||null;} function getTaskSnapshot(id){if(!id)return null;try{return parseJson(runTask(['get',id,'--json']),null);}catch{return null;}} function updateTaskReviewSignal(item){const taskId=resolveTaskIdForPr(item);if(!taskId)return false;const snapshot=getTaskSnapshot(taskId)||{};const existingMeta=snapshot?.meta&&typeof snapshot.meta==='object'?snapshot.meta:{};const existingReviewHealth=existingMeta.reviewHealth&&typeof existingMeta.reviewHealth==='object'?existingMeta.reviewHealth:{};const nextReviewHealth={...existingReviewHealth,status:String(item?.reviewStatus||'unknown'),failureScope:String(item?.failureScope||'none'),sharedIncidentId:item?.sharedIncidentId||null,failureFingerprint:item?.failureFingerprint||null,failingWorkflow:item?.failingWorkflow||null,failingJobs:Array.isArray(item?.failedCheckNames)?item.failedCheckNames:[],baseBranch:String(item?.base||snapshot?.baseBranch||'').trim()||null,repo:String(item?.repo||'').trim()||null,updatedAt:new Date().toISOString(),source:'pr-watchdog'};const patch={meta:{...existingMeta,reviewHealth:nextReviewHealth}};try{runTask(['update',taskId,JSON.stringify(patch)]);return true;}catch{return false;}} const sharedFailureFingerprints=new Map(); for(const pr of prs){const labels=(pr.labels||[]).map(l=>typeof l==='string'?l:l?.name).filter(Boolean);const bosunCreated=isBosunCreated(pr);const trustedAuthor=TRUSTED_AUTHORS.has(readAuthorLogin(pr));const attachEligible=bosunCreated||ATTACH_MODE==='all'||(ATTACH_MODE==='trusted-only'&&trustedAuthor);const checks=pr.statusCheckRollup||[];const gateVerdict=evaluateCheckGates(checks,{mode:CHECK_MODE,requiredPatterns:REQUIRED_CHECK_PATTERNS,optionalPatterns:OPTIONAL_CHECK_PATTERNS,ignorePatterns:IGNORE_CHECK_PATTERNS,requireAnyRequiredCheck:REQUIRE_ANY_REQUIRED_CHECK,treatPendingRequiredAsBlocking:TREAT_PENDING_REQUIRED_AS_BLOCKING,treatNeutralAsPass:TREAT_NEUTRAL_AS_PASS});const failedCheckNames=gateVerdict.failedRequiredChecks.map(readCheckName).filter(Boolean);const hasSecurityFail=failedCheckNames.some(isSecurityCheckName);const isConflict=CONFLICT_MERGEABLES.has(String(pr.mergeable||'').toUpperCase());const isDraft=pr.isDraft===true;const repo=String(pr.__repo||'').trim();const base=String(pr.baseRefName||'').trim()||'main';if(isDraft||!attachEligible||!gateVerdict.hasRequiredFailure||hasSecurityFail||isConflict)continue;const fingerprint=buildFailureFingerprint(failedCheckNames);if(!fingerprint)continue;const sharedKey=[repo,base,fingerprint].join('::');sharedFailureFingerprints.set(sharedKey,(sharedFailureFingerprints.get(sharedKey)||0)+1);} const readyCandidates=[],conflicts=[],securityFailures=[],ciFailures=[],sharedFailures=[],pending=[],drafted=[],behindBranches=[],skippedUntrusted=[]; let newlyLabeled=0,staleLabelCleared=0,ciKicked=0,taskReviewSignalsUpdated=0; for(const pr of prs){ const labels=(pr.labels||[]).map(l=>typeof l==='string'?l:l?.name).filter(Boolean); const bosunCreated=isBosunCreated(pr); const trustedAuthor=TRUSTED_AUTHORS.has(readAuthorLogin(pr)); const attachEligible=bosunCreated || ATTACH_MODE==='all' || (ATTACH_MODE==='trusted-only' && trustedAuthor); const canFix=bosunCreated || (attachEligible && ALLOW_TRUSTED_FIXES && trustedAuthor); const canMerge=bosunCreated || (attachEligible && ALLOW_TRUSTED_MERGES && trustedAuthor); const hasFixLabel=labels.includes(LABEL_FIX); const checks=pr.statusCheckRollup||[]; const gateVerdict=evaluateCheckGates(checks,{mode:CHECK_MODE,requiredPatterns:REQUIRED_CHECK_PATTERNS,optionalPatterns:OPTIONAL_CHECK_PATTERNS,ignorePatterns:IGNORE_CHECK_PATTERNS,requireAnyRequiredCheck:REQUIRE_ANY_REQUIRED_CHECK,treatPendingRequiredAsBlocking:TREAT_PENDING_REQUIRED_AS_BLOCKING,treatNeutralAsPass:TREAT_NEUTRAL_AS_PASS}); const failedChecks=gateVerdict.failedRequiredChecks; const failedCheckNames=failedChecks.map(readCheckName).filter(Boolean); const securityCheckNames=failedCheckNames.filter(isSecurityCheckName); const hasFail=gateVerdict.hasRequiredFailure; const hasSecurityFail=securityCheckNames.length>0; const hasPend=gateVerdict.hasBlockingPending; const isConflict=CONFLICT_MERGEABLES.has(String(pr.mergeable||'').toUpperCase()); const isBehind=BEHIND_MERGEABLES.has(String(pr.mergeable||'').toUpperCase()); const isDraft=pr.isDraft===true; const repo=String(pr.__repo||'').trim(); const base=String(pr.baseRefName||'').trim()||'main'; const failureFingerprint=buildFailureFingerprint(failedCheckNames); const sharedFailureKey=[repo,base,failureFingerprint].join('::'); const repeatedFailureCount=Number(sharedFailureFingerprints.get(sharedFailureKey)||0); const defaultBranchFailureNames=repo&&base?collectDefaultBranchFailureNames(repo,base):[]; const defaultBranchFailureSet=new Set((Array.isArray(defaultBranchFailureNames)?defaultBranchFailureNames:[]).map(normalizeCheckKey).filter(Boolean)); const allFailuresOnDefaultBranch=failedCheckNames.length>0&&failedCheckNames.every((name)=>defaultBranchFailureSet.has(normalizeCheckKey(name))); const isSharedFailure=hasFail&&!hasSecurityFail&&!isConflict&&(allFailuresOnDefaultBranch||repeatedFailureCount>=2); const sharedIncidentId=isSharedFailure&&failureFingerprint?[repo,base,failureFingerprint].join(':'):null; if(isDraft){drafted.push({n:pr.number,repo});continue;} if(!bosunCreated && !attachEligible){skippedUntrusted.push({n:pr.number,repo,reason:'attach_policy_excluded'});continue;} if(!bosunCreated && !trustedAuthor){skippedUntrusted.push({n:pr.number,repo,reason:'public_observation_only'});continue;} if(isBehind&&!isConflict){ if(canFix) behindBranches.push({n:pr.number,repo,branch:pr.headRefName,base:pr.baseRefName,url:pr.url}); } if(isConflict){ if(!canFix){skippedUntrusted.push({n:pr.number,repo,reason:'fix_not_allowed'});continue;} conflicts.push({n:pr.number,repo,branch:pr.headRefName,base:pr.baseRefName,url:pr.url,mergeable:String(pr.mergeable||'').toUpperCase()}); if(updateTaskReviewSignal({n:pr.number,repo,branch:pr.headRefName,base,url:pr.url,reviewStatus:'conflict',failureScope:'pr_local',failedCheckNames:[],failureFingerprint:null,failingWorkflow:null,sharedIncidentId:null}))taskReviewSignalsUpdated++; if(!hasFixLabel){ try{const editArgs=['pr','edit',String(pr.number),'--add-label',LABEL_FIX];if(repo)editArgs.push('--repo',repo);execFileSync('gh',editArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe']});newlyLabeled++;} catch(e){process.stderr.write('label err '+(repo?repo+' ':'')+'#'+pr.number+': '+(e?.message||e)+'\\\\n');} } } else if(hasSecurityFail){ if(!canFix){skippedUntrusted.push({n:pr.number,repo,reason:'security_fix_not_allowed'});continue;} securityFailures.push({n:pr.number,repo,branch:pr.headRefName,base:pr.baseRefName,url:pr.url,title:pr.title,failedCheckNames,securityCheckNames}); if(updateTaskReviewSignal({n:pr.number,repo,branch:pr.headRefName,base,url:pr.url,reviewStatus:'security_failure',failureScope:'pr_local',failedCheckNames,failureFingerprint,failingWorkflow:securityCheckNames[0]||failedCheckNames[0]||null,sharedIncidentId:null}))taskReviewSignalsUpdated++; if(!hasFixLabel){ try{const editArgs=['pr','edit',String(pr.number),'--add-label',LABEL_FIX];if(repo)editArgs.push('--repo',repo);execFileSync('gh',editArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe']});newlyLabeled++;} catch(e){process.stderr.write('label err '+(repo?repo+' ':'')+'#'+pr.number+': '+(e?.message||e)+'\\n');} } } else if(hasFail){ if(isSharedFailure){ sharedFailures.push({n:pr.number,repo,branch:pr.headRefName,base:pr.baseRefName,url:pr.url,title:pr.title,failedCheckNames,failureFingerprint,sharedIncidentId,defaultBranchFailureNames,repeatedFailureCount}); if(updateTaskReviewSignal({n:pr.number,repo,branch:pr.headRefName,base,url:pr.url,reviewStatus:'shared_ci_failure',failureScope:'shared',failedCheckNames,failureFingerprint,failingWorkflow:failedCheckNames[0]||null,sharedIncidentId}))taskReviewSignalsUpdated++; if(hasFixLabel){ try{const rmArgs=['pr','edit',String(pr.number),'--remove-label',LABEL_FIX];if(repo)rmArgs.push('--repo',repo);execFileSync('gh',rmArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe']});staleLabelCleared++;} catch(e){process.stderr.write('shared-label-rm err '+(repo?repo+' ':'')+'#'+pr.number+': '+(e?.message||e)+'\\n');} } continue; } if(!canFix){skippedUntrusted.push({n:pr.number,repo,reason:'ci_fix_not_allowed'});continue;} ciFailures.push({n:pr.number,repo,branch:pr.headRefName,url:pr.url,failedCheckNames}); if(updateTaskReviewSignal({n:pr.number,repo,branch:pr.headRefName,base,url:pr.url,reviewStatus:'ci_failure',failureScope:'pr_local',failedCheckNames,failureFingerprint,failingWorkflow:failedCheckNames[0]||null,sharedIncidentId:null}))taskReviewSignalsUpdated++; if(!hasFixLabel){ try{const editArgs=['pr','edit',String(pr.number),'--add-label',LABEL_FIX];if(repo)editArgs.push('--repo',repo);execFileSync('gh',editArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe']});newlyLabeled++;} catch(e){process.stderr.write('label err '+(repo?repo+' ':'')+'#'+pr.number+': '+(e?.message||e)+'\\\\n');} } } else { if(updateTaskReviewSignal({n:pr.number,repo,branch:pr.headRefName,base,url:pr.url,reviewStatus:hasPend?'pending':gateVerdict.isReady?'ready':'idle',failureScope:'none',failedCheckNames:[],failureFingerprint:null,failingWorkflow:null,sharedIncidentId:null}))taskReviewSignalsUpdated++; if(hasFixLabel&&!hasPend&&!gateVerdict.blocksForMissingRequired){ try{ const rmArgs=['pr','edit',String(pr.number),'--remove-label',LABEL_FIX]; if(repo)rmArgs.push('--repo',repo); execFileSync('gh',rmArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe']}); staleLabelCleared++; }catch(e){process.stderr.write('stale-label-rm err '+(repo?repo+' ':'')+'#'+pr.number+': '+(e?.message||e)+'\\\\n');} } else if(gateVerdict.isReady&&!hasFixLabel){ if(hasPend) pending.push({n:pr.number,repo}); if(canMerge){ readyCandidates.push({n:pr.number,repo,branch:pr.headRefName,base:pr.baseRefName,url:pr.url,title:pr.title,pendingChecks:hasPend}); } else { skippedUntrusted.push({n:pr.number,repo,reason:'merge_not_allowed'}); } } if(gateVerdict.shouldKickCi&&repo&&pr.headRefName&&!isDraft){ try{execFileSync('gh',['workflow','run','ci.yaml','--repo',repo,'--ref',pr.headRefName],{encoding:'utf8',stdio:['pipe','pipe','pipe']});ciKicked++;} catch{} } } } console.log(JSON.stringify({ total:prs.length, reposScanned:repoTargets.length, repoErrors, readyCandidates, conflicts, behindBranches, securityFailures, ciFailures, sharedFailures, pending:pending.length, drafted:drafted.length, skippedUntrusted, newlyLabeled, staleLabelCleared, ciKicked, fixNeeded:conflicts.length+securityFailures.length+ciFailures.length, sharedIncidentCount:sharedFailures.length, taskReviewSignalsUpdated, trustPolicy:{trustedAuthors:[...TRUSTED_AUTHORS],allowTrustedFixes:ALLOW_TRUSTED_FIXES,allowTrustedMerges:ALLOW_TRUSTED_MERGES} }));" + ], + "continueOnError": false, + "failOnError": true }, "position": { - "x": 380, - "y": 100 + "x": 400, + "y": 200 }, "outputs": [ "default" ] }, { - "id": "setup-title", - "type": "action.set_variable", - "label": "Setup Security PR Task Title", + "id": "has-prs", + "type": "condition.expression", + "label": "Any Bosun PRs?", "config": { - "key": "taskTitle", - "value": "'Security Fix PR #' + String($data?.item?.number || $data?.item?.n || '?') + ' (' + String($data?.item?.repo || '') + ')'", - "isExpression": true + "expression": "(()=>{try{const r=$ctx.getNodeOutput('fetch-and-classify');if(!r||r.success===false)return false;const o=r.output;return (JSON.parse(o||'{}').total||0)>0;}catch(e){return false;}})()" }, "position": { - "x": 660, - "y": 100 + "x": 400, + "y": 370 }, "outputs": [ "default" ] }, { - "id": "setup-claim-key", - "type": "action.set_variable", - "label": "Setup Claim Key", + "id": "has-behind", + "type": "condition.expression", + "label": "Behind Branches?", "config": { - "key": "claimKey", - "value": "String($data?.item?.claimKey || '')", - "isExpression": true + "expression": "(()=>{try{const o=$ctx.getNodeOutput('fetch-and-classify')?.output;return (JSON.parse(o||'{}').behindBranches||[]).length>0;}catch(e){return false;}})()" }, "position": { - "x": 940, - "y": 100 + "x": 400, + "y": 450 + }, + "outputs": [ + "default" + ] + }, + { + "id": "update-behind-branches", + "type": "action.run_command", + "label": "Update Behind Branches", + "config": { + "command": "node -e \" const {execFileSync}=require('child_process'); const raw=String(process.env.BOSUN_FETCH_AND_CLASSIFY||''); const payload=(()=>{try{return JSON.parse(raw||'{}')}catch{return {}}})(); const behind=Array.isArray(payload.behindBranches)?payload.behindBranches:[]; let updated=0,failed=0; for(const pr of behind){ const repo=String(pr.repo||'').trim(); if(!repo){console.log('skip PR '+pr.n+' — no repo slug');continue;} try{ execFileSync('gh',['api','repos/'+repo+'/pulls/'+pr.n+'/update-branch','--method','PUT'],{encoding:'utf8',stdio:['pipe','pipe','pipe']}); updated++; console.log('Updated PR #'+pr.n+' ('+repo+')'); }catch(e){ failed++; console.log('Failed to update PR #'+pr.n+' ('+repo+'): '+String(e.message||e).slice(0,200)); } } console.log(JSON.stringify({updated,failed,total:behind.length})); \"", + "continueOnError": true, + "failOnError": false, + "timeout": 120000, + "env": { + "BOSUN_FETCH_AND_CLASSIFY": "{{$ctx.getNodeOutput('fetch-and-classify')?.output || '{}'}}" + } + }, + "position": { + "x": 600, + "y": 450 + }, + "outputs": [ + "default" + ] + }, + { + "id": "fix-needed", + "type": "condition.expression", + "label": "Fix Needed?", + "config": { + "expression": "(()=>{try{const o=$ctx.getNodeOutput('fetch-and-classify')?.output;return (JSON.parse(o||'{}').fixNeeded||0)>0;}catch(e){return false;}})()" + }, + "position": { + "x": 200, + "y": 530 + }, + "outputs": [ + "default" + ] + }, + { + "id": "security-fix-needed", + "type": "condition.expression", + "label": "Security Fix Needed?", + "config": { + "expression": "(()=>{try{const o=$ctx.getNodeOutput('fetch-and-classify')?.output;return (JSON.parse(o||'{}').securityFailures||[]).length>0;}catch(e){return false;}})()" + }, + "position": { + "x": 120, + "y": 640 }, "outputs": [ "default" ] }, { - "id": "setup-worktree", + "id": "programmatic-security-fix", "type": "action.run_command", - "label": "Clone & Checkout PR Branch", + "label": "Collect Security Alerts", "config": { "command": "node", "args": [ "-e", - "const os=require('os'); const path=require('path'); const fs=require('fs'); const {execFileSync}=require('child_process'); const repo=String(process.env.PR_REPO||'').trim(); const branch=String(process.env.PR_BRANCH||'').trim(); const base=String(process.env.PR_BASE||'main').trim(); const num=String(process.env.PR_NUMBER||'0').trim(); if(!repo||!branch){console.log(JSON.stringify({error:'missing repo or branch',repo,branch}));process.exit(1);} const wt=path.join(os.tmpdir(),'bosun-secfix-'+num.replace(/[^0-9a-z]/gi,'-')); let reused=false; if(fs.existsSync(path.join(wt,'.git'))){ try{ const cur=execFileSync('git',['rev-parse','--abbrev-ref','HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(cur===branch){ execFileSync('git',['fetch','origin',branch],{cwd:wt,encoding:'utf8',timeout:120000,stdio:['ignore','pipe','pipe']}); execFileSync('git',['reset','--hard','origin/'+branch],{cwd:wt,encoding:'utf8',timeout:30000}); execFileSync('git',['clean','-fdx'],{cwd:wt,encoding:'utf8',timeout:30000}); try{execFileSync('git',['fetch','origin',base],{cwd:wt,encoding:'utf8',timeout:60000,stdio:['ignore','pipe','pipe']});}catch{} reused=true; }else{fs.rmSync(wt,{recursive:true,force:true});} }catch{try{fs.rmSync(wt,{recursive:true,force:true});}catch{}} } if(!reused){ if(fs.existsSync(wt)){try{fs.rmSync(wt,{recursive:true,force:true});}catch{}} execFileSync('gh',['repo','clone',repo,wt,'--','--branch',branch],{encoding:'utf8',timeout:300000,stdio:'inherit'}); execFileSync('git',['fetch','origin',branch],{cwd:wt,encoding:'utf8',timeout:120000,stdio:['ignore','pipe','pipe']}); execFileSync('git',['reset','--hard','origin/'+branch],{cwd:wt,encoding:'utf8',timeout:30000}); try{execFileSync('git',['fetch','origin',base],{cwd:wt,encoding:'utf8',timeout:60000,stdio:['ignore','pipe','pipe']});}catch{} } const finalBranch=execFileSync('git',['rev-parse','--abbrev-ref','HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(finalBranch!==branch){console.error('Branch mismatch: expected '+branch+' got '+finalBranch);process.exit(1);} console.log(JSON.stringify({worktreePath:wt,branch:finalBranch,base,repo,number:num,reused}));" + "const {execFileSync}=require('child_process'); const raw=String(process.env.BOSUN_FETCH_AND_CLASSIFY||''); const payload=(()=>{try{return JSON.parse(raw||'{}')}catch{return {}}})(); const securityFailures=Array.isArray(payload.securityFailures)?payload.securityFailures:[]; const needsAgent=[]; let alertsFetched=0; function gh(args){return execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();} function safeGhJson(args,fallback){try{const out=gh(args);return out?JSON.parse(out):fallback;}catch{return fallback;}} function truncateText(value,max){const text=String(value||'').replace(/\\r/g,'').trim();if(!text)return '';return text.length>max?text.slice(0,Math.max(0,max-19))+'\\n...[truncated]':text;} function compactUser(user){const login=String(user?.login||user?.name||'').trim();return login?{login,url:String(user?.url||user?.html_url||'').trim()||null}:null;} function compactCheck(check){const name=String(check?.name||check?.context||check?.workflowName||'').trim();const state=String(check?.state||check?.conclusion||'').toUpperCase();const bucket=String(check?.bucket||'').toUpperCase();if(!name&&!state&&!bucket)return null;return {name:name||null,state:state||null,bucket:bucket||null,workflow:String(check?.workflowName||'').trim()||null};} function compactIssueComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactReview(review){return {id:Number(review?.id||0)||null,author:compactUser(review?.user||review?.author),state:String(review?.state||'').trim()||null,submittedAt:String(review?.submitted_at||review?.submittedAt||'').trim()||null,body:truncateText(review?.body,1200)};} function compactReviewComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),path:String(comment?.path||'').trim()||null,line:Number(comment?.line||0)||Number(comment?.original_line||0)||null,side:String(comment?.side||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactFile(file){const path=String(file?.filename||file?.path||'').trim();return path?{path,status:String(file?.status||'').trim()||null,additions:Number(file?.additions||0)||0,deletions:Number(file?.deletions||0)||0,changes:Number(file?.changes||0)||0}:null;} function collectPrDigest(repo,number,fallback){const pr=safeGhJson(['pr','view',String(number),'--repo',repo,'--json','number,title,body,url,headRefName,baseRefName,isDraft,mergeable,statusCheckRollup,author,labels,reviewDecision'],{});const issueComments=safeGhJson(['api','repos/'+repo+'/issues/'+number+'/comments?per_page=100'],[]).map(compactIssueComment).slice(0,40);const reviews=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/reviews?per_page=100'],[]).map(compactReview).slice(0,40);const reviewComments=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/comments?per_page=100'],[]).map(compactReviewComment).slice(0,60);const files=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/files?per_page=100'],[]).map(compactFile).filter(Boolean).slice(0,80);const requested=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/requested_reviewers'],{});const requestedReviewers=[...(Array.isArray(requested?.users)?requested.users:[]).map(compactUser),...(Array.isArray(requested?.teams)?requested.teams:[]).map((team)=>{const slug=String(team?.slug||team?.name||'').trim();return slug?{team:slug,url:String(team?.html_url||team?.url||'').trim()||null}:null;})].filter(Boolean);const checks=(Array.isArray(pr.statusCheckRollup)?pr.statusCheckRollup:[]).map(compactCheck).filter(Boolean);const labels=(Array.isArray(pr.labels)?pr.labels:[]).map((label)=>String(label?.name||label||'').trim()).filter(Boolean);const failingChecks=checks.filter((check)=>['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE'].includes(check.state)||check.bucket==='FAIL');const pendingChecks=checks.filter((check)=>['QUEUED','IN_PROGRESS','PENDING','WAITING','REQUESTED'].includes(check.state));const digestSummary=['PR #'+String(pr?.number||number)+' '+String(pr?.title||fallback?.title||''),'repo='+repo+' branch='+(String(pr?.headRefName||fallback?.branch||'').trim()||'unknown'),'checks='+checks.length+' fail='+failingChecks.length+' pending='+pendingChecks.length,'comments='+issueComments.length+' reviews='+reviews.length+' reviewComments='+reviewComments.length+' files='+files.length,labels.length?'labels='+labels.join(', '):''].filter(Boolean).join('\\n');return {core:{number:Number(pr?.number||number)||number,title:String(pr?.title||fallback?.title||''),url:String(pr?.url||fallback?.url||'').trim()||null,body:truncateText(pr?.body,4000),branch:String(pr?.headRefName||fallback?.branch||'').trim()||null,baseBranch:String(pr?.baseRefName||fallback?.base||'').trim()||null,isDraft:pr?.isDraft===true,mergeable:String(pr?.mergeable||'').trim()||null,author:compactUser(pr?.author),reviewDecision:String(pr?.reviewDecision||'').trim()||null},labels,requestedReviewers,checks,ciSummary:{total:checks.length,failing:failingChecks.length,pending:pendingChecks.length,passing:Math.max(0,checks.length-failingChecks.length-pendingChecks.length)},issueComments,reviews,reviewComments,files,digestSummary};} function compactAlert(alert){ const instance=alert?.most_recent_instance||{}; const location=instance?.location||{}; const rule=alert?.rule||{}; const tool=alert?.tool||{}; return { number: alert?.number ?? null, state: String(alert?.state||''), ruleId: String(rule?.id||alert?.rule_id||''), ruleName: String(rule?.name||alert?.rule_name||''), severity: String(rule?.severity||alert?.severity||''), securitySeverity: String(rule?.security_severity_level||alert?.security_severity_level||''), tool: String(tool?.name||alert?.tool_name||''), path: String(location?.path||''), startLine: Number(location?.start_line||0)||null, url: String(alert?.html_url||''), }; } for(const item of securityFailures){ const repo=String(item?.repo||'').trim(); const branch=String(item?.branch||'').trim(); const n=String(item?.n||'').trim(); const securityCheckNames=Array.isArray(item?.securityCheckNames)?item.securityCheckNames:[]; const prDigest=repo&&n?collectPrDigest(repo,n,{branch,base:String(item?.base||'').trim(),title:String(item?.title||''),url:String(item?.url||'')}):null; if(!repo||!branch){needsAgent.push({repo,number:n,branch,reason:'missing_repo_or_branch',securityCheckNames,alerts:[],prDigest,digestSummary:String(prDigest?.digestSummary||'')});continue;} let alerts=[]; let fetchError=''; try{ const alertsRaw=gh(['api','--method','GET','repos/'+repo+'/code-scanning/alerts','--raw-field','state=open','--raw-field','per_page=20','--raw-field','ref=refs/heads/'+branch]); const parsed=(()=>{try{return JSON.parse(alertsRaw||'[]')}catch{return []}})(); alerts=(Array.isArray(parsed)?parsed:[]).map(compactAlert).filter(a=>a.ruleId||a.ruleName||a.path).slice(0,10); if(alerts.length>0) alertsFetched++; }catch(e){fetchError=String(e?.message||e);} needsAgent.push({repo,number:n,branch,base:String(item?.base||'').trim(),url:String(item?.url||''),title:String(item?.title||''),reason:'security_code_scanning_failure',securityCheckNames,failedCheckNames:Array.isArray(item?.failedCheckNames)?item.failedCheckNames:[],alerts,fetchError,prDigest,digestSummary:String(prDigest?.digestSummary||'')}); } console.log(JSON.stringify({securityFailureCount:securityFailures.length,alertsFetched,needsAgentCount:needsAgent.length,needsAgent}));" ], - "parseJson": true, - "failOnError": true, - "timeoutMs": 600000, + "continueOnError": true, + "failOnError": false, "env": { - "PR_REPO": "(()=>{ const i=$data?.item||{}; return String(i.repo||i.prDigest?.core?.repo||''); })()", - "PR_BRANCH": "(()=>{ const i=$data?.item||{}; return String(i.branch||i.prDigest?.core?.branch||''); })()", - "PR_BASE": "(()=>{ const i=$data?.item||{}; return String(i.base||i.baseBranch||i.prDigest?.core?.baseBranch||'main'); })()", - "PR_NUMBER": "(()=>{ const i=$data?.item||{}; return String(i.number||i.n||'0'); })()" + "BOSUN_FETCH_AND_CLASSIFY": "{{$ctx.getNodeOutput('fetch-and-classify')?.output || '{}'}}" } }, "position": { - "x": 1220, - "y": 100 + "x": 120, + "y": 750 }, "outputs": [ "default" ] }, { - "id": "set-worktree-path", - "type": "action.set_variable", - "label": "Set Agent Working Directory", + "id": "security-agent-needed", + "type": "condition.expression", + "label": "Needs Security Agent?", "config": { - "key": "worktreePath", - "value": "{{setup-worktree.output.worktreePath}}" + "expression": "(()=>{try{const o=$ctx.getNodeOutput('programmatic-security-fix')?.output;return (JSON.parse(o||'{}').needsAgentCount||0)>0;}catch(e){return false;}})()" }, "position": { - "x": 1500, - "y": 100 + "x": 120, + "y": 860 }, "outputs": [ "default" ] }, { - "id": "setup-prompt", - "type": "action.set_variable", - "label": "Build Security Agent Prompt", + "id": "dispatch-security-fix-agent", + "type": "action.run_agent", + "label": "Dispatch Security Fix Agent", "config": { - "key": "agentPrompt", - "value": "(()=>{\n const item = $data?.item || {};\n const prDigest = item.prDigest || {};\n const core = prDigest.core || {};\n const repo = String(item.repo || core.repo || '');\n const branch = String(item.branch || core.branch || '');\n const base = String(item.base || item.baseBranch || core.baseBranch || 'main');\n const number = String(item.number || item.n || '');\n const title = String(item.title || core.title || '');\n const url = String(item.url || core.url || '');\n const securityChecks = Array.isArray(item.securityCheckNames) ? item.securityCheckNames : [];\n const failedChecks = Array.isArray(item.failedCheckNames) ? item.failedCheckNames : [];\n const alerts = Array.isArray(item.alerts) ? item.alerts : [];\n const fetchError = String(item.fetchError || '').trim();\n const prBody = String(core.body || '').trim();\n const files = Array.isArray(prDigest.files) ? prDigest.files : [];\n const reviews = Array.isArray(prDigest.reviews) ? prDigest.reviews : [];\n const reviewComments = Array.isArray(prDigest.reviewComments) ? prDigest.reviewComments : [];\n const allChecks = Array.isArray(prDigest.checks) ? prDigest.checks : [];\n let p = 'You are a Bosun PR **security remediation** agent. Fix ONLY the security/CodeQL findings on this single PR.\\n\\n';\n p += '## PR Identity\\n\\n';\n p += '- **Repo**: ' + repo + '\\n';\n p += '- **PR Number**: #' + number + '\\n';\n p += '- **Title**: ' + title + '\\n';\n p += '- **URL**: ' + url + '\\n';\n p += '- **Head Branch**: `' + branch + '`\\n';\n p += '- **Base Branch**: `' + base + '`\\n\\n';\n if (securityChecks.length > 0) {\n p += '## Failed Security Checks\\n\\n';\n securityChecks.forEach(n => { p += '- `' + n + '`\\n'; });\n p += '\\n';\n }\n if (alerts.length > 0) {\n p += '## Code Scanning Alerts\\n\\n';\n alerts.forEach(a => {\n p += '### Alert #' + (a.number||'?') + ' — ' + (a.ruleName||a.ruleId||'unknown rule') + '\\n';\n p += '- **Severity**: ' + (a.securitySeverity||a.severity||'unknown') + '\\n';\n p += '- **Tool**: ' + (a.tool||'unknown') + '\\n';\n p += '- **File**: `' + (a.path||'') + ':' + (a.startLine||'') + '`\\n';\n if (a.url) p += '- **URL**: ' + a.url + '\\n';\n p += '\\n';\n });\n }\n if (fetchError) {\n p += '## Alert Fetch Error\\n\\n' + fetchError + '\\n\\n';\n p += 'Alert fetch failed. Inspect the PR checks and source code directly to identify the security issue.\\n\\n';\n }\n if (prBody) {\n p += '## PR Description\\n\\n' + prBody.slice(0,2000) + '\\n\\n';\n }\n if (files.length > 0) {\n p += '## Changed Files (' + files.length + ')\\n\\n';\n files.slice(0,40).forEach(f => { p += '- `' + f.path + '` (+' + (f.additions||0) + '/-' + (f.deletions||0) + ')\\n'; });\n p += '\\n';\n }\n return p;\n})()", - "isExpression": true + "prompt": "You are a Bosun PR security remediation agent. Work only the PRs in this JSON:\n\n{{$ctx.getNodeOutput('programmatic-security-fix')?.output}}\n\nEach item represents a Bosun-created or explicitly trusted PR blocked by CodeQL or GitHub code scanning.\nUse the supplied alert data, prDigest.body, prDigest.files, prDigest.issueComments, prDigest.reviews, prDigest.reviewComments, and prDigest.checks to make the smallest safe code change that resolves the finding.\nFor each repaired PR: check out the branch, fix only the reported code-scanning issue, run targeted validation, push the branch, and remove bosun-needs-fix after success.\n\nSTRICT RULES:\n- Only fix the listed code-scanning or CodeQL findings.\n- No unrelated refactors, dependency churn, merges, approvals, or PR closure.\n- If alert fetch failed, inspect the PR checks and relevant source to resolve the security failure directly.\n- Do NOT touch PRs that are not Bosun-created or explicitly trusted by config.", + "sdk": "auto", + "timeoutMs": 1800000, + "delegationWatchdogTimeoutMs": "{{delegationWatchdogTimeoutMs}}", + "delegationWatchdogMaxRecoveries": "{{delegationWatchdogMaxRecoveries}}", + "maxRetries": 2, + "retryDelayMs": 30000, + "continueOnError": true }, "position": { - "x": 1780, - "y": 100 + "x": 120, + "y": 970 }, "outputs": [ "default" ] }, { - "id": "fix-agent", - "type": "action.run_agent", - "label": "Fix Security Issue (Dedicated Agent)", + "id": "generic-fix-needed", + "type": "condition.expression", + "label": "Generic Fix Needed?", "config": { - "prompt": "{{agentPrompt}}\n\n## Workspace\n\nYour working directory is already a git clone of the target repo, checked out on the PR's HEAD branch (`{{setup-worktree.output.branch}}`). The base branch (`origin/{{setup-worktree.output.base}}`) has been fetched.\n\n## CRITICAL RULES — READ BEFORE DOING ANYTHING\n\n1. **Do NOT clone or re-clone the repo** — you are already in it.\n2. **Do NOT create new branches.** Stay on the current branch.\n3. **Do NOT push.** The workflow pushes for you automatically after you finish.\n4. **Do NOT switch branches** with `git checkout` or `git switch`.\n5. **Do NOT run `cd` to change to a different directory.** Stay in the cwd.\n6. Fix ONLY the listed security/CodeQL findings. No unrelated changes.\n7. Do NOT merge, approve, or close the PR.\n8. Do NOT touch any other PRs or repos.\n\n## Fix Instructions\n\n1. Read each alert's file and line number from the context above.\n2. Understand the security finding (SQL injection, XSS, path traversal, etc.).\n3. Apply the MINIMAL code change that resolves the finding.\n4. If alerts could not be fetched, run:\n `gh api repos/{{setup-worktree.output.repo}}/code-scanning/alerts --jq '.[] | select(.state==\"open\")' -X GET`\n5. Run any available tests to validate the fix.\n6. `git add` and `git commit` with a clear message referencing the security finding.\n\n**After fixing:** Remove the fix label:\n```\ngh pr edit {{setup-worktree.output.number}} --repo {{setup-worktree.output.repo}} --remove-label bosun-needs-fix\n```\n", - "sdk": "auto", - "timeoutMs": 7200000, - "maxRetries": 1, - "retryDelayMs": 60000, - "sessionRetries": 2, - "maxContinues": 3, - "continueOnSession": true, - "continueOnError": true, - "failOnError": false + "expression": "(()=>{try{const o=$ctx.getNodeOutput('fetch-and-classify')?.output;const d=JSON.parse(o||'{}');return ((d.conflicts||[]).length+(d.ciFailures||[]).length)>0;}catch(e){return false;}})()" }, "position": { - "x": 2060, - "y": 100 + "x": 280, + "y": 640 }, "outputs": [ "default" ] }, { - "id": "push-fixes", + "id": "programmatic-fix", "type": "action.run_command", - "label": "Push Fixes to PR Branch", + "label": "Programmatic Fix Pass", "config": { "command": "node", "args": [ "-e", - "const {execFileSync}=require('child_process'); const wt=String(process.env.WORKTREE_PATH||'').trim(); const branch=String(process.env.PR_BRANCH||'').trim(); const num=String(process.env.PR_NUMBER||'').trim(); if(!wt||!branch){console.log(JSON.stringify({pushed:false,reason:'missing_worktree_or_branch'}));process.exit(0);} const cur=execFileSync('git',['rev-parse','--abbrev-ref','HEAD'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(cur!==branch){console.log(JSON.stringify({pushed:false,reason:'wrong_branch',expected:branch,actual:cur}));process.exit(1);} const status=execFileSync('git',['status','--porcelain'],{cwd:wt,encoding:'utf8',timeout:10000}).trim(); if(status){ execFileSync('git',['add','-A'],{cwd:wt,encoding:'utf8',timeout:30000}); try{execFileSync('git',['commit','-m','bosun: commit security fix changes for PR #'+num],{cwd:wt,encoding:'utf8',timeout:30000});}catch{} } let hasDiff=false; try{const d=execFileSync('git',['rev-list','--count','origin/'+branch+'..HEAD'],{cwd:wt,encoding:'utf8',timeout:30000}).trim();hasDiff=Number(d)>0;} catch{hasDiff=true;} if(!hasDiff){console.log(JSON.stringify({pushed:false,reason:'no_new_commits'}));process.exit(0);} execFileSync('git',['push','--force-with-lease','origin','HEAD:'+branch],{cwd:wt,encoding:'utf8',timeout:120000,stdio:'inherit'}); console.log(JSON.stringify({pushed:true,branch:cur}));" + "const {execFileSync}=require('child_process'); const raw=String(process.env.BOSUN_FETCH_AND_CLASSIFY||''); const payload=(()=>{try{return JSON.parse(raw||'{}')}catch{return {}}})(); const ciFailures=Array.isArray(payload.ciFailures)?payload.ciFailures:[]; const conflicts=Array.isArray(payload.conflicts)?payload.conflicts:[]; const needsAgent=[]; let rerunRequested=0; const FAIL_STATES=new Set(['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE']); const MAX_AUTO_RERUN_ATTEMPT=1; function runGh(args){return execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();} function safeGhJson(args,fallback){try{const out=runGh(args);return out?JSON.parse(out):fallback;}catch{return fallback;}} function normalizeRun(run){if(!run||typeof run!=='object')return null;return {databaseId:Number(run.databaseId||0)||null,attempt:Number(run.attempt||0)||0,conclusion:String(run.conclusion||''),status:String(run.status||''),workflowName:String(run.workflowName||run.name||''),displayTitle:String(run.displayTitle||run.name||''),url:String(run.url||''),createdAt:String(run.createdAt||''),updatedAt:String(run.updatedAt||'')}} function normalizeJob(job){if(!job||typeof job!=='object')return null;const steps=Array.isArray(job.steps)?job.steps:[];return {databaseId:Number(job.databaseId||job.id||0)||null,name:String(job.name||''),status:String(job.status||''),conclusion:String(job.conclusion||''),url:String(job.url||job.html_url||''),checkRunUrl:String(job.check_run_url||job.checkRunUrl||''),failedSteps:steps.filter((step)=>FAIL_STATES.has(String(step?.conclusion||step?.status||'').toUpperCase())).map((step)=>({name:String(step?.name||''),number:Number(step?.number||0)||null,status:String(step?.status||''),conclusion:String(step?.conclusion||'')})).filter((step)=>step.name).slice(0,10)}} function truncateText(value,max){const text=String(value||'').replace(/\\r/g,'').trim();if(!text)return '';return text.length>max?text.slice(0,Math.max(0,max-19))+'\\n...[truncated]':text;} function compactUser(user){const login=String(user?.login||user?.name||'').trim();return login?{login,url:String(user?.url||user?.html_url||'').trim()||null}:null;} function compactCheck(check){const name=String(check?.name||check?.context||check?.workflowName||'').trim();const state=String(check?.state||check?.conclusion||'').toUpperCase();const bucket=String(check?.bucket||'').toUpperCase();if(!name&&!state&&!bucket)return null;return {name:name||null,state:state||null,bucket:bucket||null,workflow:String(check?.workflowName||'').trim()||null};} function compactIssueComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactReview(review){return {id:Number(review?.id||0)||null,author:compactUser(review?.user||review?.author),state:String(review?.state||'').trim()||null,submittedAt:String(review?.submitted_at||review?.submittedAt||'').trim()||null,body:truncateText(review?.body,1200)};} function compactReviewComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),path:String(comment?.path||'').trim()||null,line:Number(comment?.line||0)||Number(comment?.original_line||0)||null,side:String(comment?.side||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactFile(file){const path=String(file?.filename||file?.path||'').trim();return path?{path,status:String(file?.status||'').trim()||null,additions:Number(file?.additions||0)||0,deletions:Number(file?.deletions||0)||0,changes:Number(file?.changes||0)||0}:null;} function collectPrDigest(repo,number,fallback){const pr=safeGhJson(['pr','view',String(number),'--repo',repo,'--json','number,title,body,url,headRefName,baseRefName,isDraft,mergeable,statusCheckRollup,author,labels,reviewDecision'],{});const issueComments=safeGhJson(['api','repos/'+repo+'/issues/'+number+'/comments?per_page=100'],[]).map(compactIssueComment).slice(0,40);const reviews=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/reviews?per_page=100'],[]).map(compactReview).slice(0,40);const reviewComments=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/comments?per_page=100'],[]).map(compactReviewComment).slice(0,60);const files=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/files?per_page=100'],[]).map(compactFile).filter(Boolean).slice(0,80);const requested=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/requested_reviewers'],{});const requestedReviewers=[...(Array.isArray(requested?.users)?requested.users:[]).map(compactUser),...(Array.isArray(requested?.teams)?requested.teams:[]).map((team)=>{const slug=String(team?.slug||team?.name||'').trim();return slug?{team:slug,url:String(team?.html_url||team?.url||'').trim()||null}:null;})].filter(Boolean);const checks=(Array.isArray(pr.statusCheckRollup)?pr.statusCheckRollup:[]).map(compactCheck).filter(Boolean);const failingChecks=checks.filter((check)=>['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE'].includes(check.state)||check.bucket==='FAIL');const pendingChecks=checks.filter((check)=>['QUEUED','IN_PROGRESS','PENDING','WAITING','REQUESTED'].includes(check.state));const labels=(Array.isArray(pr.labels)?pr.labels:[]).map((label)=>String(label?.name||label||'').trim()).filter(Boolean);const digestSummary=['PR #'+String(pr?.number||number)+' '+String(pr?.title||fallback?.title||''),'repo='+repo+' branch='+(String(pr?.headRefName||fallback?.branch||'').trim()||'unknown'),'checks='+checks.length+' fail='+failingChecks.length+' pending='+pendingChecks.length,'comments='+issueComments.length+' reviews='+reviews.length+' reviewComments='+reviewComments.length+' files='+files.length,labels.length?'labels='+labels.join(', '):''].filter(Boolean).join('\\n');return {core:{number:Number(pr?.number||number)||number,title:String(pr?.title||fallback?.title||''),url:String(pr?.url||fallback?.url||'').trim()||null,body:truncateText(pr?.body,4000),branch:String(pr?.headRefName||fallback?.branch||'').trim()||null,baseBranch:String(pr?.baseRefName||fallback?.base||'').trim()||null,isDraft:pr?.isDraft===true,mergeable:String(pr?.mergeable||'').trim()||null,author:compactUser(pr?.author),reviewDecision:String(pr?.reviewDecision||'').trim()||null},labels,requestedReviewers,checks,ciSummary:{total:checks.length,failing:failingChecks.length,pending:pendingChecks.length,passing:Math.max(0,checks.length-failingChecks.length-pendingChecks.length)},issueComments,reviews,reviewComments,files,digestSummary};} const CI_LOG_EXCERPT_MAX_CHARS=12000;const CI_MAX_JOB_DIAGNOSTICS=10;const CI_MAX_ANNOTATIONS=60;function safeGhJsonRunner(runner,args,fallback){try{const out=runner(args);return out?JSON.parse(out):fallback;}catch{return fallback;}}function parseCheckRunId(value){const match=String(value||'').match(/\\/check-runs\\/(\\d+)/i);return match?Number(match[1]||0)||0:0;}function normalizeAnnotation(annotation){if(!annotation||typeof annotation!=='object')return null;const path=String(annotation.path||'').trim();const message=truncateText(annotation.message,1200);if(!path&&!message)return null;return {path:path||null,startLine:Number(annotation.start_line||0)||null,endLine:Number(annotation.end_line||0)||null,startColumn:Number(annotation.start_column||0)||null,endColumn:Number(annotation.end_column||0)||null,level:String(annotation.annotation_level||'').trim()||null,title:truncateText(annotation.title,300)||null,message,rawDetails:truncateText(annotation.raw_details,800)||null};}function collectCheckRunAnnotations(repo,checkRunId,runner){if(!repo||!checkRunId)return [];const annotations=[];for(let page=1;page<=3&&annotations.length=CI_MAX_ANNOTATIONS)break;}if(batch.length<50)break;}return annotations.slice(0,CI_MAX_ANNOTATIONS);}function collectCiDiagnostics(repo,run,runner){const info={failedRun:normalizeRun(run),failedJobs:[],failedAnnotations:[],failedLogExcerpt:'',diagnosticsError:''};const runId=Number(run?.databaseId||0)||0;if(!runId||!repo)return info;let workflowJobs=[];try{const viewRaw=runner(['run','view',String(runId),'--repo',repo,'--json','attempt,conclusion,status,workflowName,displayTitle,url,createdAt,updatedAt,jobs']);const view=(()=>{try{return JSON.parse(viewRaw||'{}')}catch{return {}}})();info.failedRun=normalizeRun({...run,...view});const apiJobs=safeGhJsonRunner(runner,['api','repos/'+repo+'/actions/runs/'+runId+'/jobs?per_page=100'],{});workflowJobs=Array.isArray(apiJobs?.jobs)?apiJobs.jobs:(Array.isArray(view.jobs)?view.jobs:[]);info.failedJobs=workflowJobs.map(normalizeJob).filter((job)=>job&&(FAIL_STATES.has(String(job.conclusion||'').toUpperCase())||job.failedSteps.length>0)).slice(0,CI_MAX_JOB_DIAGNOSTICS);}catch(e){info.diagnosticsError=String(e?.message||e);}try{for(const job of info.failedJobs){const checkRunId=parseCheckRunId(job?.checkRunUrl);const annotations=collectCheckRunAnnotations(repo,checkRunId,runner);if(annotations.length===0)continue;info.failedAnnotations.push({name:String(job?.name||''),checkRunId,annotations});if(info.failedAnnotations.length>=CI_MAX_JOB_DIAGNOSTICS)break;}}catch(e){const message=String(e?.message||e);if(message&&message!==info.diagnosticsError){info.diagnosticsError=info.diagnosticsError?info.diagnosticsError+' | '+message:message;}}try{info.failedLogExcerpt=truncateText(runner(['run','view',String(runId),'--repo',repo,'--log-failed']),CI_LOG_EXCERPT_MAX_CHARS);}catch(e){const message=String(e?.message||e);if(message&&message!==info.diagnosticsError){info.diagnosticsError=info.diagnosticsError?info.diagnosticsError+' | '+message:message;}}return info;} for(const item of ciFailures){ const repo=String(item?.repo||'').trim(); const branch=String(item?.branch||'').trim(); const n=String(item?.n||'').trim(); const failedCheckNames=Array.isArray(item?.failedCheckNames)?item.failedCheckNames:[]; const url=String(item?.url||'').trim(); const title=String(item?.title||'').trim(); const prDigest=repo&&n?collectPrDigest(repo,n,{branch,title,url}):null; if(!repo||!branch){needsAgent.push({repo,number:n,branch,url,title,failedCheckNames,reason:'missing_repo_or_branch',prDigest,digestSummary:String(prDigest?.digestSummary||'')});continue;} let runs=[]; try{ const listRaw=runGh(['run','list','--repo',repo,'--branch',branch,'--json','databaseId,attempt,conclusion,status,workflowName,displayTitle,url,createdAt,updatedAt','--limit','8']); const parsedRuns=(()=>{try{return JSON.parse(listRaw||'[]')}catch{return []}})(); runs=Array.isArray(parsedRuns)?parsedRuns:[]; }catch(e){needsAgent.push({repo,number:n,branch,url,title,failedCheckNames,reason:'ci_run_listing_failed',error:String(e?.message||e),prDigest,digestSummary:String(prDigest?.digestSummary||'')});continue;} const failed=runs.find((r)=>FAIL_STATES.has(String(r?.conclusion||'').toUpperCase())); const failedRun=normalizeRun(failed); if(failedRun?.databaseId&&failedRun.attempt<=MAX_AUTO_RERUN_ATTEMPT){ try{runGh(['run','rerun',String(failedRun.databaseId),'--repo',repo]);rerunRequested++;continue;} catch(e){needsAgent.push({repo,number:n,branch,url,title,failedCheckNames,reason:'ci_rerun_failed',error:String(e?.message||e),prDigest,digestSummary:String(prDigest?.digestSummary||''),...collectCiDiagnostics(repo,failedRun,runGh)});continue;} } if(failedRun?.databaseId){needsAgent.push({repo,number:n,branch,url,title,failedCheckNames,reason:'auto_rerun_limit_reached',rerunAttempts:failedRun.attempt||0,prDigest,digestSummary:String(prDigest?.digestSummary||''),...collectCiDiagnostics(repo,failedRun,runGh)});continue;} needsAgent.push({repo,number:n,branch,url,title,failedCheckNames,reason:'no_rerunnable_failed_run_found',recentRuns:runs.map(normalizeRun).filter(Boolean).slice(0,5),prDigest,digestSummary:String(prDigest?.digestSummary||'')}); } let branchUpdated=0; for(const item of conflicts){ const repo=String(item?.repo||'').trim(); const n=String(item?.n||'').trim(); const branch=String(item?.branch||'').trim(); const base=String(item?.base||'').trim(); const mergeable=String(item?.mergeable||'').toUpperCase(); const prDigest=repo&&n?collectPrDigest(repo,n,{branch,base,url:String(item?.url||'')}):null; if(!repo||!n){needsAgent.push({...item,reason:'missing_repo_or_pr',prDigest,digestSummary:String(prDigest?.digestSummary||'')});continue;} if(mergeable==='BEHIND'){ try{ const headSha=JSON.parse(runGh(['pr','view',n,'--repo',repo,'--json','headRefOid'])).headRefOid; const apiArgs=['api','-X','PUT','repos/'+repo+'/pulls/'+n+'/update-branch','--field','expected_head_sha='+headSha]; runGh(apiArgs); branchUpdated++; }catch(e){needsAgent.push({repo,number:n,branch,base,mergeable,reason:'branch_update_failed',error:String(e?.message||e),prDigest,digestSummary:String(prDigest?.digestSummary||'')});} continue; } needsAgent.push({repo,number:n,branch,base,mergeable,reason:'merge_conflict_requires_code_resolution',prDigest,digestSummary:String(prDigest?.digestSummary||'')}); } console.log(JSON.stringify({rerunRequested,branchUpdated,ciFailureCount:ciFailures.length,conflictCount:conflicts.length,needsAgentCount:needsAgent.length,needsAgent}));" ], - "parseJson": true, "continueOnError": true, "failOnError": false, - "timeoutMs": 300000, "env": { - "WORKTREE_PATH": "{{setup-worktree.output.worktreePath}}", - "PR_BRANCH": "{{setup-worktree.output.branch}}", - "PR_NUMBER": "{{setup-worktree.output.number}}" + "BOSUN_FETCH_AND_CLASSIFY": "{{$ctx.getNodeOutput('fetch-and-classify')?.output || '{}'}}" } }, "position": { - "x": 2340, - "y": 100 + "x": 280, + "y": 750 + }, + "outputs": [ + "default" + ] + }, + { + "id": "fix-agent-needed", + "type": "condition.expression", + "label": "Needs Agent Fix?", + "config": { + "expression": "(()=>{try{const o=$ctx.getNodeOutput('programmatic-fix')?.output;return (JSON.parse(o||'{}').needsAgentCount||0)>0;}catch(e){return false;}})()" + }, + "position": { + "x": 280, + "y": 860 + }, + "outputs": [ + "default" + ] + }, + { + "id": "dispatch-fix-agent", + "type": "action.run_agent", + "label": "Dispatch Fix Agent (Fallback)", + "config": { + "prompt": "You are a Bosun PR repair fallback agent. A deterministic CLI fix pass has already run. Only work unresolved items from this JSON:\n\n{{$ctx.getNodeOutput('programmatic-fix')?.output}}\n\nEach unresolved item includes prDigest with the PR body, files, issue comments, reviews, review comments, review requests, and check summaries. Use that context first.\nFor conflict items: rebase/merge branch onto base, resolve conflicts, run tests, push with --force-with-lease if needed.\nFor CI-failure items: start from failedCheckNames, failedRun, failedJobs, failedAnnotations, and failedLogExcerpt to identify the actual failing workflow step, then apply the minimal fix, commit, and push.\nAfter successful repair remove bosun-needs-fix label.\n\nSTRICT RULES:\n- Fix only CI/conflict issues. No scope creep.\n- Do NOT merge/close/approve PRs.\n- Do NOT touch PRs that are not Bosun-created or explicitly trusted by config.", + "sdk": "auto", + "timeoutMs": 1800000, + "delegationWatchdogTimeoutMs": "{{delegationWatchdogTimeoutMs}}", + "delegationWatchdogMaxRecoveries": "{{delegationWatchdogMaxRecoveries}}", + "maxRetries": 2, + "retryDelayMs": 30000, + "continueOnError": true + }, + "position": { + "x": 280, + "y": 970 + }, + "outputs": [ + "default" + ] + }, + { + "id": "review-needed", + "type": "condition.expression", + "label": "Review Candidates?", + "config": { + "expression": "(()=>{try{const o=$ctx.getNodeOutput('fetch-and-classify')?.output;return (JSON.parse(o||'{}').readyCandidates||[]).length>0;}catch(e){return false;}})()" + }, + "position": { + "x": 600, + "y": 530 }, "outputs": [ "default" ] }, { - "id": "cleanup-worktree", + "id": "programmatic-review", "type": "action.run_command", - "label": "Cleanup Temp Worktree", + "label": "Review Gate: Programmatic Merge", "config": { "command": "node", "args": [ "-e", - "const fs=require('fs'); const wt=String(process.env.WORKTREE_PATH||'').trim(); if(!wt){console.log(JSON.stringify({cleaned:false,reason:'no_path'}));process.exit(0);} try{fs.rmSync(wt,{recursive:true,force:true});console.log(JSON.stringify({cleaned:true,path:wt}));} catch(e){console.log(JSON.stringify({cleaned:false,error:String(e?.message||e)}));}" + "const fs=require('fs'); const path=require('path'); const {execFileSync}=require('child_process'); const raw=String(process.env.BOSUN_FETCH_AND_CLASSIFY||''); const payload=(()=>{try{return JSON.parse(raw||'{}')}catch{return {}}})(); const candidates=Array.isArray(payload.readyCandidates)?payload.readyCandidates:[]; const ratio=Number('{{suspiciousDeletionRatio}}')||3; const minDel=Number('{{minDestructiveDeletions}}')||500; const labelReview=String('{{labelNeedsReview}}'||'bosun-needs-human-review'); const method=String('{{mergeMethod}}'||'merge').toLowerCase(); const merged=[]; const held=[]; const skipped=[]; function gh(args){return execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();} function normalizeList(value){if(Array.isArray(value)) return value.map((entry)=>String(entry||'').trim().toLowerCase()).filter(Boolean); return String(value||'').split(',').map((entry)=>entry.trim().toLowerCase()).filter(Boolean);} function parseBool(value,fallback){if(value===undefined||value===null||value==='') return fallback; const raw=String(value).trim().toLowerCase(); if(['1','true','yes','on'].includes(raw)) return true; if(['0','false','no','off'].includes(raw)) return false; return fallback;} function matchesCheckPattern(name,pattern){const text=String(name||'').trim().toLowerCase();const token=String(pattern||'').trim().toLowerCase();if(!text||!token)return false;if(token==='*')return true;if(!token.includes('*'))return text.includes(token);const parts=token.split('*').filter(Boolean);if(parts.length===0)return true;let cursor=0;for(const part of parts){const idx=text.indexOf(part,cursor);if(idx===-1)return false;cursor=idx+part.length;}if(!token.startsWith('*')&&!text.startsWith(parts[0]||''))return false;if(!token.endsWith('*')&&!text.endsWith(parts[parts.length-1]||''))return false;return true;} function matchesAnyPattern(name,patterns){return (Array.isArray(patterns)?patterns:[]).some((pattern)=>matchesCheckPattern(name,pattern));} function readCheckState(check){return String(check?.state||check?.conclusion||check?.bucket||'').trim().toUpperCase();} function isPassingCheckState(state,treatNeutralAsPass){if(!state)return true;if(['SUCCESS','PASS','PASSED','COMPLETED'].includes(state))return true;if(treatNeutralAsPass&&['NEUTRAL','SKIPPED'].includes(state))return true;return !['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE'].includes(state)&&!['QUEUED','IN_PROGRESS','PENDING','WAITING','REQUESTED'].includes(state);} function evaluateCheckGates(checks,policy){const normalized=(Array.isArray(checks)?checks:[]).map((check)=>({name:String(check?.name||'').trim(),state:readCheckState(check)})).filter((check)=>check.name);const considered=normalized.filter((check)=>!matchesAnyPattern(check.name,policy.ignorePatterns));let required=considered;if(policy.mode==='required-only'){required=considered.filter((check)=>matchesAnyPattern(check.name,policy.requiredPatterns));}if((Array.isArray(policy.optionalPatterns)?policy.optionalPatterns:[]).length>0){required=required.filter((check)=>!matchesAnyPattern(check.name,policy.optionalPatterns));}const missingRequired=policy.requireAnyRequiredCheck&&required.length===0;const hasFailure=required.some((check)=>['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE'].includes(check.state));const hasPending=policy.treatPendingRequiredAsBlocking&&required.some((check)=>['QUEUED','IN_PROGRESS','PENDING','WAITING','REQUESTED'].includes(check.state));return {hasFailure,hasPending,missingRequired,noConsideredChecks:considered.length===0,isReady:!missingRequired&&!hasFailure&&!hasPending&&required.every((check)=>isPassingCheckState(check.state,policy.treatNeutralAsPass))};} function configPath(){const home=String(process.env.BOSUN_HOME||process.env.BOSUN_PROJECT_DIR||'').trim();return home?path.join(home,'bosun.config.json'):path.join(process.cwd(),'bosun.config.json');} function readBosunConfig(){try{return JSON.parse(fs.readFileSync(configPath(),'utf8'));}catch{return {};}} const BOSUN_CONFIG=readBosunConfig(); const CHECK_GATES=(BOSUN_CONFIG&&typeof BOSUN_CONFIG.gates==='object'&&BOSUN_CONFIG.gates&&typeof BOSUN_CONFIG.gates.checks==='object')?BOSUN_CONFIG.gates.checks:{}; const CHECK_MODE=((String(CHECK_GATES?.mode||'all').trim().toLowerCase())||'all'); const REQUIRED_CHECK_PATTERNS=normalizeList(CHECK_GATES?.requiredPatterns); const OPTIONAL_CHECK_PATTERNS=normalizeList(CHECK_GATES?.optionalPatterns); const IGNORE_CHECK_PATTERNS=normalizeList(CHECK_GATES?.ignorePatterns); const REQUIRE_ANY_REQUIRED_CHECK=parseBool(CHECK_GATES?.requireAnyRequiredCheck, true); const TREAT_PENDING_REQUIRED_AS_BLOCKING=parseBool(CHECK_GATES?.treatPendingRequiredAsBlocking, true); const TREAT_NEUTRAL_AS_PASS=parseBool(CHECK_GATES?.treatNeutralAsPass, false); for(const c of candidates){ const repo=String(c?.repo||'').trim(); const n=String(c?.n||'').trim(); if(!repo||!n){skipped.push({repo,number:n,reason:'missing_repo_or_pr'});continue;} try{ const viewRaw=gh(['pr','view',n,'--repo',repo,'--json','number,title,additions,deletions,changedFiles,isDraft']); const view=(()=>{try{return JSON.parse(viewRaw||'{}')}catch{return {}}})(); if(view?.isDraft===true){skipped.push({repo,number:n,reason:'draft'});continue;} const add=Number(view?.additions||0); const del=Number(view?.deletions||0); const changed=Number(view?.changedFiles||0); const destructive=(del>(add*ratio))&&(del>minDel); const tooWide=changed>250; if(destructive||tooWide){ gh(['pr','edit',n,'--repo',repo,'--add-label',labelReview]); gh(['pr','comment',n,'--repo',repo,'--body',':warning: Bosun held this PR for human review due to suspicious diff footprint.']); held.push({repo,number:n,reason:destructive?'destructive_diff':'changed_files_too_large',additions:add,deletions:del,changedFiles:changed}); continue; } const checksRaw=gh(['pr','checks',n,'--repo',repo,'--json','name,state,bucket']); const checks=(()=>{try{return JSON.parse(checksRaw||'[]')}catch{return []}})(); const gateVerdict=evaluateCheckGates(checks,{mode:CHECK_MODE,requiredPatterns:REQUIRED_CHECK_PATTERNS,optionalPatterns:OPTIONAL_CHECK_PATTERNS,ignorePatterns:IGNORE_CHECK_PATTERNS,requireAnyRequiredCheck:REQUIRE_ANY_REQUIRED_CHECK,treatPendingRequiredAsBlocking:TREAT_PENDING_REQUIRED_AS_BLOCKING,treatNeutralAsPass:TREAT_NEUTRAL_AS_PASS}); if(gateVerdict.hasFailure){skipped.push({repo,number:n,reason:'ci_failed'});continue;} if(gateVerdict.hasPending){skipped.push({repo,number:n,reason:'ci_pending'});continue;} if(gateVerdict.missingRequired){skipped.push({repo,number:n,reason:'no_required_checks'});continue;} if(gateVerdict.noConsideredChecks){skipped.push({repo,number:n,reason:'no_checks_yet'});continue;} const doApplySuggestions=String('{{autoApplySuggestions}}'||'true')==='true'&&process.env.BOSUN_AUTO_APPLY_SUGGESTIONS!=='false'; if(doApplySuggestions){ try{ const toolPath=require('path').resolve(process.cwd(),'tools','apply-pr-suggestions.mjs'); if(require('fs').existsSync(toolPath)){ const sugOut=execFileSync('node',[toolPath,'--owner',repo.split('/')[0],'--repo',repo.split('/')[1],n,'--json'],{encoding:'utf8',timeout:60000,stdio:['pipe','pipe','pipe']}); const sugRes=(()=>{try{return JSON.parse(sugOut)}catch{return null}})(); if(sugRes?.commitSha){console.error('[watchdog] auto-applied '+sugRes.applied+' suggestion(s) on PR #'+n+' → '+sugRes.commitSha.slice(0,8));skipped.push({repo,number:n,reason:'suggestions_applied_awaiting_ci'});continue;} } }catch(sugErr){console.error('[watchdog] suggestion auto-apply skipped for PR #'+n+': '+String(sugErr?.message||sugErr).slice(0,120));} } const mergeArgs=['pr','merge',n,'--repo',repo,'--delete-branch']; if(method==='rebase') mergeArgs.push('--rebase'); else if(method==='merge') mergeArgs.push('--merge'); else mergeArgs.push('--squash'); try{gh(mergeArgs);}catch(directErr){ mergeArgs.push('--auto'); gh(mergeArgs); } merged.push({repo,number:n,title:String(view?.title||'')}); }catch(e){ held.push({repo,number:n,reason:'merge_attempt_failed',error:String(e?.message||e)}); } } console.log(JSON.stringify({mergedCount:merged.length,heldCount:held.length,skippedCount:skipped.length,merged,held,skipped}));" ], "continueOnError": true, "failOnError": false, "env": { - "WORKTREE_PATH": "{{setup-worktree.output.worktreePath}}" + "BOSUN_FETCH_AND_CLASSIFY": "{{$ctx.getNodeOutput('fetch-and-classify')?.output || '{}'}}" } }, "position": { - "x": 2620, - "y": 100 + "x": 600, + "y": 700 }, "outputs": [ "default" ] }, { - "id": "release-claim", + "id": "notify", + "type": "notify.log", + "label": "Watchdog Report", + "config": { + "message": "Bosun PR Watchdog cycle complete — see live digest/status board for streaming updates", + "level": "info" + }, + "position": { + "x": 400, + "y": 900 + }, + "outputs": [ + "default" + ] + }, + { + "id": "no-prs", + "type": "notify.log", + "label": "No Bosun PRs Open", + "config": { + "message": "Bosun PR Watchdog: no open automation-eligible PRs found — idle", + "level": "info" + }, + "position": { + "x": 700, + "y": 370 + }, + "outputs": [ + "default" + ] + }, + { + "id": "cleanup-merged-branches", "type": "action.run_command", - "label": "Release Security PR Claim", + "label": "Prune Merged Branches", "config": { "command": "node", "args": [ "-e", - "const fs=require('fs'); const path=require('path'); const claimKey=String(process.env.PR_CLAIM_KEY||'').trim(); if(!claimKey){console.log(JSON.stringify({released:false,reason:'no_claim_key'}));process.exit(0);} const CLAIM_FILE=path.join(process.cwd(),'.cache','bosun','pr-security-fix-claims.json'); try{ if(!fs.existsSync(CLAIM_FILE)){console.log(JSON.stringify({released:false,reason:'no_claim_file'}));process.exit(0);} const data=JSON.parse(fs.readFileSync(CLAIM_FILE,'utf8')); if(data.claims&&data.claims[claimKey]){ delete data.claims[claimKey]; data.updatedAt=new Date().toISOString(); fs.writeFileSync(CLAIM_FILE,JSON.stringify(data,null,2),'utf8'); console.log(JSON.stringify({released:true,claimKey})); }else{ console.log(JSON.stringify({released:false,reason:'not_found',claimKey})); } }catch(e){ console.log(JSON.stringify({released:false,reason:'error',error:String(e?.message||e),claimKey})); }" + "const {execFileSync}=require('child_process'); function gh(a){return execFileSync('gh',a,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();} const repos=String(process.env.BOSUN_REPO_LIST||'').split(',').map(s=>s.trim()).filter(Boolean); let deleted=0; for(const repo of repos){ try{ const raw=gh(['pr','list','--repo',repo,'--state','merged','--json','number,headRefName,labels','--limit','50']); const prs=(()=>{try{return JSON.parse(raw||'[]')}catch{return []}})(); for(const pr of prs){ const labels=Array.isArray(pr?.labels)?pr.labels.map((entry)=>typeof entry==='string'?entry:entry?.name).filter(Boolean):[]; if(!labels.includes('bosun-pr-bosun-created')) continue; const branch=String(pr?.headRefName||'').trim(); if(!branch||branch==='main'||branch==='master')continue; try{gh(['api','repos/'+repo+'/git/refs/heads/'+branch,'--method','DELETE','--silent']);deleted++;}catch(e){} } }catch(e){} } console.log(JSON.stringify({deletedBranches:deleted}));" ], "continueOnError": true, "failOnError": false, "env": { - "PR_CLAIM_KEY": "{{claimKey}}" + "BOSUN_REPO_LIST": "{{$ctx.getNodeOutput('fetch-and-classify')?.output ? (()=>{try{const o=JSON.parse($ctx.getNodeOutput('fetch-and-classify').output);return [...new Set([...(o.fixCandidates||[]),...(o.readyCandidates||[])].map(c=>c.repo).filter(Boolean))].join(',')}catch{return ''}})() : ''}}" } }, "position": { - "x": 2900, - "y": 100 + "x": 400, + "y": 1020 }, "outputs": [ "default" @@ -27952,99 +21373,213 @@ ], "edges": [ { - "id": "trigger->setup-task", + "id": "trigger->fetch-and-classify", "source": "trigger", - "target": "setup-task", + "target": "fetch-and-classify", "sourcePort": "default" }, { - "id": "setup-task->setup-title", - "source": "setup-task", - "target": "setup-title", + "id": "fetch-and-classify->has-prs", + "source": "fetch-and-classify", + "target": "has-prs", "sourcePort": "default" }, { - "id": "setup-title->setup-claim-key", - "source": "setup-title", - "target": "setup-claim-key", - "sourcePort": "default" + "id": "has-prs->has-behind", + "source": "has-prs", + "target": "has-behind", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "has-prs->no-prs", + "source": "has-prs", + "target": "no-prs", + "sourcePort": "default", + "condition": "$output?.result !== true" + }, + { + "id": "has-prs->review-needed", + "source": "has-prs", + "target": "review-needed", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "has-behind->update-behind-branches", + "source": "has-behind", + "target": "update-behind-branches", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "has-behind->fix-needed", + "source": "has-behind", + "target": "fix-needed", + "sourcePort": "no", + "condition": "$output?.result !== true" }, { - "id": "setup-claim-key->setup-worktree", - "source": "setup-claim-key", - "target": "setup-worktree", + "id": "update-behind-branches->fix-needed", + "source": "update-behind-branches", + "target": "fix-needed", "sourcePort": "default" }, { - "id": "setup-worktree->set-worktree-path", - "source": "setup-worktree", - "target": "set-worktree-path", + "id": "fix-needed->security-fix-needed", + "source": "fix-needed", + "target": "security-fix-needed", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "fix-needed->review-needed", + "source": "fix-needed", + "target": "review-needed", + "sourcePort": "default", + "condition": "$output?.result !== true" + }, + { + "id": "security-fix-needed->programmatic-security-fix", + "source": "security-fix-needed", + "target": "programmatic-security-fix", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "security-fix-needed->generic-fix-needed", + "source": "security-fix-needed", + "target": "generic-fix-needed", + "sourcePort": "default", + "condition": "$output?.result !== true" + }, + { + "id": "programmatic-security-fix->security-agent-needed", + "source": "programmatic-security-fix", + "target": "security-agent-needed", "sourcePort": "default" }, { - "id": "set-worktree-path->setup-prompt", - "source": "set-worktree-path", - "target": "setup-prompt", + "id": "security-agent-needed->dispatch-security-fix-agent", + "source": "security-agent-needed", + "target": "dispatch-security-fix-agent", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "security-agent-needed->generic-fix-needed", + "source": "security-agent-needed", + "target": "generic-fix-needed", + "sourcePort": "default", + "condition": "$output?.result !== true" + }, + { + "id": "dispatch-security-fix-agent->generic-fix-needed", + "source": "dispatch-security-fix-agent", + "target": "generic-fix-needed", "sourcePort": "default" }, { - "id": "setup-prompt->fix-agent", - "source": "setup-prompt", - "target": "fix-agent", + "id": "generic-fix-needed->programmatic-fix", + "source": "generic-fix-needed", + "target": "programmatic-fix", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "generic-fix-needed->review-needed", + "source": "generic-fix-needed", + "target": "review-needed", + "sourcePort": "default", + "condition": "$output?.result !== true" + }, + { + "id": "programmatic-fix->fix-agent-needed", + "source": "programmatic-fix", + "target": "fix-agent-needed", "sourcePort": "default" }, { - "id": "fix-agent->push-fixes", - "source": "fix-agent", - "target": "push-fixes", + "id": "fix-agent-needed->dispatch-fix-agent", + "source": "fix-agent-needed", + "target": "dispatch-fix-agent", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "fix-agent-needed->review-needed", + "source": "fix-agent-needed", + "target": "review-needed", + "sourcePort": "default", + "condition": "$output?.result !== true" + }, + { + "id": "dispatch-fix-agent->review-needed", + "source": "dispatch-fix-agent", + "target": "review-needed", "sourcePort": "default" }, { - "id": "push-fixes->cleanup-worktree", - "source": "push-fixes", - "target": "cleanup-worktree", + "id": "review-needed->programmatic-review", + "source": "review-needed", + "target": "programmatic-review", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "review-needed->notify", + "source": "review-needed", + "target": "notify", + "sourcePort": "default", + "condition": "$output?.result !== true" + }, + { + "id": "programmatic-review->notify", + "source": "programmatic-review", + "target": "notify", "sourcePort": "default" }, { - "id": "cleanup-worktree->release-claim", - "source": "cleanup-worktree", - "target": "release-claim", + "id": "notify->cleanup-merged-branches", + "source": "notify", + "target": "cleanup-merged-branches", "sourcePort": "default" } ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-09T12:00:00.000Z", - "updatedAt": "2026-03-09T12:00:00.000Z", + "createdAt": "2026-03-02T12:00:00.000Z", + "updatedAt": "2026-03-02T12:00:00.000Z", "templateState": { - "templateId": "template-pr-security-fix-single", - "templateName": "PR Security Fix Agent (Single PR)", - "templateVersion": "2.0.0", - "installedTemplateVersion": "2.0.0", + "templateId": "template-bosun-pr-watchdog", + "templateName": "Bosun PR Watchdog", + "templateVersion": "2.3.0", + "installedTemplateVersion": "2.3.0", "isCustomized": false, "updateAvailable": false } } }, { - "id": "wf-pr-triage", - "name": "PR Triage & Labels", - "description": "Automatically triage incoming PRs: classify by size, detect breaking changes, add labels, and assign reviewers based on CODEOWNERS.", + "id": "wf-github-kanban-sync", + "name": "GitHub ↔ Kanban Sync", + "description": "Reconciles GitHub PR state with the bosun kanban board every 5 minutes. Marks tasks as in-review when Bosun-created PRs open, moves them to done when PRs are merged, and posts completion comments via the kanban API. Replaces the legacy github-reconciler.mjs module.", "category": "github", "enabled": true, - "nodeCount": 10, - "trigger": "trigger.pr_event", + "nodeCount": 8, + "trigger": "trigger.schedule", "variables": { - "smallThreshold": 50, - "largeThreshold": 500 + "lookbackHours": 24, + "repoScope": "auto" }, "nodes": [ { "id": "trigger", - "type": "trigger.pr_event", - "label": "PR Opened", + "type": "trigger.schedule", + "label": "Sync Every 5 min", "config": { - "event": "opened" + "intervalMs": 300000, + "cron": "*/5 * * * *" }, "position": { "x": 400, @@ -28055,145 +21590,124 @@ ] }, { - "id": "get-stats", + "id": "fetch-pr-state", "type": "action.run_command", - "label": "Get PR Stats", + "label": "Fetch Bosun PR State", "config": { - "command": "gh pr view {{prNumber}} --json additions,deletions,files,labels,title,body" + "command": "node", + "args": [ + "-e", + "const fs=require('fs'); const path=require('path'); const {execFileSync}=require('child_process'); const hours=Number('{{lookbackHours}}')||24; const repoScope=String('{{repoScope}}'||'auto').trim(); const since=new Date(Date.now()-hours*3600000).toISOString(); function ghJson(args){ try{const o=execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();return o?JSON.parse(o):[];} catch{return [];} } function configPath(){ const home=String(process.env.BOSUN_HOME||process.env.BOSUN_PROJECT_DIR||'').trim(); return home?path.join(home,'bosun.config.json'):path.join(process.cwd(),'bosun.config.json'); } function collectReposFromConfig(){ const repos=[]; try{ const cfg=JSON.parse(fs.readFileSync(configPath(),'utf8')); const workspaces=Array.isArray(cfg?.workspaces)?cfg.workspaces:[]; if(workspaces.length>0){ const active=String(cfg?.activeWorkspace||'').trim().toLowerCase(); const activeWs=active?workspaces.find(w=>String(w?.id||'').trim().toLowerCase()===active):null; const wsList=activeWs?[activeWs]:workspaces; for(const ws of wsList){ for(const repo of (Array.isArray(ws?.repos)?ws.repos:[])){ const slug=typeof repo==='string'?String(repo).trim():String(repo?.slug||'').trim(); if(slug) repos.push(slug); } } } if(repos.length===0){ for(const repo of (Array.isArray(cfg?.repos)?cfg.repos:[])){ const slug=typeof repo==='string'?String(repo).trim():String(repo?.slug||'').trim(); if(slug) repos.push(slug); } } }catch{} return repos; } function resolveRepoTargets(){ if(repoScope&&repoScope!=='auto'&&repoScope!=='all'&&repoScope!=='current'){ return [...new Set(repoScope.split(',').map(v=>v.trim()).filter(Boolean))]; } if(repoScope==='current') return ['']; const fromConfig=collectReposFromConfig(); if(fromConfig.length>0) return [...new Set(fromConfig)]; const envRepo=String(process.env.GITHUB_REPOSITORY||'').trim(); if(envRepo) return [envRepo]; return ['']; } function parseRepoFromUrl(url){ const raw=String(url||''); const marker='github.com/'; const idx=raw.toLowerCase().indexOf(marker); if(idx<0) return ''; const tail=raw.slice(idx+marker.length).split('/'); if(tail.length<2) return ''; const owner=String(tail[0]||'').trim(); const repo=String(tail[1]||'').trim(); return owner&&repo?(owner+'/'+repo):''; } function extractTaskId(pr){ const src=String((pr.body||'')+'\\n'+(pr.title||'')); const m=src.match(/(?:Bosun-Task|VE-Task|Task-ID|task[_-]?id)[:\\s]+([a-zA-Z0-9_-]{4,64})/i); return m?m[1].trim():null; } function shouldSyncTaskPr(pr){ return Boolean(extractTaskId(pr)); } const repoTargets=resolveRepoTargets(); const merged=[]; const open=[]; for(const target of repoTargets){ const repo=String(target||'').trim(); const mergedArgs=['pr','list','--state','merged','--json','number,title,body,headRefName,mergedAt,url','--limit','50']; const openArgs=['pr','list','--state','open','--json','number,title,body,headRefName,isDraft,url','--limit','50']; if(repo){ mergedArgs.push('--repo',repo); openArgs.push('--repo',repo); } for(const pr of ghJson(mergedArgs)){ if(shouldSyncTaskPr(pr)) merged.push({...pr,__repo:repo||parseRepoFromUrl(pr?.url)||String(process.env.GITHUB_REPOSITORY||'').trim()}); } for(const pr of ghJson(openArgs)){ if(shouldSyncTaskPr(pr)) open.push({...pr,__repo:repo||parseRepoFromUrl(pr?.url)||String(process.env.GITHUB_REPOSITORY||'').trim()}); } } const recentMerged=merged.filter(p=>!p.mergedAt||new Date(p.mergedAt)>=new Date(since)); console.log(JSON.stringify({ repoScope, reposScanned: repoTargets.length, merged:recentMerged.map(p=>({n:p.number,repo:p.__repo||'',title:p.title,branch:p.headRefName,taskId:extractTaskId(p)})), open:open.filter(p=>!p.isDraft).map(p=>({n:p.number,repo:p.__repo||'',title:p.title,branch:p.headRefName,taskId:extractTaskId(p)})), }));" + ], + "continueOnError": true }, "position": { "x": 400, - "y": 180 + "y": 200 }, "outputs": [ "default" ] }, { - "id": "classify-size", - "type": "condition.switch", - "label": "Classify Size", + "id": "has-updates", + "type": "condition.expression", + "label": "Any Updates?", "config": { - "value": "(() => { const raw = $ctx.getNodeOutput('get-stats')?.output || '{}'; let stats = {}; try { stats = typeof raw === 'string' ? JSON.parse(raw) : raw; } catch { stats = {}; } const delta = Number(stats?.additions || 0) + Number(stats?.deletions || 0); const small = Number($data?.smallThreshold || 50); const large = Number($data?.largeThreshold || 500); if (delta < small) return 'small'; if (delta > large) return 'large'; return 'medium'; })()", - "cases": { - "small": "small", - "medium": "medium", - "large": "large" - } + "expression": "(()=>{try{const o=$ctx.getNodeOutput('fetch-pr-state')?.output;const d=JSON.parse(o||'{}');return (d.merged||[]).length>0||(d.open||[]).length>0;}catch{return false;}})()" }, "position": { "x": 400, - "y": 330 - }, - "outputs": [ - "small", - "medium", - "large", - "default" - ] - }, - { - "id": "label-small", - "type": "action.run_command", - "label": "Label: Size/S", - "config": { - "command": "gh pr edit {{prNumber}} --add-label \"size/S\"" - }, - "position": { - "x": 150, - "y": 480 + "y": 370 }, "outputs": [ "default" ] }, { - "id": "label-medium", + "id": "sync-programmatic", "type": "action.run_command", - "label": "Label: Size/M", + "label": "Sync PR State → Kanban (Programmatic)", "config": { - "command": "gh pr edit {{prNumber}} --add-label \"size/M\"" + "command": "node", + "args": [ + "-e", + "const {execFileSync}=require('child_process'); const fs=require('fs'); const raw=String(process.env.BOSUN_FETCH_PR_STATE||''); const data=(()=>{try{return JSON.parse(raw||'{}')}catch{return {}}})(); const merged=Array.isArray(data.merged)?data.merged:[]; const open=Array.isArray(data.open)?data.open:[]; const updates=[]; const unresolved=[]; const maxBuffer=25*1024*1024; const cliPath=fs.existsSync('cli.mjs')?'cli.mjs':''; const taskCli=['task/task-cli.mjs','task-cli.mjs'].find(p=>fs.existsSync(p))||''; const taskRunner=cliPath?'cli':(taskCli?'task-cli':''); if(!taskRunner){ console.log(JSON.stringify({updated:0,unresolved:[{reason:'task_command_missing'}],needsAgent:true})); process.exit(0); } function runTask(args){const cmdArgs=taskRunner==='cli'?['cli.mjs','task',...args,'--config-dir','.bosun','--repo-root','.']:[taskCli,...args];return execFileSync('node',cmdArgs,{encoding:'utf8',stdio:['pipe','pipe','pipe'],maxBuffer}).trim();} function parseJsonObject(raw){const txt=String(raw||'').trim();if(!txt)return null;try{return JSON.parse(txt);}catch{}const lines=txt.split(/\\r?\\n/);for(let start=0;starts.trim()).filter(Boolean);for(let i=compact.length-1;i>=0;i--){const line=compact[i];if(!(line.startsWith('{')||line.startsWith('[')))continue;try{return JSON.parse(line);}catch{}}const start=txt.indexOf('{');const end=txt.lastIndexOf('}');if(start>=0&&end>start){try{return JSON.parse(txt.slice(start,end+1));}catch{}}return null;} let taskListCache=null; function normalizeRepo(value){return String(value||'').trim().toLowerCase();} function listTasks(){ if(Array.isArray(taskListCache)) return taskListCache; try{const raw=runTask(['list','--json']);const tasks=parseJsonObject(raw);taskListCache=Array.isArray(tasks)?tasks:[];return taskListCache;}catch{taskListCache=[];return taskListCache;} } function resolveTaskId(item){ const explicit=String(item?.taskId||'').trim(); if(explicit) return explicit; const branch=String(item?.branch||'').trim(); if(!branch) return ''; const repo=normalizeRepo(item?.repo); const matches=listTasks().filter((task)=>{ const taskBranch=String(task?.branchName||'').trim(); if(taskBranch!==branch) return false; const taskRepo=normalizeRepo(task?.repository||''); if(!repo || !taskRepo) return true; return taskRepo===repo; }); if(matches.length===1) return String(matches[0]?.id||'').trim(); const exactRepo=matches.find((task)=>normalizeRepo(task?.repository||'')===repo); return exactRepo?String(exactRepo?.id||'').trim():''; } function getTaskSnapshot(id){ try{const raw=runTask(['get',id,'--json']);const task=parseJsonObject(raw);return {status:task?.status||null,reviewStatus:task?.reviewStatus||null};}catch{return {status:null,reviewStatus:null};} } for(const item of merged){ const id=resolveTaskId(item); if(!id){unresolved.push({taskId:null,repo:String(item?.repo||''),branch:String(item?.branch||''),status:'done',reason:'task_lookup_failed'});continue;} try{runTask(['update',id,'--status','done']);updates.push({taskId:id,status:'done'});}catch(e){unresolved.push({taskId:id,status:'done',error:String(e?.message||e)});} } for(const item of open){ const id=resolveTaskId(item); if(!id){unresolved.push({taskId:null,repo:String(item?.repo||''),branch:String(item?.branch||''),status:'inreview',reason:'task_lookup_failed'});continue;} try{const snap=getTaskSnapshot(id);const current=String(snap?.status||'').trim().toLowerCase();const review=String(snap?.reviewStatus||'').toLowerCase();if(current==='inreview'||current==='done'){updates.push({taskId:id,status:current,skipped:true});continue;}runTask(['update',id,'--status','inreview']);updates.push({taskId:id,status:'inreview',fromStatus:current||null,reviewStatus:review||null});}catch(e){unresolved.push({taskId:id,status:'inreview',error:String(e?.message||e)});} } const actionableUnresolved=unresolved.filter((item)=>String(item?.taskId||'').trim()); console.log(JSON.stringify({updated:updates.length,updates,unresolved,needsAgent:actionableUnresolved.length>0}));" + ], + "continueOnError": true, + "failOnError": false, + "env": { + "BOSUN_FETCH_PR_STATE": "{{$ctx.getNodeOutput('fetch-pr-state')?.output || '{}'}}" + } }, "position": { "x": 400, - "y": 480 - }, - "outputs": [ - "default" - ] - }, - { - "id": "label-large", - "type": "action.run_command", - "label": "Label: Size/L", - "config": { - "command": "gh pr edit {{prNumber}} --add-label \"size/L\"" - }, - "position": { - "x": 650, - "y": 480 + "y": 530 }, "outputs": [ "default" ] }, { - "id": "detect-breaking", + "id": "sync-agent-needed", "type": "condition.expression", - "label": "Detect Breaking Changes", + "label": "Needs Agent Sync?", "config": { - "expression": "/* */ (() => { const raw=$ctx.getNodeOutput('get-stats')?.output||'{}'; let stats={}; try{stats=typeof raw==='string'?JSON.parse(raw):raw;}catch{return false;} const title=String(stats?.title||'').toLowerCase(); const body=String(stats?.body||'').toLowerCase(); const files=Array.isArray(stats?.files)?stats.files.map((f)=>String(f?.path||f?.filename||f||'').toLowerCase()):[]; const text=title+'\\n'+body; const explicit=/\\bbreaking\\b|\\bbreaking change\\b|\\bmajor\\b|\\bbackward incompatible\\b/.test(text); const apiTouch=files.some((f)=>f.includes('api/')||f.includes('/proto/')||f.includes('openapi')||f.includes('schema')); const contractWords=/\\bremove\\b|\\brename\\b|\\bdeprecate\\b|\\bdrop\\b/.test(text); return explicit || (apiTouch && contractWords);})()" + "expression": "(()=>{try{const raw=$ctx.getNodeOutput('sync-programmatic')?.output||'{}';const d=JSON.parse(raw);const actionable=Array.isArray(d?.unresolved)?d.unresolved.some((item)=>String(item?.taskId||'').trim()):false;return d?.needsAgent===true || actionable;}catch{return true;}})()" }, "position": { "x": 400, - "y": 630 + "y": 615 }, "outputs": [ "default" ] }, { - "id": "is-breaking", - "type": "condition.expression", - "label": "Breaking?", + "id": "sync-agent", + "type": "action.run_agent", + "label": "Sync PR State → Kanban (Fallback)", "config": { - "expression": "(() => { return $ctx.getNodeOutput('detect-breaking')?.result === true; })()" + "prompt": "You are the Bosun GitHub-Kanban sync fallback agent. A deterministic sync pass already ran.\n\nProgrammatic sync output:\n{{$ctx.getNodeOutput('sync-programmatic')?.output}}\n\nNow complete only unresolved updates.\n\nGitHub PR state:\nPR state (JSON from fetch-pr-state node output):\n{{$ctx.getNodeOutput('fetch-pr-state')?.output}}\n\nRULES:\n1. For each MERGED PR entry with a taskId: update the kanban task to done.\n Use the available bosun CLI, for example:\n node task/task-cli.mjs update --status done\n Or inspect available commands with a shell-native file listing.\n2. For each OPEN (non-draft) PR entry with a taskId: if the task is not\n already in inreview or done status, update it to inreview.\n3. Only act on entries that have a non-null taskId.\n4. Log each update and whether it succeeded.\n5. Do NOT close, merge, or modify any PR.\n6. Do NOT create new tasks — only update existing ones.", + "sdk": "auto", + "timeoutMs": 300000, + "continueOnError": true }, "position": { "x": 400, - "y": 780 + "y": 700 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "label-breaking", - "type": "action.run_command", - "label": "Label: Breaking", + "id": "done", + "type": "notify.log", + "label": "Sync Complete", "config": { - "command": "gh pr edit {{prNumber}} --add-label \"breaking-change\"" + "message": "GitHub ↔ Kanban sync cycle complete", + "level": "info" }, "position": { - "x": 200, - "y": 920 + "x": 400, + "y": 700 }, "outputs": [ "default" ] }, { - "id": "done", + "id": "skip", "type": "notify.log", - "label": "Triage Complete", + "label": "No PR Updates", "config": { - "message": "PR #{{prNumber}} triage workflow completed", - "level": "info" + "message": "No bosun PR changes to sync this cycle", + "level": "debug" }, "position": { - "x": 400, - "y": 1050 + "x": 650, + "y": 450 }, "outputs": [ "default" @@ -28202,87 +21716,65 @@ ], "edges": [ { - "id": "trigger->get-stats", + "id": "trigger->fetch-pr-state", "source": "trigger", - "target": "get-stats", - "sourcePort": "default" - }, - { - "id": "get-stats->classify-size", - "source": "get-stats", - "target": "classify-size", + "target": "fetch-pr-state", "sourcePort": "default" }, { - "id": "classify-size->label-small", - "source": "classify-size", - "target": "label-small", - "sourcePort": "small" - }, - { - "id": "classify-size->label-medium", - "source": "classify-size", - "target": "label-medium", - "sourcePort": "medium" - }, - { - "id": "classify-size->label-large", - "source": "classify-size", - "target": "label-large", - "sourcePort": "large" - }, - { - "id": "label-small->detect-breaking", - "source": "label-small", - "target": "detect-breaking", + "id": "fetch-pr-state->has-updates", + "source": "fetch-pr-state", + "target": "has-updates", "sourcePort": "default" }, { - "id": "label-medium->detect-breaking", - "source": "label-medium", - "target": "detect-breaking", - "sourcePort": "default" + "id": "has-updates->sync-programmatic", + "source": "has-updates", + "target": "sync-programmatic", + "sourcePort": "default", + "condition": "$output?.result === true" }, { - "id": "label-large->detect-breaking", - "source": "label-large", - "target": "detect-breaking", - "sourcePort": "default" + "id": "has-updates->skip", + "source": "has-updates", + "target": "skip", + "sourcePort": "default", + "condition": "$output?.result !== true" }, { - "id": "detect-breaking->is-breaking", - "source": "detect-breaking", - "target": "is-breaking", + "id": "sync-programmatic->sync-agent-needed", + "source": "sync-programmatic", + "target": "sync-agent-needed", "sourcePort": "default" }, { - "id": "is-breaking->label-breaking", - "source": "is-breaking", - "target": "label-breaking", - "sourcePort": "yes", + "id": "sync-agent-needed->sync-agent", + "source": "sync-agent-needed", + "target": "sync-agent", + "sourcePort": "default", "condition": "$output?.result === true" }, { - "id": "is-breaking->done", - "source": "is-breaking", + "id": "sync-agent-needed->done", + "source": "sync-agent-needed", "target": "done", - "sourcePort": "no", + "sourcePort": "default", "condition": "$output?.result !== true" }, { - "id": "label-breaking->done", - "source": "label-breaking", + "id": "sync-agent->done", + "source": "sync-agent", "target": "done", "sourcePort": "default" } ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-10T12:00:00.000Z", - "updatedAt": "2026-03-10T12:00:00.000Z", + "createdAt": "2026-03-03T12:00:00.000Z", + "updatedAt": "2026-03-03T12:00:00.000Z", "templateState": { - "templateId": "template-pr-triage", - "templateName": "PR Triage & Labels", + "templateId": "template-github-kanban-sync", + "templateName": "GitHub ↔ Kanban Sync", "templateVersion": "1.0.0", "installedTemplateVersion": "1.0.0", "isCustomized": false, @@ -28291,24 +21783,26 @@ } }, { - "id": "wf-release-drafter", - "name": "Release Drafter", - "description": "Automatically generates release notes from merged PRs since the last tag. Groups changes by conventional commit type (features, fixes, refactors, etc.) and drafts a GitHub release.", + "id": "wf-pr-conflict-resolver", + "name": "PR Conflict Resolver", + "description": ":alert: SUPERSEDED for bosun-managed repos — use the Bosun PR Watchdog (template-bosun-pr-watchdog) instead. The Watchdog consolidates conflict resolution, CI-failure repair, diff-safety review, and merge into one cycle with a single gh API call and a mandatory review gate before any merge. This template is kept for repos that do not use the assistive bosun-attached label convention. It only touches Bosun-created PRs and never auto-merges directly — it resolves conflicts and then defers to the Watchdog's review gate for the actual merge decision.", "category": "github", - "enabled": true, - "nodeCount": 7, - "trigger": "trigger.manual", + "enabled": false, + "nodeCount": 11, + "trigger": "trigger.schedule", "variables": { - "baseBranch": "main", - "releasePrefix": "v" + "checkIntervalMs": 1800000, + "maxConcurrentFixes": 3, + "maxRetries": 3 }, "nodes": [ { "id": "trigger", - "type": "trigger.manual", - "label": "Draft Release Notes", + "type": "trigger.schedule", + "label": "Check Every 30min", "config": { - "description": "Generate release notes from merged PRs" + "intervalMs": "{{checkIntervalMs}}", + "cron": "*/30 * * * *" }, "position": { "x": 400, @@ -28318,254 +21812,167 @@ "default" ] }, - { - "id": "get-last-tag", - "type": "action.run_command", - "label": "Get Last Tag", - "config": { - "command": "git describe --tags --abbrev=0 2>/dev/null || echo '{{releasePrefix}}0.0.0'" - }, - "position": { - "x": 400, - "y": 180 - }, - "outputs": [ - "default" - ] - }, { "id": "list-prs", "type": "action.run_command", - "label": "List Merged PRs", - "config": { - "command": "gh pr list --state merged --base {{baseBranch}} --json number,title,labels,author,mergedAt --limit 100", - "continueOnError": true - }, - "position": { - "x": 400, - "y": 310 - }, - "outputs": [ - "default" - ] - }, - { - "id": "get-commits", - "type": "action.run_command", - "label": "Get Commit Log", - "config": { - "command": "git log $(git describe --tags --abbrev=0 2>/dev/null || echo HEAD~50)..HEAD --oneline --no-merges" - }, - "position": { - "x": 400, - "y": 440 - }, - "outputs": [ - "default" - ] - }, - { - "id": "draft-notes", - "type": "action.run_agent", - "label": "Draft Release Notes", + "label": "List Bosun-Created Conflicting PRs", "config": { - "prompt": "# Generate Release Notes\n\n## Merged PRs (JSON)\n{{prList}}\n\n## Commit Log\n{{commitLog}}\n\n## Last Tag\n{{lastTag}}\n\nGenerate professional release notes in the following format:\n\n# What's Changed\n\n## :rocket: Features\n- [list feat: commits with PR references]\n\n## :bug: Bug Fixes\n- [list fix: commits with PR references]\n\n## :settings: Improvements\n- [list refactor/perf/style commits]\n\n## :u1f4da: Documentation\n- [list docs: commits]\n\n## :hammer: Internal\n- [list chore/ci/build commits]\n\nOmit empty sections. Include contributor attribution. Be concise.", - "sdk": "auto", - "timeoutMs": 600000 + "command": "gh pr list --state open --json number,title,body,headRefName,baseRefName,mergeable,labels --limit {{maxConcurrentFixes}}" }, "position": { "x": 400, - "y": 590 + "y": 180 }, "outputs": [ "default" ] }, { - "id": "save-draft", - "type": "action.write_file", - "label": "Save Draft", + "id": "target-pr", + "type": "action.set_variable", + "label": "Pick Conflict PR", "config": { - "path": "RELEASE_DRAFT.md", - "content": "{{releaseNotes}}" + "key": "targetPrNumber", + "value": "(() => { const raw = $ctx.getNodeOutput('list-prs')?.output || '[]'; let prs = []; try { prs = typeof raw === 'string' ? JSON.parse(raw) : raw; } catch { return ''; } if (!Array.isArray(prs)) return ''; const CONFLICT = new Set(['CONFLICTING', 'BEHIND', 'DIRTY']); const BOSUN_CREATED_LABEL = 'bosun-pr-bosun-created'; const readLabelNames = (pr) => Array.isArray(pr?.labels) ? pr.labels.map((entry) => typeof entry === 'string' ? entry : entry?.name).filter(Boolean) : []; const isBosunCreated = (pr) => readLabelNames(pr).includes(BOSUN_CREATED_LABEL); /* Skip PRs already owned by the watchdog fix agent */ const pr = prs.find((p) => isBosunCreated(p) && CONFLICT.has(String(p?.mergeable || '').toUpperCase()) && !(p.labels || []).some((l) => l.name === 'bosun-needs-fix') ); return pr?.number ? String(pr.number) : '';})()", + "isExpression": true }, "position": { "x": 400, - "y": 740 + "y": 260 }, "outputs": [ "default" ] }, { - "id": "notify-ready", - "type": "notify.log", - "label": "Draft Ready", + "id": "target-branch", + "type": "action.set_variable", + "label": "Capture Conflict Branch", "config": { - "message": "Release notes draft saved to RELEASE_DRAFT.md — review and publish when ready", - "level": "info" + "key": "targetPrBranch", + "value": "(() => { const raw = $ctx.getNodeOutput('list-prs')?.output || '[]'; let prs = []; try { prs = typeof raw === 'string' ? JSON.parse(raw) : raw; } catch { return ''; } if (!Array.isArray(prs)) return ''; const pr = prs.find((p) => String(p?.number || '') === String($data?.targetPrNumber || '')); return pr?.headRefName || '';})()", + "isExpression": true }, "position": { "x": 400, - "y": 870 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->get-last-tag", - "source": "trigger", - "target": "get-last-tag", - "sourcePort": "default" - }, - { - "id": "get-last-tag->list-prs", - "source": "get-last-tag", - "target": "list-prs", - "sourcePort": "default" - }, - { - "id": "list-prs->get-commits", - "source": "list-prs", - "target": "get-commits", - "sourcePort": "default" - }, - { - "id": "get-commits->draft-notes", - "source": "get-commits", - "target": "draft-notes", - "sourcePort": "default" + "y": 340 + }, + "outputs": [ + "default" + ] }, { - "id": "draft-notes->save-draft", - "source": "draft-notes", - "target": "save-draft", - "sourcePort": "default" + "id": "target-base", + "type": "action.set_variable", + "label": "Capture Base Branch", + "config": { + "key": "targetPrBase", + "value": "(() => { const raw = $ctx.getNodeOutput('list-prs')?.output || '[]'; let prs = []; try { prs = typeof raw === 'string' ? JSON.parse(raw) : raw; } catch { return 'main'; } if (!Array.isArray(prs)) return 'main'; const pr = prs.find((p) => String(p?.number || '') === String($data?.targetPrNumber || '')); return pr?.baseRefName || 'main';})()", + "isExpression": true + }, + "position": { + "x": 400, + "y": 420 + }, + "outputs": [ + "default" + ] }, { - "id": "save-draft->notify-ready", - "source": "save-draft", - "target": "notify-ready", - "sourcePort": "default" - } - ], - "metadata": { - "author": "bosun-demo", - "createdAt": "2026-03-11T12:00:00.000Z", - "updatedAt": "2026-03-11T12:00:00.000Z", - "templateState": { - "templateId": "template-release-drafter", - "templateName": "Release Drafter", - "templateVersion": "1.0.0", - "installedTemplateVersion": "1.0.0", - "isCustomized": false, - "updateAvailable": false - } - } - }, - { - "id": "wf-review-agent", - "name": "Review Agent", - "description": "Automatically runs code review when a PR is opened or updated. Checks build, tests, and code quality, then posts review comments.", - "category": "github", - "enabled": true, - "nodeCount": 6, - "trigger": "trigger.pr_event", - "variables": {}, - "nodes": [ - { - "id": "trigger", - "type": "trigger.pr_event", - "label": "PR Opened/Updated", + "id": "has-conflicts", + "type": "condition.expression", + "label": "Any Conflicts?", "config": { - "event": "opened" + "expression": "Boolean($data?.targetPrNumber)" }, "position": { "x": 400, - "y": 50 + "y": 510 }, "outputs": [ "default" ] }, { - "id": "run-build", - "type": "validation.build", - "label": "Run Build", + "id": "label-fixing", + "type": "action.run_command", + "label": "Label bosun-needs-fix", "config": { - "command": "npm run build" + "command": "gh pr edit {{targetPrNumber}} --add-label bosun-needs-fix", + "continueOnError": true }, "position": { "x": 200, - "y": 200 + "y": 650 }, "outputs": [ "default" ] }, { - "id": "run-tests", - "type": "validation.tests", - "label": "Run Tests", + "id": "resolve-conflicts", + "type": "action.run_agent", + "label": "Resolve Conflicts", "config": { - "command": "npm test" + "prompt": "You are a merge conflict resolution agent for PR #{{targetPrNumber}} on branch {{targetPrBranch}} (base: {{targetPrBase}}).\n\nSteps:\n1. git fetch origin\n2. git checkout {{targetPrBranch}}\n3. git rebase origin/{{targetPrBase}} (fall back to merge if rebase is too complex)\n4. Resolve all merge conflicts, preserving the intent of both sides.\n5. Run the repo's build and test suite to confirm nothing is broken.\n6. git push --force-with-lease origin {{targetPrBranch}}\n7. Remove the bosun-needs-fix label: gh pr edit {{targetPrNumber}} --remove-label bosun-needs-fix\n\nRules:\n- Only make minimal conflict-resolution changes. No unrelated refactors.\n- Do NOT merge, close, or approve the PR — the Bosun PR Watchdog handles merging.\n- Do NOT touch PRs that are not Bosun-created.", + "sdk": "auto", + "timeoutMs": 1800000, + "failOnError": true, + "maxRetries": "{{maxRetries}}", + "retryDelayMs": 30000, + "continueOnError": true }, "position": { - "x": 600, - "y": 200 + "x": 200, + "y": 800 }, "outputs": [ "default" ] }, { - "id": "run-review", - "type": "action.run_agent", - "label": "Agent Review", + "id": "notify-fixed", + "type": "notify.telegram", + "label": "Notify Resolved", "config": { - "prompt": "# Code Review\n\nReview the changes in the current branch. Check for:\n1. Code quality and best practices\n2. Potential bugs or edge cases\n3. Test coverage for new features\n4. Documentation updates if needed\n\nProvide a structured review with specific file:line references.", - "timeoutMs": 900000 + "message": ":settings: PR #{{targetPrNumber}} conflict resolved — awaiting CI and Watchdog review before merge", + "silent": true }, "position": { - "x": 400, - "y": 350 + "x": 200, + "y": 960 }, "outputs": [ "default" ] }, { - "id": "aggregate", - "type": "transform.aggregate", - "label": "Collect Results", + "id": "notify-failed", + "type": "notify.log", + "label": "Log Resolution Failed", "config": { - "sources": [ - "run-build", - "run-tests", - "run-review" - ] + "message": "PR #{{targetPrNumber}} conflict could not be resolved cleanly — manual review required", + "level": "warn" }, "position": { - "x": 400, - "y": 500 + "x": 450, + "y": 800 }, "outputs": [ "default" ] }, { - "id": "notify", - "type": "notify.telegram", - "label": "Post Review", + "id": "skip", + "type": "notify.log", + "label": "No Conflicts", "config": { - "message": ":edit: PR review complete for {{branch}}" + "message": "PR Conflict Resolver: no unhandled Bosun-created conflicts found", + "level": "info" }, "position": { - "x": 400, - "y": 640 + "x": 620, + "y": 510 }, "outputs": [ "default" @@ -28574,78 +21981,111 @@ ], "edges": [ { - "id": "trigger->run-build", + "id": "trigger->list-prs", "source": "trigger", - "target": "run-build", + "target": "list-prs", "sourcePort": "default" }, { - "id": "trigger->run-tests", - "source": "trigger", - "target": "run-tests", + "id": "list-prs->target-pr", + "source": "list-prs", + "target": "target-pr", "sourcePort": "default" }, { - "id": "run-build->run-review", - "source": "run-build", - "target": "run-review", + "id": "target-pr->target-branch", + "source": "target-pr", + "target": "target-branch", "sourcePort": "default" }, { - "id": "run-tests->run-review", - "source": "run-tests", - "target": "run-review", + "id": "target-branch->target-base", + "source": "target-branch", + "target": "target-base", "sourcePort": "default" }, { - "id": "run-review->aggregate", - "source": "run-review", - "target": "aggregate", + "id": "target-base->has-conflicts", + "source": "target-base", + "target": "has-conflicts", "sourcePort": "default" }, { - "id": "aggregate->notify", - "source": "aggregate", - "target": "notify", + "id": "has-conflicts->label-fixing", + "source": "has-conflicts", + "target": "label-fixing", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "has-conflicts->skip", + "source": "has-conflicts", + "target": "skip", + "sourcePort": "default", + "condition": "$output?.result !== true" + }, + { + "id": "label-fixing->resolve-conflicts", + "source": "label-fixing", + "target": "resolve-conflicts", "sourcePort": "default" + }, + { + "id": "resolve-conflicts->notify-fixed", + "source": "resolve-conflicts", + "target": "notify-fixed", + "sourcePort": "default", + "condition": "$ctx.getNodeOutput('resolve-conflicts')?.success === true" + }, + { + "id": "resolve-conflicts->notify-failed", + "source": "resolve-conflicts", + "target": "notify-failed", + "sourcePort": "default", + "condition": "$ctx.getNodeOutput('resolve-conflicts')?.success !== true" } ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-12T12:00:00.000Z", - "updatedAt": "2026-03-12T12:00:00.000Z", + "createdAt": "2026-03-04T12:00:00.000Z", + "updatedAt": "2026-03-04T12:00:00.000Z", "templateState": { - "templateId": "template-review-agent", - "templateName": "Review Agent", - "templateVersion": "1.0.0", - "installedTemplateVersion": "1.0.0", + "templateId": "template-pr-conflict-resolver", + "templateName": "PR Conflict Resolver", + "templateVersion": "2.0.0", + "installedTemplateVersion": "2.0.0", "isCustomized": false, "updateAvailable": false } } }, { - "id": "wf-sdk-conflict-resolver", - "name": "SDK Conflict Resolver", - "description": "Intelligent merge-conflict resolution using SDK agents. Auto-resolves lockfiles and generated files mechanically, then launches an agent with full context to resolve semantic conflicts in code, configs, and imports. Verifies resolution and pushes.", + "id": "wf-pr-merge-strategy", + "name": "PR Merge Strategy", + "description": "Automated PR merge decision workflow with resilient retry paths. Analyzes CI + agent output, executes merge/prompt/close/re-attempt actions, and escalates gracefully when any branch action fails.", "category": "github", "enabled": true, - "nodeCount": 18, - "trigger": "trigger.event", + "nodeCount": 20, + "trigger": "trigger.pr_event", "variables": { - "timeoutMs": 600000, - "cooldownMs": 1800000, - "maxAttempts": 4, - "baseBranch": "main" + "ciTimeoutMs": 300000, + "cooldownSec": 60, + "maxRetries": 3, + "baseBranch": "main", + "requireBosunCreatedPr": true }, "nodes": [ { "id": "trigger", - "type": "trigger.event", - "label": "Merge Conflict Detected", + "type": "trigger.pr_event", + "label": "PR Ready for Merge Decision", "config": { - "eventType": "pr.conflict_detected", - "description": "Fires when a PR has merge conflicts that need resolution" + "event": "review_requested", + "events": [ + "review_requested", + "approved", + "opened" + ] }, "position": { "x": 400, @@ -28656,31 +22096,30 @@ ] }, { - "id": "check-cooldown", - "type": "condition.expression", - "label": "On Cooldown?", + "id": "load-pr-context", + "type": "action.run_command", + "label": "Load PR Context", "config": { - "expression": "(() => { const last = Number($data?.lastAttemptAt || 0); if (!last) return false; return (Date.now() - last) < ($data?.cooldownMs || 1800000); })()" + "command": "gh pr view {{prNumber}} --json body,author,title,labels" }, "position": { "x": 400, - "y": 200 + "y": 140 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "check-attempts", + "id": "automation-eligible", "type": "condition.expression", - "label": "Attempts Exhausted?", + "label": "Bosun-Created PR?", "config": { - "expression": "Number($data?.attemptCount || 0) >= Number($data?.maxAttempts || 4)" + "expression": "(() => { if ($data?.requireBosunCreatedPr !== true && String($data?.requireBosunCreatedPr || '').toLowerCase() !== 'true') return true; const raw = $ctx.getNodeOutput('load-pr-context')?.output || '{}'; let pr = {}; try { pr = typeof raw === 'string' ? JSON.parse(raw) : raw; } catch { return false; } const labels = Array.isArray(pr?.labels) ? pr.labels.map((entry) => typeof entry === 'string' ? entry : entry?.name).filter(Boolean) : []; return labels.includes('bosun-pr-bosun-created'); })()" }, "position": { "x": 400, - "y": 350 + "y": 230 }, "outputs": [ "yes", @@ -28688,256 +22127,302 @@ ] }, { - "id": "get-conflicts", - "type": "action.run_command", - "label": "List Conflicted Files", + "id": "check-ci", + "type": "validation.build", + "label": "Check CI Status", "config": { - "command": "git diff --name-only --diff-filter=U", - "cwd": "{{worktreePath}}", - "continueOnError": true + "command": "gh pr checks {{prNumber}} --json name,state" }, "position": { - "x": 400, - "y": 500 + "x": 150, + "y": 320 }, "outputs": [ "default" ] }, { - "id": "classify-files", - "type": "action.set_variable", - "label": "Classify Files", + "id": "get-diff", + "type": "action.run_command", + "label": "Get Diff Stats", "config": { - "key": "fileClassification", - "value": "(() => { const output = $ctx.getNodeOutput('get-conflicts')?.output || ''; const files = output.split('\\n').map(f => f.trim()).filter(Boolean); const auto = []; const manual = []; const AUTO_THEIRS = ['pnpm-lock.yaml','package-lock.json','yarn.lock','go.sum']; const AUTO_OURS = ['CHANGELOG.md','coverage.txt','results.txt']; for (const f of files) { const name = f.split('/').pop(); if (AUTO_THEIRS.includes(name) || name.endsWith('.lock')) auto.push({file:f,strategy:'theirs'}); else if (AUTO_OURS.includes(name)) auto.push({file:f,strategy:'ours'}); else manual.push(f); } return {auto, manual, total: files.length}; })()", - "isExpression": true + "command": "git diff --stat {{baseBranch}}...HEAD" }, "position": { - "x": 400, - "y": 650 + "x": 650, + "y": 320 }, "outputs": [ "default" ] }, { - "id": "auto-resolve", - "type": "action.run_command", - "label": "Auto-Resolve Trivial Files", + "id": "ci-passed", + "type": "condition.expression", + "label": "CI Passed?", "config": { - "command": "node -e \"const files = JSON.parse(process.env.AUTO_FILES || '[]'); const {execSync} = require('child_process'); let resolved = 0; for (const {file, strategy} of files) { try { execSync('git checkout --' + strategy + ' -- ' + file, {cwd: process.env.CWD}); execSync('git add ' + file, {cwd: process.env.CWD}); resolved++; } catch {} } console.log(JSON.stringify({resolved}));\" ", - "env": { - "AUTO_FILES": "{{fileClassification.auto}}", - "CWD": "{{worktreePath}}" - }, - "continueOnError": true + "expression": "(() => { const out = $ctx.getNodeOutput('check-ci'); if (!out || out.passed !== true) return false; let checks = []; try { checks = JSON.parse(out.output || '[]'); } catch { return false; } if (!Array.isArray(checks) || checks.length === 0) return false; const ok = new Set(['SUCCESS', 'PASSED', 'PASS', 'COMPLETED', 'NEUTRAL', 'SKIPPED']); return checks.every((c) => ok.has(String(c?.state || '').toUpperCase())); })()" }, "position": { - "x": 200, - "y": 800 + "x": 150, + "y": 470 + }, + "outputs": [ + "yes", + "no" + ] + }, + { + "id": "wait-for-ci", + "type": "action.delay", + "label": "Wait for CI", + "config": { + "ms": "{{ciTimeoutMs}}", + "seconds": "{{cooldownSec}}", + "reason": "CI is still running" + }, + "position": { + "x": 150, + "y": 620 }, "outputs": [ "default" ] }, { - "id": "has-manual", - "type": "condition.expression", - "label": "Manual Conflicts Remain?", + "id": "skip-untrusted-pr", + "type": "notify.log", + "label": "Skip Non-Bosun PR", "config": { - "expression": "(() => { const c = $data?.fileClassification; return c?.manual?.length > 0; })()" + "message": "PR Merge Strategy: skipping PR #{{prNumber}} because it is attached but not Bosun-created", + "level": "info" }, "position": { - "x": 400, - "y": 800 + "x": 730, + "y": 230 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "launch-agent", + "id": "analyze", "type": "action.run_agent", - "label": "SDK Agent: Resolve Conflicts", + "label": "Analyze Merge Strategy", "config": { - "prompt": "# Merge Conflict Resolution\n\nYou are resolving merge conflicts in a git worktree.\n\n## Context\n- **Working directory**: `{{worktreePath}}`\n- **PR branch** (HEAD): `{{branch}}`\n- **Base branch** (incoming): `origin/{{baseBranch}}`\n- **PR**: #{{prNumber}}\n- **Task**: {{taskTitle}}\n\n## Conflicted files needing manual resolution:\n{{manualFiles}}\n\n## Instructions\n1. Read both sides of each conflict carefully\n2. Understand the INTENT of each change (feature vs upstream)\n3. Write a correct resolution that preserves both intents\n4. `git add` each resolved file\n5. Run `git commit --no-edit` to finalize the merge\n6. Do NOT use `--theirs` or `--ours` for code files\n7. Ensure no conflict markers (`<<<<<<<`, `=======`, `>>>>>>>`) remain", - "sdk": "auto", - "timeoutMs": "{{timeoutMs}}", - "delegationWatchdogTimeoutMs": "{{delegationWatchdogTimeoutMs}}", - "delegationWatchdogMaxRecoveries": "{{delegationWatchdogMaxRecoveries}}", - "failOnError": true, - "continueOnError": true + "prompt": "# PR Merge Strategy Analysis\n\nReview PR #{{prNumber}} on branch {{branch}}.\n\n## Decision Options:\n1. **merge_after_ci_pass** — Code looks correct, CI is green, merge it.\n2. **prompt** — Agent needs to do more work (provide specific instructions).\n3. **close_pr** — PR should be closed (bad approach, duplicate, etc.).\n4. **re_attempt** — Start task over with fresh agent.\n5. **manual_review** — Escalate to human reviewer.\n6. **wait** — CI still running, wait before deciding.\n7. **noop** — No action needed.\n\nRespond with JSON: { \"action\": \"\", \"reason\": \"\", \"message\": \"\" }", + "timeoutMs": 900000 }, "position": { - "x": 200, - "y": 950 + "x": 400, + "y": 350 }, "outputs": [ "default" ] }, { - "id": "verify-clean", - "type": "action.run_command", - "label": "Verify No Markers", + "id": "parse-decision", + "type": "action.set_variable", + "label": "Parse Decision JSON", "config": { - "command": "git grep -rl '^<<<<<<<\\|^=======\\|^>>>>>>>' -- . || echo CLEAN", - "cwd": "{{worktreePath}}", - "continueOnError": true + "key": "decision", + "value": "(() => { const raw = $ctx.getNodeOutput('analyze')?.output || '{}'; if (raw && typeof raw === 'object') return raw; try { return JSON.parse(String(raw)); } catch { return { action: 'manual_review', reason: 'unparseable merge strategy response', message: String(raw || '') }; } })()", + "isExpression": true }, "position": { - "x": 200, - "y": 1100 + "x": 400, + "y": 430 }, "outputs": [ "default" ] }, { - "id": "markers-clean", - "type": "condition.expression", - "label": "Markers Clean?", + "id": "decision-router", + "type": "condition.switch", + "label": "Route Decision", "config": { - "expression": "(() => { const out = $ctx.getNodeOutput('verify-clean')?.output || ''; return out.trim() === 'CLEAN' || out.trim() === ''; })()" + "value": "(() => { const action = String($data?.decision?.action || '').trim().toLowerCase(); return action || 'manual_review'; })()", + "cases": { + "merge_after_ci_pass": "merge", + "prompt": "prompt-agent", + "close_pr": "close", + "re_attempt": "retry", + "manual_review": "escalate", + "wait": "wait-for-ci", + "noop": "default" + } }, "position": { - "x": 200, - "y": 1250 + "x": 400, + "y": 520 }, "outputs": [ - "yes", - "no" + "merge", + "prompt-agent", + "close", + "retry", + "escalate", + "wait-for-ci", + "default" ] }, { - "id": "push-result", + "id": "do-merge", "type": "action.run_command", - "label": "Push Resolution", + "label": "Auto-Merge PR", "config": { - "command": "git push origin HEAD:{{branch}}", - "cwd": "{{worktreePath}}", - "continueOnError": true, - "maxRetries": 2, - "retryDelayMs": 10000 + "command": "gh pr merge {{prNumber}} --auto --merge", + "failOnError": true, + "maxRetries": "{{maxRetries}}", + "retryDelayMs": 30000, + "continueOnError": true }, "position": { - "x": 200, - "y": 1400 + "x": 100, + "y": 680 }, "outputs": [ "default" ] }, { - "id": "commit-auto-only", - "type": "action.run_command", - "label": "Commit Auto-Only Resolution", + "id": "do-prompt", + "type": "action.run_agent", + "label": "Prompt Agent", "config": { - "command": "git commit --no-edit", - "cwd": "{{worktreePath}}", + "prompt": "Continue working on the PR. Instructions: {{decision.message}}", + "timeoutMs": 3600000, + "failOnError": true, + "maxRetries": 2, + "retryDelayMs": 15000, "continueOnError": true }, "position": { - "x": 600, - "y": 950 + "x": 300, + "y": 680 }, "outputs": [ "default" ] }, { - "id": "push-auto", + "id": "do-close", "type": "action.run_command", - "label": "Push Auto Resolution", + "label": "Close PR", "config": { - "command": "git push origin HEAD:{{branch}}", - "cwd": "{{worktreePath}}", + "command": "gh pr close {{prNumber}} --comment \"{{decision.reason}}\"", + "failOnError": true, + "maxRetries": 2, + "retryDelayMs": 15000, "continueOnError": true }, "position": { - "x": 600, - "y": 1100 + "x": 500, + "y": 680 }, "outputs": [ "default" ] }, { - "id": "notify-resolved", - "type": "notify.log", - "label": "Conflict Resolved", + "id": "do-retry", + "type": "action.run_agent", + "label": "Re-attempt Task", "config": { - "message": "SDK conflict resolution succeeded for PR #{{prNumber}} on {{branch}}", - "level": "info" + "prompt": "Start the task over from scratch. Previous attempt failed: {{decision.reason}}", + "timeoutMs": 3600000, + "failOnError": true, + "maxRetries": 2, + "retryDelayMs": 15000, + "continueOnError": true }, "position": { - "x": 400, - "y": 1550 + "x": 700, + "y": 680 }, "outputs": [ "default" ] }, { - "id": "escalate-cooldown", - "type": "notify.log", - "label": "On Cooldown", + "id": "do-escalate", + "type": "notify.telegram", + "label": "Escalate to Human", "config": { - "message": "SDK conflict resolution skipped — cooldown active for {{branch}}", - "level": "warn" + "message": ":eye: PR #{{prNumber}} needs manual review: {{decision.reason}}" }, "position": { - "x": 700, - "y": 200 + "x": 900, + "y": 680 }, "outputs": [ "default" ] }, { - "id": "escalate-exhausted", + "id": "action-succeeded", + "type": "condition.expression", + "label": "Action Succeeded?", + "config": { + "expression": "(() => { const action = String($data?.decision?.action || '').trim().toLowerCase(); if (action === 'merge_after_ci_pass') return $ctx.getNodeOutput('do-merge')?.success === true; if (action === 'prompt') return $ctx.getNodeOutput('do-prompt')?.success === true; if (action === 'close_pr') return $ctx.getNodeOutput('do-close')?.success === true; if (action === 're_attempt') return $ctx.getNodeOutput('do-retry')?.success === true; if (action === 'manual_review') return $ctx.getNodeOutput('do-escalate')?.sent !== false; return true; })()" + }, + "position": { + "x": 480, + "y": 770 + }, + "outputs": [ + "yes", + "no" + ] + }, + { + "id": "notify-action-failed", "type": "notify.telegram", - "label": "Max Attempts Reached", + "label": "Escalate Action Failure", "config": { - "message": ":warning: Merge conflicts on **{{branch}}** (PR #{{prNumber}}) could not be resolved after {{maxAttempts}} SDK attempts. Manual intervention required." + "message": ":alert: PR #{{prNumber}} workflow action failed after retries ({{decision.action}}). Reason: {{decision.reason}}. Manual follow-up required." }, "position": { - "x": 700, - "y": 350 + "x": 760, + "y": 850 }, "outputs": [ "default" ] }, { - "id": "escalate-markers", - "type": "notify.telegram", - "label": "Markers Still Present", + "id": "notify-complete", + "type": "notify.log", + "label": "Log Result", "config": { - "message": ":alert: SDK agent resolved conflicts on **{{branch}}** but conflict markers remain. Manual review needed for PR #{{prNumber}}." + "message": "PR #{{prNumber}} merge strategy: {{decision.action}} — {{decision.reason}}", + "level": "info" }, "position": { - "x": 500, - "y": 1400 + "x": 400, + "y": 850 }, "outputs": [ "default" ] }, { - "id": "chain-merge-strategy", - "type": "action.execute_workflow", - "label": "Re-evaluate Merge", + "id": "end", + "type": "flow.end", + "label": "End Merge Strategy", "config": { - "workflowId": "template-pr-merge-strategy", - "mode": "dispatch", - "input": "({prNumber: $data?.prNumber, branch: $data?.branch, baseBranch: $data?.baseBranch})" + "status": "completed", + "message": "PR merge strategy flow completed for PR #{{prNumber}}", + "output": { + "prNumber": "{{prNumber}}", + "action": "{{decision.action}}" + } }, "position": { - "x": 200, - "y": 1550 + "x": 400, + "y": 950 }, "outputs": [ "default" @@ -28946,129 +22431,194 @@ ], "edges": [ { - "id": "trigger->check-cooldown", + "id": "trigger->load-pr-context", "source": "trigger", - "target": "check-cooldown", + "target": "load-pr-context", "sourcePort": "default" }, { - "id": "check-cooldown->escalate-cooldown", - "source": "check-cooldown", - "target": "escalate-cooldown", + "id": "load-pr-context->automation-eligible", + "source": "load-pr-context", + "target": "automation-eligible", + "sourcePort": "default" + }, + { + "id": "automation-eligible->check-ci", + "source": "automation-eligible", + "target": "check-ci", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "check-cooldown->check-attempts", - "source": "check-cooldown", - "target": "check-attempts", + "id": "automation-eligible->get-diff", + "source": "automation-eligible", + "target": "get-diff", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "automation-eligible->skip-untrusted-pr", + "source": "automation-eligible", + "target": "skip-untrusted-pr", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "check-attempts->escalate-exhausted", - "source": "check-attempts", - "target": "escalate-exhausted", - "sourcePort": "yes", - "condition": "$output?.result === true" + "id": "check-ci->ci-passed", + "source": "check-ci", + "target": "ci-passed", + "sourcePort": "default" }, { - "id": "check-attempts->get-conflicts", - "source": "check-attempts", - "target": "get-conflicts", + "id": "ci-passed->wait-for-ci", + "source": "ci-passed", + "target": "wait-for-ci", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "get-conflicts->classify-files", - "source": "get-conflicts", - "target": "classify-files", + "id": "ci-passed->analyze", + "source": "ci-passed", + "target": "analyze", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "get-diff->analyze", + "source": "get-diff", + "target": "analyze", "sourcePort": "default" }, { - "id": "classify-files->auto-resolve", - "source": "classify-files", - "target": "auto-resolve", + "id": "wait-for-ci->analyze", + "source": "wait-for-ci", + "target": "analyze", "sourcePort": "default" }, { - "id": "auto-resolve->has-manual", - "source": "auto-resolve", - "target": "has-manual", + "id": "analyze->parse-decision", + "source": "analyze", + "target": "parse-decision", "sourcePort": "default" }, { - "id": "has-manual->launch-agent", - "source": "has-manual", - "target": "launch-agent", - "sourcePort": "yes", - "condition": "$output?.result === true" + "id": "parse-decision->decision-router", + "source": "parse-decision", + "target": "decision-router", + "sourcePort": "default" }, { - "id": "has-manual->commit-auto-only", - "source": "has-manual", - "target": "commit-auto-only", - "sourcePort": "no", - "condition": "$output?.result !== true" + "id": "decision-router->do-merge", + "source": "decision-router", + "target": "do-merge", + "sourcePort": "merge" }, { - "id": "launch-agent->verify-clean", - "source": "launch-agent", - "target": "verify-clean", + "id": "decision-router->do-prompt", + "source": "decision-router", + "target": "do-prompt", + "sourcePort": "prompt-agent" + }, + { + "id": "decision-router->do-close", + "source": "decision-router", + "target": "do-close", + "sourcePort": "close" + }, + { + "id": "decision-router->do-retry", + "source": "decision-router", + "target": "do-retry", + "sourcePort": "retry" + }, + { + "id": "decision-router->do-escalate", + "source": "decision-router", + "target": "do-escalate", + "sourcePort": "escalate" + }, + { + "id": "decision-router->wait-for-ci", + "source": "decision-router", + "target": "wait-for-ci", + "sourcePort": "wait-for-ci" + }, + { + "id": "decision-router->notify-complete", + "source": "decision-router", + "target": "notify-complete", "sourcePort": "default" }, { - "id": "verify-clean->markers-clean", - "source": "verify-clean", - "target": "markers-clean", + "id": "do-merge->action-succeeded", + "source": "do-merge", + "target": "action-succeeded", "sourcePort": "default" }, { - "id": "markers-clean->push-result", - "source": "markers-clean", - "target": "push-result", + "id": "do-prompt->action-succeeded", + "source": "do-prompt", + "target": "action-succeeded", + "sourcePort": "default" + }, + { + "id": "do-close->action-succeeded", + "source": "do-close", + "target": "action-succeeded", + "sourcePort": "default" + }, + { + "id": "do-retry->action-succeeded", + "source": "do-retry", + "target": "action-succeeded", + "sourcePort": "default" + }, + { + "id": "do-escalate->action-succeeded", + "source": "do-escalate", + "target": "action-succeeded", + "sourcePort": "default" + }, + { + "id": "action-succeeded->notify-complete", + "source": "action-succeeded", + "target": "notify-complete", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "markers-clean->escalate-markers", - "source": "markers-clean", - "target": "escalate-markers", + "id": "action-succeeded->notify-action-failed", + "source": "action-succeeded", + "target": "notify-action-failed", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "push-result->chain-merge-strategy", - "source": "push-result", - "target": "chain-merge-strategy", - "sourcePort": "default" - }, - { - "id": "chain-merge-strategy->notify-resolved", - "source": "chain-merge-strategy", - "target": "notify-resolved", + "id": "notify-action-failed->notify-complete", + "source": "notify-action-failed", + "target": "notify-complete", "sourcePort": "default" }, { - "id": "commit-auto-only->push-auto", - "source": "commit-auto-only", - "target": "push-auto", + "id": "notify-complete->end", + "source": "notify-complete", + "target": "end", "sourcePort": "default" }, { - "id": "push-auto->notify-resolved", - "source": "push-auto", - "target": "notify-resolved", + "id": "skip-untrusted-pr->end", + "source": "skip-untrusted-pr", + "target": "end", "sourcePort": "default" } ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-13T12:00:00.000Z", - "updatedAt": "2026-03-13T12:00:00.000Z", + "createdAt": "2026-03-05T12:00:00.000Z", + "updatedAt": "2026-03-05T12:00:00.000Z", "templateState": { - "templateId": "template-sdk-conflict-resolver", - "templateName": "SDK Conflict Resolver", + "templateId": "template-pr-merge-strategy", + "templateName": "PR Merge Strategy", "templateVersion": "1.0.0", "installedTemplateVersion": "1.0.0", "isCustomized": false, @@ -29077,25 +22627,24 @@ } }, { - "id": "wf-stale-pr-reaper", - "name": "Stale PR Reaper", - "description": "Close stale PRs that have been inactive for too long. Posts a warning comment before closing and cleans up associated branches.", + "id": "wf-pr-triage", + "name": "PR Triage & Labels", + "description": "Automatically triage incoming PRs: classify by size, detect breaking changes, add labels, and assign reviewers based on CODEOWNERS.", "category": "github", "enabled": true, - "nodeCount": 9, - "trigger": "trigger.schedule", + "nodeCount": 10, + "trigger": "trigger.pr_event", "variables": { - "staleAfterDays": 14, - "warningBeforeDays": 3 + "smallThreshold": 50, + "largeThreshold": 500 }, "nodes": [ { "id": "trigger", - "type": "trigger.schedule", - "label": "Daily Check", + "type": "trigger.pr_event", + "label": "PR Opened", "config": { - "intervalMs": 86400000, - "cron": "0 8 * * *" + "event": "opened" }, "position": { "x": 400, @@ -29106,125 +22655,145 @@ ] }, { - "id": "find-stale", + "id": "get-stats", "type": "action.run_command", - "label": "Find Stale PRs", + "label": "Get PR Stats", "config": { - "command": "gh pr list --json number,title,updatedAt,headRefName --limit 50" + "command": "gh pr view {{prNumber}} --json additions,deletions,files,labels,title,body" }, "position": { "x": 400, - "y": 200 + "y": 180 }, "outputs": [ "default" ] }, { - "id": "has-stale", - "type": "condition.expression", - "label": "Any Stale PRs?", + "id": "classify-size", + "type": "condition.switch", + "label": "Classify Size", "config": { - "expression": "($ctx.getNodeOutput('find-stale')?.output || '[]').length > 2" + "value": "(() => { const raw = $ctx.getNodeOutput('get-stats')?.output || '{}'; let stats = {}; try { stats = typeof raw === 'string' ? JSON.parse(raw) : raw; } catch { stats = {}; } const delta = Number(stats?.additions || 0) + Number(stats?.deletions || 0); const small = Number($data?.smallThreshold || 50); const large = Number($data?.largeThreshold || 500); if (delta < small) return 'small'; if (delta > large) return 'large'; return 'medium'; })()", + "cases": { + "small": "small", + "medium": "medium", + "large": "large" + } }, "position": { "x": 400, - "y": 350 + "y": 330 }, "outputs": [ + "small", + "medium", + "large", "default" ] }, { - "id": "warn-stale", + "id": "label-small", "type": "action.run_command", - "label": "Post Warning Comment", + "label": "Label: Size/S", "config": { - "command": "node -e \"const {execFileSync}=require('child_process');const stale=Number('{{staleAfterDays}}')||14;const warn=Number('{{warningBeforeDays}}')||3;const now=Date.now();const prs=JSON.parse(execFileSync('gh',['pr','list','--state','open','--json','number,updatedAt,labels','--limit','100'],{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim()||'[]');let n=0;for(const pr of prs){const age=(now-new Date(pr.updatedAt))/864e5;if(age>=(stale-warn)&&age(typeof l==='string'?l:l?.name)==='stale-warning');if(!lbl){try{execFileSync('gh',['pr','comment',String(pr.number),'--body','\\u26a0\\ufe0f This PR has been inactive for '+Math.floor(age)+' day(s) and will be closed in '+Math.ceil(stale-age)+' day(s). Please update or close it if no longer needed.'],{encoding:'utf8',stdio:['pipe','pipe','pipe']});execFileSync('gh',['pr','edit',String(pr.number),'--add-label','stale-warning'],{encoding:'utf8',stdio:['pipe','pipe','pipe']});n++;}catch(e){}}}}console.log('Warned '+n+' PR(s).');\"", - "continueOnError": true + "command": "gh pr edit {{prNumber}} --add-label \"size/S\"" }, "position": { - "x": 200, - "y": 500 + "x": 150, + "y": 480 }, "outputs": [ "default" ] }, { - "id": "close-stale", + "id": "label-medium", "type": "action.run_command", - "label": "Close Expired PRs", + "label": "Label: Size/M", "config": { - "command": "node -e \"const {execFileSync}=require('child_process');const stale=Number('{{staleAfterDays}}')||14;const now=Date.now();const prs=JSON.parse(execFileSync('gh',['pr','list','--state','open','--json','number,title,updatedAt,headRefName','--limit','100'],{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim()||'[]');let n=0;for(const pr of prs){const age=(now-new Date(pr.updatedAt))/864e5;if(age>=stale){try{execFileSync('gh',['pr','close',String(pr.number),'--comment','Automatically closed: inactive for '+Math.floor(age)+' days (threshold: '+stale+' days).','--delete-branch'],{encoding:'utf8',stdio:['pipe','pipe','pipe']});n++;}catch(e){process.stderr.write('close #'+pr.number+': '+(e?.message||e)+'\\n');}}}console.log('Closed '+n+' stale PR(s).');\"", - "continueOnError": true + "command": "gh pr edit {{prNumber}} --add-label \"size/M\"" }, "position": { - "x": 200, - "y": 650 + "x": 400, + "y": 480 }, "outputs": [ "default" ] }, { - "id": "cleanup-branches", + "id": "label-large", "type": "action.run_command", - "label": "Delete Stale Branches", + "label": "Label: Size/L", "config": { - "command": "git fetch --prune origin" + "command": "gh pr edit {{prNumber}} --add-label \"size/L\"" }, "position": { - "x": 200, - "y": 800 + "x": 650, + "y": 480 }, "outputs": [ "default" ] }, { - "id": "prune-worktrees", - "type": "action.run_command", - "label": "Prune Git Worktrees", + "id": "detect-breaking", + "type": "condition.expression", + "label": "Detect Breaking Changes", "config": { - "command": "git worktree prune --expire 7.days.ago 2>/dev/null && echo 'Worktree prune complete.' || echo 'Worktree prune skipped (not a git repo).'", - "continueOnError": true + "expression": "(() => { const raw=$ctx.getNodeOutput('get-stats')?.output||'{}'; let stats={}; try{stats=typeof raw==='string'?JSON.parse(raw):raw;}catch{return false;} const title=String(stats?.title||'').toLowerCase(); const body=String(stats?.body||'').toLowerCase(); const files=Array.isArray(stats?.files)?stats.files.map((f)=>String(f?.path||f?.filename||f||'').toLowerCase()):[]; const text=title+'\\n'+body; const explicit=/\\bbreaking\\b|\\bbreaking change\\b|\\bmajor\\b|\\bbackward incompatible\\b/.test(text); const apiTouch=files.some((f)=>f.includes('api/')||f.includes('/proto/')||f.includes('openapi')||f.includes('schema')); const contractWords=/\\bremove\\b|\\brename\\b|\\bdeprecate\\b|\\bdrop\\b/.test(text); return explicit || (apiTouch && contractWords);})()" }, "position": { - "x": 200, - "y": 950 + "x": 400, + "y": 630 }, "outputs": [ "default" ] }, { - "id": "summary", - "type": "notify.telegram", - "label": "Summary", + "id": "is-breaking", + "type": "condition.expression", + "label": "Breaking?", "config": { - "message": ":trash: Stale PR cleanup complete", - "silent": true + "expression": "(() => { return $ctx.getNodeOutput('detect-breaking')?.result === true; })()" + }, + "position": { + "x": 400, + "y": 780 + }, + "outputs": [ + "yes", + "no" + ] + }, + { + "id": "label-breaking", + "type": "action.run_command", + "label": "Label: Breaking", + "config": { + "command": "gh pr edit {{prNumber}} --add-label \"breaking-change\"" }, "position": { "x": 200, - "y": 1100 + "y": 920 }, "outputs": [ "default" ] }, { - "id": "skip", + "id": "done", "type": "notify.log", - "label": "No Stale PRs", + "label": "Triage Complete", "config": { - "message": "No stale PRs found", + "message": "PR #{{prNumber}} triage workflow completed", "level": "info" }, "position": { - "x": 600, - "y": 500 + "x": 400, + "y": 1050 }, "outputs": [ "default" @@ -29233,63 +22802,87 @@ ], "edges": [ { - "id": "trigger->find-stale", + "id": "trigger->get-stats", "source": "trigger", - "target": "find-stale", + "target": "get-stats", "sourcePort": "default" }, { - "id": "find-stale->has-stale", - "source": "find-stale", - "target": "has-stale", + "id": "get-stats->classify-size", + "source": "get-stats", + "target": "classify-size", "sourcePort": "default" }, { - "id": "has-stale->warn-stale", - "source": "has-stale", - "target": "warn-stale", - "sourcePort": "default", - "condition": "$output?.result === true" + "id": "classify-size->label-small", + "source": "classify-size", + "target": "label-small", + "sourcePort": "small" }, { - "id": "has-stale->skip", - "source": "has-stale", - "target": "skip", - "sourcePort": "default", - "condition": "$output?.result !== true" + "id": "classify-size->label-medium", + "source": "classify-size", + "target": "label-medium", + "sourcePort": "medium" }, { - "id": "warn-stale->close-stale", - "source": "warn-stale", - "target": "close-stale", + "id": "classify-size->label-large", + "source": "classify-size", + "target": "label-large", + "sourcePort": "large" + }, + { + "id": "label-small->detect-breaking", + "source": "label-small", + "target": "detect-breaking", "sourcePort": "default" }, { - "id": "close-stale->cleanup-branches", - "source": "close-stale", - "target": "cleanup-branches", + "id": "label-medium->detect-breaking", + "source": "label-medium", + "target": "detect-breaking", "sourcePort": "default" }, { - "id": "cleanup-branches->prune-worktrees", - "source": "cleanup-branches", - "target": "prune-worktrees", + "id": "label-large->detect-breaking", + "source": "label-large", + "target": "detect-breaking", "sourcePort": "default" }, { - "id": "prune-worktrees->summary", - "source": "prune-worktrees", - "target": "summary", + "id": "detect-breaking->is-breaking", + "source": "detect-breaking", + "target": "is-breaking", + "sourcePort": "default" + }, + { + "id": "is-breaking->label-breaking", + "source": "is-breaking", + "target": "label-breaking", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "is-breaking->done", + "source": "is-breaking", + "target": "done", + "sourcePort": "no", + "condition": "$output?.result !== true" + }, + { + "id": "label-breaking->done", + "source": "label-breaking", + "target": "done", "sourcePort": "default" } ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-14T12:00:00.000Z", - "updatedAt": "2026-03-14T12:00:00.000Z", + "createdAt": "2026-03-06T12:00:00.000Z", + "updatedAt": "2026-03-06T12:00:00.000Z", "templateState": { - "templateId": "template-stale-pr-reaper", - "templateName": "Stale PR Reaper", + "templateId": "template-pr-triage", + "templateName": "PR Triage & Labels", "templateVersion": "1.0.0", "installedTemplateVersion": "1.0.0", "isCustomized": false, @@ -29298,26 +22891,24 @@ } }, { - "id": "wf-agent-session-monitor", - "name": "Agent Session Monitor", - "description": "Monitors active agent sessions for timeouts, excessive token usage, or inactivity. Auto-continues stalled agents or escalates hung ones.", - "category": "agents", + "id": "wf-release-drafter", + "name": "Release Drafter", + "description": "Automatically generates release notes from merged PRs since the last tag. Groups changes by conventional commit type (features, fixes, refactors, etc.) and drafts a GitHub release.", + "category": "github", "enabled": true, - "nodeCount": 9, - "trigger": "trigger.schedule", + "nodeCount": 7, + "trigger": "trigger.manual", "variables": { - "checkIntervalMs": 300000, - "maxIdleMs": 600000, - "maxTokenPercent": 85 + "baseBranch": "main", + "releasePrefix": "v" }, "nodes": [ { "id": "trigger", - "type": "trigger.schedule", - "label": "Check Every 5min", + "type": "trigger.manual", + "label": "Draft Release Notes", "config": { - "intervalMs": "{{checkIntervalMs}}", - "cron": "*/5 * * * *" + "description": "Generate release notes from merged PRs" }, "position": { "x": 400, @@ -29328,126 +22919,95 @@ ] }, { - "id": "list-sessions", + "id": "get-last-tag", "type": "action.run_command", - "label": "List Active Sessions", - "config": { - "command": "node -e \"const fs = require('node:fs');const path = require('node:path');const { pathToFileURL } = require('node:url');const cwd = process.cwd();const mirrorMarker = `${path.sep}.bosun${path.sep}workspaces${path.sep}`.toLowerCase();let repoRoot = cwd;if (cwd.toLowerCase().includes(mirrorMarker)) {const sourceRepoRoot = path.resolve(cwd, '..', '..', '..', '..');if (fs.existsSync(path.join(sourceRepoRoot, 'infra', 'session-tracker.mjs'))) repoRoot = sourceRepoRoot;}const trackerModuleUrl = pathToFileURL(path.join(repoRoot, 'infra', 'session-tracker.mjs')).href;import(trackerModuleUrl).then(({ getSessionTracker }) => {const tracker = getSessionTracker();const sessions = tracker.getActiveSessions().map((session) => {const progress = tracker.getProgressStatus(session.taskId);return {id: session.taskId,taskId: session.taskId,taskTitle: session.taskTitle || null,status: progress.status,idleMs: progress.idleMs,totalEvents: progress.totalEvents,elapsedMs: progress.elapsedMs,lastEventType: progress.lastEventType,recommendation: progress.recommendation,tokenPercent: null};});console.log(JSON.stringify(sessions));}).catch((err) => { console.error(err?.stack || String(err)); process.exit(1); });\"", - "continueOnError": true - }, - "position": { - "x": 400, - "y": 200 - }, - "outputs": [ - "default" - ] - }, - { - "id": "has-active", - "type": "condition.expression", - "label": "Any Active?", + "label": "Get Last Tag", "config": { - "expression": "(() => {const raw = String($ctx.getNodeOutput('list-sessions')?.output || '[]');const lines = raw.split(/\\r?\\n/).map((line) => line.trim()).filter(Boolean);const candidate = lines.length ? lines[lines.length - 1] : '[]';try {const parsed = JSON.parse(candidate);return Array.isArray(parsed) ? parsed : [];} catch {return [];}})().length > 0" + "command": "git describe --tags --abbrev=0 2>/dev/null || echo '{{releasePrefix}}0.0.0'" }, "position": { "x": 400, - "y": 340 + "y": 180 }, "outputs": [ "default" ] }, { - "id": "check-health", + "id": "list-prs", "type": "action.run_command", - "label": "Check Session Health", + "label": "List Merged PRs", "config": { - "command": "node -e \"const fs = require('node:fs');const path = require('node:path');const { pathToFileURL } = require('node:url');const cwd = process.cwd();const mirrorMarker = `${path.sep}.bosun${path.sep}workspaces${path.sep}`.toLowerCase();let repoRoot = cwd;if (cwd.toLowerCase().includes(mirrorMarker)) {const sourceRepoRoot = path.resolve(cwd, '..', '..', '..', '..');if (fs.existsSync(path.join(sourceRepoRoot, 'infra', 'session-tracker.mjs'))) repoRoot = sourceRepoRoot;}const trackerModuleUrl = pathToFileURL(path.join(repoRoot, 'infra', 'session-tracker.mjs')).href;import(trackerModuleUrl).then(({ getSessionTracker }) => {const tracker = getSessionTracker();const sessions = tracker.getActiveSessions().map((session) => {const progress = tracker.getProgressStatus(session.taskId);return {id: session.taskId,taskId: session.taskId,taskTitle: session.taskTitle || null,status: progress.status,idleMs: progress.idleMs,totalEvents: progress.totalEvents,elapsedMs: progress.elapsedMs,lastEventType: progress.lastEventType,recommendation: progress.recommendation,tokenPercent: null};});console.log(JSON.stringify(sessions));}).catch((err) => { console.error(err?.stack || String(err)); process.exit(1); });\"", + "command": "gh pr list --state merged --base {{baseBranch}} --json number,title,labels,author,mergedAt --limit 100", "continueOnError": true }, "position": { - "x": 200, - "y": 490 - }, - "outputs": [ - "default" - ] - }, - { - "id": "has-issues", - "type": "condition.expression", - "label": "Any Unhealthy?", - "config": { - "expression": "(() => { const sessions = (() => {const raw = String($ctx.getNodeOutput('check-health')?.output || '[]');const lines = raw.split(/\\r?\\n/).map((line) => line.trim()).filter(Boolean);const candidate = lines.length ? lines[lines.length - 1] : '[]';try {const parsed = JSON.parse(candidate);return Array.isArray(parsed) ? parsed : [];} catch {return [];}})(); const maxIdleMs = Number($data?.maxIdleMs || 600000); const maxTokenPercent = Number($data?.maxTokenPercent || 85); return sessions.some((item) => { const status = String(item?.status || '').toLowerCase(); const idleMs = Number(item?.idleMs || 0); const tokenPercent = Number(item?.tokenPercent); return status === 'idle' || status === 'stalled' || status === 'timeout' || idleMs > maxIdleMs || (Number.isFinite(tokenPercent) && tokenPercent >= maxTokenPercent); }); })()" - }, - "position": { - "x": 200, - "y": 640 + "x": 400, + "y": 310 }, "outputs": [ "default" ] }, { - "id": "auto-continue", - "type": "action.continue_session", - "label": "Auto-Continue Stalled", + "id": "get-commits", + "type": "action.run_command", + "label": "Get Commit Log", "config": { - "prompt": "You appear to have stalled. Please continue working on the current task.", - "strategy": "continue", - "timeoutMs": 300000 + "command": "git log $(git describe --tags --abbrev=0 2>/dev/null || echo HEAD~50)..HEAD --oneline --no-merges" }, "position": { - "x": 100, - "y": 800 + "x": 400, + "y": 440 }, "outputs": [ "default" ] }, { - "id": "alert-hung", - "type": "notify.telegram", - "label": "Alert Hung Sessions", + "id": "draft-notes", + "type": "action.run_agent", + "label": "Draft Release Notes", "config": { - "message": ":dot: Agent session appears hung — auto-continue attempted. Check status." + "prompt": "# Generate Release Notes\n\n## Merged PRs (JSON)\n{{prList}}\n\n## Commit Log\n{{commitLog}}\n\n## Last Tag\n{{lastTag}}\n\nGenerate professional release notes in the following format:\n\n# What's Changed\n\n## :rocket: Features\n- [list feat: commits with PR references]\n\n## :bug: Bug Fixes\n- [list fix: commits with PR references]\n\n## :settings: Improvements\n- [list refactor/perf/style commits]\n\n## :u1f4da: Documentation\n- [list docs: commits]\n\n## :hammer: Internal\n- [list chore/ci/build commits]\n\nOmit empty sections. Include contributor attribution. Be concise.", + "sdk": "auto", + "timeoutMs": 600000 }, "position": { - "x": 100, - "y": 950 + "x": 400, + "y": 590 }, "outputs": [ "default" ] }, { - "id": "all-healthy", - "type": "notify.log", - "label": "Sessions Healthy", + "id": "save-draft", + "type": "action.write_file", + "label": "Save Draft", "config": { - "message": "All active agent sessions are healthy", - "level": "info" + "path": "RELEASE_DRAFT.md", + "content": "{{releaseNotes}}" }, "position": { - "x": 450, - "y": 640 + "x": 400, + "y": 740 }, "outputs": [ "default" ] }, { - "id": "no-sessions", + "id": "notify-ready", "type": "notify.log", - "label": "No Active Sessions", + "label": "Draft Ready", "config": { - "message": "No active agent sessions to monitor", + "message": "Release notes draft saved to RELEASE_DRAFT.md — review and publish when ready", "level": "info" }, "position": { - "x": 600, - "y": 490 + "x": 400, + "y": 870 }, "outputs": [ "default" @@ -29456,65 +23016,49 @@ ], "edges": [ { - "id": "trigger->list-sessions", + "id": "trigger->get-last-tag", "source": "trigger", - "target": "list-sessions", + "target": "get-last-tag", "sourcePort": "default" }, { - "id": "list-sessions->has-active", - "source": "list-sessions", - "target": "has-active", + "id": "get-last-tag->list-prs", + "source": "get-last-tag", + "target": "list-prs", "sourcePort": "default" }, { - "id": "has-active->check-health", - "source": "has-active", - "target": "check-health", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "has-active->no-sessions", - "source": "has-active", - "target": "no-sessions", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "check-health->has-issues", - "source": "check-health", - "target": "has-issues", + "id": "list-prs->get-commits", + "source": "list-prs", + "target": "get-commits", "sourcePort": "default" }, { - "id": "has-issues->auto-continue", - "source": "has-issues", - "target": "auto-continue", - "sourcePort": "default", - "condition": "$output?.result === true" + "id": "get-commits->draft-notes", + "source": "get-commits", + "target": "draft-notes", + "sourcePort": "default" }, { - "id": "has-issues->all-healthy", - "source": "has-issues", - "target": "all-healthy", - "sourcePort": "default", - "condition": "$output?.result !== true" + "id": "draft-notes->save-draft", + "source": "draft-notes", + "target": "save-draft", + "sourcePort": "default" }, { - "id": "auto-continue->alert-hung", - "source": "auto-continue", - "target": "alert-hung", + "id": "save-draft->notify-ready", + "source": "save-draft", + "target": "notify-ready", "sourcePort": "default" } ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-15T12:00:00.000Z", - "updatedAt": "2026-03-15T12:00:00.000Z", + "createdAt": "2026-03-07T12:00:00.000Z", + "updatedAt": "2026-03-07T12:00:00.000Z", "templateState": { - "templateId": "template-agent-session-monitor", - "templateName": "Agent Session Monitor", + "templateId": "template-release-drafter", + "templateName": "Release Drafter", "templateVersion": "1.0.0", "installedTemplateVersion": "1.0.0", "isCustomized": false, @@ -29523,119 +23067,105 @@ } }, { - "id": "wf-custom-agent", - "name": "Custom Agent Profile", - "description": "Starter template for creating a custom agent profile with configurable validation, notification, and completion gates. Duplicate and customize to match your specific workflow.", - "category": "agents", - "enabled": false, - "nodeCount": 7, - "trigger": "trigger.manual", - "variables": { - "agentName": "my-custom-agent" - }, + "id": "wf-review-agent", + "name": "Review Agent", + "description": "Automatically runs code review when a PR is opened or updated. Checks build, tests, and code quality, then posts review comments.", + "category": "github", + "enabled": true, + "nodeCount": 6, + "trigger": "trigger.pr_event", + "variables": {}, "nodes": [ { "id": "trigger", - "type": "trigger.manual", - "label": "Start", - "config": {}, - "position": { - "x": 400, - "y": 50 - }, - "outputs": [ - "default" - ] - }, - { - "id": "set-context", - "type": "action.set_variable", - "label": "Set Context", + "type": "trigger.pr_event", + "label": "PR Opened/Updated", "config": { - "key": "agentProfile", - "value": "{{agentName}}" + "event": "opened" }, "position": { "x": 400, - "y": 180 + "y": 50 }, "outputs": [ "default" ] }, { - "id": "run-agent", - "type": "action.run_agent", - "label": "Run Agent", + "id": "run-build", + "type": "validation.build", + "label": "Run Build", "config": { - "prompt": "# Custom Agent Task\n\nTask: {{taskTitle}}\n{{taskDescription}}", - "sdk": "auto" + "command": "npm run build" }, "position": { - "x": 400, - "y": 310 + "x": 200, + "y": 200 }, "outputs": [ "default" ] }, { - "id": "verify", + "id": "run-tests", "type": "validation.tests", - "label": "Run Verification", + "label": "Run Tests", "config": { "command": "npm test" }, "position": { - "x": 400, - "y": 440 + "x": 600, + "y": 200 }, "outputs": [ "default" ] }, { - "id": "check-result", - "type": "condition.expression", - "label": "Passed?", + "id": "run-review", + "type": "action.run_agent", + "label": "Agent Review", "config": { - "expression": "$ctx.getNodeOutput('verify')?.passed === true" + "prompt": "# Code Review\n\nReview the changes in the current branch. Check for:\n1. Code quality and best practices\n2. Potential bugs or edge cases\n3. Test coverage for new features\n4. Documentation updates if needed\n\nProvide a structured review with specific file:line references.", + "timeoutMs": 900000 }, "position": { "x": 400, - "y": 570 + "y": 350 }, "outputs": [ "default" ] }, { - "id": "complete", - "type": "action.update_task_status", - "label": "Mark Complete", + "id": "aggregate", + "type": "transform.aggregate", + "label": "Collect Results", "config": { - "taskId": "{{taskId}}", - "status": "done" + "sources": [ + "run-build", + "run-tests", + "run-review" + ] }, "position": { - "x": 200, - "y": 700 + "x": 400, + "y": 500 }, "outputs": [ "default" ] }, { - "id": "fail-notify", - "type": "notify.log", - "label": "Log Failure", + "id": "notify", + "type": "notify.telegram", + "label": "Post Review", "config": { - "message": "Custom agent verification failed for {{taskId}}", - "level": "warn" + "message": ":edit: PR review complete for {{branch}}" }, "position": { - "x": 600, - "y": 700 + "x": 400, + "y": 640 }, "outputs": [ "default" @@ -29644,51 +23174,49 @@ ], "edges": [ { - "id": "trigger->set-context", + "id": "trigger->run-build", "source": "trigger", - "target": "set-context", + "target": "run-build", "sourcePort": "default" }, { - "id": "set-context->run-agent", - "source": "set-context", - "target": "run-agent", + "id": "trigger->run-tests", + "source": "trigger", + "target": "run-tests", "sourcePort": "default" }, { - "id": "run-agent->verify", - "source": "run-agent", - "target": "verify", + "id": "run-build->run-review", + "source": "run-build", + "target": "run-review", "sourcePort": "default" }, { - "id": "verify->check-result", - "source": "verify", - "target": "check-result", + "id": "run-tests->run-review", + "source": "run-tests", + "target": "run-review", "sourcePort": "default" }, { - "id": "check-result->complete", - "source": "check-result", - "target": "complete", - "sourcePort": "default", - "condition": "$output?.result === true" + "id": "run-review->aggregate", + "source": "run-review", + "target": "aggregate", + "sourcePort": "default" }, { - "id": "check-result->fail-notify", - "source": "check-result", - "target": "fail-notify", - "sourcePort": "default", - "condition": "$output?.result !== true" + "id": "aggregate->notify", + "source": "aggregate", + "target": "notify", + "sourcePort": "default" } ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-16T12:00:00.000Z", - "updatedAt": "2026-03-16T12:00:00.000Z", + "createdAt": "2026-03-08T12:00:00.000Z", + "updatedAt": "2026-03-08T12:00:00.000Z", "templateState": { - "templateId": "template-custom-agent", - "templateName": "Custom Agent Profile", + "templateId": "template-review-agent", + "templateName": "Review Agent", "templateVersion": "1.0.0", "installedTemplateVersion": "1.0.0", "isCustomized": false, @@ -29697,26 +23225,29 @@ } }, { - "id": "wf-frontend-agent", - "name": "Frontend Agent", - "description": "Front-end development agent that validates work by taking screenshots, storing them as evidence, and having an independent model verify the implementation matches the task requirements before marking complete.", - "category": "agents", + "id": "wf-sdk-conflict-resolver", + "name": "SDK Conflict Resolver", + "description": "Intelligent merge-conflict resolution using SDK agents. Auto-resolves lockfiles and generated files mechanically, then launches an agent with full context to resolve semantic conflicts in code, configs, and imports. Verifies resolution and pushes.", + "category": "github", "enabled": true, - "nodeCount": 15, - "trigger": "trigger.task_assigned", + "nodeCount": 18, + "trigger": "trigger.event", "variables": { - "devServerUrl": "http://localhost:3000", - "evidenceDir": ".bosun/evidence", - "screenshotCount": 3 + "timeoutMs": 600000, + "cooldownMs": 1800000, + "maxAttempts": 4, + "baseBranch": "main", + "delegationWatchdogTimeoutMs": 300000, + "delegationWatchdogMaxRecoveries": 1 }, "nodes": [ { "id": "trigger", - "type": "trigger.task_assigned", - "label": "Task Assigned", + "type": "trigger.event", + "label": "Merge Conflict Detected", "config": { - "agentType": "frontend", - "taskPattern": "feat\\(.*\\)|fix\\(.*\\)|style\\(.*\\)|ui|frontend|css|component" + "eventType": "pr.conflict_detected", + "description": "Fires when a PR has merge conflicts that need resolution" }, "position": { "x": 400, @@ -29727,269 +23258,288 @@ ] }, { - "id": "select-profile", - "type": "agent.select_profile", - "label": "Select Agent Profile", + "id": "check-cooldown", + "type": "condition.expression", + "label": "On Cooldown?", "config": { - "profiles": { - "frontend": { - "titlePatterns": [ - "ui", - "frontend", - "css", - "component", - "page", - "layout", - "style", - "design" - ], - "tags": [ - "frontend", - "ui", - "css", - "component" - ] - }, - "fullstack": { - "titlePatterns": [ - "api.*ui", - "full.?stack" - ], - "tags": [ - "fullstack" - ] - } - }, - "default": "frontend" + "expression": "(() => { const last = Number($data?.lastAttemptAt || 0); if (!last) return false; return (Date.now() - last) < ($data?.cooldownMs || 1800000); })()" }, "position": { "x": 400, - "y": 160 + "y": 200 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "run-agent", - "type": "action.run_agent", - "label": "Run Frontend Agent", + "id": "check-attempts", + "type": "condition.expression", + "label": "Attempts Exhausted?", "config": { - "prompt": "# Frontend Development Task\n\n## Task: {{taskTitle}}\n\n## Description\n{{taskDescription}}\n\n## Special Instructions\nYou are a **frontend specialist** agent. Your focus areas:\n- HTML/CSS layout and styling\n- JavaScript/TypeScript UI logic\n- Component architecture and state management\n- Responsive design and accessibility\n- Visual accuracy matching design specifications\n\n## CRITICAL: Evidence Collection\nAfter completing your implementation:\n1. Start the dev server if not running\n2. Take screenshots of ALL pages/components you changed\n3. Save each screenshot to `.bosun/evidence/` directory\n4. Include screenshots of: main view, mobile view, any interactive states\n5. Name files descriptively: `homepage-desktop.png`, `modal-open.png`, etc.\n6. Capture at least {{screenshotCount}} key screenshots across target states/viewports.\n\n## Workflow\n1. Read task requirements carefully\n2. Implement all frontend changes\n3. Run `npm run build` to verify no errors\n4. Run `npm run lint` to verify no warnings\n5. Start dev server and screenshot all changed pages\n6. Commit and push\n\n## Do NOT mark task complete yourself — the validation workflow handles that.", - "sdk": "auto", - "cwd": "{{worktreePath}}", - "timeoutMs": 7200000, - "agentProfile": "frontend" + "expression": "Number($data?.attemptCount || 0) >= Number($data?.maxAttempts || 4)" }, "position": { "x": 400, - "y": 280 + "y": 350 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "verify-build", - "type": "validation.build", - "label": "Verify Build", + "id": "get-conflicts", + "type": "action.run_command", + "label": "List Conflicted Files", "config": { - "command": "npm run build", + "command": "git diff --name-only --diff-filter=U", "cwd": "{{worktreePath}}", - "zeroWarnings": true + "continueOnError": true }, "position": { - "x": 150, - "y": 420 + "x": 400, + "y": 500 }, "outputs": [ "default" ] }, { - "id": "verify-lint", - "type": "validation.lint", - "label": "Verify Lint", + "id": "classify-files", + "type": "action.set_variable", + "label": "Classify Files", "config": { - "command": "npm run lint", - "cwd": "{{worktreePath}}" + "key": "fileClassification", + "value": "(() => { const output = $ctx.getNodeOutput('get-conflicts')?.output || ''; const files = output.split('\\n').map(f => f.trim()).filter(Boolean); const auto = []; const manual = []; const AUTO_THEIRS = ['pnpm-lock.yaml','package-lock.json','yarn.lock','go.sum']; const AUTO_OURS = ['CHANGELOG.md','coverage.txt','results.txt']; for (const f of files) { const name = f.split('/').pop(); if (AUTO_THEIRS.includes(name) || name.endsWith('.lock')) auto.push({file:f,strategy:'theirs'}); else if (AUTO_OURS.includes(name)) auto.push({file:f,strategy:'ours'}); else manual.push(f); } return {auto, manual, total: files.length}; })()", + "isExpression": true }, "position": { - "x": 650, - "y": 420 + "x": 400, + "y": 650 }, "outputs": [ "default" ] }, { - "id": "screenshot-desktop", - "type": "validation.screenshot", - "label": "Screenshot Desktop", + "id": "auto-resolve", + "type": "action.run_command", + "label": "Auto-Resolve Trivial Files", "config": { - "url": "{{devServerUrl}}", - "outputDir": "{{evidenceDir}}", - "filename": "desktop-{{taskId}}.png", - "viewport": { - "width": 1920, - "height": 1080 - } + "command": "node -e \"const files = JSON.parse(process.env.AUTO_FILES || '[]'); const {execSync} = require('child_process'); let resolved = 0; for (const {file, strategy} of files) { try { execSync('git checkout --' + strategy + ' -- ' + file, {cwd: process.env.CWD}); execSync('git add ' + file, {cwd: process.env.CWD}); resolved++; } catch {} } console.log(JSON.stringify({resolved}));\" ", + "env": { + "AUTO_FILES": "{{fileClassification.auto}}", + "CWD": "{{worktreePath}}" + }, + "continueOnError": true }, "position": { - "x": 100, - "y": 560 + "x": 200, + "y": 800 }, "outputs": [ "default" ] }, { - "id": "screenshot-tablet", - "type": "validation.screenshot", - "label": "Screenshot Tablet", + "id": "has-manual", + "type": "condition.expression", + "label": "Manual Conflicts Remain?", "config": { - "url": "{{devServerUrl}}", - "outputDir": "{{evidenceDir}}", - "filename": "tablet-{{taskId}}.png", - "viewport": { - "width": 768, - "height": 1024 - } + "expression": "(() => { const c = $data?.fileClassification; return c?.manual?.length > 0; })()" }, "position": { "x": 400, - "y": 560 + "y": 800 + }, + "outputs": [ + "yes", + "no" + ] + }, + { + "id": "launch-agent", + "type": "action.run_agent", + "label": "SDK Agent: Resolve Conflicts", + "config": { + "prompt": "# Merge Conflict Resolution\n\nYou are resolving merge conflicts in a git worktree.\n\n## Context\n- **Working directory**: `{{worktreePath}}`\n- **PR branch** (HEAD): `{{branch}}`\n- **Base branch** (incoming): `origin/{{baseBranch}}`\n- **PR**: #{{prNumber}}\n- **Task**: {{taskTitle}}\n\n## Conflicted files needing manual resolution:\n{{manualFiles}}\n\n## Instructions\n1. Read both sides of each conflict carefully\n2. Understand the INTENT of each change (feature vs upstream)\n3. Write a correct resolution that preserves both intents\n4. `git add` each resolved file\n5. Run `git commit --no-edit` to finalize the merge\n6. Do NOT use `--theirs` or `--ours` for code files\n7. Ensure no conflict markers (`<<<<<<<`, `=======`, `>>>>>>>`) remain", + "sdk": "auto", + "timeoutMs": "{{timeoutMs}}", + "delegationWatchdogTimeoutMs": "{{delegationWatchdogTimeoutMs}}", + "delegationWatchdogMaxRecoveries": "{{delegationWatchdogMaxRecoveries}}", + "failOnError": true, + "continueOnError": true + }, + "position": { + "x": 200, + "y": 950 }, "outputs": [ "default" ] }, { - "id": "screenshot-mobile", - "type": "validation.screenshot", - "label": "Screenshot Mobile", + "id": "verify-clean", + "type": "action.run_command", + "label": "Verify No Markers", "config": { - "url": "{{devServerUrl}}", - "outputDir": "{{evidenceDir}}", - "filename": "mobile-{{taskId}}.png", - "viewport": { - "width": 375, - "height": 812 - } + "command": "git grep -rl '^<<<<<<<\\|^=======\\|^>>>>>>>' -- . || echo CLEAN", + "cwd": "{{worktreePath}}", + "continueOnError": true }, "position": { - "x": 700, - "y": 560 + "x": 200, + "y": 1100 }, "outputs": [ "default" ] }, { - "id": "collect-evidence", - "type": "agent.evidence_collect", - "label": "Collect Evidence", + "id": "markers-clean", + "type": "condition.expression", + "label": "Markers Clean?", "config": { - "evidenceDir": "{{evidenceDir}}" + "expression": "(() => { const out = $ctx.getNodeOutput('verify-clean')?.output || ''; return out.trim() === 'CLEAN' || out.trim() === ''; })()" }, "position": { - "x": 400, - "y": 700 + "x": 200, + "y": 1250 + }, + "outputs": [ + "yes", + "no" + ] + }, + { + "id": "push-result", + "type": "action.run_command", + "label": "Push Resolution", + "config": { + "command": "git push origin HEAD:{{branch}}", + "cwd": "{{worktreePath}}", + "continueOnError": true, + "maxRetries": 2, + "retryDelayMs": 10000 + }, + "position": { + "x": 200, + "y": 1400 }, "outputs": [ "default" ] }, { - "id": "model-review", - "type": "validation.model_review", - "label": "Model Verification", + "id": "commit-auto-only", + "type": "action.run_command", + "label": "Commit Auto-Only Resolution", + "config": { + "command": "git commit --no-edit", + "cwd": "{{worktreePath}}", + "continueOnError": true + }, + "position": { + "x": 600, + "y": 950 + }, + "outputs": [ + "default" + ] + }, + { + "id": "push-auto", + "type": "action.run_command", + "label": "Push Auto Resolution", "config": { - "evidenceDir": "{{evidenceDir}}", - "originalTask": "{{taskTitle}}: {{taskDescription}}", - "criteria": "Visual implementation matches requirements. No broken layouts. Responsive design works across viewports. No console errors visible.", - "strictMode": true + "command": "git push origin HEAD:{{branch}}", + "cwd": "{{worktreePath}}", + "continueOnError": true }, "position": { - "x": 400, - "y": 840 + "x": 600, + "y": 1100 }, "outputs": [ "default" ] }, { - "id": "check-review", - "type": "condition.expression", - "label": "Review Passed?", + "id": "notify-resolved", + "type": "notify.log", + "label": "Conflict Resolved", "config": { - "expression": "$output?.model_review?.passed === true || $data?.modelReviewPassed === true" + "message": "SDK conflict resolution succeeded for PR #{{prNumber}} on {{branch}}", + "level": "info" }, "position": { "x": 400, - "y": 960 + "y": 1550 }, "outputs": [ "default" ] }, { - "id": "mark-success", - "type": "action.update_task_status", - "label": "Mark Task Done", + "id": "escalate-cooldown", + "type": "notify.log", + "label": "On Cooldown", "config": { - "taskId": "{{taskId}}", - "status": "done" + "message": "SDK conflict resolution skipped — cooldown active for {{branch}}", + "level": "warn" }, "position": { - "x": 200, - "y": 1080 + "x": 700, + "y": 200 }, "outputs": [ "default" ] }, { - "id": "notify-success", + "id": "escalate-exhausted", "type": "notify.telegram", - "label": "Notify Success", + "label": "Max Attempts Reached", "config": { - "message": ":check: Frontend task **{{taskTitle}}** passed visual verification and is complete." + "message": ":warning: Merge conflicts on **{{branch}}** (PR #{{prNumber}}) could not be resolved after {{maxAttempts}} SDK attempts. Manual intervention required." }, "position": { - "x": 200, - "y": 1200 + "x": 700, + "y": 350 }, "outputs": [ "default" ] }, { - "id": "notify-failure", + "id": "escalate-markers", "type": "notify.telegram", - "label": "Notify Review Failed", + "label": "Markers Still Present", "config": { - "message": "❌ Frontend task **{{taskTitle}}** failed visual verification.\nEvidence dir: `{{evidenceDir}}`\nReason: `{{model-review.reason}}`\nEvidence count: `{{model-review.evidenceCount}}`\nReview output: {{model-review.reviewOutput}}" + "message": ":alert: SDK agent resolved conflicts on **{{branch}}** but conflict markers remain. Manual review needed for PR #{{prNumber}}." }, "position": { - "x": 600, - "y": 1080 + "x": 500, + "y": 1400 }, "outputs": [ "default" ] }, { - "id": "log-failure", - "type": "notify.log", - "label": "Log Failure", + "id": "chain-merge-strategy", + "type": "action.execute_workflow", + "label": "Re-evaluate Merge", "config": { - "message": "Frontend verification failed for {{taskId}}: evidenceDir={{evidenceDir}} reason={{model-review.reason}} evidenceCount={{model-review.evidenceCount}}", - "level": "warn" + "workflowId": "template-pr-merge-strategy", + "mode": "dispatch", + "input": "({prNumber: $data?.prNumber, branch: $data?.branch, baseBranch: $data?.baseBranch})" }, "position": { - "x": 600, - "y": 1200 + "x": 200, + "y": 1550 }, "outputs": [ "default" @@ -29998,117 +23548,129 @@ ], "edges": [ { - "id": "trigger->select-profile", + "id": "trigger->check-cooldown", "source": "trigger", - "target": "select-profile", - "sourcePort": "default" - }, - { - "id": "select-profile->run-agent", - "source": "select-profile", - "target": "run-agent", + "target": "check-cooldown", "sourcePort": "default" }, { - "id": "run-agent->verify-build", - "source": "run-agent", - "target": "verify-build", - "sourcePort": "default" + "id": "check-cooldown->escalate-cooldown", + "source": "check-cooldown", + "target": "escalate-cooldown", + "sourcePort": "yes", + "condition": "$output?.result === true" }, { - "id": "run-agent->verify-lint", - "source": "run-agent", - "target": "verify-lint", - "sourcePort": "default" + "id": "check-cooldown->check-attempts", + "source": "check-cooldown", + "target": "check-attempts", + "sourcePort": "no", + "condition": "$output?.result !== true" }, { - "id": "verify-build->screenshot-desktop", - "source": "verify-build", - "target": "screenshot-desktop", - "sourcePort": "default" + "id": "check-attempts->escalate-exhausted", + "source": "check-attempts", + "target": "escalate-exhausted", + "sourcePort": "yes", + "condition": "$output?.result === true" }, { - "id": "verify-build->screenshot-tablet", - "source": "verify-build", - "target": "screenshot-tablet", - "sourcePort": "default" + "id": "check-attempts->get-conflicts", + "source": "check-attempts", + "target": "get-conflicts", + "sourcePort": "no", + "condition": "$output?.result !== true" }, { - "id": "verify-build->screenshot-mobile", - "source": "verify-build", - "target": "screenshot-mobile", + "id": "get-conflicts->classify-files", + "source": "get-conflicts", + "target": "classify-files", "sourcePort": "default" }, { - "id": "verify-lint->screenshot-desktop", - "source": "verify-lint", - "target": "screenshot-desktop", + "id": "classify-files->auto-resolve", + "source": "classify-files", + "target": "auto-resolve", "sourcePort": "default" }, { - "id": "screenshot-desktop->collect-evidence", - "source": "screenshot-desktop", - "target": "collect-evidence", + "id": "auto-resolve->has-manual", + "source": "auto-resolve", + "target": "has-manual", "sourcePort": "default" }, { - "id": "screenshot-tablet->collect-evidence", - "source": "screenshot-tablet", - "target": "collect-evidence", - "sourcePort": "default" + "id": "has-manual->launch-agent", + "source": "has-manual", + "target": "launch-agent", + "sourcePort": "yes", + "condition": "$output?.result === true" }, { - "id": "screenshot-mobile->collect-evidence", - "source": "screenshot-mobile", - "target": "collect-evidence", - "sourcePort": "default" + "id": "has-manual->commit-auto-only", + "source": "has-manual", + "target": "commit-auto-only", + "sourcePort": "no", + "condition": "$output?.result !== true" }, { - "id": "collect-evidence->model-review", - "source": "collect-evidence", - "target": "model-review", + "id": "launch-agent->verify-clean", + "source": "launch-agent", + "target": "verify-clean", "sourcePort": "default" }, { - "id": "model-review->check-review", - "source": "model-review", - "target": "check-review", + "id": "verify-clean->markers-clean", + "source": "verify-clean", + "target": "markers-clean", "sourcePort": "default" }, { - "id": "check-review->mark-success", - "source": "check-review", - "target": "mark-success", - "sourcePort": "default", + "id": "markers-clean->push-result", + "source": "markers-clean", + "target": "push-result", + "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "check-review->notify-failure", - "source": "check-review", - "target": "notify-failure", - "sourcePort": "default", + "id": "markers-clean->escalate-markers", + "source": "markers-clean", + "target": "escalate-markers", + "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "mark-success->notify-success", - "source": "mark-success", - "target": "notify-success", + "id": "push-result->chain-merge-strategy", + "source": "push-result", + "target": "chain-merge-strategy", "sourcePort": "default" }, { - "id": "notify-failure->log-failure", - "source": "notify-failure", - "target": "log-failure", + "id": "chain-merge-strategy->notify-resolved", + "source": "chain-merge-strategy", + "target": "notify-resolved", + "sourcePort": "default" + }, + { + "id": "commit-auto-only->push-auto", + "source": "commit-auto-only", + "target": "push-auto", + "sourcePort": "default" + }, + { + "id": "push-auto->notify-resolved", + "source": "push-auto", + "target": "notify-resolved", "sourcePort": "default" } ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-17T12:00:00.000Z", - "updatedAt": "2026-03-17T12:00:00.000Z", + "createdAt": "2026-03-09T12:00:00.000Z", + "updatedAt": "2026-03-09T12:00:00.000Z", "templateState": { - "templateId": "template-frontend-agent", - "templateName": "Frontend Agent", + "templateId": "template-sdk-conflict-resolver", + "templateName": "SDK Conflict Resolver", "templateVersion": "1.0.0", "installedTemplateVersion": "1.0.0", "isCustomized": false, @@ -30117,37 +23679,28 @@ } }, { - "id": "wf-meeting-subworkflow-chain", - "name": "Meeting Orchestrator + Subworkflow Chain", - "description": "Runs a meeting session start/send/vision/transcript/finalize flow, applies a wake-phrase trigger + transcript quality guard, then invokes a child workflow via action.execute_workflow for post-meeting automation.", - "category": "agents", - "enabled": false, - "nodeCount": 14, - "trigger": "trigger.manual", + "id": "wf-stale-pr-reaper", + "name": "Stale PR Reaper", + "description": "Close stale PRs that have been inactive for too long. Posts a warning comment before closing and cleans up associated branches.", + "category": "github", + "enabled": true, + "nodeCount": 9, + "trigger": "trigger.schedule", "variables": { - "sessionTitle": "Sprint Planning Sync", - "meetingExecutor": "codex", - "wakePhrase": "bosun wake", - "openingMessage": "Kick off planning review. Capture decisions, blockers, and next actions.", - "frameDataUrl": "", - "visionSource": "screen", - "visionPrompt": "Summarize visible meeting context, shared docs, and any blockers shown.", - "visionModel": "", - "visionMinIntervalMs": 1500, - "forceVisionAnalyze": false, - "minTranscriptChars": 140, - "childWorkflowId": "template-task-planner", - "finalizeDisposition": "completed", - "notifyPrefix": ":memo:" + "staleAfterDays": 14, + "warningBeforeDays": 3 }, "nodes": [ { "id": "trigger", - "type": "trigger.manual", - "label": "Start Meeting Orchestration", - "config": {}, + "type": "trigger.schedule", + "label": "Daily Check", + "config": { + "intervalMs": 86400000, + "cron": "0 8 * * *" + }, "position": { - "x": 450, + "x": 400, "y": 50 }, "outputs": [ @@ -30155,227 +23708,348 @@ ] }, { - "id": "meeting-start", - "type": "meeting.start", - "label": "Meeting Start", + "id": "find-stale", + "type": "action.run_command", + "label": "Find Stale PRs", "config": { - "title": "{{sessionTitle}}", - "executor": "{{meetingExecutor}}", - "wakePhrase": "{{wakePhrase}}", - "includeTaskContext": true + "command": "gh pr list --json number,title,updatedAt,headRefName --limit 50" }, "position": { - "x": 450, - "y": 190 + "x": 400, + "y": 200 }, "outputs": [ "default" ] }, { - "id": "meeting-send", - "type": "meeting.send", - "label": "Send Opening Prompt", + "id": "has-stale", + "type": "condition.expression", + "label": "Any Stale PRs?", "config": { - "message": "{{openingMessage}}", - "role": "system" + "expression": "($ctx.getNodeOutput('find-stale')?.output || '[]').length > 2" }, "position": { - "x": 450, - "y": 320 + "x": 400, + "y": 350 }, "outputs": [ "default" ] }, { - "id": "meeting-vision", - "type": "meeting.vision", - "label": "Analyze Meeting Frame", + "id": "warn-stale", + "type": "action.run_command", + "label": "Post Warning Comment", "config": { - "frameDataUrl": "{{frameDataUrl}}", - "source": "{{visionSource}}", - "prompt": "{{visionPrompt}}", - "visionModel": "{{visionModel}}", - "minIntervalMs": "{{visionMinIntervalMs}}", - "forceAnalyze": "{{forceVisionAnalyze}}", - "failOnError": false + "command": "node -e \"const {execFileSync}=require('child_process');const stale=Number('{{staleAfterDays}}')||14;const warn=Number('{{warningBeforeDays}}')||3;const now=Date.now();const prs=JSON.parse(execFileSync('gh',['pr','list','--state','open','--json','number,updatedAt,labels','--limit','100'],{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim()||'[]');let n=0;for(const pr of prs){const age=(now-new Date(pr.updatedAt))/864e5;if(age>=(stale-warn)&&age(typeof l==='string'?l:l?.name)==='stale-warning');if(!lbl){try{execFileSync('gh',['pr','comment',String(pr.number),'--body','\\u26a0\\ufe0f This PR has been inactive for '+Math.floor(age)+' day(s) and will be closed in '+Math.ceil(stale-age)+' day(s). Please update or close it if no longer needed.'],{encoding:'utf8',stdio:['pipe','pipe','pipe']});execFileSync('gh',['pr','edit',String(pr.number),'--add-label','stale-warning'],{encoding:'utf8',stdio:['pipe','pipe','pipe']});n++;}catch(e){}}}}console.log('Warned '+n+' PR(s).');\"", + "continueOnError": true }, "position": { - "x": 450, - "y": 450 + "x": 200, + "y": 500 }, "outputs": [ "default" ] }, { - "id": "meeting-transcript", - "type": "meeting.transcript", - "label": "Capture Transcript", + "id": "close-stale", + "type": "action.run_command", + "label": "Close Expired PRs", "config": { - "includeMessages": true + "command": "node -e \"const {execFileSync}=require('child_process');const stale=Number('{{staleAfterDays}}')||14;const now=Date.now();const prs=JSON.parse(execFileSync('gh',['pr','list','--state','open','--json','number,title,updatedAt,headRefName','--limit','100'],{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim()||'[]');let n=0;for(const pr of prs){const age=(now-new Date(pr.updatedAt))/864e5;if(age>=stale){try{execFileSync('gh',['pr','close',String(pr.number),'--comment','Automatically closed: inactive for '+Math.floor(age)+' days (threshold: '+stale+' days).','--delete-branch'],{encoding:'utf8',stdio:['pipe','pipe','pipe']});n++;}catch(e){process.stderr.write('close #'+pr.number+': '+(e?.message||e)+'\\n');}}}console.log('Closed '+n+' stale PR(s).');\"", + "continueOnError": true }, "position": { - "x": 450, - "y": 580 + "x": 200, + "y": 650 }, "outputs": [ "default" ] }, { - "id": "wake-phrase-trigger", - "type": "trigger.meeting.wake_phrase", - "label": "Wake Phrase Trigger", + "id": "cleanup-branches", + "type": "action.run_command", + "label": "Delete Stale Branches", "config": { - "wakePhrase": "{{wakePhrase}}", - "text": "{{meeting-transcript.transcript}}", - "mode": "contains" + "command": "git fetch --prune origin" }, "position": { - "x": 450, - "y": 710 + "x": 200, + "y": 800 }, "outputs": [ "default" ] }, { - "id": "guard-transcript", - "type": "condition.expression", - "label": "Wake Phrase + Transcript Guard", + "id": "prune-worktrees", + "type": "action.run_command", + "label": "Prune Git Worktrees", "config": { - "expression": "(() => { const transcript = String($ctx.getNodeOutput('meeting-transcript')?.transcript || ''); const minChars = Number($data?.minTranscriptChars || 0); const hasWake = $ctx.getNodeOutput('wake-phrase-trigger')?.triggered === true; return transcript.length >= minChars && hasWake; })()" + "command": "git worktree prune --expire 7.days.ago 2>/dev/null && echo 'Worktree prune complete.' || echo 'Worktree prune skipped (not a git repo).'", + "continueOnError": true }, "position": { - "x": 450, - "y": 840 + "x": 200, + "y": 950 }, "outputs": [ "default" ] }, { - "id": "notify-guard-failed", + "id": "summary", "type": "notify.telegram", - "label": "Notify Guard Failed", + "label": "Summary", "config": { - "message": "{{notifyPrefix}} Meeting transcript guard failed for **{{sessionTitle}}**. Wake phrase missing or transcript shorter than {{minTranscriptChars}} chars." + "message": ":trash: Stale PR cleanup complete", + "silent": true }, "position": { - "x": 840, - "y": 840 + "x": 200, + "y": 1100 }, "outputs": [ "default" ] }, { - "id": "execute-child-workflow", - "type": "action.execute_workflow", - "label": "Run Child Workflow", + "id": "skip", + "type": "notify.log", + "label": "No Stale PRs", "config": { - "workflowId": "{{childWorkflowId}}", - "mode": "sync", - "inheritContext": true, - "includeKeys": [ - "meetingSessionId", - "sessionTitle", - "wakePhrase", - "meetingVisionSummary" - ], - "input": { - "parentWorkflowId": "{{_workflowId}}", - "parentRunId": "{{_workflowRunId}}", - "sessionTitle": "{{sessionTitle}}", - "wakePhrase": "{{wakePhrase}}", - "transcript": "{{meeting-transcript.transcript}}", - "visionSummary": "{{meeting-vision.summary}}" - }, - "outputVariable": "childWorkflowResult", - "failOnChildError": false + "message": "No stale PRs found", + "level": "info" + }, + "position": { + "x": 600, + "y": 500 + }, + "outputs": [ + "default" + ] + } + ], + "edges": [ + { + "id": "trigger->find-stale", + "source": "trigger", + "target": "find-stale", + "sourcePort": "default" + }, + { + "id": "find-stale->has-stale", + "source": "find-stale", + "target": "has-stale", + "sourcePort": "default" + }, + { + "id": "has-stale->warn-stale", + "source": "has-stale", + "target": "warn-stale", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "has-stale->skip", + "source": "has-stale", + "target": "skip", + "sourcePort": "default", + "condition": "$output?.result !== true" + }, + { + "id": "warn-stale->close-stale", + "source": "warn-stale", + "target": "close-stale", + "sourcePort": "default" + }, + { + "id": "close-stale->cleanup-branches", + "source": "close-stale", + "target": "cleanup-branches", + "sourcePort": "default" + }, + { + "id": "cleanup-branches->prune-worktrees", + "source": "cleanup-branches", + "target": "prune-worktrees", + "sourcePort": "default" + }, + { + "id": "prune-worktrees->summary", + "source": "prune-worktrees", + "target": "summary", + "sourcePort": "default" + } + ], + "metadata": { + "author": "bosun-demo", + "createdAt": "2026-03-10T12:00:00.000Z", + "updatedAt": "2026-03-10T12:00:00.000Z", + "templateState": { + "templateId": "template-stale-pr-reaper", + "templateName": "Stale PR Reaper", + "templateVersion": "1.0.0", + "installedTemplateVersion": "1.0.0", + "isCustomized": false, + "updateAvailable": false + } + } + }, + { + "id": "wf-agent-session-monitor", + "name": "Agent Session Monitor", + "description": "Monitors active agent sessions for timeouts, excessive token usage, or inactivity. Auto-continues stalled agents or escalates hung ones.", + "category": "agents", + "enabled": true, + "nodeCount": 9, + "trigger": "trigger.schedule", + "variables": { + "checkIntervalMs": 300000, + "maxIdleMs": 600000, + "maxTokenPercent": 85 + }, + "nodes": [ + { + "id": "trigger", + "type": "trigger.schedule", + "label": "Check Every 5min", + "config": { + "intervalMs": "{{checkIntervalMs}}", + "cron": "*/5 * * * *" + }, + "position": { + "x": 400, + "y": 50 + }, + "outputs": [ + "default" + ] + }, + { + "id": "list-sessions", + "type": "action.run_command", + "label": "List Active Sessions", + "config": { + "command": "node -e \"const fs = require('node:fs');const path = require('node:path');const { pathToFileURL } = require('node:url');const cwd = process.cwd();const mirrorMarker = `${path.sep}.bosun${path.sep}workspaces${path.sep}`.toLowerCase();let repoRoot = cwd;if (cwd.toLowerCase().includes(mirrorMarker)) {const sourceRepoRoot = path.resolve(cwd, '..', '..', '..', '..');if (fs.existsSync(path.join(sourceRepoRoot, 'infra', 'session-tracker.mjs'))) repoRoot = sourceRepoRoot;}const trackerModuleUrl = pathToFileURL(path.join(repoRoot, 'infra', 'session-tracker.mjs')).href;import(trackerModuleUrl).then(({ getSessionTracker }) => {const tracker = getSessionTracker();const sessions = tracker.getActiveSessions().map((session) => {const progress = tracker.getProgressStatus(session.taskId);return {id: session.taskId,taskId: session.taskId,taskTitle: session.taskTitle || null,status: progress.status,idleMs: progress.idleMs,totalEvents: progress.totalEvents,elapsedMs: progress.elapsedMs,lastEventType: progress.lastEventType,recommendation: progress.recommendation,tokenPercent: null};});console.log(JSON.stringify(sessions));}).catch((err) => { console.error(err?.stack || String(err)); process.exit(1); });\"", + "continueOnError": true + }, + "position": { + "x": 400, + "y": 200 + }, + "outputs": [ + "default" + ] + }, + { + "id": "has-active", + "type": "condition.expression", + "label": "Any Active?", + "config": { + "expression": "(() => {const raw = String($ctx.getNodeOutput('list-sessions')?.output || '[]');const lines = raw.split(/\\r?\\n/).map((line) => line.trim()).filter(Boolean);const candidate = lines.length ? lines[lines.length - 1] : '[]';try {const parsed = JSON.parse(candidate);return Array.isArray(parsed) ? parsed : [];} catch {return [];}})().length > 0" + }, + "position": { + "x": 400, + "y": 340 + }, + "outputs": [ + "default" + ] + }, + { + "id": "check-health", + "type": "action.run_command", + "label": "Check Session Health", + "config": { + "command": "node -e \"const fs = require('node:fs');const path = require('node:path');const { pathToFileURL } = require('node:url');const cwd = process.cwd();const mirrorMarker = `${path.sep}.bosun${path.sep}workspaces${path.sep}`.toLowerCase();let repoRoot = cwd;if (cwd.toLowerCase().includes(mirrorMarker)) {const sourceRepoRoot = path.resolve(cwd, '..', '..', '..', '..');if (fs.existsSync(path.join(sourceRepoRoot, 'infra', 'session-tracker.mjs'))) repoRoot = sourceRepoRoot;}const trackerModuleUrl = pathToFileURL(path.join(repoRoot, 'infra', 'session-tracker.mjs')).href;import(trackerModuleUrl).then(({ getSessionTracker }) => {const tracker = getSessionTracker();const sessions = tracker.getActiveSessions().map((session) => {const progress = tracker.getProgressStatus(session.taskId);return {id: session.taskId,taskId: session.taskId,taskTitle: session.taskTitle || null,status: progress.status,idleMs: progress.idleMs,totalEvents: progress.totalEvents,elapsedMs: progress.elapsedMs,lastEventType: progress.lastEventType,recommendation: progress.recommendation,tokenPercent: null};});console.log(JSON.stringify(sessions));}).catch((err) => { console.error(err?.stack || String(err)); process.exit(1); });\"", + "continueOnError": true }, "position": { - "x": 450, - "y": 980 + "x": 200, + "y": 490 }, "outputs": [ "default" ] }, { - "id": "child-workflow-ok", + "id": "has-issues", "type": "condition.expression", - "label": "Child Workflow Succeeded?", + "label": "Any Unhealthy?", "config": { - "expression": "$ctx.getNodeOutput('execute-child-workflow')?.success === true" + "expression": "(() => { const sessions = (() => {const raw = String($ctx.getNodeOutput('check-health')?.output || '[]');const lines = raw.split(/\\r?\\n/).map((line) => line.trim()).filter(Boolean);const candidate = lines.length ? lines[lines.length - 1] : '[]';try {const parsed = JSON.parse(candidate);return Array.isArray(parsed) ? parsed : [];} catch {return [];}})(); const maxIdleMs = Number($data?.maxIdleMs || 600000); const maxTokenPercent = Number($data?.maxTokenPercent || 85); return sessions.some((item) => { const status = String(item?.status || '').toLowerCase(); const idleMs = Number(item?.idleMs || 0); const tokenPercent = Number(item?.tokenPercent); return status === 'idle' || status === 'stalled' || status === 'timeout' || idleMs > maxIdleMs || (Number.isFinite(tokenPercent) && tokenPercent >= maxTokenPercent); }); })()" }, "position": { - "x": 450, - "y": 1110 + "x": 200, + "y": 640 }, "outputs": [ "default" ] }, { - "id": "notify-chain-success", - "type": "notify.telegram", - "label": "Notify Chain Success", + "id": "auto-continue", + "type": "action.continue_session", + "label": "Auto-Continue Stalled", "config": { - "message": "{{notifyPrefix}} Meeting workflow chained into **{{childWorkflowId}}** successfully for **{{sessionTitle}}**." + "prompt": "You appear to have stalled. Please continue working on the current task.", + "strategy": "continue", + "timeoutMs": 300000 }, "position": { - "x": 250, - "y": 1230 + "x": 100, + "y": 800 }, "outputs": [ "default" ] }, { - "id": "notify-chain-failed", + "id": "alert-hung", "type": "notify.telegram", - "label": "Notify Chain Failure", + "label": "Alert Hung Sessions", "config": { - "message": ":alert: Meeting flow completed but child workflow **{{childWorkflowId}}** failed or timed out for **{{sessionTitle}}**." + "message": ":dot: Agent session appears hung — auto-continue attempted. Check status." }, "position": { - "x": 650, - "y": 1230 + "x": 100, + "y": 950 }, "outputs": [ "default" ] }, { - "id": "meeting-finalize", - "type": "meeting.finalize", - "label": "Finalize Meeting Session", + "id": "all-healthy", + "type": "notify.log", + "label": "Sessions Healthy", "config": { - "status": "{{finalizeDisposition}}", - "note": "Meeting subworkflow chain finalized." + "message": "All active agent sessions are healthy", + "level": "info" }, "position": { "x": 450, - "y": 1360 + "y": 640 }, "outputs": [ "default" ] }, { - "id": "final-log", + "id": "no-sessions", "type": "notify.log", - "label": "Record Final Outcome", + "label": "No Active Sessions", "config": { - "message": "Meeting orchestration finalized for {{sessionTitle}} with child workflow {{childWorkflowId}}", + "message": "No active agent sessions to monitor", "level": "info" }, "position": { - "x": 450, - "y": 1490 + "x": 600, + "y": 490 }, "outputs": [ "default" @@ -30384,107 +24058,65 @@ ], "edges": [ { - "id": "trigger->meeting-start", + "id": "trigger->list-sessions", "source": "trigger", - "target": "meeting-start", - "sourcePort": "default" - }, - { - "id": "meeting-start->meeting-send", - "source": "meeting-start", - "target": "meeting-send", - "sourcePort": "default" - }, - { - "id": "meeting-send->meeting-vision", - "source": "meeting-send", - "target": "meeting-vision", - "sourcePort": "default" - }, - { - "id": "meeting-vision->meeting-transcript", - "source": "meeting-vision", - "target": "meeting-transcript", - "sourcePort": "default" - }, - { - "id": "meeting-transcript->wake-phrase-trigger", - "source": "meeting-transcript", - "target": "wake-phrase-trigger", + "target": "list-sessions", "sourcePort": "default" }, { - "id": "wake-phrase-trigger->guard-transcript", - "source": "wake-phrase-trigger", - "target": "guard-transcript", + "id": "list-sessions->has-active", + "source": "list-sessions", + "target": "has-active", "sourcePort": "default" }, { - "id": "guard-transcript->execute-child-workflow", - "source": "guard-transcript", - "target": "execute-child-workflow", - "sourcePort": "yes", + "id": "has-active->check-health", + "source": "has-active", + "target": "check-health", + "sourcePort": "default", "condition": "$output?.result === true" }, { - "id": "guard-transcript->notify-guard-failed", - "source": "guard-transcript", - "target": "notify-guard-failed", - "sourcePort": "no", + "id": "has-active->no-sessions", + "source": "has-active", + "target": "no-sessions", + "sourcePort": "default", "condition": "$output?.result !== true" }, { - "id": "execute-child-workflow->child-workflow-ok", - "source": "execute-child-workflow", - "target": "child-workflow-ok", + "id": "check-health->has-issues", + "source": "check-health", + "target": "has-issues", "sourcePort": "default" }, { - "id": "child-workflow-ok->notify-chain-success", - "source": "child-workflow-ok", - "target": "notify-chain-success", - "sourcePort": "yes", + "id": "has-issues->auto-continue", + "source": "has-issues", + "target": "auto-continue", + "sourcePort": "default", "condition": "$output?.result === true" }, { - "id": "child-workflow-ok->notify-chain-failed", - "source": "child-workflow-ok", - "target": "notify-chain-failed", - "sourcePort": "no", + "id": "has-issues->all-healthy", + "source": "has-issues", + "target": "all-healthy", + "sourcePort": "default", "condition": "$output?.result !== true" }, { - "id": "notify-chain-success->meeting-finalize", - "source": "notify-chain-success", - "target": "meeting-finalize", - "sourcePort": "default" - }, - { - "id": "notify-chain-failed->meeting-finalize", - "source": "notify-chain-failed", - "target": "meeting-finalize", - "sourcePort": "default" - }, - { - "id": "notify-guard-failed->meeting-finalize", - "source": "notify-guard-failed", - "target": "meeting-finalize", - "sourcePort": "default" - }, - { - "id": "meeting-finalize->final-log", - "source": "meeting-finalize", - "target": "final-log", + "id": "auto-continue->alert-hung", + "source": "auto-continue", + "target": "alert-hung", "sourcePort": "default" } ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-18T12:00:00.000Z", - "updatedAt": "2026-03-18T12:00:00.000Z", + "createdAt": "2026-03-11T12:00:00.000Z", + "updatedAt": "2026-03-11T12:00:00.000Z", "templateState": { - "templateId": "template-meeting-subworkflow-chain", - "templateName": "Meeting Orchestrator + Subworkflow Chain", + "templateId": "template-agent-session-monitor", + "templateName": "Agent Session Monitor", "templateVersion": "1.0.0", "installedTemplateVersion": "1.0.0", "isCustomized": false, @@ -30493,34 +24125,21 @@ } }, { - "id": "wf-backend-agent", - "name": "Task Completion Agent", - "description": "General-purpose task completion agent with a test-first methodology. Writes tests first, implements the feature, validates with build + lint, then creates a PR. Works with any language/framework — commands are auto-detected from your project or fully customizable.", + "id": "wf-custom-agent", + "name": "Custom Agent Profile", + "description": "Starter template for creating a custom agent profile with configurable validation, notification, and completion gates. Duplicate and customize to match your specific workflow.", "category": "agents", - "enabled": true, - "nodeCount": 46, - "trigger": "trigger.task_assigned", + "enabled": false, + "nodeCount": 7, + "trigger": "trigger.manual", "variables": { - "testCommand": "npm test", - "buildCommand": "npm run build", - "lintCommand": "", - "baseBranch": "main", - "protectedBranches": [ - "main", - "master", - "develop", - "production" - ], - "agentSdk": "auto", - "timeoutMs": 3600000, - "testTimeoutMs": 1800000, - "autoFixTimeoutMs": 1200000 + "agentName": "my-custom-agent" }, "nodes": [ { "id": "trigger", - "type": "trigger.task_assigned", - "label": "Task Assigned", + "type": "trigger.manual", + "label": "Start", "config": {}, "position": { "x": 400, @@ -30531,14 +24150,12 @@ ] }, { - "id": "plan-work", - "type": "agent.run_planner", - "label": "Plan Implementation", + "id": "set-context", + "type": "action.set_variable", + "label": "Set Context", "config": { - "prompt": "Analyze the task requirements and create a step-by-step implementation plan. Identify which files need to be modified, what tests need to be written, and any API contracts to maintain.", - "outputVariable": "plan", - "repoMapQuery": "{{taskTitle}} {{taskDescription}}", - "repoMapFileLimit": 8 + "key": "agentProfile", + "value": "{{agentName}}" }, "position": { "x": 400, @@ -30549,765 +24166,818 @@ ] }, { - "id": "write-tests", - "type": "action.run_agent", - "label": "Write Tests First", - "config": { - "prompt": "# Test-First Development\n\nBased on the plan:\n{{plan}}\n\nWrite comprehensive tests FIRST before any implementation:\n1. Unit tests for new functions/methods\n2. Integration tests for API endpoints if applicable\n3. Edge cases and error scenarios\n\nUse the project's test command: {{testCommand}}\nCreate a descriptive test commit message that names the behavior or surface covered.\nExample: \"test: cover portal login validation\"", - "sdk": "{{agentSdk}}", - "timeoutMs": "{{timeoutMs}}" - }, - "position": { - "x": 400, - "y": 330 - }, - "outputs": [ - "default" - ] - }, - { - "id": "implement", + "id": "run-agent", "type": "action.run_agent", - "label": "Implement Feature", - "config": { - "prompt": "# Implement Feature\n\nThe tests have been written. Now implement the feature to make them pass:\n1. Follow existing code conventions\n2. Add proper error handling\n3. Ensure all new tests pass\n4. Do NOT modify the tests — make the code fit the contract\n\nRun `{{testCommand}}` after implementation.\nCreate a descriptive feat/fix commit message that names the shipped capability.\nExample: \"feat: add portal login rate limiting\"", - "sdk": "{{agentSdk}}", - "timeoutMs": "{{timeoutMs}}" - }, - "position": { - "x": 400, - "y": 490 - }, - "outputs": [ - "default" - ] - }, - { - "id": "main-build", - "type": "validation.build", - "label": "Build Check", + "label": "Run Agent", "config": { - "command": "{{buildCommand}}", - "zeroWarnings": true + "prompt": "# Custom Agent Task\n\nTask: {{taskTitle}}\n{{taskDescription}}", + "sdk": "auto" }, "position": { "x": 400, - "y": 0 + "y": 310 }, "outputs": [ "default" ] }, { - "id": "main-test", + "id": "verify", "type": "validation.tests", - "label": "Test Run", + "label": "Run Verification", "config": { - "command": "{{testCommand}}", - "timeoutMs": "{{testTimeoutMs}}" + "command": "npm test" }, "position": { "x": 400, - "y": 130 + "y": 440 }, "outputs": [ "default" ] }, { - "id": "main-lint", - "type": "validation.lint", - "label": "Lint Check", + "id": "check-result", + "type": "condition.expression", + "label": "Passed?", "config": { - "command": "{{lintCommand}}" + "expression": "$ctx.getNodeOutput('verify')?.passed === true" }, "position": { "x": 400, - "y": 260 + "y": 570 }, "outputs": [ "default" ] }, { - "id": "all-passed", - "type": "condition.expression", - "label": "All Checks Passed?", + "id": "complete", + "type": "action.update_task_status", + "label": "Mark Complete", "config": { - "expression": "$ctx.getNodeOutput('main-build')?.passed === true && $ctx.getNodeOutput('main-test')?.passed === true && $ctx.getNodeOutput('main-lint')?.passed === true" + "taskId": "{{taskId}}", + "status": "done" }, "position": { - "x": 400, - "y": 1040 + "x": 200, + "y": 700 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "push-branch", - "type": "action.push_branch", - "label": "Push Branch", + "id": "fail-notify", + "type": "notify.log", + "label": "Log Failure", "config": { - "worktreePath": "{{worktreePath}}", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "rebaseBeforePush": true, - "mergeBaseBeforePush": true, - "autoResolveMergeConflicts": true, - "conflictResolverSdk": "{{agentSdk}}", - "emptyDiffGuard": true, - "protectedBranches": "{{protectedBranches}}" + "message": "Custom agent verification failed for {{taskId}}", + "level": "warn" }, "position": { - "x": 250, - "y": 1110 + "x": 600, + "y": 700 }, "outputs": [ "default" ] - }, + } + ], + "edges": [ { - "id": "push-ok", - "type": "condition.expression", - "label": "Push OK?", - "config": { - "expression": "$ctx.getNodeOutput('push-branch')?.pushed === true" - }, - "position": { - "x": 250, - "y": 1170 - }, - "outputs": [ - "yes", - "no" - ] + "id": "trigger->set-context", + "source": "trigger", + "target": "set-context", + "sourcePort": "default" }, { - "id": "create-pr", - "type": "action.create_pr", - "label": "Handoff PR Lifecycle", - "config": { - "title": "feat: {{taskTitle}}", - "body": "Implements backend task with test-first methodology.\n\n**Plan:**\n{{plan}}\n\nAll tests passing. Bosun lifecycle handoff ready.", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "failOnError": true, - "maxRetries": 3, - "retryDelayMs": 15000, - "continueOnError": true - }, - "position": { - "x": 250, - "y": 1170 - }, - "outputs": [ - "default" - ] + "id": "set-context->run-agent", + "source": "set-context", + "target": "run-agent", + "sourcePort": "default" }, { - "id": "main-pr-ok", - "type": "condition.expression", - "label": "PR Created?", - "config": { - "expression": "Boolean($ctx.getNodeOutput($edge.source)?.prNumber || $ctx.getNodeOutput($edge.source)?.prUrl)" - }, - "position": { - "x": 400, - "y": 0 - }, - "outputs": [ - "yes", - "no" - ] + "id": "run-agent->verify", + "source": "run-agent", + "target": "verify", + "sourcePort": "default" }, { - "id": "main-set-inreview", - "type": "action.update_task_status", - "label": "Set In-Review", - "config": { - "taskId": "{{taskId}}", - "status": "inreview", - "taskTitle": "{{taskTitle}}" - }, - "position": { - "x": 300, - "y": 130 - }, - "outputs": [ - "default" - ] + "id": "verify->check-result", + "source": "verify", + "target": "check-result", + "sourcePort": "default" }, { - "id": "main-handoff-progressor", - "type": "action.execute_workflow", - "label": "Handoff PR Progressor", - "config": { - "workflowId": "template-bosun-pr-progressor", - "mode": "dispatch", - "input": { - "taskId": "{{taskId}}", - "taskTitle": "{{taskTitle}}", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}" - } - }, - "position": { - "x": 300, - "y": 260 - }, - "outputs": [ - "default" - ] + "id": "check-result->complete", + "source": "check-result", + "target": "complete", + "sourcePort": "default", + "condition": "$output?.result === true" }, { - "id": "notify-done", - "type": "notify.log", - "label": "Task Complete", - "config": { - "message": "Task completion agent finished task — PR lifecycle handoff recorded", - "level": "info" - }, - "position": { - "x": 180, - "y": 1320 - }, - "outputs": [ - "default" - ] - }, + "id": "check-result->fail-notify", + "source": "check-result", + "target": "fail-notify", + "sourcePort": "default", + "condition": "$output?.result !== true" + } + ], + "metadata": { + "author": "bosun-demo", + "createdAt": "2026-03-12T12:00:00.000Z", + "updatedAt": "2026-03-12T12:00:00.000Z", + "templateState": { + "templateId": "template-custom-agent", + "templateName": "Custom Agent Profile", + "templateVersion": "1.0.0", + "installedTemplateVersion": "1.0.0", + "isCustomized": false, + "updateAvailable": false + } + } + }, + { + "id": "wf-frontend-agent", + "name": "Frontend Agent", + "description": "Front-end development agent that validates work by taking screenshots, storing them as evidence, and having an independent model verify the implementation matches the task requirements before marking complete.", + "category": "agents", + "enabled": true, + "nodeCount": 15, + "trigger": "trigger.task_assigned", + "variables": { + "devServerUrl": "http://localhost:3000", + "evidenceDir": ".bosun/evidence", + "screenshotCount": 3 + }, + "nodes": [ { - "id": "notify-pr-failed", - "type": "notify.telegram", - "label": "Escalate Lifecycle Handoff Failure", + "id": "trigger", + "type": "trigger.task_assigned", + "label": "Task Assigned", "config": { - "message": ":alert: Task completion agent passed validation for {{taskTitle}} but failed to record Bosun PR lifecycle handoff after retries. Manual follow-up required." + "agentType": "frontend", + "taskPattern": "feat\\(.*\\)|fix\\(.*\\)|style\\(.*\\)|ui|frontend|css|component" }, "position": { - "x": 420, - "y": 1320 + "x": 400, + "y": 50 }, "outputs": [ "default" ] }, { - "id": "set-validation-summary", - "type": "action.set_variable", - "label": "Summarize Validation Output", + "id": "select-profile", + "type": "agent.select_profile", + "label": "Select Agent Profile", "config": { - "key": "validationSummary", - "value": "(() => { function fmtGate(label, out) { if (!out || !Object.keys(out).length) return label + ': (not run)'; const diag = out.outputDiagnostics || {}; const lines = [label + ': ' + (out.passed === true ? 'PASSED' : 'FAILED')]; if (diag.summary) lines.push(' Summary: ' + diag.summary); const targets = diag.failedTargets || []; if (targets.length) { lines.push(' Failed targets (' + targets.length + '):'); targets.slice(0, 20).forEach(t => lines.push(' - ' + t)); if (targets.length > 20) lines.push(' ... and ' + (targets.length - 20) + ' more'); } const rerun = out.outputSuggestedRerun || diag.suggestedRerun || ''; if (rerun) lines.push(' Rerun: `' + rerun + '`'); const hint = out.outputHint || diag.hint || ''; if (hint) lines.push(' Hint: ' + hint); if (out.output) lines.push(' Output:\\n' + String(out.output).slice(0, 5000)); return lines.join('\\n'); } const build = $ctx.getNodeOutput('main-build') || {}; const test = $ctx.getNodeOutput('main-test') || {}; const lint = $ctx.getNodeOutput('main-lint') || {}; return [ '## Validation Results', '', fmtGate('Build', build), '', fmtGate('Test', test), '', fmtGate('Lint', lint), ].join('\\n'); })()", - "isExpression": true + "profiles": { + "frontend": { + "titlePatterns": [ + "ui", + "frontend", + "css", + "component", + "page", + "layout", + "style", + "design" + ], + "tags": [ + "frontend", + "ui", + "css", + "component" + ] + }, + "fullstack": { + "titlePatterns": [ + "api.*ui", + "full.?stack" + ], + "tags": [ + "fullstack" + ] + } + }, + "default": "frontend" }, "position": { - "x": 620, - "y": 1090 + "x": 400, + "y": 160 }, "outputs": [ "default" ] }, { - "id": "auto-fix", + "id": "run-agent", "type": "action.run_agent", - "label": "Auto-Fix Validation Failures", + "label": "Run Frontend Agent", "config": { - "prompt": "# Fix Validation Failures — Pass 1\n\nThe first validation pass failed for task **{{taskTitle}}**.\n\nPlan:\n{{plan}}\n\n{{validationSummary}}\n\nSTRATEGY:\n1. Look at which gates failed (Build / Test / Lint) and focus on those.\n2. Check the **Failed Targets** — these are the exact tests/files/packages that broke.\n3. Fix compilation errors first, then test failures, then lint issues.\n4. Use the **Suggested Rerun Command** (if shown) to iterate on just the failing targets.\n5. Once targeted failures pass, run all three gates to confirm everything is green.\n\nRULES:\n- Do NOT weaken, remove, or bypass tests.\n- Keep the original task scope.\n- Create a descriptive fix commit message that names the concrete failure resolved.", - "sdk": "{{agentSdk}}", - "timeoutMs": "{{autoFixTimeoutMs}}" + "prompt": "# Frontend Development Task\n\n## Task: {{taskTitle}}\n\n## Description\n{{taskDescription}}\n\n## Special Instructions\nYou are a **frontend specialist** agent. Your focus areas:\n- HTML/CSS layout and styling\n- JavaScript/TypeScript UI logic\n- Component architecture and state management\n- Responsive design and accessibility\n- Visual accuracy matching design specifications\n\n## CRITICAL: Evidence Collection\nAfter completing your implementation:\n1. Start the dev server if not running\n2. Take screenshots of ALL pages/components you changed\n3. Save each screenshot to `.bosun/evidence/` directory\n4. Include screenshots of: main view, mobile view, any interactive states\n5. Name files descriptively: `homepage-desktop.png`, `modal-open.png`, etc.\n6. Capture at least {{screenshotCount}} key screenshots across target states/viewports.\n\n## Workflow\n1. Read task requirements carefully\n2. Implement all frontend changes\n3. Run `npm run build` to verify no errors\n4. Run `npm run lint` to verify no warnings\n5. Start dev server and screenshot all changed pages\n6. Commit and push\n\n## Do NOT mark task complete yourself — the validation workflow handles that.", + "sdk": "auto", + "cwd": "{{worktreePath}}", + "timeoutMs": 7200000, + "agentProfile": "frontend" }, "position": { - "x": 620, - "y": 1170 + "x": 400, + "y": 280 }, "outputs": [ "default" ] }, { - "id": "retry-build", + "id": "verify-build", "type": "validation.build", - "label": "Build Check", + "label": "Verify Build", "config": { - "command": "{{buildCommand}}", + "command": "npm run build", + "cwd": "{{worktreePath}}", "zeroWarnings": true }, "position": { - "x": 400, - "y": 0 + "x": 150, + "y": 420 }, "outputs": [ "default" ] }, { - "id": "retry-test", - "type": "validation.tests", - "label": "Test Run", + "id": "verify-lint", + "type": "validation.lint", + "label": "Verify Lint", "config": { - "command": "{{testCommand}}", - "timeoutMs": "{{testTimeoutMs}}" + "command": "npm run lint", + "cwd": "{{worktreePath}}" }, "position": { - "x": 400, - "y": 130 + "x": 650, + "y": 420 }, "outputs": [ "default" ] }, { - "id": "retry-lint", - "type": "validation.lint", - "label": "Lint Check", + "id": "screenshot-desktop", + "type": "validation.screenshot", + "label": "Screenshot Desktop", "config": { - "command": "{{lintCommand}}" + "url": "{{devServerUrl}}", + "outputDir": "{{evidenceDir}}", + "filename": "desktop-{{taskId}}.png", + "viewport": { + "width": 1920, + "height": 1080 + } }, "position": { - "x": 400, - "y": 260 + "x": 100, + "y": 560 }, "outputs": [ "default" ] }, { - "id": "retry-passed", - "type": "condition.expression", - "label": "Retry Checks Passed?", + "id": "screenshot-tablet", + "type": "validation.screenshot", + "label": "Screenshot Tablet", "config": { - "expression": "$ctx.getNodeOutput('retry-build')?.passed === true && $ctx.getNodeOutput('retry-test')?.passed === true && $ctx.getNodeOutput('retry-lint')?.passed === true" + "url": "{{devServerUrl}}", + "outputDir": "{{evidenceDir}}", + "filename": "tablet-{{taskId}}.png", + "viewport": { + "width": 768, + "height": 1024 + } }, "position": { - "x": 620, - "y": 1690 + "x": 400, + "y": 560 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "push-branch-retry", - "type": "action.push_branch", - "label": "Push Branch (Retry)", + "id": "screenshot-mobile", + "type": "validation.screenshot", + "label": "Screenshot Mobile", "config": { - "worktreePath": "{{worktreePath}}", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "rebaseBeforePush": true, - "mergeBaseBeforePush": true, - "autoResolveMergeConflicts": true, - "conflictResolverSdk": "{{agentSdk}}", - "emptyDiffGuard": true, - "protectedBranches": "{{protectedBranches}}" + "url": "{{devServerUrl}}", + "outputDir": "{{evidenceDir}}", + "filename": "mobile-{{taskId}}.png", + "viewport": { + "width": 375, + "height": 812 + } }, "position": { - "x": 450, - "y": 1760 + "x": 700, + "y": 560 }, "outputs": [ "default" ] }, { - "id": "push-ok-retry", - "type": "condition.expression", - "label": "Push OK? (Retry)", + "id": "collect-evidence", + "type": "agent.evidence_collect", + "label": "Collect Evidence", "config": { - "expression": "$ctx.getNodeOutput('push-branch-retry')?.pushed === true" + "evidenceDir": "{{evidenceDir}}" }, "position": { - "x": 450, - "y": 1820 + "x": 400, + "y": 700 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "create-pr-retry", - "type": "action.create_pr", - "label": "Handoff PR Lifecycle (After Retry)", + "id": "model-review", + "type": "validation.model_review", + "label": "Model Verification", "config": { - "title": "feat: {{taskTitle}}", - "body": "Implements backend task after auto-fix retry.\n\n**Plan:**\n{{plan}}\n\nValidation passed after remediation. Bosun lifecycle handoff ready.", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "failOnError": true, - "maxRetries": 3, - "retryDelayMs": 15000, - "continueOnError": true + "evidenceDir": "{{evidenceDir}}", + "originalTask": "{{taskTitle}}: {{taskDescription}}", + "criteria": "Visual implementation matches requirements. No broken layouts. Responsive design works across viewports. No console errors visible.", + "strictMode": true }, "position": { - "x": 450, - "y": 1820 + "x": 400, + "y": 840 }, "outputs": [ "default" ] }, { - "id": "retry-pr-ok", + "id": "check-review", "type": "condition.expression", - "label": "PR Created?", + "label": "Review Passed?", "config": { - "expression": "Boolean($ctx.getNodeOutput($edge.source)?.prNumber || $ctx.getNodeOutput($edge.source)?.prUrl)" + "expression": "$output?.model_review?.passed === true || $data?.modelReviewPassed === true" }, "position": { "x": 400, - "y": 0 + "y": 960 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "retry-set-inreview", + "id": "mark-success", "type": "action.update_task_status", - "label": "Set In-Review", + "label": "Mark Task Done", "config": { "taskId": "{{taskId}}", - "status": "inreview", - "taskTitle": "{{taskTitle}}" + "status": "done" }, "position": { - "x": 300, - "y": 130 + "x": 200, + "y": 1080 }, "outputs": [ "default" ] }, { - "id": "retry-handoff-progressor", - "type": "action.execute_workflow", - "label": "Handoff PR Progressor", + "id": "notify-success", + "type": "notify.telegram", + "label": "Notify Success", "config": { - "workflowId": "template-bosun-pr-progressor", - "mode": "dispatch", - "input": { - "taskId": "{{taskId}}", - "taskTitle": "{{taskTitle}}", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}" - } + "message": ":check: Frontend task **{{taskTitle}}** passed visual verification and is complete." }, "position": { - "x": 300, - "y": 260 + "x": 200, + "y": 1200 }, "outputs": [ "default" ] }, { - "id": "notify-done-retry", - "type": "notify.log", - "label": "Task Complete (After Retry)", + "id": "notify-failure", + "type": "notify.telegram", + "label": "Notify Review Failed", "config": { - "message": "Task completion agent finished task after retry — PR lifecycle handoff recorded", - "level": "info" + "message": "❌ Frontend task **{{taskTitle}}** failed visual verification.\nEvidence dir: `{{evidenceDir}}`\nReason: `{{model-review.reason}}`\nEvidence count: `{{model-review.evidenceCount}}`\nReview output: {{model-review.reviewOutput}}" }, "position": { - "x": 360, - "y": 1980 + "x": 600, + "y": 1080 }, "outputs": [ "default" ] }, { - "id": "set-retry2-summary", - "type": "action.set_variable", - "label": "Summarize Retry-1 Output", + "id": "log-failure", + "type": "notify.log", + "label": "Log Failure", "config": { - "key": "retry2Summary", - "value": "(() => { function fmtGate(label, out) { if (!out || !Object.keys(out).length) return label + ': (not run)'; const diag = out.outputDiagnostics || {}; const lines = [label + ': ' + (out.passed === true ? 'PASSED' : 'FAILED')]; if (diag.summary) lines.push(' Summary: ' + diag.summary); const targets = diag.failedTargets || []; if (targets.length) { lines.push(' Failed (' + targets.length + '):'); targets.slice(0, 15).forEach(t => lines.push(' - ' + t)); if (targets.length > 15) lines.push(' ... +' + (targets.length - 15) + ' more'); } const rerun = out.outputSuggestedRerun || diag.suggestedRerun || ''; if (rerun) lines.push(' Rerun: `' + rerun + '`'); if (diag.deltaSummary) lines.push(' Delta: ' + diag.deltaSummary); if (out.output) lines.push(' Output:\\n' + String(out.output).slice(0, 3500)); return lines.join('\\n'); } const b1 = $ctx.getNodeOutput('main-build') || {}; const t1 = $ctx.getNodeOutput('main-test') || {}; const l1 = $ctx.getNodeOutput('main-lint') || {}; const b2 = $ctx.getNodeOutput('retry-build') || {}; const t2 = $ctx.getNodeOutput('retry-test') || {}; const l2 = $ctx.getNodeOutput('retry-lint') || {}; return [ '## Validation History (both passes failed)', '', '### Pass 1 — Original', fmtGate('Build', b1), fmtGate('Test', t1), fmtGate('Lint', l1), '', '### Pass 2 — After First Auto-Fix', fmtGate('Build', b2), fmtGate('Test', t2), fmtGate('Lint', l2), ].join('\\n'); })()", - "isExpression": true + "message": "Frontend verification failed for {{taskId}}: evidenceDir={{evidenceDir}} reason={{model-review.reason}} evidenceCount={{model-review.evidenceCount}}", + "level": "warn" }, "position": { - "x": 820, - "y": 1820 + "x": 600, + "y": 1200 }, "outputs": [ "default" ] + } + ], + "edges": [ + { + "id": "trigger->select-profile", + "source": "trigger", + "target": "select-profile", + "sourcePort": "default" }, { - "id": "auto-fix-2", - "type": "action.run_agent", - "label": "Auto-Fix (Escalated, Pass 2)", - "config": { - "prompt": "# Fix Validation Failures — FINAL AUTOMATED ATTEMPT\n\nThis is the SECOND and LAST automated remediation pass for task **{{taskTitle}}**.\nThe first auto-fix attempt DID NOT resolve all issues. You MUST take a different approach.\n\nPlan:\n{{plan}}\n\n{{retry2Summary}}\n\nANALYSIS STEPS:\n1. Compare **Failed Targets** between Pass 1 and Pass 2.\n - Same targets still failing → previous fix was wrong, try a different approach.\n - New targets appearing → previous fix broke something else, fix both.\n - Some resolved → partially right, focus on remaining.\n2. Check the **Delta** field to see what changed between runs.\n3. Use the **Rerun** command to iterate on just the failing targets.\n\nCRITICAL RULES:\n- Do NOT repeat the same fix that already failed.\n- If a test is genuinely wrong or testing stale behavior, fix the test AND the code.\n- If build/lint/test configs are misconfigured, fix the config.\n- Do NOT weaken, remove, or skip tests. Do NOT add --force or --no-verify flags.\n- Keep the original task scope — do not revert the feature.\n\nRun build + tests + lint locally and confirm ALL pass before finishing.\nCreate a descriptive commit: \"fix: \"", - "sdk": "{{agentSdk}}", - "timeoutMs": "{{autoFixTimeoutMs}}" - }, - "position": { - "x": 820, - "y": 1900 - }, - "outputs": [ - "default" - ] + "id": "select-profile->run-agent", + "source": "select-profile", + "target": "run-agent", + "sourcePort": "default" }, { - "id": "retry2-build", - "type": "validation.build", - "label": "Build Check", - "config": { - "command": "{{buildCommand}}", - "zeroWarnings": true - }, - "position": { - "x": 400, - "y": 0 - }, - "outputs": [ - "default" - ] + "id": "run-agent->verify-build", + "source": "run-agent", + "target": "verify-build", + "sourcePort": "default" }, { - "id": "retry2-test", - "type": "validation.tests", - "label": "Test Run", - "config": { - "command": "{{testCommand}}", - "timeoutMs": "{{testTimeoutMs}}" - }, + "id": "run-agent->verify-lint", + "source": "run-agent", + "target": "verify-lint", + "sourcePort": "default" + }, + { + "id": "verify-build->screenshot-desktop", + "source": "verify-build", + "target": "screenshot-desktop", + "sourcePort": "default" + }, + { + "id": "verify-build->screenshot-tablet", + "source": "verify-build", + "target": "screenshot-tablet", + "sourcePort": "default" + }, + { + "id": "verify-build->screenshot-mobile", + "source": "verify-build", + "target": "screenshot-mobile", + "sourcePort": "default" + }, + { + "id": "verify-lint->screenshot-desktop", + "source": "verify-lint", + "target": "screenshot-desktop", + "sourcePort": "default" + }, + { + "id": "screenshot-desktop->collect-evidence", + "source": "screenshot-desktop", + "target": "collect-evidence", + "sourcePort": "default" + }, + { + "id": "screenshot-tablet->collect-evidence", + "source": "screenshot-tablet", + "target": "collect-evidence", + "sourcePort": "default" + }, + { + "id": "screenshot-mobile->collect-evidence", + "source": "screenshot-mobile", + "target": "collect-evidence", + "sourcePort": "default" + }, + { + "id": "collect-evidence->model-review", + "source": "collect-evidence", + "target": "model-review", + "sourcePort": "default" + }, + { + "id": "model-review->check-review", + "source": "model-review", + "target": "check-review", + "sourcePort": "default" + }, + { + "id": "check-review->mark-success", + "source": "check-review", + "target": "mark-success", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "check-review->notify-failure", + "source": "check-review", + "target": "notify-failure", + "sourcePort": "default", + "condition": "$output?.result !== true" + }, + { + "id": "mark-success->notify-success", + "source": "mark-success", + "target": "notify-success", + "sourcePort": "default" + }, + { + "id": "notify-failure->log-failure", + "source": "notify-failure", + "target": "log-failure", + "sourcePort": "default" + } + ], + "metadata": { + "author": "bosun-demo", + "createdAt": "2026-03-13T12:00:00.000Z", + "updatedAt": "2026-03-13T12:00:00.000Z", + "templateState": { + "templateId": "template-frontend-agent", + "templateName": "Frontend Agent", + "templateVersion": "1.0.0", + "installedTemplateVersion": "1.0.0", + "isCustomized": false, + "updateAvailable": false + } + } + }, + { + "id": "wf-meeting-subworkflow-chain", + "name": "Meeting Orchestrator + Subworkflow Chain", + "description": "Runs a meeting session start/send/vision/transcript/finalize flow, applies a wake-phrase trigger + transcript quality guard, then invokes a child workflow via action.execute_workflow for post-meeting automation.", + "category": "agents", + "enabled": false, + "nodeCount": 14, + "trigger": "trigger.manual", + "variables": { + "sessionTitle": "Sprint Planning Sync", + "meetingExecutor": "codex", + "wakePhrase": "bosun wake", + "openingMessage": "Kick off planning review. Capture decisions, blockers, and next actions.", + "frameDataUrl": "", + "visionSource": "screen", + "visionPrompt": "Summarize visible meeting context, shared docs, and any blockers shown.", + "visionModel": "", + "visionMinIntervalMs": 1500, + "forceVisionAnalyze": false, + "minTranscriptChars": 140, + "childWorkflowId": "template-task-planner", + "finalizeDisposition": "completed", + "notifyPrefix": ":memo:" + }, + "nodes": [ + { + "id": "trigger", + "type": "trigger.manual", + "label": "Start Meeting Orchestration", + "config": {}, "position": { - "x": 400, - "y": 130 + "x": 450, + "y": 50 }, "outputs": [ "default" ] }, { - "id": "retry2-lint", - "type": "validation.lint", - "label": "Lint Check", + "id": "meeting-start", + "type": "meeting.start", + "label": "Meeting Start", "config": { - "command": "{{lintCommand}}" + "title": "{{sessionTitle}}", + "executor": "{{meetingExecutor}}", + "wakePhrase": "{{wakePhrase}}", + "includeTaskContext": true }, "position": { - "x": 400, - "y": 260 + "x": 450, + "y": 190 }, "outputs": [ "default" ] }, { - "id": "retry2-passed", - "type": "condition.expression", - "label": "Retry-2 Checks Passed?", + "id": "meeting-send", + "type": "meeting.send", + "label": "Send Opening Prompt", "config": { - "expression": "$ctx.getNodeOutput('retry2-build')?.passed === true && $ctx.getNodeOutput('retry2-test')?.passed === true && $ctx.getNodeOutput('retry2-lint')?.passed === true" + "message": "{{openingMessage}}", + "role": "system" }, "position": { - "x": 820, - "y": 2400 + "x": 450, + "y": 320 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "push-branch-retry2", - "type": "action.push_branch", - "label": "Push Branch (Retry 2)", + "id": "meeting-vision", + "type": "meeting.vision", + "label": "Analyze Meeting Frame", "config": { - "worktreePath": "{{worktreePath}}", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "rebaseBeforePush": true, - "mergeBaseBeforePush": true, - "autoResolveMergeConflicts": true, - "conflictResolverSdk": "{{agentSdk}}", - "emptyDiffGuard": true, - "protectedBranches": "{{protectedBranches}}" + "frameDataUrl": "{{frameDataUrl}}", + "source": "{{visionSource}}", + "prompt": "{{visionPrompt}}", + "visionModel": "{{visionModel}}", + "minIntervalMs": "{{visionMinIntervalMs}}", + "forceAnalyze": "{{forceVisionAnalyze}}", + "failOnError": false }, "position": { - "x": 650, - "y": 2470 + "x": 450, + "y": 450 }, "outputs": [ "default" ] }, { - "id": "push-ok-retry2", - "type": "condition.expression", - "label": "Push OK? (Retry 2)", + "id": "meeting-transcript", + "type": "meeting.transcript", + "label": "Capture Transcript", "config": { - "expression": "$ctx.getNodeOutput('push-branch-retry2')?.pushed === true" + "includeMessages": true }, "position": { - "x": 650, - "y": 2530 + "x": 450, + "y": 580 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "create-pr-retry2", - "type": "action.create_pr", - "label": "Handoff PR Lifecycle (After Retry 2)", + "id": "wake-phrase-trigger", + "type": "trigger.meeting.wake_phrase", + "label": "Wake Phrase Trigger", "config": { - "title": "feat: {{taskTitle}}", - "body": "Implements backend task after two auto-fix passes.\n\n**Plan:**\n{{plan}}\n\nValidation passed after 2nd remediation. Bosun lifecycle handoff ready.", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "failOnError": true, - "maxRetries": 3, - "retryDelayMs": 15000, - "continueOnError": true + "wakePhrase": "{{wakePhrase}}", + "text": "{{meeting-transcript.transcript}}", + "mode": "contains" }, "position": { - "x": 650, - "y": 2530 + "x": 450, + "y": 710 }, "outputs": [ "default" ] }, { - "id": "retry2-pr-ok", + "id": "guard-transcript", "type": "condition.expression", - "label": "PR Created?", + "label": "Wake Phrase + Transcript Guard", "config": { - "expression": "Boolean($ctx.getNodeOutput($edge.source)?.prNumber || $ctx.getNodeOutput($edge.source)?.prUrl)" + "expression": "(() => { const transcript = String($ctx.getNodeOutput('meeting-transcript')?.transcript || ''); const minChars = Number($data?.minTranscriptChars || 0); const hasWake = $ctx.getNodeOutput('wake-phrase-trigger')?.triggered === true; return transcript.length >= minChars && hasWake; })()" }, "position": { - "x": 400, - "y": 0 + "x": 450, + "y": 840 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "retry2-set-inreview", - "type": "action.update_task_status", - "label": "Set In-Review", + "id": "notify-guard-failed", + "type": "notify.telegram", + "label": "Notify Guard Failed", "config": { - "taskId": "{{taskId}}", - "status": "inreview", - "taskTitle": "{{taskTitle}}" + "message": "{{notifyPrefix}} Meeting transcript guard failed for **{{sessionTitle}}**. Wake phrase missing or transcript shorter than {{minTranscriptChars}} chars." }, "position": { - "x": 300, - "y": 130 + "x": 840, + "y": 840 }, "outputs": [ "default" ] }, { - "id": "retry2-handoff-progressor", + "id": "execute-child-workflow", "type": "action.execute_workflow", - "label": "Handoff PR Progressor", + "label": "Run Child Workflow", "config": { - "workflowId": "template-bosun-pr-progressor", - "mode": "dispatch", + "workflowId": "{{childWorkflowId}}", + "mode": "sync", + "inheritContext": true, + "includeKeys": [ + "meetingSessionId", + "sessionTitle", + "wakePhrase", + "meetingVisionSummary" + ], "input": { - "taskId": "{{taskId}}", - "taskTitle": "{{taskTitle}}", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}" - } + "parentWorkflowId": "{{_workflowId}}", + "parentRunId": "{{_workflowRunId}}", + "sessionTitle": "{{sessionTitle}}", + "wakePhrase": "{{wakePhrase}}", + "transcript": "{{meeting-transcript.transcript}}", + "visionSummary": "{{meeting-vision.summary}}" + }, + "outputVariable": "childWorkflowResult", + "failOnChildError": false }, "position": { - "x": 300, - "y": 260 + "x": 450, + "y": 980 }, "outputs": [ "default" ] }, { - "id": "notify-done-retry2", - "type": "notify.log", - "label": "Task Complete (After Retry 2)", + "id": "child-workflow-ok", + "type": "condition.expression", + "label": "Child Workflow Succeeded?", "config": { - "message": "Task completion agent finished task after 2nd retry — PR lifecycle handoff recorded", - "level": "info" + "expression": "$ctx.getNodeOutput('execute-child-workflow')?.success === true" }, "position": { - "x": 560, - "y": 2690 + "x": 450, + "y": 1110 }, "outputs": [ "default" ] }, { - "id": "set-blocked-validation", - "type": "action.update_task_status", - "label": "Block Task (Validation Exhausted)", + "id": "notify-chain-success", + "type": "notify.telegram", + "label": "Notify Chain Success", "config": { - "taskId": "{{taskId}}", - "status": "blocked", - "taskTitle": "{{taskTitle}}", - "blockedReason": "Validation failed after 2 automated remediation passes" + "message": "{{notifyPrefix}} Meeting workflow chained into **{{childWorkflowId}}** successfully for **{{sessionTitle}}**." }, "position": { - "x": 1020, - "y": 2470 + "x": 250, + "y": 1230 }, "outputs": [ "default" ] }, { - "id": "notify-fail", + "id": "notify-chain-failed", "type": "notify.telegram", - "label": "Checks Failed (Exhausted)", + "label": "Notify Chain Failure", "config": { - "message": ":alert: Backend agent: validation failed for task {{taskTitle}} even after 2 remediation passes. Task blocked — manual review needed." + "message": ":alert: Meeting flow completed but child workflow **{{childWorkflowId}}** failed or timed out for **{{sessionTitle}}**." }, "position": { - "x": 1020, - "y": 2560 + "x": 650, + "y": 1230 }, "outputs": [ "default" ] }, { - "id": "notify-pr-failed-retry", - "type": "notify.telegram", - "label": "Escalate Lifecycle Failure (Retry Path)", + "id": "meeting-finalize", + "type": "meeting.finalize", + "label": "Finalize Meeting Session", "config": { - "message": ":alert: Task completion agent remediation passed for {{taskTitle}} but Bosun PR lifecycle handoff failed after retries. Manual follow-up required." + "status": "{{finalizeDisposition}}", + "note": "Meeting subworkflow chain finalized." }, "position": { - "x": 620, - "y": 1980 + "x": 450, + "y": 1360 }, "outputs": [ "default" ] }, { - "id": "notify-pr-failed-retry2", - "type": "notify.telegram", - "label": "Escalate Lifecycle Failure (Retry 2)", + "id": "final-log", + "type": "notify.log", + "label": "Record Final Outcome", "config": { - "message": ":alert: Task completion agent 2nd remediation passed for {{taskTitle}} but Bosun PR lifecycle handoff failed. Manual follow-up required." + "message": "Meeting orchestration finalized for {{sessionTitle}} with child workflow {{childWorkflowId}}", + "level": "info" }, "position": { - "x": 820, - "y": 2690 + "x": 450, + "y": 1490 }, "outputs": [ "default" @@ -31316,346 +24986,145 @@ ], "edges": [ { - "id": "trigger->plan-work", + "id": "trigger->meeting-start", "source": "trigger", - "target": "plan-work", - "sourcePort": "default" - }, - { - "id": "plan-work->write-tests", - "source": "plan-work", - "target": "write-tests", - "sourcePort": "default" - }, - { - "id": "write-tests->implement", - "source": "write-tests", - "target": "implement", - "sourcePort": "default" - }, - { - "id": "implement->main-build", - "source": "implement", - "target": "main-build", - "sourcePort": "default" - }, - { - "id": "main-build->main-test", - "source": "main-build", - "target": "main-test", - "sourcePort": "default" - }, - { - "id": "main-test->main-lint", - "source": "main-test", - "target": "main-lint", - "sourcePort": "default" - }, - { - "id": "main-lint->all-passed", - "source": "main-lint", - "target": "all-passed", - "sourcePort": "default" - }, - { - "id": "all-passed->push-branch", - "source": "all-passed", - "target": "push-branch", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "all-passed->set-validation-summary", - "source": "all-passed", - "target": "set-validation-summary", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "push-branch->push-ok", - "source": "push-branch", - "target": "push-ok", - "sourcePort": "default" - }, - { - "id": "push-ok->create-pr", - "source": "push-ok", - "target": "create-pr", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "push-ok->notify-pr-failed", - "source": "push-ok", - "target": "notify-pr-failed", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "create-pr->main-pr-ok", - "source": "create-pr", - "target": "main-pr-ok", - "sourcePort": "default" - }, - { - "id": "main-pr-ok->main-set-inreview", - "source": "main-pr-ok", - "target": "main-set-inreview", - "sourcePort": "yes" - }, - { - "id": "main-set-inreview->main-handoff-progressor", - "source": "main-set-inreview", - "target": "main-handoff-progressor", - "sourcePort": "default" - }, - { - "id": "main-handoff-progressor->notify-done", - "source": "main-handoff-progressor", - "target": "notify-done", - "sourcePort": "default" - }, - { - "id": "main-pr-ok->notify-pr-failed", - "source": "main-pr-ok", - "target": "notify-pr-failed", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "set-validation-summary->auto-fix", - "source": "set-validation-summary", - "target": "auto-fix", + "target": "meeting-start", "sourcePort": "default" }, { - "id": "auto-fix->retry-build", - "source": "auto-fix", - "target": "retry-build", + "id": "meeting-start->meeting-send", + "source": "meeting-start", + "target": "meeting-send", "sourcePort": "default" }, { - "id": "retry-build->retry-test", - "source": "retry-build", - "target": "retry-test", + "id": "meeting-send->meeting-vision", + "source": "meeting-send", + "target": "meeting-vision", "sourcePort": "default" }, { - "id": "retry-test->retry-lint", - "source": "retry-test", - "target": "retry-lint", + "id": "meeting-vision->meeting-transcript", + "source": "meeting-vision", + "target": "meeting-transcript", "sourcePort": "default" }, { - "id": "retry-lint->retry-passed", - "source": "retry-lint", - "target": "retry-passed", + "id": "meeting-transcript->wake-phrase-trigger", + "source": "meeting-transcript", + "target": "wake-phrase-trigger", "sourcePort": "default" }, { - "id": "retry-passed->push-branch-retry", - "source": "retry-passed", - "target": "push-branch-retry", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "retry-passed->set-retry2-summary", - "source": "retry-passed", - "target": "set-retry2-summary", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "push-branch-retry->push-ok-retry", - "source": "push-branch-retry", - "target": "push-ok-retry", + "id": "wake-phrase-trigger->guard-transcript", + "source": "wake-phrase-trigger", + "target": "guard-transcript", "sourcePort": "default" }, { - "id": "push-ok-retry->create-pr-retry", - "source": "push-ok-retry", - "target": "create-pr-retry", + "id": "guard-transcript->execute-child-workflow", + "source": "guard-transcript", + "target": "execute-child-workflow", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "push-ok-retry->notify-pr-failed-retry", - "source": "push-ok-retry", - "target": "notify-pr-failed-retry", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "create-pr-retry->retry-pr-ok", - "source": "create-pr-retry", - "target": "retry-pr-ok", - "sourcePort": "default" - }, - { - "id": "retry-pr-ok->retry-set-inreview", - "source": "retry-pr-ok", - "target": "retry-set-inreview", - "sourcePort": "yes" - }, - { - "id": "retry-set-inreview->retry-handoff-progressor", - "source": "retry-set-inreview", - "target": "retry-handoff-progressor", - "sourcePort": "default" - }, - { - "id": "retry-handoff-progressor->notify-done-retry", - "source": "retry-handoff-progressor", - "target": "notify-done-retry", - "sourcePort": "default" - }, - { - "id": "retry-pr-ok->notify-pr-failed-retry", - "source": "retry-pr-ok", - "target": "notify-pr-failed-retry", + "id": "guard-transcript->notify-guard-failed", + "source": "guard-transcript", + "target": "notify-guard-failed", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "set-retry2-summary->auto-fix-2", - "source": "set-retry2-summary", - "target": "auto-fix-2", - "sourcePort": "default" - }, - { - "id": "auto-fix-2->retry2-build", - "source": "auto-fix-2", - "target": "retry2-build", - "sourcePort": "default" - }, - { - "id": "retry2-build->retry2-test", - "source": "retry2-build", - "target": "retry2-test", - "sourcePort": "default" - }, - { - "id": "retry2-test->retry2-lint", - "source": "retry2-test", - "target": "retry2-lint", - "sourcePort": "default" - }, - { - "id": "retry2-lint->retry2-passed", - "source": "retry2-lint", - "target": "retry2-passed", + "id": "execute-child-workflow->child-workflow-ok", + "source": "execute-child-workflow", + "target": "child-workflow-ok", "sourcePort": "default" }, { - "id": "retry2-passed->push-branch-retry2", - "source": "retry2-passed", - "target": "push-branch-retry2", + "id": "child-workflow-ok->notify-chain-success", + "source": "child-workflow-ok", + "target": "notify-chain-success", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "retry2-passed->set-blocked-validation", - "source": "retry2-passed", - "target": "set-blocked-validation", + "id": "child-workflow-ok->notify-chain-failed", + "source": "child-workflow-ok", + "target": "notify-chain-failed", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "set-blocked-validation->notify-fail", - "source": "set-blocked-validation", - "target": "notify-fail", - "sourcePort": "default" - }, - { - "id": "push-branch-retry2->push-ok-retry2", - "source": "push-branch-retry2", - "target": "push-ok-retry2", + "id": "notify-chain-success->meeting-finalize", + "source": "notify-chain-success", + "target": "meeting-finalize", "sourcePort": "default" }, { - "id": "push-ok-retry2->create-pr-retry2", - "source": "push-ok-retry2", - "target": "create-pr-retry2", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "push-ok-retry2->notify-pr-failed-retry2", - "source": "push-ok-retry2", - "target": "notify-pr-failed-retry2", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "create-pr-retry2->retry2-pr-ok", - "source": "create-pr-retry2", - "target": "retry2-pr-ok", + "id": "notify-chain-failed->meeting-finalize", + "source": "notify-chain-failed", + "target": "meeting-finalize", "sourcePort": "default" }, { - "id": "retry2-pr-ok->retry2-set-inreview", - "source": "retry2-pr-ok", - "target": "retry2-set-inreview", - "sourcePort": "yes" - }, - { - "id": "retry2-set-inreview->retry2-handoff-progressor", - "source": "retry2-set-inreview", - "target": "retry2-handoff-progressor", + "id": "notify-guard-failed->meeting-finalize", + "source": "notify-guard-failed", + "target": "meeting-finalize", "sourcePort": "default" }, { - "id": "retry2-handoff-progressor->notify-done-retry2", - "source": "retry2-handoff-progressor", - "target": "notify-done-retry2", + "id": "meeting-finalize->final-log", + "source": "meeting-finalize", + "target": "final-log", "sourcePort": "default" - }, - { - "id": "retry2-pr-ok->notify-pr-failed-retry2", - "source": "retry2-pr-ok", - "target": "notify-pr-failed-retry2", - "sourcePort": "no", - "condition": "$output?.result !== true" } ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-19T12:00:00.000Z", - "updatedAt": "2026-03-19T12:00:00.000Z", + "createdAt": "2026-03-14T12:00:00.000Z", + "updatedAt": "2026-03-14T12:00:00.000Z", "templateState": { - "templateId": "template-backend-agent", - "templateName": "Task Completion Agent", - "templateVersion": "3.0.0", - "installedTemplateVersion": "3.0.0", + "templateId": "template-meeting-subworkflow-chain", + "templateName": "Meeting Orchestrator + Subworkflow Chain", + "templateVersion": "1.0.0", + "installedTemplateVersion": "1.0.0", "isCustomized": false, "updateAvailable": false } } }, { - "id": "wf-voice-video-parallel-rollout", - "name": "Voice + Video Rollout (Parallel Lanes)", - "description": "Launches three agent lanes in parallel (capture pipeline, provider adapters, and QA/rollout hardening) to accelerate Voice + Video delivery while keeping workstreams isolated by worktree.", + "id": "wf-backend-agent", + "name": "Task Completion Agent", + "description": "General-purpose task completion agent with a test-first methodology. Writes tests first, implements the feature, validates with build + lint, then creates a PR. Works with any language/framework — commands are auto-detected from your project or fully customizable.", "category": "agents", - "enabled": false, - "nodeCount": 11, - "trigger": "trigger.manual", + "enabled": true, + "nodeCount": 29, + "trigger": "trigger.task_assigned", "variables": { - "lane1Worktree": "{{worktreePath}}", - "lane2Worktree": "{{worktreePath}}", - "lane3Worktree": "{{worktreePath}}", - "integrationBranch": "feat/voice-video-integration", - "definitionOfDone": "Voice + vision works end-to-end, provider fallback is explicit, and tests cover config + transport + failure paths." + "testCommand": "npm test", + "buildCommand": "npm run build", + "lintCommand": "", + "baseBranch": "main", + "protectedBranches": [ + "main", + "master", + "develop", + "production" + ], + "agentSdk": "auto", + "timeoutMs": 3600000, + "autoFixTimeoutMs": 1200000 }, "nodes": [ { "id": "trigger", - "type": "trigger.manual", - "label": "Launch Parallel Rollout", + "type": "trigger.task_assigned", + "label": "Task Assigned", "config": {}, "position": { - "x": 500, + "x": 400, "y": 50 }, "outputs": [ @@ -31663,493 +25132,395 @@ ] }, { - "id": "check-worktrees", - "type": "condition.expression", - "label": "Worktrees Distinct?", + "id": "plan-work", + "type": "agent.run_planner", + "label": "Plan Implementation", "config": { - "expression": "(() => { const a = String($data?.lane1Worktree || '').trim(); const b = String($data?.lane2Worktree || '').trim(); const c = String($data?.lane3Worktree || '').trim(); if (!a || !b || !c) return false; return new Set([a, b, c]).size === 3; })()" + "prompt": "Analyze the task requirements and create a step-by-step implementation plan. Identify which files need to be modified, what tests need to be written, and any API contracts to maintain.", + "outputVariable": "plan", + "repoMapQuery": "{{taskTitle}} {{taskDescription}}", + "repoMapFileLimit": 8 }, "position": { - "x": 500, - "y": 170 + "x": 400, + "y": 180 }, "outputs": [ "default" ] }, { - "id": "notify-worktree-error", - "type": "notify.telegram", - "label": "Invalid Worktree Setup", + "id": "write-tests", + "type": "action.run_agent", + "label": "Write Tests First", "config": { - "message": "Parallel rollout aborted. Configure three distinct worktrees in `lane1Worktree`, `lane2Worktree`, and `lane3Worktree` before launching." + "prompt": "# Test-First Development\n\nBased on the plan:\n{{plan}}\n\nWrite comprehensive tests FIRST before any implementation:\n1. Unit tests for new functions/methods\n2. Integration tests for API endpoints if applicable\n3. Edge cases and error scenarios\n\nUse the project's test command: {{testCommand}}\nCommit with message \"test: add tests for [feature]\"", + "sdk": "{{agentSdk}}", + "timeoutMs": "{{timeoutMs}}" }, "position": { - "x": 860, - "y": 170 + "x": 400, + "y": 330 }, "outputs": [ "default" ] }, { - "id": "kickoff-log", - "type": "notify.log", - "label": "Kickoff Parallel Lanes", + "id": "implement", + "type": "action.run_agent", + "label": "Implement Feature", "config": { - "message": "Starting parallel rollout on branch {{integrationBranch}} with 3 lanes.", - "level": "info" + "prompt": "# Implement Feature\n\nThe tests have been written. Now implement the feature to make them pass:\n1. Follow existing code conventions\n2. Add proper error handling\n3. Ensure all new tests pass\n4. Do NOT modify the tests — make the code fit the contract\n\nRun `{{testCommand}}` after implementation.\nCommit with message \"feat: implement [feature]\"", + "sdk": "{{agentSdk}}", + "timeoutMs": "{{timeoutMs}}" }, "position": { - "x": 500, - "y": 290 + "x": 400, + "y": 490 }, "outputs": [ "default" ] }, { - "id": "lane-capture-core", - "type": "action.run_agent", - "label": "Lane 1: Capture Core", + "id": "main-build", + "type": "validation.build", + "label": "Build Check", "config": { - "prompt": "# Lane 1 - Capture Core\n\nWork only in this lane's worktree. Focus on:\n1. Voice video config/schema/env/settings keys\n2. Browser capture loop (screen/camera), adaptive FPS, compression, change detection\n3. Overlay controls + capture state indicators\n\nGuardrails:\n- Do not touch provider dispatch code owned by Lane 2\n- Keep changes bounded to UI/config paths\n- Add/extend tests for capture throttling and config behavior\n\nTarget branch: {{integrationBranch}}\nDefinition of done: {{definitionOfDone}}", - "sdk": "auto", - "cwd": "{{lane1Worktree}}", - "timeoutMs": 5400000, - "includeTaskContext": false, - "failOnError": true + "command": "{{buildCommand}}", + "zeroWarnings": true }, "position": { - "x": 120, - "y": 450 + "x": 400, + "y": 0 }, "outputs": [ "default" ] }, { - "id": "lane-provider-bridge", - "type": "action.run_agent", - "label": "Lane 2: Provider Bridge", + "id": "main-test", + "type": "validation.tests", + "label": "Test Run", "config": { - "prompt": "# Lane 2 - Provider Bridge\n\nWork only in this lane's worktree. Focus on:\n1. Server-side vision frame ingress route and validation\n2. Provider dispatch in voice relay (OpenAI image path, Gemini live path, Claude vision path)\n3. Rate-limits, payload caps, and fallback semantics\n\nGuardrails:\n- Do not edit overlay/capture UI owned by Lane 1\n- Keep provider logic behind explicit feature flags\n- Add/extend tests for endpoint validation and provider routing\n\nTarget branch: {{integrationBranch}}\nDefinition of done: {{definitionOfDone}}", - "sdk": "auto", - "cwd": "{{lane2Worktree}}", - "timeoutMs": 5400000, - "includeTaskContext": false, - "failOnError": true + "command": "{{testCommand}}" }, "position": { - "x": 500, - "y": 450 + "x": 400, + "y": 130 }, "outputs": [ "default" ] }, { - "id": "lane-hardening", - "type": "action.run_agent", - "label": "Lane 3: QA + Rollout", + "id": "main-lint", + "type": "validation.lint", + "label": "Lint Check", "config": { - "prompt": "# Lane 3 - QA + Rollout Hardening\n\nWork only in this lane's worktree. Focus on:\n1. Integration tests, resilience tests, and docs updates\n2. Migration/rollout notes and operator controls\n3. Conflict-free merge guidance across Lane 1 and Lane 2 outputs\n\nGuardrails:\n- Avoid touching core capture loop and provider dispatch internals unless a test proves breakage\n- Keep this lane focused on verification, docs, and release safety\n- Produce a concise verification summary\n\nTarget branch: {{integrationBranch}}\nDefinition of done: {{definitionOfDone}}", - "sdk": "auto", - "cwd": "{{lane3Worktree}}", - "timeoutMs": 3600000, - "includeTaskContext": false, - "failOnError": true + "command": "{{lintCommand}}" }, "position": { - "x": 880, - "y": 450 + "x": 400, + "y": 260 }, "outputs": [ "default" ] }, { - "id": "aggregate", - "type": "transform.aggregate", - "label": "Aggregate Lane Results", + "id": "all-passed", + "type": "condition.expression", + "label": "All Checks Passed?", "config": { - "sources": [ - "lane-capture-core", - "lane-provider-bridge", - "lane-hardening" - ] + "expression": "$ctx.getNodeOutput('main-build')?.passed === true && $ctx.getNodeOutput('main-test')?.passed === true && $ctx.getNodeOutput('main-lint')?.passed === true" }, "position": { - "x": 500, - "y": 640 + "x": 400, + "y": 1040 + }, + "outputs": [ + "yes", + "no" + ] + }, + { + "id": "push-branch", + "type": "action.push_branch", + "label": "Push Branch", + "config": { + "worktreePath": "{{worktreePath}}", + "branch": "{{branch}}", + "baseBranch": "{{baseBranch}}", + "rebaseBeforePush": true, + "emptyDiffGuard": true, + "protectedBranches": "{{protectedBranches}}" + }, + "position": { + "x": 250, + "y": 1110 + }, + "outputs": [ + "default" + ] + }, + { + "id": "create-pr", + "type": "action.create_pr", + "label": "Handoff PR Lifecycle", + "config": { + "title": "feat: {{taskTitle}}", + "body": "Implements backend task with test-first methodology.\n\n**Plan:**\n{{plan}}\n\nAll tests passing. Bosun lifecycle handoff ready.", + "branch": "{{branch}}", + "baseBranch": "{{baseBranch}}", + "failOnError": true, + "maxRetries": 3, + "retryDelayMs": 15000, + "continueOnError": true + }, + "position": { + "x": 250, + "y": 1170 }, "outputs": [ "default" ] }, { - "id": "all-passed", - "type": "condition.expression", - "label": "All Lanes Passed?", + "id": "main-pr-ok", + "type": "condition.expression", + "label": "PR Created?", + "config": { + "expression": "Boolean($ctx.getNodeOutput($edge.source)?.prNumber || $ctx.getNodeOutput($edge.source)?.prUrl)" + }, + "position": { + "x": 400, + "y": 0 + }, + "outputs": [ + "yes", + "no" + ] + }, + { + "id": "main-set-inreview", + "type": "action.update_task_status", + "label": "Set In-Review", "config": { - "expression": "$ctx.getNodeOutput('lane-capture-core')?.success === true && $ctx.getNodeOutput('lane-provider-bridge')?.success === true && $ctx.getNodeOutput('lane-hardening')?.success === true" + "taskId": "{{taskId}}", + "status": "inreview", + "taskTitle": "{{taskTitle}}" }, "position": { - "x": 500, - "y": 770 + "x": 300, + "y": 130 }, "outputs": [ "default" ] }, { - "id": "notify-success", - "type": "notify.telegram", - "label": "Notify Success", + "id": "main-handoff-progressor", + "type": "action.execute_workflow", + "label": "Handoff PR Progressor", "config": { - "message": "Parallel Voice + Video rollout lanes completed successfully on {{integrationBranch}}. Proceed to integration and final verification." + "workflowId": "template-bosun-pr-progressor", + "mode": "dispatch", + "input": { + "taskId": "{{taskId}}", + "taskTitle": "{{taskTitle}}", + "branch": "{{branch}}", + "baseBranch": "{{baseBranch}}" + } }, "position": { "x": 300, - "y": 910 + "y": 260 }, "outputs": [ "default" ] }, { - "id": "notify-failure", - "type": "notify.telegram", - "label": "Notify Failure", + "id": "notify-done", + "type": "notify.log", + "label": "Task Complete", "config": { - "message": "Parallel Voice + Video rollout has lane failures on {{integrationBranch}}. Inspect lane outputs before integration." + "message": "Task completion agent finished task — PR lifecycle handoff recorded", + "level": "info" }, "position": { - "x": 700, - "y": 910 + "x": 180, + "y": 1320 }, "outputs": [ "default" ] - } - ], - "edges": [ - { - "id": "trigger->check-worktrees", - "source": "trigger", - "target": "check-worktrees", - "sourcePort": "default" - }, - { - "id": "check-worktrees->kickoff-log", - "source": "check-worktrees", - "target": "kickoff-log", - "sourcePort": "default", - "condition": "$output?.result === true" - }, - { - "id": "check-worktrees->notify-worktree-error", - "source": "check-worktrees", - "target": "notify-worktree-error", - "sourcePort": "default", - "condition": "$output?.result !== true" - }, - { - "id": "kickoff-log->lane-capture-core", - "source": "kickoff-log", - "target": "lane-capture-core", - "sourcePort": "default" - }, - { - "id": "kickoff-log->lane-provider-bridge", - "source": "kickoff-log", - "target": "lane-provider-bridge", - "sourcePort": "default" - }, - { - "id": "kickoff-log->lane-hardening", - "source": "kickoff-log", - "target": "lane-hardening", - "sourcePort": "default" - }, - { - "id": "lane-capture-core->aggregate", - "source": "lane-capture-core", - "target": "aggregate", - "sourcePort": "default" - }, - { - "id": "lane-provider-bridge->aggregate", - "source": "lane-provider-bridge", - "target": "aggregate", - "sourcePort": "default" - }, - { - "id": "lane-hardening->aggregate", - "source": "lane-hardening", - "target": "aggregate", - "sourcePort": "default" - }, - { - "id": "aggregate->all-passed", - "source": "aggregate", - "target": "all-passed", - "sourcePort": "default" - }, - { - "id": "all-passed->notify-success", - "source": "all-passed", - "target": "notify-success", - "sourcePort": "default", - "condition": "$output?.result === true" }, { - "id": "all-passed->notify-failure", - "source": "all-passed", - "target": "notify-failure", - "sourcePort": "default", - "condition": "$output?.result !== true" - } - ], - "metadata": { - "author": "bosun-demo", - "createdAt": "2026-03-20T12:00:00.000Z", - "updatedAt": "2026-03-20T12:00:00.000Z", - "templateState": { - "templateId": "template-voice-video-parallel-rollout", - "templateName": "Voice + Video Rollout (Parallel Lanes)", - "templateVersion": "1.0.0", - "installedTemplateVersion": "1.0.0", - "isCustomized": false, - "updateAvailable": false - } - } - }, - { - "id": "wf-build-deploy", - "name": "Build & Deploy", - "description": "Complete CI/CD-style pipeline: build → test → lint → deploy. Configurable deployment commands for any hosting target.", - "category": "ci-cd", - "enabled": false, - "nodeCount": 6, - "trigger": "trigger.event", - "variables": { - "deployCommand": "npm run deploy", - "deployBranch": "main" - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.event", - "label": "On PR Merged", + "id": "notify-pr-failed", + "type": "notify.telegram", + "label": "Escalate Lifecycle Handoff Failure", "config": { - "eventType": "pr.merged", - "filter": "$event.branch === '{{deployBranch}}'" + "message": ":alert: Task completion agent passed validation for {{taskTitle}} but failed to record Bosun PR lifecycle handoff after retries. Manual follow-up required." }, "position": { - "x": 400, - "y": 50 + "x": 420, + "y": 1320 }, "outputs": [ "default" ] }, { - "id": "build", - "type": "validation.build", - "label": "Build", + "id": "set-validation-summary", + "type": "action.set_variable", + "label": "Summarize Validation Output", "config": { - "command": "npm run build", - "zeroWarnings": true + "key": "validationSummary", + "value": "(() => { const implement = $ctx.getNodeOutput('implement') || {}; const build = $ctx.getNodeOutput('main-build') || {}; const test = $ctx.getNodeOutput('main-test') || {}; const lint = $ctx.getNodeOutput('main-lint') || {}; return ['- implement.success: ' + (implement.success === true), '- build.passed: ' + (build.passed === true), '- test-final.passed: ' + (test.passed === true), '- lint.passed: ' + (lint.passed === true), '', 'Build output:', String(build.output || '').slice(0, 6000), '', 'Test output:', String(test.output || '').slice(0, 6000), '', 'Lint output:', String(lint.output || '').slice(0, 6000)].join('\\n'); })()", + "isExpression": true }, "position": { - "x": 400, - "y": 180 + "x": 620, + "y": 1090 }, "outputs": [ "default" ] }, { - "id": "test", - "type": "validation.tests", - "label": "Tests", + "id": "auto-fix", + "type": "action.run_agent", + "label": "Auto-Fix Validation Failures", "config": { - "command": "npm test" + "prompt": "# Fix Validation Failures\n\nThe first validation pass failed for task **{{taskTitle}}**.\n\nPlan:\n{{plan}}\n\nCurrent validation outputs:\n{{validationSummary}}\n\nFix the code so build/tests/lint pass.\nDo NOT weaken, remove, or bypass tests.\nKeep the original task scope.\n\nRun build + tests + lint locally before finishing.\nCommit with message \"fix: address validation failures\"", + "sdk": "{{agentSdk}}", + "timeoutMs": "{{autoFixTimeoutMs}}" }, "position": { - "x": 400, - "y": 310 + "x": 620, + "y": 1170 }, "outputs": [ "default" ] }, { - "id": "lint", - "type": "validation.lint", - "label": "Lint", + "id": "retry-build", + "type": "validation.build", + "label": "Build Check", "config": { - "command": "npm run lint" + "command": "{{buildCommand}}", + "zeroWarnings": true }, "position": { "x": 400, - "y": 440 + "y": 0 }, "outputs": [ "default" ] }, { - "id": "deploy", - "type": "action.run_command", - "label": "Deploy", + "id": "retry-test", + "type": "validation.tests", + "label": "Test Run", "config": { - "command": "{{deployCommand}}" + "command": "{{testCommand}}" }, "position": { "x": 400, - "y": 570 + "y": 130 }, "outputs": [ "default" ] }, { - "id": "notify", - "type": "notify.telegram", - "label": "Notify Deploy", + "id": "retry-lint", + "type": "validation.lint", + "label": "Lint Check", "config": { - "message": ":rocket: Deployment to production completed for {{branch}}" + "command": "{{lintCommand}}" }, "position": { "x": 400, - "y": 700 + "y": 260 }, "outputs": [ "default" ] - } - ], - "edges": [ - { - "id": "trigger->build", - "source": "trigger", - "target": "build", - "sourcePort": "default" - }, - { - "id": "build->test", - "source": "build", - "target": "test", - "sourcePort": "default" - }, - { - "id": "test->lint", - "source": "test", - "target": "lint", - "sourcePort": "default" - }, - { - "id": "lint->deploy", - "source": "lint", - "target": "deploy", - "sourcePort": "default" }, { - "id": "deploy->notify", - "source": "deploy", - "target": "notify", - "sourcePort": "default" - } - ], - "metadata": { - "author": "bosun-demo", - "createdAt": "2026-03-21T12:00:00.000Z", - "updatedAt": "2026-03-21T12:00:00.000Z", - "templateState": { - "templateId": "template-build-deploy", - "templateName": "Build & Deploy", - "templateVersion": "1.0.0", - "installedTemplateVersion": "1.0.0", - "isCustomized": false, - "updateAvailable": false - } - } - }, - { - "id": "wf-canary-deploy", - "name": "Canary Deploy", - "description": "Two-phase deployment: deploy to a staging/canary environment first, run smoke tests, then promote to production or auto-rollback on failure. Reduces blast radius of bad deploys.", - "category": "ci-cd", - "enabled": false, - "nodeCount": 12, - "trigger": "trigger.manual", - "variables": { - "stagingCommand": "npm run deploy:staging", - "productionCommand": "npm run deploy:production", - "rollbackCommand": "npm run deploy:rollback", - "smokeTestCommand": "npm run test:smoke", - "promotionDelayMs": 300000 - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.manual", - "label": "Deploy Canary", + "id": "retry-passed", + "type": "condition.expression", + "label": "Retry Checks Passed?", "config": { - "description": "Start a canary deployment" + "expression": "$ctx.getNodeOutput('retry-build')?.passed === true && $ctx.getNodeOutput('retry-test')?.passed === true && $ctx.getNodeOutput('retry-lint')?.passed === true" }, "position": { - "x": 400, - "y": 50 + "x": 620, + "y": 1690 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "build", - "type": "validation.build", - "label": "Build", + "id": "push-branch-retry", + "type": "action.push_branch", + "label": "Push Branch (Retry)", "config": { - "command": "npm run build", - "zeroWarnings": true + "worktreePath": "{{worktreePath}}", + "branch": "{{branch}}", + "baseBranch": "{{baseBranch}}", + "rebaseBeforePush": true, + "emptyDiffGuard": true, + "protectedBranches": "{{protectedBranches}}" }, "position": { - "x": 400, - "y": 180 + "x": 450, + "y": 1760 }, "outputs": [ "default" ] }, { - "id": "deploy-staging", - "type": "action.run_command", - "label": "Deploy to Staging", + "id": "create-pr-retry", + "type": "action.create_pr", + "label": "Handoff PR Lifecycle (After Retry)", "config": { - "command": "{{stagingCommand}}", + "title": "feat: {{taskTitle}}", + "body": "Implements backend task after auto-fix retry.\n\n**Plan:**\n{{plan}}\n\nValidation passed after remediation. Bosun lifecycle handoff ready.", + "branch": "{{branch}}", + "baseBranch": "{{baseBranch}}", + "failOnError": true, + "maxRetries": 3, + "retryDelayMs": 15000, "continueOnError": true }, "position": { - "x": 400, - "y": 310 + "x": 450, + "y": 1820 }, "outputs": [ "default" ] }, { - "id": "staging-ok", + "id": "retry-pr-ok", "type": "condition.expression", - "label": "Staging Deploy OK?", + "label": "PR Created?", "config": { - "expression": "$ctx.getNodeOutput('deploy-staging')?.success === true" + "expression": "Boolean($ctx.getNodeOutput($edge.source)?.prNumber || $ctx.getNodeOutput($edge.source)?.prUrl)" }, "position": { "x": 400, - "y": 440 + "y": 0 }, "outputs": [ "yes", @@ -32157,239 +25528,304 @@ ] }, { - "id": "smoke-tests", - "type": "action.run_command", - "label": "Run Smoke Tests", + "id": "retry-set-inreview", + "type": "action.update_task_status", + "label": "Set In-Review", "config": { - "command": "{{smokeTestCommand}}", - "continueOnError": true + "taskId": "{{taskId}}", + "status": "inreview", + "taskTitle": "{{taskTitle}}" }, "position": { - "x": 250, - "y": 570 + "x": 300, + "y": 130 }, "outputs": [ "default" ] }, { - "id": "smoke-passed", - "type": "condition.expression", - "label": "Smoke Tests Passed?", + "id": "retry-handoff-progressor", + "type": "action.execute_workflow", + "label": "Handoff PR Progressor", "config": { - "expression": "$ctx.getNodeOutput('smoke-tests')?.success === true" + "workflowId": "template-bosun-pr-progressor", + "mode": "dispatch", + "input": { + "taskId": "{{taskId}}", + "taskTitle": "{{taskTitle}}", + "branch": "{{branch}}", + "baseBranch": "{{baseBranch}}" + } }, "position": { - "x": 250, - "y": 700 + "x": 300, + "y": 260 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "wait-bake", - "type": "action.delay", - "label": "Bake Time", + "id": "notify-done-retry", + "type": "notify.log", + "label": "Task Complete (After Retry)", "config": { - "ms": "{{promotionDelayMs}}", - "reason": "Waiting for bake time before promoting to production" + "message": "Task completion agent finished task after retry — PR lifecycle handoff recorded", + "level": "info" }, "position": { - "x": 100, - "y": 830 + "x": 360, + "y": 1980 }, "outputs": [ "default" ] }, { - "id": "promote-prod", - "type": "action.run_command", - "label": "Promote to Production", + "id": "notify-fail", + "type": "notify.telegram", + "label": "Checks Failed", "config": { - "command": "{{productionCommand}}" + "message": ":alert: Task completion agent: validation failed for task {{taskTitle}} even after remediation pass. Manual review needed." }, "position": { - "x": 100, - "y": 960 + "x": 820, + "y": 1820 }, "outputs": [ "default" ] }, { - "id": "notify-success", + "id": "notify-pr-failed-retry", "type": "notify.telegram", - "label": "Deploy Succeeded", + "label": "Escalate Lifecycle Failure (Retry Path)", "config": { - "message": ":check: **Canary deploy promoted to production** successfully." + "message": ":alert: Task completion agent remediation passed for {{taskTitle}} but Bosun PR lifecycle handoff failed after retries. Manual follow-up required." }, "position": { - "x": 100, - "y": 1090 + "x": 620, + "y": 1980 }, "outputs": [ "default" ] + } + ], + "edges": [ + { + "id": "trigger->plan-work", + "source": "trigger", + "target": "plan-work", + "sourcePort": "default" }, { - "id": "rollback", - "type": "action.run_command", - "label": "Rollback", - "config": { - "command": "{{rollbackCommand}}", - "continueOnError": true - }, - "position": { - "x": 550, - "y": 700 - }, - "outputs": [ - "default" - ] + "id": "plan-work->write-tests", + "source": "plan-work", + "target": "write-tests", + "sourcePort": "default" + }, + { + "id": "write-tests->implement", + "source": "write-tests", + "target": "implement", + "sourcePort": "default" + }, + { + "id": "implement->main-build", + "source": "implement", + "target": "main-build", + "sourcePort": "default" + }, + { + "id": "main-build->main-test", + "source": "main-build", + "target": "main-test", + "sourcePort": "default" + }, + { + "id": "main-test->main-lint", + "source": "main-test", + "target": "main-lint", + "sourcePort": "default" + }, + { + "id": "main-lint->all-passed", + "source": "main-lint", + "target": "all-passed", + "sourcePort": "default" + }, + { + "id": "all-passed->push-branch", + "source": "all-passed", + "target": "push-branch", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "all-passed->set-validation-summary", + "source": "all-passed", + "target": "set-validation-summary", + "sourcePort": "no", + "condition": "$output?.result !== true" + }, + { + "id": "push-branch->create-pr", + "source": "push-branch", + "target": "create-pr", + "sourcePort": "default" + }, + { + "id": "create-pr->main-pr-ok", + "source": "create-pr", + "target": "main-pr-ok", + "sourcePort": "default" + }, + { + "id": "main-pr-ok->main-set-inreview", + "source": "main-pr-ok", + "target": "main-set-inreview", + "sourcePort": "yes" + }, + { + "id": "main-set-inreview->main-handoff-progressor", + "source": "main-set-inreview", + "target": "main-handoff-progressor", + "sourcePort": "default" + }, + { + "id": "main-handoff-progressor->notify-done", + "source": "main-handoff-progressor", + "target": "notify-done", + "sourcePort": "default" }, { - "id": "notify-rollback", - "type": "notify.telegram", - "label": "Deploy Rolled Back", - "config": { - "message": ":refresh: **Canary deploy rolled back.**\n\nSmoke tests or staging deploy failed. Production unchanged." - }, - "position": { - "x": 550, - "y": 830 - }, - "outputs": [ - "default" - ] + "id": "main-pr-ok->notify-pr-failed", + "source": "main-pr-ok", + "target": "notify-pr-failed", + "sourcePort": "no", + "condition": "$output?.result !== true" }, { - "id": "notify-staging-fail", - "type": "notify.telegram", - "label": "Staging Failed", - "config": { - "message": ":close: **Staging deploy failed.** Not proceeding to canary phase." - }, - "position": { - "x": 600, - "y": 440 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ + "id": "set-validation-summary->auto-fix", + "source": "set-validation-summary", + "target": "auto-fix", + "sourcePort": "default" + }, { - "id": "trigger->build", - "source": "trigger", - "target": "build", + "id": "auto-fix->retry-build", + "source": "auto-fix", + "target": "retry-build", "sourcePort": "default" }, { - "id": "build->deploy-staging", - "source": "build", - "target": "deploy-staging", + "id": "retry-build->retry-test", + "source": "retry-build", + "target": "retry-test", "sourcePort": "default" }, { - "id": "deploy-staging->staging-ok", - "source": "deploy-staging", - "target": "staging-ok", + "id": "retry-test->retry-lint", + "source": "retry-test", + "target": "retry-lint", "sourcePort": "default" }, { - "id": "staging-ok->smoke-tests", - "source": "staging-ok", - "target": "smoke-tests", + "id": "retry-lint->retry-passed", + "source": "retry-lint", + "target": "retry-passed", + "sourcePort": "default" + }, + { + "id": "retry-passed->push-branch-retry", + "source": "retry-passed", + "target": "push-branch-retry", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "staging-ok->notify-staging-fail", - "source": "staging-ok", - "target": "notify-staging-fail", + "id": "retry-passed->notify-fail", + "source": "retry-passed", + "target": "notify-fail", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "smoke-tests->smoke-passed", - "source": "smoke-tests", - "target": "smoke-passed", + "id": "push-branch-retry->create-pr-retry", + "source": "push-branch-retry", + "target": "create-pr-retry", "sourcePort": "default" }, { - "id": "smoke-passed->wait-bake", - "source": "smoke-passed", - "target": "wait-bake", - "sourcePort": "yes", - "condition": "$output?.result === true" + "id": "create-pr-retry->retry-pr-ok", + "source": "create-pr-retry", + "target": "retry-pr-ok", + "sourcePort": "default" }, { - "id": "smoke-passed->rollback", - "source": "smoke-passed", - "target": "rollback", - "sourcePort": "no", - "condition": "$output?.result !== true" + "id": "retry-pr-ok->retry-set-inreview", + "source": "retry-pr-ok", + "target": "retry-set-inreview", + "sourcePort": "yes" }, { - "id": "wait-bake->promote-prod", - "source": "wait-bake", - "target": "promote-prod", + "id": "retry-set-inreview->retry-handoff-progressor", + "source": "retry-set-inreview", + "target": "retry-handoff-progressor", "sourcePort": "default" }, { - "id": "promote-prod->notify-success", - "source": "promote-prod", - "target": "notify-success", + "id": "retry-handoff-progressor->notify-done-retry", + "source": "retry-handoff-progressor", + "target": "notify-done-retry", "sourcePort": "default" }, { - "id": "rollback->notify-rollback", - "source": "rollback", - "target": "notify-rollback", - "sourcePort": "default" + "id": "retry-pr-ok->notify-pr-failed-retry", + "source": "retry-pr-ok", + "target": "notify-pr-failed-retry", + "sourcePort": "no", + "condition": "$output?.result !== true" } ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-22T12:00:00.000Z", - "updatedAt": "2026-03-22T12:00:00.000Z", + "createdAt": "2026-03-15T12:00:00.000Z", + "updatedAt": "2026-03-15T12:00:00.000Z", "templateState": { - "templateId": "template-canary-deploy", - "templateName": "Canary Deploy", - "templateVersion": "1.0.0", - "installedTemplateVersion": "1.0.0", + "templateId": "template-backend-agent", + "templateName": "Task Completion Agent", + "templateVersion": "2.0.0", + "installedTemplateVersion": "2.0.0", "isCustomized": false, "updateAvailable": false } } }, { - "id": "wf-release-pipeline", - "name": "Release Pipeline", - "description": "End-to-end release automation: version bump, changelog generation, build, test, npm publish, GitHub release creation, and team notification. Triggered manually or on a schedule for regular release cadences.", - "category": "ci-cd", - "enabled": true, - "nodeCount": 14, + "id": "wf-voice-video-parallel-rollout", + "name": "Voice + Video Rollout (Parallel Lanes)", + "description": "Launches three agent lanes in parallel (capture pipeline, provider adapters, and QA/rollout hardening) to accelerate Voice + Video delivery while keeping workstreams isolated by worktree.", + "category": "agents", + "enabled": false, + "nodeCount": 11, "trigger": "trigger.manual", "variables": { - "bumpType": "patch", - "publishToNpm": true, - "dryRun": false + "lane1Worktree": "{{worktreePath}}", + "lane2Worktree": "{{worktreePath}}", + "lane3Worktree": "{{worktreePath}}", + "integrationBranch": "feat/voice-video-integration", + "definitionOfDone": "Voice + vision works end-to-end, provider fallback is explicit, and tests cover config + transport + failure paths." }, "nodes": [ { "id": "trigger", "type": "trigger.manual", - "label": "Start Release", - "config": { - "description": "Kick off a new release" - }, + "label": "Launch Parallel Rollout", + "config": {}, "position": { - "x": 400, + "x": 500, "y": 50 }, "outputs": [ @@ -32397,193 +25833,140 @@ ] }, { - "id": "bump-version", - "type": "action.run_command", - "label": "Bump Version", + "id": "check-worktrees", + "type": "condition.expression", + "label": "Worktrees Distinct?", "config": { - "command": "npm version {{bumpType}} --no-git-tag-version" + "expression": "(() => { const a = String($data?.lane1Worktree || '').trim(); const b = String($data?.lane2Worktree || '').trim(); const c = String($data?.lane3Worktree || '').trim(); if (!a || !b || !c) return false; return new Set([a, b, c]).size === 3; })()" }, "position": { - "x": 400, - "y": 180 + "x": 500, + "y": 170 }, "outputs": [ "default" ] }, { - "id": "read-version", - "type": "action.run_command", - "label": "Read New Version", + "id": "notify-worktree-error", + "type": "notify.telegram", + "label": "Invalid Worktree Setup", "config": { - "command": "node -p \"require('./package.json').version\"" + "message": "Parallel rollout aborted. Configure three distinct worktrees in `lane1Worktree`, `lane2Worktree`, and `lane3Worktree` before launching." }, "position": { - "x": 400, - "y": 310 + "x": 860, + "y": 170 }, "outputs": [ "default" ] }, { - "id": "set-version", - "type": "action.set_variable", - "label": "Set Version Variable", + "id": "kickoff-log", + "type": "notify.log", + "label": "Kickoff Parallel Lanes", "config": { - "key": "version", - "value": "(() => String($ctx.getNodeOutput('read-version')?.output || '').trim())()", - "isExpression": true + "message": "Starting parallel rollout on branch {{integrationBranch}} with 3 lanes.", + "level": "info" }, "position": { - "x": 400, - "y": 380 + "x": 500, + "y": 290 }, "outputs": [ "default" ] }, { - "id": "generate-changelog", + "id": "lane-capture-core", "type": "action.run_agent", - "label": "Generate Changelog", + "label": "Lane 1: Capture Core", "config": { - "prompt": "# Generate Changelog Entry\n\nRead the git log since the last tag:\n```\ngit log $(git describe --tags --abbrev=0)..HEAD --oneline\n```\n\nGroup commits into categories (Features, Fixes, Refactors, Docs, etc.)\nfollowing the Keep a Changelog format.\n\nWrite the entry to CHANGELOG.md under a new version heading.\nCommit the result with message \"docs: update changelog for vX.Y.Z\".", + "prompt": "# Lane 1 - Capture Core\n\nWork only in this lane's worktree. Focus on:\n1. Voice video config/schema/env/settings keys\n2. Browser capture loop (screen/camera), adaptive FPS, compression, change detection\n3. Overlay controls + capture state indicators\n\nGuardrails:\n- Do not touch provider dispatch code owned by Lane 2\n- Keep changes bounded to UI/config paths\n- Add/extend tests for capture throttling and config behavior\n\nTarget branch: {{integrationBranch}}\nDefinition of done: {{definitionOfDone}}", "sdk": "auto", - "timeoutMs": 600000 + "cwd": "{{lane1Worktree}}", + "timeoutMs": 5400000, + "includeTaskContext": false, + "failOnError": true }, "position": { - "x": 400, - "y": 440 + "x": 120, + "y": 450 }, "outputs": [ "default" ] }, { - "id": "build", - "type": "validation.build", - "label": "Build", + "id": "lane-provider-bridge", + "type": "action.run_agent", + "label": "Lane 2: Provider Bridge", "config": { - "command": "npm run build", - "zeroWarnings": true + "prompt": "# Lane 2 - Provider Bridge\n\nWork only in this lane's worktree. Focus on:\n1. Server-side vision frame ingress route and validation\n2. Provider dispatch in voice relay (OpenAI image path, Gemini live path, Claude vision path)\n3. Rate-limits, payload caps, and fallback semantics\n\nGuardrails:\n- Do not edit overlay/capture UI owned by Lane 1\n- Keep provider logic behind explicit feature flags\n- Add/extend tests for endpoint validation and provider routing\n\nTarget branch: {{integrationBranch}}\nDefinition of done: {{definitionOfDone}}", + "sdk": "auto", + "cwd": "{{lane2Worktree}}", + "timeoutMs": 5400000, + "includeTaskContext": false, + "failOnError": true }, "position": { - "x": 400, - "y": 570 + "x": 500, + "y": 450 }, "outputs": [ "default" ] }, { - "id": "test", - "type": "validation.tests", - "label": "Run Tests", + "id": "lane-hardening", + "type": "action.run_agent", + "label": "Lane 3: QA + Rollout", "config": { - "command": "npm test" + "prompt": "# Lane 3 - QA + Rollout Hardening\n\nWork only in this lane's worktree. Focus on:\n1. Integration tests, resilience tests, and docs updates\n2. Migration/rollout notes and operator controls\n3. Conflict-free merge guidance across Lane 1 and Lane 2 outputs\n\nGuardrails:\n- Avoid touching core capture loop and provider dispatch internals unless a test proves breakage\n- Keep this lane focused on verification, docs, and release safety\n- Produce a concise verification summary\n\nTarget branch: {{integrationBranch}}\nDefinition of done: {{definitionOfDone}}", + "sdk": "auto", + "cwd": "{{lane3Worktree}}", + "timeoutMs": 3600000, + "includeTaskContext": false, + "failOnError": true }, "position": { - "x": 400, - "y": 700 + "x": 880, + "y": 450 }, "outputs": [ "default" ] }, { - "id": "test-passed", - "type": "condition.expression", - "label": "Tests Passed?", - "config": { - "expression": "$ctx.getNodeOutput('test')?.passed === true" - }, - "position": { - "x": 400, - "y": 830 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "should-publish", - "type": "condition.expression", - "label": "Publish To npm?", - "config": { - "expression": "Boolean($data?.publishToNpm)" - }, - "position": { - "x": 250, - "y": 1030 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "commit-tag", - "type": "action.git_operations", - "label": "Commit & Tag", + "id": "aggregate", + "type": "transform.aggregate", + "label": "Aggregate Lane Results", "config": { - "operations": [ - { - "op": "add", - "paths": [ - "." - ] - }, - { - "op": "commit", - "message": "chore(release): v{{version}}" - }, - { - "op": "tag", - "name": "v{{version}}" - }, - { - "op": "push", - "includeTags": true - } + "sources": [ + "lane-capture-core", + "lane-provider-bridge", + "lane-hardening" ] }, "position": { - "x": 250, - "y": 960 - }, - "outputs": [ - "default" - ] - }, - { - "id": "publish-npm", - "type": "action.run_command", - "label": "Publish to npm", - "config": { - "command": "if [ \"{{dryRun}}\" = \"true\" ]; then echo 'Dry run: skipping npm publish'; else npm publish --access public; fi", - "continueOnError": true - }, - "position": { - "x": 250, - "y": 1090 + "x": 500, + "y": 640 }, "outputs": [ "default" ] }, { - "id": "create-gh-release", - "type": "action.run_command", - "label": "GitHub Release", + "id": "all-passed", + "type": "condition.expression", + "label": "All Lanes Passed?", "config": { - "command": "gh release create v{{version}} --generate-notes --title \"v{{version}}\"", - "continueOnError": true + "expression": "$ctx.getNodeOutput('lane-capture-core')?.success === true && $ctx.getNodeOutput('lane-provider-bridge')?.success === true && $ctx.getNodeOutput('lane-hardening')?.success === true" }, "position": { - "x": 250, - "y": 1220 + "x": 500, + "y": 770 }, "outputs": [ "default" @@ -32592,13 +25975,13 @@ { "id": "notify-success", "type": "notify.telegram", - "label": "Notify: Released", + "label": "Notify Success", "config": { - "message": ":box: **Release published!**\n\nVersion: v{{version}}\nnpm + GitHub release created." + "message": "Parallel Voice + Video rollout lanes completed successfully on {{integrationBranch}}. Proceed to integration and final verification." }, "position": { - "x": 250, - "y": 1350 + "x": 300, + "y": 910 }, "outputs": [ "default" @@ -32607,13 +25990,13 @@ { "id": "notify-failure", "type": "notify.telegram", - "label": "Notify: Release Failed", + "label": "Notify Failure", "config": { - "message": ":close: **Release pipeline failed** at test stage.\n\nVersion bump was {{bumpType}} but tests did not pass. Manual intervention required." + "message": "Parallel Voice + Video rollout has lane failures on {{integrationBranch}}. Inspect lane outputs before integration." }, "position": { - "x": 600, - "y": 960 + "x": 700, + "y": 910 }, "outputs": [ "default" @@ -32622,101 +26005,89 @@ ], "edges": [ { - "id": "trigger->bump-version", + "id": "trigger->check-worktrees", "source": "trigger", - "target": "bump-version", + "target": "check-worktrees", "sourcePort": "default" }, { - "id": "bump-version->read-version", - "source": "bump-version", - "target": "read-version", - "sourcePort": "default" + "id": "check-worktrees->kickoff-log", + "source": "check-worktrees", + "target": "kickoff-log", + "sourcePort": "default", + "condition": "$output?.result === true" }, { - "id": "read-version->set-version", - "source": "read-version", - "target": "set-version", - "sourcePort": "default" + "id": "check-worktrees->notify-worktree-error", + "source": "check-worktrees", + "target": "notify-worktree-error", + "sourcePort": "default", + "condition": "$output?.result !== true" }, { - "id": "set-version->generate-changelog", - "source": "set-version", - "target": "generate-changelog", + "id": "kickoff-log->lane-capture-core", + "source": "kickoff-log", + "target": "lane-capture-core", "sourcePort": "default" }, { - "id": "generate-changelog->build", - "source": "generate-changelog", - "target": "build", + "id": "kickoff-log->lane-provider-bridge", + "source": "kickoff-log", + "target": "lane-provider-bridge", "sourcePort": "default" }, { - "id": "build->test", - "source": "build", - "target": "test", + "id": "kickoff-log->lane-hardening", + "source": "kickoff-log", + "target": "lane-hardening", "sourcePort": "default" }, { - "id": "test->test-passed", - "source": "test", - "target": "test-passed", + "id": "lane-capture-core->aggregate", + "source": "lane-capture-core", + "target": "aggregate", "sourcePort": "default" }, { - "id": "test-passed->commit-tag", - "source": "test-passed", - "target": "commit-tag", - "sourcePort": "yes", - "condition": "$output?.result === true" + "id": "lane-provider-bridge->aggregate", + "source": "lane-provider-bridge", + "target": "aggregate", + "sourcePort": "default" }, { - "id": "test-passed->notify-failure", - "source": "test-passed", - "target": "notify-failure", - "sourcePort": "no", - "condition": "$output?.result !== true" + "id": "lane-hardening->aggregate", + "source": "lane-hardening", + "target": "aggregate", + "sourcePort": "default" }, { - "id": "commit-tag->should-publish", - "source": "commit-tag", - "target": "should-publish", + "id": "aggregate->all-passed", + "source": "aggregate", + "target": "all-passed", "sourcePort": "default" }, { - "id": "should-publish->publish-npm", - "source": "should-publish", - "target": "publish-npm", - "sourcePort": "yes", + "id": "all-passed->notify-success", + "source": "all-passed", + "target": "notify-success", + "sourcePort": "default", "condition": "$output?.result === true" }, { - "id": "should-publish->create-gh-release", - "source": "should-publish", - "target": "create-gh-release", - "sourcePort": "no", + "id": "all-passed->notify-failure", + "source": "all-passed", + "target": "notify-failure", + "sourcePort": "default", "condition": "$output?.result !== true" - }, - { - "id": "publish-npm->create-gh-release", - "source": "publish-npm", - "target": "create-gh-release", - "sourcePort": "default" - }, - { - "id": "create-gh-release->notify-success", - "source": "create-gh-release", - "target": "notify-success", - "sourcePort": "default" } ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-23T12:00:00.000Z", - "updatedAt": "2026-03-23T12:00:00.000Z", + "createdAt": "2026-03-16T12:00:00.000Z", + "updatedAt": "2026-03-16T12:00:00.000Z", "templateState": { - "templateId": "template-release-pipeline", - "templateName": "Release Pipeline", + "templateId": "template-voice-video-parallel-rollout", + "templateName": "Voice + Video Rollout (Parallel Lanes)", "templateVersion": "1.0.0", "installedTemplateVersion": "1.0.0", "isCustomized": false, @@ -32725,25 +26096,25 @@ } }, { - "id": "wf-nightly-report", - "name": "Nightly Report", - "description": "Generates a daily summary of agent activity: tasks completed, PRs merged, errors encountered, and token usage. Sends to Telegram.", - "category": "planning", + "id": "wf-build-deploy", + "name": "Build & Deploy", + "description": "Complete CI/CD-style pipeline: build → test → lint → deploy. Configurable deployment commands for any hosting target.", + "category": "ci-cd", "enabled": false, "nodeCount": 6, - "trigger": "trigger.schedule", + "trigger": "trigger.event", "variables": { - "reportHour": 23, - "reportTimezone": "UTC" + "deployCommand": "npm run deploy", + "deployBranch": "main" }, "nodes": [ { "id": "trigger", - "type": "trigger.schedule", - "label": "Nightly at 11pm", + "type": "trigger.event", + "label": "On PR Merged", "config": { - "intervalMs": 86400000, - "cron": "0 {{reportHour}} * * *" + "eventType": "pr.merged", + "filter": "$event.branch === '{{deployBranch}}'" }, "position": { "x": 400, @@ -32754,79 +26125,76 @@ ] }, { - "id": "get-task-stats", - "type": "action.run_command", - "label": "Get Task Stats", + "id": "build", + "type": "validation.build", + "label": "Build", "config": { - "command": "bosun task stats --json", - "continueOnError": true + "command": "npm run build", + "zeroWarnings": true }, "position": { - "x": 150, - "y": 200 + "x": 400, + "y": 180 }, "outputs": [ "default" ] }, { - "id": "get-pr-stats", - "type": "action.run_command", - "label": "Get PR Stats", + "id": "test", + "type": "validation.tests", + "label": "Tests", "config": { - "command": "gh pr list --state all --json number,state,mergedAt --limit 50", - "continueOnError": true + "command": "npm test" }, "position": { "x": 400, - "y": 200 + "y": 310 }, "outputs": [ "default" ] }, { - "id": "get-agent-stats", - "type": "action.run_command", - "label": "Get Agent Stats", + "id": "lint", + "type": "validation.lint", + "label": "Lint", "config": { - "command": "bosun agent stats --json 2>/dev/null || echo '{}'", - "continueOnError": true + "command": "npm run lint" }, "position": { - "x": 650, - "y": 200 + "x": 400, + "y": 440 }, "outputs": [ "default" ] }, { - "id": "generate-report", - "type": "action.run_agent", - "label": "Generate Report", + "id": "deploy", + "type": "action.run_command", + "label": "Deploy", "config": { - "prompt": "Generate a concise daily activity report from the following data.\n\n## Task Stats\n{{taskStats}}\n\n## PR Activity\n{{prStats}}\n\n## Agent Activity\n{{agentStats}}\n\nFormat as a Telegram-friendly message with emoji headers. Include:\n- Tasks completed today vs yesterday\n- PRs merged / opened / closed\n- Agent success rate\n- Notable errors or anomalies\n- Recommendations for tomorrow", - "timeoutMs": 300000 + "command": "{{deployCommand}}" }, "position": { "x": 400, - "y": 380 + "y": 570 }, "outputs": [ "default" ] }, { - "id": "send-report", + "id": "notify", "type": "notify.telegram", - "label": "Send Report", + "label": "Notify Deploy", "config": { - "message": ":chart: **Daily Bosun Report** ({{reportTimezone}})\n\n{{reportOutput}}" + "message": ":rocket: Deployment to production completed for {{branch}}" }, "position": { "x": 400, - "y": 540 + "y": 700 }, "outputs": [ "default" @@ -32835,55 +26203,43 @@ ], "edges": [ { - "id": "trigger->get-task-stats", - "source": "trigger", - "target": "get-task-stats", - "sourcePort": "default" - }, - { - "id": "trigger->get-pr-stats", - "source": "trigger", - "target": "get-pr-stats", - "sourcePort": "default" - }, - { - "id": "trigger->get-agent-stats", + "id": "trigger->build", "source": "trigger", - "target": "get-agent-stats", + "target": "build", "sourcePort": "default" }, { - "id": "get-task-stats->generate-report", - "source": "get-task-stats", - "target": "generate-report", + "id": "build->test", + "source": "build", + "target": "test", "sourcePort": "default" }, { - "id": "get-pr-stats->generate-report", - "source": "get-pr-stats", - "target": "generate-report", + "id": "test->lint", + "source": "test", + "target": "lint", "sourcePort": "default" }, { - "id": "get-agent-stats->generate-report", - "source": "get-agent-stats", - "target": "generate-report", + "id": "lint->deploy", + "source": "lint", + "target": "deploy", "sourcePort": "default" }, { - "id": "generate-report->send-report", - "source": "generate-report", - "target": "send-report", + "id": "deploy->notify", + "source": "deploy", + "target": "notify", "sourcePort": "default" } ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-24T12:00:00.000Z", - "updatedAt": "2026-03-24T12:00:00.000Z", + "createdAt": "2026-03-17T12:00:00.000Z", + "updatedAt": "2026-03-17T12:00:00.000Z", "templateState": { - "templateId": "template-nightly-report", - "templateName": "Nightly Report", + "templateId": "template-build-deploy", + "templateName": "Build & Deploy", "templateVersion": "1.0.0", "installedTemplateVersion": "1.0.0", "isCustomized": false, @@ -32892,26 +26248,27 @@ } }, { - "id": "wf-sprint-retrospective", - "name": "Sprint Retrospective", - "description": "Weekly automated retrospective: gathers metrics on tasks completed, PRs merged, agent success rates, and common failure patterns. Generates improvement suggestions and creates action item tasks.", - "category": "planning", - "enabled": true, - "nodeCount": 10, - "trigger": "trigger.schedule", + "id": "wf-canary-deploy", + "name": "Canary Deploy", + "description": "Two-phase deployment: deploy to a staging/canary environment first, run smoke tests, then promote to production or auto-rollback on failure. Reduces blast radius of bad deploys.", + "category": "ci-cd", + "enabled": false, + "nodeCount": 12, + "trigger": "trigger.manual", "variables": { - "lookbackDays": 7, - "lookbackWindowMs": 604800000, - "createImprovementTasks": true + "stagingCommand": "npm run deploy:staging", + "productionCommand": "npm run deploy:production", + "rollbackCommand": "npm run deploy:rollback", + "smokeTestCommand": "npm run test:smoke", + "promotionDelayMs": 300000 }, "nodes": [ { "id": "trigger", - "type": "trigger.schedule", - "label": "Weekly Retro", + "type": "trigger.manual", + "label": "Deploy Canary", "config": { - "intervalMs": 604800000, - "cron": "0 9 * * 1" + "description": "Start a canary deployment" }, "position": { "x": 400, @@ -32922,145 +26279,172 @@ ] }, { - "id": "task-metrics", - "type": "action.bosun_cli", - "label": "Gather Task Metrics", + "id": "build", + "type": "validation.build", + "label": "Build", "config": { - "command": "task list --format json --since {{lookbackDays}}d", - "continueOnError": true + "command": "npm run build", + "zeroWarnings": true }, "position": { - "x": 200, - "y": 200 + "x": 400, + "y": 180 }, "outputs": [ "default" ] }, { - "id": "pr-metrics", + "id": "deploy-staging", "type": "action.run_command", - "label": "Gather PR Metrics", + "label": "Deploy to Staging", "config": { - "command": "gh pr list --state all --json number,title,state,createdAt,mergedAt,closedAt --limit 50", + "command": "{{stagingCommand}}", "continueOnError": true }, "position": { - "x": 600, - "y": 200 + "x": 400, + "y": 310 }, "outputs": [ "default" ] }, { - "id": "error-analysis", - "type": "action.analyze_errors", - "label": "Analyze Error Patterns", + "id": "staging-ok", + "type": "condition.expression", + "label": "Staging Deploy OK?", "config": { - "timeWindowMs": "{{lookbackWindowMs}}", - "groupBy": "category" + "expression": "$ctx.getNodeOutput('deploy-staging')?.success === true" }, "position": { - "x": 200, - "y": 350 + "x": 400, + "y": 440 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "agent-stats", - "type": "action.bosun_cli", - "label": "Agent Performance", + "id": "smoke-tests", + "type": "action.run_command", + "label": "Run Smoke Tests", "config": { - "command": "status --json", + "command": "{{smokeTestCommand}}", "continueOnError": true }, "position": { - "x": 600, - "y": 350 + "x": 250, + "y": 570 }, "outputs": [ "default" ] }, { - "id": "generate-retro", - "type": "action.run_agent", - "label": "Generate Retrospective", + "id": "smoke-passed", + "type": "condition.expression", + "label": "Smoke Tests Passed?", "config": { - "prompt": "# Sprint Retrospective Analysis\n\nAnalyze the following data from the past {{lookbackDays}} days:\n\n## Task Metrics\n{{taskMetrics}}\n\n## PR Metrics\n{{prMetrics}}\n\n## Error Patterns\n{{errorAnalysis}}\n\n## Agent Performance\n{{agentStats}}\n\nGenerate a retrospective report with these sections:\n\n### :chart: Key Metrics\n- Tasks completed vs created\n- Average task cycle time\n- PR merge rate and average review time\n- Agent success rate\n\n### :check: What Went Well\n- Highlight successful patterns and wins\n\n### :close: What Didn't Go Well\n- Identify bottlenecks and recurring issues\n\n### :target: Action Items\nFor each improvement suggestion, output a line:\nACTION: [title] | [description]\n\nBe specific and actionable. Limit to 3-5 improvement items.", - "sdk": "auto", - "timeoutMs": 600000 + "expression": "$ctx.getNodeOutput('smoke-tests')?.success === true" }, "position": { - "x": 400, - "y": 520 + "x": 250, + "y": 700 + }, + "outputs": [ + "yes", + "no" + ] + }, + { + "id": "wait-bake", + "type": "action.delay", + "label": "Bake Time", + "config": { + "ms": "{{promotionDelayMs}}", + "reason": "Waiting for bake time before promoting to production" + }, + "position": { + "x": 100, + "y": 830 }, "outputs": [ "default" ] }, { - "id": "has-actions", - "type": "condition.expression", - "label": "Has Action Items?", + "id": "promote-prod", + "type": "action.run_command", + "label": "Promote to Production", "config": { - "expression": "($ctx.getNodeOutput('generate-retro')?.output || '').includes('ACTION:')" + "command": "{{productionCommand}}" }, "position": { - "x": 400, - "y": 680 + "x": 100, + "y": 960 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "create-tasks", - "type": "action.run_agent", - "label": "Create Improvement Tasks", + "id": "notify-success", + "type": "notify.telegram", + "label": "Deploy Succeeded", "config": { - "prompt": "# Create Improvement Tasks\n\nFrom the retrospective output, extract all lines starting with ACTION:\nand create a bosun task for each one.\n\nUse the CLI: bosun task create --title \"[title]\" --description \"[description]\" --tag improvement --tag retro\n\nOnly create tasks if {{createImprovementTasks}} is true.", - "sdk": "auto", - "timeoutMs": 300000 + "message": ":check: **Canary deploy promoted to production** successfully." }, "position": { - "x": 250, - "y": 830 + "x": 100, + "y": 1090 }, "outputs": [ "default" ] }, { - "id": "send-report", + "id": "rollback", + "type": "action.run_command", + "label": "Rollback", + "config": { + "command": "{{rollbackCommand}}", + "continueOnError": true + }, + "position": { + "x": 550, + "y": 700 + }, + "outputs": [ + "default" + ] + }, + { + "id": "notify-rollback", "type": "notify.telegram", - "label": "Send Retro Report", + "label": "Deploy Rolled Back", "config": { - "message": ":clipboard: **Weekly Retrospective** (past {{lookbackDays}} days)\n\n{{retroOutput}}" + "message": ":refresh: **Canary deploy rolled back.**\n\nSmoke tests or staging deploy failed. Production unchanged." }, "position": { - "x": 400, - "y": 980 + "x": 550, + "y": 830 }, "outputs": [ "default" ] }, { - "id": "log-no-actions", - "type": "notify.log", - "label": "No Actions Needed", + "id": "notify-staging-fail", + "type": "notify.telegram", + "label": "Staging Failed", "config": { - "message": "Sprint retrospective complete — no action items generated", - "level": "info" + "message": ":close: **Staging deploy failed.** Not proceeding to canary phase." }, "position": { "x": 600, - "y": 830 + "y": 440 }, "outputs": [ "default" @@ -33069,81 +26453,83 @@ ], "edges": [ { - "id": "trigger->task-metrics", - "source": "trigger", - "target": "task-metrics", - "sourcePort": "default" - }, - { - "id": "trigger->pr-metrics", + "id": "trigger->build", "source": "trigger", - "target": "pr-metrics", + "target": "build", "sourcePort": "default" }, { - "id": "task-metrics->error-analysis", - "source": "task-metrics", - "target": "error-analysis", + "id": "build->deploy-staging", + "source": "build", + "target": "deploy-staging", "sourcePort": "default" }, { - "id": "pr-metrics->agent-stats", - "source": "pr-metrics", - "target": "agent-stats", + "id": "deploy-staging->staging-ok", + "source": "deploy-staging", + "target": "staging-ok", "sourcePort": "default" }, { - "id": "error-analysis->generate-retro", - "source": "error-analysis", - "target": "generate-retro", - "sourcePort": "default" + "id": "staging-ok->smoke-tests", + "source": "staging-ok", + "target": "smoke-tests", + "sourcePort": "yes", + "condition": "$output?.result === true" }, { - "id": "agent-stats->generate-retro", - "source": "agent-stats", - "target": "generate-retro", - "sourcePort": "default" + "id": "staging-ok->notify-staging-fail", + "source": "staging-ok", + "target": "notify-staging-fail", + "sourcePort": "no", + "condition": "$output?.result !== true" }, { - "id": "generate-retro->has-actions", - "source": "generate-retro", - "target": "has-actions", + "id": "smoke-tests->smoke-passed", + "source": "smoke-tests", + "target": "smoke-passed", "sourcePort": "default" }, { - "id": "has-actions->create-tasks", - "source": "has-actions", - "target": "create-tasks", + "id": "smoke-passed->wait-bake", + "source": "smoke-passed", + "target": "wait-bake", "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "has-actions->log-no-actions", - "source": "has-actions", - "target": "log-no-actions", + "id": "smoke-passed->rollback", + "source": "smoke-passed", + "target": "rollback", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "create-tasks->send-report", - "source": "create-tasks", - "target": "send-report", + "id": "wait-bake->promote-prod", + "source": "wait-bake", + "target": "promote-prod", "sourcePort": "default" }, { - "id": "log-no-actions->send-report", - "source": "log-no-actions", - "target": "send-report", + "id": "promote-prod->notify-success", + "source": "promote-prod", + "target": "notify-success", + "sourcePort": "default" + }, + { + "id": "rollback->notify-rollback", + "source": "rollback", + "target": "notify-rollback", "sourcePort": "default" } ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-25T12:00:00.000Z", - "updatedAt": "2026-03-25T12:00:00.000Z", + "createdAt": "2026-03-18T12:00:00.000Z", + "updatedAt": "2026-03-18T12:00:00.000Z", "templateState": { - "templateId": "template-sprint-retrospective", - "templateName": "Sprint Retrospective", + "templateId": "template-canary-deploy", + "templateName": "Canary Deploy", "templateVersion": "1.0.0", "installedTemplateVersion": "1.0.0", "isCustomized": false, @@ -33152,29 +26538,25 @@ } }, { - "id": "wf-task-planner", - "name": "Task Planner", - "description": "Automatically generates new backlog tasks when the todo count drops below a configurable threshold. Replaces the previous hardcoded TASK_PLANNER_MODE / REPLENISH_ENABLED env-var system.", - "category": "planning", + "id": "wf-release-pipeline", + "name": "Release Pipeline", + "description": "End-to-end release automation: version bump, changelog generation, build, test, npm publish, GitHub release creation, and team notification. Triggered manually or on a schedule for regular release cadences.", + "category": "ci-cd", "enabled": true, - "nodeCount": 11, - "trigger": "trigger.task_low", + "nodeCount": 14, + "trigger": "trigger.manual", "variables": { - "minTodoCount": 3, - "taskCount": 5, - "dedupHours": 24, - "failureCooldownMinutes": 30, - "prompt": "", - "plannerContext": "Focus on high-value implementation work. Avoid duplicating existing tasks." + "bumpType": "patch", + "publishToNpm": true, + "dryRun": false }, "nodes": [ { "id": "trigger", - "type": "trigger.task_low", - "label": "Backlog Low?", + "type": "trigger.manual", + "label": "Start Release", "config": { - "threshold": "{{minTodoCount}}", - "status": "todo" + "description": "Kick off a new release" }, "position": { "x": 400, @@ -33185,11 +26567,11 @@ ] }, { - "id": "check-dedup", - "type": "condition.expression", - "label": "Dedup Window", + "id": "bump-version", + "type": "action.run_command", + "label": "Bump Version", "config": { - "expression": "(() => { const now = Date.now(); const lastSuccessAt = Number($data?._lastPlannerRun || 0); const lastFailureAt = Number($data?._lastPlannerFailureAt || 0); const successWindowMs = Number($data?.dedupHours || 24) * 3600000; const failureWindowMs = Number($data?.failureCooldownMinutes || 30) * 60000; return (now - lastSuccessAt) > successWindowMs && (now - lastFailureAt) > failureWindowMs;})()" + "command": "npm version {{bumpType}} --no-git-tag-version" }, "position": { "x": 400, @@ -33200,12 +26582,11 @@ ] }, { - "id": "log-start", - "type": "notify.log", - "label": "Log Planner Start", + "id": "read-version", + "type": "action.run_command", + "label": "Read New Version", "config": { - "message": "Task planner triggered: {{trigger.todoCount}} tasks remaining (threshold: {{minTodoCount}})", - "level": "info" + "command": "node -p \"require('./package.json').version\"" }, "position": { "x": 400, @@ -33216,20 +26597,30 @@ ] }, { - "id": "run-planner", - "type": "agent.run_planner", - "label": "Generate Tasks", + "id": "set-version", + "type": "action.set_variable", + "label": "Set Version Variable", "config": { - "taskCount": "{{taskCount}}", - "context": "{{plannerContext}}", - "prompt": "{{prompt}}", - "repoMapQuery": "{{plannerContext}} {{prompt}}", - "repoMapFileLimit": 8, - "dedup": true, - "timeoutMs": 960000, - "agentTimeoutMs": 900000, - "maxRetries": 0, - "retryable": false + "key": "version", + "value": "(() => String($ctx.getNodeOutput('read-version')?.output || '').trim())()", + "isExpression": true + }, + "position": { + "x": 400, + "y": 380 + }, + "outputs": [ + "default" + ] + }, + { + "id": "generate-changelog", + "type": "action.run_agent", + "label": "Generate Changelog", + "config": { + "prompt": "# Generate Changelog Entry\n\nRead the git log since the last tag:\n```\ngit log $(git describe --tags --abbrev=0)..HEAD --oneline\n```\n\nGroup commits into categories (Features, Fixes, Refactors, Docs, etc.)\nfollowing the Keep a Changelog format.\n\nWrite the entry to CHANGELOG.md under a new version heading.\nCommit the result with message \"docs: update changelog for vX.Y.Z\".", + "sdk": "auto", + "timeoutMs": 600000 }, "position": { "x": 400, @@ -33240,16 +26631,12 @@ ] }, { - "id": "materialize-tasks", - "type": "action.materialize_planner_tasks", - "label": "Create Tasks", + "id": "build", + "type": "validation.build", + "label": "Build", "config": { - "plannerNodeId": "run-planner", - "maxTasks": "{{taskCount}}", - "status": "draft", - "dedup": true, - "failOnZero": true, - "minCreated": 1 + "command": "npm run build", + "zeroWarnings": true }, "position": { "x": 400, @@ -33260,11 +26647,11 @@ ] }, { - "id": "check-result", - "type": "condition.expression", - "label": "Planner Succeeded?", + "id": "test", + "type": "validation.tests", + "label": "Run Tests", "config": { - "expression": "$ctx.getNodeOutput('materialize-tasks')?.success === true && ($ctx.getNodeOutput('materialize-tasks')?.createdCount || 0) > 0" + "command": "npm test" }, "position": { "x": 400, @@ -33275,78 +26662,124 @@ ] }, { - "id": "set-timestamp", - "type": "action.set_variable", - "label": "Update Last Run", + "id": "test-passed", + "type": "condition.expression", + "label": "Tests Passed?", "config": { - "key": "_lastPlannerRun", - "value": "Date.now()", - "isExpression": true + "expression": "$ctx.getNodeOutput('test')?.passed === true" }, "position": { - "x": 200, + "x": 400, "y": 830 }, + "outputs": [ + "yes", + "no" + ] + }, + { + "id": "should-publish", + "type": "condition.expression", + "label": "Publish To npm?", + "config": { + "expression": "Boolean($data?.publishToNpm)" + }, + "position": { + "x": 250, + "y": 1030 + }, + "outputs": [ + "yes", + "no" + ] + }, + { + "id": "commit-tag", + "type": "action.git_operations", + "label": "Commit & Tag", + "config": { + "operations": [ + { + "op": "add", + "paths": [ + "." + ] + }, + { + "op": "commit", + "message": "chore(release): v{{version}}" + }, + { + "op": "tag", + "name": "v{{version}}" + }, + { + "op": "push", + "includeTags": true + } + ] + }, + "position": { + "x": 250, + "y": 960 + }, "outputs": [ "default" ] }, { - "id": "notify-done", - "type": "notify.telegram", - "label": "Notify Tasks Created", + "id": "publish-npm", + "type": "action.run_command", + "label": "Publish to npm", "config": { - "message": ":folder: Task planner created {{materialize-tasks.createdCount}} backlog tasks (skipped {{materialize-tasks.skippedCount}} duplicates).", - "silent": true + "command": "if [ \"{{dryRun}}\" = \"true\" ]; then echo 'Dry run: skipping npm publish'; else npm publish --access public; fi", + "continueOnError": true }, "position": { - "x": 200, - "y": 960 + "x": 250, + "y": 1090 }, "outputs": [ "default" ] }, { - "id": "notify-skip", - "type": "notify.log", - "label": "Log Dedup Skip", + "id": "create-gh-release", + "type": "action.run_command", + "label": "GitHub Release", "config": { - "message": "Task planner skipped: within dedup window", - "level": "info" + "command": "gh release create v{{version}} --generate-notes --title \"v{{version}}\"", + "continueOnError": true }, "position": { - "x": 650, - "y": 180 + "x": 250, + "y": 1220 }, "outputs": [ "default" ] }, { - "id": "notify-fail", - "type": "notify.log", - "label": "Log Planner Failure", + "id": "notify-success", + "type": "notify.telegram", + "label": "Notify: Released", "config": { - "message": "Task planner failed to materialize tasks from planner output", - "level": "warn" + "message": ":box: **Release published!**\n\nVersion: v{{version}}\nnpm + GitHub release created." }, "position": { - "x": 600, - "y": 830 + "x": 250, + "y": 1350 }, "outputs": [ "default" ] }, { - "id": "set-timestamp-fail", - "type": "action.set_variable", - "label": "Cooldown After Failure", + "id": "notify-failure", + "type": "notify.telegram", + "label": "Notify: Release Failed", "config": { - "key": "_lastPlannerFailureAt", - "value": "Date.now()", - "isExpression": true + "message": ":close: **Release pipeline failed** at test stage.\n\nVersion bump was {{bumpType}} but tests did not pass. Manual intervention required." }, "position": { "x": 600, @@ -33359,77 +26792,101 @@ ], "edges": [ { - "id": "trigger->check-dedup", + "id": "trigger->bump-version", "source": "trigger", - "target": "check-dedup", + "target": "bump-version", "sourcePort": "default" }, { - "id": "check-dedup->log-start", - "source": "check-dedup", - "target": "log-start", - "sourcePort": "default", - "condition": "$output?.result === true" + "id": "bump-version->read-version", + "source": "bump-version", + "target": "read-version", + "sourcePort": "default" }, { - "id": "check-dedup->notify-skip", - "source": "check-dedup", - "target": "notify-skip", - "sourcePort": "default", - "condition": "$output?.result !== true" + "id": "read-version->set-version", + "source": "read-version", + "target": "set-version", + "sourcePort": "default" }, { - "id": "log-start->run-planner", - "source": "log-start", - "target": "run-planner", + "id": "set-version->generate-changelog", + "source": "set-version", + "target": "generate-changelog", "sourcePort": "default" }, { - "id": "run-planner->materialize-tasks", - "source": "run-planner", - "target": "materialize-tasks", + "id": "generate-changelog->build", + "source": "generate-changelog", + "target": "build", "sourcePort": "default" }, { - "id": "materialize-tasks->check-result", - "source": "materialize-tasks", - "target": "check-result", + "id": "build->test", + "source": "build", + "target": "test", "sourcePort": "default" }, { - "id": "check-result->set-timestamp", - "source": "check-result", - "target": "set-timestamp", - "sourcePort": "default", + "id": "test->test-passed", + "source": "test", + "target": "test-passed", + "sourcePort": "default" + }, + { + "id": "test-passed->commit-tag", + "source": "test-passed", + "target": "commit-tag", + "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "check-result->notify-fail", - "source": "check-result", - "target": "notify-fail", - "sourcePort": "default", + "id": "test-passed->notify-failure", + "source": "test-passed", + "target": "notify-failure", + "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "set-timestamp->notify-done", - "source": "set-timestamp", - "target": "notify-done", + "id": "commit-tag->should-publish", + "source": "commit-tag", + "target": "should-publish", "sourcePort": "default" }, { - "id": "notify-fail->set-timestamp-fail", - "source": "notify-fail", - "target": "set-timestamp-fail", + "id": "should-publish->publish-npm", + "source": "should-publish", + "target": "publish-npm", + "sourcePort": "yes", + "condition": "$output?.result === true" + }, + { + "id": "should-publish->create-gh-release", + "source": "should-publish", + "target": "create-gh-release", + "sourcePort": "no", + "condition": "$output?.result !== true" + }, + { + "id": "publish-npm->create-gh-release", + "source": "publish-npm", + "target": "create-gh-release", + "sourcePort": "default" + }, + { + "id": "create-gh-release->notify-success", + "source": "create-gh-release", + "target": "notify-success", "sourcePort": "default" } ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-26T12:00:00.000Z", - "updatedAt": "2026-03-26T12:00:00.000Z", + "createdAt": "2026-03-19T12:00:00.000Z", + "updatedAt": "2026-03-19T12:00:00.000Z", "templateState": { - "templateId": "template-task-planner", - "templateName": "Task Planner", + "templateId": "template-release-pipeline", + "templateName": "Release Pipeline", "templateVersion": "1.0.0", "installedTemplateVersion": "1.0.0", "isCustomized": false, @@ -33438,27 +26895,25 @@ } }, { - "id": "wf-task-replenish", - "name": "Task Replenish (Scheduled)", - "description": "Periodically checks backlog and replenishes tasks on a schedule. This replaces the previous INTERNAL_EXECUTOR_REPLENISH_ENABLED env var with a configurable visual workflow.", + "id": "wf-nightly-report", + "name": "Nightly Report", + "description": "Generates a daily summary of agent activity: tasks completed, PRs merged, errors encountered, and token usage. Sends to Telegram.", "category": "planning", "enabled": false, - "nodeCount": 7, + "nodeCount": 6, "trigger": "trigger.schedule", "variables": { - "intervalMs": 3600000, - "minTodoCount": 5, - "taskCount": 8, - "prompt": "", - "plannerContext": "Scheduled replenishment run. Prioritize implementation tasks that build on recent PRs." + "reportHour": 23, + "reportTimezone": "UTC" }, "nodes": [ { "id": "trigger", "type": "trigger.schedule", - "label": "Hourly Check", + "label": "Nightly at 11pm", "config": { - "intervalMs": "{{intervalMs}}" + "intervalMs": 86400000, + "cron": "0 {{reportHour}} * * *" }, "position": { "x": 400, @@ -33469,104 +26924,79 @@ ] }, { - "id": "check-backlog", - "type": "trigger.task_low", - "label": "Check Backlog Level", + "id": "get-task-stats", + "type": "action.run_command", + "label": "Get Task Stats", "config": { - "threshold": "{{minTodoCount}}" + "command": "bosun task stats --json", + "continueOnError": true }, "position": { - "x": 400, - "y": 180 + "x": 150, + "y": 200 }, "outputs": [ "default" ] }, { - "id": "needs-tasks", - "type": "condition.expression", - "label": "Needs Replenishment?", + "id": "get-pr-stats", + "type": "action.run_command", + "label": "Get PR Stats", "config": { - "expression": "$ctx.getNodeOutput('check-backlog')?.triggered === true" + "command": "gh pr list --state all --json number,state,mergedAt --limit 50", + "continueOnError": true }, "position": { "x": 400, - "y": 310 + "y": 200 }, "outputs": [ "default" ] }, { - "id": "run-planner", - "type": "agent.run_planner", - "label": "Generate Tasks", + "id": "get-agent-stats", + "type": "action.run_command", + "label": "Get Agent Stats", "config": { - "taskCount": "{{taskCount}}", - "context": "{{plannerContext}}", - "prompt": "{{prompt}}", - "repoMapQuery": "{{plannerContext}} {{prompt}}", - "repoMapFileLimit": 8, - "timeoutMs": 960000, - "agentTimeoutMs": 900000, - "maxRetries": 0, - "retryable": false + "command": "bosun agent stats --json 2>/dev/null || echo '{}'", + "continueOnError": true }, "position": { - "x": 400, - "y": 440 + "x": 650, + "y": 200 }, "outputs": [ "default" ] }, { - "id": "materialize-tasks", - "type": "action.materialize_planner_tasks", - "label": "Create Tasks", + "id": "generate-report", + "type": "action.run_agent", + "label": "Generate Report", "config": { - "plannerNodeId": "run-planner", - "maxTasks": "{{taskCount}}", - "status": "todo", - "dedup": true, - "failOnZero": true, - "minCreated": 1 + "prompt": "Generate a concise daily activity report from the following data.\n\n## Task Stats\n{{taskStats}}\n\n## PR Activity\n{{prStats}}\n\n## Agent Activity\n{{agentStats}}\n\nFormat as a Telegram-friendly message with emoji headers. Include:\n- Tasks completed today vs yesterday\n- PRs merged / opened / closed\n- Agent success rate\n- Notable errors or anomalies\n- Recommendations for tomorrow", + "timeoutMs": 300000 }, "position": { "x": 400, - "y": 570 + "y": 380 }, "outputs": [ "default" ] }, { - "id": "notify", + "id": "send-report", "type": "notify.telegram", - "label": "Notify", + "label": "Send Report", "config": { - "message": ":refresh: Scheduled replenishment created {{materialize-tasks.createdCount}} tasks (skipped {{materialize-tasks.skippedCount}}).", - "silent": true + "message": ":chart: **Daily Bosun Report** ({{reportTimezone}})\n\n{{reportOutput}}" }, "position": { "x": 400, - "y": 700 - }, - "outputs": [ - "default" - ] - }, - { - "id": "skip-log", - "type": "notify.log", - "label": "No Replenish Needed", - "config": { - "message": "Scheduled replenishment check: backlog sufficient, skipping" - }, - "position": { - "x": 700, - "y": 310 + "y": 540 }, "outputs": [ "default" @@ -33575,51 +27005,55 @@ ], "edges": [ { - "id": "trigger->check-backlog", + "id": "trigger->get-task-stats", "source": "trigger", - "target": "check-backlog", + "target": "get-task-stats", "sourcePort": "default" }, { - "id": "check-backlog->needs-tasks", - "source": "check-backlog", - "target": "needs-tasks", + "id": "trigger->get-pr-stats", + "source": "trigger", + "target": "get-pr-stats", "sourcePort": "default" }, { - "id": "needs-tasks->run-planner", - "source": "needs-tasks", - "target": "run-planner", - "sourcePort": "default", - "condition": "$output?.result === true" + "id": "trigger->get-agent-stats", + "source": "trigger", + "target": "get-agent-stats", + "sourcePort": "default" }, { - "id": "needs-tasks->skip-log", - "source": "needs-tasks", - "target": "skip-log", - "sourcePort": "default", - "condition": "$output?.result !== true" + "id": "get-task-stats->generate-report", + "source": "get-task-stats", + "target": "generate-report", + "sourcePort": "default" }, { - "id": "run-planner->materialize-tasks", - "source": "run-planner", - "target": "materialize-tasks", + "id": "get-pr-stats->generate-report", + "source": "get-pr-stats", + "target": "generate-report", "sourcePort": "default" }, { - "id": "materialize-tasks->notify", - "source": "materialize-tasks", - "target": "notify", + "id": "get-agent-stats->generate-report", + "source": "get-agent-stats", + "target": "generate-report", + "sourcePort": "default" + }, + { + "id": "generate-report->send-report", + "source": "generate-report", + "target": "send-report", "sourcePort": "default" } ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-27T12:00:00.000Z", - "updatedAt": "2026-03-27T12:00:00.000Z", + "createdAt": "2026-03-20T12:00:00.000Z", + "updatedAt": "2026-03-20T12:00:00.000Z", "templateState": { - "templateId": "template-task-replenish", - "templateName": "Task Replenish (Scheduled)", + "templateId": "template-nightly-report", + "templateName": "Nightly Report", "templateVersion": "1.0.0", "installedTemplateVersion": "1.0.0", "isCustomized": false, @@ -33628,32 +27062,30 @@ } }, { - "id": "wf-weekly-fitness-summary", - "name": "Weekly Fitness Summary", - "description": "Weekly evaluator workflow that scores delivery fitness using throughput, regression rate, merge success, reopened tasks, and debt growth. Produces follow-up actions and can materialize them as backlog tasks.", + "id": "wf-sprint-retrospective", + "name": "Sprint Retrospective", + "description": "Weekly automated retrospective: gathers metrics on tasks completed, PRs merged, agent success rates, and common failure patterns. Generates improvement suggestions and creates action item tasks.", "category": "planning", - "enabled": false, - "nodeCount": 15, + "enabled": true, + "nodeCount": 10, "trigger": "trigger.schedule", "variables": { - "scheduleCron": "0 9 * * 1", "lookbackDays": 7, - "evaluatorFocus": "Bias toward systemic fixes that reduce regressions and execution thrash.", - "createFollowupTasks": true, - "maxFollowupTasks": 4 + "lookbackWindowMs": 604800000, + "createImprovementTasks": true }, "nodes": [ { "id": "trigger", "type": "trigger.schedule", - "label": "Weekly Schedule", + "label": "Weekly Retro", "config": { "intervalMs": 604800000, - "cron": "{{scheduleCron}}" + "cron": "0 9 * * 1" }, "position": { - "x": 420, - "y": 40 + "x": 400, + "y": 50 }, "outputs": [ "default" @@ -33662,16 +27094,14 @@ { "id": "task-metrics", "type": "action.bosun_cli", - "label": "Collect Task Metrics", + "label": "Gather Task Metrics", "config": { - "subcommand": "task list", - "args": "--json", - "parseJson": true, + "command": "task list --format json --since {{lookbackDays}}d", "continueOnError": true }, "position": { - "x": 150, - "y": 180 + "x": 200, + "y": 200 }, "outputs": [ "default" @@ -33680,214 +27110,127 @@ { "id": "pr-metrics", "type": "action.run_command", - "label": "Collect PR Metrics", - "config": { - "command": "gh pr list --state all --json number,state,mergedAt,closedAt,createdAt,updatedAt,title,body --limit 200", - "continueOnError": true - }, - "position": { - "x": 420, - "y": 180 - }, - "outputs": [ - "default" - ] - }, - { - "id": "debt-metrics", - "type": "action.run_command", - "label": "Collect Debt Signals", + "label": "Gather PR Metrics", "config": { - "command": "node -e \"const fs=require('fs');const p='.bosun/workflow-runs/task-debt-ledger.jsonl';if(!fs.existsSync(p)){console.log('[]');process.exit(0);}const lines=fs.readFileSync(p,'utf8').split(/\\r?\\n/).filter(Boolean);console.log(JSON.stringify(lines.slice(-500).map(l=>{try{return JSON.parse(l)}catch{return null}}).filter(Boolean)));\"", + "command": "gh pr list --state all --json number,title,state,createdAt,mergedAt,closedAt --limit 50", "continueOnError": true }, "position": { - "x": 690, - "y": 180 - }, - "outputs": [ - "default" - ] - }, - { - "id": "read-previous-summary", - "type": "action.read_file", - "label": "Read Prior Summary", - "config": { - "path": ".bosun/workflow-runs/weekly-fitness-summary.latest.json" - }, - "position": { - "x": 960, - "y": 180 - }, - "outputs": [ - "default" - ] - }, - { - "id": "summarize-fitness-metrics", - "type": "action.set_variable", - "label": "Summarize Fitness Metrics", - "config": { - "key": "fitnessSummary", - "value": "(() => { try { const now = Date.now(); const lookbackDays = Math.max(1, Number($data?.lookbackDays || 7)); const windowMs = lookbackDays * 24 * 60 * 60 * 1000; const currentStart = now - windowMs; const previousStart = currentStart - windowMs; const previousEnd = currentStart; const toNumber = (v, fallback = 0) => { const n = Number(v); return Number.isFinite(n) ? n : fallback; }; const toIso = (ms) => new Date(ms).toISOString(); const parseJsonSafe = (raw) => { try { return JSON.parse(String(raw)); } catch { return null; } }; const extractCanonicalItems = (value) => { if (!value || typeof value !== 'object') return null; const keys = ['items', 'tasks', 'entries', 'records', 'results', 'data']; for (const key of keys) { if (Array.isArray(value[key])) return value[key].filter(Boolean); } return null; }; const parseSource = (raw, depth = 0) => { if (depth > 3) return { items: [], degraded: true, parsedAny: false, partial: false }; if (Array.isArray(raw)) return { items: raw.filter(Boolean), degraded: false, parsedAny: raw.length > 0, partial: false }; if (raw && typeof raw === 'object') { const canonical = extractCanonicalItems(raw) ?? extractCanonicalItems(raw.output) ?? extractCanonicalItems(raw.result) ?? extractCanonicalItems(raw.payload); if (canonical) return { items: canonical, degraded: false, parsedAny: canonical.length > 0, partial: false }; const wrappedCandidates = [raw.output, raw.result, raw.payload, raw.data, raw.stdout, raw.content, raw.text, raw.json]; for (const candidate of wrappedCandidates) { if (candidate == null) continue; const parsedCandidate = parseSource(candidate, depth + 1); if (parsedCandidate.items.length > 0 || parsedCandidate.parsedAny || parsedCandidate.degraded === false) return parsedCandidate; } return { items: [], degraded: Object.keys(raw).length > 0, parsedAny: false, partial: false }; } if (typeof raw !== 'string') return { items: [], degraded: true, parsedAny: false, partial: false }; const trimmed = raw.trim(); if (!trimmed) return { items: [], degraded: false, parsedAny: false, partial: false }; const parsed = parseJsonSafe(trimmed); if (Array.isArray(parsed)) return { items: parsed.filter(Boolean), degraded: false, parsedAny: true, partial: false }; if (parsed && typeof parsed === 'object') { const canonical = extractCanonicalItems(parsed) ?? extractCanonicalItems(parsed.output) ?? extractCanonicalItems(parsed.result) ?? extractCanonicalItems(parsed.payload); if (canonical) return { items: canonical, degraded: false, parsedAny: true, partial: false }; } const lines = trimmed.split(/\\r?\\n/).filter((line) => line.trim() !== ''); const parsedLines = []; let failedLines = 0; for (const line of lines) { const parsedLine = parseJsonSafe(line); if (parsedLine == null) { failedLines += 1; continue; } if (Array.isArray(parsedLine)) parsedLines.push(...parsedLine.filter(Boolean)); else parsedLines.push(parsedLine); } if (parsedLines.length > 0) return { items: parsedLines, degraded: failedLines > 0, parsedAny: true, partial: failedLines > 0 }; return { items: [], degraded: true, parsedAny: false, partial: false }; }; const detectLinewiseParseHealth = (raw) => { if (typeof raw !== 'string') return { mixedValidity: false, nonJson: false }; const lines = raw.split(/\\r?\\n/).map((line) => line.trim()).filter(Boolean); if (lines.length === 0) return { mixedValidity: false, nonJson: false }; let parsedLines = 0; let failedLines = 0; for (const line of lines) { if (parseJsonSafe(line) == null) failedLines += 1; else parsedLines += 1; } return { mixedValidity: parsedLines > 0 && failedLines > 0, nonJson: parsedLines === 0 && failedLines > 0 }; }; const getTs = (item) => { if (!item || typeof item !== 'object') return null; const fields = ['completedAt', 'closedAt', 'mergedAt', 'resolvedAt', 'updatedAt', 'createdAt', 'timestamp', 'ts', 'date', 'completed_at', 'closed_at', 'merged_at', 'resolved_at', 'updated_at', 'created_at']; for (const key of fields) { const value = item[key]; if (!value) continue; const ms = Date.parse(String(value)); if (Number.isFinite(ms)) return ms; if (typeof value === 'number' && Number.isFinite(value)) return value > 1e12 ? value : value * 1000; } return null; }; const normalizeBucket = (items) => { const stamped = []; const unstamped = []; for (const item of items) { const ts = getTs(item); if (ts == null) unstamped.push(item); else stamped.push({ item, ts }); } return { stamped, unstamped }; }; const splitWindows = (items) => { const { stamped, unstamped } = normalizeBucket(items); const current = stamped.filter((entry) => entry.ts >= currentStart && entry.ts <= now).map((entry) => entry.item); const previous = stamped.filter((entry) => entry.ts >= previousStart && entry.ts < previousEnd).map((entry) => entry.item); const usedFallbackWindow = stamped.length === 0 && unstamped.length > 0; if (usedFallbackWindow) return { current: unstamped, previous: [], usedFallbackWindow }; return { current, previous, usedFallbackWindow }; }; const metric = (name, value, previous, direction, unit, confidence, status, notes = []) => { const hasCurrent = typeof value === 'number' && Number.isFinite(value); const hasPrevious = typeof previous === 'number' && Number.isFinite(previous); return { name, value: hasCurrent ? value : null, previous: hasPrevious ? previous : null, delta: hasCurrent && hasPrevious ? Number((value - previous).toFixed(2)) : null, direction, unit, confidence, status, notes: notes.filter(Boolean), }; }; const sourceStatus = (nodeOut, parsedList, parsedMeta = {}) => { const output = nodeOut?.output; const hasPayload = (() => { if (output == null) return false; if (Array.isArray(output)) return true; if (typeof output === 'string') return output.trim() !== ''; if (typeof output === 'object') { const wrapped = [output.stdout, output.content, output.text, output.json, output.output, output.result, output.payload, output.data]; if (wrapped.some((v) => (typeof v === 'string' ? v.trim() !== '' : v != null))) return true; return Object.keys(output).length > 0; } return true; })(); const linewiseHealth = (() => { if (typeof output === 'string') return detectLinewiseParseHealth(output); if (output && typeof output === 'object') { const candidate = [output.stdout, output.content, output.text, output.output, output.result, output.payload, output.data].find((value) => typeof value === 'string' && value.trim() !== ''); return detectLinewiseParseHealth(candidate); } return { mixedValidity: false, nonJson: false }; })(); const success = nodeOut?.success !== false; if (!hasPayload) return { status: 'missing', confidence: 'low' }; if (!Array.isArray(parsedList)) return { status: 'degraded', confidence: 'low' }; if (linewiseHealth.mixedValidity) return { status: 'degraded', confidence: parsedList.length > 0 ? 'medium' : 'low' }; if (linewiseHealth.nonJson && parsedList.length === 0) return { status: 'degraded', confidence: 'low' }; if (parsedMeta?.degraded || parsedMeta?.partial) return { status: 'degraded', confidence: parsedList.length > 0 ? 'medium' : 'low' }; if (!success) return { status: 'degraded', confidence: parsedList.length > 0 ? 'medium' : 'low' }; return { status: 'ok', confidence: parsedList.length > 0 ? 'high' : 'medium' }; }; const taskNode = $ctx.getNodeOutput('task-metrics') || {}; const prNode = $ctx.getNodeOutput('pr-metrics') || {}; const debtNode = $ctx.getNodeOutput('debt-metrics') || {}; const prevNode = $ctx.getNodeOutput('read-previous-summary') || {}; const taskParsed = parseSource(taskNode.output); const prParsed = parseSource(prNode.output); const debtParsed = parseSource(debtNode.output); const tasks = taskParsed.items; const prs = prParsed.items; const debt = debtParsed.items; const taskHealth = sourceStatus(taskNode, tasks, taskParsed); const prHealth = sourceStatus(prNode, prs, prParsed); const debtHealth = sourceStatus(debtNode, debt, debtParsed); const taskSplit = splitWindows(tasks); const prSplit = splitWindows(prs); const debtSplit = splitWindows(debt); const doneStatuses = new Set(['done', 'closed', 'completed', 'merged', 'resolved']); const isDone = (item) => doneStatuses.has(String(item?.status ?? item?.state ?? '').toLowerCase()); const taskTelemetryUnavailable = taskHealth.status === 'missing' || (taskHealth.status === 'degraded' && tasks.length === 0); const throughputCurrent = taskTelemetryUnavailable ? null : taskSplit.current.filter(isDone).length; const throughputPrevious = taskTelemetryUnavailable ? null : taskSplit.previous.filter(isDone).length; const reopenedCount = (items) => items.filter((item) => { if (!item || typeof item !== 'object') return false; const reopenCount = toNumber(item.reopenCount ?? item.reopenedCount ?? item.reopen_count ?? item.reopened_count, 0); if (reopenCount > 0) return true; if (item.reopened === true) return true; const status = String(item.status ?? item.state ?? '').toLowerCase(); return status.includes('reopen'); }).length; const reopenedCurrent = taskTelemetryUnavailable ? null : reopenedCount(taskSplit.current); const reopenedPrevious = taskTelemetryUnavailable ? null : reopenedCount(taskSplit.previous); const classifyRegression = (pr) => /revert|regression|rollback|hotfix/i.test(String(pr?.title || '') + ' ' + String(pr?.body || '')); const regressionCurrentCount = prSplit.current.filter(classifyRegression).length; const regressionPreviousCount = prSplit.previous.filter(classifyRegression).length; const regressionCurrentRate = prSplit.current.length > 0 ? Number(((regressionCurrentCount / prSplit.current.length) * 100).toFixed(2)) : null; const regressionPreviousRate = prSplit.previous.length > 0 ? Number(((regressionPreviousCount / prSplit.previous.length) * 100).toFixed(2)) : null; const mergedCount = (items) => items.filter((pr) => String(pr?.state || '').toLowerCase() === 'merged' || Boolean(pr?.mergedAt) || Boolean(pr?.merged_at) || pr?.merged === true).length; const closedCount = (items) => items.filter((pr) => { const state = String(pr?.state || '').toLowerCase(); return state === 'closed' || state === 'merged' || Boolean(pr?.closedAt) || Boolean(pr?.closed_at) || Boolean(pr?.mergedAt) || Boolean(pr?.merged_at); }).length; const mergeClosedCurrent = closedCount(prSplit.current); const mergeClosedPrevious = closedCount(prSplit.previous); const mergeSuccessCurrent = mergeClosedCurrent > 0 ? Number(((mergedCount(prSplit.current) / mergeClosedCurrent) * 100).toFixed(2)) : null; const mergeSuccessPrevious = mergeClosedPrevious > 0 ? Number(((mergedCount(prSplit.previous) / mergeClosedPrevious) * 100).toFixed(2)) : null; const debtDelta = (entries) => { let total = 0; for (const entry of entries) { if (entry == null) continue; if (typeof entry === 'number') { total += entry; continue; } if (typeof entry !== 'object') continue; if (Number.isFinite(Number(entry.debtDelta))) { total += Number(entry.debtDelta); continue; } if (Number.isFinite(Number(entry.delta))) { total += Number(entry.delta); continue; } if (Number.isFinite(Number(entry.netChange))) { total += Number(entry.netChange); continue; } const amt = Number.isFinite(Number(entry.amount)) ? Number(entry.amount) : 1; const kind = String(entry.type || entry.event || entry.action || '').toLowerCase(); if (/resolved|burn|paydown|decrease|closed/.test(kind)) total -= amt; else if (/created|added|increase|opened|new/.test(kind)) total += amt; } return Number(total.toFixed(2)); }; const debtCurrent = debtSplit.current.length > 0 ? debtDelta(debtSplit.current) : null; const debtPrevious = debtSplit.previous.length > 0 ? debtDelta(debtSplit.previous) : null; const priorRaw = prevNode?.success === true ? (parseSource(prevNode.content).items?.[0] ?? parseJsonSafe(prevNode.content)) : null; const priorParsed = priorRaw?.fitnessSummary && typeof priorRaw.fitnessSummary === 'object' ? priorRaw.fitnessSummary : (priorRaw && typeof priorRaw === 'object' ? priorRaw : null); const metricConfidence = (primaryHealth, hasValue, usedFallbackWindow) => { if (!hasValue) return 'low'; if (primaryHealth.status === 'missing') return 'low'; if (primaryHealth.status === 'degraded') return 'low'; if (usedFallbackWindow) return 'medium'; return primaryHealth.confidence || 'medium'; }; const throughputMetric = metric('throughput', throughputCurrent, throughputPrevious, 'up_is_good', 'tasks', metricConfidence(taskHealth, throughputCurrent != null, taskSplit.usedFallbackWindow), taskHealth.status, [throughputCurrent == null ? 'Task telemetry unavailable for this window.' : '', taskSplit.usedFallbackWindow ? 'No task timestamps detected; treated all records as current week.' : '']); const regressionMetric = metric('regression_rate', regressionCurrentRate, regressionPreviousRate, 'down_is_good', 'percent', metricConfidence(prHealth, regressionCurrentRate != null, prSplit.usedFallbackWindow), prHealth.status, [regressionCurrentRate == null ? 'Insufficient PR sample to compute regression rate.' : '', prSplit.usedFallbackWindow ? 'No PR timestamps detected; treated all records as current week.' : '']); const mergeMetric = metric('merge_success', mergeSuccessCurrent, mergeSuccessPrevious, 'up_is_good', 'percent', metricConfidence(prHealth, mergeSuccessCurrent != null, prSplit.usedFallbackWindow), prHealth.status, [mergeSuccessCurrent == null ? 'No closed or merged PRs in scope.' : '', prSplit.usedFallbackWindow ? 'No PR timestamps detected; treated all records as current week.' : '']); const reopenedMetric = metric('reopened_tasks', reopenedCurrent, reopenedPrevious, 'down_is_good', 'tasks', metricConfidence(taskHealth, reopenedCurrent != null, taskSplit.usedFallbackWindow), taskHealth.status, [reopenedCurrent == null ? 'Task telemetry unavailable for this window.' : '', taskSplit.usedFallbackWindow ? 'No task timestamps detected; treated all records as current week.' : '']); const debtMetric = metric('debt_growth', debtCurrent, debtPrevious, 'down_is_good', 'points', metricConfidence(debtHealth, debtCurrent != null, debtSplit.usedFallbackWindow), debtHealth.status, [debtCurrent == null ? 'No debt ledger events in scope.' : '', debtSplit.usedFallbackWindow ? 'No debt timestamps detected; treated all records as current week.' : '']); const metrics = { throughput: throughputMetric, regression_rate: regressionMetric, merge_success: mergeMetric, reopened_tasks: reopenedMetric, debt_growth: debtMetric }; const metricKeys = ['throughput', 'regression_rate', 'merge_success', 'reopened_tasks', 'debt_growth']; const trendDeltas = metricKeys.reduce((acc, key) => { const d = metrics?.[key]?.delta; acc[key] = Number.isFinite(d) ? d : null; return acc; }, {}); const normalizePriorTrendDelta = (metricName) => { const direct = priorParsed?.priorWeekTrendDeltas?.[metricName]; if (Number.isFinite(Number(direct))) return Number(Number(direct).toFixed(2)); const trend = priorParsed?.trendDeltas?.[metricName]; if (Number.isFinite(Number(trend))) return Number(Number(trend).toFixed(2)); const metricDelta = priorParsed?.metrics?.[metricName]?.delta; if (Number.isFinite(Number(metricDelta))) return Number(Number(metricDelta).toFixed(2)); return null; }; const priorWeekTrendDeltas = metricKeys.reduce((acc, key) => { acc[key] = normalizePriorTrendDelta(key); return acc; }, {}); const priorWeekDeltas = priorWeekTrendDeltas; const priorWeekMetrics = priorParsed?.metrics && typeof priorParsed.metrics === 'object' ? priorParsed.metrics : null; const alertThresholds = { throughput: 1, regression_rate: 2.5, merge_success: 2.5, reopened_tasks: 1, debt_growth: 1 }; const metricTrendAlerts = Object.entries(metrics).flatMap(([metricName, m]) => { if (m == null || m.delta == null) return []; if (String(m.confidence || '').toLowerCase() === 'low') return []; const delta = Number(m.delta); const isRegression = (m.direction === 'up_is_good' && delta < 0) || (m.direction === 'down_is_good' && delta > 0); if (!isRegression) return []; const absDelta = Math.abs(delta); const threshold = alertThresholds[metricName] ?? 1; const severity = absDelta >= threshold * 2 ? 'high' : absDelta >= threshold ? 'medium' : 'low'; return [{ metric: metricName, severity, delta, reason: `${metricName} moved in a negative direction by ${delta} ${m.unit}.` }]; }); const sourceHealth = { tasks: { ...taskHealth, count: tasks.length }, prs: { ...prHealth, count: prs.length }, debt: { ...debtHealth, count: debt.length }, }; const sourceTelemetryAlerts = Object.entries(sourceHealth).flatMap(([sourceName, health]) => { if (health?.status === 'ok') return []; const severity = health?.status === 'missing' ? 'high' : 'medium'; const reason = health?.status === 'missing' ? `${sourceName} telemetry missing; metric interpretation may be limited.` : `${sourceName} telemetry partially parsed; confidence reduced.`; return [{ metric: `telemetry:${sourceName}`, severity, delta: null, reason }]; }); const trendAlerts = [...metricTrendAlerts, ...sourceTelemetryAlerts]; const confidenceValues = Object.values(metrics).map((m) => m?.confidence || 'low'); const overallConfidence = confidenceValues.every((c) => c === 'high') ? 'high' : confidenceValues.some((c) => c === 'low') ? 'low' : 'medium'; const plannerSignals = { schemaVersion: '1.0', overallConfidence, trendAlertCount: trendAlerts.length, highSeverityAlertCount: trendAlerts.filter((a) => a?.severity === 'high').length, sourceStatus: Object.fromEntries(Object.entries(sourceHealth).map(([k, v]) => [k, v?.status || 'missing'])), metricStatus: Object.fromEntries(metricKeys.map((k) => [k, metrics?.[k]?.status || 'missing'])), metricConfidence: Object.fromEntries(metricKeys.map((k) => [k, metrics?.[k]?.confidence || 'low'])), metricValues: Object.fromEntries(metricKeys.map((k) => [k, Number.isFinite(metrics?.[k]?.value) ? Number(metrics[k].value) : null])), trendDeltas, priorWeekTrendDeltas, }; const plannerArtifact = { schemaVersion: '1.0', generatedAt: toIso(now), lookbackDays, sourceStatus: plannerSignals.sourceStatus, metricConfidence: plannerSignals.metricConfidence, metricValues: plannerSignals.metricValues, trendDeltas, priorWeekTrendDeltas, trendAlertCount: plannerSignals.trendAlertCount, highSeverityAlertCount: plannerSignals.highSeverityAlertCount, trendAlerts, }; return { schemaVersion: '1.0', generatedAt: toIso(now), lookbackDays, window: { currentStart: toIso(currentStart), currentEnd: toIso(now), previousStart: toIso(previousStart), previousEnd: toIso(previousEnd) }, sourceHealth, metrics, trendDeltas, trendAlerts, priorWeekTrendDeltas, priorWeekDeltas, priorWeekMetrics, plannerSignals, plannerArtifact, dataQuality: { overallConfidence, missingSources: Object.entries(sourceHealth).filter(([, v]) => v.status === 'missing').map(([k]) => k), degradedSources: Object.entries(sourceHealth).filter(([, v]) => v.status === 'degraded').map(([k]) => k), }, }; } catch (error) { return { schemaVersion: '1.0', generatedAt: new Date().toISOString(), lookbackDays: Number($data?.lookbackDays || 7), sourceHealth: { tasks: { status: 'missing', confidence: 'low', count: 0 }, prs: { status: 'missing', confidence: 'low', count: 0 }, debt: { status: 'missing', confidence: 'low', count: 0 }, }, metrics: { throughput: { value: null, previous: null, delta: null, confidence: 'low', status: 'missing' }, regression_rate: { value: null, previous: null, delta: null, confidence: 'low', status: 'missing' }, merge_success: { value: null, previous: null, delta: null, confidence: 'low', status: 'missing' }, reopened_tasks: { value: null, previous: null, delta: null, confidence: 'low', status: 'missing' }, debt_growth: { value: null, previous: null, delta: null, confidence: 'low', status: 'missing' }, }, trendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, trendAlerts: [{ metric: 'summary', severity: 'high', delta: null, reason: `Fitness summary fallback engaged: ${error?.message || 'unknown error'}` }], priorWeekTrendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, priorWeekDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, priorWeekMetrics: null, plannerSignals: { schemaVersion: '1.0', overallConfidence: 'low', trendAlertCount: 1, highSeverityAlertCount: 1, sourceStatus: { tasks: 'missing', prs: 'missing', debt: 'missing' }, metricStatus: { throughput: 'missing', regression_rate: 'missing', merge_success: 'missing', reopened_tasks: 'missing', debt_growth: 'missing' }, metricConfidence: { throughput: 'low', regression_rate: 'low', merge_success: 'low', reopened_tasks: 'low', debt_growth: 'low' }, metricValues: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, trendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, priorWeekTrendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, }, plannerArtifact: { schemaVersion: '1.0', generatedAt: new Date().toISOString(), lookbackDays: Number($data?.lookbackDays || 7), sourceStatus: { tasks: 'missing', prs: 'missing', debt: 'missing' }, metricConfidence: { throughput: 'low', regression_rate: 'low', merge_success: 'low', reopened_tasks: 'low', debt_growth: 'low' }, metricValues: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, trendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, priorWeekTrendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, trendAlertCount: 1, highSeverityAlertCount: 1, trendAlerts: [{ metric: 'summary', severity: 'high', delta: null, reason: `Fitness summary fallback engaged: ${error?.message || 'unknown error'}` }], }, dataQuality: { overallConfidence: 'low', missingSources: ['tasks', 'prs', 'debt'], degradedSources: [] }, }; }})()", - "isExpression": true - }, - "position": { - "x": 420, - "y": 360 - }, - "outputs": [ - "default" - ] - }, - { - "id": "serialize-fitness-summary", - "type": "action.set_variable", - "label": "Serialize Fitness Summary", - "config": { - "key": "fitnessSummaryJson", - "value": "(() => JSON.stringify($data?.fitnessSummary || {}, null, 2))()", - "isExpression": true - }, - "position": { - "x": 420, - "y": 500 + "x": 600, + "y": 200 }, "outputs": [ "default" ] }, { - "id": "render-trend-alerts", - "type": "action.set_variable", - "label": "Render Trend Alerts", + "id": "error-analysis", + "type": "action.analyze_errors", + "label": "Analyze Error Patterns", "config": { - "key": "fitnessTrendAlertsText", - "value": "(() => { const alerts = Array.isArray($data?.fitnessSummary?.trendAlerts) ? $data.fitnessSummary.trendAlerts : []; if (!alerts.length) return 'No negative trend alerts this week.'; return alerts.map((a, idx) => `${idx + 1}. ${a.metric} (${a.severity}) - ${a.reason}`).join('\\n'); })()", - "isExpression": true + "timeWindowMs": "{{lookbackWindowMs}}", + "groupBy": "category" }, "position": { - "x": 420, - "y": 640 + "x": 200, + "y": 350 }, "outputs": [ "default" ] }, { - "id": "persist-fitness-summary", - "type": "action.write_file", - "label": "Persist Fitness Summary Artifact", + "id": "agent-stats", + "type": "action.bosun_cli", + "label": "Agent Performance", "config": { - "path": ".bosun/workflow-runs/weekly-fitness-summary.latest.json", - "content": "{{fitnessSummaryJson}}", - "mkdir": true + "command": "status --json", + "continueOnError": true }, "position": { - "x": 420, - "y": 780 + "x": 600, + "y": 350 }, "outputs": [ "default" ] }, { - "id": "evaluate-fitness", + "id": "generate-retro", "type": "action.run_agent", - "label": "Evaluate Fitness", + "label": "Generate Retrospective", "config": { - "prompt": "# Weekly Delivery Fitness Evaluation\n\nEvaluate the last {{lookbackDays}} days using this machine-readable summary:\n\nMetrics to evaluate:\n- Throughput\n- Regression rate\n- Merge success\n- Reopened tasks\n- Debt growth\n\n## Weekly Fitness JSON\n{{fitnessSummaryJson}}\n\n## Negative Trend Alerts\n{{fitnessTrendAlertsText}}\n\nFocus directive: {{evaluatorFocus}}\n\nRequirements:\n- Respect confidence and status on each metric.\n- If a metric has low confidence or missing telemetry, call that out explicitly and avoid overconfident recommendations.\n- Use prior-week deltas when available.\n- If one telemetry source is unavailable, still provide a stable scorecard and best-effort recommendations.\n\nReturn sections:\n1) Scorecard (0-100) with one line per metric and confidence\n2) Root-cause analysis of the largest drag\n3) Countermeasures ranked by impact/cost\n4) FOLLOW_UP_ACTION lines using format:\nFOLLOW_UP_ACTION: [title] | [description] | [repo_area] | [risk] | [effort]\n\nOnly include FOLLOW_UP_ACTION lines for changes that are worth implementing this week.", + "prompt": "# Sprint Retrospective Analysis\n\nAnalyze the following data from the past {{lookbackDays}} days:\n\n## Task Metrics\n{{taskMetrics}}\n\n## PR Metrics\n{{prMetrics}}\n\n## Error Patterns\n{{errorAnalysis}}\n\n## Agent Performance\n{{agentStats}}\n\nGenerate a retrospective report with these sections:\n\n### :chart: Key Metrics\n- Tasks completed vs created\n- Average task cycle time\n- PR merge rate and average review time\n- Agent success rate\n\n### :check: What Went Well\n- Highlight successful patterns and wins\n\n### :close: What Didn't Go Well\n- Identify bottlenecks and recurring issues\n\n### :target: Action Items\nFor each improvement suggestion, output a line:\nACTION: [title] | [description]\n\nBe specific and actionable. Limit to 3-5 improvement items.", "sdk": "auto", "timeoutMs": 600000 }, "position": { - "x": 420, - "y": 930 + "x": 400, + "y": 520 }, "outputs": [ "default" ] }, { - "id": "has-followups", + "id": "has-actions", "type": "condition.expression", - "label": "Follow-ups Enabled + Present", + "label": "Has Action Items?", "config": { - "expression": "($data?.createFollowupTasks === true) && (($ctx.getNodeOutput('evaluate-fitness')?.output || '').includes('FOLLOW_UP_ACTION:'))" + "expression": "($ctx.getNodeOutput('generate-retro')?.output || '').includes('ACTION:')" }, "position": { - "x": 420, - "y": 1090 + "x": 400, + "y": 680 }, "outputs": [ - "default" + "yes", + "no" ] }, { - "id": "build-followup-json", + "id": "create-tasks", "type": "action.run_agent", - "label": "Build Follow-up Tasks JSON", + "label": "Create Improvement Tasks", "config": { - "prompt": "Convert FOLLOW_UP_ACTION lines below into a single JSON object with shape { \"tasks\": [...] }.\n\nSource:\n{{evaluate-fitness.output}}\n\nStructured context:\n{{fitnessSummaryJson}}\n\nRules:\n- Generate at most {{maxFollowupTasks}} tasks\n- Include fields: title, description, implementation_steps, acceptance_criteria, verification, priority, tags, base_branch, impact, confidence, risk, estimated_effort, repo_areas, why_now, kill_criteria\n- Use trend deltas from the summary artifact to justify urgency and avoid parse errors\n- Keep tasks implementation-ready and avoid duplicates\n- Return only JSON", + "prompt": "# Create Improvement Tasks\n\nFrom the retrospective output, extract all lines starting with ACTION:\nand create a bosun task for each one.\n\nUse the CLI: bosun task create --title \"[title]\" --description \"[description]\" --tag improvement --tag retro\n\nOnly create tasks if {{createImprovementTasks}} is true.", "sdk": "auto", "timeoutMs": 300000 }, "position": { - "x": 220, - "y": 1260 - }, - "outputs": [ - "default" - ] - }, - { - "id": "materialize-followups", - "type": "action.materialize_planner_tasks", - "label": "Materialize Follow-up Tasks", - "config": { - "plannerNodeId": "build-followup-json", - "maxTasks": "{{maxFollowupTasks}}", - "status": "todo", - "dedup": true, - "failOnZero": false, - "minCreated": 0 - }, - "position": { - "x": 220, - "y": 1420 + "x": 250, + "y": 830 }, "outputs": [ "default" ] }, { - "id": "notify-summary", + "id": "send-report", "type": "notify.telegram", - "label": "Send Weekly Fitness Summary", + "label": "Send Retro Report", "config": { - "message": ":chart: Weekly fitness evaluation complete. Follow-up tasks created: {{materialize-followups.createdCount}}\\n\\nTrend alerts:\\n{{fitnessTrendAlertsText}}\\n\\n{{evaluate-fitness.output}}", - "silent": true + "message": ":clipboard: **Weekly Retrospective** (past {{lookbackDays}} days)\n\n{{retroOutput}}" }, "position": { - "x": 420, - "y": 1580 + "x": 400, + "y": 980 }, "outputs": [ "default" ] }, { - "id": "log-no-followups", + "id": "log-no-actions", "type": "notify.log", - "label": "No Follow-up Tasks", + "label": "No Actions Needed", "config": { - "message": "Weekly fitness evaluation completed with no follow-up task creation.", + "message": "Sprint retrospective complete — no action items generated", "level": "info" }, "position": { - "x": 620, - "y": 1260 + "x": 600, + "y": 830 }, "outputs": [ "default" @@ -33908,111 +27251,69 @@ "sourcePort": "default" }, { - "id": "trigger->debt-metrics", - "source": "trigger", - "target": "debt-metrics", - "sourcePort": "default" - }, - { - "id": "trigger->read-previous-summary", - "source": "trigger", - "target": "read-previous-summary", - "sourcePort": "default" - }, - { - "id": "task-metrics->summarize-fitness-metrics", + "id": "task-metrics->error-analysis", "source": "task-metrics", - "target": "summarize-fitness-metrics", + "target": "error-analysis", "sourcePort": "default" }, { - "id": "pr-metrics->summarize-fitness-metrics", + "id": "pr-metrics->agent-stats", "source": "pr-metrics", - "target": "summarize-fitness-metrics", - "sourcePort": "default" - }, - { - "id": "debt-metrics->summarize-fitness-metrics", - "source": "debt-metrics", - "target": "summarize-fitness-metrics", - "sourcePort": "default" - }, - { - "id": "read-previous-summary->summarize-fitness-metrics", - "source": "read-previous-summary", - "target": "summarize-fitness-metrics", - "sourcePort": "default" - }, - { - "id": "summarize-fitness-metrics->serialize-fitness-summary", - "source": "summarize-fitness-metrics", - "target": "serialize-fitness-summary", - "sourcePort": "default" - }, - { - "id": "serialize-fitness-summary->render-trend-alerts", - "source": "serialize-fitness-summary", - "target": "render-trend-alerts", + "target": "agent-stats", "sourcePort": "default" }, { - "id": "render-trend-alerts->persist-fitness-summary", - "source": "render-trend-alerts", - "target": "persist-fitness-summary", + "id": "error-analysis->generate-retro", + "source": "error-analysis", + "target": "generate-retro", "sourcePort": "default" }, { - "id": "persist-fitness-summary->evaluate-fitness", - "source": "persist-fitness-summary", - "target": "evaluate-fitness", + "id": "agent-stats->generate-retro", + "source": "agent-stats", + "target": "generate-retro", "sourcePort": "default" }, { - "id": "evaluate-fitness->has-followups", - "source": "evaluate-fitness", - "target": "has-followups", + "id": "generate-retro->has-actions", + "source": "generate-retro", + "target": "has-actions", "sourcePort": "default" }, { - "id": "has-followups->build-followup-json", - "source": "has-followups", - "target": "build-followup-json", - "sourcePort": "default", + "id": "has-actions->create-tasks", + "source": "has-actions", + "target": "create-tasks", + "sourcePort": "yes", "condition": "$output?.result === true" }, { - "id": "has-followups->log-no-followups", - "source": "has-followups", - "target": "log-no-followups", - "sourcePort": "default", + "id": "has-actions->log-no-actions", + "source": "has-actions", + "target": "log-no-actions", + "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "build-followup-json->materialize-followups", - "source": "build-followup-json", - "target": "materialize-followups", - "sourcePort": "default" - }, - { - "id": "materialize-followups->notify-summary", - "source": "materialize-followups", - "target": "notify-summary", + "id": "create-tasks->send-report", + "source": "create-tasks", + "target": "send-report", "sourcePort": "default" }, { - "id": "log-no-followups->notify-summary", - "source": "log-no-followups", - "target": "notify-summary", + "id": "log-no-actions->send-report", + "source": "log-no-actions", + "target": "send-report", "sourcePort": "default" } ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-28T12:00:00.000Z", - "updatedAt": "2026-03-28T12:00:00.000Z", + "createdAt": "2026-03-21T12:00:00.000Z", + "updatedAt": "2026-03-21T12:00:00.000Z", "templateState": { - "templateId": "template-weekly-fitness-summary", - "templateName": "Weekly Fitness Summary", + "templateId": "template-sprint-retrospective", + "templateName": "Sprint Retrospective", "templateVersion": "1.0.0", "installedTemplateVersion": "1.0.0", "isCustomized": false, @@ -34021,26 +27322,29 @@ } }, { - "id": "wf-anomaly-watchdog", - "name": "Anomaly Watchdog", - "description": "Real-time anomaly detection for agent sessions — catches death loops, stalls, token overflows, rebase spirals, and thought spinning. Automatically intervenes or escalates depending on severity.", - "category": "reliability", + "id": "wf-task-planner", + "name": "Task Planner", + "description": "Automatically generates new backlog tasks when the todo count drops below a configurable threshold. Replaces the previous hardcoded TASK_PLANNER_MODE / REPLENISH_ENABLED env-var system.", + "category": "planning", "enabled": true, - "nodeCount": 9, - "trigger": "trigger.event", + "nodeCount": 11, + "trigger": "trigger.task_low", "variables": { - "stallThresholdMs": 300000, - "maxTokenUsage": 0.9, - "maxConsecutiveErrors": 5 + "minTodoCount": 3, + "taskCount": 5, + "dedupHours": 24, + "failureCooldownMinutes": 30, + "prompt": "", + "plannerContext": "Focus on high-value implementation work. Avoid duplicating existing tasks." }, "nodes": [ { "id": "trigger", - "type": "trigger.event", - "label": "Agent Anomaly Detected", + "type": "trigger.task_low", + "label": "Backlog Low?", "config": { - "eventType": "agent.anomaly", - "filter": "$event?.severity === 'high' || $event?.severity === 'critical'" + "threshold": "{{minTodoCount}}", + "status": "todo" }, "position": { "x": 400, @@ -34051,142 +27355,172 @@ ] }, { - "id": "classify", - "type": "condition.switch", - "label": "Classify Anomaly", + "id": "check-dedup", + "type": "condition.expression", + "label": "Dedup Window", "config": { - "value": "$data?.anomalyType || 'unknown'", - "cases": { - "DEATH_LOOP": "death-loop", - "STALL": "stall", - "TOKEN_OVERFLOW": "token-overflow", - "REBASE_SPIRAL": "rebase-spiral", - "THOUGHT_SPIN": "thought-spin" - } + "expression": "(() => { const now = Date.now(); const lastSuccessAt = Number($data?._lastPlannerRun || 0); const lastFailureAt = Number($data?._lastPlannerFailureAt || 0); const successWindowMs = Number($data?.dedupHours || 24) * 3600000; const failureWindowMs = Number($data?.failureCooldownMinutes || 30) * 60000; return (now - lastSuccessAt) > successWindowMs && (now - lastFailureAt) > failureWindowMs;})()" }, "position": { "x": 400, - "y": 200 + "y": 180 }, "outputs": [ - "death-loop", - "stall", - "token-overflow", - "rebase-spiral", - "thought-spin", "default" ] }, { - "id": "kill-and-restart", - "type": "action.restart_agent", - "label": "Kill & Restart Agent", + "id": "log-start", + "type": "notify.log", + "label": "Log Planner Start", "config": { - "sessionId": "{{sessionId}}", - "reason": "Death loop detected — agent cycling through the same error pattern", - "prompt": "The previous session entered a death loop. Start fresh with a different approach.\n\nOriginal task: {{taskTitle}}" + "message": "Task planner triggered: {{trigger.todoCount}} tasks remaining (threshold: {{minTodoCount}})", + "level": "info" }, "position": { - "x": 100, - "y": 380 + "x": 400, + "y": 310 }, "outputs": [ "default" ] }, { - "id": "nudge-stall", - "type": "action.continue_session", - "label": "Nudge Stalled Agent", + "id": "run-planner", + "type": "agent.run_planner", + "label": "Generate Tasks", "config": { - "sessionId": "{{sessionId}}", - "prompt": "You appear to be stalled. Please continue working on the current task. If you are stuck, describe the blocker and try a different approach.", - "strategy": "continue" + "taskCount": "{{taskCount}}", + "context": "{{plannerContext}}", + "prompt": "{{prompt}}", + "repoMapQuery": "{{plannerContext}} {{prompt}}", + "repoMapFileLimit": 8, + "dedup": true, + "timeoutMs": 960000, + "agentTimeoutMs": 900000, + "maxRetries": 0, + "retryable": false }, "position": { - "x": 300, - "y": 380 + "x": 400, + "y": 440 }, "outputs": [ "default" ] }, { - "id": "trim-context", - "type": "action.continue_session", - "label": "Trim Context & Continue", + "id": "materialize-tasks", + "type": "action.materialize_planner_tasks", + "label": "Create Tasks", "config": { - "sessionId": "{{sessionId}}", - "prompt": "Your context window is nearly full. Summarize your progress so far in 2-3 sentences, then continue with the most critical remaining work.", - "strategy": "refine" + "plannerNodeId": "run-planner", + "maxTasks": "{{taskCount}}", + "status": "draft", + "dedup": true, + "failOnZero": true, + "minCreated": 1 }, "position": { - "x": 500, - "y": 380 + "x": 400, + "y": 570 }, "outputs": [ "default" ] }, { - "id": "fix-rebase", - "type": "action.run_command", - "label": "Fix Stuck Rebase", + "id": "check-result", + "type": "condition.expression", + "label": "Planner Succeeded?", "config": { - "command": "git rebase --abort 2>/dev/null; git reset --hard HEAD; git checkout -B {{branch}} origin/{{branch}} 2>/dev/null || true", - "cwd": "{{worktreePath}}" + "expression": "$ctx.getNodeOutput('materialize-tasks')?.success === true && ($ctx.getNodeOutput('materialize-tasks')?.createdCount || 0) > 0" }, "position": { - "x": 700, - "y": 380 + "x": 400, + "y": 700 }, "outputs": [ "default" ] }, { - "id": "break-spin", - "type": "action.continue_session", - "label": "Break Thought Spin", + "id": "set-timestamp", + "type": "action.set_variable", + "label": "Update Last Run", "config": { - "sessionId": "{{sessionId}}", - "prompt": "Stop your current analysis. You are repeating the same reasoning. Take a concrete action NOW:\n1. Make a specific code change, OR\n2. Run a specific command, OR\n3. Report that you are blocked and need help.\nDo NOT continue analyzing.", - "strategy": "continue" + "key": "_lastPlannerRun", + "value": "Date.now()", + "isExpression": true }, "position": { - "x": 900, - "y": 380 + "x": 200, + "y": 830 }, "outputs": [ "default" ] }, { - "id": "log-intervention", + "id": "notify-done", + "type": "notify.telegram", + "label": "Notify Tasks Created", + "config": { + "message": ":folder: Task planner created {{materialize-tasks.createdCount}} backlog tasks (skipped {{materialize-tasks.skippedCount}} duplicates).", + "silent": true + }, + "position": { + "x": 200, + "y": 960 + }, + "outputs": [ + "default" + ] + }, + { + "id": "notify-skip", "type": "notify.log", - "label": "Log Intervention", + "label": "Log Dedup Skip", "config": { - "message": "Anomaly watchdog intervened: {{anomalyType}} for session {{sessionId}}", + "message": "Task planner skipped: within dedup window", + "level": "info" + }, + "position": { + "x": 650, + "y": 180 + }, + "outputs": [ + "default" + ] + }, + { + "id": "notify-fail", + "type": "notify.log", + "label": "Log Planner Failure", + "config": { + "message": "Task planner failed to materialize tasks from planner output", "level": "warn" }, "position": { - "x": 400, - "y": 550 + "x": 600, + "y": 830 }, "outputs": [ "default" ] }, { - "id": "alert-telegram", - "type": "notify.telegram", - "label": "Alert Human", + "id": "set-timestamp-fail", + "type": "action.set_variable", + "label": "Cooldown After Failure", "config": { - "message": ":alert: Agent anomaly detected: **{{anomalyType}}**\nSession: {{sessionId}}\nTask: {{taskTitle}}\nIntervention: auto-applied\nThresholds: stall={{stallThresholdMs}}ms token={{maxTokenUsage}} maxErrors={{maxConsecutiveErrors}}" + "key": "_lastPlannerFailureAt", + "value": "Date.now()", + "isExpression": true }, "position": { - "x": 400, - "y": 700 + "x": 600, + "y": 960 }, "outputs": [ "default" @@ -34195,743 +27529,834 @@ ], "edges": [ { - "id": "trigger->classify", + "id": "trigger->check-dedup", "source": "trigger", - "target": "classify", + "target": "check-dedup", "sourcePort": "default" }, { - "id": "classify->kill-and-restart", - "source": "classify", - "target": "kill-and-restart", - "sourcePort": "death-loop" - }, - { - "id": "classify->nudge-stall", - "source": "classify", - "target": "nudge-stall", - "sourcePort": "stall" - }, - { - "id": "classify->trim-context", - "source": "classify", - "target": "trim-context", - "sourcePort": "token-overflow" + "id": "check-dedup->log-start", + "source": "check-dedup", + "target": "log-start", + "sourcePort": "default", + "condition": "$output?.result === true" }, { - "id": "classify->fix-rebase", - "source": "classify", - "target": "fix-rebase", - "sourcePort": "rebase-spiral" + "id": "check-dedup->notify-skip", + "source": "check-dedup", + "target": "notify-skip", + "sourcePort": "default", + "condition": "$output?.result !== true" }, { - "id": "classify->break-spin", - "source": "classify", - "target": "break-spin", - "sourcePort": "thought-spin" + "id": "log-start->run-planner", + "source": "log-start", + "target": "run-planner", + "sourcePort": "default" }, { - "id": "kill-and-restart->log-intervention", - "source": "kill-and-restart", - "target": "log-intervention", + "id": "run-planner->materialize-tasks", + "source": "run-planner", + "target": "materialize-tasks", "sourcePort": "default" }, { - "id": "nudge-stall->log-intervention", - "source": "nudge-stall", - "target": "log-intervention", + "id": "materialize-tasks->check-result", + "source": "materialize-tasks", + "target": "check-result", "sourcePort": "default" }, { - "id": "trim-context->log-intervention", - "source": "trim-context", - "target": "log-intervention", - "sourcePort": "default" + "id": "check-result->set-timestamp", + "source": "check-result", + "target": "set-timestamp", + "sourcePort": "default", + "condition": "$output?.result === true" }, { - "id": "fix-rebase->log-intervention", - "source": "fix-rebase", - "target": "log-intervention", - "sourcePort": "default" + "id": "check-result->notify-fail", + "source": "check-result", + "target": "notify-fail", + "sourcePort": "default", + "condition": "$output?.result !== true" }, { - "id": "break-spin->log-intervention", - "source": "break-spin", - "target": "log-intervention", + "id": "set-timestamp->notify-done", + "source": "set-timestamp", + "target": "notify-done", "sourcePort": "default" }, { - "id": "log-intervention->alert-telegram", - "source": "log-intervention", - "target": "alert-telegram", + "id": "notify-fail->set-timestamp-fail", + "source": "notify-fail", + "target": "set-timestamp-fail", "sourcePort": "default" } ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-28T12:00:00.000Z", - "updatedAt": "2026-03-28T12:00:00.000Z", + "createdAt": "2026-03-22T12:00:00.000Z", + "updatedAt": "2026-03-22T12:00:00.000Z", "templateState": { - "templateId": "template-anomaly-watchdog", - "templateName": "Anomaly Watchdog", - "templateVersion": "1.0.1", - "installedTemplateVersion": "1.0.1", + "templateId": "template-task-planner", + "templateName": "Task Planner", + "templateVersion": "1.0.0", + "installedTemplateVersion": "1.0.0", "isCustomized": false, "updateAvailable": false } } }, { - "id": "wf-continuation-loop", - "name": "Continuation Loop", - "description": "Issue-state continuation loop. Fires automatically for any available task (trigger.task_available), drives the agent until a terminal state or max turns, and handles stuck sessions with retry/escalate/pause. taskId and worktreePath are auto-populated from the picked task — no manual input required.", - "category": "reliability", - "enabled": true, - "nodeCount": 34, - "trigger": "trigger.task_available", + "id": "wf-task-replenish", + "name": "Task Replenish (Scheduled)", + "description": "Periodically checks backlog and replenishes tasks on a schedule. This replaces the previous INTERNAL_EXECUTOR_REPLENISH_ENABLED env var with a configurable visual workflow.", + "category": "planning", + "enabled": false, + "nodeCount": 7, + "trigger": "trigger.schedule", "variables": { - "maxParallel": 1, - "taskId": "", - "worktreePath": "", - "maxTurns": 8, - "pollIntervalMs": 30000, - "terminalStates": [ - "done", - "cancelled" - ], - "stuckThresholdMs": 300000, - "maxStuckAutoRetries": 1, - "onStuck": "escalate", - "continuePrompt": "Continue this task from the current state. Focus on the next missing step and push toward completion.", - "retryPrompt": "No progress was detected recently. Try a different approach and make concrete progress (commit or file updates).", - "sdk": "auto", - "model": "", - "timeoutMs": 1800000 + "intervalMs": 3600000, + "minTodoCount": 5, + "taskCount": 8, + "prompt": "", + "plannerContext": "Scheduled replenishment run. Prioritize implementation tasks that build on recent PRs." }, "nodes": [ { "id": "trigger", - "type": "trigger.task_available", - "label": "Pick Available Task", - "config": { - "maxParallel": "{{maxParallel}}", - "status": "inprogress", - "statuses": [ - "inprogress", - "todo" - ], - "filterCodexScoped": true, - "filterDrafts": true - }, - "position": { - "x": 420, - "y": 60 - }, - "outputs": [ - "default" - ] - }, - { - "id": "init-turn", - "type": "action.set_variable", - "label": "Initialize Turn Counter", - "config": { - "key": "continuationTurn", - "value": "0", - "isExpression": true - }, - "position": { - "x": 420, - "y": 170 - }, - "outputs": [ - "default" - ] - }, - { - "id": "init-progress-at", - "type": "action.set_variable", - "label": "Initialize Progress Clock", - "config": { - "key": "lastProgressAt", - "value": "Date.now()", - "isExpression": true - }, - "position": { - "x": 420, - "y": 280 - }, - "outputs": [ - "default" - ] - }, - { - "id": "init-signature", - "type": "action.set_variable", - "label": "Initialize Progress Signature", + "type": "trigger.schedule", + "label": "Hourly Check", "config": { - "key": "lastProgressSignature", - "value": "''", - "isExpression": true + "intervalMs": "{{intervalMs}}" }, "position": { - "x": 420, - "y": 390 + "x": 400, + "y": 50 }, "outputs": [ "default" ] }, { - "id": "init-stuck-retry-count", - "type": "action.set_variable", - "label": "Initialize Stuck Retry Count", + "id": "check-backlog", + "type": "trigger.task_low", + "label": "Check Backlog Level", "config": { - "key": "stuckRetryCount", - "value": "0", - "isExpression": true + "threshold": "{{minTodoCount}}" }, - "position": { - "x": 420, - "y": 450 + "position": { + "x": 400, + "y": 180 }, "outputs": [ "default" ] }, { - "id": "poll-task", - "type": "action.bosun_function", - "label": "Poll External Task State", + "id": "needs-tasks", + "type": "condition.expression", + "label": "Needs Replenishment?", "config": { - "function": "tasks.get", - "args": { - "taskId": "{{taskId}}" - }, - "outputVariable": "continuationTask" + "expression": "$ctx.getNodeOutput('check-backlog')?.triggered === true" }, "position": { - "x": 420, - "y": 500 + "x": 400, + "y": 310 }, "outputs": [ "default" ] }, { - "id": "derive-status", - "type": "action.set_variable", - "label": "Derive External Status", + "id": "run-planner", + "type": "agent.run_planner", + "label": "Generate Tasks", "config": { - "key": "currentExternalStatus", - "value": "String(($data?.continuationTask?.externalStatus ?? $data?.continuationTask?.status ?? '') || '').trim().toLowerCase()", - "isExpression": true + "taskCount": "{{taskCount}}", + "context": "{{plannerContext}}", + "prompt": "{{prompt}}", + "repoMapQuery": "{{plannerContext}} {{prompt}}", + "repoMapFileLimit": 8, + "timeoutMs": 960000, + "agentTimeoutMs": 900000, + "maxRetries": 0, + "retryable": false }, "position": { - "x": 420, - "y": 610 + "x": 400, + "y": 440 }, "outputs": [ "default" ] }, { - "id": "terminal-check", - "type": "condition.expression", - "label": "Terminal State Reached?", + "id": "materialize-tasks", + "type": "action.materialize_planner_tasks", + "label": "Create Tasks", "config": { - "expression": "(() => { const s = String($data?.currentExternalStatus || '').trim().toLowerCase(); const t = Array.isArray($data?.terminalStates) ? $data.terminalStates.map(v => String(v || '').trim().toLowerCase()).filter(Boolean) : []; return Boolean(s) && t.includes(s); })()" + "plannerNodeId": "run-planner", + "maxTasks": "{{taskCount}}", + "status": "todo", + "dedup": true, + "failOnZero": true, + "minCreated": 1 }, "position": { - "x": 420, - "y": 720 + "x": 400, + "y": 570 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "end-terminal", - "type": "flow.end", - "label": "End: Terminal State", + "id": "notify", + "type": "notify.telegram", + "label": "Notify", "config": { - "status": "completed", - "message": "Continuation loop completed: terminal external state '{{currentExternalStatus}}' reached for task {{taskId}}.", - "output": { - "reason": "terminal_state", - "taskId": "{{taskId}}", - "externalStatus": "{{currentExternalStatus}}" - } + "message": ":refresh: Scheduled replenishment created {{materialize-tasks.createdCount}} tasks (skipped {{materialize-tasks.skippedCount}}).", + "silent": true }, "position": { - "x": 160, - "y": 860 + "x": 400, + "y": 700 }, "outputs": [ "default" ] }, { - "id": "max-turns-check", - "type": "condition.expression", - "label": "Max Turns Reached?", + "id": "skip-log", + "type": "notify.log", + "label": "No Replenish Needed", "config": { - "expression": "Number($data?.continuationTurn || 0) >= Number($data?.maxTurns || 0)" + "message": "Scheduled replenishment check: backlog sufficient, skipping" }, "position": { - "x": 620, - "y": 860 + "x": 700, + "y": 310 }, "outputs": [ - "yes", - "no" + "default" ] + } + ], + "edges": [ + { + "id": "trigger->check-backlog", + "source": "trigger", + "target": "check-backlog", + "sourcePort": "default" }, { - "id": "end-max-turns", - "type": "flow.end", - "label": "End: Max Turns", + "id": "check-backlog->needs-tasks", + "source": "check-backlog", + "target": "needs-tasks", + "sourcePort": "default" + }, + { + "id": "needs-tasks->run-planner", + "source": "needs-tasks", + "target": "run-planner", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "needs-tasks->skip-log", + "source": "needs-tasks", + "target": "skip-log", + "sourcePort": "default", + "condition": "$output?.result !== true" + }, + { + "id": "run-planner->materialize-tasks", + "source": "run-planner", + "target": "materialize-tasks", + "sourcePort": "default" + }, + { + "id": "materialize-tasks->notify", + "source": "materialize-tasks", + "target": "notify", + "sourcePort": "default" + } + ], + "metadata": { + "author": "bosun-demo", + "createdAt": "2026-03-23T12:00:00.000Z", + "updatedAt": "2026-03-23T12:00:00.000Z", + "templateState": { + "templateId": "template-task-replenish", + "templateName": "Task Replenish (Scheduled)", + "templateVersion": "1.0.0", + "installedTemplateVersion": "1.0.0", + "isCustomized": false, + "updateAvailable": false + } + } + }, + { + "id": "wf-weekly-fitness-summary", + "name": "Weekly Fitness Summary", + "description": "Weekly evaluator workflow that scores delivery fitness using throughput, regression rate, merge success, reopened tasks, and debt growth. Produces follow-up actions and can materialize them as backlog tasks.", + "category": "planning", + "enabled": false, + "nodeCount": 15, + "trigger": "trigger.schedule", + "variables": { + "scheduleCron": "0 9 * * 1", + "lookbackDays": 7, + "evaluatorFocus": "Bias toward systemic fixes that reduce regressions and execution thrash.", + "createFollowupTasks": true, + "maxFollowupTasks": 4 + }, + "nodes": [ + { + "id": "trigger", + "type": "trigger.schedule", + "label": "Weekly Schedule", "config": { - "status": "failed", - "message": "Continuation loop stopped after reaching maxTurns={{maxTurns}} for task {{taskId}}.", - "output": { - "reason": "max_turns", - "taskId": "{{taskId}}", - "turns": "{{continuationTurn}}" - } + "intervalMs": 604800000, + "cron": "{{scheduleCron}}" }, "position": { - "x": 460, - "y": 1000 + "x": 420, + "y": 40 }, "outputs": [ "default" ] }, { - "id": "run-agent", - "type": "action.run_agent", - "label": "Drive Agent", + "id": "task-metrics", + "type": "action.bosun_cli", + "label": "Collect Task Metrics", "config": { - "prompt": "{{continuePrompt}}", - "taskId": "{{taskId}}", - "cwd": "{{worktreePath}}", - "sdk": "{{sdk}}", - "model": "{{model}}", - "timeoutMs": "{{timeoutMs}}", - "requireTaskPromptCompleteness": false, - "failOnError": false + "subcommand": "task list", + "args": "--json", + "parseJson": true, + "continueOnError": true }, "position": { - "x": 800, - "y": 1000 + "x": 150, + "y": 180 }, "outputs": [ "default" ] }, { - "id": "capture-progress", + "id": "pr-metrics", "type": "action.run_command", - "label": "Capture Progress Signature", + "label": "Collect PR Metrics", "config": { - "command": "node -e \"const cp=require('node:child_process');const crypto=require('node:crypto');const head=(cp.execSync('git rev-parse HEAD',{encoding:'utf8'}).trim()||'');const dirtyRaw=cp.execSync('git status --porcelain=v1',{encoding:'utf8'});const dirtyCount=dirtyRaw.split(/\\r?\\n/).filter(Boolean).length;const statusDigest=crypto.createHash('sha1').update(dirtyRaw).digest('hex').slice(0,16);process.stdout.write(JSON.stringify({head,dirtyCount,statusDigest}));\"", - "cwd": "{{worktreePath}}", - "failOnError": false + "command": "gh pr list --state all --json number,state,mergedAt,closedAt,createdAt,updatedAt,title,body --limit 200", + "continueOnError": true }, "position": { - "x": 800, - "y": 1120 + "x": 420, + "y": 180 }, "outputs": [ "default" ] }, { - "id": "derive-signature", - "type": "action.set_variable", - "label": "Derive Signature", + "id": "debt-metrics", + "type": "action.run_command", + "label": "Collect Debt Signals", "config": { - "key": "currentProgressSignature", - "value": "(() => { const raw = String($ctx.getNodeOutput('capture-progress')?.output || '').trim(); try { const parsed = JSON.parse(raw); const head = String(parsed?.head || ''); const dirty = Number(parsed?.dirtyCount || 0); const statusDigest = String(parsed?.statusDigest || ''); return `${head}:${dirty}:${statusDigest}`; } catch { return ''; } })()", - "isExpression": true + "command": "node -e \"const fs=require('fs');const p='.bosun/workflow-runs/task-debt-ledger.jsonl';if(!fs.existsSync(p)){console.log('[]');process.exit(0);}const lines=fs.readFileSync(p,'utf8').split(/\\r?\\n/).filter(Boolean);console.log(JSON.stringify(lines.slice(-500).map(l=>{try{return JSON.parse(l)}catch{return null}}).filter(Boolean)));\"", + "continueOnError": true }, "position": { - "x": 800, - "y": 1240 + "x": 690, + "y": 180 }, "outputs": [ "default" ] }, { - "id": "derive-stuck-ms", - "type": "action.set_variable", - "label": "Derive Stuck Duration", + "id": "read-previous-summary", + "type": "action.read_file", + "label": "Read Prior Summary", "config": { - "key": "stuckForMs", - "value": "Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))", - "isExpression": true + "path": ".bosun/workflow-runs/weekly-fitness-summary.latest.json" }, "position": { - "x": 1080, - "y": 1230 + "x": 960, + "y": 180 }, "outputs": [ "default" ] }, { - "id": "progress-changed", - "type": "condition.expression", - "label": "Progress Changed?", + "id": "summarize-fitness-metrics", + "type": "action.set_variable", + "label": "Summarize Fitness Metrics", "config": { - "expression": "String($data?.currentProgressSignature || '') !== String($data?.lastProgressSignature || '')" + "key": "fitnessSummary", + "value": "(() => { try { const now = Date.now(); const lookbackDays = Math.max(1, Number($data?.lookbackDays || 7)); const windowMs = lookbackDays * 24 * 60 * 60 * 1000; const currentStart = now - windowMs; const previousStart = currentStart - windowMs; const previousEnd = currentStart; const toNumber = (v, fallback = 0) => { const n = Number(v); return Number.isFinite(n) ? n : fallback; }; const toIso = (ms) => new Date(ms).toISOString(); const parseJsonSafe = (raw) => { try { return JSON.parse(String(raw)); } catch { return null; } }; const extractCanonicalItems = (value) => { if (!value || typeof value !== 'object') return null; const keys = ['items', 'tasks', 'entries', 'records', 'results', 'data']; for (const key of keys) { if (Array.isArray(value[key])) return value[key].filter(Boolean); } return null; }; const parseSource = (raw, depth = 0) => { if (depth > 3) return { items: [], degraded: true, parsedAny: false, partial: false }; if (Array.isArray(raw)) return { items: raw.filter(Boolean), degraded: false, parsedAny: raw.length > 0, partial: false }; if (raw && typeof raw === 'object') { const canonical = extractCanonicalItems(raw) ?? extractCanonicalItems(raw.output) ?? extractCanonicalItems(raw.result) ?? extractCanonicalItems(raw.payload); if (canonical) return { items: canonical, degraded: false, parsedAny: canonical.length > 0, partial: false }; const wrappedCandidates = [raw.output, raw.result, raw.payload, raw.data, raw.stdout, raw.content, raw.text, raw.json]; for (const candidate of wrappedCandidates) { if (candidate == null) continue; const parsedCandidate = parseSource(candidate, depth + 1); if (parsedCandidate.items.length > 0 || parsedCandidate.parsedAny || parsedCandidate.degraded === false) return parsedCandidate; } return { items: [], degraded: Object.keys(raw).length > 0, parsedAny: false, partial: false }; } if (typeof raw !== 'string') return { items: [], degraded: true, parsedAny: false, partial: false }; const trimmed = raw.trim(); if (!trimmed) return { items: [], degraded: false, parsedAny: false, partial: false }; const parsed = parseJsonSafe(trimmed); if (Array.isArray(parsed)) return { items: parsed.filter(Boolean), degraded: false, parsedAny: true, partial: false }; if (parsed && typeof parsed === 'object') { const canonical = extractCanonicalItems(parsed) ?? extractCanonicalItems(parsed.output) ?? extractCanonicalItems(parsed.result) ?? extractCanonicalItems(parsed.payload); if (canonical) return { items: canonical, degraded: false, parsedAny: true, partial: false }; } const lines = trimmed.split(/\\r?\\n/).filter((line) => line.trim() !== ''); const parsedLines = []; let failedLines = 0; for (const line of lines) { const parsedLine = parseJsonSafe(line); if (parsedLine == null) { failedLines += 1; continue; } if (Array.isArray(parsedLine)) parsedLines.push(...parsedLine.filter(Boolean)); else parsedLines.push(parsedLine); } if (parsedLines.length > 0) return { items: parsedLines, degraded: failedLines > 0, parsedAny: true, partial: failedLines > 0 }; return { items: [], degraded: true, parsedAny: false, partial: false }; }; const getTs = (item) => { if (!item || typeof item !== 'object') return null; const fields = ['completedAt', 'closedAt', 'mergedAt', 'resolvedAt', 'updatedAt', 'createdAt', 'timestamp', 'ts', 'date', 'completed_at', 'closed_at', 'merged_at', 'resolved_at', 'updated_at', 'created_at']; for (const key of fields) { const value = item[key]; if (!value) continue; const ms = Date.parse(String(value)); if (Number.isFinite(ms)) return ms; if (typeof value === 'number' && Number.isFinite(value)) return value > 1e12 ? value : value * 1000; } return null; }; const normalizeBucket = (items) => { const stamped = []; const unstamped = []; for (const item of items) { const ts = getTs(item); if (ts == null) unstamped.push(item); else stamped.push({ item, ts }); } return { stamped, unstamped }; }; const splitWindows = (items) => { const { stamped, unstamped } = normalizeBucket(items); const current = stamped.filter((entry) => entry.ts >= currentStart && entry.ts <= now).map((entry) => entry.item); const previous = stamped.filter((entry) => entry.ts >= previousStart && entry.ts < previousEnd).map((entry) => entry.item); const usedFallbackWindow = stamped.length === 0 && unstamped.length > 0; if (usedFallbackWindow) return { current: unstamped, previous: [], usedFallbackWindow }; return { current, previous, usedFallbackWindow }; }; const metric = (name, value, previous, direction, unit, confidence, status, notes = []) => { const hasCurrent = typeof value === 'number' && Number.isFinite(value); const hasPrevious = typeof previous === 'number' && Number.isFinite(previous); return { name, value: hasCurrent ? value : null, previous: hasPrevious ? previous : null, delta: hasCurrent && hasPrevious ? Number((value - previous).toFixed(2)) : null, direction, unit, confidence, status, notes: notes.filter(Boolean), }; }; const sourceStatus = (nodeOut, parsedList, parsedMeta = {}) => { const output = nodeOut?.output; const hasPayload = (() => { if (output == null) return false; if (Array.isArray(output)) return true; if (typeof output === 'string') return output.trim() !== ''; if (typeof output === 'object') { const wrapped = [output.stdout, output.content, output.text, output.json, output.output, output.result, output.payload, output.data]; if (wrapped.some((v) => (typeof v === 'string' ? v.trim() !== '' : v != null))) return true; return Object.keys(output).length > 0; } return true; })(); const success = nodeOut?.success !== false; if (!hasPayload) return { status: 'missing', confidence: 'low' }; if (!Array.isArray(parsedList)) return { status: 'degraded', confidence: 'low' }; if (parsedMeta?.degraded || parsedMeta?.partial) return { status: 'degraded', confidence: parsedList.length > 0 ? 'medium' : 'low' }; if (!success) return { status: 'degraded', confidence: parsedList.length > 0 ? 'medium' : 'low' }; return { status: 'ok', confidence: parsedList.length > 0 ? 'high' : 'medium' }; }; const taskNode = $ctx.getNodeOutput('task-metrics') || {}; const prNode = $ctx.getNodeOutput('pr-metrics') || {}; const debtNode = $ctx.getNodeOutput('debt-metrics') || {}; const prevNode = $ctx.getNodeOutput('read-previous-summary') || {}; const taskParsed = parseSource(taskNode.output); const prParsed = parseSource(prNode.output); const debtParsed = parseSource(debtNode.output); const tasks = taskParsed.items; const prs = prParsed.items; const debt = debtParsed.items; const taskHealth = sourceStatus(taskNode, tasks, taskParsed); const prHealth = sourceStatus(prNode, prs, prParsed); const debtHealth = sourceStatus(debtNode, debt, debtParsed); const taskSplit = splitWindows(tasks); const prSplit = splitWindows(prs); const debtSplit = splitWindows(debt); const doneStatuses = new Set(['done', 'closed', 'completed', 'merged', 'resolved']); const isDone = (item) => doneStatuses.has(String(item?.status ?? item?.state ?? '').toLowerCase()); const taskTelemetryUnavailable = taskHealth.status === 'missing' || (taskHealth.status === 'degraded' && tasks.length === 0); const throughputCurrent = taskTelemetryUnavailable ? null : taskSplit.current.filter(isDone).length; const throughputPrevious = taskTelemetryUnavailable ? null : taskSplit.previous.filter(isDone).length; const reopenedCount = (items) => items.filter((item) => { if (!item || typeof item !== 'object') return false; const reopenCount = toNumber(item.reopenCount ?? item.reopenedCount ?? item.reopen_count ?? item.reopened_count, 0); if (reopenCount > 0) return true; if (item.reopened === true) return true; const status = String(item.status ?? item.state ?? '').toLowerCase(); return status.includes('reopen'); }).length; const reopenedCurrent = taskTelemetryUnavailable ? null : reopenedCount(taskSplit.current); const reopenedPrevious = taskTelemetryUnavailable ? null : reopenedCount(taskSplit.previous); const classifyRegression = (pr) => /revert|regression|rollback|hotfix/i.test(String(pr?.title || '') + ' ' + String(pr?.body || '')); const regressionCurrentCount = prSplit.current.filter(classifyRegression).length; const regressionPreviousCount = prSplit.previous.filter(classifyRegression).length; const regressionCurrentRate = prSplit.current.length > 0 ? Number(((regressionCurrentCount / prSplit.current.length) * 100).toFixed(2)) : null; const regressionPreviousRate = prSplit.previous.length > 0 ? Number(((regressionPreviousCount / prSplit.previous.length) * 100).toFixed(2)) : null; const mergedCount = (items) => items.filter((pr) => String(pr?.state || '').toLowerCase() === 'merged' || Boolean(pr?.mergedAt) || Boolean(pr?.merged_at) || pr?.merged === true).length; const closedCount = (items) => items.filter((pr) => { const state = String(pr?.state || '').toLowerCase(); return state === 'closed' || state === 'merged' || Boolean(pr?.closedAt) || Boolean(pr?.closed_at) || Boolean(pr?.mergedAt) || Boolean(pr?.merged_at); }).length; const mergeClosedCurrent = closedCount(prSplit.current); const mergeClosedPrevious = closedCount(prSplit.previous); const mergeSuccessCurrent = mergeClosedCurrent > 0 ? Number(((mergedCount(prSplit.current) / mergeClosedCurrent) * 100).toFixed(2)) : null; const mergeSuccessPrevious = mergeClosedPrevious > 0 ? Number(((mergedCount(prSplit.previous) / mergeClosedPrevious) * 100).toFixed(2)) : null; const debtDelta = (entries) => { let total = 0; for (const entry of entries) { if (entry == null) continue; if (typeof entry === 'number') { total += entry; continue; } if (typeof entry !== 'object') continue; if (Number.isFinite(Number(entry.debtDelta))) { total += Number(entry.debtDelta); continue; } if (Number.isFinite(Number(entry.delta))) { total += Number(entry.delta); continue; } if (Number.isFinite(Number(entry.netChange))) { total += Number(entry.netChange); continue; } const amt = Number.isFinite(Number(entry.amount)) ? Number(entry.amount) : 1; const kind = String(entry.type || entry.event || entry.action || '').toLowerCase(); if (/resolved|burn|paydown|decrease|closed/.test(kind)) total -= amt; else if (/created|added|increase|opened|new/.test(kind)) total += amt; } return Number(total.toFixed(2)); }; const debtCurrent = debtSplit.current.length > 0 ? debtDelta(debtSplit.current) : null; const debtPrevious = debtSplit.previous.length > 0 ? debtDelta(debtSplit.previous) : null; const priorRaw = prevNode?.success === true ? (parseSource(prevNode.content).items?.[0] ?? parseJsonSafe(prevNode.content)) : null; const priorParsed = priorRaw?.fitnessSummary && typeof priorRaw.fitnessSummary === 'object' ? priorRaw.fitnessSummary : (priorRaw && typeof priorRaw === 'object' ? priorRaw : null); const metricConfidence = (primaryHealth, hasValue, usedFallbackWindow) => { if (!hasValue) return 'low'; if (primaryHealth.status === 'missing') return 'low'; if (primaryHealth.status === 'degraded') return 'low'; if (usedFallbackWindow) return 'medium'; return primaryHealth.confidence || 'medium'; }; const throughputMetric = metric('throughput', throughputCurrent, throughputPrevious, 'up_is_good', 'tasks', metricConfidence(taskHealth, throughputCurrent != null, taskSplit.usedFallbackWindow), taskHealth.status, [throughputCurrent == null ? 'Task telemetry unavailable for this window.' : '', taskSplit.usedFallbackWindow ? 'No task timestamps detected; treated all records as current week.' : '']); const regressionMetric = metric('regression_rate', regressionCurrentRate, regressionPreviousRate, 'down_is_good', 'percent', metricConfidence(prHealth, regressionCurrentRate != null, prSplit.usedFallbackWindow), prHealth.status, [regressionCurrentRate == null ? 'Insufficient PR sample to compute regression rate.' : '', prSplit.usedFallbackWindow ? 'No PR timestamps detected; treated all records as current week.' : '']); const mergeMetric = metric('merge_success', mergeSuccessCurrent, mergeSuccessPrevious, 'up_is_good', 'percent', metricConfidence(prHealth, mergeSuccessCurrent != null, prSplit.usedFallbackWindow), prHealth.status, [mergeSuccessCurrent == null ? 'No closed or merged PRs in scope.' : '', prSplit.usedFallbackWindow ? 'No PR timestamps detected; treated all records as current week.' : '']); const reopenedMetric = metric('reopened_tasks', reopenedCurrent, reopenedPrevious, 'down_is_good', 'tasks', metricConfidence(taskHealth, reopenedCurrent != null, taskSplit.usedFallbackWindow), taskHealth.status, [reopenedCurrent == null ? 'Task telemetry unavailable for this window.' : '', taskSplit.usedFallbackWindow ? 'No task timestamps detected; treated all records as current week.' : '']); const debtMetric = metric('debt_growth', debtCurrent, debtPrevious, 'down_is_good', 'points', metricConfidence(debtHealth, debtCurrent != null, debtSplit.usedFallbackWindow), debtHealth.status, [debtCurrent == null ? 'No debt ledger events in scope.' : '', debtSplit.usedFallbackWindow ? 'No debt timestamps detected; treated all records as current week.' : '']); const metrics = { throughput: throughputMetric, regression_rate: regressionMetric, merge_success: mergeMetric, reopened_tasks: reopenedMetric, debt_growth: debtMetric }; const metricKeys = ['throughput', 'regression_rate', 'merge_success', 'reopened_tasks', 'debt_growth']; const trendDeltas = metricKeys.reduce((acc, key) => { const d = metrics?.[key]?.delta; acc[key] = Number.isFinite(d) ? d : null; return acc; }, {}); const normalizePriorTrendDelta = (metricName) => { const direct = priorParsed?.priorWeekTrendDeltas?.[metricName]; if (Number.isFinite(Number(direct))) return Number(Number(direct).toFixed(2)); const trend = priorParsed?.trendDeltas?.[metricName]; if (Number.isFinite(Number(trend))) return Number(Number(trend).toFixed(2)); const metricDelta = priorParsed?.metrics?.[metricName]?.delta; if (Number.isFinite(Number(metricDelta))) return Number(Number(metricDelta).toFixed(2)); return null; }; const priorWeekTrendDeltas = metricKeys.reduce((acc, key) => { acc[key] = normalizePriorTrendDelta(key); return acc; }, {}); const priorWeekDeltas = priorWeekTrendDeltas; const priorWeekMetrics = priorParsed?.metrics && typeof priorParsed.metrics === 'object' ? priorParsed.metrics : null; const alertThresholds = { throughput: 1, regression_rate: 2.5, merge_success: 2.5, reopened_tasks: 1, debt_growth: 1 }; const metricTrendAlerts = Object.entries(metrics).flatMap(([metricName, m]) => { if (m == null || m.delta == null) return []; if (String(m.confidence || '').toLowerCase() === 'low') return []; const delta = Number(m.delta); const isRegression = (m.direction === 'up_is_good' && delta < 0) || (m.direction === 'down_is_good' && delta > 0); if (!isRegression) return []; const absDelta = Math.abs(delta); const threshold = alertThresholds[metricName] ?? 1; const severity = absDelta >= threshold * 2 ? 'high' : absDelta >= threshold ? 'medium' : 'low'; return [{ metric: metricName, severity, delta, reason: `${metricName} moved in a negative direction by ${delta} ${m.unit}.` }]; }); const sourceHealth = { tasks: { ...taskHealth, count: tasks.length }, prs: { ...prHealth, count: prs.length }, debt: { ...debtHealth, count: debt.length }, }; const sourceTelemetryAlerts = Object.entries(sourceHealth).flatMap(([sourceName, health]) => { if (health?.status === 'ok') return []; const severity = health?.status === 'missing' ? 'high' : 'medium'; const reason = health?.status === 'missing' ? `${sourceName} telemetry missing; metric interpretation may be limited.` : `${sourceName} telemetry partially parsed; confidence reduced.`; return [{ metric: `telemetry:${sourceName}`, severity, delta: null, reason }]; }); const trendAlerts = [...metricTrendAlerts, ...sourceTelemetryAlerts]; const confidenceValues = Object.values(metrics).map((m) => m?.confidence || 'low'); const overallConfidence = confidenceValues.every((c) => c === 'high') ? 'high' : confidenceValues.some((c) => c === 'low') ? 'low' : 'medium'; const plannerSignals = { schemaVersion: '1.0', overallConfidence, trendAlertCount: trendAlerts.length, highSeverityAlertCount: trendAlerts.filter((a) => a?.severity === 'high').length, sourceStatus: Object.fromEntries(Object.entries(sourceHealth).map(([k, v]) => [k, v?.status || 'missing'])), metricStatus: Object.fromEntries(metricKeys.map((k) => [k, metrics?.[k]?.status || 'missing'])), metricConfidence: Object.fromEntries(metricKeys.map((k) => [k, metrics?.[k]?.confidence || 'low'])), metricValues: Object.fromEntries(metricKeys.map((k) => [k, Number.isFinite(metrics?.[k]?.value) ? Number(metrics[k].value) : null])), trendDeltas, priorWeekTrendDeltas, }; const plannerArtifact = { schemaVersion: '1.0', generatedAt: toIso(now), lookbackDays, sourceStatus: plannerSignals.sourceStatus, metricConfidence: plannerSignals.metricConfidence, metricValues: plannerSignals.metricValues, trendDeltas, priorWeekTrendDeltas, trendAlertCount: plannerSignals.trendAlertCount, highSeverityAlertCount: plannerSignals.highSeverityAlertCount, trendAlerts, }; return { schemaVersion: '1.0', generatedAt: toIso(now), lookbackDays, window: { currentStart: toIso(currentStart), currentEnd: toIso(now), previousStart: toIso(previousStart), previousEnd: toIso(previousEnd) }, sourceHealth, metrics, trendDeltas, trendAlerts, priorWeekTrendDeltas, priorWeekDeltas, priorWeekMetrics, plannerSignals, plannerArtifact, dataQuality: { overallConfidence, missingSources: Object.entries(sourceHealth).filter(([, v]) => v.status === 'missing').map(([k]) => k), degradedSources: Object.entries(sourceHealth).filter(([, v]) => v.status === 'degraded').map(([k]) => k), }, }; } catch (error) { return { schemaVersion: '1.0', generatedAt: new Date().toISOString(), lookbackDays: Number($data?.lookbackDays || 7), sourceHealth: { tasks: { status: 'missing', confidence: 'low', count: 0 }, prs: { status: 'missing', confidence: 'low', count: 0 }, debt: { status: 'missing', confidence: 'low', count: 0 }, }, metrics: { throughput: { value: null, previous: null, delta: null, confidence: 'low', status: 'missing' }, regression_rate: { value: null, previous: null, delta: null, confidence: 'low', status: 'missing' }, merge_success: { value: null, previous: null, delta: null, confidence: 'low', status: 'missing' }, reopened_tasks: { value: null, previous: null, delta: null, confidence: 'low', status: 'missing' }, debt_growth: { value: null, previous: null, delta: null, confidence: 'low', status: 'missing' }, }, trendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, trendAlerts: [{ metric: 'summary', severity: 'high', delta: null, reason: `Fitness summary fallback engaged: ${error?.message || 'unknown error'}` }], priorWeekTrendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, priorWeekDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, priorWeekMetrics: null, plannerSignals: { schemaVersion: '1.0', overallConfidence: 'low', trendAlertCount: 1, highSeverityAlertCount: 1, sourceStatus: { tasks: 'missing', prs: 'missing', debt: 'missing' }, metricStatus: { throughput: 'missing', regression_rate: 'missing', merge_success: 'missing', reopened_tasks: 'missing', debt_growth: 'missing' }, metricConfidence: { throughput: 'low', regression_rate: 'low', merge_success: 'low', reopened_tasks: 'low', debt_growth: 'low' }, metricValues: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, trendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, priorWeekTrendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, }, plannerArtifact: { schemaVersion: '1.0', generatedAt: new Date().toISOString(), lookbackDays: Number($data?.lookbackDays || 7), sourceStatus: { tasks: 'missing', prs: 'missing', debt: 'missing' }, metricConfidence: { throughput: 'low', regression_rate: 'low', merge_success: 'low', reopened_tasks: 'low', debt_growth: 'low' }, metricValues: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, trendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, priorWeekTrendDeltas: { throughput: null, regression_rate: null, merge_success: null, reopened_tasks: null, debt_growth: null }, trendAlertCount: 1, highSeverityAlertCount: 1, trendAlerts: [{ metric: 'summary', severity: 'high', delta: null, reason: `Fitness summary fallback engaged: ${error?.message || 'unknown error'}` }], }, dataQuality: { overallConfidence: 'low', missingSources: ['tasks', 'prs', 'debt'], degradedSources: [] }, }; }})()", + "isExpression": true }, "position": { - "x": 800, - "y": 1360 + "x": 420, + "y": 360 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "mark-progress-at", + "id": "serialize-fitness-summary", "type": "action.set_variable", - "label": "Update Progress Clock", + "label": "Serialize Fitness Summary", "config": { - "key": "lastProgressAt", - "value": "(() => { const changed = String($data?.currentProgressSignature || '') !== String($data?.lastProgressSignature || ''); return changed ? Date.now() : Number($data?.lastProgressAt || 0); })()", + "key": "fitnessSummaryJson", + "value": "(() => JSON.stringify($data?.fitnessSummary || {}, null, 2))()", "isExpression": true }, "position": { - "x": 680, - "y": 1490 + "x": 420, + "y": 500 }, "outputs": [ "default" ] }, { - "id": "mark-progress-sig", + "id": "render-trend-alerts", "type": "action.set_variable", - "label": "Update Progress Signature", + "label": "Render Trend Alerts", "config": { - "key": "lastProgressSignature", - "value": "$data?.currentProgressSignature || ''", + "key": "fitnessTrendAlertsText", + "value": "(() => { const alerts = Array.isArray($data?.fitnessSummary?.trendAlerts) ? $data.fitnessSummary.trendAlerts : []; if (!alerts.length) return 'No negative trend alerts this week.'; return alerts.map((a, idx) => `${idx + 1}. ${a.metric} (${a.severity}) - ${a.reason}`).join('\\n'); })()", "isExpression": true }, "position": { - "x": 680, - "y": 1600 + "x": 420, + "y": 640 }, "outputs": [ "default" ] }, { - "id": "reset-stuck-retry-count", - "type": "action.set_variable", - "label": "Reset Stuck Retry Count On Progress", + "id": "persist-fitness-summary", + "type": "action.write_file", + "label": "Persist Fitness Summary Artifact", "config": { - "key": "stuckRetryCount", - "value": "(() => { const changed = String($data?.currentProgressSignature || '') !== String($data?.lastProgressSignature || ''); return changed ? 0 : Number($data?.stuckRetryCount || 0); })()", - "isExpression": true + "path": ".bosun/workflow-runs/weekly-fitness-summary.latest.json", + "content": "{{fitnessSummaryJson}}", + "mkdir": true }, "position": { - "x": 680, - "y": 1710 + "x": 420, + "y": 780 }, "outputs": [ "default" ] }, { - "id": "stuck-check", - "type": "condition.expression", - "label": "Session Stuck?", + "id": "evaluate-fitness", + "type": "action.run_agent", + "label": "Evaluate Fitness", "config": { - "expression": "(() => { const agentOutput = $ctx.getNodeOutput('run-agent') || {}; const normalizedOutput = String(agentOutput?.output || '').replace(/\\s+/g, ' ').trim().toLowerCase(); const placeholderOutput = normalizedOutput === 'continued' || normalizedOutput === 'model response continued' || normalizedOutput === '(agent completed with no text output)'; const streamCount = Array.isArray(agentOutput?.stream) ? agentOutput.stream.length : 0; const itemCount = Number(agentOutput?.itemCount || (Array.isArray(agentOutput?.items) ? agentOutput.items.length : 0) || 0); const meaningfulAgentActivity = streamCount > 0 || itemCount > 0 || (!!normalizedOutput && !placeholderOutput); const noProgressChange = String($data?.currentProgressSignature || '') === String($data?.lastProgressSignature || ''); if (noProgressChange && !meaningfulAgentActivity) return true; if (placeholderOutput && noProgressChange) return true; const lastProgressAt = Number($data?.lastProgressAt || 0); const stuckThresholdMs = Number($data?.stuckThresholdMs || 0); if (stuckThresholdMs <= 0) return noProgressChange; if (lastProgressAt <= 0) return false; return noProgressChange && (Date.now() - lastProgressAt) >= stuckThresholdMs; })()" + "prompt": "# Weekly Delivery Fitness Evaluation\n\nEvaluate the last {{lookbackDays}} days using this machine-readable summary:\n\nMetrics to evaluate:\n- Throughput\n- Regression rate\n- Merge success\n- Reopened tasks\n- Debt growth\n\n## Weekly Fitness JSON\n{{fitnessSummaryJson}}\n\n## Negative Trend Alerts\n{{fitnessTrendAlertsText}}\n\nFocus directive: {{evaluatorFocus}}\n\nRequirements:\n- Respect confidence and status on each metric.\n- If a metric has low confidence or missing telemetry, call that out explicitly and avoid overconfident recommendations.\n- Use prior-week deltas when available.\n- If one telemetry source is unavailable, still provide a stable scorecard and best-effort recommendations.\n\nReturn sections:\n1) Scorecard (0-100) with one line per metric and confidence\n2) Root-cause analysis of the largest drag\n3) Countermeasures ranked by impact/cost\n4) FOLLOW_UP_ACTION lines using format:\nFOLLOW_UP_ACTION: [title] | [description] | [repo_area] | [risk] | [effort]\n\nOnly include FOLLOW_UP_ACTION lines for changes that are worth implementing this week.", + "sdk": "auto", + "timeoutMs": 600000 }, "position": { - "x": 980, - "y": 1820 + "x": 420, + "y": 930 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "emit-stuck", - "type": "action.emit_event", - "label": "Emit session-stuck", + "id": "has-followups", + "type": "condition.expression", + "label": "Follow-ups Enabled + Present", "config": { - "eventType": "session-stuck", - "payload": { - "taskId": "{{taskId}}", - "turn": "{{continuationTurn}}", - "externalStatus": "{{currentExternalStatus}}", - "stuckThresholdMs": "{{stuckThresholdMs}}", - "stuckForMs": "{{stuckForMs}}", - "onStuck": "{{onStuck}}", - "stuckRetryCount": "{{stuckRetryCount}}", - "maxStuckAutoRetries": "{{maxStuckAutoRetries}}", - "lastProgressAt": "{{lastProgressAt}}", - "lastProgressSignature": "{{lastProgressSignature}}", - "currentProgressSignature": "{{currentProgressSignature}}", - "placeholderResponse": "{{(() => { const normalizedOutput = String($ctx.getNodeOutput('run-agent')?.output || '').replace(/\\s+/g, ' ').trim().toLowerCase(); return normalizedOutput === 'continued' || normalizedOutput === 'model response continued'; })()}}", - "agentActivityDetected": "{{(() => { const agentOutput = $ctx.getNodeOutput('run-agent') || {}; const normalizedOutput = String(agentOutput?.output || '').replace(/\\s+/g, ' ').trim().toLowerCase(); const placeholderOutput = normalizedOutput === 'continued' || normalizedOutput === 'model response continued' || normalizedOutput === '(agent completed with no text output)'; const streamCount = Array.isArray(agentOutput?.stream) ? agentOutput.stream.length : 0; const itemCount = Number(agentOutput?.itemCount || (Array.isArray(agentOutput?.items) ? agentOutput.items.length : 0) || 0); return streamCount > 0 || itemCount > 0 || (!!normalizedOutput && !placeholderOutput); })()}}", - "agentItemCount": "{{$ctx.getNodeOutput('run-agent')?.itemCount || (Array.isArray($ctx.getNodeOutput('run-agent')?.items) ? $ctx.getNodeOutput('run-agent')?.items.length : 0) || 0}}", - "agentStreamCount": "{{Array.isArray($ctx.getNodeOutput('run-agent')?.stream) ? $ctx.getNodeOutput('run-agent')?.stream.length : 0}}", - "progressSnapshot": "{{$ctx.getNodeOutput('capture-progress')?.output || ''}}", - "lastAgentSuccess": "{{$ctx.getNodeOutput('run-agent')?.success === true}}", - "lastAgentOutput": "{{$ctx.getNodeOutput('run-agent')?.output || ''}}" - }, - "outputVariable": "sessionStuckEvent" + "expression": "($data?.createFollowupTasks === true) && (($ctx.getNodeOutput('evaluate-fitness')?.output || '').includes('FOLLOW_UP_ACTION:'))" }, "position": { - "x": 980, - "y": 1600 + "x": 420, + "y": 1090 }, "outputs": [ "default" ] }, { - "id": "stuck-route", - "type": "condition.switch", - "label": "Route onStuck Action", + "id": "build-followup-json", + "type": "action.run_agent", + "label": "Build Follow-up Tasks JSON", "config": { - "value": "$data?.onStuck || 'escalate'", - "cases": { - "retry": "retry", - "escalate": "escalate", - "pause": "pause" - } + "prompt": "Convert FOLLOW_UP_ACTION lines below into a single JSON object with shape { \"tasks\": [...] }.\n\nSource:\n{{evaluate-fitness.output}}\n\nStructured context:\n{{fitnessSummaryJson}}\n\nRules:\n- Generate at most {{maxFollowupTasks}} tasks\n- Include fields: title, description, implementation_steps, acceptance_criteria, verification, priority, tags, base_branch, impact, confidence, risk, estimated_effort, repo_areas, why_now, kill_criteria\n- Use trend deltas from the summary artifact to justify urgency and avoid parse errors\n- Keep tasks implementation-ready and avoid duplicates\n- Return only JSON", + "sdk": "auto", + "timeoutMs": 300000 }, "position": { - "x": 980, - "y": 1710 + "x": 220, + "y": 1260 }, "outputs": [ - "retry", - "escalate", - "pause", "default" ] }, { - "id": "stuck-retry-budget", - "type": "condition.expression", - "label": "Stuck Retry Budget Remaining?", + "id": "materialize-followups", + "type": "action.materialize_planner_tasks", + "label": "Materialize Follow-up Tasks", "config": { - "expression": "Number($data?.stuckRetryCount || 0) < Number($data?.maxStuckAutoRetries || 0)" + "plannerNodeId": "build-followup-json", + "maxTasks": "{{maxFollowupTasks}}", + "status": "todo", + "dedup": true, + "failOnZero": false, + "minCreated": 0 }, "position": { - "x": 760, - "y": 1820 + "x": 220, + "y": 1420 }, "outputs": [ - "yes", - "no" + "default" ] }, { - "id": "stuck-retry", - "type": "action.run_agent", - "label": "Retry After Stuck", + "id": "notify-summary", + "type": "notify.telegram", + "label": "Send Weekly Fitness Summary", "config": { - "prompt": "{{retryPrompt}}\n\nStuck context:\n- taskId: {{taskId}}\n- externalStatus: {{currentExternalStatus}}\n- turn: {{continuationTurn}}\n- stuckRetryCount: {{stuckRetryCount}}/{{maxStuckAutoRetries}}\n- stuckForMs: {{Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))}}\n- lastProgressSignature: {{lastProgressSignature}}\n- currentProgressSignature: {{currentProgressSignature}}\n- progressSnapshot: {{$ctx.getNodeOutput('capture-progress')?.output || ''}}\n- lastAgentOutput: {{$ctx.getNodeOutput('run-agent')?.output || ''}}\n\nTry a materially different approach. If you cannot create progress, explain the specific blocker.", - "taskId": "{{taskId}}", - "cwd": "{{worktreePath}}", - "sdk": "{{sdk}}", - "model": "{{model}}", - "timeoutMs": "{{timeoutMs}}", - "requireTaskPromptCompleteness": false, - "failOnError": false + "message": ":chart: Weekly fitness evaluation complete. Follow-up tasks created: {{materialize-followups.createdCount}}\\n\\nTrend alerts:\\n{{fitnessTrendAlertsText}}\\n\\n{{evaluate-fitness.output}}", + "silent": true }, "position": { - "x": 760, - "y": 1830 + "x": 420, + "y": 1580 }, "outputs": [ "default" ] }, { - "id": "increment-stuck-retry-count", - "type": "action.set_variable", - "label": "Increment Stuck Retry Count", + "id": "log-no-followups", + "type": "notify.log", + "label": "No Follow-up Tasks", "config": { - "key": "stuckRetryCount", - "value": "Number($data?.stuckRetryCount || 0) + 1", - "isExpression": true + "message": "Weekly fitness evaluation completed with no follow-up task creation.", + "level": "info" }, "position": { - "x": 760, - "y": 1940 + "x": 620, + "y": 1260 }, "outputs": [ "default" ] + } + ], + "edges": [ + { + "id": "trigger->task-metrics", + "source": "trigger", + "target": "task-metrics", + "sourcePort": "default" + }, + { + "id": "trigger->pr-metrics", + "source": "trigger", + "target": "pr-metrics", + "sourcePort": "default" + }, + { + "id": "trigger->debt-metrics", + "source": "trigger", + "target": "debt-metrics", + "sourcePort": "default" + }, + { + "id": "trigger->read-previous-summary", + "source": "trigger", + "target": "read-previous-summary", + "sourcePort": "default" + }, + { + "id": "task-metrics->summarize-fitness-metrics", + "source": "task-metrics", + "target": "summarize-fitness-metrics", + "sourcePort": "default" + }, + { + "id": "pr-metrics->summarize-fitness-metrics", + "source": "pr-metrics", + "target": "summarize-fitness-metrics", + "sourcePort": "default" + }, + { + "id": "debt-metrics->summarize-fitness-metrics", + "source": "debt-metrics", + "target": "summarize-fitness-metrics", + "sourcePort": "default" + }, + { + "id": "read-previous-summary->summarize-fitness-metrics", + "source": "read-previous-summary", + "target": "summarize-fitness-metrics", + "sourcePort": "default" + }, + { + "id": "summarize-fitness-metrics->serialize-fitness-summary", + "source": "summarize-fitness-metrics", + "target": "serialize-fitness-summary", + "sourcePort": "default" + }, + { + "id": "serialize-fitness-summary->render-trend-alerts", + "source": "serialize-fitness-summary", + "target": "render-trend-alerts", + "sourcePort": "default" + }, + { + "id": "render-trend-alerts->persist-fitness-summary", + "source": "render-trend-alerts", + "target": "persist-fitness-summary", + "sourcePort": "default" + }, + { + "id": "persist-fitness-summary->evaluate-fitness", + "source": "persist-fitness-summary", + "target": "evaluate-fitness", + "sourcePort": "default" + }, + { + "id": "evaluate-fitness->has-followups", + "source": "evaluate-fitness", + "target": "has-followups", + "sourcePort": "default" + }, + { + "id": "has-followups->build-followup-json", + "source": "has-followups", + "target": "build-followup-json", + "sourcePort": "default", + "condition": "$output?.result === true" + }, + { + "id": "has-followups->log-no-followups", + "source": "has-followups", + "target": "log-no-followups", + "sourcePort": "default", + "condition": "$output?.result !== true" }, { - "id": "stuck-escalate", - "type": "notify.log", - "label": "Escalate Stuck Session", + "id": "build-followup-json->materialize-followups", + "source": "build-followup-json", + "target": "materialize-followups", + "sourcePort": "default" + }, + { + "id": "materialize-followups->notify-summary", + "source": "materialize-followups", + "target": "notify-summary", + "sourcePort": "default" + }, + { + "id": "log-no-followups->notify-summary", + "source": "log-no-followups", + "target": "notify-summary", + "sourcePort": "default" + } + ], + "metadata": { + "author": "bosun-demo", + "createdAt": "2026-03-24T12:00:00.000Z", + "updatedAt": "2026-03-24T12:00:00.000Z", + "templateState": { + "templateId": "template-weekly-fitness-summary", + "templateName": "Weekly Fitness Summary", + "templateVersion": "1.0.0", + "installedTemplateVersion": "1.0.0", + "isCustomized": false, + "updateAvailable": false + } + } + }, + { + "id": "wf-anomaly-watchdog", + "name": "Anomaly Watchdog", + "description": "Real-time anomaly detection for agent sessions — catches death loops, stalls, token overflows, rebase spirals, and thought spinning. Automatically intervenes or escalates depending on severity.", + "category": "reliability", + "enabled": true, + "nodeCount": 9, + "trigger": "trigger.event", + "variables": { + "stallThresholdMs": 300000, + "maxTokenUsage": 0.9, + "maxConsecutiveErrors": 5 + }, + "nodes": [ + { + "id": "trigger", + "type": "trigger.event", + "label": "Agent Anomaly Detected", "config": { - "level": "warn", - "message": "session-stuck: escalation requested for task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}}, stuckForMs={{stuckForMs}}, stuckRetryCount={{stuckRetryCount}}/{{maxStuckAutoRetries}}, lastProgressSignature={{lastProgressSignature}}, currentProgressSignature={{currentProgressSignature}})" + "eventType": "agent.anomaly", + "filter": "$event?.severity === 'high' || $event?.severity === 'critical'" }, "position": { - "x": 980, - "y": 1830 + "x": 400, + "y": 50 }, "outputs": [ "default" ] }, { - "id": "stuck-escalate-budget", - "type": "notify.log", - "label": "Escalate Stuck Session (Retry Limit)", + "id": "classify", + "type": "condition.switch", + "label": "Classify Anomaly", "config": { - "level": "warn", - "message": "session-stuck: retry budget exhausted for task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}}, stuckForMs={{stuckForMs}}, stuckRetryCount={{stuckRetryCount}}/{{maxStuckAutoRetries}}, lastProgressSignature={{lastProgressSignature}}, currentProgressSignature={{currentProgressSignature}})" + "value": "$data?.anomalyType || 'unknown'", + "cases": { + "DEATH_LOOP": "death-loop", + "STALL": "stall", + "TOKEN_OVERFLOW": "token-overflow", + "REBASE_SPIRAL": "rebase-spiral", + "THOUGHT_SPIN": "thought-spin" + } }, "position": { - "x": 760, - "y": 2050 + "x": 400, + "y": 200 }, "outputs": [ + "death-loop", + "stall", + "token-overflow", + "rebase-spiral", + "thought-spin", "default" ] }, { - "id": "stuck-pause", - "type": "notify.log", - "label": "Pause Stuck Session", + "id": "kill-and-restart", + "type": "action.restart_agent", + "label": "Kill & Restart Agent", "config": { - "level": "warn", - "message": "session-stuck: paused task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}})" + "sessionId": "{{sessionId}}", + "reason": "Death loop detected — agent cycling through the same error pattern", + "prompt": "The previous session entered a death loop. Start fresh with a different approach.\n\nOriginal task: {{taskTitle}}" }, "position": { - "x": 1200, - "y": 1830 + "x": 100, + "y": 380 }, "outputs": [ "default" ] }, { - "id": "end-escalated", - "type": "flow.end", - "label": "End: Escalated", + "id": "nudge-stall", + "type": "action.continue_session", + "label": "Nudge Stalled Agent", "config": { - "status": "failed", - "message": "Continuation loop escalated due to session-stuck for task {{taskId}}.", - "output": { - "reason": "stuck_escalated", - "taskId": "{{taskId}}", - "event": "{{sessionStuckEvent.eventType}}", - "stuckRetryCount": "{{stuckRetryCount}}", - "maxStuckAutoRetries": "{{maxStuckAutoRetries}}" - } + "sessionId": "{{sessionId}}", + "prompt": "You appear to be stalled. Please continue working on the current task. If you are stuck, describe the blocker and try a different approach.", + "strategy": "continue" }, "position": { - "x": 980, - "y": 1950 + "x": 300, + "y": 380 }, "outputs": [ "default" ] }, { - "id": "end-paused", - "type": "flow.end", - "label": "End: Paused", + "id": "trim-context", + "type": "action.continue_session", + "label": "Trim Context & Continue", "config": { - "status": "completed", - "message": "Continuation loop paused due to session-stuck for task {{taskId}}.", - "output": { - "reason": "stuck_paused", - "taskId": "{{taskId}}", - "event": "{{sessionStuckEvent.eventType}}" - } + "sessionId": "{{sessionId}}", + "prompt": "Your context window is nearly full. Summarize your progress so far in 2-3 sentences, then continue with the most critical remaining work.", + "strategy": "refine" }, "position": { - "x": 1200, - "y": 1950 + "x": 500, + "y": 380 }, "outputs": [ "default" ] }, { - "id": "wait-next-turn", - "type": "action.delay", - "label": "Wait Poll Interval", + "id": "fix-rebase", + "type": "action.run_command", + "label": "Fix Stuck Rebase", "config": { - "ms": "{{pollIntervalMs}}", - "reason": "Waiting before next external status poll" + "command": "git rebase --abort 2>/dev/null; git reset --hard HEAD; git checkout -B {{branch}} origin/{{branch}} 2>/dev/null || true", + "cwd": "{{worktreePath}}" }, "position": { - "x": 760, - "y": 1950 + "x": 700, + "y": 380 }, "outputs": [ "default" ] }, { - "id": "increment-turn", - "type": "action.set_variable", - "label": "Increment Turn", + "id": "break-spin", + "type": "action.continue_session", + "label": "Break Thought Spin", "config": { - "key": "continuationTurn", - "value": "Number($data?.continuationTurn || 0) + 1", - "isExpression": true + "sessionId": "{{sessionId}}", + "prompt": "Stop your current analysis. You are repeating the same reasoning. Take a concrete action NOW:\n1. Make a specific code change, OR\n2. Run a specific command, OR\n3. Report that you are blocked and need help.\nDo NOT continue analyzing.", + "strategy": "continue" }, "position": { - "x": 760, - "y": 2060 + "x": 900, + "y": 380 }, "outputs": [ "default" ] }, { - "id": "wait-next-turn-no-stuck", - "type": "action.delay", - "label": "Wait (No Stuck)", + "id": "log-intervention", + "type": "notify.log", + "label": "Log Intervention", "config": { - "ms": "{{pollIntervalMs}}", - "reason": "Waiting before next external status poll" + "message": "Anomaly watchdog intervened: {{anomalyType}} for session {{sessionId}}", + "level": "warn" }, "position": { - "x": 1080, - "y": 1950 + "x": 400, + "y": 550 }, "outputs": [ "default" ] }, { - "id": "increment-turn-no-stuck", - "type": "action.set_variable", - "label": "Increment Turn (No Stuck)", + "id": "alert-telegram", + "type": "notify.telegram", + "label": "Alert Human", "config": { - "key": "continuationTurn", - "value": "Number($data?.continuationTurn || 0) + 1", - "isExpression": true + "message": ":alert: Agent anomaly detected: **{{anomalyType}}**\nSession: {{sessionId}}\nTask: {{taskTitle}}\nIntervention: auto-applied\nThresholds: stall={{stallThresholdMs}}ms token={{maxTokenUsage}} maxErrors={{maxConsecutiveErrors}}" }, "position": { - "x": 1080, - "y": 2060 + "x": 400, + "y": 700 }, "outputs": [ "default" @@ -34940,249 +28365,87 @@ ], "edges": [ { - "id": "trigger->init-turn", + "id": "trigger->classify", "source": "trigger", - "target": "init-turn", - "sourcePort": "default" - }, - { - "id": "init-turn->init-progress-at", - "source": "init-turn", - "target": "init-progress-at", - "sourcePort": "default" - }, - { - "id": "init-progress-at->init-signature", - "source": "init-progress-at", - "target": "init-signature", - "sourcePort": "default" - }, - { - "id": "init-signature->init-stuck-retry-count", - "source": "init-signature", - "target": "init-stuck-retry-count", - "sourcePort": "default" - }, - { - "id": "init-stuck-retry-count->poll-task", - "source": "init-stuck-retry-count", - "target": "poll-task", - "sourcePort": "default" - }, - { - "id": "poll-task->derive-status", - "source": "poll-task", - "target": "derive-status", - "sourcePort": "default" - }, - { - "id": "derive-status->terminal-check", - "source": "derive-status", - "target": "terminal-check", - "sourcePort": "default" - }, - { - "id": "terminal-check->end-terminal", - "source": "terminal-check", - "target": "end-terminal", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "terminal-check->max-turns-check", - "source": "terminal-check", - "target": "max-turns-check", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "max-turns-check->end-max-turns", - "source": "max-turns-check", - "target": "end-max-turns", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "max-turns-check->run-agent", - "source": "max-turns-check", - "target": "run-agent", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "run-agent->capture-progress", - "source": "run-agent", - "target": "capture-progress", - "sourcePort": "default" - }, - { - "id": "capture-progress->derive-signature", - "source": "capture-progress", - "target": "derive-signature", - "sourcePort": "default" - }, - { - "id": "derive-signature->derive-stuck-ms", - "source": "derive-signature", - "target": "derive-stuck-ms", - "sourcePort": "default" - }, - { - "id": "derive-stuck-ms->progress-changed", - "source": "derive-stuck-ms", - "target": "progress-changed", - "sourcePort": "default" - }, - { - "id": "progress-changed->mark-progress-at", - "source": "progress-changed", - "target": "mark-progress-at", - "sourcePort": "default" - }, - { - "id": "mark-progress-at->mark-progress-sig", - "source": "mark-progress-at", - "target": "mark-progress-sig", - "sourcePort": "default" - }, - { - "id": "mark-progress-sig->reset-stuck-retry-count", - "source": "mark-progress-sig", - "target": "reset-stuck-retry-count", - "sourcePort": "default" - }, - { - "id": "reset-stuck-retry-count->stuck-check", - "source": "reset-stuck-retry-count", - "target": "stuck-check", - "sourcePort": "default" - }, - { - "id": "stuck-check->emit-stuck", - "source": "stuck-check", - "target": "emit-stuck", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "stuck-check->wait-next-turn-no-stuck", - "source": "stuck-check", - "target": "wait-next-turn-no-stuck", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "emit-stuck->stuck-route", - "source": "emit-stuck", - "target": "stuck-route", + "target": "classify", "sourcePort": "default" }, { - "id": "stuck-route->stuck-retry-budget", - "source": "stuck-route", - "target": "stuck-retry-budget", - "sourcePort": "retry" - }, - { - "id": "stuck-route->stuck-escalate", - "source": "stuck-route", - "target": "stuck-escalate", - "sourcePort": "escalate" - }, - { - "id": "stuck-route->stuck-pause", - "source": "stuck-route", - "target": "stuck-pause", - "sourcePort": "pause" + "id": "classify->kill-and-restart", + "source": "classify", + "target": "kill-and-restart", + "sourcePort": "death-loop" }, { - "id": "stuck-route->stuck-escalate", - "source": "stuck-route", - "target": "stuck-escalate", - "sourcePort": "default" + "id": "classify->nudge-stall", + "source": "classify", + "target": "nudge-stall", + "sourcePort": "stall" }, { - "id": "stuck-retry-budget->stuck-retry", - "source": "stuck-retry-budget", - "target": "stuck-retry", - "sourcePort": "yes", - "condition": "$output?.result === true" + "id": "classify->trim-context", + "source": "classify", + "target": "trim-context", + "sourcePort": "token-overflow" }, { - "id": "stuck-retry-budget->stuck-escalate-budget", - "source": "stuck-retry-budget", - "target": "stuck-escalate-budget", - "sourcePort": "no", - "condition": "$output?.result !== true" + "id": "classify->fix-rebase", + "source": "classify", + "target": "fix-rebase", + "sourcePort": "rebase-spiral" }, { - "id": "stuck-retry->increment-stuck-retry-count", - "source": "stuck-retry", - "target": "increment-stuck-retry-count", - "sourcePort": "default" + "id": "classify->break-spin", + "source": "classify", + "target": "break-spin", + "sourcePort": "thought-spin" }, { - "id": "increment-stuck-retry-count->wait-next-turn", - "source": "increment-stuck-retry-count", - "target": "wait-next-turn", + "id": "kill-and-restart->log-intervention", + "source": "kill-and-restart", + "target": "log-intervention", "sourcePort": "default" }, { - "id": "stuck-escalate->end-escalated", - "source": "stuck-escalate", - "target": "end-escalated", + "id": "nudge-stall->log-intervention", + "source": "nudge-stall", + "target": "log-intervention", "sourcePort": "default" }, { - "id": "stuck-escalate-budget->end-escalated", - "source": "stuck-escalate-budget", - "target": "end-escalated", + "id": "trim-context->log-intervention", + "source": "trim-context", + "target": "log-intervention", "sourcePort": "default" }, { - "id": "stuck-pause->end-paused", - "source": "stuck-pause", - "target": "end-paused", + "id": "fix-rebase->log-intervention", + "source": "fix-rebase", + "target": "log-intervention", "sourcePort": "default" }, { - "id": "wait-next-turn->increment-turn", - "source": "wait-next-turn", - "target": "increment-turn", + "id": "break-spin->log-intervention", + "source": "break-spin", + "target": "log-intervention", "sourcePort": "default" }, { - "id": "wait-next-turn-no-stuck->increment-turn-no-stuck", - "source": "wait-next-turn-no-stuck", - "target": "increment-turn-no-stuck", + "id": "log-intervention->alert-telegram", + "source": "log-intervention", + "target": "alert-telegram", "sourcePort": "default" - }, - { - "id": "increment-turn->poll-task", - "source": "increment-turn", - "target": "poll-task", - "sourcePort": "default", - "backEdge": true, - "maxIterations": 500 - }, - { - "id": "increment-turn-no-stuck->poll-task", - "source": "increment-turn-no-stuck", - "target": "poll-task", - "sourcePort": "default", - "backEdge": true, - "maxIterations": 500 } ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-28T12:00:00.000Z", - "updatedAt": "2026-03-28T12:00:00.000Z", + "createdAt": "2026-03-25T12:00:00.000Z", + "updatedAt": "2026-03-25T12:00:00.000Z", "templateState": { - "templateId": "template-continuation-loop", - "templateName": "Continuation Loop", - "templateVersion": "1.3.0", - "installedTemplateVersion": "1.3.0", + "templateId": "template-anomaly-watchdog", + "templateName": "Anomaly Watchdog", + "templateVersion": "1.0.1", + "installedTemplateVersion": "1.0.1", "isCustomized": false, "updateAvailable": false } @@ -35191,13 +28454,12 @@ { "id": "wf-continuation-loop", "name": "Continuation Loop", - "description": "Issue-state continuation loop. Fires automatically for any available task (trigger.task_available), drives the agent until a terminal state or max turns, and handles stuck sessions with retry/escalate/pause. taskId and worktreePath are auto-populated from the picked task — no manual input required.", + "description": "Issue-state continuation loop. Polls externalStatus, keeps driving the agent until terminal state or max turns, and handles stuck sessions with retry/escalate/pause.", "category": "reliability", "enabled": true, - "nodeCount": 34, - "trigger": "trigger.task_available", + "nodeCount": 33, + "trigger": "trigger.manual", "variables": { - "maxParallel": 1, "taskId": "", "worktreePath": "", "maxTurns": 8, @@ -35218,18 +28480,9 @@ "nodes": [ { "id": "trigger", - "type": "trigger.task_available", - "label": "Pick Available Task", - "config": { - "maxParallel": "{{maxParallel}}", - "status": "inprogress", - "statuses": [ - "inprogress", - "todo" - ], - "filterCodexScoped": true, - "filterDrafts": true - }, + "type": "trigger.manual", + "label": "Start Continuation Loop", + "config": {}, "position": { "x": 420, "y": 60 @@ -35427,7 +28680,6 @@ "sdk": "{{sdk}}", "model": "{{model}}", "timeoutMs": "{{timeoutMs}}", - "requireTaskPromptCompleteness": false, "failOnError": false }, "position": { @@ -35472,23 +28724,6 @@ "default" ] }, - { - "id": "derive-stuck-ms", - "type": "action.set_variable", - "label": "Derive Stuck Duration", - "config": { - "key": "stuckForMs", - "value": "Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))", - "isExpression": true - }, - "position": { - "x": 1080, - "y": 1230 - }, - "outputs": [ - "default" - ] - }, { "id": "progress-changed", "type": "condition.expression", @@ -35561,7 +28796,7 @@ "type": "condition.expression", "label": "Session Stuck?", "config": { - "expression": "(() => { const agentOutput = $ctx.getNodeOutput('run-agent') || {}; const normalizedOutput = String(agentOutput?.output || '').replace(/\\s+/g, ' ').trim().toLowerCase(); const placeholderOutput = normalizedOutput === 'continued' || normalizedOutput === 'model response continued' || normalizedOutput === '(agent completed with no text output)'; const streamCount = Array.isArray(agentOutput?.stream) ? agentOutput.stream.length : 0; const itemCount = Number(agentOutput?.itemCount || (Array.isArray(agentOutput?.items) ? agentOutput.items.length : 0) || 0); const meaningfulAgentActivity = streamCount > 0 || itemCount > 0 || (!!normalizedOutput && !placeholderOutput); const noProgressChange = String($data?.currentProgressSignature || '') === String($data?.lastProgressSignature || ''); if (noProgressChange && !meaningfulAgentActivity) return true; if (placeholderOutput && noProgressChange) return true; const lastProgressAt = Number($data?.lastProgressAt || 0); const stuckThresholdMs = Number($data?.stuckThresholdMs || 0); if (stuckThresholdMs <= 0) return noProgressChange; if (lastProgressAt <= 0) return false; return noProgressChange && (Date.now() - lastProgressAt) >= stuckThresholdMs; })()" + "expression": "(Date.now() - Number($data?.lastProgressAt || 0)) >= Number($data?.stuckThresholdMs || 0)" }, "position": { "x": 980, @@ -35583,17 +28818,13 @@ "turn": "{{continuationTurn}}", "externalStatus": "{{currentExternalStatus}}", "stuckThresholdMs": "{{stuckThresholdMs}}", - "stuckForMs": "{{stuckForMs}}", + "stuckForMs": "{{Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))}}", "onStuck": "{{onStuck}}", "stuckRetryCount": "{{stuckRetryCount}}", "maxStuckAutoRetries": "{{maxStuckAutoRetries}}", "lastProgressAt": "{{lastProgressAt}}", "lastProgressSignature": "{{lastProgressSignature}}", "currentProgressSignature": "{{currentProgressSignature}}", - "placeholderResponse": "{{(() => { const normalizedOutput = String($ctx.getNodeOutput('run-agent')?.output || '').replace(/\\s+/g, ' ').trim().toLowerCase(); return normalizedOutput === 'continued' || normalizedOutput === 'model response continued'; })()}}", - "agentActivityDetected": "{{(() => { const agentOutput = $ctx.getNodeOutput('run-agent') || {}; const normalizedOutput = String(agentOutput?.output || '').replace(/\\s+/g, ' ').trim().toLowerCase(); const placeholderOutput = normalizedOutput === 'continued' || normalizedOutput === 'model response continued' || normalizedOutput === '(agent completed with no text output)'; const streamCount = Array.isArray(agentOutput?.stream) ? agentOutput.stream.length : 0; const itemCount = Number(agentOutput?.itemCount || (Array.isArray(agentOutput?.items) ? agentOutput.items.length : 0) || 0); return streamCount > 0 || itemCount > 0 || (!!normalizedOutput && !placeholderOutput); })()}}", - "agentItemCount": "{{$ctx.getNodeOutput('run-agent')?.itemCount || (Array.isArray($ctx.getNodeOutput('run-agent')?.items) ? $ctx.getNodeOutput('run-agent')?.items.length : 0) || 0}}", - "agentStreamCount": "{{Array.isArray($ctx.getNodeOutput('run-agent')?.stream) ? $ctx.getNodeOutput('run-agent')?.stream.length : 0}}", "progressSnapshot": "{{$ctx.getNodeOutput('capture-progress')?.output || ''}}", "lastAgentSuccess": "{{$ctx.getNodeOutput('run-agent')?.success === true}}", "lastAgentOutput": "{{$ctx.getNodeOutput('run-agent')?.output || ''}}" @@ -35658,7 +28889,6 @@ "sdk": "{{sdk}}", "model": "{{model}}", "timeoutMs": "{{timeoutMs}}", - "requireTaskPromptCompleteness": false, "failOnError": false }, "position": { @@ -35692,7 +28922,7 @@ "label": "Escalate Stuck Session", "config": { "level": "warn", - "message": "session-stuck: escalation requested for task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}}, stuckForMs={{stuckForMs}}, stuckRetryCount={{stuckRetryCount}}/{{maxStuckAutoRetries}}, lastProgressSignature={{lastProgressSignature}}, currentProgressSignature={{currentProgressSignature}})" + "message": "session-stuck: escalation requested for task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}}, stuckForMs={{Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))}}, stuckRetryCount={{stuckRetryCount}}/{{maxStuckAutoRetries}}, lastProgressSignature={{lastProgressSignature}}, currentProgressSignature={{currentProgressSignature}})" }, "position": { "x": 980, @@ -35708,7 +28938,7 @@ "label": "Escalate Stuck Session (Retry Limit)", "config": { "level": "warn", - "message": "session-stuck: retry budget exhausted for task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}}, stuckForMs={{stuckForMs}}, stuckRetryCount={{stuckRetryCount}}/{{maxStuckAutoRetries}}, lastProgressSignature={{lastProgressSignature}}, currentProgressSignature={{currentProgressSignature}})" + "message": "session-stuck: retry budget exhausted for task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}}, stuckForMs={{Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))}}, stuckRetryCount={{stuckRetryCount}}/{{maxStuckAutoRetries}}, lastProgressSignature={{lastProgressSignature}}, currentProgressSignature={{currentProgressSignature}})" }, "position": { "x": 760, @@ -35929,14 +29159,8 @@ "sourcePort": "default" }, { - "id": "derive-signature->derive-stuck-ms", + "id": "derive-signature->progress-changed", "source": "derive-signature", - "target": "derive-stuck-ms", - "sourcePort": "default" - }, - { - "id": "derive-stuck-ms->progress-changed", - "source": "derive-stuck-ms", "target": "progress-changed", "sourcePort": "default" }, @@ -36083,25 +29307,25 @@ ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-28T12:00:00.000Z", - "updatedAt": "2026-03-28T12:00:00.000Z", + "createdAt": "2026-03-26T12:00:00.000Z", + "updatedAt": "2026-03-26T12:00:00.000Z", "templateState": { "templateId": "template-continuation-loop", "templateName": "Continuation Loop", - "templateVersion": "1.3.0", - "installedTemplateVersion": "1.3.0", + "templateVersion": "1.1.0", + "installedTemplateVersion": "1.1.0", "isCustomized": false, "updateAvailable": false } } }, { - "id": "wf-continuation-loop-manual", - "name": "Continuation Loop (Manual)", - "description": "Issue-state continuation loop for a specific task. Provide taskId and worktreePath at install time. Drives the agent until a terminal state or max turns, and handles stuck sessions with retry/escalate/pause.", + "id": "wf-continuation-loop", + "name": "Continuation Loop", + "description": "Issue-state continuation loop. Polls externalStatus, keeps driving the agent until terminal state or max turns, and handles stuck sessions with retry/escalate/pause.", "category": "reliability", "enabled": true, - "nodeCount": 34, + "nodeCount": 33, "trigger": "trigger.manual", "variables": { "taskId": "", @@ -36324,7 +29548,6 @@ "sdk": "{{sdk}}", "model": "{{model}}", "timeoutMs": "{{timeoutMs}}", - "requireTaskPromptCompleteness": false, "failOnError": false }, "position": { @@ -36369,23 +29592,6 @@ "default" ] }, - { - "id": "derive-stuck-ms", - "type": "action.set_variable", - "label": "Derive Stuck Duration", - "config": { - "key": "stuckForMs", - "value": "Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))", - "isExpression": true - }, - "position": { - "x": 1080, - "y": 1230 - }, - "outputs": [ - "default" - ] - }, { "id": "progress-changed", "type": "condition.expression", @@ -36458,7 +29664,7 @@ "type": "condition.expression", "label": "Session Stuck?", "config": { - "expression": "(() => { const agentOutput = $ctx.getNodeOutput('run-agent') || {}; const normalizedOutput = String(agentOutput?.output || '').replace(/\\s+/g, ' ').trim().toLowerCase(); const placeholderOutput = normalizedOutput === 'continued' || normalizedOutput === 'model response continued' || normalizedOutput === '(agent completed with no text output)'; const streamCount = Array.isArray(agentOutput?.stream) ? agentOutput.stream.length : 0; const itemCount = Number(agentOutput?.itemCount || (Array.isArray(agentOutput?.items) ? agentOutput.items.length : 0) || 0); const meaningfulAgentActivity = streamCount > 0 || itemCount > 0 || (!!normalizedOutput && !placeholderOutput); const noProgressChange = String($data?.currentProgressSignature || '') === String($data?.lastProgressSignature || ''); if (noProgressChange && !meaningfulAgentActivity) return true; if (placeholderOutput && noProgressChange) return true; const lastProgressAt = Number($data?.lastProgressAt || 0); const stuckThresholdMs = Number($data?.stuckThresholdMs || 0); if (stuckThresholdMs <= 0) return noProgressChange; if (lastProgressAt <= 0) return false; return noProgressChange && (Date.now() - lastProgressAt) >= stuckThresholdMs; })()" + "expression": "(Date.now() - Number($data?.lastProgressAt || 0)) >= Number($data?.stuckThresholdMs || 0)" }, "position": { "x": 980, @@ -36480,17 +29686,13 @@ "turn": "{{continuationTurn}}", "externalStatus": "{{currentExternalStatus}}", "stuckThresholdMs": "{{stuckThresholdMs}}", - "stuckForMs": "{{stuckForMs}}", + "stuckForMs": "{{Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))}}", "onStuck": "{{onStuck}}", "stuckRetryCount": "{{stuckRetryCount}}", "maxStuckAutoRetries": "{{maxStuckAutoRetries}}", "lastProgressAt": "{{lastProgressAt}}", "lastProgressSignature": "{{lastProgressSignature}}", "currentProgressSignature": "{{currentProgressSignature}}", - "placeholderResponse": "{{(() => { const normalizedOutput = String($ctx.getNodeOutput('run-agent')?.output || '').replace(/\\s+/g, ' ').trim().toLowerCase(); return normalizedOutput === 'continued' || normalizedOutput === 'model response continued'; })()}}", - "agentActivityDetected": "{{(() => { const agentOutput = $ctx.getNodeOutput('run-agent') || {}; const normalizedOutput = String(agentOutput?.output || '').replace(/\\s+/g, ' ').trim().toLowerCase(); const placeholderOutput = normalizedOutput === 'continued' || normalizedOutput === 'model response continued' || normalizedOutput === '(agent completed with no text output)'; const streamCount = Array.isArray(agentOutput?.stream) ? agentOutput.stream.length : 0; const itemCount = Number(agentOutput?.itemCount || (Array.isArray(agentOutput?.items) ? agentOutput.items.length : 0) || 0); return streamCount > 0 || itemCount > 0 || (!!normalizedOutput && !placeholderOutput); })()}}", - "agentItemCount": "{{$ctx.getNodeOutput('run-agent')?.itemCount || (Array.isArray($ctx.getNodeOutput('run-agent')?.items) ? $ctx.getNodeOutput('run-agent')?.items.length : 0) || 0}}", - "agentStreamCount": "{{Array.isArray($ctx.getNodeOutput('run-agent')?.stream) ? $ctx.getNodeOutput('run-agent')?.stream.length : 0}}", "progressSnapshot": "{{$ctx.getNodeOutput('capture-progress')?.output || ''}}", "lastAgentSuccess": "{{$ctx.getNodeOutput('run-agent')?.success === true}}", "lastAgentOutput": "{{$ctx.getNodeOutput('run-agent')?.output || ''}}" @@ -36555,7 +29757,6 @@ "sdk": "{{sdk}}", "model": "{{model}}", "timeoutMs": "{{timeoutMs}}", - "requireTaskPromptCompleteness": false, "failOnError": false }, "position": { @@ -36589,7 +29790,7 @@ "label": "Escalate Stuck Session", "config": { "level": "warn", - "message": "session-stuck: escalation requested for task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}}, stuckForMs={{stuckForMs}}, stuckRetryCount={{stuckRetryCount}}/{{maxStuckAutoRetries}}, lastProgressSignature={{lastProgressSignature}}, currentProgressSignature={{currentProgressSignature}})" + "message": "session-stuck: escalation requested for task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}}, stuckForMs={{Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))}}, stuckRetryCount={{stuckRetryCount}}/{{maxStuckAutoRetries}}, lastProgressSignature={{lastProgressSignature}}, currentProgressSignature={{currentProgressSignature}})" }, "position": { "x": 980, @@ -36605,7 +29806,7 @@ "label": "Escalate Stuck Session (Retry Limit)", "config": { "level": "warn", - "message": "session-stuck: retry budget exhausted for task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}}, stuckForMs={{stuckForMs}}, stuckRetryCount={{stuckRetryCount}}/{{maxStuckAutoRetries}}, lastProgressSignature={{lastProgressSignature}}, currentProgressSignature={{currentProgressSignature}})" + "message": "session-stuck: retry budget exhausted for task {{taskId}} at turn {{continuationTurn}} (externalStatus={{currentExternalStatus}}, stuckForMs={{Math.max(0, Date.now() - Number($data?.lastProgressAt || 0))}}, stuckRetryCount={{stuckRetryCount}}/{{maxStuckAutoRetries}}, lastProgressSignature={{lastProgressSignature}}, currentProgressSignature={{currentProgressSignature}})" }, "position": { "x": 760, @@ -36826,14 +30027,8 @@ "sourcePort": "default" }, { - "id": "derive-signature->derive-stuck-ms", + "id": "derive-signature->progress-changed", "source": "derive-signature", - "target": "derive-stuck-ms", - "sourcePort": "default" - }, - { - "id": "derive-stuck-ms->progress-changed", - "source": "derive-stuck-ms", "target": "progress-changed", "sourcePort": "default" }, @@ -36980,13 +30175,13 @@ ], "metadata": { "author": "bosun-demo", - "createdAt": "2026-03-28T12:00:00.000Z", - "updatedAt": "2026-03-28T12:00:00.000Z", + "createdAt": "2026-03-27T12:00:00.000Z", + "updatedAt": "2026-03-27T12:00:00.000Z", "templateState": { - "templateId": "template-continuation-loop-manual", - "templateName": "Continuation Loop (Manual)", - "templateVersion": "1.3.0", - "installedTemplateVersion": "1.3.0", + "templateId": "template-continuation-loop", + "templateName": "Continuation Loop", + "templateVersion": "1.1.0", + "installedTemplateVersion": "1.1.0", "isCustomized": false, "updateAvailable": false } @@ -38012,469 +31207,6 @@ } } }, - { - "id": "wf-recover-blocked-task", - "name": "Recover Blocked Task (Worktree)", - "description": "Sub-workflow invoked once per blocked task by template-recover-blocked-worktrees. Sweeps stale worktrees for the task, acquires a clean one, and unblocks the task so it re-enters the normal task lifecycle. Works across all workspace repos — repo context is sourced entirely from the task's own stored metadata.", - "category": "reliability", - "enabled": true, - "nodeCount": 10, - "trigger": "trigger.event", - "variables": { - "baseBranch": "main", - "defaultTargetBranch": "origin/main" - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.event", - "label": "Recovery Requested", - "config": { - "eventType": "task.blocked.recovery_requested" - }, - "position": { - "x": 400, - "y": 50 - }, - "outputs": [ - "default" - ] - }, - { - "id": "check-context", - "type": "condition.expression", - "label": "Has Task Context?", - "config": { - "expression": "Boolean($data?.item?.taskId || $data?.taskId) && Boolean($data?.item?.branch || $data?.item?.branchName || $data?.branch || $data?.branchName || $data?.item?.meta?.worktreeFailure?.branch || $data?.meta?.worktreeFailure?.branch) && Boolean($data?.item?.repoRoot || $data?.item?.workspace || $data?.repoRoot || $data?.workspace || $data?.item?.meta?.worktreeFailure?.repoRoot || $data?.meta?.worktreeFailure?.repoRoot)" - }, - "position": { - "x": 400, - "y": 190 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "recover-wt", - "type": "action.recover_worktree", - "label": "Reset Broken Worktree", - "config": { - "taskId": "{{$data?.item?.taskId || $data?.taskId || ''}}", - "branch": "{{$data?.item?.branch || $data?.item?.branchName || $data?.branch || $data?.branchName || $data?.item?.meta?.worktreeFailure?.branch || $data?.meta?.worktreeFailure?.branch || ''}}", - "repoRoot": "{{$data?.item?.repoRoot || $data?.item?.workspace || $data?.repoRoot || $data?.workspace || $data?.item?.meta?.worktreeFailure?.repoRoot || $data?.meta?.worktreeFailure?.repoRoot || ''}}", - "worktreePath": "{{$data?.item?.worktreePath || $data?.worktreePath || $data?.item?.meta?.worktreeFailure?.worktreePath || $data?.meta?.worktreeFailure?.worktreePath || ''}}" - }, - "position": { - "x": 250, - "y": 340 - }, - "outputs": [ - "default" - ] - }, - { - "id": "acquire-wt", - "type": "action.acquire_worktree", - "label": "Acquire Clean Worktree", - "config": { - "taskId": "{{$data?.item?.taskId || $data?.taskId || ''}}", - "branch": "{{$data?.item?.branch || $data?.item?.branchName || $data?.branch || $data?.branchName || $data?.item?.meta?.worktreeFailure?.branch || $data?.meta?.worktreeFailure?.branch || ''}}", - "repoRoot": "{{$data?.item?.repoRoot || $data?.item?.workspace || $data?.repoRoot || $data?.workspace || $data?.item?.meta?.worktreeFailure?.repoRoot || $data?.meta?.worktreeFailure?.repoRoot || ''}}", - "baseBranch": "{{$data?.item?.baseBranch || $data?.baseBranch || $data?.item?.meta?.worktreeFailure?.baseBranch || $data?.meta?.worktreeFailure?.baseBranch || baseBranch}}", - "defaultTargetBranch": "{{$data?.item?.defaultTargetBranch || $data?.defaultTargetBranch || $data?.item?.meta?.worktreeFailure?.defaultTargetBranch || $data?.meta?.worktreeFailure?.defaultTargetBranch || defaultTargetBranch}}" - }, - "position": { - "x": 250, - "y": 490 - }, - "outputs": [ - "default" - ] - }, - { - "id": "check-acquired", - "type": "condition.expression", - "label": "Worktree Acquired?", - "config": { - "expression": "$ctx.getNodeOutput('acquire-wt')?.success === true" - }, - "position": { - "x": 250, - "y": 640 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "unblock-task", - "type": "action.update_task_status", - "label": "Unblock Task", - "config": { - "taskId": "{{$data?.item?.taskId || $data?.taskId || ''}}", - "status": "todo", - "taskTitle": "{{$data?.item?.taskTitle || $data?.taskTitle || $data?.item?.taskId || $data?.taskId || ''}}", - "workflowEvent": "task.blocked.recovery_succeeded", - "workflowData": { - "stage": "worktree_recovery", - "result": "recovered", - "branch": "{{$data?.item?.branch || $data?.item?.branchName || $data?.branch || $data?.branchName || $data?.item?.meta?.worktreeFailure?.branch || $data?.meta?.worktreeFailure?.branch || ''}}", - "worktreePath": "{{$ctx.getNodeOutput('acquire-wt')?.worktreePath || ''}}" - } - }, - "position": { - "x": 250, - "y": 790 - }, - "outputs": [ - "default" - ] - }, - { - "id": "clear-blocked-meta", - "type": "action.bosun_function", - "label": "Clear Blocked Metadata", - "config": { - "function": "tasks.update", - "args": { - "taskId": "{{$data?.item?.taskId || $data?.taskId || ''}}", - "fields": { - "blockedReason": null, - "meta": "{{(() => { const cur = Object.assign({}, $data?.item?.meta || $data?.meta || {}); delete cur.autoRecovery; delete cur.worktreeFailure; delete cur.consecutiveRecoveryFailures; delete cur.blockedReason; return cur; })()}}" - } - } - }, - "position": { - "x": 250, - "y": 940 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-success", - "type": "notify.log", - "label": "Log Recovery Success", - "config": { - "message": ":check: Worktree recovery succeeded for task {{$data?.item?.taskId || $data?.taskId}} ({{$data?.item?.taskTitle || $data?.taskTitle || 'unknown'}}). Task unblocked and returned to todo.", - "level": "info" - }, - "position": { - "x": 250, - "y": 1090 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-no-context", - "type": "notify.log", - "label": "Log Missing Context", - "config": { - "message": "Blocked task recovery skipped — missing taskId or branch in dispatch payload. Item: {{JSON.stringify($data?.item || {})}}", - "level": "warn" - }, - "position": { - "x": 620, - "y": 340 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-acquire-failed", - "type": "notify.log", - "label": "Log Acquire Failure", - "config": { - "message": ":warning: Worktree recovery failed for task {{$data?.item?.taskId || $data?.taskId}} — could not acquire a clean worktree. Branch: {{$data?.item?.branch || $data?.branch || 'unknown'}}. Manual intervention may be required.", - "level": "warn" - }, - "position": { - "x": 620, - "y": 790 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->check-context", - "source": "trigger", - "target": "check-context", - "sourcePort": "default" - }, - { - "id": "check-context->recover-wt", - "source": "check-context", - "target": "recover-wt", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "check-context->log-no-context", - "source": "check-context", - "target": "log-no-context", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "recover-wt->acquire-wt", - "source": "recover-wt", - "target": "acquire-wt", - "sourcePort": "default" - }, - { - "id": "acquire-wt->check-acquired", - "source": "acquire-wt", - "target": "check-acquired", - "sourcePort": "default" - }, - { - "id": "check-acquired->unblock-task", - "source": "check-acquired", - "target": "unblock-task", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "check-acquired->log-acquire-failed", - "source": "check-acquired", - "target": "log-acquire-failed", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "unblock-task->clear-blocked-meta", - "source": "unblock-task", - "target": "clear-blocked-meta", - "sourcePort": "default" - }, - { - "id": "clear-blocked-meta->log-success", - "source": "clear-blocked-meta", - "target": "log-success", - "sourcePort": "default" - } - ], - "metadata": { - "author": "bosun-demo", - "createdAt": "2026-03-28T12:00:00.000Z", - "updatedAt": "2026-03-28T12:00:00.000Z", - "templateState": { - "templateId": "template-recover-blocked-task", - "templateName": "Recover Blocked Task (Worktree)", - "templateVersion": "1.0.0", - "installedTemplateVersion": "1.0.0", - "isCustomized": false, - "updateAvailable": false - } - } - }, - { - "id": "wf-recover-blocked-worktrees", - "name": "Recover Blocked Worktree Tasks", - "description": "Scheduled operator-assist workflow that finds all tasks blocked due to worktree failures, sweeps their stale worktrees, and re-queues each as todo. Works across every repo in the workspace — repo context is read from each task's own metadata, so no repo configuration is needed here.", - "category": "reliability", - "enabled": true, - "nodeCount": 7, - "trigger": "trigger.schedule", - "variables": { - "scheduleIntervalMs": 1800000, - "maxPerSweep": 20, - "maxConcurrent": 2 - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.schedule", - "label": "Scheduled Worktree Recovery Sweep", - "config": { - "intervalMs": "{{scheduleIntervalMs}}", - "cron": "*/30 * * * *" - }, - "position": { - "x": 400, - "y": 50 - }, - "outputs": [ - "default" - ] - }, - { - "id": "query-blocked", - "type": "action.run_command", - "label": "Query Blocked Tasks", - "config": { - "command": "node", - "args": [ - "-e", - "\n const fs = require(\"node:fs\");\n const path = require(\"node:path\");\n const { pathToFileURL } = require(\"node:url\");\n let repoRoot = process.cwd();\n const mirrorMarker = (path.sep + \".bosun\" + path.sep + \"workspaces\" + path.sep).toLowerCase();\n if (repoRoot.toLowerCase().includes(mirrorMarker)) {\n const r = path.resolve(repoRoot, \"..\", \"..\", \"..\", \"..\");\n if (fs.existsSync(path.join(r, \"kanban\", \"kanban-adapter.mjs\"))) repoRoot = r;\n }\n const kanbanUrl = pathToFileURL(path.join(repoRoot, \"kanban\", \"kanban-adapter.mjs\")).href;\n import(kanbanUrl)\n .then(k => k.listTasks(undefined, { status: \"blocked\" }))\n .then(tasks => {\n const limit = parseInt(process.env.MAX_PER_SWEEP || \"20\");\n const blocked = (tasks || [])\n .map(t => {\n const meta = t && typeof t.meta === \"object\" ? t.meta : {};\n const worktreeFailure = meta && typeof meta.worktreeFailure === \"object\" ? meta.worktreeFailure : {};\n const branch = t?.branch || t?.branchName || t?.metadata?.branch || meta?.branch || worktreeFailure?.branch || null;\n const repoRoot = t?.repoRoot || t?.workspace || t?.metadata?.repoRoot || t?.metadata?.workspace || meta?.repoRoot || meta?.workspace || worktreeFailure?.repoRoot || null;\n const worktreePath = t?.worktreePath || t?.metadata?.worktreePath || meta?.worktreePath || worktreeFailure?.worktreePath || null;\n const baseBranch = t?.baseBranch || t?.metadata?.baseBranch || meta?.baseBranch || worktreeFailure?.baseBranch || null;\n const defaultTargetBranch = t?.defaultTargetBranch || t?.metadata?.defaultTargetBranch || meta?.defaultTargetBranch || worktreeFailure?.defaultTargetBranch || null;\n return {\n taskId: t?.id,\n taskTitle: t?.title || t?.id,\n branch,\n repoRoot,\n worktreePath,\n repository: t?.repository || t?.metadata?.repository || meta?.repository || null,\n baseBranch,\n defaultTargetBranch,\n meta,\n };\n })\n .filter(t => t && t.taskId && t.branch && t.repoRoot)\n .slice(0, limit)\n ;\n console.log(JSON.stringify(blocked));\n })\n .catch(e => { console.error(e.message); process.exit(1); });\n " - ], - "env": { - "MAX_PER_SWEEP": "{{maxPerSweep}}" - }, - "parseJson": true - }, - "position": { - "x": 400, - "y": 190 - }, - "outputs": [ - "default" - ] - }, - { - "id": "check-has-tasks", - "type": "condition.expression", - "label": "Any Blocked Tasks?", - "config": { - "expression": "Array.isArray($ctx.getNodeOutput('query-blocked')?.output) && $ctx.getNodeOutput('query-blocked').output.length > 0" - }, - "position": { - "x": 400, - "y": 360 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "recover-each", - "type": "loop.for_each", - "label": "Recover Each Blocked Task", - "config": { - "items": "$ctx.getNodeOutput('query-blocked')?.output || []", - "variable": "item", - "indexVariable": "recoveryIndex", - "maxConcurrent": "{{maxConcurrent}}", - "workflowId": "template-recover-blocked-task", - "mode": "dispatch" - }, - "position": { - "x": 400, - "y": 510 - }, - "outputs": [ - "default" - ] - }, - { - "id": "prune-worktrees", - "type": "action.run_command", - "label": "Prune Stale Worktree Refs", - "config": { - "command": "git", - "args": [ - "worktree", - "prune", - "--verbose" - ], - "continueOnError": true - }, - "position": { - "x": 400, - "y": 650 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-summary", - "type": "notify.log", - "label": "Log Recovery Summary", - "config": { - "message": ":broom: Blocked worktree recovery sweep dispatched for {{$ctx.getNodeOutput('query-blocked')?.output?.length || 0}} task(s). maxConcurrent={{maxConcurrent}} maxPerSweep={{maxPerSweep}}", - "level": "info" - }, - "position": { - "x": 250, - "y": 790 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-idle", - "type": "notify.log", - "label": "Log No Blocked Tasks", - "config": { - "message": "Blocked worktree recovery sweep: no blocked tasks with branch context found.", - "level": "debug" - }, - "position": { - "x": 620, - "y": 510 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->query-blocked", - "source": "trigger", - "target": "query-blocked", - "sourcePort": "default" - }, - { - "id": "query-blocked->check-has-tasks", - "source": "query-blocked", - "target": "check-has-tasks", - "sourcePort": "default" - }, - { - "id": "check-has-tasks->recover-each", - "source": "check-has-tasks", - "target": "recover-each", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "check-has-tasks->log-idle", - "source": "check-has-tasks", - "target": "log-idle", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "recover-each->prune-worktrees", - "source": "recover-each", - "target": "prune-worktrees", - "sourcePort": "default" - }, - { - "id": "prune-worktrees->log-summary", - "source": "prune-worktrees", - "target": "log-summary", - "sourcePort": "default" - } - ], - "metadata": { - "author": "bosun-demo", - "createdAt": "2026-03-28T12:00:00.000Z", - "updatedAt": "2026-03-28T12:00:00.000Z", - "templateState": { - "templateId": "template-recover-blocked-worktrees", - "templateName": "Recover Blocked Worktree Tasks", - "templateVersion": "1.0.0", - "installedTemplateVersion": "1.0.0", - "isCustomized": false, - "updateAvailable": false - } - } - }, { "id": "wf-task-archiver", "name": "Task Archiver", @@ -39478,13 +32210,11 @@ "description": "Recovery workflow for tasks that fail execution or finalization. Refreshes worktree state, runs a repair agent, re-validates quality gates, and escalates only after automated repair fails.", "category": "reliability", "enabled": true, - "nodeCount": 21, + "nodeCount": 15, "trigger": "trigger.event", "variables": { "repairTimeoutMs": 5400000, "verificationTimeoutMs": 3600000, - "repoRoot": "", - "defaultTargetBranch": "main", "baseBranch": "main", "verificationCommand": "node -e \"const cp=require('node:child_process');const cmds=['npm run prepush --if-present','npm run prepush:check --if-present','npm run build','npm test','npm run lint --if-present'];for(const cmd of cmds){cp.execSync(cmd,{stdio:'inherit'});} \"", "repairPrompt": "Task {{taskId}} ({{taskTitle}}) failed. Error: {{error}}. Repair the implementation in {{worktreePath}} without bypassing tests, then leave the branch ready for Bosun PR lifecycle handoff." @@ -39521,102 +32251,32 @@ ] }, { - "id": "has-branch-context", + "id": "has-worktree", "type": "condition.expression", - "label": "Branch Context Available?", + "label": "Worktree Context Available?", "config": { - "expression": "Boolean($data?.repoRoot) && Boolean($data?.branch) && Boolean($data?.taskId)" + "expression": "Boolean($data?.worktreePath)" }, "position": { "x": 400, "y": 180 }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "recover-repair-worktree", - "type": "action.recover_worktree", - "label": "Reset Broken Worktree", - "config": { - "worktreePath": "{{worktreePath}}", - "branch": "{{branch}}", - "repoRoot": "{{repoRoot}}", - "taskId": "{{taskId}}" - }, - "position": { - "x": 220, - "y": 320 - }, "outputs": [ "default" ] }, - { - "id": "acquire-repair-worktree", - "type": "action.acquire_worktree", - "label": "Acquire Clean Worktree", - "config": { - "repoRoot": "{{repoRoot}}", - "branch": "{{branch}}", - "taskId": "{{taskId}}", - "baseBranch": "{{baseBranch}}", - "defaultTargetBranch": "{{defaultTargetBranch}}" - }, - "position": { - "x": 220, - "y": 460 - }, - "outputs": [ - "default" - ] - }, - { - "id": "acquired-repair-worktree", - "type": "condition.expression", - "label": "Clean Worktree Ready?", - "config": { - "expression": "$ctx.getNodeOutput('acquire-repair-worktree')?.success === true" - }, - "position": { - "x": 220, - "y": 600 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "has-worktree", - "type": "condition.expression", - "label": "Fallback Worktree Context Available?", - "config": { - "expression": "Boolean($data?.worktreePath)" - }, - "position": { - "x": 560, - "y": 320 - }, - "outputs": [ - "yes", - "no" - ] - }, { "id": "refresh-worktree", "type": "action.refresh_worktree", "label": "Refresh Worktree", "config": { "operation": "fetch", - "cwd": "{{$ctx.getNodeOutput('acquire-repair-worktree')?.worktreePath || $data?.worktreePath || ''}}", + "cwd": "{{worktreePath}}", "continueOnError": true }, "position": { "x": 400, - "y": 740 + "y": 320 }, "outputs": [ "default" @@ -39628,12 +32288,12 @@ "label": "Repair Task", "config": { "prompt": "{{repairPrompt}}", - "cwd": "{{$ctx.getNodeOutput('acquire-repair-worktree')?.worktreePath || $data?.worktreePath || ''}}", + "cwd": "{{worktreePath}}", "timeoutMs": "{{repairTimeoutMs}}" }, "position": { "x": 400, - "y": 880 + "y": 460 }, "outputs": [ "default" @@ -39645,13 +32305,13 @@ "label": "Re-run Quality Gates", "config": { "command": "{{verificationCommand}}", - "cwd": "{{$ctx.getNodeOutput('acquire-repair-worktree')?.worktreePath || $data?.worktreePath || ''}}", + "cwd": "{{worktreePath}}", "timeoutMs": "{{verificationTimeoutMs}}", "continueOnError": true }, "position": { "x": 400, - "y": 1020 + "y": 600 }, "outputs": [ "default" @@ -39666,7 +32326,7 @@ }, "position": { "x": 400, - "y": 1160 + "y": 740 }, "outputs": [ "default" @@ -39688,7 +32348,7 @@ }, "position": { "x": 250, - "y": 1300 + "y": 880 }, "outputs": [ "default" @@ -39703,7 +32363,7 @@ }, "position": { "x": 250, - "y": 1370 + "y": 950 }, "outputs": [ "yes", @@ -39728,30 +32388,7 @@ }, "position": { "x": 250, - "y": 1440 - }, - "outputs": [ - "default" - ] - }, - { - "id": "clear-repair-blocked-success", - "type": "action.bosun_function", - "label": "Clear Repair Blocked State", - "config": { - "function": "tasks.update", - "args": { - "taskId": "{{taskId}}", - "fields": { - "cooldownUntil": null, - "blockedReason": null, - "meta": "{{(() => { const current = ($data?.meta && typeof $data.meta === 'object') ? $data.meta : {}; const next = { ...current }; delete next.autoRecovery; delete next.worktreeFailure; delete next.blockedReason; return next; })()}}" - } - } - }, - "position": { - "x": 250, - "y": 1510 + "y": 1020 }, "outputs": [ "default" @@ -39776,7 +32413,7 @@ }, "position": { "x": 250, - "y": 1650 + "y": 1160 }, "outputs": [ "default" @@ -39801,30 +32438,7 @@ }, "position": { "x": 560, - "y": 1300 - }, - "outputs": [ - "default" - ] - }, - { - "id": "clear-repair-blocked-failure", - "type": "action.bosun_function", - "label": "Clear Failed Repair Blocked State", - "config": { - "function": "tasks.update", - "args": { - "taskId": "{{taskId}}", - "fields": { - "cooldownUntil": null, - "blockedReason": null, - "meta": "{{(() => { const current = ($data?.meta && typeof $data.meta === 'object') ? $data.meta : {}; const next = { ...current }; delete next.autoRecovery; delete next.worktreeFailure; delete next.blockedReason; return next; })()}}" - } - } - }, - "position": { - "x": 560, - "y": 1440 + "y": 880 }, "outputs": [ "default" @@ -39840,7 +32454,7 @@ }, "position": { "x": 250, - "y": 1790 + "y": 1300 }, "outputs": [ "default" @@ -39855,7 +32469,7 @@ }, "position": { "x": 560, - "y": 1580 + "y": 1020 }, "outputs": [ "default" @@ -39870,8 +32484,8 @@ "level": "warn" }, "position": { - "x": 720, - "y": 460 + "x": 700, + "y": 320 }, "outputs": [ "default" @@ -39880,69 +32494,29 @@ ], "edges": [ { - "id": "trigger-failed->has-branch-context", + "id": "trigger-failed->has-worktree", "source": "trigger-failed", - "target": "has-branch-context", + "target": "has-worktree", "sourcePort": "default" }, { - "id": "trigger-finalization->has-branch-context", + "id": "trigger-finalization->has-worktree", "source": "trigger-finalization", - "target": "has-branch-context", - "sourcePort": "default" - }, - { - "id": "has-branch-context->recover-repair-worktree", - "source": "has-branch-context", - "target": "recover-repair-worktree", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "has-branch-context->has-worktree", - "source": "has-branch-context", "target": "has-worktree", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "recover-repair-worktree->acquire-repair-worktree", - "source": "recover-repair-worktree", - "target": "acquire-repair-worktree", - "sourcePort": "default" - }, - { - "id": "acquire-repair-worktree->acquired-repair-worktree", - "source": "acquire-repair-worktree", - "target": "acquired-repair-worktree", "sourcePort": "default" }, - { - "id": "acquired-repair-worktree->refresh-worktree", - "source": "acquired-repair-worktree", - "target": "refresh-worktree", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "acquired-repair-worktree->no-worktree", - "source": "acquired-repair-worktree", - "target": "no-worktree", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, { "id": "has-worktree->refresh-worktree", "source": "has-worktree", "target": "refresh-worktree", - "sourcePort": "yes", + "sourcePort": "default", "condition": "$output?.result === true" }, { "id": "has-worktree->no-worktree", "source": "has-worktree", "target": "no-worktree", - "sourcePort": "no", + "sourcePort": "default", "condition": "$output?.result !== true" }, { @@ -39998,14 +32572,8 @@ "condition": "$output?.result !== true" }, { - "id": "mark-inreview->clear-repair-blocked-success", + "id": "mark-inreview->handoff-pr-progressor", "source": "mark-inreview", - "target": "clear-repair-blocked-success", - "sourcePort": "default" - }, - { - "id": "clear-repair-blocked-success->handoff-pr-progressor", - "source": "clear-repair-blocked-success", "target": "handoff-pr-progressor", "sourcePort": "default" }, @@ -40016,14 +32584,8 @@ "sourcePort": "default" }, { - "id": "mark-todo->clear-repair-blocked-failure", + "id": "mark-todo->notify-escalate", "source": "mark-todo", - "target": "clear-repair-blocked-failure", - "sourcePort": "default" - }, - { - "id": "clear-repair-blocked-failure->notify-escalate", - "source": "clear-repair-blocked-failure", "target": "notify-escalate", "sourcePort": "default" }, @@ -40301,7 +32863,7 @@ "type": "action.run_command", "label": "Rotate Agent Logs", "config": { - "command": "node -e \"const fs=require('node:fs');const path=require('node:path');const root=path.resolve('.bosun','logs');const cutoff=Date.now()-((Number('{{logRetentionDays}}')||7)*86400000);let removed=0;const walk=(dir)=>{if(!fs.existsSync(dir))return;for(const entry of fs.readdirSync(dir,{withFileTypes:true})){const full=path.join(dir,entry.name);if(entry.isDirectory())walk(full);else if(entry.isFile()&&entry.name.endsWith('.log')){const stat=fs.statSync(full);if(Number(stat.mtimeMs||0)/dev/null; echo 'Rotated'", "continueOnError": true }, "position": { @@ -40317,7 +32879,7 @@ "type": "action.run_command", "label": "Clean Old Evidence", "config": { - "command": "node -e \"const fs=require('node:fs');const path=require('node:path');const root=path.resolve('.bosun','evidence');const cutoff=Date.now()-((Number('{{logRetentionDays}}')||7)*86400000);let removed=0;const walk=(dir)=>{if(!fs.existsSync(dir))return;for(const entry of fs.readdirSync(dir,{withFileTypes:true})){const full=path.join(dir,entry.name);if(entry.isDirectory())walk(full);else if(entry.isFile()){const stat=fs.statSync(full);if(Number(stat.mtimeMs||0)/dev/null; echo 'Cleaned'", "continueOnError": true }, "position": { @@ -44930,221 +37492,6 @@ } } }, - { - "id": "wf-pr-review-quality-striker", - "name": "PR Review Quality Striker", - "description": "Reactive PR quality workflow that responds to GitHub review activity, falls back to scheduled sweeps, pulls GitHub review comments, reviews, inline review comments, and quality-related checks, then dispatches a constrained repair agent against actionable findings.", - "category": "maintenance", - "enabled": true, - "nodeCount": 8, - "trigger": "trigger.pr_event", - "variables": { - "repoScope": "auto", - "maxPrs": 12, - "intervalMs": 300000, - "trustedAuthors": "", - "allowTrustedFixes": false - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.pr_event", - "label": "PR Review Activity", - "config": { - "event": "review_requested", - "events": [ - "review_requested", - "changes_requested", - "approved", - "opened" - ] - }, - "position": { - "x": 220, - "y": 50 - }, - "outputs": [ - "default" - ] - }, - { - "id": "trigger-review-comment", - "type": "trigger.event", - "label": "PR Review Comment", - "config": { - "eventType": "github:pull_request_review_comment", - "filter": "['created','edited'].includes(String($event?.action || '').toLowerCase())" - }, - "position": { - "x": 420, - "y": 50 - }, - "outputs": [ - "default" - ] - }, - { - "id": "trigger-fallback", - "type": "trigger.schedule", - "label": "Poll PR Quality Signals", - "config": { - "intervalMs": "{{intervalMs}}" - }, - "position": { - "x": 620, - "y": 50 - }, - "outputs": [ - "default" - ] - }, - { - "id": "fetch-review-signals", - "type": "action.run_command", - "label": "Fetch Review Quality Signals", - "config": { - "command": "node", - "args": [ - "-e", - "const fs=require('fs'); const path=require('path'); const {execFileSync}=require('child_process'); const MAX_PRS=Math.max(1,Number('{{maxPrs}}')||12); const REPO_SCOPE=String('{{repoScope}}'||'auto').trim(); const TRUSTED_AUTHORS=new Set(String('{{trustedAuthors}}'||'').split(',').map((entry)=>entry.trim().toLowerCase()).filter(Boolean)); const ALLOW_TRUSTED_FIXES=String('{{allowTrustedFixes}}'||'false').trim().toLowerCase()==='true'; function runGh(args){return execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();} function parseJson(raw,fallback){try{return JSON.parse(raw||'')}catch{return fallback;}} function ghJson(args){return parseJson(runGh(args),[]);} function readLabelNames(pr){return Array.isArray(pr?.labels)?pr.labels.map((entry)=>typeof entry==='string'?entry:entry?.name).filter(Boolean):[];} function isBosunCreated(pr){return readLabelNames(pr).includes('bosun-pr-bosun-created');} function readAuthorLogin(pr){return String(pr?.author?.login||pr?.author?.name||'').trim().toLowerCase();} function configPath(){const home=String(process.env.BOSUN_HOME||process.env.BOSUN_PROJECT_DIR||'').trim();return home?path.join(home,'bosun.config.json'):path.join(process.cwd(),'bosun.config.json');} function readBosunConfig(){try{return JSON.parse(fs.readFileSync(configPath(),'utf8'));}catch{return {};}} function collectReposFromConfig(){const repos=[];try{const cfg=readBosunConfig();const workspaces=Array.isArray(cfg?.workspaces)?cfg.workspaces:[];if(workspaces.length>0){const active=String(cfg?.activeWorkspace||'').trim().toLowerCase();const activeWs=active?workspaces.find((ws)=>String(ws?.id||'').trim().toLowerCase()===active):null;const wsList=activeWs?[activeWs]:workspaces;for(const ws of wsList){for(const repo of (Array.isArray(ws?.repos)?ws.repos:[])){const slug=typeof repo==='string'?String(repo).trim():String(repo?.slug||'').trim();if(slug)repos.push(slug);}}}if(repos.length===0){for(const repo of (Array.isArray(cfg?.repos)?cfg.repos:[])){const slug=typeof repo==='string'?String(repo).trim():String(repo?.slug||'').trim();if(slug)repos.push(slug);}}}catch{}return repos;} function resolveRepoTargets(){if(REPO_SCOPE&&REPO_SCOPE!=='auto'&&REPO_SCOPE!=='current'){return [...new Set(REPO_SCOPE.split(',').map((entry)=>entry.trim()).filter(Boolean))];}if(REPO_SCOPE==='current')return [''];const fromConfig=collectReposFromConfig();if(fromConfig.length>0)return [...new Set(fromConfig)];const envRepo=String(process.env.GITHUB_REPOSITORY||'').trim();return envRepo?[envRepo]:[''];} function parseRepoFromUrl(url){const raw=String(url||'');const marker='github.com/';const idx=raw.toLowerCase().indexOf(marker);if(idx<0)return '';const tail=raw.slice(idx+marker.length).split('/');if(tail.length<2)return '';const owner=String(tail[0]||'').trim();const repo=String(tail[1]||'').trim();return owner&&repo?(owner+'/'+repo):'';} function isEligible(pr){const bosunCreated=isBosunCreated(pr);if(bosunCreated)return true;return ALLOW_TRUSTED_FIXES&&TRUSTED_AUTHORS.has(readAuthorLogin(pr));} const QUALITY_FAIL_STATES=new Set(['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE','FAIL']); const QUALITY_PENDING_STATES=new Set(['QUEUED','IN_PROGRESS','PENDING','WAITING','REQUESTED']); const SONAR_CHECK_RE=/(^|[^a-z])(sonarqube|sonarcloud|sonar)([^a-z]|$)/i; function readCheckName(check){return String(check?.name||check?.context||check?.workflowName||check?.displayTitle||'').trim();} function safeGhJson(args,fallback,runner){try{const invoke=typeof runner==='function'?runner:runGh;const out=invoke(args);return out?JSON.parse(out):fallback;}catch{return fallback;}} function truncateText(value,max){const text=String(value||'').replace(/\\r/g,'').trim();if(!text)return '';return text.length>max?text.slice(0,Math.max(0,max-19))+'\\n...[truncated]':text;} function compactUser(user){const login=String(user?.login||user?.name||'').trim();return login?{login,url:String(user?.url||user?.html_url||'').trim()||null}:null;} function compactCheck(check){const name=readCheckName(check);const state=String(check?.state||check?.conclusion||'').trim().toUpperCase();const bucket=String(check?.bucket||'').trim().toUpperCase();if(!name&&!state&&!bucket)return null;return {name:name||null,state:state||null,bucket:bucket||null,workflow:String(check?.workflowName||'').trim()||null};} function compactIssueComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactReview(review){return {id:Number(review?.id||0)||null,author:compactUser(review?.user||review?.author),state:String(review?.state||'').trim()||null,submittedAt:String(review?.submitted_at||review?.submittedAt||'').trim()||null,body:truncateText(review?.body,1200)};} function compactReviewComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),path:String(comment?.path||'').trim()||null,line:Number(comment?.line||0)||Number(comment?.original_line||0)||null,side:String(comment?.side||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactFile(file){const filePath=String(file?.filename||file?.path||'').trim();return filePath?{path:filePath,status:String(file?.status||'').trim()||null,additions:Number(file?.additions||0)||0,deletions:Number(file?.deletions||0)||0,changes:Number(file?.changes||0)||0}:null;} function collectPrDigest(repo,number,fallback,runner){const pr=safeGhJson(['pr','view',String(number),'--repo',repo,'--json','number,title,body,url,headRefName,baseRefName,isDraft,mergeable,statusCheckRollup,author,labels,reviewDecision'],{},runner);const issueComments=safeGhJson(['api','repos/'+repo+'/issues/'+number+'/comments?per_page=100'],[],runner).map(compactIssueComment).slice(0,40);const reviews=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/reviews?per_page=100'],[],runner).map(compactReview).slice(0,40);const reviewComments=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/comments?per_page=100'],[],runner).map(compactReviewComment).slice(0,60);const files=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/files?per_page=100'],[],runner).map(compactFile).filter(Boolean).slice(0,80);const requested=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/requested_reviewers'],{},runner);const requestedReviewers=[...(Array.isArray(requested?.users)?requested.users:[]).map(compactUser),...(Array.isArray(requested?.teams)?requested.teams:[]).map((team)=>{const slug=String(team?.slug||team?.name||'').trim();return slug?{team:slug,url:String(team?.html_url||team?.url||'').trim()||null}:null;})].filter(Boolean);const checks=(Array.isArray(pr?.statusCheckRollup)?pr.statusCheckRollup:[]).map(compactCheck).filter(Boolean);const labels=(Array.isArray(pr?.labels)?pr.labels:[]).map((label)=>String(label?.name||label||'').trim()).filter(Boolean);const failingChecks=checks.filter((check)=>QUALITY_FAIL_STATES.has(String(check?.state||'').toUpperCase())||QUALITY_FAIL_STATES.has(String(check?.bucket||'').toUpperCase()));const pendingChecks=checks.filter((check)=>QUALITY_PENDING_STATES.has(String(check?.state||'').toUpperCase()));const digestSummary=['PR #'+String(pr?.number||number)+' '+String(pr?.title||fallback?.title||''),'repo='+repo+' branch='+(String(pr?.headRefName||fallback?.branch||'').trim()||'unknown'),'checks='+checks.length+' fail='+failingChecks.length+' pending='+pendingChecks.length,'comments='+issueComments.length+' reviews='+reviews.length+' reviewComments='+reviewComments.length+' files='+files.length,labels.length?'labels='+labels.join(', '):''].filter(Boolean).join('\\n');return {core:{number:Number(pr?.number||number)||number,title:String(pr?.title||fallback?.title||''),url:String(pr?.url||fallback?.url||'').trim()||null,body:truncateText(pr?.body,4000),branch:String(pr?.headRefName||fallback?.branch||'').trim()||null,baseBranch:String(pr?.baseRefName||fallback?.base||'').trim()||null,isDraft:pr?.isDraft===true,mergeable:String(pr?.mergeable||'').trim()||null,author:compactUser(pr?.author),reviewDecision:String(pr?.reviewDecision||'').trim()||null},labels,requestedReviewers,checks,ciSummary:{total:checks.length,failing:failingChecks.length,pending:pendingChecks.length,passing:Math.max(0,checks.length-failingChecks.length-pendingChecks.length)},issueComments,reviews,reviewComments,files,digestSummary};} function isActionableText(value){const text=String(value||'').trim();if(!text)return false;return /(fix|please|should|must|needs?|issue|bug|error|warning|sonar|lint|review|nit|suggest|change|request|fail)/i.test(text);} function collectActionableReviewSignals(prDigest){const digest=prDigest&&typeof prDigest==='object'?prDigest:{};const reviewComments=Array.isArray(digest.reviewComments)?digest.reviewComments:[];const reviews=Array.isArray(digest.reviews)?digest.reviews:[];const issueComments=Array.isArray(digest.issueComments)?digest.issueComments:[];const checks=Array.isArray(digest.checks)?digest.checks:[];const commentFindings=[];for(const comment of reviewComments){if(!isActionableText(comment?.body))continue;commentFindings.push({kind:'review_comment',path:String(comment?.path||'').trim()||null,line:Number(comment?.line||0)||null,author:String(comment?.author?.login||'').trim()||null,body:String(comment?.body||'').trim(),url:String(comment?.url||'').trim()||null});}for(const review of reviews){const state=String(review?.state||'').trim().toUpperCase();if(state!=='CHANGES_REQUESTED'&&!isActionableText(review?.body))continue;commentFindings.push({kind:'review',state:state||null,author:String(review?.author?.login||'').trim()||null,body:String(review?.body||'').trim(),url:String(review?.url||'').trim()||null});}for(const comment of issueComments){if(!isActionableText(comment?.body))continue;commentFindings.push({kind:'issue_comment',author:String(comment?.author?.login||'').trim()||null,body:String(comment?.body||'').trim(),url:String(comment?.url||'').trim()||null});}const failingChecks=checks.filter((check)=>QUALITY_FAIL_STATES.has(String(check?.state||'').toUpperCase())||QUALITY_FAIL_STATES.has(String(check?.bucket||'').toUpperCase()));const sonarChecks=failingChecks.filter((check)=>SONAR_CHECK_RE.test(String(readCheckName(check)||'')));const qualityChecks=failingChecks.map((check)=>({name:readCheckName(check),state:String(check?.state||check?.bucket||'').trim()||null,workflow:String(check?.workflow||'').trim()||null}));const summary=['commentFindings='+commentFindings.length,'qualityChecks='+qualityChecks.length,sonarChecks.length?'sonarChecks='+sonarChecks.length:''].filter(Boolean).join(' ');return {commentFindings,qualityChecks,sonarChecks,summary};} const DIRECT_PR_NUMBER=Number('{{prNumber}}')||0; const DIRECT_PR_URL=String('{{prUrl}}'||'').trim(); const DIRECT_REPO=String('{{repo}}'||'{{repoSlug}}'||'{{repository}}'||'').trim()||parseRepoFromUrl(DIRECT_PR_URL); const DIRECT_BRANCH=String('{{branch}}'||'').trim(); const DIRECT_BASE=String('{{baseBranch}}'||'').trim(); const DIRECT_EVENT=String('{{prEvent}}'||'').trim().toLowerCase(); const actionables=[]; function appendActionable(repo,prNumber,fallback,sourceKind){const number=Number(prNumber)||0;if(!repo||!number)return false;const prDigest=collectPrDigest(repo,number,fallback,runGh);if(prDigest?.core?.isDraft===true)return false;if(!isEligible({author:prDigest?.core?.author,labels:prDigest?.labels,body:prDigest?.core?.body,title:prDigest?.core?.title}))return false;const signals=collectActionableReviewSignals(prDigest);if(signals.commentFindings.length===0&&signals.qualityChecks.length===0)return false;actionables.push({repo,number,branch:String(prDigest?.core?.branch||fallback?.branch||'').trim(),base:String(prDigest?.core?.baseBranch||fallback?.base||'').trim(),url:String(prDigest?.core?.url||fallback?.url||'').trim(),title:String(prDigest?.core?.title||fallback?.title||'').trim(),sourceKind,prEvent:DIRECT_EVENT||null,commentFindings:signals.commentFindings,qualityChecks:signals.qualityChecks,sonarChecks:signals.sonarChecks,summary:signals.summary,digestSummary:prDigest.digestSummary,prDigest});return true;} let total=0; if(DIRECT_REPO&&DIRECT_PR_NUMBER>0){total=1;appendActionable(DIRECT_REPO,DIRECT_PR_NUMBER,{branch:DIRECT_BRANCH,base:DIRECT_BASE,url:DIRECT_PR_URL},'event');}else{const prs=[];for(const target of resolveRepoTargets()){const repo=String(target||'').trim();const args=['pr','list','--state','open','--json','number,title,body,author,headRefName,baseRefName,isDraft,statusCheckRollup,labels,url','--limit',String(MAX_PRS)];if(repo)args.push('--repo',repo);try{const list=ghJson(args);for(const pr of (Array.isArray(list)?list:[])){prs.push({...pr,__repo:repo||parseRepoFromUrl(pr?.url)});}}catch{}}total=prs.length;for(const pr of prs){if(pr?.isDraft===true)continue;if(!isEligible(pr))continue;const repo=String(pr?.__repo||'').trim();if(!repo)continue;if(appendActionable(repo,pr.number,{branch:pr.headRefName,base:pr.baseRefName,title:pr.title,url:pr.url},'schedule')&&actionables.length>=5)break;}} console.log(JSON.stringify({total,actionableCount:actionables.length,mode:DIRECT_REPO&&DIRECT_PR_NUMBER>0?'event':'schedule',actionables}));" - ], - "continueOnError": false, - "failOnError": true - }, - "position": { - "x": 420, - "y": 210 - }, - "outputs": [ - "default" - ] - }, - { - "id": "has-review-work", - "type": "condition.expression", - "label": "Actionable Review Signals?", - "config": { - "expression": "(()=>{try{const raw=$ctx.getNodeOutput('fetch-review-signals')?.output||'{}';return (JSON.parse(raw).actionableCount||0)>0;}catch{return false;}})()" - }, - "position": { - "x": 420, - "y": 370 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "run-review-striker", - "type": "action.run_agent", - "label": "Repair PR Quality Findings", - "config": { - "sdk": "auto", - "timeoutMs": 1800000, - "prompt": "You are a Bosun PR quality repair agent. Work only the PRs in this JSON:\n\n{{$ctx.getNodeOutput('fetch-review-signals')?.output}}\n\nEach item contains prDigest with the PR body, files, issue comments, reviews, review comments, and checks. Address only the listed commentFindings and qualityChecks on the existing PR branch. Make the smallest safe code change, run targeted validation, and push updates to the same PR branch.\n\nSTRICT RULES:\n- Focus on actionable review feedback and failing quality checks only.\n- Do not create a new PR, close the PR, or perform unrelated cleanup.\n- Prioritize commentFindings before generic lint or static-analysis cleanup.\n- Preserve runtime behavior unless a reviewer-requested fix requires otherwise.\n- If a check is listed but the cause is unclear, inspect the relevant file paths from prDigest.files and the referenced review comment paths before editing." - }, - "position": { - "x": 220, - "y": 540 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-review-idle", - "type": "notify.log", - "label": "No Review Work", - "config": { - "message": "PR Review Quality Striker found no actionable review or quality findings.", - "level": "info" - }, - "position": { - "x": 620, - "y": 540 - }, - "outputs": [ - "default" - ] - }, - { - "id": "notify-review-run", - "type": "notify.log", - "label": "Log Review Dispatch", - "config": { - "message": "PR Review Quality Striker dispatched remediation for actionable GitHub review signals.", - "level": "info" - }, - "position": { - "x": 220, - "y": 700 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->fetch-review-signals", - "source": "trigger", - "target": "fetch-review-signals", - "sourcePort": "default" - }, - { - "id": "trigger-review-comment->fetch-review-signals", - "source": "trigger-review-comment", - "target": "fetch-review-signals", - "sourcePort": "default" - }, - { - "id": "trigger-fallback->fetch-review-signals", - "source": "trigger-fallback", - "target": "fetch-review-signals", - "sourcePort": "default" - }, - { - "id": "fetch-review-signals->has-review-work", - "source": "fetch-review-signals", - "target": "has-review-work", - "sourcePort": "default" - }, - { - "id": "has-review-work->run-review-striker", - "source": "has-review-work", - "target": "run-review-striker", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "has-review-work->log-review-idle", - "source": "has-review-work", - "target": "log-review-idle", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "run-review-striker->notify-review-run", - "source": "run-review-striker", - "target": "notify-review-run", - "sourcePort": "default" - } - ], - "metadata": { - "author": "bosun-demo", - "createdAt": "2026-03-28T12:00:00.000Z", - "updatedAt": "2026-03-28T12:00:00.000Z", - "templateState": { - "templateId": "template-pr-review-quality-striker", - "templateName": "PR Review Quality Striker", - "templateVersion": "1.0.0", - "installedTemplateVersion": "1.0.0", - "isCustomized": false, - "updateAvailable": false - } - } - }, { "id": "wf-scheduled-maintenance", "name": "Scheduled Maintenance", @@ -45325,172 +37672,6 @@ } } }, - { - "id": "wf-sonarqube-pr-striker", - "name": "SonarQube PR Striker", - "description": "Scheduled PR quality workflow that detects failing SonarQube or SonarCloud checks through GitHub-native status checks, enriches them with the same compact PR digest used by Bosun's PR workflows, and dispatches a constrained static-analysis remediation agent.", - "category": "maintenance", - "enabled": true, - "nodeCount": 6, - "trigger": "trigger.schedule", - "variables": { - "repoScope": "auto", - "maxPrs": 12, - "intervalMs": 600000, - "trustedAuthors": "", - "allowTrustedFixes": false - }, - "nodes": [ - { - "id": "trigger", - "type": "trigger.schedule", - "label": "Poll Sonar Signals", - "config": { - "intervalMs": "{{intervalMs}}" - }, - "position": { - "x": 420, - "y": 50 - }, - "outputs": [ - "default" - ] - }, - { - "id": "fetch-sonar-signals", - "type": "action.run_command", - "label": "Fetch SonarQube Signals", - "config": { - "command": "node", - "args": [ - "-e", - "const fs=require('fs'); const path=require('path'); const {execFileSync}=require('child_process'); const MAX_PRS=Math.max(1,Number('{{maxPrs}}')||12); const REPO_SCOPE=String('{{repoScope}}'||'auto').trim(); const TRUSTED_AUTHORS=new Set(String('{{trustedAuthors}}'||'').split(',').map((entry)=>entry.trim().toLowerCase()).filter(Boolean)); const ALLOW_TRUSTED_FIXES=String('{{allowTrustedFixes}}'||'false').trim().toLowerCase()==='true'; function runGh(args){return execFileSync('gh',args,{encoding:'utf8',stdio:['pipe','pipe','pipe']}).trim();} function parseJson(raw,fallback){try{return JSON.parse(raw||'')}catch{return fallback;}} function ghJson(args){return parseJson(runGh(args),[]);} function readLabelNames(pr){return Array.isArray(pr?.labels)?pr.labels.map((entry)=>typeof entry==='string'?entry:entry?.name).filter(Boolean):[];} function isBosunCreated(pr){return readLabelNames(pr).includes('bosun-pr-bosun-created');} function readAuthorLogin(pr){return String(pr?.author?.login||pr?.author?.name||'').trim().toLowerCase();} function configPath(){const home=String(process.env.BOSUN_HOME||process.env.BOSUN_PROJECT_DIR||'').trim();return home?path.join(home,'bosun.config.json'):path.join(process.cwd(),'bosun.config.json');} function readBosunConfig(){try{return JSON.parse(fs.readFileSync(configPath(),'utf8'));}catch{return {};}} function collectReposFromConfig(){const repos=[];try{const cfg=readBosunConfig();const workspaces=Array.isArray(cfg?.workspaces)?cfg.workspaces:[];if(workspaces.length>0){const active=String(cfg?.activeWorkspace||'').trim().toLowerCase();const activeWs=active?workspaces.find((ws)=>String(ws?.id||'').trim().toLowerCase()===active):null;const wsList=activeWs?[activeWs]:workspaces;for(const ws of wsList){for(const repo of (Array.isArray(ws?.repos)?ws.repos:[])){const slug=typeof repo==='string'?String(repo).trim():String(repo?.slug||'').trim();if(slug)repos.push(slug);}}}if(repos.length===0){for(const repo of (Array.isArray(cfg?.repos)?cfg.repos:[])){const slug=typeof repo==='string'?String(repo).trim():String(repo?.slug||'').trim();if(slug)repos.push(slug);}}}catch{}return repos;} function resolveRepoTargets(){if(REPO_SCOPE&&REPO_SCOPE!=='auto'&&REPO_SCOPE!=='current'){return [...new Set(REPO_SCOPE.split(',').map((entry)=>entry.trim()).filter(Boolean))];}if(REPO_SCOPE==='current')return [''];const fromConfig=collectReposFromConfig();if(fromConfig.length>0)return [...new Set(fromConfig)];const envRepo=String(process.env.GITHUB_REPOSITORY||'').trim();return envRepo?[envRepo]:[''];} function parseRepoFromUrl(url){const raw=String(url||'');const marker='github.com/';const idx=raw.toLowerCase().indexOf(marker);if(idx<0)return '';const tail=raw.slice(idx+marker.length).split('/');if(tail.length<2)return '';const owner=String(tail[0]||'').trim();const repo=String(tail[1]||'').trim();return owner&&repo?(owner+'/'+repo):'';} function isEligible(pr){const bosunCreated=isBosunCreated(pr);if(bosunCreated)return true;return ALLOW_TRUSTED_FIXES&&TRUSTED_AUTHORS.has(readAuthorLogin(pr));} const QUALITY_FAIL_STATES=new Set(['FAILURE','ERROR','TIMED_OUT','CANCELLED','STARTUP_FAILURE','FAIL']); const QUALITY_PENDING_STATES=new Set(['QUEUED','IN_PROGRESS','PENDING','WAITING','REQUESTED']); const SONAR_CHECK_RE=/(^|[^a-z])(sonarqube|sonarcloud|sonar)([^a-z]|$)/i; function readCheckName(check){return String(check?.name||check?.context||check?.workflowName||check?.displayTitle||'').trim();} function safeGhJson(args,fallback,runner){try{const invoke=typeof runner==='function'?runner:runGh;const out=invoke(args);return out?JSON.parse(out):fallback;}catch{return fallback;}} function truncateText(value,max){const text=String(value||'').replace(/\\r/g,'').trim();if(!text)return '';return text.length>max?text.slice(0,Math.max(0,max-19))+'\\n...[truncated]':text;} function compactUser(user){const login=String(user?.login||user?.name||'').trim();return login?{login,url:String(user?.url||user?.html_url||'').trim()||null}:null;} function compactCheck(check){const name=readCheckName(check);const state=String(check?.state||check?.conclusion||'').trim().toUpperCase();const bucket=String(check?.bucket||'').trim().toUpperCase();if(!name&&!state&&!bucket)return null;return {name:name||null,state:state||null,bucket:bucket||null,workflow:String(check?.workflowName||'').trim()||null};} function compactIssueComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactReview(review){return {id:Number(review?.id||0)||null,author:compactUser(review?.user||review?.author),state:String(review?.state||'').trim()||null,submittedAt:String(review?.submitted_at||review?.submittedAt||'').trim()||null,body:truncateText(review?.body,1200)};} function compactReviewComment(comment){return {id:Number(comment?.id||0)||null,author:compactUser(comment?.user||comment?.author),path:String(comment?.path||'').trim()||null,line:Number(comment?.line||0)||Number(comment?.original_line||0)||null,side:String(comment?.side||'').trim()||null,url:String(comment?.html_url||comment?.url||'').trim()||null,createdAt:String(comment?.created_at||comment?.createdAt||'').trim()||null,body:truncateText(comment?.body,1200)};} function compactFile(file){const filePath=String(file?.filename||file?.path||'').trim();return filePath?{path:filePath,status:String(file?.status||'').trim()||null,additions:Number(file?.additions||0)||0,deletions:Number(file?.deletions||0)||0,changes:Number(file?.changes||0)||0}:null;} function collectPrDigest(repo,number,fallback,runner){const pr=safeGhJson(['pr','view',String(number),'--repo',repo,'--json','number,title,body,url,headRefName,baseRefName,isDraft,mergeable,statusCheckRollup,author,labels,reviewDecision'],{},runner);const issueComments=safeGhJson(['api','repos/'+repo+'/issues/'+number+'/comments?per_page=100'],[],runner).map(compactIssueComment).slice(0,40);const reviews=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/reviews?per_page=100'],[],runner).map(compactReview).slice(0,40);const reviewComments=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/comments?per_page=100'],[],runner).map(compactReviewComment).slice(0,60);const files=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/files?per_page=100'],[],runner).map(compactFile).filter(Boolean).slice(0,80);const requested=safeGhJson(['api','repos/'+repo+'/pulls/'+number+'/requested_reviewers'],{},runner);const requestedReviewers=[...(Array.isArray(requested?.users)?requested.users:[]).map(compactUser),...(Array.isArray(requested?.teams)?requested.teams:[]).map((team)=>{const slug=String(team?.slug||team?.name||'').trim();return slug?{team:slug,url:String(team?.html_url||team?.url||'').trim()||null}:null;})].filter(Boolean);const checks=(Array.isArray(pr?.statusCheckRollup)?pr.statusCheckRollup:[]).map(compactCheck).filter(Boolean);const labels=(Array.isArray(pr?.labels)?pr.labels:[]).map((label)=>String(label?.name||label||'').trim()).filter(Boolean);const failingChecks=checks.filter((check)=>QUALITY_FAIL_STATES.has(String(check?.state||'').toUpperCase())||QUALITY_FAIL_STATES.has(String(check?.bucket||'').toUpperCase()));const pendingChecks=checks.filter((check)=>QUALITY_PENDING_STATES.has(String(check?.state||'').toUpperCase()));const digestSummary=['PR #'+String(pr?.number||number)+' '+String(pr?.title||fallback?.title||''),'repo='+repo+' branch='+(String(pr?.headRefName||fallback?.branch||'').trim()||'unknown'),'checks='+checks.length+' fail='+failingChecks.length+' pending='+pendingChecks.length,'comments='+issueComments.length+' reviews='+reviews.length+' reviewComments='+reviewComments.length+' files='+files.length,labels.length?'labels='+labels.join(', '):''].filter(Boolean).join('\\n');return {core:{number:Number(pr?.number||number)||number,title:String(pr?.title||fallback?.title||''),url:String(pr?.url||fallback?.url||'').trim()||null,body:truncateText(pr?.body,4000),branch:String(pr?.headRefName||fallback?.branch||'').trim()||null,baseBranch:String(pr?.baseRefName||fallback?.base||'').trim()||null,isDraft:pr?.isDraft===true,mergeable:String(pr?.mergeable||'').trim()||null,author:compactUser(pr?.author),reviewDecision:String(pr?.reviewDecision||'').trim()||null},labels,requestedReviewers,checks,ciSummary:{total:checks.length,failing:failingChecks.length,pending:pendingChecks.length,passing:Math.max(0,checks.length-failingChecks.length-pendingChecks.length)},issueComments,reviews,reviewComments,files,digestSummary};} function isActionableText(value){const text=String(value||'').trim();if(!text)return false;return /(fix|please|should|must|needs?|issue|bug|error|warning|sonar|lint|review|nit|suggest|change|request|fail)/i.test(text);} function collectActionableReviewSignals(prDigest){const digest=prDigest&&typeof prDigest==='object'?prDigest:{};const reviewComments=Array.isArray(digest.reviewComments)?digest.reviewComments:[];const reviews=Array.isArray(digest.reviews)?digest.reviews:[];const issueComments=Array.isArray(digest.issueComments)?digest.issueComments:[];const checks=Array.isArray(digest.checks)?digest.checks:[];const commentFindings=[];for(const comment of reviewComments){if(!isActionableText(comment?.body))continue;commentFindings.push({kind:'review_comment',path:String(comment?.path||'').trim()||null,line:Number(comment?.line||0)||null,author:String(comment?.author?.login||'').trim()||null,body:String(comment?.body||'').trim(),url:String(comment?.url||'').trim()||null});}for(const review of reviews){const state=String(review?.state||'').trim().toUpperCase();if(state!=='CHANGES_REQUESTED'&&!isActionableText(review?.body))continue;commentFindings.push({kind:'review',state:state||null,author:String(review?.author?.login||'').trim()||null,body:String(review?.body||'').trim(),url:String(review?.url||'').trim()||null});}for(const comment of issueComments){if(!isActionableText(comment?.body))continue;commentFindings.push({kind:'issue_comment',author:String(comment?.author?.login||'').trim()||null,body:String(comment?.body||'').trim(),url:String(comment?.url||'').trim()||null});}const failingChecks=checks.filter((check)=>QUALITY_FAIL_STATES.has(String(check?.state||'').toUpperCase())||QUALITY_FAIL_STATES.has(String(check?.bucket||'').toUpperCase()));const sonarChecks=failingChecks.filter((check)=>SONAR_CHECK_RE.test(String(readCheckName(check)||'')));const qualityChecks=failingChecks.map((check)=>({name:readCheckName(check),state:String(check?.state||check?.bucket||'').trim()||null,workflow:String(check?.workflow||'').trim()||null}));const summary=['commentFindings='+commentFindings.length,'qualityChecks='+qualityChecks.length,sonarChecks.length?'sonarChecks='+sonarChecks.length:''].filter(Boolean).join(' ');return {commentFindings,qualityChecks,sonarChecks,summary};} const prs=[]; for(const target of resolveRepoTargets()){const repo=String(target||'').trim();const args=['pr','list','--state','open','--json','number,title,body,author,headRefName,baseRefName,isDraft,statusCheckRollup,labels,url','--limit',String(MAX_PRS)];if(repo)args.push('--repo',repo);try{const list=ghJson(args);for(const pr of (Array.isArray(list)?list:[])){prs.push({...pr,__repo:repo||parseRepoFromUrl(pr?.url)});}}catch{}} const actionables=[]; for(const pr of prs){if(pr?.isDraft===true)continue;if(!isEligible(pr))continue;const repo=String(pr?.__repo||'').trim();if(!repo)continue;const listedChecks=Array.isArray(pr?.statusCheckRollup)?pr.statusCheckRollup:[];const hasSonarFailure=listedChecks.some((check)=>SONAR_CHECK_RE.test(String(readCheckName(check)||''))&&(QUALITY_FAIL_STATES.has(String(check?.conclusion||check?.state||'').toUpperCase())||QUALITY_FAIL_STATES.has(String(check?.bucket||'').toUpperCase())));if(!hasSonarFailure)continue;const prDigest=collectPrDigest(repo,pr.number,{branch:pr.headRefName,base:pr.baseRefName,title:pr.title,url:pr.url},runGh);const signals=collectActionableReviewSignals(prDigest);if(signals.sonarChecks.length===0)continue;actionables.push({repo,number:pr.number,branch:String(pr?.headRefName||'').trim(),base:String(pr?.baseRefName||'').trim(),url:String(pr?.url||'').trim(),title:String(pr?.title||'').trim(),sonarChecks:signals.sonarChecks,qualityChecks:signals.qualityChecks,commentFindings:signals.commentFindings,digestSummary:prDigest.digestSummary,summary:signals.summary,prDigest});if(actionables.length>=5)break;} console.log(JSON.stringify({total:prs.length,actionableCount:actionables.length,actionables}));" - ], - "continueOnError": false, - "failOnError": true - }, - "position": { - "x": 420, - "y": 210 - }, - "outputs": [ - "default" - ] - }, - { - "id": "has-sonar-work", - "type": "condition.expression", - "label": "Actionable Sonar Findings?", - "config": { - "expression": "(()=>{try{const raw=$ctx.getNodeOutput('fetch-sonar-signals')?.output||'{}';return (JSON.parse(raw).actionableCount||0)>0;}catch{return false;}})()" - }, - "position": { - "x": 420, - "y": 370 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "run-sonar-striker", - "type": "action.run_agent", - "label": "Repair SonarQube Findings", - "config": { - "sdk": "auto", - "timeoutMs": 1800000, - "prompt": "You are a Bosun SonarQube remediation agent. Work only the PRs in this JSON:\n\n{{$ctx.getNodeOutput('fetch-sonar-signals')?.output}}\n\nEach item contains sonarChecks plus prDigest with files, comments, reviews, review comments, and all checks. Fix only the listed SonarQube or SonarCloud findings on the existing PR branch, using the smallest safe code change.\n\nSTRICT RULES:\n- Use GitHub-native Sonar checks as the source of truth for this run.\n- Do not create a new PR or perform unrelated refactors.\n- If reviewer comments overlap with the Sonar issue, incorporate them only when they point at the same root cause.\n- Run targeted validation before pushing the branch update.\n- Preserve behavior while satisfying the static-analysis requirement." - }, - "position": { - "x": 220, - "y": 540 - }, - "outputs": [ - "default" - ] - }, - { - "id": "log-sonar-idle", - "type": "notify.log", - "label": "No Sonar Work", - "config": { - "message": "SonarQube PR Striker found no actionable SonarQube or SonarCloud failures.", - "level": "info" - }, - "position": { - "x": 620, - "y": 540 - }, - "outputs": [ - "default" - ] - }, - { - "id": "notify-sonar-run", - "type": "notify.log", - "label": "Log Sonar Dispatch", - "config": { - "message": "SonarQube PR Striker dispatched remediation for Sonar-native quality failures.", - "level": "info" - }, - "position": { - "x": 220, - "y": 700 - }, - "outputs": [ - "default" - ] - } - ], - "edges": [ - { - "id": "trigger->fetch-sonar-signals", - "source": "trigger", - "target": "fetch-sonar-signals", - "sourcePort": "default" - }, - { - "id": "fetch-sonar-signals->has-sonar-work", - "source": "fetch-sonar-signals", - "target": "has-sonar-work", - "sourcePort": "default" - }, - { - "id": "has-sonar-work->run-sonar-striker", - "source": "has-sonar-work", - "target": "run-sonar-striker", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "has-sonar-work->log-sonar-idle", - "source": "has-sonar-work", - "target": "log-sonar-idle", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "run-sonar-striker->notify-sonar-run", - "source": "run-sonar-striker", - "target": "notify-sonar-run", - "sourcePort": "default" - } - ], - "metadata": { - "author": "bosun-demo", - "createdAt": "2026-03-28T12:00:00.000Z", - "updatedAt": "2026-03-28T12:00:00.000Z", - "templateState": { - "templateId": "template-sonarqube-pr-striker", - "templateName": "SonarQube PR Striker", - "templateVersion": "1.0.0", - "installedTemplateVersion": "1.0.0", - "isCustomized": false, - "updateAvailable": false - } - } - }, { "id": "wf-task-batch-pr", "name": "Task Batch → PR", @@ -46065,7 +38246,7 @@ "description": "Complete task execution pipeline: poll for tasks → claim → worktree → agent dispatch → commit detection → PR creation → status transition. Replaces the monolithic TaskExecutor.executeTask() method with a composable workflow DAG.", "category": "task-execution", "enabled": true, - "nodeCount": 71, + "nodeCount": 59, "trigger": "trigger.task_available", "variables": { "maxParallel": 3, @@ -46508,202 +38689,34 @@ "no" ] }, - { - "id": "set-fix-summary", - "type": "action.set_variable", - "label": "Summarize Validation Output", - "config": { - "key": "fixSummary", - "value": "(() => { const out = $ctx.getNodeOutput('pre-pr-validation') || {}; const diag = out.outputDiagnostics || {}; const sections = []; sections.push('## Validation Result'); sections.push('- Exit code: ' + (out.exitCode ?? 'unknown')); sections.push('- Runner: ' + (diag.family || diag.runner || 'unknown')); if (diag.summary) sections.push('- Summary: ' + diag.summary); const targets = diag.failedTargets || []; if (targets.length) { sections.push(''); sections.push('## Failed Targets (' + targets.length + ')'); targets.slice(0, 30).forEach(t => sections.push(' - ' + t)); if (targets.length > 30) sections.push(' ... and ' + (targets.length - 30) + ' more'); } const rerun = out.outputSuggestedRerun || diag.suggestedRerun || ''; if (rerun) { sections.push(''); sections.push('## Suggested Rerun Command'); sections.push('```'); sections.push(rerun); sections.push('```'); } const hint = out.outputHint || diag.hint || ''; if (hint) sections.push('\\nHint: ' + hint); sections.push(''); sections.push('## Full Command Output'); sections.push(String(out.output || '').slice(0, 12000)); return sections.join('\\n'); })()", - "isExpression": true - }, - "position": { - "x": 300, - "y": 2000 - }, - "outputs": [ - "default" - ] - }, - { - "id": "auto-fix-validation", - "type": "action.run_agent", - "label": "Auto-Fix Validation (Pass 1)", - "config": { - "prompt": "# Fix Pre-PR Validation Failures — Pass 1\n\nTask: **{{taskTitle}}**\n\nThe pre-PR validation command failed. Your job is to fix EVERY error so validation passes.\n\n{{fixSummary}}\n\nSTRATEGY:\n1. Start from the **Failed Targets** list above — these are the exact files/tests/packages that broke.\n2. Fix compilation and syntax errors FIRST (missing imports, typos, type errors).\n3. Then fix test failures — open each failing test file, read what it asserts, and fix your code or the test expectation.\n4. If a **Suggested Rerun Command** is shown above, use it to re-run only the failing targets and iterate faster.\n5. Once targeted failures are fixed, run the full validation command to confirm everything passes.\n\nRULES:\n- Do NOT weaken, remove, or skip tests. Do NOT add --force or --no-verify flags.\n- Keep the original task scope — do not revert the feature.\n- Create a descriptive commit: \"fix: \"", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false - }, - "position": { - "x": 300, - "y": 2080 - }, - "outputs": [ - "default" - ] - }, - { - "id": "retry-pre-pr-validation", - "type": "action.run_command", - "label": "Retry Pre-PR Validation", - "config": { - "command": "{{prePrValidationCommand}}", - "commandType": "qualityGate", - "cwd": "{{worktreePath}}", - "failOnError": false - }, - "position": { - "x": 300, - "y": 2160 - }, - "outputs": [ - "default" - ] - }, - { - "id": "retry-validation-ok", - "type": "condition.expression", - "label": "Retry Validation Passed?", - "config": { - "expression": "(() => {const enabled = $data?.prePrValidationEnabled !== false;if (!enabled) return true;const out = $ctx.getNodeOutput('retry-pre-pr-validation');if (!out) return false;if (out.success === true) return true;const code = Number(out.exitCode);return Number.isFinite(code) && code === 0;})()" - }, - "position": { - "x": 300, - "y": 2240 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "set-fix2-summary", - "type": "action.set_variable", - "label": "Summarize Both Validation Outputs", - "config": { - "key": "fix2Summary", - "value": "(() => { function summarizeRun(label, out) { const diag = out.outputDiagnostics || {}; const lines = ['### ' + label]; lines.push('- Exit code: ' + (out.exitCode ?? 'unknown')); lines.push('- Runner: ' + (diag.family || diag.runner || 'unknown')); if (diag.summary) lines.push('- Summary: ' + diag.summary); const targets = diag.failedTargets || []; if (targets.length) { lines.push('- Failed targets (' + targets.length + '):'); targets.slice(0, 20).forEach(t => lines.push(' - ' + t)); if (targets.length > 20) lines.push(' ... and ' + (targets.length - 20) + ' more'); } const rerun = out.outputSuggestedRerun || diag.suggestedRerun || ''; if (rerun) lines.push('- Rerun: `' + rerun + '`'); const hint = out.outputHint || diag.hint || ''; if (hint) lines.push('- Hint: ' + hint); if (diag.deltaSummary) lines.push('- Delta: ' + diag.deltaSummary); lines.push(''); lines.push('Full output:'); lines.push(String(out.output || '').slice(0, 8000)); return lines.join('\\n'); } const v1 = $ctx.getNodeOutput('pre-pr-validation') || {}; const v2 = $ctx.getNodeOutput('retry-pre-pr-validation') || {}; return [ '## Validation History (both passes failed)', '', summarizeRun('Pass 1 — Original Validation', v1), '', summarizeRun('Pass 2 — After First Auto-Fix', v2), ].join('\\n'); })()", - "isExpression": true - }, - "position": { - "x": 500, - "y": 2300 - }, - "outputs": [ - "default" - ] - }, - { - "id": "auto-fix-validation-2", - "type": "action.run_agent", - "label": "Auto-Fix Validation (Pass 2 — Escalated)", - "config": { - "prompt": "# Fix Validation Failures — FINAL AUTOMATED ATTEMPT\n\nThis is the SECOND and LAST automated remediation pass for task **{{taskTitle}}**.\nThe first auto-fix attempt DID NOT resolve all issues. You MUST take a different approach.\n\n{{fix2Summary}}\n\nANALYSIS STEPS:\n1. Compare the **Failed Targets** between Pass 1 and Pass 2.\n - If the SAME targets still fail → your previous fix was wrong. Revert it and try a different approach.\n - If NEW targets appeared → your fix broke something else. Fix both.\n - If some targets were RESOLVED → the approach was partially right. Focus on the remaining ones.\n2. Use the **Delta** field (if present) to see exactly what changed between runs.\n3. Use the **Suggested Rerun Command** to iterate on just the failing targets.\n\nCRITICAL RULES:\n- Do NOT repeat the same fix that already failed.\n- If a test is genuinely wrong or testing stale behavior your change invalidated, fix the test AND the code.\n- If the build/lint/test commands are misconfigured for your changes, fix the config.\n- Do NOT weaken, remove, or skip tests. Do NOT add --force or --no-verify flags.\n- Keep the original task scope — do not revert the feature.\n\nRun the full validation command locally and confirm ALL checks pass before finishing.\nCreate a descriptive commit: \"fix: \"", - "taskId": "{{taskId}}", - "sdk": "{{resolvedSdk}}", - "model": "{{resolvedModel}}", - "agentProfile": "{{agentProfile}}", - "cwd": "{{worktreePath}}", - "timeoutMs": "{{taskTimeoutMs}}", - "maxRetries": "{{maxRetries}}", - "maxContinues": "{{maxContinues}}", - "resolveMode": "library", - "failOnError": false - }, - "position": { - "x": 500, - "y": 2380 - }, - "outputs": [ - "default" - ] - }, - { - "id": "retry2-pre-pr-validation", - "type": "action.run_command", - "label": "Retry-2 Pre-PR Validation", - "config": { - "command": "{{prePrValidationCommand}}", - "commandType": "qualityGate", - "cwd": "{{worktreePath}}", - "failOnError": false - }, - "position": { - "x": 500, - "y": 2460 - }, - "outputs": [ - "default" - ] - }, - { - "id": "retry2-validation-ok", - "type": "condition.expression", - "label": "Retry-2 Validation Passed?", - "config": { - "expression": "(() => {const enabled = $data?.prePrValidationEnabled !== false;if (!enabled) return true;const out = $ctx.getNodeOutput('retry2-pre-pr-validation');if (!out) return false;if (out.success === true) return true;const code = Number(out.exitCode);return Number.isFinite(code) && code === 0;})()" - }, - "position": { - "x": 500, - "y": 2540 - }, - "outputs": [ - "yes", - "no" - ] - }, { "id": "log-validation-failed", "type": "notify.log", "label": "Log Validation Failed", "config": { - "message": "Task \"{{taskTitle}}\" ({{taskId}}) — pre-PR validation failed after 2 auto-fix remediation passes, blocking task", + "message": "Task \"{{taskTitle}}\" ({{taskId}}) — pre-PR validation failed, returning to todo", "level": "warn" }, "position": { - "x": 700, - "y": 2600 + "x": 300, + "y": 2000 }, "outputs": [ "default" ] }, { - "id": "set-blocked-validation-failed", + "id": "set-todo-validation-failed", "type": "action.update_task_status", - "label": "Block Task (Validation Fail)", + "label": "Set Todo (Validation Fail)", "config": { "taskId": "{{taskId}}", - "status": "blocked", - "taskTitle": "{{taskTitle}}", - "blockedReason": "Pre-PR validation failed after 2 automated remediation passes" - }, - "position": { - "x": 700, - "y": 2680 - }, - "outputs": [ - "default" - ] - }, - { - "id": "notify-validation-blocked", - "type": "notify.telegram", - "label": "Notify Validation Blocked", - "config": { - "message": ":alert: Task \"{{taskTitle}}\" blocked — pre-PR validation failed after 2 automated remediation attempts. Manual review needed." + "status": "todo", + "taskTitle": "{{taskTitle}}" }, "position": { - "x": 700, - "y": 2760 + "x": 300, + "y": 2130 }, "outputs": [ "default" @@ -46718,9 +38731,6 @@ "branch": "{{branch}}", "baseBranch": "{{baseBranch}}", "rebaseBeforePush": true, - "mergeBaseBeforePush": true, - "autoResolveMergeConflicts": true, - "conflictResolverSdk": "auto", "emptyDiffGuard": true, "protectedBranches": "{{protectedBranches}}" }, @@ -46893,40 +38903,6 @@ "default" ] }, - { - "id": "push-failure-blocking", - "type": "condition.expression", - "label": "Push Failure Blocks?", - "config": { - "expression": "$ctx.getNodeOutput('push-branch')?.implementationDone === true" - }, - "position": { - "x": 360, - "y": 2195 - }, - "outputs": [ - "yes", - "no" - ] - }, - { - "id": "set-blocked-push-failed", - "type": "action.update_task_status", - "label": "Set Blocked (Push Fail)", - "config": { - "taskId": "{{taskId}}", - "status": "blocked", - "taskTitle": "{{taskTitle}}", - "blockedReason": "{{$ctx.getNodeOutput('push-branch')?.blockedReason || $ctx.getNodeOutput('push-branch')?.error || 'implementation_done_commit_blocked'}}" - }, - "position": { - "x": 360, - "y": 2325 - }, - "outputs": [ - "default" - ] - }, { "id": "create-pr-retry", "type": "action.create_pr", @@ -47065,9 +39041,8 @@ "sourceNodeIds": [ "log-success", "set-todo-push-failed", - "set-blocked-push-failed", "set-todo-cooldown", - "notify-validation-blocked", + "set-todo-validation-failed", "set-todo-stolen", "log-claim-stolen-recovered" ], @@ -47179,7 +39154,7 @@ "type": "condition.expression", "label": "Non-Retryable WT Failure?", "config": { - "expression": "(() => { const retry = $ctx.getNodeOutput('retry-acquire-wt'); const latest = retry && retry.success === false ? retry : $ctx.getNodeOutput('acquire-worktree'); return latest?.retryable === false; })()" + "expression": "$ctx.getNodeOutput('acquire-worktree')?.retryable === false" }, "position": { "x": 600, @@ -47197,8 +39172,7 @@ "config": { "taskId": "{{taskId}}", "status": "blocked", - "taskTitle": "{{taskTitle}}", - "blockedReason": "{{$ctx.getNodeOutput('retry-acquire-wt')?.success === false ? ($ctx.getNodeOutput('retry-acquire-wt')?.blockedReason || $ctx.getNodeOutput('retry-acquire-wt')?.error || '') : ($ctx.getNodeOutput('acquire-worktree')?.blockedReason || $ctx.getNodeOutput('acquire-worktree')?.error || '')}}" + "taskTitle": "{{taskTitle}}" }, "position": { "x": 470, @@ -47217,9 +39191,9 @@ "args": { "taskId": "{{taskId}}", "fields": { - "cooldownUntil": "{{(() => { const retry = $ctx.getNodeOutput('retry-acquire-wt'); const output = retry && retry.success === false ? retry : ($ctx.getNodeOutput('acquire-worktree') || {}); return output.retryAt || null; })()}}", - "blockedReason": "{{(() => { const retry = $ctx.getNodeOutput('retry-acquire-wt'); const output = retry && retry.success === false ? retry : ($ctx.getNodeOutput('acquire-worktree') || {}); return output.blockedReason || output.error || null; })()}}", - "meta": "{{(() => { const current = ($data.meta && typeof $data.meta === 'object') ? $data.meta : (($data.taskMeta && typeof $data.taskMeta === 'object') ? $data.taskMeta : {}); const retry = $ctx.getNodeOutput('retry-acquire-wt'); const output = retry && retry.success === false ? retry : ($ctx.getNodeOutput('acquire-worktree') || {}); const worktreePath = output.worktreePath || $data.worktreePath || ''; const repoRoot = $data.repoRoot || $data.workspace || current.repoRoot || current.workspace || ''; const branch = $data.branch || $data.branchName || current.branch || current.branchName || ''; const baseBranch = $data.baseBranch || current.baseBranch || ''; const defaultTargetBranch = $data.defaultTargetBranch || current.defaultTargetBranch || ''; return { ...current, autoRecovery: { active: true, reason: 'worktree_failure', failureKind: output.failureKind || 'branch_refresh_conflict', retryAt: output.retryAt || null, recoveryDelayMs: output.autoRecoverDelayMs || null, error: output.error || '', recordedAt: output.recordedAt || null }, worktreeFailure: { failureKind: output.failureKind || 'branch_refresh_conflict', retryable: output.retryable !== false, retryAt: output.retryAt || null, blockedReason: output.blockedReason || output.error || '', error: output.error || '', recordedAt: output.recordedAt || null, repairArtifacts: output.repairArtifacts || null, branch, repoRoot, baseBranch, defaultTargetBranch, worktreePath } }; })()}}" + "cooldownUntil": "{{acquire-worktree.retryAt}}", + "blockedReason": "{{acquire-worktree.blockedReason}}", + "meta": "{{(() => { const current = ($data.taskMeta && typeof $data.taskMeta === 'object') ? $data.taskMeta : {}; const output = $ctx.getNodeOutput('acquire-worktree') || {}; return { ...current, autoRecovery: { active: true, reason: 'worktree_failure', failureKind: output.failureKind || 'branch_refresh_conflict', retryAt: output.retryAt || null, recoveryDelayMs: output.autoRecoverDelayMs || null, error: output.error || '', recordedAt: output.recordedAt || null }, worktreeFailure: { failureKind: output.failureKind || 'branch_refresh_conflict', retryable: output.retryable !== false, retryAt: output.retryAt || null, blockedReason: output.blockedReason || '', error: output.error || '', recordedAt: output.recordedAt || null, repairArtifacts: output.repairArtifacts || null } }; })()}}" } } }, @@ -47231,34 +39205,6 @@ "default" ] }, - { - "id": "dispatch-wt-repair", - "type": "action.execute_workflow", - "label": "Dispatch WT Repair", - "config": { - "workflowId": "template-task-repair-worktree", - "mode": "dispatch", - "input": { - "taskId": "{{taskId}}", - "taskTitle": "{{taskTitle}}", - "repoRoot": "{{repoRoot}}", - "worktreePath": "{{$ctx.getNodeOutput('retry-acquire-wt')?.success === false ? ($ctx.getNodeOutput('retry-acquire-wt')?.worktreePath || $data.worktreePath || '') : ($ctx.getNodeOutput('acquire-worktree')?.worktreePath || $data.worktreePath || '')}}", - "branch": "{{branch}}", - "baseBranch": "{{baseBranch}}", - "defaultTargetBranch": "{{defaultTargetBranch}}", - "error": "{{$ctx.getNodeOutput('retry-acquire-wt')?.success === false ? ($ctx.getNodeOutput('retry-acquire-wt')?.error || $ctx.getNodeOutput('retry-acquire-wt')?.blockedReason || 'worktree acquisition failed') : ($ctx.getNodeOutput('acquire-worktree')?.error || $ctx.getNodeOutput('acquire-worktree')?.blockedReason || 'worktree acquisition failed')}}", - "failureKind": "{{$ctx.getNodeOutput('retry-acquire-wt')?.success === false ? ($ctx.getNodeOutput('retry-acquire-wt')?.failureKind || 'branch_refresh_conflict') : ($ctx.getNodeOutput('acquire-worktree')?.failureKind || 'branch_refresh_conflict')}}", - "repairArtifacts": "{{$ctx.getNodeOutput('retry-acquire-wt')?.success === false ? ($ctx.getNodeOutput('retry-acquire-wt')?.repairArtifacts || null) : ($ctx.getNodeOutput('acquire-worktree')?.repairArtifacts || null)}}" - } - }, - "position": { - "x": 470, - "y": 1610 - }, - "outputs": [ - "default" - ] - }, { "id": "set-todo-wt-failed", "type": "action.update_task_status", @@ -47296,7 +39242,7 @@ "type": "notify.telegram", "label": "Notify WT Failed", "config": { - "message": "⚠️ Worktree failed for \"{{taskTitle}}\" ({{taskId}}){{$ctx.getNodeOutput('retry-acquire-wt')?.success === false ? ($ctx.getNodeOutput('retry-acquire-wt')?.recoveryNote || '') : ($ctx.getNodeOutput('acquire-worktree')?.recoveryNote || '')}}" + "message": "⚠️ Worktree failed for \"{{taskTitle}}\" ({{taskId}}){{acquire-worktree.recoveryNote}}" }, "position": { "x": 600, @@ -47531,91 +39477,21 @@ "condition": "$output?.result === true" }, { - "id": "pre-pr-validation-ok->set-fix-summary", + "id": "pre-pr-validation-ok->log-validation-failed", "source": "pre-pr-validation-ok", - "target": "set-fix-summary", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "set-fix-summary->auto-fix-validation", - "source": "set-fix-summary", - "target": "auto-fix-validation", - "sourcePort": "default" - }, - { - "id": "auto-fix-validation->retry-pre-pr-validation", - "source": "auto-fix-validation", - "target": "retry-pre-pr-validation", - "sourcePort": "default" - }, - { - "id": "retry-pre-pr-validation->retry-validation-ok", - "source": "retry-pre-pr-validation", - "target": "retry-validation-ok", - "sourcePort": "default" - }, - { - "id": "retry-validation-ok->push-branch", - "source": "retry-validation-ok", - "target": "push-branch", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "retry-validation-ok->set-fix2-summary", - "source": "retry-validation-ok", - "target": "set-fix2-summary", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "set-fix2-summary->auto-fix-validation-2", - "source": "set-fix2-summary", - "target": "auto-fix-validation-2", - "sourcePort": "default" - }, - { - "id": "auto-fix-validation-2->retry2-pre-pr-validation", - "source": "auto-fix-validation-2", - "target": "retry2-pre-pr-validation", - "sourcePort": "default" - }, - { - "id": "retry2-pre-pr-validation->retry2-validation-ok", - "source": "retry2-pre-pr-validation", - "target": "retry2-validation-ok", - "sourcePort": "default" - }, - { - "id": "retry2-validation-ok->push-branch", - "source": "retry2-validation-ok", - "target": "push-branch", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "retry2-validation-ok->log-validation-failed", - "source": "retry2-validation-ok", "target": "log-validation-failed", "sourcePort": "no", "condition": "$output?.result !== true" }, { - "id": "log-validation-failed->set-blocked-validation-failed", + "id": "log-validation-failed->set-todo-validation-failed", "source": "log-validation-failed", - "target": "set-blocked-validation-failed", - "sourcePort": "default" - }, - { - "id": "set-blocked-validation-failed->notify-validation-blocked", - "source": "set-blocked-validation-failed", - "target": "notify-validation-blocked", + "target": "set-todo-validation-failed", "sourcePort": "default" }, { - "id": "notify-validation-blocked->join-outcomes", - "source": "notify-validation-blocked", + "id": "set-todo-validation-failed->join-outcomes", + "source": "set-todo-validation-failed", "target": "join-outcomes", "sourcePort": "default" }, @@ -47671,32 +39547,12 @@ "sourcePort": "default" }, { - "id": "push-ok->push-failure-blocking", + "id": "push-ok->set-todo-push-failed", "source": "push-ok", - "target": "push-failure-blocking", - "sourcePort": "no", - "condition": "$output?.result !== true" - }, - { - "id": "push-failure-blocking->set-blocked-push-failed", - "source": "push-failure-blocking", - "target": "set-blocked-push-failed", - "sourcePort": "yes", - "condition": "$output?.result === true" - }, - { - "id": "push-failure-blocking->set-todo-push-failed", - "source": "push-failure-blocking", "target": "set-todo-push-failed", "sourcePort": "no", "condition": "$output?.result !== true" }, - { - "id": "set-blocked-push-failed->join-outcomes", - "source": "set-blocked-push-failed", - "target": "join-outcomes", - "sourcePort": "default" - }, { "id": "set-todo-push-failed->join-outcomes", "source": "set-todo-push-failed", @@ -47890,14 +39746,8 @@ "sourcePort": "default" }, { - "id": "annotate-blocked-wt-failed->dispatch-wt-repair", + "id": "annotate-blocked-wt-failed->release-slot-wt-failed", "source": "annotate-blocked-wt-failed", - "target": "dispatch-wt-repair", - "sourcePort": "default" - }, - { - "id": "dispatch-wt-repair->release-slot-wt-failed", - "source": "dispatch-wt-repair", "target": "release-slot-wt-failed", "sourcePort": "default" }, @@ -47921,8 +39771,8 @@ "templateState": { "templateId": "template-task-lifecycle", "templateName": "Task Lifecycle", - "templateVersion": "4.0.0", - "installedTemplateVersion": "4.0.0", + "templateVersion": "2.1.0", + "installedTemplateVersion": "2.1.0", "isCustomized": false, "updateAvailable": false } @@ -48280,7 +40130,7 @@ "workflowId": "wf-bosun-pr-progressor", "workflowName": "Bosun PR Progressor", "status": "completed", - "nodeCount": 17, + "nodeCount": 13, "duration": 20000, "errorCount": 0, "triggerSource": "manual", @@ -48292,7 +40142,7 @@ "workflowId": "wf-bosun-pr-watchdog", "workflowName": "Bosun PR Watchdog", "status": "completed", - "nodeCount": 23, + "nodeCount": 19, "duration": 29000, "errorCount": 0, "triggerSource": "manual", @@ -48313,10 +40163,10 @@ }, { "runId": "run-004", - "workflowId": "wf-github-check-failure", - "workflowName": "GitHub Check Failure Handler", + "workflowId": "wf-pr-conflict-resolver", + "workflowName": "PR Conflict Resolver", "status": "completed", - "nodeCount": 5, + "nodeCount": 11, "duration": 47000, "errorCount": 0, "triggerSource": "manual", @@ -48325,10 +40175,10 @@ }, { "runId": "run-005", - "workflowId": "wf-github-pr-event-handler", - "workflowName": "GitHub PR Event Handler", + "workflowId": "wf-pr-merge-strategy", + "workflowName": "PR Merge Strategy", "status": "failed", - "nodeCount": 9, + "nodeCount": 20, "duration": 56000, "errorCount": 1, "triggerSource": "manual", @@ -48337,10 +40187,10 @@ }, { "runId": "run-006", - "workflowId": "wf-pr-conflict-resolver", - "workflowName": "PR Conflict Resolver", + "workflowId": "wf-pr-triage", + "workflowName": "PR Triage & Labels", "status": "completed", - "nodeCount": 11, + "nodeCount": 10, "duration": 65000, "errorCount": 0, "triggerSource": "manual", @@ -48349,10 +40199,10 @@ }, { "runId": "run-007", - "workflowId": "wf-pr-fix-single", - "workflowName": "PR Fix Agent (Single PR)", + "workflowId": "wf-release-drafter", + "workflowName": "Release Drafter", "status": "completed", - "nodeCount": 11, + "nodeCount": 7, "duration": 74000, "errorCount": 0, "triggerSource": "manual", @@ -48361,10 +40211,10 @@ }, { "runId": "run-008", - "workflowId": "wf-pr-merge-strategy", - "workflowName": "PR Merge Strategy", + "workflowId": "wf-review-agent", + "workflowName": "Review Agent", "status": "completed", - "nodeCount": 20, + "nodeCount": 6, "duration": 83000, "errorCount": 0, "triggerSource": "manual", @@ -50039,7 +41889,7 @@ ], "libraryContents": { "orchestrator": "# Task Orchestrator Agent\n\nYou are an autonomous task orchestrator agent. You receive implementation tasks and execute them end-to-end.\n\n## Prime Directives\n\n1. Never ask for human input for normal engineering decisions.\n2. Complete the assigned scope fully before stopping.\n3. Keep changes minimal, correct, and production-safe.\n4. Run relevant verification (tests/lint/build) before finalizing.\n5. Use conventional commit messages.\n\n## Code Quality — Hard Rules\n\nThese rules are non-negotiable. Violations cause real production crashes.\n\n- **Module-scope caching:** Variables that cache state (lazy singletons, loaded\n flags, memoization maps) MUST be at module scope, never inside a function body\n that runs repeatedly.\n- **Async safety:** NEVER use bare `void asyncFn()`. Every async call must be\n `await`-ed or have a `.catch()` handler. Unhandled rejections crash Node.js.\n- **Error boundaries:** HTTP handlers, timers, and event callbacks MUST wrap async\n work in try/catch so one failure doesn't kill the process.\n- **No over-mocking in tests:** Mock only external boundaries (network, disk, clock).\n Never mock the module under test. If a test needs > 3 mocks, refactor the code.\n- **Deterministic tests:** No `Math.random()`, real network calls, or `setTimeout`\n for synchronization. Tests must be reproducible and order-independent.\n- **Dynamic `import()` must be cached:** Never place `import()` inside a\n frequently-called function without caching the result at module scope.\n\n## Completion Criteria\n\n- Implementation matches requested behavior.\n- Existing functionality is preserved.\n- Relevant checks pass.\n- Branch is pushed and ready for PR/review flow.\n\n## Skills & Knowledge Base\n\nBefore starting any task, load relevant skills to avoid known pitfalls and\napply patterns discovered by previous agents:\n\n1. Check if `.bosun/skills/index.json` exists in the workspace or bosun home.\n2. Read the index to find skills whose tags match your task's module or domain.\n3. Load and apply any matching skill files from `.bosun/skills/`.\n\nAfter completing a task, if you discovered a non-obvious pattern, workaround, or\ndomain-specific fact, write or update a skill file at `.bosun/skills/.md`\nso the next agent benefits from your investigation.\n", - "taskexecutor": "# {{TASK_ID}} — {{TASK_TITLE}}\n\n## Description\n{{TASK_DESCRIPTION}}\n{{TASK_CONTEXT}}\n\n## Environment\n- Working Directory: {{WORKTREE_PATH}}\n- Branch: {{BRANCH}}\n- Repository: {{REPO_SLUG}}\n\n## Skills — Load Before Starting\n\nCheck for relevant skills before implementing:\n1. Look for `.bosun/skills/index.json` (in workspace root or BOSUN_HOME).\n2. Read the index; load skills whose tags match this task's module/domain.\n3. Apply the patterns — especially `background-task-execution`, `error-recovery`,\n and `pr-workflow` which apply to almost every task.\n\n## Instructions\n1. Load relevant skills as described above.\n2. Read task requirements carefully.\n3. Implement required code changes.\n4. Run relevant tests/lint/build checks.\n5. Commit with conventional commit format.\n6. Push branch updates.\n7. After completing: if you discovered non-obvious patterns, write a skill file\n at `.bosun/skills/.md` for future agents.\n\n## Critical Rules\n- Do not ask for manual confirmation.\n- No placeholders/stubs/TODO-only output.\n- Keep behavior stable and production-safe.\n\n## Code Quality — Mandatory Checks\n\nThese patterns have caused real production crashes. Treat them as hard rules:\n\n1. **Module-scope caching:** If you declare variables that cache state (lazy\n singletons, init flags, memoization), place them at **module scope** — never\n inside a function body that runs per-request or per-event.\n2. **Async fire-and-forget:** Never use bare `void asyncFn()`. Always `await`\n or append `.catch()`. Unhandled promise rejections crash Node.js (exit 1).\n3. **Error boundaries:** Wrap HTTP handlers, timers, and event callbacks in\n top-level try/catch. One unguarded throw must not kill the process.\n4. **Dynamic imports:** Cache `import()` results at module scope. Never call\n `import()` inside a hot path without caching — it causes repeated I/O.\n5. **Test quality:** Mock only external boundaries (network, disk, clock). Never\n mock the module under test. No `setTimeout`/`sleep` for synchronization.\n Tests must be deterministic and order-independent. Assert on behavior, not\n implementation details.\n6. **No architectural shortcuts:** Don't force-enable feature flags inline. Don't\n add config overrides that bypass safety checks. If a feature is behind a flag,\n respect it.\n\n## Bosun Task Agent — Git & Bosun Lifecycle Workflow\n\nYou are running as a **Bosun-managed task agent**. Environment variables\n`BOSUN_TASK_TITLE`, `BOSUN_BRANCH_NAME`, `BOSUN_TASK_ID`, and their\n`VE_*` / `VK_*` aliases are available in your environment.\n\n**Before committing:**\n- Run auto-formatting tools (gofmt, prettier, etc.) relevant to changed files.\n- Fix any lint or vet warnings introduced by your changes.\n\n**After committing:**\n- If a precommit hook auto-applies additional formatting changes, add those\n to a follow-up commit before finishing.\n- Merge any upstream changes — BOTH from the base (module) branch AND from main:\n `git fetch origin && git merge origin/ --no-edit && git merge origin/main --no-edit`\n Resolve any conflicts that arise before handing off.\n- Run local validation, including the repository pre-push quality gate, before handing off.\n- Do not push directly. Bosun workflow automation will perform the validated push and PR lifecycle handoff.\n- Do not run direct PR commands.\n{{COAUTHOR_INSTRUCTION}}\n**Do NOT:**\n- Push branches directly from the agent session.\n- Bypass pre-push hooks (`git push --no-verify` is forbidden).\n- Use `git add .` — stage files individually.\n- Wait for user confirmation before handing off lifecycle state.\n\n## Agent Status Endpoint\n- URL: http://127.0.0.1:{{ENDPOINT_PORT}}/api/tasks/{{TASK_ID}}\n- POST /status {\"status\":\"inreview\"} after push + Bosun lifecycle handoff readiness\n- POST /heartbeat {} while running\n- POST /error {\"error\":\"...\"} on fatal failure\n- POST /complete {\"hasCommits\":true} when done\n\n## Task Reference\n{{TASK_URL_LINE}}\n\n## Repository Context\n{{REPO_CONTEXT}}\n", + "taskexecutor": "# {{TASK_ID}} — {{TASK_TITLE}}\n\n## Description\n{{TASK_DESCRIPTION}}\n{{TASK_CONTEXT}}\n\n## Environment\n- Working Directory: {{WORKTREE_PATH}}\n- Branch: {{BRANCH}}\n- Repository: {{REPO_SLUG}}\n\n## Skills — Load Before Starting\n\nCheck for relevant skills before implementing:\n1. Look for `.bosun/skills/index.json` (in workspace root or BOSUN_HOME).\n2. Read the index; load skills whose tags match this task's module/domain.\n3. Apply the patterns — especially `background-task-execution`, `error-recovery`,\n and `pr-workflow` which apply to almost every task.\n\n## Instructions\n1. Load relevant skills as described above.\n2. Read task requirements carefully.\n3. Implement required code changes.\n4. Run relevant tests/lint/build checks.\n5. Commit with conventional commit format.\n6. Push branch updates.\n7. After completing: if you discovered non-obvious patterns, write a skill file\n at `.bosun/skills/.md` for future agents.\n\n## Critical Rules\n- Do not ask for manual confirmation.\n- No placeholders/stubs/TODO-only output.\n- Keep behavior stable and production-safe.\n\n## Code Quality — Mandatory Checks\n\nThese patterns have caused real production crashes. Treat them as hard rules:\n\n1. **Module-scope caching:** If you declare variables that cache state (lazy\n singletons, init flags, memoization), place them at **module scope** — never\n inside a function body that runs per-request or per-event.\n2. **Async fire-and-forget:** Never use bare `void asyncFn()`. Always `await`\n or append `.catch()`. Unhandled promise rejections crash Node.js (exit 1).\n3. **Error boundaries:** Wrap HTTP handlers, timers, and event callbacks in\n top-level try/catch. One unguarded throw must not kill the process.\n4. **Dynamic imports:** Cache `import()` results at module scope. Never call\n `import()` inside a hot path without caching — it causes repeated I/O.\n5. **Test quality:** Mock only external boundaries (network, disk, clock). Never\n mock the module under test. No `setTimeout`/`sleep` for synchronization.\n Tests must be deterministic and order-independent. Assert on behavior, not\n implementation details.\n6. **No architectural shortcuts:** Don't force-enable feature flags inline. Don't\n add config overrides that bypass safety checks. If a feature is behind a flag,\n respect it.\n\n## Bosun Task Agent — Git & Bosun Lifecycle Workflow\n\nYou are running as a **Bosun-managed task agent**. Environment variables\n`BOSUN_TASK_TITLE`, `BOSUN_BRANCH_NAME`, `BOSUN_TASK_ID`, and their\n`VE_*` / `VK_*` aliases are available in your environment.\n\n**Before committing:**\n- Run auto-formatting tools (gofmt, prettier, etc.) relevant to changed files.\n- Fix any lint or vet warnings introduced by your changes.\n\n**After committing:**\n- If a precommit hook auto-applies additional formatting changes, add those\n to a follow-up commit before pushing.\n- Merge any upstream changes — BOTH from the base (module) branch AND from main:\n `git fetch origin && git merge origin/ --no-edit && git merge origin/main --no-edit`\n Resolve any conflicts that arise before pushing.\n- Push: `git push --set-upstream origin {{BRANCH}}`\n- After a successful push, hand off PR lifecycle to Bosun management.\n- Do not run direct PR commands.\n{{COAUTHOR_INSTRUCTION}}\n**Do NOT:**\n- Bypass pre-push hooks (`git push --no-verify` is forbidden).\n- Use `git add .` — stage files individually.\n- Wait for user confirmation before pushing or handing off lifecycle state.\n\n## Agent Status Endpoint\n- URL: http://127.0.0.1:{{ENDPOINT_PORT}}/api/tasks/{{TASK_ID}}\n- POST /status {\"status\":\"inreview\"} after push + Bosun lifecycle handoff readiness\n- POST /heartbeat {} while running\n- POST /error {\"error\":\"...\"} on fatal failure\n- POST /complete {\"hasCommits\":true} when done\n\n## Task Reference\n{{TASK_URL_LINE}}\n\n## Repository Context\n{{REPO_CONTEXT}}\n", "taskexecutorretry": "# {{TASK_ID}} — ERROR RECOVERY (Attempt {{ATTEMPT_NUMBER}})\n\nYour previous attempt on task \"{{TASK_TITLE}}\" encountered an issue:\n\n```\n{{LAST_ERROR}}\n```\n\nError classification: {{CLASSIFICATION_PATTERN}} (confidence: {{CLASSIFICATION_CONFIDENCE}})\n\nPlease:\n1. Diagnose the failure root cause.\n2. Fix the issue with minimal safe changes.\n3. Re-run verification checks.\n4. Commit and push the fix.\n\nOriginal task description:\n{{TASK_DESCRIPTION}}\n{{TASK_CONTEXT}}\n", "taskexecutorcontinuehascommits": "# {{TASK_ID}} — CONTINUE (Verify and Push)\n\nYou were working on \"{{TASK_TITLE}}\" and appear to have stopped.\nYou already made commits.\n\n1. Run tests to verify changes.\n2. If passing, push: git push origin HEAD\n3. If failing, fix issues, commit, and push.\n4. Task is not complete until push succeeds.\n{{TASK_CONTEXT}}\n", "taskexecutorcontinuehasedits": "# {{TASK_ID}} — CONTINUE (Commit and Push)\n\nYou were working on \"{{TASK_TITLE}}\" and appear to have stopped.\nYou made file edits but no commit yet.\n\n1. Review edits for correctness.\n2. Run relevant tests.\n3. Commit with conventional format.\n4. Push: git push origin HEAD\n{{TASK_CONTEXT}}\n", diff --git a/site/ui/demo.html b/site/ui/demo.html index 1f30d54b6..dd02a8355 100644 --- a/site/ui/demo.html +++ b/site/ui/demo.html @@ -6641,12 +6641,6 @@ globalThis.removeEventListener('bosun:app-mounted', handleMounted); }); - // If app.js already mounted before this listener was registered, clear the timeout now - if (globalThis.__bosunAppMounted) { - bootReady = true; - clearTimeout(bootTimeoutId); - } - var appModuleScript = document.getElementById('app-module'); appModuleScript?.addEventListener('error', function () { clearTimeout(bootTimeoutId); diff --git a/site/ui/index.html b/site/ui/index.html index 8645d5cf4..65cdef29a 100644 --- a/site/ui/index.html +++ b/site/ui/index.html @@ -1,15 +1,13 @@ - - + Bosun — Task Orchestrator - <${ChatInputAreaMemo} - key=${sessionId || "__no_session__"} - inputAreaRef=${inputAreaRef} - textareaRef=${textareaRef} - fileInputRef=${fileInputRef} - sessionId=${sessionId} - sending=${sending} - stoppingAgent=${stoppingAgent} - pendingAttachments=${pendingAttachments} - uploadingAttachments=${uploadingAttachments} - dragActive=${dragActive} - queueCount=${queueCount} - allCommands=${allCommands} - onSend=${handleSend} - onAddToQueue=${handleAddToQueue} - onPaste=${handleInputPaste} - onStop=${handleStop} - onStopAndSend=${handleStopAndSend} - onSteerWithMessage=${handleSteerWithMessage} - onAttachFile=${handleAttachmentInput} - removeAttachment=${removeAttachment} - /> + <${Box} className="chat-input-area"> + ${showSlashMenu && + html` + <${SlashMenu} + filter=${slashFilter} + onSelect=${selectSlashCommand} + activeIndex=${slashActiveIdx} + commands=${allCommands} + /> + `} + <${ChatSafeBoundary} label="Agent Toolbar"> + <${ChatInputToolbar} /> + + ${pendingAttachments.length > 0 && html` + <${Stack} direction="row" spacing=${0.5} flexWrap="wrap" className="chat-attachments-pending" sx=${{ px: 1, py: 0.5 }}> + ${pendingAttachments.map((att, index) => html` + <${Chip} + key=${att.id || `${att.name}-${index}`} + label=${`${att.name || "attachment"}${att.size ? ` (${formatAttachmentSize(att.size)})` : ""}`} + onDelete=${() => removeAttachment(index)} + size="small" + variant="outlined" + /> + `)} + ${uploadingAttachments && html` + <${Chip} label="Uploading..." size="small" icon=${html`<${CircularProgress} size=${14} />`} /> + `} + + `} + <${Box} className="chat-input-wrapper" sx=${{ display: "flex", alignItems: "flex-end", gap: 0.5, px: 1, py: 0.5 }}> + <${TextField} + inputRef=${fileInputRef} + type="file" + size="small" + variant="outlined" + inputProps=${{ multiple: true }} + sx=${{ display: "none" }} + onChange=${handleAttachmentInput} + /> + <${IconButton} + size="small" + disabled=${uploadingAttachments} + onClick=${() => fileInputRef.current?.click?.()} + title="Attach file" + > + ${resolveIcon(":link:")} + + <${TextField} + inputRef=${textareaRef} + className=${dragActive ? "chat-input-drag" : ""} + placeholder=${sessionId + ? 'Send a message… (type "/" for commands)' + : 'Start a new chat or type "/" for commands'} + multiline + maxRows=${4} + fullWidth + size="small" + variant="outlined" + value=${inputValue} + onInput=${handleInputChange} + onKeyDown=${handleKeyDown} + onPaste=${handleInputPaste} + sx=${{ "& .MuiOutlinedInput-root": { borderRadius: 2 } }} + /> + <${VoiceMicButton} + disabled=${sending} + title="Live voice mode" + /> + ${activeAgentInfo.value?.busy && !stoppingAgent && html` + <${IconButton} + onClick=${handleStop} + title="Stop agent" + aria-label="Stop agent" + size="small" + color="error" + >⏹ + `} + <${Box} className="chat-send-group" ref=${sendMenuRef} sx=${{ display: "flex", position: "relative" }}> + <${IconButton} + color="primary" + disabled=${(!inputValue.trim() && pendingAttachments.length === 0) || uploadingAttachments} + onClick=${activeAgentInfo.value?.busy ? handleSteerWithMessage : handleSend} + title=${activeAgentInfo.value?.busy ? "Steer with Message (Enter)" : "Send (Enter)"} + size="small" + >➤ + <${IconButton} + size="small" + disabled=${(!inputValue.trim() && pendingAttachments.length === 0) || uploadingAttachments} + onClick=${(e) => { e.stopPropagation(); setShowSendMenu(v => !v); }} + aria-label="Send options" + title="Send options" + >▾ + ${showSendMenu && html` + <${Paper} elevation=${4} className="chat-send-menu" sx=${{ position: "absolute", bottom: "100%", right: 0, minWidth: 200, borderRadius: 2, overflow: "hidden", zIndex: 10 }}> + <${List} dense disablePadding> + <${ListItemButton} onClick=${handleStopAndSend}> + <${ListItemIcon} sx=${{ minWidth: 28 }}>⊳ + <${ListItemText} primary="Stop and Send" /> + + <${ListItemButton} onClick=${handleAddToQueue}> + <${ListItemIcon} sx=${{ minWidth: 28 }}>+ + <${ListItemText} primary="Add to Queue" secondary="Alt+Enter" /> + + <${ListItemButton} selected onClick=${handleSteerWithMessage}> + <${ListItemIcon} sx=${{ minWidth: 28 }}>→ + <${ListItemText} primary="Steer with Message" secondary="Enter" /> + + + + `} + + + <${Stack} direction="row" spacing=${1} className="chat-input-hint" sx=${{ px: 1.5, py: 0.5 }}> + <${Typography} variant="caption" color="text.secondary">Shift+Enter for new line + <${Typography} variant="caption" color="text.secondary">Type / for commands + ${offlineQueueSize.peek() > 0 && html` + <${Chip} label=${`${offlineQueueSize.peek()} queued`} size="small" color="warning" variant="outlined" /> + `} + ${queueCount > 0 && html` + <${Chip} label=${`⏳ ${queueCount} pending`} size="small" color="info" variant="outlined" /> + `} + + ${dragActive && html` <${Box} className="chat-drop-overlay" diff --git a/site/ui/tabs/dashboard.js b/site/ui/tabs/dashboard.js index c7bbd4a1a..81caf09d2 100644 --- a/site/ui/tabs/dashboard.js +++ b/site/ui/tabs/dashboard.js @@ -145,14 +145,6 @@ function AnimatedNumber({ value, duration = 600, className = "" }) { return html`${display}`; } -function buildQuickActionLabel(action) { - if (!action) return "Run quick action"; - if (action.action === "create") return "Create a new task"; - if (action.action === "start") return "Start a task"; - if (action.cmd) return `Run ${action.label} command`; - return action.label || "Run quick action"; -} - function normalizeCommitMessage(message) { const text = String(message || "").trim(); if (!text) return ""; @@ -748,8 +740,8 @@ export function DashboardTab() { if (!status && !executor) return html` -
-
+
+
${Array.from({ length: 6 }, (_, i) => html`<${SkeletonCard} key=${i} />`)}
@@ -779,13 +771,13 @@ export function DashboardTab() { return html`
-