@locusai/sdk 0.11.8 → 0.12.1

package/dist/agent/worker.js

@@ -522,9 +522,6 @@ var init_src = __esm(() => {
 
 // src/core/config.ts
 function getLocusPath(projectPath, fileName) {
-  if (fileName === "projectContextFile" || fileName === "projectProgressFile") {
-    return import_node_path.join(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.projectDir, LOCUS_CONFIG[fileName]);
-  }
   return import_node_path.join(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG[fileName]);
 }
 function getAgentArtifactsPath(projectPath, agentId) {
@@ -552,14 +549,12 @@ var init_config = __esm(() => {
     settingsFile: "settings.json",
     indexFile: "codebase-index.json",
     contextFile: "LOCUS.md",
+    learningsFile: "LEARNINGS.md",
     artifactsDir: "artifacts",
     documentsDir: "documents",
     sessionsDir: "sessions",
     reviewsDir: "reviews",
-    plansDir: "plans",
-    projectDir: "project",
-    projectContextFile: "context.md",
-    projectProgressFile: "progress.md"
+    plansDir: "plans"
   };
   LOCUS_GITIGNORE_PATTERNS = [
     "# Locus AI - Session data (user-specific, can grow large)",
@@ -577,11 +572,8 @@ var init_config = __esm(() => {
     "# Locus AI - Settings (contains API key, telegram config, etc.)",
     ".locus/settings.json",
     "",
-    "# Locus AI - Configuration (contains project context, progress, etc.)",
-    ".locus/config.json",
-    "",
-    "# Locus AI - Project progress (contains project progress, etc.)",
-    ".locus/project/progress.md"
+    "# Locus AI - Configuration (contains project context, etc.)",
+    ".locus/config.json"
   ];
 });
 
@@ -820,17 +812,22 @@ class ClaudeRunner {
       });
     });
   }
-  async* runStream(prompt) {
+  buildCliArgs() {
     const args = [
-      "--dangerously-skip-permissions",
       "--print",
-      "--verbose",
       "--output-format",
       "stream-json",
+      "--verbose",
+      "--dangerously-skip-permissions",
+      "--no-session-persistence",
       "--include-partial-messages",
       "--model",
       this.model
     ];
+    return args;
+  }
+  async* runStream(prompt) {
+    const args = this.buildCliArgs();
     const env = getAugmentedEnv({
       FORCE_COLOR: "1",
       TERM: "xterm-256color"
@@ -1070,16 +1067,7 @@ class ClaudeRunner {
   }
   executeRun(prompt) {
     return new Promise((resolve2, reject) => {
-      const args = [
-        "--dangerously-skip-permissions",
-        "--print",
-        "--verbose",
-        "--output-format",
-        "stream-json",
-        "--include-partial-messages",
-        "--model",
-        this.model
-      ];
+      const args = this.buildCliArgs();
       const env = getAugmentedEnv({
         FORCE_COLOR: "1",
         TERM: "xterm-256color"
@@ -1200,7 +1188,7 @@ class CodexRunner {
   eventEmitter;
   currentToolName;
   timeoutMs;
-  constructor(projectPath, model = DEFAULT_MODEL[PROVIDER.CODEX], log, timeoutMs, reasoningEffort) {
+  constructor(projectPath, model = DEFAULT_MODEL[PROVIDER.CODEX], log, reasoningEffort, timeoutMs) {
     this.projectPath = projectPath;
     this.model = model;
     this.log = log;
@@ -1531,7 +1519,7 @@ function createAiRunner(provider, config) {
   const model = config.model ?? DEFAULT_MODEL[resolvedProvider];
   switch (resolvedProvider) {
     case PROVIDER.CODEX:
-      return new CodexRunner(config.projectPath, model, config.log, config.timeoutMs, config.reasoningEffort ?? "high");
+      return new CodexRunner(config.projectPath, model, config.log, config.reasoningEffort ?? "high", config.timeoutMs);
     default:
       return new ClaudeRunner(config.projectPath, model, config.log, config.timeoutMs);
   }
@@ -1638,106 +1626,6 @@ var init_git_utils = __esm(() => {
   import_node_child_process3 = require("node:child_process");
 });
 
-// src/project/knowledge-base.ts
-class KnowledgeBase {
-  contextPath;
-  progressPath;
-  constructor(projectPath) {
-    this.contextPath = getLocusPath(projectPath, "projectContextFile");
-    this.progressPath = getLocusPath(projectPath, "projectProgressFile");
-  }
-  readContext() {
-    if (!import_node_fs3.existsSync(this.contextPath)) {
-      return "";
-    }
-    return import_node_fs3.readFileSync(this.contextPath, "utf-8");
-  }
-  readProgress() {
-    if (!import_node_fs3.existsSync(this.progressPath)) {
-      return "";
-    }
-    return import_node_fs3.readFileSync(this.progressPath, "utf-8");
-  }
-  updateContext(content) {
-    this.ensureDir(this.contextPath);
-    import_node_fs3.writeFileSync(this.contextPath, content);
-  }
-  updateProgress(entry) {
-    this.ensureDir(this.progressPath);
-    const existing = this.readProgress();
-    const timestamp = (entry.timestamp ?? new Date).toISOString();
-    const label = entry.role === "user" ? "User" : "Assistant";
-    const line = `**${label}** (${timestamp}):
-${entry.content}`;
-    const updated = existing ? `${existing}
-
----
-
-${line}` : `# Conversation History
-
-${line}`;
-    import_node_fs3.writeFileSync(this.progressPath, updated);
-  }
-  getFullContext() {
-    const context = this.readContext();
-    const progress = this.readProgress();
-    const parts = [];
-    if (context.trim()) {
-      parts.push(context.trim());
-    }
-    if (progress.trim()) {
-      parts.push(progress.trim());
-    }
-    return parts.join(`
-
----
-
-`);
-  }
-  initialize(info) {
-    this.ensureDir(this.contextPath);
-    this.ensureDir(this.progressPath);
-    const techStackList = info.techStack.map((t) => `- ${t}`).join(`
-`);
-    const contextContent = `# Project: ${info.name}
-
-## Mission
-${info.mission}
-
-## Tech Stack
-${techStackList}
-
-## Architecture
-<!-- Describe your high-level architecture here -->
-
-## Key Decisions
-<!-- Document important technical decisions and their rationale -->
-
-## Feature Areas
-<!-- List your main feature areas and their status -->
-`;
-    const progressContent = `# Conversation History
-`;
-    import_node_fs3.writeFileSync(this.contextPath, contextContent);
-    import_node_fs3.writeFileSync(this.progressPath, progressContent);
-  }
-  get exists() {
-    return import_node_fs3.existsSync(this.contextPath) || import_node_fs3.existsSync(this.progressPath);
-  }
-  ensureDir(filePath) {
-    const dir = import_node_path5.dirname(filePath);
-    if (!import_node_fs3.existsSync(dir)) {
-      import_node_fs3.mkdirSync(dir, { recursive: true });
-    }
-  }
-}
-var import_node_fs3, import_node_path5;
-var init_knowledge_base = __esm(() => {
-  init_config();
-  import_node_fs3 = require("node:fs");
-  import_node_path5 = require("node:path");
-});
-
 // src/agent/git-workflow.ts
 class GitWorkflow {
   config;
@@ -1989,239 +1877,157 @@ class PromptBuilder {
   constructor(projectPath) {
     this.projectPath = projectPath;
   }
-  async build(task, options = {}) {
-    let prompt = `# Task: ${task.title}
-
-`;
+  async build(task) {
     const roleText = this.roleToText(task.assigneeRole);
+    const description = task.description || "No description provided.";
+    const context = this.getProjectContext();
+    const learnings = this.getLearningsContent();
+    const knowledgeBase = this.getKnowledgeBaseSection();
+    let sections = "";
     if (roleText) {
-      prompt += `## Role
+      sections += `
+<role>
 You are acting as a ${roleText}.
-
+</role>
 `;
     }
-    prompt += `## Description
-${task.description || "No description provided."}
-
-`;
-    const projectConfig = this.getProjectConfig();
-    if (projectConfig) {
-      prompt += `## Project Metadata
-`;
-      prompt += `- Version: ${projectConfig.version || "Unknown"}
-`;
-      prompt += `- Created At: ${projectConfig.createdAt || "Unknown"}
-
-`;
-    }
-    let serverContext = null;
-    if (options.taskContext) {
-      try {
-        serverContext = JSON.parse(options.taskContext);
-      } catch {
-        serverContext = { context: options.taskContext };
-      }
-    }
-    const contextPath = getLocusPath(this.projectPath, "contextFile");
-    let hasLocalContext = false;
-    if (import_node_fs4.existsSync(contextPath)) {
-      try {
-        const context = import_node_fs4.readFileSync(contextPath, "utf-8");
-        if (context.trim().length > 20) {
-          prompt += `## Project Context (Local)
+    if (context) {
+      sections += `
+<project_context>
 ${context}
-
-`;
-          hasLocalContext = true;
-        }
-      } catch (err) {
-        console.warn(`Warning: Could not read context file: ${err}`);
-      }
-    }
-    if (!hasLocalContext) {
-      const fallback = this.getFallbackContext();
-      if (fallback) {
-        prompt += `## Project Context (README Fallback)
-${fallback}
-
+</project_context>
 `;
-      }
     }
-    if (serverContext) {
-      prompt += `## Project Context (Server)
-`;
-      const project = serverContext.project;
-      if (project) {
-        prompt += `- Project: ${project.name || "Unknown"}
+    sections += `
+<knowledge_base>
+${knowledgeBase}
+</knowledge_base>
 `;
-        if (!hasLocalContext && project.techStack?.length) {
-          prompt += `- Tech Stack: ${project.techStack.join(", ")}
-`;
-        }
-      }
-      if (serverContext.context) {
-        prompt += `
-${serverContext.context}
-`;
-      }
-      prompt += `
-`;
-    }
-    prompt += this.getProjectStructure();
-    prompt += `## Project Knowledge Base
-`;
-    prompt += `You have access to the following documentation directories for context:
-`;
-    prompt += `- Artifacts: \`.locus/artifacts\`
-`;
-    prompt += `- Documents: \`.locus/documents\`
-`;
-    prompt += `If you need more information about the project strategies, plans, or architecture, please read files in these directories.
-
-`;
-    const indexPath = getLocusPath(this.projectPath, "indexFile");
-    if (import_node_fs4.existsSync(indexPath)) {
-      prompt += `## Codebase Overview
-There is an index file in the .locus/codebase-index.json and if you need you can check it.
-
+    if (learnings) {
+      sections += `
+<learnings>
+These are accumulated lessons from past tasks. Follow them to avoid repeating mistakes:
+${learnings}
+</learnings>
 `;
     }
     if (task.docs && task.docs.length > 0) {
-      prompt += `## Attached Documents (Summarized)
-`;
-      prompt += `> Full content available on server. Rely on Task Description for specific requirements.
-
-`;
+      let docsContent = "";
       for (const doc of task.docs) {
         const content = doc.content || "";
         const limit = 800;
         const preview = content.slice(0, limit);
         const isTruncated = content.length > limit;
-        prompt += `### Doc: ${doc.title}
+        docsContent += `### ${doc.title}
 ${preview}${isTruncated ? `
 ...(truncated)...` : ""}
 
 `;
       }
+      sections += `
+<documents>
+${docsContent.trimEnd()}
+</documents>
+`;
     }
     if (task.acceptanceChecklist && task.acceptanceChecklist.length > 0) {
-      prompt += `## Acceptance Criteria
-`;
+      let criteria = "";
       for (const item of task.acceptanceChecklist) {
-        prompt += `- ${item.done ? "[x]" : "[ ]"} ${item.text}
+        criteria += `- ${item.done ? "[x]" : "[ ]"} ${item.text}
 `;
       }
-      prompt += `
+      sections += `
+<acceptance_criteria>
+${criteria.trimEnd()}
+</acceptance_criteria>
 `;
     }
     if (task.comments && task.comments.length > 0) {
-      const comments = task.comments.slice(0, 3);
-      prompt += `## Task History & Feedback
-`;
-      prompt += `Review the following comments for context or rejection feedback:
-
+      const filteredComments = task.comments.filter((comment) => comment.author !== "system");
+      const comments = filteredComments.slice(0, 3);
+      if (comments.length > 0) {
+        let commentsContent = "";
+        for (const comment of comments) {
+          const date = new Date(comment.createdAt).toLocaleString();
+          commentsContent += `- ${comment.author} (${date}): ${comment.text}
 `;
-      for (const comment of comments) {
-        const date = new Date(comment.createdAt).toLocaleString();
-        prompt += `### ${comment.author} (${date})
-${comment.text}
-
+        }
+        sections += `
+<feedback>
+${commentsContent.trimEnd()}
+</feedback>
 `;
       }
     }
-    prompt += `## Instructions
-1. Complete this task.
-2. **Artifact Management**: If you create any high-level documentation (PRDs, technical drafts, architecture docs), you MUST save them in \`.locus/artifacts/\`. Do NOT create them in the root directory.
-3. **Paths**: Use relative paths from the project root at all times. Do NOT use absolute local paths (e.g., /Users/...).
-4. **Git**: Do NOT run \`git add\`, \`git commit\`, \`git push\`, or create branches. The Locus system handles all git operations automatically after your execution completes.
-5. **Progress**: Do NOT modify \`.locus/project/progress.md\`. The system updates it automatically.`;
-    return prompt;
+    return `<task_execution>
+Complete this task: ${task.title}
+
+<description>
+${description}
+</description>
+${sections}
+<rules>
+- Complete the task as described
+- Save any high-level documentation (PRDs, technical drafts, architecture docs) in \`.locus/artifacts/\`
+- Use relative paths from the project root at all times — no absolute local paths
+- Do NOT run \`git add\`, \`git commit\`, \`git push\`, or create branches — Locus handles git automatically
+</rules>
+</task_execution>`;
   }
   async buildGenericPrompt(query) {
-    let prompt = `# Direct Execution
-
-`;
-    prompt += `## Prompt
-${query}
-
-`;
-    const projectConfig = this.getProjectConfig();
-    if (projectConfig) {
-      prompt += `## Project Metadata
+    const context = this.getProjectContext();
+    const learnings = this.getLearningsContent();
+    const knowledgeBase = this.getKnowledgeBaseSection();
+    let sections = "";
+    if (context) {
+      sections += `
+<project_context>
+${context}
+</project_context>
 `;
-      prompt += `- Version: ${projectConfig.version || "Unknown"}
+    }
+    sections += `
+<knowledge_base>
+${knowledgeBase}
+</knowledge_base>
 `;
-      prompt += `- Created At: ${projectConfig.createdAt || "Unknown"}
-
+    if (learnings) {
+      sections += `
+<learnings>
+These are accumulated lessons from past tasks. Follow them to avoid repeating mistakes:
+${learnings}
+</learnings>
 `;
     }
+    return `<direct_execution>
+Execute this prompt: ${query}
+${sections}
+<rules>
+- Execute the prompt based on the provided project context
+- Use relative paths from the project root at all times — no absolute local paths
+- Do NOT run \`git add\`, \`git commit\`, \`git push\`, or create branches — Locus handles git automatically
+</rules>
+</direct_execution>`;
+  }
+  getProjectContext() {
     const contextPath = getLocusPath(this.projectPath, "contextFile");
-    let hasLocalContext = false;
-    if (import_node_fs4.existsSync(contextPath)) {
+    if (import_node_fs3.existsSync(contextPath)) {
       try {
-        const context = import_node_fs4.readFileSync(contextPath, "utf-8");
+        const context = import_node_fs3.readFileSync(contextPath, "utf-8");
         if (context.trim().length > 20) {
-          prompt += `## Project Context (Local)
-${context}
-
-`;
-          hasLocalContext = true;
+          return context;
         }
       } catch (err) {
         console.warn(`Warning: Could not read context file: ${err}`);
       }
     }
-    if (!hasLocalContext) {
-      const fallback = this.getFallbackContext();
-      if (fallback) {
-        prompt += `## Project Context (README Fallback)
-${fallback}
-
-`;
-      }
-    }
-    prompt += this.getProjectStructure();
-    prompt += `## Project Knowledge Base
-`;
-    prompt += `You have access to the following documentation directories for context:
-`;
-    prompt += `- Artifacts: \`.locus/artifacts\` (local-only, not synced to cloud)
-`;
-    prompt += `- Documents: \`.locus/documents\` (synced from cloud)
-`;
-    prompt += `If you need more information about the project strategies, plans, or architecture, please read files in these directories.
-
-`;
-    const indexPath = getLocusPath(this.projectPath, "indexFile");
-    if (import_node_fs4.existsSync(indexPath)) {
-      prompt += `## Codebase Overview
-There is an index file in the .locus/codebase-index.json and if you need you can check it.
-
-`;
-    }
-    prompt += `## Instructions
-1. Execute the prompt based on the provided project context.
-2. **Paths**: Use relative paths from the project root at all times. Do NOT use absolute local paths (e.g., /Users/...).
-3. **Git**: Do NOT run \`git add\`, \`git commit\`, \`git push\`, or create branches. The Locus system handles all git operations automatically after your execution completes.
-4. **Progress**: Do NOT modify \`.locus/project/progress.md\`. The system updates it automatically.`;
-    return prompt;
-  }
-  getProjectConfig() {
-    const configPath = getLocusPath(this.projectPath, "configFile");
-    if (import_node_fs4.existsSync(configPath)) {
-      try {
-        return JSON.parse(import_node_fs4.readFileSync(configPath, "utf-8"));
-      } catch {
-        return null;
-      }
-    }
-    return null;
+    return this.getFallbackContext() || null;
   }
   getFallbackContext() {
-    const readmePath = import_node_path6.join(this.projectPath, "README.md");
-    if (import_node_fs4.existsSync(readmePath)) {
+    const readmePath = import_node_path5.join(this.projectPath, "README.md");
+    if (import_node_fs3.existsSync(readmePath)) {
       try {
-        const content = import_node_fs4.readFileSync(readmePath, "utf-8");
+        const content = import_node_fs3.readFileSync(readmePath, "utf-8");
         const limit = 1000;
         return content.slice(0, limit) + (content.length > limit ? `
 ...(truncated)...` : "");
@@ -2231,32 +2037,28 @@ There is an index file in the .locus/codebase-index.json and if you need you can
     }
     return "";
   }
-  getProjectStructure() {
+  getKnowledgeBaseSection() {
+    return `You have access to the following documentation directories for context:
+- Artifacts: \`.locus/artifacts\` (local-only, not synced to cloud)
+- Documents: \`.locus/documents\` (synced from cloud)
+If you need more information about the project strategies, plans, or architecture, read files in these directories.`;
+  }
+  getLearningsContent() {
+    const learningsPath = getLocusPath(this.projectPath, "learningsFile");
+    if (!import_node_fs3.existsSync(learningsPath)) {
+      return null;
+    }
     try {
-      const entries = import_node_fs4.readdirSync(this.projectPath);
-      const folders = entries.filter((e) => {
-        if (e.startsWith(".") || e === "node_modules")
-          return false;
-        try {
-          return import_node_fs4.statSync(import_node_path6.join(this.projectPath, e)).isDirectory();
-        } catch {
-          return false;
-        }
-      });
-      if (folders.length === 0)
-        return "";
-      let structure = `## Project Structure
-`;
-      structure += `Key directories in this project:
-`;
-      for (const folder of folders) {
-        structure += `- \`${folder}/\`
-`;
+      const content = import_node_fs3.readFileSync(learningsPath, "utf-8");
+      const lines = content.split(`
+`).filter((l) => l.startsWith("- "));
+      if (lines.length === 0) {
+        return null;
       }
-      return `${structure}
-`;
+      return lines.join(`
+`);
     } catch {
-      return "";
+      return null;
     }
   }
   roleToText(role) {
@@ -2279,11 +2081,11 @@ There is an index file in the .locus/codebase-index.json and if you need you can
     }
   }
 }
-var import_node_fs4, import_node_path6, import_shared2;
+var import_node_fs3, import_node_path5, import_shared2;
 var init_prompt_builder = __esm(() => {
   init_config();
-  import_node_fs4 = require("node:fs");
-  import_node_path6 = require("node:path");
+  import_node_fs3 = require("node:fs");
+  import_node_path5 = require("node:path");
   import_shared2 = require("@locusai/shared");
 });
 
@@ -2401,7 +2203,6 @@ class AgentWorker {
   client;
   aiRunner;
   taskExecutor;
-  knowledgeBase;
   gitWorkflow;
   maxTasks = 50;
   tasksCompleted = 0;
@@ -2441,7 +2242,6 @@ class AgentWorker {
       projectPath,
       log
     });
-    this.knowledgeBase = new KnowledgeBase(projectPath);
     this.gitWorkflow = new GitWorkflow(config, log);
     const providerLabel = provider === "codex" ? "Codex" : "Claude";
     this.log(`Using ${providerLabel} CLI for all phases`, "info");
@@ -2515,20 +2315,6 @@ class AgentWorker {
       };
     }
   }
-  updateProgress(task, summary) {
-    try {
-      this.knowledgeBase.updateProgress({
-        role: "user",
-        content: task.title
-      });
-      this.knowledgeBase.updateProgress({
-        role: "assistant",
-        content: summary
-      });
-    } catch (err) {
-      this.log(`Failed to update progress: ${err instanceof Error ? err.message : String(err)}`, "warn");
-    }
-  }
   startHeartbeat() {
     this.sendHeartbeat();
     this.heartbeatInterval = setInterval(() => this.sendHeartbeat(), 60000);
@@ -2582,7 +2368,7 @@ class AgentWorker {
             assignedTo: null
           });
           await this.client.tasks.addComment(task.id, this.config.workspaceId, {
-            author: this.config.agentId,
+            author: "system",
             text: `⚠️ Agent execution finished with no file changes, so no commit was created.
 
 ${result.summary}`
@@ -2597,13 +2383,12 @@ ${result.summary}`
 
 Branch: \`${result.branch}\`` : "";
           await this.client.tasks.addComment(task.id, this.config.workspaceId, {
-            author: this.config.agentId,
+            author: "system",
             text: `✅ ${result.summary}${branchInfo}`
           });
           this.tasksCompleted++;
           this.completedTaskList.push({ title: task.title, id: task.id });
           this.taskSummaries.push(result.summary);
-          this.updateProgress(task, result.summary);
         }
       } else {
         this.log(`Failed: ${task.title} - ${result.summary}`, "error");
@@ -2612,7 +2397,7 @@ Branch: \`${result.branch}\`` : "";
           assignedTo: null
         });
         await this.client.tasks.addComment(task.id, this.config.workspaceId, {
-          author: this.config.agentId,
+          author: "system",
           text: `❌ ${result.summary}`
         });
       }
@@ -2648,7 +2433,6 @@ var init_worker = __esm(() => {
   init_config();
   init_git_utils();
   init_src();
-  init_knowledge_base();
   init_colors();
   init_git_workflow();
   init_task_executor();

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

@@ -22,6 +22,7 @@ export declare class ClaudeRunner implements AiRunner {
     abort(): void;
     run(prompt: string): Promise<string>;
     private withTimeout;
+    private buildCliArgs;
     runStream(prompt: string): AsyncGenerator<StreamChunk, void, unknown>;
     /**
      * Emit an event corresponding to a stream chunk.