@synaplink/orqlaude 0.3.0

package/dist/tools/review.d.ts

@@ -0,0 +1,18 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StateStore } from "../lib/state.js";
+import type { AuditLog } from "../lib/audit.js";
+/**
+ * review_prs — spawn a review fleet against the PRs produced by an
+ * already-completed plan.
+ *
+ * The implementation creates a NEW plan whose tasks correspond 1:1 with the
+ * source plan's tasks-with-PR-URLs. Each new task's prompt instructs the
+ * reviewer agent to fetch the PR via `gh pr view`, inspect the diff, run any
+ * applicable tests, and post findings via post_note (with `pr_url` set to the
+ * source PR so the original collect() picks them up).
+ *
+ * The review plan is automatically approved (skipping the AskUserQuestion
+ * step) because the user already approved the parent fleet. If they want a
+ * confirmation per review, they can set `auto_approve: false`.
+ */
+export declare function registerReview(server: McpServer, store: StateStore, audit: AuditLog): void;

package/dist/tools/review.js

@@ -0,0 +1,93 @@
+import { z } from "zod";
+import { newPlan, findPlan } from "../lib/state.js";
+import { estimateAgent } from "../lib/budgeting.js";
+/**
+ * review_prs — spawn a review fleet against the PRs produced by an
+ * already-completed plan.
+ *
+ * The implementation creates a NEW plan whose tasks correspond 1:1 with the
+ * source plan's tasks-with-PR-URLs. Each new task's prompt instructs the
+ * reviewer agent to fetch the PR via `gh pr view`, inspect the diff, run any
+ * applicable tests, and post findings via post_note (with `pr_url` set to the
+ * source PR so the original collect() picks them up).
+ *
+ * The review plan is automatically approved (skipping the AskUserQuestion
+ * step) because the user already approved the parent fleet. If they want a
+ * confirmation per review, they can set `auto_approve: false`.
+ */
+export function registerReview(server, store, audit) {
+    server.tool("review_prs", "Spawn a reviewer agent for each PR produced by a completed plan. Creates a NEW plan (the 'review plan') whose tasks dispatch via the normal next_task/spawn_task loop. Auto-approved by default — pass `auto_approve: false` to require a fresh user approval. Source plan's review_plan_id is updated so you can trace the relationship.", {
+        plan_id: z.string().describe("Plan id of the COMPLETED fleet whose PRs should be reviewed."),
+        auto_approve: z.boolean().default(true).describe("Skip the user approval gate. The parent fleet already had an approval; this is asking 'do you want a separate prompt for reviewing your own PRs?' Default false-equivalent is to do request_approval/confirm manually."),
+        budget_cap_tokens: z.number().int().positive().default(300_000).describe("Token budget for the review fleet."),
+    }, audit.wrap("review_prs", async ({ plan_id, auto_approve, budget_cap_tokens }) => {
+        const result = await store.update((state) => {
+            const source = findPlan(state, plan_id);
+            const prTasks = source.tasks.filter((t) => t.prUrl);
+            if (prTasks.length === 0) {
+                return { created: false, note: "No PRs to review yet. Agents must call post_note with a pr_url first." };
+            }
+            const reviewTasks = prTasks.map((t) => ({
+                title: `Review: ${truncate(t.title, 50)}`,
+                prompt: buildReviewPrompt(t.prUrl, t.title, source.rootTask),
+                tldr: `Review the PR opened for "${t.title}".`,
+                scope: [t.prUrl],
+            }));
+            const reviewPlan = newPlan(`Review of PRs from plan ${plan_id}`, budget_cap_tokens, reviewTasks);
+            const est = estimateAgent(source.modelForEstimate ?? "claude-sonnet-4-6", source.effortMultiplier ?? 0.6);
+            reviewPlan.estimatedTokens = est.tokens.totalEffective * reviewPlan.tasks.length;
+            reviewPlan.estimatedCostUsd = est.costUsd * reviewPlan.tasks.length;
+            reviewPlan.estimatedDurationSec = 60 * 3; // reviewers are typically shorter than implementers
+            reviewPlan.modelForEstimate = source.modelForEstimate;
+            reviewPlan.effortMultiplier = 0.6;
+            if (auto_approve) {
+                reviewPlan.status = "approved";
+                reviewPlan.approvedAt = Date.now();
+            }
+            state.plans[reviewPlan.id] = reviewPlan;
+            source.reviewPlanId = reviewPlan.id;
+            return {
+                created: true,
+                review_plan_id: reviewPlan.id,
+                source_plan_id: plan_id,
+                task_count: reviewPlan.tasks.length,
+                status: reviewPlan.status,
+                estimated_tokens: reviewPlan.estimatedTokens,
+                next_step: auto_approve
+                    ? "Loop next_task → spawn_task for each reviewer just like the parent fleet. Reviewers will post their findings as notes."
+                    : "Call request_approval on the review plan to get a user prompt, then confirm.",
+            };
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }, ({ plan_id }) => ({ planId: plan_id })));
+}
+function buildReviewPrompt(prUrl, originalTitle, rootTask) {
+    return `Review the pull request: ${prUrl}
+
+Context: this PR was produced by an orqlaude fleet member working on the task "${originalTitle}", part of the larger effort: "${rootTask}".
+
+Your job:
+1. Fetch the PR locally: \`gh pr checkout <number>\` or \`gh pr view ${prUrl} --json files,title,body\`.
+2. Read the diff. Walk every changed file. Don't trust the description; verify against the code.
+3. Check for:
+   - Bugs (off-by-one, null handling, race conditions, error swallowing)
+   - Missed tests (any new logic without coverage?)
+   - Design issues (does the change fit the surrounding code's idioms?)
+   - Security concerns (input validation, secret handling, injection vectors)
+   - Documentation gaps
+4. Run the project's test suite if there is one (\`npm test\`, \`pytest\`, etc.). Report failures.
+5. Post your findings via \`mcp__orqlaude__post_note\` with:
+   - \`session_id\`: your session id (self-register first via checkin with the task_id below).
+   - \`text\`: a concise review. Bullet points. Severity-tagged: [BLOCKER], [CONCERN], [NIT].
+   - \`pr_url\`: ${prUrl}  (so the orchestrator attaches it to your task)
+6. If you find a [BLOCKER], also leave a GitHub review comment via \`gh pr review <pr> -c -b "..."\` so the human sees it inline.
+
+Be specific. "Looks good" is not a review. If you have nothing to say, say "No issues found — read N files, all match the surrounding style and have test coverage."
+`;
+}
+function truncate(s, n) {
+    if (s.length <= n)
+        return s;
+    return s.slice(0, n - 1) + "…";
+}
+//# sourceMappingURL=review.js.map

package/dist/tools/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/tools/review.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@synaplink/orqlaude",
+  "version": "0.3.0",
+  "description": "Multi-agent orchestrator for Claude Code. One primary session decomposes a complex task, gets a single budget approval, then dispatches N parallel agents via the Desktop app's native spawn_task. Tracks cost/status via JSONL tails; brokers messages between agents; detects hallucination; manages PRs.",
+  "type": "module",
+  "bin": {
+    "orqlaude": "./dist/cli.js"
+  },
+  "main": "./dist/server.js",
+  "files": [
+    "dist",
+    "README.md",
+    ".mcp.json.template"
+  ],
+  "scripts": {
+    "build": "tsc && chmod +x dist/cli.js dist/server.js",
+    "dev": "tsc --watch",
+    "start": "node dist/server.js",
+    "typecheck": "tsc --noEmit",
+    "test": "tsc && chmod +x dist/cli.js dist/server.js && node --test dist/__tests__/*.test.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "mcp",
+    "orchestrator",
+    "multi-agent",
+    "agents",
+    "anthropic"
+  ],
+  "author": "SynapLink",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SynapLink/orqlaude.git"
+  },
+  "bugs": {
+    "url": "https://github.com/SynapLink/orqlaude/issues"
+  },
+  "homepage": "https://github.com/SynapLink/orqlaude#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.7.5",
+    "typescript": "^5.6.3"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}