@locusai/sdk 0.4.6 → 0.4.9

package/src/core/indexer.ts

@@ -1,131 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { globby } from "globby";
-
-export interface CodebaseIndex {
-  symbols: Record<string, string[]>; // symbol -> file paths
-  responsibilities: Record<string, string>; // file path -> brief summary
-  lastIndexed: string;
-}
-
-export class CodebaseIndexer {
-  private projectPath: string;
-  private indexPath: string;
-
-  constructor(projectPath: string) {
-    this.projectPath = projectPath;
-    this.indexPath = join(projectPath, ".locus", "codebase-index.json");
-  }
-
-  /**
-   * Generates a codebase index by providing the entire file tree to an AI summarizer.
-   * This is much more efficient than per-file indexing for large projects.
-   */
-  async index(
-    onProgress?: (message: string) => void,
-    treeSummarizer?: (tree: string) => Promise<CodebaseIndex>
-  ): Promise<CodebaseIndex> {
-    if (!treeSummarizer) {
-      throw new Error("A treeSummarizer is required for this indexing method.");
-    }
-
-    if (onProgress) onProgress("Generating file tree...");
-
-    // 1. Get a comprehensive but clean file tree
-    const gitmodulesPath = join(this.projectPath, ".gitmodules");
-    const submoduleIgnores: string[] = [];
-    if (existsSync(gitmodulesPath)) {
-      try {
-        const content = readFileSync(gitmodulesPath, "utf-8");
-        const lines = content.split("\n");
-        for (const line of lines) {
-          const match = line.match(/^\s*path\s*=\s*(.*)$/);
-          const path = match?.[1]?.trim();
-          if (path) {
-            submoduleIgnores.push(`${path}/**`);
-            submoduleIgnores.push(`**/${path}/**`);
-          }
-        }
-      } catch {
-        // Fallback if .gitmodules exists but can't be read or parsed
-      }
-    }
-
-    const files = await globby(["**/*"], {
-      cwd: this.projectPath,
-      gitignore: true,
-      ignore: [
-        ...submoduleIgnores,
-        "**/node_modules/**",
-        "**/dist/**",
-        "**/build/**",
-        "**/target/**", // Rust build artifacts
-        "**/bin/**",
-        "**/obj/**",
-        "**/.next/**",
-        "**/.svelte-kit/**",
-        "**/.nuxt/**",
-        "**/.cache/**",
-        "**/out/**",
-        "**/__tests__/**",
-        "**/coverage/**",
-        "**/*.test.*",
-        "**/*.spec.*",
-        "**/*.d.ts",
-        "**/tsconfig.tsbuildinfo",
-        "**/.locus/*.json", // Ignore index and other system JSONs
-        "**/.locus/*.md", // Ignore system MDs
-        "**/.locus/!(artifacts)/**", // Ignore everything in .locus EXCEPT artifacts
-        "**/.git/**",
-        "**/.svn/**",
-        "**/.hg/**",
-        "**/.vscode/**",
-        "**/.idea/**",
-        "**/.DS_Store",
-        "**/bun.lock",
-        "**/package-lock.json",
-        "**/yarn.lock",
-        "**/pnpm-lock.yaml",
-        "**/Cargo.lock",
-        "**/go.sum",
-        "**/poetry.lock",
-        // Binary/Large Assets
-        "**/*.{png,jpg,jpeg,gif,svg,ico,mp4,webm,wav,mp3,woff,woff2,eot,ttf,otf,pdf,zip,tar.gz,rar}",
-      ],
-    });
-
-    // Format the tree for the AI
-    const treeString = files.join("\n");
-
-    if (onProgress) onProgress("AI is analyzing codebase structure...");
-
-    // 2. Ask AI to generate the index based on the tree
-    const index = await treeSummarizer(treeString);
-
-    // 3. Post-process: Ensure symbols are extracted for core files if not provided by AI
-    // (AI is good at structure, but might miss specific exports unless it reads the files)
-    // For now, we trust the AI's structural summary and can supplement symbols later if needed.
-
-    index.lastIndexed = new Date().toISOString();
-    return index;
-  }
-
-  loadIndex(): CodebaseIndex | null {
-    if (existsSync(this.indexPath)) {
-      try {
-        return JSON.parse(readFileSync(this.indexPath, "utf-8"));
-      } catch {
-        return null;
-      }
-    }
-    return null;
-  }
-
-  saveIndex(index: CodebaseIndex): void {
-    const dir = dirname(this.indexPath);
-    if (!existsSync(dir)) {
-      mkdirSync(dir, { recursive: true });
-    }
-    writeFileSync(this.indexPath, JSON.stringify(index, null, 2));
-  }
-}

package/src/core/prompt-builder.ts

@@ -1,91 +0,0 @@
-import { existsSync, readFileSync } from "node:fs";
-import { AssigneeRole, Task } from "@locusai/shared";
-import { getLocusPath } from "./config.js";
-
-export class PromptBuilder {
-  constructor(private projectPath: string) {}
-
-  async build(task: Task): Promise<string> {
-    let prompt = `# Task: ${task.title}\n\n`;
-
-    const roleText = this.roleToText(task.assigneeRole);
-    if (roleText) {
-      prompt += `## Role\nYou are acting as a ${roleText}.\n\n`;
-    }
-
-    prompt += `## Description\n${task.description || "No description provided."}\n\n`;
-
-    // 1. Add CLAUDE.md context
-    const contextPath = getLocusPath(this.projectPath, "contextFile");
-    if (existsSync(contextPath)) {
-      try {
-        const context = readFileSync(contextPath, "utf-8");
-        prompt += `## Project Context (from CLAUDE.md)\n${context}\n\n`;
-      } catch (err) {
-        console.warn(`Warning: Could not read context file: ${err}`);
-      }
-    }
-
-    // 2. Add Codebase Index context
-    const indexPath = getLocusPath(this.projectPath, "indexFile");
-    if (existsSync(indexPath)) {
-      prompt += `## Codebase Overview\nThere is an index file in the .locus/codebase-index.json and if you need you can check it.\n\n`;
-    }
-
-    // 3. Add Documents
-    if (task.docs && task.docs.length > 0) {
-      prompt += `## Attached Documents\n`;
-      for (const doc of task.docs) {
-        prompt += `### ${doc.title}\n${doc.content || "(No content)"}\n\n`;
-      }
-    }
-
-    // 4. Add Checklist
-    if (task.acceptanceChecklist && task.acceptanceChecklist.length > 0) {
-      prompt += `## Acceptance Criteria\n`;
-      for (const item of task.acceptanceChecklist) {
-        prompt += `- ${item.done ? "[x]" : "[ ]"} ${item.text}\n`;
-      }
-      prompt += "\n";
-    }
-
-    // 5. Add Comments & Feedback
-    if (task.comments && task.comments.length > 0) {
-      const comments = task.comments.slice(0, 5);
-      prompt += `## Task History & Feedback\n`;
-      prompt += `Review the following comments for context or rejection feedback:\n\n`;
-      for (const comment of comments) {
-        const date = new Date(comment.createdAt).toLocaleString();
-        prompt += `### ${comment.author} (${date})\n${comment.text}\n\n`;
-      }
-    }
-
-    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. When finished successfully, output: <promise>COMPLETE</promise>\n`;
-    return prompt;
-  }
-
-  roleToText(role: Task["assigneeRole"]): string | null {
-    if (!role) {
-      return null;
-    }
-
-    switch (role) {
-      case AssigneeRole.BACKEND:
-        return "Backend Engineer";
-      case AssigneeRole.FRONTEND:
-        return "Frontend Engineer";
-      case AssigneeRole.PM:
-        return "Product Manager";
-      case AssigneeRole.QA:
-        return "QA Engineer";
-      case AssigneeRole.DESIGN:
-        return "Product Designer";
-      default:
-        return "engineer";
-    }
-  }
-}

package/src/events.ts

@@ -1,35 +0,0 @@
-import { EventEmitter } from "events";
-
-import { RetryOptions } from "./utils/retry.js";
-
-export enum LocusEvent {
-  TOKEN_EXPIRED = "TOKEN_EXPIRED",
-  AUTH_ERROR = "AUTH_ERROR",
-  REQUEST_ERROR = "REQUEST_ERROR",
-}
-
-export interface LocusConfig {
-  baseUrl: string;
-  token?: string | null;
-  timeout?: number;
-  retryOptions?: RetryOptions;
-}
-
-export class LocusEmitter extends EventEmitter {
-  on(event: LocusEvent.TOKEN_EXPIRED, listener: () => void): this;
-  on(event: LocusEvent.AUTH_ERROR, listener: (error: Error) => void): this;
-  on(event: LocusEvent.REQUEST_ERROR, listener: (error: Error) => void): this;
-  on(
-    event: LocusEvent | string,
-    listener: ((...args: unknown[]) => void) | (() => void)
-  ): this {
-    return super.on(event, listener);
-  }
-
-  emit(event: LocusEvent.TOKEN_EXPIRED): boolean;
-  emit(event: LocusEvent.AUTH_ERROR, error: Error): boolean;
-  emit(event: LocusEvent.REQUEST_ERROR, error: Error): boolean;
-  emit(event: LocusEvent | string, ...args: unknown[]): boolean {
-    return super.emit(event, ...args);
-  }
-}

package/src/index-node.ts

@@ -1,23 +0,0 @@
-/**
- * Node.js-only exports
- * This is a separate entry point for Node.js/CLI only
- * It should NOT be imported by browser applications
- *
- * These modules use Node.js APIs (fs, child_process, etc.)
- * and will break in browser environments
- */
-
-// Node.js-only: Agent system
-export * from "./agent/index.js";
-// Node.js-only: AI clients
-export * from "./ai/index.js";
-// Node.js-only: Core utilities (uses fs)
-export * from "./core/index.js";
-// Re-export everything from main index (browser-safe)
-export * from "./index.js";
-
-// Node.js-only: Orchestrator
-export { AgentOrchestrator, type OrchestratorConfig } from "./orchestrator.js";
-
-// Utilities
-export { c } from "./utils/colors.js";

package/src/index.ts

@@ -1,159 +0,0 @@
-import axios, { AxiosInstance, InternalAxiosRequestConfig } from "axios";
-import { LocusConfig, LocusEmitter, LocusEvent } from "./events.js";
-import { AuthModule } from "./modules/auth.js";
-import { CiModule } from "./modules/ci.js";
-import { DocsModule } from "./modules/docs.js";
-import { InvitationsModule } from "./modules/invitations.js";
-import { OrganizationsModule } from "./modules/organizations.js";
-import { SprintsModule } from "./modules/sprints.js";
-import { TasksModule } from "./modules/tasks.js";
-import { WorkspacesModule } from "./modules/workspaces.js";
-import { RetryOptions } from "./utils/retry.js";
-
-// Browser-safe exports only
-export * from "./events.js";
-export * from "./modules/auth.js";
-export * from "./modules/ci.js";
-export * from "./modules/docs.js";
-export * from "./modules/invitations.js";
-export * from "./modules/organizations.js";
-export * from "./modules/sprints.js";
-export * from "./modules/tasks.js";
-export * from "./modules/workspaces.js";
-
-export class LocusClient {
-  private readonly api: AxiosInstance;
-  public readonly emitter: LocusEmitter;
-
-  public readonly auth: AuthModule;
-  public readonly tasks: TasksModule;
-  public readonly sprints: SprintsModule;
-  public readonly workspaces: WorkspacesModule;
-  public readonly organizations: OrganizationsModule;
-  public readonly invitations: InvitationsModule;
-  public readonly docs: DocsModule;
-  public readonly ci: CiModule;
-
-  constructor(config: LocusConfig) {
-    this.emitter = new LocusEmitter();
-
-    this.api = axios.create({
-      baseURL: config.baseUrl,
-      timeout: config.timeout || 10000,
-      headers: {
-        "Content-Type": "application/json",
-        ...(config.token ? { Authorization: `Bearer ${config.token}` } : {}),
-      },
-    });
-
-    this.setupInterceptors();
-
-    // Initialize modules
-    this.auth = new AuthModule(this.api, this.emitter);
-    this.tasks = new TasksModule(this.api, this.emitter);
-    this.sprints = new SprintsModule(this.api, this.emitter);
-    this.workspaces = new WorkspacesModule(this.api, this.emitter);
-    this.organizations = new OrganizationsModule(this.api, this.emitter);
-    this.invitations = new InvitationsModule(this.api, this.emitter);
-    this.docs = new DocsModule(this.api, this.emitter);
-    this.ci = new CiModule(this.api, this.emitter);
-
-    if (config.retryOptions) {
-      this.setupRetryInterceptor(config.retryOptions);
-    }
-  }
-
-  private setupRetryInterceptor(retryOptions: RetryOptions) {
-    this.api.interceptors.response.use(undefined, async (error) => {
-      const config = error.config as InternalAxiosRequestConfig & {
-        _retryCount?: number;
-      };
-
-      if (!config || !retryOptions) {
-        return Promise.reject(error);
-      }
-
-      config._retryCount = config._retryCount || 0;
-
-      const maxRetries = retryOptions.maxRetries ?? 3;
-      const shouldRetry =
-        config._retryCount < maxRetries &&
-        (retryOptions.retryCondition
-          ? retryOptions.retryCondition(error)
-          : !error.response || error.response.status >= 500);
-
-      if (shouldRetry) {
-        config._retryCount++;
-        const delay = Math.min(
-          (retryOptions.initialDelay ?? 1000) *
-            Math.pow(retryOptions.factor ?? 2, config._retryCount - 1),
-          retryOptions.maxDelay ?? 5000
-        );
-
-        await new Promise((resolve) => setTimeout(resolve, delay));
-        return this.api(config);
-      }
-
-      return Promise.reject(error);
-    });
-  }
-
-  private setupInterceptors() {
-    this.api.interceptors.response.use(
-      (response) => {
-        if (
-          response.data &&
-          typeof response.data === "object" &&
-          "data" in response.data
-        ) {
-          response.data = response.data.data;
-        }
-        return response;
-      },
-      (error) => {
-        const status = error.response?.status;
-
-        // Extract error message from API response format: { error: { message: "..." } }
-        let message: string;
-
-        // Try to get message from API error response
-        if (
-          error.response?.data?.error?.message &&
-          typeof error.response.data.error.message === "string"
-        ) {
-          message = error.response.data.error.message;
-        } else if (
-          error.response?.data?.message &&
-          typeof error.response.data.message === "string"
-        ) {
-          message = error.response.data.message;
-        } else if (error.message && typeof error.message === "string") {
-          message = error.message;
-        } else {
-          message = "An error occurred";
-        }
-
-        // Create a new error with a meaningful message
-        const enhancedError = new Error(message);
-        enhancedError.name = `HTTP${status || "Error"}`;
-
-        if (status === 401) {
-          this.emitter.emit(LocusEvent.TOKEN_EXPIRED);
-          this.emitter.emit(LocusEvent.AUTH_ERROR, enhancedError);
-        } else {
-          this.emitter.emit(LocusEvent.REQUEST_ERROR, enhancedError);
-        }
-
-        return Promise.reject(enhancedError);
-      }
-    );
-  }
-
-  public setToken(token: string | null) {
-    if (token) {
-      this.api.defaults.headers.common.Authorization = `Bearer ${token}`;
-    } else {
-      delete this.api.defaults.headers.common.Authorization;
-    }
-  }
-}

package/src/modules/auth.ts

@@ -1,48 +0,0 @@
-import {
-  CompleteRegistration,
-  LoginResponse,
-  User,
-  VerifyOtp,
-} from "@locusai/shared";
-import { BaseModule } from "./base.js";
-
-export class AuthModule extends BaseModule {
-  async getMe(): Promise<User> {
-    const { data } = await this.api.get<User>("/auth/me");
-    return data;
-  }
-
-  async requestRegisterOtp(email: string): Promise<{ success: boolean }> {
-    const { data } = await this.api.post<{ success: boolean }>(
-      "/auth/register-otp",
-      { email }
-    );
-    return data;
-  }
-
-  async requestLoginOtp(email: string): Promise<{ success: boolean }> {
-    const { data } = await this.api.post<{ success: boolean }>(
-      "/auth/login-otp",
-      { email }
-    );
-    return data;
-  }
-
-  async verifyLogin(body: VerifyOtp): Promise<LoginResponse> {
-    const { data } = await this.api.post<LoginResponse>(
-      "/auth/verify-login",
-      body
-    );
-    return data;
-  }
-
-  async completeRegistration(
-    body: CompleteRegistration
-  ): Promise<LoginResponse> {
-    const { data } = await this.api.post<LoginResponse>(
-      "/auth/complete-registration",
-      body
-    );
-    return data;
-  }
-}

package/src/modules/base.ts

@@ -1,9 +0,0 @@
-import { AxiosInstance } from "axios";
-import { LocusEmitter } from "../events.js";
-
-export abstract class BaseModule {
-  constructor(
-    protected readonly api: AxiosInstance,
-    protected readonly emitter: LocusEmitter
-  ) {}
-}

package/src/modules/ci.ts

@@ -1,12 +0,0 @@
-import { ReportCiResult } from "@locusai/shared";
-import { BaseModule } from "./base.js";
-
-export class CiModule extends BaseModule {
-  async report(body: ReportCiResult): Promise<{ success: boolean }> {
-    const { data } = await this.api.post<{ success: boolean }>(
-      "/ci/report",
-      body
-    );
-    return data;
-  }
-}

package/src/modules/docs.ts

@@ -1,84 +0,0 @@
-import {
-  CreateDoc,
-  CreateDocGroup,
-  Doc,
-  DocGroup,
-  DocGroupResponse,
-  DocGroupsResponse,
-  DocResponse,
-  DocsResponse,
-  UpdateDoc,
-  UpdateDocGroup,
-} from "@locusai/shared";
-import { BaseModule } from "./base.js";
-
-export class DocsModule extends BaseModule {
-  async create(workspaceId: string, body: CreateDoc): Promise<Doc> {
-    const { data } = await this.api.post<DocResponse>(
-      `/workspaces/${workspaceId}/docs`,
-      body
-    );
-    return data.doc;
-  }
-
-  async list(workspaceId: string): Promise<Doc[]> {
-    const { data } = await this.api.get<DocsResponse>(
-      `/workspaces/${workspaceId}/docs`
-    );
-    return data.docs;
-  }
-
-  async getById(id: string, workspaceId: string): Promise<Doc> {
-    const { data } = await this.api.get<DocResponse>(
-      `/workspaces/${workspaceId}/docs/${id}`
-    );
-    return data.doc;
-  }
-
-  async update(id: string, workspaceId: string, body: UpdateDoc): Promise<Doc> {
-    const { data } = await this.api.put<DocResponse>(
-      `/workspaces/${workspaceId}/docs/${id}`,
-      body
-    );
-    return data.doc;
-  }
-
-  async delete(id: string, workspaceId: string): Promise<void> {
-    await this.api.delete(`/workspaces/${workspaceId}/docs/${id}`);
-  }
-
-  // Group Management
-  async listGroups(workspaceId: string): Promise<DocGroup[]> {
-    const { data } = await this.api.get<DocGroupsResponse>(
-      `/workspaces/${workspaceId}/doc-groups`
-    );
-    return data.groups;
-  }
-
-  async createGroup(
-    workspaceId: string,
-    body: CreateDocGroup
-  ): Promise<DocGroup> {
-    const { data } = await this.api.post<DocGroupResponse>(
-      `/workspaces/${workspaceId}/doc-groups`,
-      body
-    );
-    return data.group;
-  }
-
-  async updateGroup(
-    id: string,
-    workspaceId: string,
-    body: UpdateDocGroup
-  ): Promise<DocGroup> {
-    const { data } = await this.api.patch<DocGroupResponse>(
-      `/workspaces/${workspaceId}/doc-groups/${id}`,
-      body
-    );
-    return data.group;
-  }
-
-  async deleteGroup(id: string, workspaceId: string): Promise<void> {
-    await this.api.delete(`/workspaces/${workspaceId}/doc-groups/${id}`);
-  }
-}

package/src/modules/invitations.ts

@@ -1,45 +0,0 @@
-import {
-  AcceptInvitation,
-  AcceptInvitationResponse,
-  CreateInvitation,
-  Invitation,
-  InvitationResponse,
-  InvitationsResponse,
-} from "@locusai/shared";
-import { BaseModule } from "./base.js";
-
-export class InvitationsModule extends BaseModule {
-  async create(orgId: string, body: CreateInvitation): Promise<Invitation> {
-    const { data } = await this.api.post<InvitationResponse>(
-      `/org/${orgId}/invitations`,
-      body
-    );
-    return data.invitation;
-  }
-
-  async list(orgId: string): Promise<Invitation[]> {
-    const { data } = await this.api.get<InvitationsResponse>(
-      `/org/${orgId}/invitations`
-    );
-    return data.invitations;
-  }
-
-  async verify(token: string): Promise<InvitationResponse> {
-    const { data } = await this.api.get<InvitationResponse>(
-      `/invitations/verify/${token}`
-    );
-    return data;
-  }
-
-  async accept(body: AcceptInvitation): Promise<AcceptInvitationResponse> {
-    const { data } = await this.api.post<AcceptInvitationResponse>(
-      "/invitations/accept",
-      body
-    );
-    return data;
-  }
-
-  async revoke(orgId: string, id: string): Promise<void> {
-    await this.api.delete(`/org/${orgId}/invitations/${id}`);
-  }
-}