@locusai/sdk 0.8.0 → 0.8.1

package/dist/agent/index.d.ts

@@ -1,5 +1,6 @@
 export { CodebaseIndexerService } from "./codebase-indexer-service.js";
 export { DocumentFetcher } from "./document-fetcher.js";
+export { ReviewService, type ReviewServiceDeps } from "./review-service.js";
 export { TaskExecutor } from "./task-executor.js";
 export { AgentWorker, type WorkerConfig } from "./worker.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/agent/review-service.d.ts

@@ -0,0 +1,21 @@
+import type { Sprint } from "@locusai/shared";
+import { LogFn } from "../ai/factory.js";
+import type { AiRunner } from "../ai/runner.js";
+export interface ReviewServiceDeps {
+    aiRunner: AiRunner;
+    projectPath: string;
+    log: LogFn;
+}
+/**
+ * Reviews staged git changes and produces a markdown report.
+ */
+export declare class ReviewService {
+    private deps;
+    constructor(deps: ReviewServiceDeps);
+    /**
+     * Stages all changes and runs an AI review on the diff.
+     * Returns a markdown review report, or null if there are no changes.
+     */
+    reviewStagedChanges(sprint: Sprint | null): Promise<string | null>;
+}
+//# sourceMappingURL=review-service.d.ts.map

package/dist/agent/review-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-service.d.ts","sourceRoot":"","sources":["../../src/agent/review-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,KAAK,CAAC;CACZ;AAED;;GAEG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,iBAAiB;IAE3C;;;OAGG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAkEzE"}

package/dist/agent/task-executor.d.ts

@@ -7,7 +7,7 @@ export interface TaskExecutorDeps {
     log: LogFn;
 }
 /**
- * Handles task execution with two-phase approach (planning + execution)
+ * Handles direct task execution (single-pass, no separate planning phase)
  */
 export declare class TaskExecutor {
     private deps;

package/dist/agent/task-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-executor.d.ts","sourceRoot":"","sources":["../../src/agent/task-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,KAAK,CAAC;CACZ;AAED;;GAEG;AACH,qBAAa,YAAY;IAGX,OAAO,CAAC,IAAI;IAFxB,OAAO,CAAC,aAAa,CAAgB;gBAEjB,IAAI,EAAE,gBAAgB;IAIpC,OAAO,CACX,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CA2ClD"}
+{"version":3,"file":"task-executor.d.ts","sourceRoot":"","sources":["../../src/agent/task-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,KAAK,CAAC;CACZ;AAED;;GAEG;AACH,qBAAa,YAAY;IAGX,OAAO,CAAC,IAAI;IAFxB,OAAO,CAAC,aAAa,CAAgB;gBAEjB,IAAI,EAAE,gBAAgB;IAIpC,OAAO,CACX,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAyBlD"}

package/dist/agent/worker.d.ts

@@ -20,16 +20,15 @@ export declare class AgentWorker {
     private indexerService;
     private documentFetcher;
     private taskExecutor;
-    private consecutiveEmpty;
-    private maxEmpty;
+    private reviewService;
     private maxTasks;
     private tasksCompleted;
-    private pollInterval;
     constructor(config: WorkerConfig);
     log(message: string, level?: "info" | "success" | "warn" | "error"): void;
     private getActiveSprint;
     private getNextTask;
     private executeTask;
+    private runStagedChangesReview;
     run(): Promise<void>;
 }
 //# sourceMappingURL=worker.d.ts.map

package/dist/agent/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/agent/worker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,iBAAiB,CAAC;AAsB5D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,WAAW;IAgBV,OAAO,CAAC,MAAM;IAf1B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAW;IAG3B,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,YAAY,CAAe;IAGnC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,YAAY,CAAU;gBAEV,MAAM,EAAE,YAAY;IAiDxC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAgB;YAe5D,eAAe;YAcf,WAAW;YAiBX,WAAW;IA6BnB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAqF3B"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/agent/worker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,iBAAiB,CAAC;AAuB5D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,WAAW;IAcV,OAAO,CAAC,MAAM;IAb1B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAW;IAG3B,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,aAAa,CAAgB;IAGrC,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,cAAc,CAAK;gBAEP,MAAM,EAAE,YAAY;IAuDxC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAgB;YAe5D,eAAe;YAcf,WAAW;YAiBX,WAAW;YA6BX,sBAAsB;IAoC9B,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA2D3B"}

package/dist/agent/worker.js

@@ -512,6 +512,8 @@ __export(exports_worker, {
   AgentWorker: () => AgentWorker
 });
 module.exports = __toCommonJS(exports_worker);
+var import_node_fs5 = require("node:fs");
+var import_node_path7 = require("node:path");
 
 // src/core/config.ts
 var import_node_path = require("node:path");
@@ -531,14 +533,22 @@ var LOCUS_CONFIG = {
   artifactsDir: "artifacts",
   documentsDir: "documents",
   agentSkillsDir: ".agent/skills",
-  sessionsDir: "sessions"
+  sessionsDir: "sessions",
+  reviewsDir: "reviews",
+  plansDir: "plans"
 };
 var LOCUS_GITIGNORE_PATTERNS = [
   "# Locus AI - Session data (user-specific, can grow large)",
   ".locus/sessions/",
   "",
   "# Locus AI - Artifacts (local-only, user-specific)",
-  ".locus/artifacts/"
+  ".locus/artifacts/",
+  "",
+  "# Locus AI - Review reports (generated per sprint)",
+  ".locus/reviews/",
+  "",
+  "# Locus AI - Plans (generated per task)",
+  ".locus/plans/"
 ];
 function getLocusPath(projectPath, fileName) {
   if (fileName === "contextFile") {
@@ -633,7 +643,7 @@ class ClaudeRunner {
   setEventEmitter(emitter) {
     this.eventEmitter = emitter;
   }
-  async run(prompt, _isPlanning = false) {
+  async run(prompt) {
     const maxRetries = 3;
     let lastError = null;
     for (let attempt = 1;attempt <= maxRetries; attempt++) {
@@ -1479,7 +1489,7 @@ File tree:
 ${tree}
 
 Return ONLY valid JSON, no markdown formatting.`;
-        const response = await this.deps.aiRunner.run(prompt, true);
+        const response = await this.deps.aiRunner.run(prompt);
         const jsonMatch = response.match(/\{[\s\S]*\}/);
         if (jsonMatch) {
           return JSON.parse(jsonMatch[0]);
@@ -1542,6 +1552,66 @@ class DocumentFetcher {
   }
 }
 
+// src/agent/review-service.ts
+var import_node_child_process3 = require("node:child_process");
+
+class ReviewService {
+  deps;
+  constructor(deps) {
+    this.deps = deps;
+  }
+  async reviewStagedChanges(sprint) {
+    const { projectPath, log } = this.deps;
+    try {
+      import_node_child_process3.execSync("git add -A", { cwd: projectPath, stdio: "pipe" });
+      log("Staged all changes for review.", "info");
+    } catch (err) {
+      log(`Failed to stage changes: ${err instanceof Error ? err.message : String(err)}`, "error");
+      return null;
+    }
+    let diff;
+    try {
+      diff = import_node_child_process3.execSync("git diff --cached --stat && echo '---' && git diff --cached", {
+        cwd: projectPath,
+        maxBuffer: 10 * 1024 * 1024
+      }).toString();
+    } catch (err) {
+      log(`Failed to get staged diff: ${err instanceof Error ? err.message : String(err)}`, "error");
+      return null;
+    }
+    if (!diff.trim()) {
+      return null;
+    }
+    const sprintInfo = sprint ? `Sprint: ${sprint.name} (${sprint.id})` : "No active sprint";
+    const reviewPrompt = `# Code Review Request
+
+## Context
+${sprintInfo}
+Date: ${new Date().toISOString()}
+
+## Staged Changes (git diff)
+\`\`\`diff
+${diff}
+\`\`\`
+
+## Instructions
+You are reviewing the staged changes at the end of a sprint. Produce a thorough markdown review report with the following sections:
+
+1. **Summary** — Brief overview of what changed and why.
+2. **Files Changed** — List each file with a short description of changes.
+3. **Code Quality** — Note any code quality concerns (naming, structure, complexity).
+4. **Potential Issues** — Identify bugs, security issues, edge cases, or regressions.
+5. **Recommendations** — Actionable suggestions for improvement.
+6. **Overall Assessment** — A short verdict (e.g., "Looks good", "Needs attention", "Critical issues found").
+
+Keep the review concise but thorough. Focus on substance over style.
+Do NOT output <promise>COMPLETE</promise> — just output the review report as markdown.`;
+    log("Running AI review on staged changes...", "info");
+    const report = await this.deps.aiRunner.run(reviewPrompt);
+    return report;
+  }
+}
+
 // src/core/prompt-builder.ts
 var import_node_fs4 = require("node:fs");
 var import_node_os2 = require("node:os");
@@ -1907,29 +1977,8 @@ class TaskExecutor {
       taskContext: context
     });
     try {
-      let plan = null;
-      this.deps.log("Phase 1: Planning (CLI)...", "info");
-      const planningPrompt = `${basePrompt}
-
-## Phase 1: Planning
-Analyze and create a detailed plan for THIS SPECIFIC TASK. Do NOT execute changes yet.`;
-      plan = await this.deps.aiRunner.run(planningPrompt, true);
       this.deps.log("Starting Execution...", "info");
-      let executionPrompt = basePrompt;
-      if (plan != null) {
-        executionPrompt += `
-
-## Phase 2: Execution
-Based on the plan, execute the task:
-
-${plan}`;
-      } else {
-        executionPrompt += `
-
-## Execution
-Execute the task directly.`;
-      }
-      executionPrompt += `
+      const executionPrompt = `${basePrompt}
 
 When finished, output: <promise>COMPLETE</promise>`;
       const output = await this.deps.aiRunner.run(executionPrompt);
@@ -1963,11 +2012,9 @@ class AgentWorker {
   indexerService;
   documentFetcher;
   taskExecutor;
-  consecutiveEmpty = 0;
-  maxEmpty = 60;
+  reviewService;
   maxTasks = 50;
   tasksCompleted = 0;
-  pollInterval = 1e4;
   constructor(config) {
     this.config = config;
     const projectPath = config.projectPath || process.cwd();
@@ -2004,6 +2051,11 @@ class AgentWorker {
       projectPath,
       log
     });
+    this.reviewService = new ReviewService({
+      aiRunner: this.aiRunner,
+      projectPath,
+      log
+    });
     const providerLabel = provider === "codex" ? "Codex" : "Claude";
     this.log(`Using ${providerLabel} CLI for all phases`, "info");
   }
@@ -2049,33 +2101,42 @@ class AgentWorker {
     await this.indexerService.reindex();
     return result;
   }
+  async runStagedChangesReview(sprint) {
+    try {
+      const report = await this.reviewService.reviewStagedChanges(sprint);
+      if (report) {
+        const reviewsDir = import_node_path7.join(this.config.projectPath, LOCUS_CONFIG.dir, "reviews");
+        if (!import_node_fs5.existsSync(reviewsDir)) {
+          import_node_fs5.mkdirSync(reviewsDir, { recursive: true });
+        }
+        const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+        const sprintSlug = sprint?.name ? sprint.name.toLowerCase().replace(/\s+/g, "-").slice(0, 40) : "no-sprint";
+        const fileName = `review-${sprintSlug}-${timestamp}.md`;
+        const filePath = import_node_path7.join(reviewsDir, fileName);
+        import_node_fs5.writeFileSync(filePath, report);
+        this.log(`Review report saved to .locus/reviews/${fileName}`, "success");
+      } else {
+        this.log("No staged changes to review.", "info");
+      }
+    } catch (err) {
+      this.log(`Review failed: ${err instanceof Error ? err.message : String(err)}`, "error");
+    }
+  }
   async run() {
     this.log(`Agent started in ${this.config.projectPath || process.cwd()}`, "success");
     const sprint = await this.getActiveSprint();
     if (sprint) {
-      this.log(`Active sprint found: ${sprint.name}. Ensuring plan is up to date...`, "info");
-      try {
-        await this.client.sprints.triggerAIPlanning(sprint.id, this.config.workspaceId);
-        this.log(`Sprint plan sync checked on server.`, "success");
-      } catch (err) {
-        this.log(`Sprint planning sync failed (non-critical): ${err instanceof Error ? err.message : String(err)}`, "warn");
-      }
+      this.log(`Active sprint found: ${sprint.name}`, "info");
     } else {
-      this.log("No active sprint found for planning.", "warn");
+      this.log("No active sprint found.", "warn");
     }
-    while (this.tasksCompleted < this.maxTasks && this.consecutiveEmpty < this.maxEmpty) {
+    while (this.tasksCompleted < this.maxTasks) {
       const task = await this.getNextTask();
       if (!task) {
-        if (this.consecutiveEmpty === 0) {
-          this.log("Queue empty, waiting for tasks...", "info");
-        }
-        this.consecutiveEmpty++;
-        if (this.consecutiveEmpty >= this.maxEmpty)
-          break;
-        await new Promise((r) => setTimeout(r, this.pollInterval));
-        continue;
+        this.log("No tasks remaining. Running review on staged changes...", "info");
+        await this.runStagedChangesReview(sprint);
+        break;
       }
-      this.consecutiveEmpty = 0;
       this.log(`Claimed: ${task.title}`, "success");
       const result = await this.executeTask(task);
       try {

package/dist/ai/claude-runner.d.ts

@@ -14,7 +14,7 @@ export declare class ClaudeRunner implements AiRunner {
      * Set an event emitter to receive execution events.
      */
     setEventEmitter(emitter: ExecEventEmitter): void;
-    run(prompt: string, _isPlanning?: boolean): Promise<string>;
+    run(prompt: string): Promise<string>;
     runStream(prompt: string): AsyncGenerator<StreamChunk, void, unknown>;
     /**
      * Emit an event corresponding to a stream chunk.

package/dist/ai/claude-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-runner.d.ts","sourceRoot":"","sources":["../../src/ai/claude-runner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,kBAAkB,CAAC;AAEhE,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAgC5C,qBAAa,YAAa,YAAW,QAAQ;IAQzC,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,GAAG,CAAC;IARd,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAC,CAAmB;IACxC,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,WAAW,CAA+C;gBAGhE,WAAW,EAAE,MAAM,EACX,KAAK,GAAE,MAAuC,EAC9C,GAAG,CAAC,EAAE,KAAK,YAAA;IAKrB;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAI1C,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAyBxD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC;IAqK5E;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiCzB,OAAO,CAAC,sBAAsB;IAW9B,OAAO,CAAC,wBAAwB;IAYhC,OAAO,CAAC,kBAAkB;IAwE1B,OAAO,CAAC,UAAU;IAkFlB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,oBAAoB;CAO7B"}
+{"version":3,"file":"claude-runner.d.ts","sourceRoot":"","sources":["../../src/ai/claude-runner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,kBAAkB,CAAC;AAEhE,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAgC5C,qBAAa,YAAa,YAAW,QAAQ;IAQzC,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,GAAG,CAAC;IARd,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAC,CAAmB;IACxC,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,WAAW,CAA+C;gBAGhE,WAAW,EAAE,MAAM,EACX,KAAK,GAAE,MAAuC,EAC9C,GAAG,CAAC,EAAE,KAAK,YAAA;IAKrB;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAI1C,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAyBnC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC;IAqK5E;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiCzB,OAAO,CAAC,sBAAsB;IAW9B,OAAO,CAAC,wBAAwB;IAYhC,OAAO,CAAC,kBAAkB;IAwE1B,OAAO,CAAC,UAAU;IAkFlB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,oBAAoB;CAO7B"}

package/dist/ai/runner.d.ts

@@ -2,7 +2,7 @@ import type { Provider } from "../core/config.js";
 import type { ExecEventEmitter } from "../exec/event-emitter.js";
 import type { StreamChunk } from "../exec/types.js";
 export interface AiRunner {
-    run(prompt: string, isPlanning?: boolean): Promise<string>;
+    run(prompt: string): Promise<string>;
     runStream(prompt: string): AsyncGenerator<StreamChunk, void, unknown>;
     /**
      * Set an event emitter to receive execution events.

package/dist/ai/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/ai/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,QAAQ;IACvB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACtE;;OAEG;IACH,eAAe,CAAC,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACnD;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/ai/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,QAAQ;IACvB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACtE;;OAEG;IACH,eAAe,CAAC,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACnD;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC"}

package/dist/core/config.d.ts

@@ -13,8 +13,10 @@ export declare const LOCUS_CONFIG: {
     documentsDir: string;
     agentSkillsDir: string;
     sessionsDir: string;
+    reviewsDir: string;
+    plansDir: string;
 };
-export declare const LOCUS_GITIGNORE_PATTERNS: readonly ["# Locus AI - Session data (user-specific, can grow large)", ".locus/sessions/", "", "# Locus AI - Artifacts (local-only, user-specific)", ".locus/artifacts/"];
+export declare const LOCUS_GITIGNORE_PATTERNS: readonly ["# Locus AI - Session data (user-specific, can grow large)", ".locus/sessions/", "", "# Locus AI - Artifacts (local-only, user-specific)", ".locus/artifacts/", "", "# Locus AI - Review reports (generated per sprint)", ".locus/reviews/", "", "# Locus AI - Plans (generated per task)", ".locus/plans/"];
 export declare function getLocusPath(projectPath: string, fileName: keyof typeof LOCUS_CONFIG): string;
 /**
  * Gets the artifacts directory path for a specific agent.

package/dist/core/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ;;;CAGX,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAEhE,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAGlD,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;;;;;CASxB,CAAC;AAIF,eAAO,MAAM,wBAAwB,2KAM3B,CAAC;AAEX,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,OAAO,YAAY,GAClC,MAAM,CAKR;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,CASR"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ;;;CAGX,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAEhE,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAGlD,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;CAWxB,CAAC;AAIF,eAAO,MAAM,wBAAwB,wTAY3B,CAAC;AAEX,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,OAAO,YAAY,GAClC,MAAM,CAKR;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,CASR"}

package/dist/index-node.js

@@ -512,6 +512,8 @@ __export(exports_worker, {
   AgentWorker: () => AgentWorker
 });
 module.exports = __toCommonJS(exports_worker);
+var import_node_fs5 = require("node:fs");
+var import_node_path7 = require("node:path");
 
 // src/core/config.ts
 var import_node_path = require("node:path");
@@ -531,14 +533,22 @@ var LOCUS_CONFIG = {
   artifactsDir: "artifacts",
   documentsDir: "documents",
   agentSkillsDir: ".agent/skills",
-  sessionsDir: "sessions"
+  sessionsDir: "sessions",
+  reviewsDir: "reviews",
+  plansDir: "plans"
 };
 var LOCUS_GITIGNORE_PATTERNS = [
   "# Locus AI - Session data (user-specific, can grow large)",
   ".locus/sessions/",
   "",
   "# Locus AI - Artifacts (local-only, user-specific)",
-  ".locus/artifacts/"
+  ".locus/artifacts/",
+  "",
+  "# Locus AI - Review reports (generated per sprint)",
+  ".locus/reviews/",
+  "",
+  "# Locus AI - Plans (generated per task)",
+  ".locus/plans/"
 ];
 function getLocusPath(projectPath, fileName) {
   if (fileName === "contextFile") {
@@ -633,7 +643,7 @@ class ClaudeRunner {
   setEventEmitter(emitter) {
     this.eventEmitter = emitter;
   }
-  async run(prompt, _isPlanning = false) {
+  async run(prompt) {
     const maxRetries = 3;
     let lastError = null;
     for (let attempt = 1;attempt <= maxRetries; attempt++) {
@@ -1479,7 +1489,7 @@ File tree:
 ${tree}
 
 Return ONLY valid JSON, no markdown formatting.`;
-        const response = await this.deps.aiRunner.run(prompt, true);
+        const response = await this.deps.aiRunner.run(prompt);
         const jsonMatch = response.match(/\{[\s\S]*\}/);
         if (jsonMatch) {
           return JSON.parse(jsonMatch[0]);
@@ -1542,6 +1552,66 @@ class DocumentFetcher {
   }
 }
 
+// src/agent/review-service.ts
+var import_node_child_process3 = require("node:child_process");
+
+class ReviewService {
+  deps;
+  constructor(deps) {
+    this.deps = deps;
+  }
+  async reviewStagedChanges(sprint) {
+    const { projectPath, log } = this.deps;
+    try {
+      import_node_child_process3.execSync("git add -A", { cwd: projectPath, stdio: "pipe" });
+      log("Staged all changes for review.", "info");
+    } catch (err) {
+      log(`Failed to stage changes: ${err instanceof Error ? err.message : String(err)}`, "error");
+      return null;
+    }
+    let diff;
+    try {
+      diff = import_node_child_process3.execSync("git diff --cached --stat && echo '---' && git diff --cached", {
+        cwd: projectPath,
+        maxBuffer: 10 * 1024 * 1024
+      }).toString();
+    } catch (err) {
+      log(`Failed to get staged diff: ${err instanceof Error ? err.message : String(err)}`, "error");
+      return null;
+    }
+    if (!diff.trim()) {
+      return null;
+    }
+    const sprintInfo = sprint ? `Sprint: ${sprint.name} (${sprint.id})` : "No active sprint";
+    const reviewPrompt = `# Code Review Request
+
+## Context
+${sprintInfo}
+Date: ${new Date().toISOString()}
+
+## Staged Changes (git diff)
+\`\`\`diff
+${diff}
+\`\`\`
+
+## Instructions
+You are reviewing the staged changes at the end of a sprint. Produce a thorough markdown review report with the following sections:
+
+1. **Summary** — Brief overview of what changed and why.
+2. **Files Changed** — List each file with a short description of changes.
+3. **Code Quality** — Note any code quality concerns (naming, structure, complexity).
+4. **Potential Issues** — Identify bugs, security issues, edge cases, or regressions.
+5. **Recommendations** — Actionable suggestions for improvement.
+6. **Overall Assessment** — A short verdict (e.g., "Looks good", "Needs attention", "Critical issues found").
+
+Keep the review concise but thorough. Focus on substance over style.
+Do NOT output <promise>COMPLETE</promise> — just output the review report as markdown.`;
+    log("Running AI review on staged changes...", "info");
+    const report = await this.deps.aiRunner.run(reviewPrompt);
+    return report;
+  }
+}
+
 // src/core/prompt-builder.ts
 var import_node_fs4 = require("node:fs");
 var import_node_os2 = require("node:os");
@@ -1907,29 +1977,8 @@ class TaskExecutor {
       taskContext: context
     });
     try {
-      let plan = null;
-      this.deps.log("Phase 1: Planning (CLI)...", "info");
-      const planningPrompt = `${basePrompt}
-
-## Phase 1: Planning
-Analyze and create a detailed plan for THIS SPECIFIC TASK. Do NOT execute changes yet.`;
-      plan = await this.deps.aiRunner.run(planningPrompt, true);
       this.deps.log("Starting Execution...", "info");
-      let executionPrompt = basePrompt;
-      if (plan != null) {
-        executionPrompt += `
-
-## Phase 2: Execution
-Based on the plan, execute the task:
-
-${plan}`;
-      } else {
-        executionPrompt += `
-
-## Execution
-Execute the task directly.`;
-      }
-      executionPrompt += `
+      const executionPrompt = `${basePrompt}
 
 When finished, output: <promise>COMPLETE</promise>`;
       const output = await this.deps.aiRunner.run(executionPrompt);
@@ -1963,11 +2012,9 @@ class AgentWorker {
   indexerService;
   documentFetcher;
   taskExecutor;
-  consecutiveEmpty = 0;
-  maxEmpty = 60;
+  reviewService;
   maxTasks = 50;
   tasksCompleted = 0;
-  pollInterval = 1e4;
   constructor(config) {
     this.config = config;
     const projectPath = config.projectPath || process.cwd();
@@ -2004,6 +2051,11 @@ class AgentWorker {
       projectPath,
       log
     });
+    this.reviewService = new ReviewService({
+      aiRunner: this.aiRunner,
+      projectPath,
+      log
+    });
     const providerLabel = provider === "codex" ? "Codex" : "Claude";
     this.log(`Using ${providerLabel} CLI for all phases`, "info");
   }
@@ -2049,33 +2101,42 @@ class AgentWorker {
     await this.indexerService.reindex();
     return result;
   }
+  async runStagedChangesReview(sprint) {
+    try {
+      const report = await this.reviewService.reviewStagedChanges(sprint);
+      if (report) {
+        const reviewsDir = import_node_path7.join(this.config.projectPath, LOCUS_CONFIG.dir, "reviews");
+        if (!import_node_fs5.existsSync(reviewsDir)) {
+          import_node_fs5.mkdirSync(reviewsDir, { recursive: true });
+        }
+        const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+        const sprintSlug = sprint?.name ? sprint.name.toLowerCase().replace(/\s+/g, "-").slice(0, 40) : "no-sprint";
+        const fileName = `review-${sprintSlug}-${timestamp}.md`;
+        const filePath = import_node_path7.join(reviewsDir, fileName);
+        import_node_fs5.writeFileSync(filePath, report);
+        this.log(`Review report saved to .locus/reviews/${fileName}`, "success");
+      } else {
+        this.log("No staged changes to review.", "info");
+      }
+    } catch (err) {
+      this.log(`Review failed: ${err instanceof Error ? err.message : String(err)}`, "error");
+    }
+  }
   async run() {
     this.log(`Agent started in ${this.config.projectPath || process.cwd()}`, "success");
     const sprint = await this.getActiveSprint();
     if (sprint) {
-      this.log(`Active sprint found: ${sprint.name}. Ensuring plan is up to date...`, "info");
-      try {
-        await this.client.sprints.triggerAIPlanning(sprint.id, this.config.workspaceId);
-        this.log(`Sprint plan sync checked on server.`, "success");
-      } catch (err) {
-        this.log(`Sprint planning sync failed (non-critical): ${err instanceof Error ? err.message : String(err)}`, "warn");
-      }
+      this.log(`Active sprint found: ${sprint.name}`, "info");
     } else {
-      this.log("No active sprint found for planning.", "warn");
+      this.log("No active sprint found.", "warn");
     }
-    while (this.tasksCompleted < this.maxTasks && this.consecutiveEmpty < this.maxEmpty) {
+    while (this.tasksCompleted < this.maxTasks) {
       const task = await this.getNextTask();
       if (!task) {
-        if (this.consecutiveEmpty === 0) {
-          this.log("Queue empty, waiting for tasks...", "info");
-        }
-        this.consecutiveEmpty++;
-        if (this.consecutiveEmpty >= this.maxEmpty)
-          break;
-        await new Promise((r) => setTimeout(r, this.pollInterval));
-        continue;
+        this.log("No tasks remaining. Running review on staged changes...", "info");
+        await this.runStagedChangesReview(sprint);
+        break;
       }
-      this.consecutiveEmpty = 0;
       this.log(`Claimed: ${task.title}`, "success");
       const result = await this.executeTask(task);
       try {
@@ -2157,6 +2218,7 @@ __export(exports_index_node, {
   TasksModule: () => TasksModule,
   TaskExecutor: () => TaskExecutor,
   SprintsModule: () => SprintsModule,
+  ReviewService: () => ReviewService,
   PromptBuilder: () => PromptBuilder,
   PROVIDER: () => PROVIDER,
   OrganizationsModule: () => OrganizationsModule,
@@ -2598,8 +2660,8 @@ class ExecEventEmitter {
   }
 }
 // src/exec/history-manager.ts
-var import_node_fs5 = require("node:fs");
-var import_node_path7 = require("node:path");
+var import_node_fs6 = require("node:fs");
+var import_node_path8 = require("node:path");
 var DEFAULT_MAX_SESSIONS = 30;
 function generateSessionId2() {
   const timestamp = Date.now().toString(36);
@@ -2611,30 +2673,30 @@ class HistoryManager {
   historyDir;
   maxSessions;
   constructor(projectPath, options) {
-    this.historyDir = options?.historyDir ?? import_node_path7.join(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.sessionsDir);
+    this.historyDir = options?.historyDir ?? import_node_path8.join(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.sessionsDir);
     this.maxSessions = options?.maxSessions ?? DEFAULT_MAX_SESSIONS;
     this.ensureHistoryDir();
   }
   ensureHistoryDir() {
-    if (!import_node_fs5.existsSync(this.historyDir)) {
-      import_node_fs5.mkdirSync(this.historyDir, { recursive: true });
+    if (!import_node_fs6.existsSync(this.historyDir)) {
+      import_node_fs6.mkdirSync(this.historyDir, { recursive: true });
     }
   }
   getSessionPath(sessionId) {
-    return import_node_path7.join(this.historyDir, `${sessionId}.json`);
+    return import_node_path8.join(this.historyDir, `${sessionId}.json`);
   }
   saveSession(session) {
     const filePath = this.getSessionPath(session.id);
     session.updatedAt = Date.now();
-    import_node_fs5.writeFileSync(filePath, JSON.stringify(session, null, 2), "utf-8");
+    import_node_fs6.writeFileSync(filePath, JSON.stringify(session, null, 2), "utf-8");
   }
   loadSession(sessionId) {
     const filePath = this.getSessionPath(sessionId);
-    if (!import_node_fs5.existsSync(filePath)) {
+    if (!import_node_fs6.existsSync(filePath)) {
       return null;
     }
     try {
-      const content = import_node_fs5.readFileSync(filePath, "utf-8");
+      const content = import_node_fs6.readFileSync(filePath, "utf-8");
       return JSON.parse(content);
     } catch {
       return null;
@@ -2642,18 +2704,18 @@ class HistoryManager {
   }
   deleteSession(sessionId) {
     const filePath = this.getSessionPath(sessionId);
-    if (!import_node_fs5.existsSync(filePath)) {
+    if (!import_node_fs6.existsSync(filePath)) {
       return false;
     }
     try {
-      import_node_fs5.rmSync(filePath);
+      import_node_fs6.rmSync(filePath);
       return true;
     } catch {
       return false;
     }
   }
   listSessions(options) {
-    const files = import_node_fs5.readdirSync(this.historyDir);
+    const files = import_node_fs6.readdirSync(this.historyDir);
     let sessions = [];
     for (const file of files) {
       if (file.endsWith(".json")) {
@@ -2726,11 +2788,11 @@ class HistoryManager {
     return deleted;
   }
   getSessionCount() {
-    const files = import_node_fs5.readdirSync(this.historyDir);
+    const files = import_node_fs6.readdirSync(this.historyDir);
     return files.filter((f) => f.endsWith(".json")).length;
   }
   sessionExists(sessionId) {
-    return import_node_fs5.existsSync(this.getSessionPath(sessionId));
+    return import_node_fs6.existsSync(this.getSessionPath(sessionId));
   }
   findSessionByPartialId(partialId) {
     const sessions = this.listSessions();
@@ -2744,12 +2806,12 @@ class HistoryManager {
     return this.historyDir;
   }
   clearAllSessions() {
-    const files = import_node_fs5.readdirSync(this.historyDir);
+    const files = import_node_fs6.readdirSync(this.historyDir);
     let deleted = 0;
     for (const file of files) {
       if (file.endsWith(".json")) {
         try {
-          import_node_fs5.rmSync(import_node_path7.join(this.historyDir, file));
+          import_node_fs6.rmSync(import_node_path8.join(this.historyDir, file));
           deleted++;
         } catch {}
       }
@@ -3014,9 +3076,9 @@ ${currentPrompt}`);
   }
 }
 // src/orchestrator.ts
-var import_node_child_process3 = require("node:child_process");
-var import_node_fs6 = require("node:fs");
-var import_node_path8 = require("node:path");
+var import_node_child_process4 = require("node:child_process");
+var import_node_fs7 = require("node:fs");
+var import_node_path9 = require("node:path");
 var import_node_url = require("node:url");
 var import_shared3 = require("@locusai/shared");
 var import_events4 = require("events");
@@ -3112,9 +3174,9 @@ ${c.success("✅ Orchestrator finished")}`);
 `);
     const potentialPaths = [];
     const currentModulePath = import_node_url.fileURLToPath("file:///home/runner/work/locusai/locusai/packages/sdk/src/orchestrator.ts");
-    const currentModuleDir = import_node_path8.dirname(currentModulePath);
-    potentialPaths.push(import_node_path8.join(currentModuleDir, "agent", "worker.js"), import_node_path8.join(currentModuleDir, "worker.js"), import_node_path8.join(currentModuleDir, "agent", "worker.ts"));
-    const workerPath = potentialPaths.find((p) => import_node_fs6.existsSync(p));
+    const currentModuleDir = import_node_path9.dirname(currentModulePath);
+    potentialPaths.push(import_node_path9.join(currentModuleDir, "agent", "worker.js"), import_node_path9.join(currentModuleDir, "worker.js"), import_node_path9.join(currentModuleDir, "agent", "worker.ts"));
+    const workerPath = potentialPaths.find((p) => import_node_fs7.existsSync(p));
     if (!workerPath) {
       throw new Error(`Worker file not found. Checked: ${potentialPaths.join(", ")}. ` + `Make sure the SDK is properly built and installed.`);
     }
@@ -3139,7 +3201,7 @@ ${c.success("✅ Orchestrator finished")}`);
     if (this.resolvedSprintId) {
       workerArgs.push("--sprint-id", this.resolvedSprintId);
     }
-    const agentProcess = import_node_child_process3.spawn(process.execPath, [workerPath, ...workerArgs], {
+    const agentProcess = import_node_child_process4.spawn(process.execPath, [workerPath, ...workerArgs], {
       stdio: ["pipe", "pipe", "pipe"],
       env: {
         ...process.env,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@locusai/sdk",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
@@ -30,7 +30,7 @@
     "clean": "rm -rf node_modules"
   },
   "dependencies": {
-    "@locusai/shared": "^0.8.0",
+    "@locusai/shared": "^0.8.1",
     "axios": "^1.13.2",
     "events": "^3.3.0",
     "globby": "^14.0.2"