agi-farm 1.5.0 → 1.5.2

package/README.md

@@ -686,6 +686,45 @@ The embedded `skills/agi-farm/SKILL.md` provides documentation reference for age
 
 ---
 
+## 🔄 OpenClaw Compatibility
+
+AGI Farm ensures compatibility with OpenClaw through **automated testing** and **proactive monitoring**:
+
+### Automated Compatibility Testing
+- **Weekly testing** against multiple OpenClaw versions (latest, previous, oldest-supported, beta)
+- **Performance benchmarks** to detect regressions (load time, validation time thresholds)
+- **API deprecation scanning** with automated replacement suggestions
+- **Automated PR creation** for compatibility fixes when breaking changes detected
+
+### Supported Versions
+- **Minimum**: OpenClaw 1.0.0+
+- **Tested**: Latest stable + previous stable + beta (when available)
+- **Status**: All compatibility tests run weekly via GitHub Actions
+
+### For Users
+Check compatibility before upgrading OpenClaw:
+```bash
+# Check current OpenClaw version
+openclaw --version
+
+# Run validation
+npm run validate
+
+# View compatibility matrix
+cat OPENCLAW_COMPATIBILITY.md
+```
+
+### For Maintainers
+The enhanced compatibility system includes:
+- Multi-version testing matrix (4 versions tested)
+- Performance regression detection (<5s load time, <3s validation)
+- Automated issue creation when incompatibility detected
+- Optional automated PR generation with suggested fixes
+
+**See:** [OPENCLAW_COMPATIBILITY.md](OPENCLAW_COMPATIBILITY.md) for complete compatibility guide.
+
+---
+
 ## 🤝 Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request.

package/openclaw.plugin.json

@@ -2,10 +2,15 @@
   "id": "agi-farm",
   "kind": "team-orchestration",
   "name": "AGI Farm — Multi-Agent Team Builder",
-  "version": "1.5.0",
+  "version": "1.5.2",
   "description": "Bootstrap complete multi-agent AI teams with auto-dispatcher, live dashboard, and infrastructure. Includes interactive wizard, SOUL.md generation, comms setup, cron registration, and React + SSE ops room.",
   "author": "oabdelmaksoud",
   "homepage": "https://github.com/oabdelmaksoud/AGI-FARM-PLUGIN",
+  "openclawVersion": ">=1.0.0",
+  "engines": {
+    "openclaw": ">=1.0.0",
+    "node": ">=20.0.0"
+  },
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agi-farm",
-  "version": "1.5.0",
+  "version": "1.5.2",
   "description": "Multi-agent AI team builder for OpenClaw — bootstrap complete teams with auto-dispatcher, dashboard, and infrastructure",
   "main": "dist/index.js",
   "type": "module",
@@ -43,6 +43,14 @@
   "engines": {
     "node": ">=20.0.0"
   },
+  "peerDependencies": {
+    "openclaw": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
   "scripts": {
     "build:dashboard": "cd dashboard-react && npm run build",
     "build:all": "npm run build && npm run build:dashboard && rm -rf dashboard-dist && cp -r dashboard-react/dist dashboard-dist",

package/scripts/validate-config.js

@@ -24,7 +24,7 @@ if (isCI) {
   console.log(chalk.cyan('ℹ  Running in CI environment'));
 }
 
-// ── 1. Check OpenClaw Installation ────────────────────────────────────────────
+// ── 1. Check OpenClaw Installation & Version ──────────────────────────────────
 const openclawDir = path.join(os.homedir(), '.openclaw');
 if (!fs.existsSync(openclawDir)) {
   // In CI, OpenClaw won't be installed — treat as warning, not error
@@ -35,6 +35,43 @@ if (!fs.existsSync(openclawDir)) {
   }
 } else {
   console.log(chalk.green('✓ OpenClaw directory found'));
+
+  // Check OpenClaw version
+  try {
+    const openclawVersion = execSync('openclaw --version', { encoding: 'utf-8', stdio: 'pipe' }).trim();
+    console.log(chalk.green(`✓ OpenClaw version: ${openclawVersion}`));
+
+    // Extract version number (e.g., "openclaw/1.2.3" → "1.2.3")
+    const versionMatch = openclawVersion.match(/(\d+\.\d+\.\d+)/);
+    if (versionMatch) {
+      const version = versionMatch[1];
+      const [major, minor, patch] = version.split('.').map(Number);
+
+      // Define minimum compatible OpenClaw version
+      const MIN_OPENCLAW_VERSION = '1.0.0';
+      const [minMajor, minMinor, minPatch] = MIN_OPENCLAW_VERSION.split('.').map(Number);
+
+      // Check if version meets minimum requirement
+      if (major < minMajor || (major === minMajor && minor < minMinor) || (major === minMajor && minor === minMinor && patch < minPatch)) {
+        warnings.push(`OpenClaw ${version} is older than recommended ${MIN_OPENCLAW_VERSION}`);
+        warnings.push('Consider upgrading: npm install -g openclaw@latest');
+      }
+
+      // Check for known incompatible versions
+      const INCOMPATIBLE_VERSIONS = [
+        // Add known incompatible versions here if discovered
+        // e.g., '2.0.0-beta.1'
+      ];
+
+      if (INCOMPATIBLE_VERSIONS.includes(version)) {
+        errors.push(`OpenClaw ${version} has known incompatibilities with AGI Farm`);
+        errors.push('Please upgrade or downgrade OpenClaw');
+      }
+    }
+  } catch (err) {
+    warnings.push('Could not determine OpenClaw version');
+    warnings.push('Ensure openclaw CLI is in PATH');
+  }
 }
 
 // ── 2. Check Node.js Version ──────────────────────────────────────────────────

package/server/dashboard.js

@@ -378,7 +378,7 @@ function toggleCronEnabled(id) {
 const updateChecker = new UpdateChecker();
 
 function buildWorkspaceSnapshot(cache, services) {
-  const tasks = asArray(readJson(path.join(WORKSPACE, 'TASKS.json')));
+  let tasks = asArray(readJson(path.join(WORKSPACE, 'TASKS.json')));
   const agentStatus = asObject(readJson(path.join(WORKSPACE, 'AGENT_STATUS.json')));
   const agentPerf = asObject(readJson(path.join(WORKSPACE, 'AGENT_PERFORMANCE.json')));
   const budget = asObject(readJson(path.join(WORKSPACE, 'BUDGET.json')));
@@ -445,13 +445,61 @@ function buildWorkspaceSnapshot(cache, services) {
   const jobs = flags.jobs ? services.jobs.list({}).slice(0, 100) : [];
   const approvals = flags.approvals ? services.policy.listApprovals() : [];
   const usage = flags.metering ? services.metering.getUsage() : { records: [], perAgent: {}, perModel: {}, totals: {} };
-  const projects = enrichProjects(projectsRaw, tasks, agentPerf);
+
+  // Auto-derive tasks from jobs that have rootTaskId
+  const taskIds = new Set(tasks.map(t => t.id));
+  const derivedTasks = [];
+  for (const job of jobs) {
+    if (job.rootTaskId && !taskIds.has(job.rootTaskId)) {
+      derivedTasks.push({
+        id: job.rootTaskId,
+        title: job.title || `Task from job ${job.id.slice(0, 8)}`,
+        description: job.intent || '',
+        status: job.status === 'complete' ? 'complete' : (job.status === 'running' ? 'in-progress' : 'pending'),
+        assigned_to: job.assignedAgent || job.requestedBy || 'system',
+        project_id: job.projectId || null,
+        created_at: job.createdAt,
+        updated_at: job.updatedAt,
+        depends_on: [],
+      });
+      taskIds.add(job.rootTaskId);
+    }
+  }
+  // Merge explicit tasks + auto-derived from jobs
+  const allTasks = [...tasks, ...derivedTasks];
+
+  // Auto-derive projects from jobs that have projectId
+  const jobProjects = {};
+  for (const job of jobs) {
+    if (job.projectId && !jobProjects[job.projectId]) {
+      jobProjects[job.projectId] = {
+        id: job.projectId,
+        name: job.title || job.projectId,
+        description: job.intent || '',
+        status: job.status === 'complete' ? 'complete' : 'active',
+        owner: job.requestedBy || 'system',
+        created_at: job.createdAt,
+        updated_at: job.updatedAt,
+        task_ids: job.rootTaskId ? [job.rootTaskId] : [],
+        job_ids: [job.id],
+      };
+    } else if (job.projectId && jobProjects[job.projectId]) {
+      jobProjects[job.projectId].job_ids.push(job.id);
+      if (job.rootTaskId && !jobProjects[job.projectId].task_ids.includes(job.rootTaskId)) {
+        jobProjects[job.projectId].task_ids.push(job.rootTaskId);
+      }
+    }
+  }
+
+  // Merge: explicit projects from PROJECTS.json + auto-derived from jobs
+  const allProjectsRaw = [...projectsRaw, ...Object.values(jobProjects)];
+  const projects = enrichProjects(allProjectsRaw, tasks, agentPerf);
   const projectEvents = services.timeline ? services.timeline.list(null, { limit: 120 }) : [];
 
   return {
     timestamp: new Date().toISOString(),
     workspace: WORKSPACE,
-    tasks,
+    tasks: allTasks,
     task_counts: taskCounts,
     hitl_tasks: hitlTasks,
     sla_at_risk: slaAtRisk,