opengate 0.2.2 → 0.2.4

package/dist/index.js

@@ -4,18 +4,29 @@ function resolveConfig(raw) {
   const apiKey = typeof raw.apiKey === "string" ? raw.apiKey : "";
   if (!url) throw new Error("[opengate] plugin config missing: url");
   if (!apiKey) throw new Error("[opengate] plugin config missing: apiKey");
+  const home = process.env.HOME ?? "/home/unknown";
   return {
     url,
     apiKey,
     agentId: typeof raw.agentId === "string" ? raw.agentId : "main",
     model: typeof raw.model === "string" ? raw.model : void 0,
     pollIntervalMs: typeof raw.pollIntervalMs === "number" ? raw.pollIntervalMs : 3e4,
-    maxConcurrent: typeof raw.maxConcurrent === "number" ? raw.maxConcurrent : 3
+    maxConcurrent: typeof raw.maxConcurrent === "number" ? raw.maxConcurrent : 3,
+    projectsDir: typeof raw.projectsDir === "string" ? raw.projectsDir : `${home}/Projects`
   };
 }
 
 // src/bootstrap.ts
-function buildBootstrapPrompt(task, openGateUrl, apiKey) {
+function repoNameFromUrl(repoUrl) {
+  try {
+    const url = new URL(repoUrl);
+    const segments = url.pathname.replace(/\.git$/, "").split("/").filter(Boolean);
+    return segments.length > 0 ? segments[segments.length - 1] : null;
+  } catch {
+    return null;
+  }
+}
+function buildBootstrapPrompt(task, openGateUrl, apiKey, project, projectsDir) {
   const tags = Array.isArray(task.tags) && task.tags.length > 0 ? task.tags.join(", ") : "none";
   const contextBlock = task.context && Object.keys(task.context).length > 0 ? `
 ## Task Context
@@ -23,42 +34,107 @@ function buildBootstrapPrompt(task, openGateUrl, apiKey) {
 ${JSON.stringify(task.context, null, 2)}
 \`\`\`
 ` : "";
+  const projectId = task.project_id ?? "unknown";
+  const defaultBranch = project?.default_branch ?? "main";
+  let workspacePath = null;
+  if (project?.repo_url) {
+    const repoName = repoNameFromUrl(project.repo_url);
+    if (repoName && projectsDir) {
+      workspacePath = `${projectsDir}/${repoName}`;
+    }
+  }
+  const workspaceBlock = workspacePath ? `### Phase 4: Workspace Setup
+6. **Set up your workspace:**
+   - \`cd ${workspacePath}\`
+   - Pull latest: \`git fetch origin && git checkout ${defaultBranch} && git pull origin ${defaultBranch}\`
+   - Create a feature branch: \`git checkout -b <branch-name>\`
+   - Branch naming: use the task title slugified, e.g. \`feat/add-user-auth\` or \`fix/null-pointer-in-parser\`
+   - If \`${workspacePath}\` does not exist, clone it: \`git clone ${project.repo_url} ${workspacePath}\`` : `### Phase 4: Workspace Setup
+6. **Set up your workspace:**
+   - Fetch project info: \`GET /api/projects/${projectId}\` \u2014 read \`repo_url\` and \`default_branch\`
+   - Derive the local path from the repo name (under ~/Projects/)
+   - If the directory doesn't exist, clone it
+   - Create a feature branch from the default branch`;
   return `You are an autonomous coding agent assigned a task via OpenGate.
 
-## Your Task
+## Your Task (Summary)
 **ID:** ${task.id}
 **Title:** ${task.title}
 **Priority:** ${task.priority ?? "medium"}
 **Tags:** ${tags}
-**Project ID:** ${task.project_id ?? "unknown"}
+**Project ID:** ${projectId}
 
 **Description:**
 ${task.description ?? "(no description provided)"}
 ${contextBlock}
 ## OpenGate API
 - **Base URL:** ${openGateUrl}
-- **Auth:** Bearer ${apiKey}
+- **Auth header:** Authorization: Bearer ${apiKey}
+
+All API calls below use this base URL and auth header.
 
 ## Protocol \u2014 Follow This Exactly
-You MUST follow these steps in order. Skipping any step is not acceptable.
 
-1. **Claim** \u2014 \`POST /api/tasks/${task.id}/claim\`
-2. **Post starting comment** \u2014 \`POST /api/tasks/${task.id}/activity\` with body: \`{"content": "Starting: <your plan in 1-2 sentences>"}\`
-3. **Do the work** \u2014 read relevant files, write code, run tests, commit to a branch
-4. **Post results comment** \u2014 \`POST /api/tasks/${task.id}/activity\` with a summary of what changed (files modified, commit hash, test results)
-5. **Complete** \u2014 \`POST /api/tasks/${task.id}/complete\` with body: \`{"summary": "<what was done>", "output": {"branch": "...", "commits": [...]}}\`
+### Phase 1: Claim
+1. **Claim the task** \u2014 \`POST /api/tasks/${task.id}/claim\`
+
+### Phase 2: Gather Context
+Before writing any code, gather all available context:
+
+2. **Fetch full task details** \u2014 \`GET /api/tasks/${task.id}\`
+   - Read the \`activities\` array for comments, instructions, and prior discussion
+   - Read the \`artifacts\` array for any attached files or links
+   - Read the \`dependencies\` array \u2014 if any dependency has status != "done", note it as a potential blocker
+   - Pay close attention to reviewer comments or change requests in activities
+
+3. **Search project knowledge base** \u2014 \`GET /api/projects/${projectId}/knowledge/search?q=${task.title}\`
+   - Also search by tags if present: \`GET /api/projects/${projectId}/knowledge/search?tags=${tags}\`
+   - Read any returned entries \u2014 they contain architecture decisions, patterns, gotchas, and conventions for this project
+   - Follow these conventions in your implementation
+
+### Phase 3: Plan & Announce
+4. **Post starting comment** \u2014 \`POST /api/tasks/${task.id}/activity\`
+   Body: \`{"content": "Starting work. Plan: <your plan informed by the context you gathered, 2-4 sentences>"}\`
+   - Your plan should reflect what you learned from the knowledge base, existing comments, and dependencies
+
+${workspaceBlock}
+
+### Phase 5: Do the Work
+7. **Implement the solution:**
+   - Follow patterns and conventions from the knowledge base
+   - Write clean, tested code
+   - Run the project's test suite and fix any failures
+   - Commit your changes with a descriptive message referencing the task
 
+### Phase 6: Report & Complete
+8. **Post results comment** \u2014 \`POST /api/tasks/${task.id}/activity\`
+   Body: \`{"content": "<summary of what changed: files modified, approach taken, test results, commit hash>"}\`
+
+9. **Write knowledge** (if you discovered something worth sharing) \u2014 \`PUT /api/projects/${projectId}/knowledge/<key>\`
+   Body: \`{"title": "...", "content": "...", "tags": [...], "category": "<architecture|pattern|gotcha|decision|reference>"}\`
+   - Write entries for: architectural decisions you made, gotchas you encountered, patterns you established
+
+10. **Complete the task** \u2014 \`POST /api/tasks/${task.id}/complete\`
+    Body: \`{"summary": "<what was done>", "output": {"branch": "<branch-name>", "commits": ["<hash>"]}}\`
+
+## Handling Blockers
 If you encounter a blocker that requires human input:
-- Post a question: \`POST /api/tasks/${task.id}/activity\` with \`{"content": "BLOCKED: <question>"}\`
+- Post a question: \`POST /api/tasks/${task.id}/activity\` with \`{"content": "BLOCKED: <describe the issue and what you need>"}\`
 - Block the task: \`POST /api/tasks/${task.id}/block\` with \`{"reason": "<reason>"}\`
 - Then stop \u2014 do NOT mark it complete.
 
-## Notes
+If a dependency is not yet done:
+- Post a comment noting which dependency is blocking you
+- Block the task with the dependency info
+- Stop and let the orchestrator handle sequencing
+
+## Rules
 - Always work on a feature branch, never commit directly to main
-- Run tests before completing
-- If you discover something worth remembering (pattern, gotcha, decision), write it to a file in your workspace
+- Run tests before completing \u2014 do not complete with failing tests
+- Respect existing patterns found in the knowledge base
+- Keep commits atomic and descriptive
 
-Now begin. Start by claiming the task.`;
+Now begin. Start with Phase 1: claim the task.`;
 }
 
 // src/spawner.ts
@@ -165,6 +241,19 @@ var TaskState = class {
 };
 
 // src/poller.ts
+async function fetchProject(url, apiKey, projectId) {
+  try {
+    const resp = await fetch(`${url}/api/projects/${projectId}`, {
+      headers: { Authorization: `Bearer ${apiKey}` },
+      signal: AbortSignal.timeout(1e4)
+    });
+    if (!resp.ok) return null;
+    const body = await resp.json();
+    return body.project ?? body;
+  } catch {
+    return null;
+  }
+}
 async function fetchInbox(url, apiKey) {
   const resp = await fetch(`${url}/api/agents/me/inbox`, {
     headers: { Authorization: `Bearer ${apiKey}` },
@@ -186,6 +275,7 @@ var OpenGatePoller = class {
   timer = null;
   state;
   running = false;
+  projectCache = /* @__PURE__ */ new Map();
   start() {
     if (this.running) return;
     this.running = true;
@@ -239,9 +329,26 @@ var OpenGatePoller = class {
       await this.spawnTask(task);
     }
   }
+  async resolveProject(projectId) {
+    const cached = this.projectCache.get(projectId);
+    if (cached) return cached;
+    const project = await fetchProject(this.pluginCfg.url, this.pluginCfg.apiKey, projectId);
+    if (project) this.projectCache.set(projectId, project);
+    return project;
+  }
   async spawnTask(task) {
     this.logger.info(`[opengate] Spawning session for task: "${task.title}" (${task.id})`);
-    const prompt = buildBootstrapPrompt(task, this.pluginCfg.url, this.pluginCfg.apiKey);
+    let project = null;
+    if (task.project_id) {
+      project = await this.resolveProject(task.project_id);
+    }
+    const prompt = buildBootstrapPrompt(
+      task,
+      this.pluginCfg.url,
+      this.pluginCfg.apiKey,
+      project,
+      this.pluginCfg.projectsDir
+    );
     const result = await spawnTaskSession(
       task.id,
       prompt,

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "opengate",
   "name": "OpenGate",
   "description": "Polls OpenGate for assigned tasks and spawns isolated OpenClaw sessions to execute them. Turns OpenGate into the orchestrator.",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "skills": ["./skills/opengate"],
   "configSchema": {
     "type": "object",
@@ -32,6 +32,10 @@
       "maxConcurrent": {
         "type": "number",
         "description": "Max concurrent task sessions (default: 3)"
+      },
+      "projectsDir": {
+        "type": "string",
+        "description": "Base directory where project repos live on disk (default: ~/Projects)"
       }
     }
   },
@@ -41,6 +45,7 @@
     "agentId": { "label": "OpenClaw Agent ID", "placeholder": "main" },
     "model": { "label": "Model Override", "placeholder": "anthropic/claude-sonnet-4-6" },
     "pollIntervalMs": { "label": "Poll Interval (ms)", "advanced": true },
-    "maxConcurrent": { "label": "Max Concurrent Tasks", "advanced": true }
+    "maxConcurrent": { "label": "Max Concurrent Tasks", "advanced": true },
+    "projectsDir": { "label": "Projects Directory", "placeholder": "~/Projects", "advanced": true }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opengate",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "OpenGate task executor plugin for OpenClaw — polls assigned tasks and spawns isolated agent sessions",
   "type": "module",
   "main": "./dist/index.js",