@virtengine/openfleet 0.25.0

package/package.json

@@ -0,0 +1,203 @@
+{
+  "name": "@virtengine/openfleet",
+  "version": "0.25.0",
+  "description": "AI-powered orchestrator supervisor — manages AI agent executors with failover, auto-restarts on failure, analyzes crashes with Codex SDK, creates PRs via Vibe-Kanban API, and sends Telegram notifications. Supports N executors with weighted distribution, multi-repo projects, and auto-setup.",
+  "type": "module",
+  "license": "Apache 2.0",
+  "author": "VirtEngine <dev@virtengine.com>",
+  "homepage": "https://github.com/virtengine/virtengine/tree/main/scripts/openfleet",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/virtengine/virtengine.git",
+    "directory": "scripts/openfleet"
+  },
+  "bugs": {
+    "url": "https://github.com/virtengine/virtengine/issues"
+  },
+  "keywords": [
+    "codex",
+    "orchestrator",
+    "monitor",
+    "ai",
+    "automation",
+    "vibe-kanban",
+    "telegram",
+    "devops",
+    "executor",
+    "failover",
+    "copilot",
+    "agent",
+    "openai",
+    "cli"
+  ],
+  "exports": {
+    ".": "./monitor.mjs",
+    "./config": "./config.mjs",
+    "./config-doctor": "./config-doctor.mjs",
+    "./codex-config": "./codex-config.mjs",
+    "./setup": "./setup.mjs",
+    "./autofix": "./autofix.mjs",
+    "./codex-shell": "./codex-shell.mjs",
+    "./copilot-shell": "./copilot-shell.mjs",
+    "./claude-shell": "./claude-shell.mjs",
+    "./primary-agent": "./primary-agent.mjs",
+    "./maintenance": "./maintenance.mjs",
+    "./telegram-bot": "./telegram-bot.mjs",
+    "./ui-server": "./ui-server.mjs",
+    "./workspace-registry": "./workspace-registry.mjs",
+    "./shared-workspace-registry": "./shared-workspace-registry.mjs",
+    "./workspace-reaper": "./workspace-reaper.mjs",
+    "./merge-strategy": "./merge-strategy.mjs",
+    "./restart-controller": "./restart-controller.mjs",
+    "./fleet-coordinator": "./fleet-coordinator.mjs",
+    "./shared-knowledge": "./shared-knowledge.mjs",
+    "./presence": "./presence.mjs",
+    "./vk-log-stream": "./vk-log-stream.mjs",
+    "./session-tracker": "./session-tracker.mjs",
+    "./diff-stats": "./diff-stats.mjs",
+    "./review-agent": "./review-agent.mjs",
+    "./agent-hooks": "./agent-hooks.mjs",
+    "./hook-profiles": "./hook-profiles.mjs",
+    "./agent-hook-bridge": "./agent-hook-bridge.mjs",
+    "./startup-service": "./startup-service.mjs",
+    "./telegram-sentinel": "./telegram-sentinel.mjs",
+    "./whatsapp-channel": "./whatsapp-channel.mjs",
+    "./container-runner": "./container-runner.mjs"
+  },
+  "bin": {
+    "openfleet": "cli.mjs",
+    "openfleet-setup": "setup.mjs",
+    "openfleet-chat-id": "get-telegram-chat-id.mjs",
+    "openfleet-shared-workspaces": "shared-workspace-cli.mjs",
+    "codex-monitor": "cli.mjs",
+    "codex-monitor-setup": "setup.mjs",
+    "codex-monitor-chat-id": "get-telegram-chat-id.mjs",
+    "codex-monitor-shared-workspaces": "shared-workspace-cli.mjs",
+    "vibe-kanban": "vibe-kanban-wrapper.mjs",
+    "telegram-sentinel": "telegram-sentinel.mjs"
+  },
+  "scripts": {
+    "start": "node cli.mjs",
+    "setup": "node setup.mjs",
+    "monitor": "node monitor.mjs",
+    "shared-workspaces": "node shared-workspace-cli.mjs",
+    "syntax:check": "node -e \"const fs=require('fs'),path=require('path');const files=fs.readdirSync('.').filter(f=>f.endsWith('.mjs'));let fail=0;for(const f of files){try{require('child_process').execSync('node --check '+f,{stdio:'pipe'});}catch(e){console.error('Syntax error: '+f);console.error(e.stderr.toString());fail=1;}}if(fail)process.exit(1);console.log('Syntax OK: '+files.length+' files checked');\"",
+    "pretest": "npm run syntax:check",
+    "test": "vitest run --config vitest.config.mjs",
+    "test:watch": "vitest",
+    "postinstall": "node postinstall.mjs",
+    "sentinel": "node telegram-sentinel.mjs",
+    "sentinel:stop": "node -e \"import('./telegram-sentinel.mjs').then(m => m.stopSentinel())\"",
+    "sentinel:status": "node -e \"import('./telegram-sentinel.mjs').then(m => console.log(JSON.stringify(m.getSentinelStatus(), null, 2)))\"",
+    "prepush:check": "npm run syntax:check && npm test",
+    "prepublishOnly": "node prepublish-check.mjs",
+    "publish:env": "node publish.mjs",
+    "publish:dry-run": "node publish.mjs --dry-run"
+  },
+  "files": [
+    ".env.example",
+    "LICENSE",
+    "README.md",
+    "agent-endpoint.mjs",
+    "agent-pool.mjs",
+    "agent-prompts.mjs",
+    "agent-sdk.mjs",
+    "anomaly-detector.mjs",
+    "autofix.mjs",
+    "claude-shell.mjs",
+    "cli.mjs",
+    "codex-config.mjs",
+    "openfleet.config.example.json",
+    "openfleet.schema.json",
+    "codex-model-profiles.mjs",
+    "codex-shell.mjs",
+    "config.mjs",
+    "config-doctor.mjs",
+    "conflict-resolver.mjs",
+    "copilot-shell.mjs",
+    "diff-stats.mjs",
+    "error-detector.mjs",
+    "fetch-runtime.mjs",
+    "fleet-coordinator.mjs",
+    "github-reconciler.mjs",
+    "get-telegram-chat-id.mjs",
+    "git-safety.mjs",
+    "kanban-adapter.mjs",
+    "lib/logger.mjs",
+    "maintenance.mjs",
+    "merge-strategy.mjs",
+    "monitor.mjs",
+    "postinstall.mjs",
+    "pr-cleanup-daemon.mjs",
+    "preflight.mjs",
+    "prepublish-check.mjs",
+    "presence.mjs",
+    "primary-agent.mjs",
+    "repo-root.mjs",
+    "restart-controller.mjs",
+    "review-agent.mjs",
+    "sdk-conflict-resolver.mjs",
+    "session-tracker.mjs",
+    "setup.mjs",
+    "shared-knowledge.mjs",
+    "shared-state-manager.mjs",
+    "shared-workspace-cli.mjs",
+    "shared-workspace-registry.mjs",
+    "shared-workspaces.json",
+    "sync-engine.mjs",
+    "task-archiver.mjs",
+    "task-assessment.mjs",
+    "task-complexity.mjs",
+    "task-claims.mjs",
+    "task-executor.mjs",
+    "task-store.mjs",
+    "telegram-bot.mjs",
+    "ui-server.mjs",
+    "ui/modules/settings-schema.js",
+    "ui/",
+    "update-check.mjs",
+    "utils.mjs",
+    "ve-kanban.mjs",
+    "ve-kanban.ps1",
+    "ve-kanban.sh",
+    "ve-orchestrator.mjs",
+    "ve-orchestrator.ps1",
+    "ve-orchestrator.sh",
+    "rotate-agent-logs.sh",
+    "vibe-kanban-wrapper.mjs",
+    "vk-error-resolver.mjs",
+    "vk-log-stream.mjs",
+    "workspace-monitor.mjs",
+    "workspace-reaper.mjs",
+    "workspace-registry.mjs",
+    "worktree-manager.mjs",
+    "agent-hooks.mjs",
+    "hook-profiles.mjs",
+    "agent-hook-bridge.mjs",
+    "startup-service.mjs",
+    "telegram-sentinel.mjs",
+    "whatsapp-channel.mjs",
+    "container-runner.mjs",
+    "daemon-restart-policy.mjs",
+    "publish.mjs"
+  ],
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "latest",
+    "@github/copilot-sdk": "latest",
+    "@openai/codex-sdk": "latest",
+    "@whiskeysockets/baileys": "^7.0.0-rc.9",
+    "ajv": "^8.18.0",
+    "qrcode-terminal": "^0.12.0",
+    "vibe-kanban": "latest",
+    "ws": "^8.19.0"
+  },
+  "devDependencies": {
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/postinstall.mjs

@@ -0,0 +1,187 @@
+#!/usr/bin/env node
+
+/**
+ * openfleet — Post-Install Environment Validator
+ *
+ * Runs after `npm install` to check for required system dependencies
+ * that can't be installed via npm (git, gh, pwsh) and prints
+ * actionable install instructions for anything missing.
+ *
+ * This is non-blocking — missing optional tools produce warnings,
+ * not errors, so CI installs won't fail.
+ */
+
+import { execSync } from "node:child_process";
+
+const isWin = process.platform === "win32";
+
+// ── Helpers ──────────────────────────────────────────────────────────────────
+
+function commandExists(cmd) {
+  try {
+    execSync(`${isWin ? "where" : "which"} ${cmd}`, { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function getVersion(cmd, flag = "--version") {
+  try {
+    return execSync(`${cmd} ${flag}`, {
+      encoding: "utf8",
+      timeout: 10000,
+      stdio: ["pipe", "pipe", "ignore"],
+    })
+      .trim()
+      .split("\n")[0];
+  } catch {
+    return null;
+  }
+}
+
+// ── Dependency checks ────────────────────────────────────────────────────────
+
+const REQUIRED = [
+  {
+    name: "git",
+    cmd: "git",
+    required: true,
+    install: {
+      win32: "winget install --id Git.Git -e --source winget",
+      darwin: "brew install git",
+      linux: "sudo apt install git  # or: sudo dnf install git",
+    },
+    url: "https://git-scm.com/downloads",
+  },
+];
+
+const RECOMMENDED = [
+  {
+    name: "GitHub CLI (gh)",
+    cmd: "gh",
+    required: false,
+    install: {
+      win32: "winget install --id GitHub.cli -e --source winget",
+      darwin: "brew install gh",
+      linux:
+        "sudo apt install gh  # or: https://github.com/cli/cli/blob/trunk/docs/install_linux.md",
+    },
+    url: "https://cli.github.com/",
+    why: "Required for PR creation, branch management, and GitHub operations",
+  },
+  {
+    name: "GitHub Copilot CLI (copilot)",
+    cmd: "copilot",
+    required: false,
+    install: {
+      win32: "npm install -g @github/copilot",
+      darwin: "npm install -g @github/copilot",
+      linux: "npm install -g @github/copilot",
+    },
+    url: "https://github.com/github/copilot-cli",
+    why: "Required for Copilot SDK primary agent sessions",
+  },
+  {
+    name: "PowerShell (pwsh)",
+    cmd: "pwsh",
+    required: false,
+    install: {
+      win32: "winget install --id Microsoft.PowerShell -e --source winget",
+      darwin: "brew install powershell/tap/powershell",
+      linux:
+        "sudo apt install powershell  # or: https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-linux",
+    },
+    url: "https://github.com/PowerShell/PowerShell",
+    why: isWin
+      ? "Required on Windows for PowerShell orchestrator scripts"
+      : "Optional on macOS/Linux (only needed when using .ps1 orchestrator scripts)",
+  },
+];
+
+// ── Main ─────────────────────────────────────────────────────────────────────
+
+function main() {
+  // Skip in CI environments
+  if (process.env.CI || process.env.CODEX_MONITOR_SKIP_POSTINSTALL) {
+    return;
+  }
+
+  console.log("");
+  console.log("  ┌──────────────────────────────────────────────┐");
+  console.log("  │      openfleet — environment check       │");
+  console.log("  └──────────────────────────────────────────────┘");
+  console.log("");
+
+  const platform = process.platform;
+  let hasErrors = false;
+  let hasWarnings = false;
+
+  // Node.js version check
+  const nodeMajor = Number(process.versions.node.split(".")[0]);
+  if (nodeMajor >= 18) {
+    console.log(`  ✅ Node.js ${process.versions.node}`);
+  } else {
+    console.log(`  ❌ Node.js ${process.versions.node} — requires ≥ 18`);
+    hasErrors = true;
+  }
+
+  // Required tools
+  for (const dep of REQUIRED) {
+    if (commandExists(dep.cmd)) {
+      const ver = getVersion(dep.cmd);
+      console.log(`  ✅ ${dep.name}${ver ? ` (${ver})` : ""}`);
+    } else {
+      console.log(`  ❌ ${dep.name} — REQUIRED`);
+      const hint = dep.install[platform] || dep.install.linux;
+      console.log(`     Install: ${hint}`);
+      console.log(`     Docs:    ${dep.url}`);
+      hasErrors = true;
+    }
+  }
+
+  // Recommended tools
+  for (const dep of RECOMMENDED) {
+    if (commandExists(dep.cmd)) {
+      const ver = getVersion(dep.cmd);
+      console.log(`  ✅ ${dep.name}${ver ? ` (${ver})` : ""}`);
+    } else {
+      console.log(`  ⚠️  ${dep.name} — not found`);
+      console.log(`     ${dep.why}`);
+      const hint = dep.install[platform] || dep.install.linux;
+      console.log(`     Install: ${hint}`);
+      hasWarnings = true;
+    }
+  }
+
+  // npm-installed tools (bundled with this package)
+  console.log(`  ✅ vibe-kanban (bundled)`);
+  console.log(`  ✅ @openai/codex-sdk (bundled)`);
+  console.log(`  ✅ @github/copilot-sdk (bundled)`);
+  console.log(`  ✅ @anthropic-ai/claude-agent-sdk (bundled)`);
+  console.log(`  ✅ @github/copilot-sdk (bundled)`);
+  console.log(`  ✅ @anthropic-ai/claude-agent-sdk (bundled)`);
+
+  // Summary
+  console.log("");
+  if (hasErrors) {
+    console.log(
+      "  ⛔ Missing required dependencies. Install them before running openfleet.",
+    );
+  } else if (hasWarnings) {
+    console.log(
+      "  \u2705 Core dependencies satisfied. Optional tools above unlock full functionality.",
+    );
+  } else {
+    console.log("  \u2705 All dependencies satisfied!");
+  }
+
+  console.log("");
+  console.log("  Get started:");
+  console.log("    openfleet --setup     Interactive setup wizard");
+  console.log("    openfleet             Start with existing config");
+  console.log("    openfleet --help       See all options");
+  console.log("");
+}
+
+main();