@locusai/cli 0.7.7 → 0.8.1

package/bin/locus.js

@@ -6341,7 +6341,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]);
@@ -6389,14 +6389,22 @@ var init_config = __esm(() => {
     artifactsDir: "artifacts",
     documentsDir: "documents",
     agentSkillsDir: ".agent/skills",
-    sessionsDir: "sessions"
+    sessionsDir: "sessions",
+    reviewsDir: "reviews",
+    plansDir: "plans"
   };
   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/"
   ];
 });
 
@@ -6448,6 +6456,67 @@ var init_document_fetcher = __esm(() => {
   init_config();
 });
 
+// ../sdk/src/agent/review-service.ts
+import { execSync } from "node:child_process";
+
+class ReviewService {
+  deps;
+  constructor(deps) {
+    this.deps = deps;
+  }
+  async reviewStagedChanges(sprint) {
+    const { projectPath, log } = this.deps;
+    try {
+      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 = 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;
+  }
+}
+var init_review_service = () => {};
+
 // ../../node_modules/zod/v4/core/core.js
 function $constructor(name, initializer, params) {
   function init(inst, def) {
@@ -20414,11 +20483,15 @@ var init_enums = __esm(() => {
     EventType2["SPRINT_STATUS_CHANGED"] = "SPRINT_STATUS_CHANGED";
     EventType2["SPRINT_DELETED"] = "SPRINT_DELETED";
     EventType2["CHECKLIST_INITIALIZED"] = "CHECKLIST_INITIALIZED";
+    EventType2["INTERVIEW_STARTED"] = "INTERVIEW_STARTED";
+    EventType2["INTERVIEW_FIELD_COMPLETED"] = "INTERVIEW_FIELD_COMPLETED";
+    EventType2["INTERVIEW_COMPLETED"] = "INTERVIEW_COMPLETED";
+    EventType2["INTERVIEW_ABANDONED"] = "INTERVIEW_ABANDONED";
   })(EventType ||= {});
 });
 
 // ../shared/src/models/activity.ts
-var CommentSchema, ArtifactSchema, TaskCreatedPayloadSchema, TaskDeletedPayloadSchema, StatusChangedPayloadSchema, CommentAddedPayloadSchema, WorkspaceCreatedPayloadSchema, MemberAddedPayloadSchema, MemberInvitedPayloadSchema, SprintCreatedPayloadSchema, SprintStatusChangedPayloadSchema, ChecklistInitializedPayloadSchema, CiRanPayloadSchema, EventPayloadSchema, EventSchema, ArtifactParamSchema, TaskIdOnlyParamSchema, EventQuerySchema, EventResponseSchema, EventsResponseSchema, ActivityResponseSchema, CommentResponseSchema, ArtifactResponseSchema, ArtifactsResponseSchema, CreateArtifactSchema, ReportCiResultSchema;
+var CommentSchema, ArtifactSchema, TaskCreatedPayloadSchema, TaskDeletedPayloadSchema, StatusChangedPayloadSchema, CommentAddedPayloadSchema, WorkspaceCreatedPayloadSchema, MemberAddedPayloadSchema, MemberInvitedPayloadSchema, SprintCreatedPayloadSchema, SprintStatusChangedPayloadSchema, ChecklistInitializedPayloadSchema, CiRanPayloadSchema, InterviewStartedPayloadSchema, InterviewFieldCompletedPayloadSchema, InterviewCompletedPayloadSchema, InterviewAbandonedPayloadSchema, EventPayloadSchema, EventSchema, ArtifactParamSchema, TaskIdOnlyParamSchema, EventQuerySchema, EventResponseSchema, EventsResponseSchema, ActivityResponseSchema, CommentResponseSchema, ArtifactResponseSchema, ArtifactsResponseSchema, CreateArtifactSchema, ReportCiResultSchema;
 var init_activity = __esm(() => {
   init_zod();
   init_common();
@@ -20486,6 +20559,25 @@ var init_activity = __esm(() => {
     processed: exports_external.boolean(),
     commands: exports_external.array(exports_external.object({ cmd: exports_external.string(), exitCode: exports_external.number() }))
   });
+  InterviewStartedPayloadSchema = exports_external.object({
+    workspaceName: exports_external.string(),
+    firstFieldName: exports_external.string()
+  });
+  InterviewFieldCompletedPayloadSchema = exports_external.object({
+    fieldName: exports_external.string(),
+    completionPercentage: exports_external.number()
+  });
+  InterviewCompletedPayloadSchema = exports_external.object({
+    workspaceName: exports_external.string(),
+    timeToCompleteMs: exports_external.number(),
+    completedVia: exports_external.enum(["interview", "manual_bypass"])
+  });
+  InterviewAbandonedPayloadSchema = exports_external.object({
+    workspaceName: exports_external.string(),
+    lastActiveAt: exports_external.union([exports_external.date(), exports_external.string()]),
+    completionPercentage: exports_external.number(),
+    daysInactive: exports_external.number()
+  });
   EventPayloadSchema = exports_external.discriminatedUnion("type", [
     exports_external.object({
       type: exports_external.literal("TASK_CREATED" /* TASK_CREATED */),
@@ -20530,6 +20622,22 @@ var init_activity = __esm(() => {
     exports_external.object({
       type: exports_external.literal("CI_RAN" /* CI_RAN */),
       payload: CiRanPayloadSchema
+    }),
+    exports_external.object({
+      type: exports_external.literal("INTERVIEW_STARTED" /* INTERVIEW_STARTED */),
+      payload: InterviewStartedPayloadSchema
+    }),
+    exports_external.object({
+      type: exports_external.literal("INTERVIEW_FIELD_COMPLETED" /* INTERVIEW_FIELD_COMPLETED */),
+      payload: InterviewFieldCompletedPayloadSchema
+    }),
+    exports_external.object({
+      type: exports_external.literal("INTERVIEW_COMPLETED" /* INTERVIEW_COMPLETED */),
+      payload: InterviewCompletedPayloadSchema
+    }),
+    exports_external.object({
+      type: exports_external.literal("INTERVIEW_ABANDONED" /* INTERVIEW_ABANDONED */),
+      payload: InterviewAbandonedPayloadSchema
     })
   ]);
   EventSchema = exports_external.object({
@@ -20609,7 +20717,7 @@ var init_ai = __esm(() => {
   AIRoleSchema = exports_external.enum(["user", "assistant", "system"]);
   AIArtifactSchema = exports_external.object({
     id: exports_external.string(),
-    type: exports_external.enum(["code", "document", "sprint", "task_list", "task"]),
+    type: exports_external.enum(["code", "document"]),
     title: exports_external.string(),
     content: exports_external.string(),
     language: exports_external.string().optional(),
@@ -20617,13 +20725,7 @@ var init_ai = __esm(() => {
   });
   SuggestedActionSchema = exports_external.object({
     label: exports_external.string(),
-    type: exports_external.enum([
-      "create_task",
-      "create_doc",
-      "chat_suggestion",
-      "start_sprint",
-      "plan_sprint"
-    ]),
+    type: exports_external.enum(["chat_suggestion", "create_doc"]),
     payload: exports_external.any()
   });
   AIMessageSchema = exports_external.object({
@@ -20924,6 +21026,58 @@ var init_invitation = __esm(() => {
   });
 });
 
+// ../shared/src/models/manifest.ts
+var ProjectPhaseSchema, SprintStatusSchema, ProjectSprintSchema, MilestoneStatusSchema, ProjectMilestoneSchema, ProjectTimelineSchema, RepositoryContextSchema, ProjectManifestSchema, PartialProjectManifestSchema;
+var init_manifest = __esm(() => {
+  init_zod();
+  ProjectPhaseSchema = exports_external.enum([
+    "PLANNING",
+    "MVP_BUILD",
+    "SCALING",
+    "MAINTENANCE"
+  ]);
+  SprintStatusSchema = exports_external.enum(["PLANNED", "ACTIVE", "COMPLETED"]);
+  ProjectSprintSchema = exports_external.object({
+    id: exports_external.string(),
+    goal: exports_external.string(),
+    tasks: exports_external.array(exports_external.string()),
+    status: SprintStatusSchema
+  });
+  MilestoneStatusSchema = exports_external.enum(["PENDING", "COMPLETED"]);
+  ProjectMilestoneSchema = exports_external.object({
+    title: exports_external.string(),
+    date: exports_external.string().optional(),
+    status: MilestoneStatusSchema
+  });
+  ProjectTimelineSchema = exports_external.object({
+    sprints: exports_external.array(ProjectSprintSchema),
+    milestones: exports_external.array(ProjectMilestoneSchema)
+  });
+  RepositoryContextSchema = exports_external.object({
+    summary: exports_external.string(),
+    fileStructure: exports_external.string(),
+    dependencies: exports_external.record(exports_external.string(), exports_external.string()),
+    frameworks: exports_external.array(exports_external.string()),
+    configFiles: exports_external.array(exports_external.string()),
+    lastAnalysis: exports_external.string()
+  });
+  ProjectManifestSchema = exports_external.object({
+    name: exports_external.string(),
+    mission: exports_external.string(),
+    targetUsers: exports_external.array(exports_external.string()),
+    techStack: exports_external.array(exports_external.string()),
+    phase: ProjectPhaseSchema,
+    features: exports_external.array(exports_external.string()),
+    competitors: exports_external.array(exports_external.string()),
+    brandVoice: exports_external.string().optional(),
+    successMetrics: exports_external.array(exports_external.string()).optional(),
+    completenessScore: exports_external.number().min(0).max(100),
+    timeline: ProjectTimelineSchema.optional(),
+    repositoryState: RepositoryContextSchema.optional()
+  });
+  PartialProjectManifestSchema = ProjectManifestSchema.partial();
+});
+
 // ../shared/src/models/organization.ts
 var OrganizationSchema, CreateOrganizationSchema, UpdateOrganizationSchema, AddMemberSchema, MembershipWithUserSchema, OrgIdParamSchema, MembershipIdParamSchema, OrganizationResponseSchema, OrganizationsResponseSchema, MembersResponseSchema, MembershipResponseSchema;
 var init_organization = __esm(() => {
@@ -21105,7 +21259,7 @@ var init_task = __esm(() => {
 });
 
 // ../shared/src/models/workspace.ts
-var ChecklistItemSchema, WorkspaceSchema, CreateWorkspaceSchema, UpdateWorkspaceSchema, AddWorkspaceMemberSchema, WorkspaceIdParamSchema, WorkspaceAndUserParamSchema, WorkspaceResponseSchema, WorkspacesResponseSchema, WorkspaceStatsSchema, WorkspaceStatsResponseSchema;
+var ChecklistItemSchema, WorkspaceSchema, CreateWorkspaceSchema, UpdateWorkspaceSchema, AddWorkspaceMemberSchema, WorkspaceIdParamSchema, WorkspaceAndUserParamSchema, WorkspaceWithManifestInfoSchema, WorkspaceResponseSchema, WorkspacesResponseSchema, WorkspaceStatsSchema, WorkspaceStatsResponseSchema, ManifestStatusResponseSchema;
 var init_workspace = __esm(() => {
   init_zod();
   init_common();
@@ -21139,11 +21293,15 @@ var init_workspace = __esm(() => {
     workspaceId: exports_external.string().uuid("Invalid Workspace ID"),
     userId: exports_external.string().uuid("Invalid User ID")
   });
+  WorkspaceWithManifestInfoSchema = WorkspaceSchema.extend({
+    isManifestComplete: exports_external.boolean(),
+    manifestCompletionPercentage: exports_external.number().min(0).max(100)
+  });
   WorkspaceResponseSchema = exports_external.object({
-    workspace: WorkspaceSchema
+    workspace: WorkspaceWithManifestInfoSchema
   });
   WorkspacesResponseSchema = exports_external.object({
-    workspaces: exports_external.array(WorkspaceSchema)
+    workspaces: exports_external.array(WorkspaceWithManifestInfoSchema)
   });
   WorkspaceStatsSchema = exports_external.object({
     workspaceName: exports_external.string(),
@@ -21153,6 +21311,13 @@ var init_workspace = __esm(() => {
   WorkspaceStatsResponseSchema = exports_external.object({
     stats: WorkspaceStatsSchema
   });
+  ManifestStatusResponseSchema = exports_external.object({
+    isComplete: exports_external.boolean(),
+    percentage: exports_external.number().min(0).max(100),
+    missingFields: exports_external.array(exports_external.string()),
+    filledFields: exports_external.array(exports_external.string()),
+    completenessScore: exports_external.number().min(0).max(100).nullable()
+  });
 });
 
 // ../shared/src/models/index.ts
@@ -21165,6 +21330,7 @@ var init_models = __esm(() => {
   init_doc();
   init_doc_group();
   init_invitation();
+  init_manifest();
   init_organization();
   init_sprint();
   init_task();
@@ -21548,29 +21714,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);
@@ -21671,7 +21816,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++) {
@@ -37612,6 +37757,10 @@ var init_workspaces = __esm(() => {
       const { data } = await this.api.get(`/workspaces/${id}/stats`);
       return data;
     }
+    async getManifestStatus(workspaceId) {
+      const { data } = await this.api.get(`/workspaces/${workspaceId}/manifest-status`);
+      return data;
+    }
     async getActivity(id, limit) {
       const { data } = await this.api.get(`/workspaces/${id}/activity`, {
         params: { limit }
@@ -37753,6 +37902,8 @@ var init_src2 = __esm(() => {
 });
 
 // ../sdk/src/agent/worker.ts
+import { existsSync as existsSync5, mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "node:fs";
+import { join as join6 } from "node:path";
 function resolveProvider(value) {
   if (!value || value.startsWith("--")) {
     console.warn("Warning: --provider requires a value. Falling back to 'claude'.");
@@ -37771,11 +37922,9 @@ class AgentWorker {
   indexerService;
   documentFetcher;
   taskExecutor;
-  consecutiveEmpty = 0;
-  maxEmpty = 60;
+  reviewService;
   maxTasks = 50;
   tasksCompleted = 0;
-  pollInterval = 1e4;
   constructor(config2) {
     this.config = config2;
     const projectPath = config2.projectPath || process.cwd();
@@ -37812,6 +37961,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");
   }
@@ -37857,33 +38011,42 @@ class AgentWorker {
     await this.indexerService.reindex();
     return result;
   }
+  async runStagedChangesReview(sprint2) {
+    try {
+      const report = await this.reviewService.reviewStagedChanges(sprint2);
+      if (report) {
+        const reviewsDir = join6(this.config.projectPath, LOCUS_CONFIG.dir, "reviews");
+        if (!existsSync5(reviewsDir)) {
+          mkdirSync3(reviewsDir, { recursive: true });
+        }
+        const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+        const sprintSlug = sprint2?.name ? sprint2.name.toLowerCase().replace(/\s+/g, "-").slice(0, 40) : "no-sprint";
+        const fileName = `review-${sprintSlug}-${timestamp}.md`;
+        const filePath = join6(reviewsDir, fileName);
+        writeFileSync3(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 sprint2 = await this.getActiveSprint();
     if (sprint2) {
-      this.log(`Active sprint found: ${sprint2.name}. Ensuring plan is up to date...`, "info");
-      try {
-        await this.client.sprints.triggerAIPlanning(sprint2.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: ${sprint2.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 task2 = await this.getNextTask();
       if (!task2) {
-        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(sprint2);
+        break;
       }
-      this.consecutiveEmpty = 0;
       this.log(`Claimed: ${task2.title}`, "success");
       const result = await this.executeTask(task2);
       try {
@@ -37923,6 +38086,7 @@ var init_worker = __esm(() => {
   init_colors();
   init_codebase_indexer_service();
   init_document_fetcher();
+  init_review_service();
   init_task_executor();
   if (process.argv[1]?.includes("agent-worker") || process.argv[1]?.includes("worker")) {
     process.title = "locus-worker";
@@ -37967,6 +38131,7 @@ var init_worker = __esm(() => {
 var init_agent2 = __esm(() => {
   init_codebase_indexer_service();
   init_document_fetcher();
+  init_review_service();
   init_task_executor();
   init_worker();
 });
@@ -38392,14 +38557,14 @@ var init_event_emitter = __esm(() => {
 
 // ../sdk/src/exec/history-manager.ts
 import {
-  existsSync as existsSync5,
-  mkdirSync as mkdirSync3,
+  existsSync as existsSync6,
+  mkdirSync as mkdirSync4,
   readdirSync as readdirSync2,
   readFileSync as readFileSync5,
   rmSync,
-  writeFileSync as writeFileSync3
+  writeFileSync as writeFileSync4
 } from "node:fs";
-import { join as join6 } from "node:path";
+import { join as join7 } from "node:path";
 function generateSessionId2() {
   const timestamp = Date.now().toString(36);
   const random = Math.random().toString(36).substring(2, 9);
@@ -38410,26 +38575,26 @@ class HistoryManager {
   historyDir;
   maxSessions;
   constructor(projectPath, options) {
-    this.historyDir = options?.historyDir ?? join6(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.sessionsDir);
+    this.historyDir = options?.historyDir ?? join7(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.sessionsDir);
     this.maxSessions = options?.maxSessions ?? DEFAULT_MAX_SESSIONS;
     this.ensureHistoryDir();
   }
   ensureHistoryDir() {
-    if (!existsSync5(this.historyDir)) {
-      mkdirSync3(this.historyDir, { recursive: true });
+    if (!existsSync6(this.historyDir)) {
+      mkdirSync4(this.historyDir, { recursive: true });
     }
   }
   getSessionPath(sessionId) {
-    return join6(this.historyDir, `${sessionId}.json`);
+    return join7(this.historyDir, `${sessionId}.json`);
   }
   saveSession(session) {
     const filePath = this.getSessionPath(session.id);
     session.updatedAt = Date.now();
-    writeFileSync3(filePath, JSON.stringify(session, null, 2), "utf-8");
+    writeFileSync4(filePath, JSON.stringify(session, null, 2), "utf-8");
   }
   loadSession(sessionId) {
     const filePath = this.getSessionPath(sessionId);
-    if (!existsSync5(filePath)) {
+    if (!existsSync6(filePath)) {
       return null;
     }
     try {
@@ -38441,7 +38606,7 @@ class HistoryManager {
   }
   deleteSession(sessionId) {
     const filePath = this.getSessionPath(sessionId);
-    if (!existsSync5(filePath)) {
+    if (!existsSync6(filePath)) {
       return false;
     }
     try {
@@ -38529,7 +38694,7 @@ class HistoryManager {
     return files.filter((f) => f.endsWith(".json")).length;
   }
   sessionExists(sessionId) {
-    return existsSync5(this.getSessionPath(sessionId));
+    return existsSync6(this.getSessionPath(sessionId));
   }
   findSessionByPartialId(partialId) {
     const sessions = this.listSessions();
@@ -38548,7 +38713,7 @@ class HistoryManager {
     for (const file2 of files) {
       if (file2.endsWith(".json")) {
         try {
-          rmSync(join6(this.historyDir, file2));
+          rmSync(join7(this.historyDir, file2));
           deleted++;
         } catch {}
       }
@@ -38831,8 +38996,8 @@ var init_exec = __esm(() => {
 
 // ../sdk/src/orchestrator.ts
 import { spawn as spawn3 } from "node:child_process";
-import { existsSync as existsSync6 } from "node:fs";
-import { dirname as dirname2, join as join7 } from "node:path";
+import { existsSync as existsSync7 } from "node:fs";
+import { dirname as dirname2, join as join8 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 import { EventEmitter as EventEmitter4 } from "events";
 var AgentOrchestrator;
@@ -38933,8 +39098,8 @@ ${c.success("✅ Orchestrator finished")}`);
       const potentialPaths = [];
       const currentModulePath = fileURLToPath2(import.meta.url);
       const currentModuleDir = dirname2(currentModulePath);
-      potentialPaths.push(join7(currentModuleDir, "agent", "worker.js"), join7(currentModuleDir, "worker.js"), join7(currentModuleDir, "agent", "worker.ts"));
-      const workerPath = potentialPaths.find((p) => existsSync6(p));
+      potentialPaths.push(join8(currentModuleDir, "agent", "worker.js"), join8(currentModuleDir, "worker.js"), join8(currentModuleDir, "agent", "worker.ts"));
+      const workerPath = potentialPaths.find((p) => existsSync7(p));
       if (!workerPath) {
         throw new Error(`Worker file not found. Checked: ${potentialPaths.join(", ")}. ` + `Make sure the SDK is properly built and installed.`);
       }
@@ -39949,6 +40114,9 @@ class InteractiveSession {
   projectPath;
   model;
   provider;
+  inputBuffer = [];
+  inputDebounceTimer = null;
+  static PASTE_DEBOUNCE_MS = 50;
   constructor(options) {
     this.aiRunner = createAiRunner(options.provider, {
       projectPath: options.projectPath,
@@ -39988,6 +40156,11 @@ class InteractiveSession {
     this.readline.on("line", (input) => this.handleLine(input));
     this.readline.on("close", () => this.shutdown());
     process.on("SIGINT", () => {
+      if (this.inputDebounceTimer) {
+        clearTimeout(this.inputDebounceTimer);
+        this.inputDebounceTimer = null;
+      }
+      this.inputBuffer = [];
       if (this.isProcessing) {
         this.renderer.stopThinkingAnimation();
         console.log(c.dim(`
@@ -39999,18 +40172,34 @@ class InteractiveSession {
       }
     });
   }
-  async handleLine(input) {
-    const trimmed = input.trim();
+  handleLine(input) {
+    this.inputBuffer.push(input);
+    if (this.inputDebounceTimer) {
+      clearTimeout(this.inputDebounceTimer);
+    }
+    this.inputDebounceTimer = setTimeout(() => {
+      this.processBufferedInput();
+    }, InteractiveSession.PASTE_DEBOUNCE_MS);
+  }
+  async processBufferedInput() {
+    const fullInput = this.inputBuffer.join(`
+`);
+    this.inputBuffer = [];
+    this.inputDebounceTimer = null;
+    const trimmed = fullInput.trim();
     if (trimmed === "") {
       this.readline?.prompt();
       return;
     }
-    const command = parseCommand(trimmed);
-    if (command) {
-      await command.execute(this, trimmed.slice(command.name.length).trim());
-      if (this.readline)
-        this.readline.prompt();
-      return;
+    if (!trimmed.includes(`
+`)) {
+      const command = parseCommand(trimmed);
+      if (command) {
+        await command.execute(this, trimmed.slice(command.name.length).trim());
+        if (this.readline)
+          this.readline.prompt();
+        return;
+      }
     }
     await this.executePrompt(trimmed);
     this.readline?.prompt();
@@ -40117,6 +40306,10 @@ ${userInput}`;
     this.historyManager.pruneSessions();
   }
   shutdown() {
+    if (this.inputDebounceTimer) {
+      clearTimeout(this.inputDebounceTimer);
+      this.inputDebounceTimer = null;
+    }
     this.renderer.stopThinkingAnimation();
     console.log(c.dim(`
 Goodbye!`));
@@ -40152,22 +40345,22 @@ import { parseArgs } from "node:util";
 init_index_node();
 
 // src/utils/version.ts
-import { existsSync as existsSync7, readFileSync as readFileSync6 } from "node:fs";
-import { dirname as dirname3, join as join8 } from "node:path";
+import { existsSync as existsSync8, readFileSync as readFileSync6 } from "node:fs";
+import { dirname as dirname3, join as join9 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 function getVersion() {
   try {
     const __filename2 = fileURLToPath3(import.meta.url);
     const __dirname2 = dirname3(__filename2);
-    const bundledPath = join8(__dirname2, "..", "package.json");
-    const sourcePath = join8(__dirname2, "..", "..", "package.json");
-    if (existsSync7(bundledPath)) {
+    const bundledPath = join9(__dirname2, "..", "package.json");
+    const sourcePath = join9(__dirname2, "..", "..", "package.json");
+    if (existsSync8(bundledPath)) {
       const pkg = JSON.parse(readFileSync6(bundledPath, "utf-8"));
       if (pkg.name === "@locusai/cli") {
         return pkg.version || "0.0.0";
       }
     }
-    if (existsSync7(sourcePath)) {
+    if (existsSync8(sourcePath)) {
       const pkg = JSON.parse(readFileSync6(sourcePath, "utf-8"));
       if (pkg.name === "@locusai/cli") {
         return pkg.version || "0.0.0";
@@ -40190,12 +40383,12 @@ function printBanner() {
 }
 // src/utils/helpers.ts
 init_index_node();
-import { existsSync as existsSync8 } from "node:fs";
-import { join as join9 } from "node:path";
+import { existsSync as existsSync9 } from "node:fs";
+import { join as join10 } from "node:path";
 function isProjectInitialized(projectPath) {
-  const locusDir = join9(projectPath, LOCUS_CONFIG.dir);
-  const configPath = join9(locusDir, LOCUS_CONFIG.configFile);
-  return existsSync8(locusDir) && existsSync8(configPath);
+  const locusDir = join10(projectPath, LOCUS_CONFIG.dir);
+  const configPath = join10(locusDir, LOCUS_CONFIG.configFile);
+  return existsSync9(locusDir) && existsSync9(configPath);
 }
 function requireInitialization(projectPath, command) {
   if (!isProjectInitialized(projectPath)) {
@@ -40520,6 +40713,7 @@ function showHelp2() {
     ${c.success("init")}      Initialize Locus in the current directory
     ${c.success("index")}     Index the codebase for AI context
     ${c.success("run")}       Start an agent to work on tasks
+    ${c.success("review")}    Review staged changes with AI
     ${c.success("exec")}      Run a prompt with repository context
               ${c.dim("--interactive, -i  Start interactive REPL mode")}
               ${c.dim("--session, -s <id> Resume a previous session")}
@@ -40536,6 +40730,7 @@ function showHelp2() {
     ${c.dim("$")} ${c.primary("locus init")}
     ${c.dim("$")} ${c.primary("locus index")}
     ${c.dim("$")} ${c.primary("locus run --api-key YOUR_KEY")}
+    ${c.dim("$")} ${c.primary("locus review")}
     ${c.dim("$")} ${c.primary("locus exec sessions list")}
 
   For more information, visit: ${c.underline("https://locusai.dev/docs")}
@@ -40547,8 +40742,8 @@ import { parseArgs as parseArgs2 } from "node:util";
 
 // src/config-manager.ts
 init_index_node();
-import { existsSync as existsSync9, mkdirSync as mkdirSync4, readFileSync as readFileSync7, writeFileSync as writeFileSync4 } from "node:fs";
-import { join as join10 } from "node:path";
+import { existsSync as existsSync10, mkdirSync as mkdirSync5, readFileSync as readFileSync7, writeFileSync as writeFileSync5 } from "node:fs";
+import { join as join11 } from "node:path";
 
 // src/templates/skills.ts
 var DEFAULT_SKILLS = [
@@ -40837,12 +41032,53 @@ Guidance for understanding and maintaining the overall project architecture.
 
 // src/config-manager.ts
 var LOCUS_GITIGNORE_MARKER = "# Locus AI";
+var CLAUDE_MD_TEMPLATE = `# CLAUDE.md
+
+## Planning First
+
+Every task must be planned before writing code. Create \`.locus/plans/<task-name>.md\` with: goal, approach, affected files, and acceptance criteria. Update the plan if the approach changes. Mark complete when done.
+
+## Code
+
+- Follow the existing formatter, linter, and code style. Run them before finishing.
+- Keep changes minimal and atomic. Separate refactors from behavioral changes.
+- No new dependencies without explicit approval.
+- Never put raw secrets or credentials in the codebase.
+
+## Testing
+
+- Every behavioral change needs a test. Bug fixes need a regression test.
+- Run the relevant test suite before marking work complete.
+- Don't modify tests just to make them pass — understand why they fail.
+
+## Communication
+
+- If the plan needs to change, update it and explain why before continuing.
+`;
 function updateGitignore(projectPath) {
-  const gitignorePath = join10(projectPath, ".gitignore");
+  const gitignorePath = join11(projectPath, ".gitignore");
   let content = "";
-  if (existsSync9(gitignorePath)) {
+  const locusBlock = LOCUS_GITIGNORE_PATTERNS.join(`
+`);
+  if (existsSync10(gitignorePath)) {
     content = readFileSync7(gitignorePath, "utf-8");
     if (content.includes(LOCUS_GITIGNORE_MARKER)) {
+      const lines = content.split(`
+`);
+      const startIdx = lines.findIndex((l) => l.includes(LOCUS_GITIGNORE_MARKER));
+      let endIdx = startIdx;
+      for (let i = startIdx;i < lines.length; i++) {
+        if (lines[i].startsWith(LOCUS_GITIGNORE_MARKER) || lines[i].startsWith(".locus/") || lines[i].trim() === "") {
+          endIdx = i;
+        } else {
+          break;
+        }
+      }
+      const before = lines.slice(0, startIdx);
+      const after = lines.slice(endIdx + 1);
+      content = [...before, locusBlock, ...after].join(`
+`);
+      writeFileSync5(gitignorePath, content);
       return;
     }
     if (content.length > 0 && !content.endsWith(`
@@ -40855,10 +41091,9 @@ function updateGitignore(projectPath) {
 `;
     }
   }
-  content += `${LOCUS_GITIGNORE_PATTERNS.join(`
-`)}
+  content += `${locusBlock}
 `;
-  writeFileSync4(gitignorePath, content);
+  writeFileSync5(gitignorePath, content);
 }
 
 class ConfigManager {
@@ -40867,27 +41102,35 @@ class ConfigManager {
     this.projectPath = projectPath;
   }
   async init(version2) {
-    const locusConfigDir = join10(this.projectPath, LOCUS_CONFIG.dir);
+    const locusConfigDir = join11(this.projectPath, LOCUS_CONFIG.dir);
     const locusConfigPath = getLocusPath(this.projectPath, "configFile");
     const claudeMdPath = getLocusPath(this.projectPath, "contextFile");
-    if (!existsSync9(claudeMdPath)) {
-      const template = `# Locus Project Context
-
-# Workflow
-- Run lint and typecheck before completion
-`;
-      writeFileSync4(claudeMdPath, template);
+    if (!existsSync10(claudeMdPath)) {
+      writeFileSync5(claudeMdPath, CLAUDE_MD_TEMPLATE);
     }
-    if (!existsSync9(locusConfigDir)) {
-      mkdirSync4(locusConfigDir, { recursive: true });
+    if (!existsSync10(locusConfigDir)) {
+      mkdirSync5(locusConfigDir, { recursive: true });
     }
-    if (!existsSync9(locusConfigPath)) {
+    const locusSubdirs = [
+      LOCUS_CONFIG.artifactsDir,
+      LOCUS_CONFIG.documentsDir,
+      LOCUS_CONFIG.sessionsDir,
+      LOCUS_CONFIG.reviewsDir,
+      LOCUS_CONFIG.plansDir
+    ];
+    for (const subdir of locusSubdirs) {
+      const subdirPath = join11(locusConfigDir, subdir);
+      if (!existsSync10(subdirPath)) {
+        mkdirSync5(subdirPath, { recursive: true });
+      }
+    }
+    if (!existsSync10(locusConfigPath)) {
       const config2 = {
         version: version2,
         createdAt: new Date().toISOString(),
         projectPath: "."
       };
-      writeFileSync4(locusConfigPath, JSON.stringify(config2, null, 2));
+      writeFileSync5(locusConfigPath, JSON.stringify(config2, null, 2));
     }
     const skillLocations = [
       LOCUS_CONFIG.agentSkillsDir,
@@ -40897,15 +41140,15 @@ class ConfigManager {
       ".gemini/skills"
     ];
     for (const location of skillLocations) {
-      const skillsDir = join10(this.projectPath, location);
-      if (!existsSync9(skillsDir)) {
-        mkdirSync4(skillsDir, { recursive: true });
+      const skillsDir = join11(this.projectPath, location);
+      if (!existsSync10(skillsDir)) {
+        mkdirSync5(skillsDir, { recursive: true });
       }
       for (const skill of DEFAULT_SKILLS) {
-        const skillPath = join10(skillsDir, skill.name);
-        if (!existsSync9(skillPath)) {
-          mkdirSync4(skillPath, { recursive: true });
-          writeFileSync4(join10(skillPath, "SKILL.md"), skill.content);
+        const skillPath = join11(skillsDir, skill.name);
+        if (!existsSync10(skillPath)) {
+          mkdirSync5(skillPath, { recursive: true });
+          writeFileSync5(join11(skillPath, "SKILL.md"), skill.content);
         }
       }
     }
@@ -40913,7 +41156,7 @@ class ConfigManager {
   }
   loadConfig() {
     const path3 = getLocusPath(this.projectPath, "configFile");
-    if (existsSync9(path3)) {
+    if (existsSync10(path3)) {
       return JSON.parse(readFileSync7(path3, "utf-8"));
     }
     return null;
@@ -40933,7 +41176,7 @@ class ConfigManager {
       skillsCreated: [],
       gitignoreUpdated: false
     };
-    const locusConfigDir = join10(this.projectPath, LOCUS_CONFIG.dir);
+    const locusConfigDir = join11(this.projectPath, LOCUS_CONFIG.dir);
     const claudeMdPath = getLocusPath(this.projectPath, "contextFile");
     const config2 = this.loadConfig();
     if (config2) {
@@ -40944,24 +41187,21 @@ class ConfigManager {
         result.versionUpdated = true;
       }
     }
-    if (!existsSync9(claudeMdPath)) {
-      const template = `# Locus Project Context
-
-# Workflow
-- Run lint and typecheck before completion
-`;
-      writeFileSync4(claudeMdPath, template);
+    if (!existsSync10(claudeMdPath)) {
+      writeFileSync5(claudeMdPath, CLAUDE_MD_TEMPLATE);
       result.directoriesCreated.push("CLAUDE.md");
     }
     const locusSubdirs = [
       LOCUS_CONFIG.artifactsDir,
       LOCUS_CONFIG.documentsDir,
-      LOCUS_CONFIG.sessionsDir
+      LOCUS_CONFIG.sessionsDir,
+      LOCUS_CONFIG.reviewsDir,
+      LOCUS_CONFIG.plansDir
     ];
     for (const subdir of locusSubdirs) {
-      const subdirPath = join10(locusConfigDir, subdir);
-      if (!existsSync9(subdirPath)) {
-        mkdirSync4(subdirPath, { recursive: true });
+      const subdirPath = join11(locusConfigDir, subdir);
+      if (!existsSync10(subdirPath)) {
+        mkdirSync5(subdirPath, { recursive: true });
         result.directoriesCreated.push(`.locus/${subdir}`);
       }
     }
@@ -40973,24 +41213,25 @@ class ConfigManager {
       ".gemini/skills"
     ];
     for (const location of skillLocations) {
-      const skillsDir = join10(this.projectPath, location);
-      if (!existsSync9(skillsDir)) {
-        mkdirSync4(skillsDir, { recursive: true });
+      const skillsDir = join11(this.projectPath, location);
+      if (!existsSync10(skillsDir)) {
+        mkdirSync5(skillsDir, { recursive: true });
         result.directoriesCreated.push(location);
       }
       for (const skill of DEFAULT_SKILLS) {
-        const skillPath = join10(skillsDir, skill.name);
-        if (!existsSync9(skillPath)) {
-          mkdirSync4(skillPath, { recursive: true });
-          writeFileSync4(join10(skillPath, "SKILL.md"), skill.content);
+        const skillPath = join11(skillsDir, skill.name);
+        if (!existsSync10(skillPath)) {
+          mkdirSync5(skillPath, { recursive: true });
+          writeFileSync5(join11(skillPath, "SKILL.md"), skill.content);
           result.skillsCreated.push(`${location}/${skill.name}`);
         }
       }
     }
-    const gitignorePath = join10(this.projectPath, ".gitignore");
-    const hadLocusPatterns = existsSync9(gitignorePath) && readFileSync7(gitignorePath, "utf-8").includes(LOCUS_GITIGNORE_MARKER);
+    const gitignorePath = join11(this.projectPath, ".gitignore");
+    const gitignoreBefore = existsSync10(gitignorePath) ? readFileSync7(gitignorePath, "utf-8") : "";
     updateGitignore(this.projectPath);
-    if (!hadLocusPatterns) {
+    const gitignoreAfter = readFileSync7(gitignorePath, "utf-8");
+    if (gitignoreBefore !== gitignoreAfter) {
       result.gitignoreUpdated = true;
     }
     return result;
@@ -41007,7 +41248,7 @@ class ConfigManager {
   }
   saveConfig(config2) {
     const path3 = getLocusPath(this.projectPath, "configFile");
-    writeFileSync4(path3, JSON.stringify(config2, null, 2));
+    writeFileSync5(path3, JSON.stringify(config2, null, 2));
   }
 }
 
@@ -41027,7 +41268,7 @@ Return ONLY a JSON object with this structure:
 
 File Tree:
 ${tree}`;
-    const output = await this.aiRunner.run(prompt, true);
+    const output = await this.aiRunner.run(prompt);
     const jsonMatch = output.match(/\{[\s\S]*\}/);
     if (jsonMatch)
       return JSON.parse(jsonMatch[0]);
@@ -41135,9 +41376,69 @@ async function initCommand() {
   For more information, visit: ${c.underline("https://locusai.dev/docs")}
 `);
 }
-// src/commands/run.ts
+// src/commands/review.ts
 init_index_node();
+import { existsSync as existsSync11, mkdirSync as mkdirSync6, writeFileSync as writeFileSync6 } from "node:fs";
+import { join as join12 } from "node:path";
 import { parseArgs as parseArgs3 } from "node:util";
+async function reviewCommand(args) {
+  const { values } = parseArgs3({
+    args,
+    options: {
+      model: { type: "string" },
+      provider: { type: "string" },
+      dir: { type: "string" }
+    },
+    strict: false
+  });
+  const projectPath = values.dir || process.cwd();
+  requireInitialization(projectPath, "review");
+  const provider = resolveProvider2(values.provider);
+  const model = values.model || DEFAULT_MODEL[provider];
+  const aiRunner = createAiRunner(provider, {
+    projectPath,
+    model
+  });
+  const reviewService = new ReviewService({
+    aiRunner,
+    projectPath,
+    log: (msg, level) => {
+      switch (level) {
+        case "error":
+          console.log(`  ${c.error("✖")} ${msg}`);
+          break;
+        case "success":
+          console.log(`  ${c.success("✔")} ${msg}`);
+          break;
+        default:
+          console.log(`  ${c.dim(msg)}`);
+      }
+    }
+  });
+  console.log(`
+  ${c.primary("\uD83D\uDD0D")} ${c.bold("Reviewing staged changes...")}
+`);
+  const report = await reviewService.reviewStagedChanges(null);
+  if (!report) {
+    console.log(`  ${c.dim("No changes to review.")}
+`);
+    return;
+  }
+  const reviewsDir = join12(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.reviewsDir);
+  if (!existsSync11(reviewsDir)) {
+    mkdirSync6(reviewsDir, { recursive: true });
+  }
+  const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+  const reportPath = join12(reviewsDir, `review-${timestamp}.md`);
+  writeFileSync6(reportPath, report, "utf-8");
+  console.log(`
+  ${c.success("✔")} ${c.success("Review complete!")}`);
+  console.log(`  ${c.dim("Report saved to:")} ${c.primary(reportPath)}
+`);
+}
+// src/commands/run.ts
+init_index_node();
+import { parseArgs as parseArgs4 } from "node:util";
 
 // src/workspace-resolver.ts
 init_index_node();
@@ -41178,7 +41479,7 @@ class WorkspaceResolver {
 
 // src/commands/run.ts
 async function runCommand(args) {
-  const { values } = parseArgs3({
+  const { values } = parseArgs4({
     args,
     options: {
       "api-key": { type: "string" },
@@ -41262,6 +41563,9 @@ async function main() {
     case "exec":
       await execCommand(args);
       break;
+    case "review":
+      await reviewCommand(args);
+      break;
     default:
       showHelp2();
   }