@locusai/cli 0.7.7 → 0.8.1

package/README.md

@@ -0,0 +1,155 @@
+# @locusai/cli
+
+Command-line interface for [Locus](https://locusai.dev) - an AI-native project management platform for engineering teams.
+
+## Installation
+
+```bash
+npm install -g @locusai/cli
+```
+
+Or with other package managers:
+
+```bash
+# pnpm
+pnpm add -g @locusai/cli
+
+# yarn
+yarn global add @locusai/cli
+
+# bun
+bun add -g @locusai/cli
+```
+
+## Quick Start
+
+```bash
+# Initialize Locus in your project
+locus init
+
+# Index your codebase for AI context
+locus index
+
+# Run an agent to work on tasks
+locus run --api-key YOUR_API_KEY
+
+# Execute a prompt with repository context
+locus exec "Explain the authentication flow"
+```
+
+## Commands
+
+### `locus init`
+
+Initialize Locus in the current directory. Creates the necessary configuration files and directory structure:
+
+- `.locus/` - Configuration directory
+- `.locus/config.json` - Project settings
+- `CLAUDE.md` - AI instructions and context
+- `.agent/skills/` - Domain-specific agent skills
+
+Running `init` on an already initialized project will update the configuration to the latest version.
+
+### `locus index`
+
+Index the codebase for AI context. This analyzes your project structure and creates a searchable index that helps AI agents understand your codebase.
+
+```bash
+locus index [options]
+
+Options:
+  --dir <path>      Project directory (default: current directory)
+  --model <name>    AI model to use
+  --provider <name> AI provider: claude or codex (default: claude)
+```
+
+### `locus run`
+
+Start an agent to work on tasks from your Locus workspace.
+
+```bash
+locus run [options]
+
+Options:
+  --api-key <key>     Your Locus API key (required)
+  --workspace <id>    Workspace ID to connect to
+  --sprint <id>       Sprint ID to work on
+  --model <name>      AI model to use
+  --provider <name>   AI provider: claude or codex (default: claude)
+  --api-url <url>     Custom API URL
+  --dir <path>        Project directory (default: current directory)
+  --skip-planning     Skip the planning phase
+```
+
+### `locus exec`
+
+Run a prompt with repository context. Supports both single execution and interactive REPL mode.
+
+```bash
+locus exec "your prompt" [options]
+locus exec --interactive [options]
+
+Options:
+  --interactive, -i   Start interactive REPL mode
+  --session, -s <id>  Resume a previous session
+  --model <name>      AI model to use
+  --provider <name>   AI provider: claude or codex (default: claude)
+  --dir <path>        Project directory (default: current directory)
+  --no-stream         Disable streaming output
+  --no-status         Disable status display
+```
+
+#### Session Management
+
+Manage your exec sessions with these subcommands:
+
+```bash
+# List recent sessions
+locus exec sessions list
+
+# Show messages from a session
+locus exec sessions show <session-id>
+
+# Delete a session
+locus exec sessions delete <session-id>
+
+# Clear all sessions
+locus exec sessions clear
+```
+
+## Configuration
+
+Locus stores its configuration in the `.locus/` directory within your project:
+
+- `config.json` - Project settings including workspace ID and version
+- `codebase-index.json` - Indexed codebase structure
+
+The `CLAUDE.md` file in your project root provides AI instructions and context that agents use when working on your codebase.
+
+## AI Providers
+
+Locus supports multiple AI providers:
+
+- **Claude** (default) - Anthropic's Claude models
+- **Codex** - OpenAI Codex models
+
+Specify the provider with the `--provider` flag:
+
+```bash
+locus exec "your prompt" --provider codex
+locus run --api-key YOUR_KEY --provider claude
+```
+
+## Requirements
+
+- Node.js 18 or later
+- A Locus API key (for `run` command)
+
+## Links
+
+- [Documentation](https://locusai.dev/docs)
+- [Website](https://locusai.dev)
+
+## License
+
+MIT

package/bin/agent/worker.js

@@ -17011,6 +17011,10 @@ var require_ignore = __commonJS((exports, module) => {
   define(module.exports, Symbol.for("setupWindows"), setupWindows);
 });
 
+// ../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";
+
 // ../sdk/src/core/config.ts
 import { join } from "node:path";
 var PROVIDER = {
@@ -17029,7 +17033,9 @@ var LOCUS_CONFIG = {
   artifactsDir: "artifacts",
   documentsDir: "documents",
   agentSkillsDir: ".agent/skills",
-  sessionsDir: "sessions"
+  sessionsDir: "sessions",
+  reviewsDir: "reviews",
+  plansDir: "plans"
 };
 function getLocusPath(projectPath, fileName) {
   if (fileName === "contextFile") {
@@ -17120,7 +17126,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++) {
@@ -34981,6 +34987,10 @@ var EventType;
   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 = BaseEntitySchema.extend({
@@ -35046,6 +35056,25 @@ var CiRanPayloadSchema = exports_external.object({
   processed: exports_external.boolean(),
   commands: exports_external.array(exports_external.object({ cmd: exports_external.string(), exitCode: exports_external.number() }))
 });
+var InterviewStartedPayloadSchema = exports_external.object({
+  workspaceName: exports_external.string(),
+  firstFieldName: exports_external.string()
+});
+var InterviewFieldCompletedPayloadSchema = exports_external.object({
+  fieldName: exports_external.string(),
+  completionPercentage: exports_external.number()
+});
+var InterviewCompletedPayloadSchema = exports_external.object({
+  workspaceName: exports_external.string(),
+  timeToCompleteMs: exports_external.number(),
+  completedVia: exports_external.enum(["interview", "manual_bypass"])
+});
+var 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()
+});
 var EventPayloadSchema = exports_external.discriminatedUnion("type", [
   exports_external.object({
     type: exports_external.literal("TASK_CREATED" /* TASK_CREATED */),
@@ -35090,6 +35119,22 @@ var EventPayloadSchema = exports_external.discriminatedUnion("type", [
   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
   })
 ]);
 var EventSchema = exports_external.object({
@@ -35159,7 +35204,7 @@ var UnlockSchema = exports_external.object({
 var AIRoleSchema = exports_external.enum(["user", "assistant", "system"]);
 var 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(),
@@ -35167,13 +35212,7 @@ var AIArtifactSchema = exports_external.object({
 });
 var 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()
 });
 var AIMessageSchema = exports_external.object({
@@ -35436,6 +35475,53 @@ var AcceptInvitationResponseSchema = exports_external.object({
     createdAt: exports_external.number()
   })
 });
+// ../shared/src/models/manifest.ts
+var ProjectPhaseSchema = exports_external.enum([
+  "PLANNING",
+  "MVP_BUILD",
+  "SCALING",
+  "MAINTENANCE"
+]);
+var SprintStatusSchema = exports_external.enum(["PLANNED", "ACTIVE", "COMPLETED"]);
+var ProjectSprintSchema = exports_external.object({
+  id: exports_external.string(),
+  goal: exports_external.string(),
+  tasks: exports_external.array(exports_external.string()),
+  status: SprintStatusSchema
+});
+var MilestoneStatusSchema = exports_external.enum(["PENDING", "COMPLETED"]);
+var ProjectMilestoneSchema = exports_external.object({
+  title: exports_external.string(),
+  date: exports_external.string().optional(),
+  status: MilestoneStatusSchema
+});
+var ProjectTimelineSchema = exports_external.object({
+  sprints: exports_external.array(ProjectSprintSchema),
+  milestones: exports_external.array(ProjectMilestoneSchema)
+});
+var 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()
+});
+var 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()
+});
+var PartialProjectManifestSchema = ProjectManifestSchema.partial();
 // ../shared/src/models/organization.ts
 var OrganizationSchema = BaseEntitySchema.extend({
   name: exports_external.string().min(1, "Name is required").max(100),
@@ -35625,11 +35711,15 @@ var WorkspaceAndUserParamSchema = exports_external.object({
   workspaceId: exports_external.string().uuid("Invalid Workspace ID"),
   userId: exports_external.string().uuid("Invalid User ID")
 });
+var WorkspaceWithManifestInfoSchema = WorkspaceSchema.extend({
+  isManifestComplete: exports_external.boolean(),
+  manifestCompletionPercentage: exports_external.number().min(0).max(100)
+});
 var WorkspaceResponseSchema = exports_external.object({
-  workspace: WorkspaceSchema
+  workspace: WorkspaceWithManifestInfoSchema
 });
 var WorkspacesResponseSchema = exports_external.object({
-  workspaces: exports_external.array(WorkspaceSchema)
+  workspaces: exports_external.array(WorkspaceWithManifestInfoSchema)
 });
 var WorkspaceStatsSchema = exports_external.object({
   workspaceName: exports_external.string(),
@@ -35639,6 +35729,13 @@ var WorkspaceStatsSchema = exports_external.object({
 var WorkspaceStatsResponseSchema = exports_external.object({
   stats: WorkspaceStatsSchema
 });
+var 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()
+});
 // ../sdk/src/modules/tasks.ts
 class TasksModule extends BaseModule {
   async list(workspaceId, options) {
@@ -35728,6 +35825,10 @@ class WorkspacesModule extends BaseModule {
     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 }
@@ -36591,7 +36692,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]);
@@ -36654,6 +36755,66 @@ class DocumentFetcher {
   }
 }
 
+// ../sdk/src/agent/review-service.ts
+import { execSync } from "node:child_process";
+
+class ReviewService {
+  deps;
+  constructor(deps) {
+    this.deps = deps;
+  }
+  async reviewStagedChanges(sprint2) {
+    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 = sprint2 ? `Sprint: ${sprint2.name} (${sprint2.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;
+  }
+}
+
 // ../sdk/src/core/prompt-builder.ts
 import { existsSync as existsSync4, readdirSync, readFileSync as readFileSync4, statSync } from "node:fs";
 import { homedir } from "node:os";
@@ -37018,29 +37179,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);
@@ -37074,11 +37214,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();
@@ -37115,6 +37253,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");
   }
@@ -37160,33 +37303,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 {