@locusai/shared 0.1.6 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # @locusai/shared
 
+## 0.2.1
+
+### Patch Changes
+
+- Update app versions
+
+## 0.2.0
+
+### Minor Changes
+
+- 52d35dd: # 🚀 The "Hybrid Agent" Release
+
+  This release introduces the new **Hybrid Architecture** for Locus, allowing autonomous agents to execute code locally while coordinating via the cloud.
+
+  ## Major Highlights
+
+  ### @locusai/cli
+
+  - **New `locus run` command**: Starts the local agent runtime that connects to the cloud.
+  - **Improved `locus index`**: Now creates a semantic map of your codebase for better agent context.
+  - **Removed MCP Server**: The standalone MCP server (`locus serve`) has been replaced by the direct agent runtime.
+  - **Terminal UI**: Enhanced CLI output with emoji status indicators and clear lifecycle phases.
+
+  ### @locusai/sdk
+
+  - **Agent Orchestrator**: New core engine that manages the agent lifecycle (Dispatch -> Plan -> Execute -> Verify).
+  - **Sprint Mindmaps**: Agents now generate high-level technical plans for sprints before executing individual tasks.
+  - **Anthropic & Claude CLI Support**: Native integration with Claude for planning and coding.
+  - **Artifact Syncing**: Automatically syncs locally generated plans and docs to the Locus Dashboard.
+
+  ### @locusai/shared
+
+  - Updated schemas to support the new `Agent` and `Orchestrator` models.
+  - Added `Sprint.mindmap` and `Sprint.mindmapUpdatedAt` fields.
+
+## 0.1.7
+
+### Patch Changes
+
+- - Workflow improvements
+
 ## 0.1.6
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1,3 +1,4 @@
-export * from "./schemas.js";
-export * from "./types.js";
+export * from "./common";
+export * from "./enums";
+export * from "./models";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -1,2 +1,3 @@
-export * from "./schemas.js";
-export * from "./types.js";
+export * from "./common";
+export * from "./enums";
+export * from "./models";

package/dist/schemas.d.ts

@@ -1,6 +1,130 @@
 import { z } from "zod";
-import { AssigneeRole, TaskPriority, TaskStatus } from "./types.js";
+import { AssigneeRole, MembershipRole, TaskPriority, TaskStatus, UserRole } from "./enums";
+export declare const OrganizationSchema: z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    slug: string;
+}, {
+    name: string;
+    slug: string;
+}>;
+export declare const OrganizationUpdateSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    avatarUrl: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    name?: string | undefined;
+    avatarUrl?: string | null | undefined;
+}, {
+    name?: string | undefined;
+    avatarUrl?: string | null | undefined;
+}>;
+export declare const ProjectSchema: z.ZodObject<{
+    orgId: z.ZodString;
+    name: z.ZodString;
+    slug: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    repoUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    orgId: string;
+    slug: string;
+    description?: string | undefined;
+    repoUrl?: string | undefined;
+}, {
+    name: string;
+    orgId: string;
+    slug: string;
+    description?: string | undefined;
+    repoUrl?: string | undefined;
+}>;
+export declare const ProjectUpdateSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    repoUrl: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    name?: string | undefined;
+    description?: string | null | undefined;
+    repoUrl?: string | null | undefined;
+}, {
+    name?: string | undefined;
+    description?: string | null | undefined;
+    repoUrl?: string | null | undefined;
+}>;
+export declare const UserSchema: z.ZodObject<{
+    email: z.ZodString;
+    name: z.ZodString;
+    avatarUrl: z.ZodOptional<z.ZodString>;
+    role: z.ZodDefault<z.ZodOptional<z.ZodNativeEnum<typeof UserRole>>>;
+}, "strip", z.ZodTypeAny, {
+    email: string;
+    name: string;
+    role: UserRole;
+    avatarUrl?: string | undefined;
+}, {
+    email: string;
+    name: string;
+    avatarUrl?: string | undefined;
+    role?: UserRole | undefined;
+}>;
+export declare const MembershipSchema: z.ZodObject<{
+    userId: z.ZodString;
+    orgId: z.ZodString;
+    role: z.ZodDefault<z.ZodNativeEnum<typeof MembershipRole>>;
+}, "strip", z.ZodTypeAny, {
+    role: MembershipRole;
+    orgId: string;
+    userId: string;
+}, {
+    orgId: string;
+    userId: string;
+    role?: MembershipRole | undefined;
+}>;
+export declare const APIKeySchema: z.ZodObject<{
+    projectId: z.ZodString;
+    name: z.ZodString;
+    expiresAt: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    projectId: string;
+    expiresAt?: number | undefined;
+}, {
+    name: string;
+    projectId: string;
+    expiresAt?: number | undefined;
+}>;
+export declare const DocumentSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    path: z.ZodString;
+    title: z.ZodString;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    title: string;
+    projectId: string;
+    content: string;
+}, {
+    path: string;
+    title: string;
+    projectId: string;
+    content: string;
+}>;
+export declare const DocumentUpdateSchema: z.ZodObject<{
+    path: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    path?: string | undefined;
+    title?: string | undefined;
+    content?: string | undefined;
+}, {
+    path?: string | undefined;
+    title?: string | undefined;
+    content?: string | undefined;
+}>;
 export declare const TaskSchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
     title: z.ZodString;
     description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     status: z.ZodDefault<z.ZodOptional<z.ZodNativeEnum<typeof TaskStatus>>>;
@@ -8,22 +132,27 @@ export declare const TaskSchema: z.ZodObject<{
     labels: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
     assigneeRole: z.ZodOptional<z.ZodNativeEnum<typeof AssigneeRole>>;
     parentId: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    sprintId: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
 }, "strip", z.ZodTypeAny, {
+    status: TaskStatus;
     title: string;
     description: string;
-    status: TaskStatus;
     priority: TaskPriority;
     labels: string[];
     assigneeRole?: AssigneeRole | undefined;
+    sprintId?: number | null | undefined;
     parentId?: number | null | undefined;
+    projectId?: string | undefined;
 }, {
     title: string;
-    description?: string | undefined;
     status?: TaskStatus | undefined;
+    description?: string | undefined;
     priority?: TaskPriority | undefined;
     labels?: string[] | undefined;
     assigneeRole?: AssigneeRole | undefined;
+    sprintId?: number | null | undefined;
     parentId?: number | null | undefined;
+    projectId?: string | undefined;
 }>;
 export declare const TaskUpdateSchema: z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
@@ -47,9 +176,9 @@ export declare const TaskUpdateSchema: z.ZodObject<{
         done: boolean;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
+    status?: TaskStatus | undefined;
     title?: string | undefined;
     description?: string | undefined;
-    status?: TaskStatus | undefined;
     priority?: TaskPriority | undefined;
     labels?: string[] | undefined;
     assigneeRole?: AssigneeRole | undefined;
@@ -60,9 +189,9 @@ export declare const TaskUpdateSchema: z.ZodObject<{
         done: boolean;
     }[] | undefined;
 }, {
+    status?: TaskStatus | undefined;
     title?: string | undefined;
     description?: string | undefined;
-    status?: TaskStatus | undefined;
     priority?: TaskPriority | undefined;
     labels?: string[] | undefined;
     assigneeRole?: AssigneeRole | undefined;
@@ -73,15 +202,31 @@ export declare const TaskUpdateSchema: z.ZodObject<{
         done: boolean;
     }[] | undefined;
 }>;
+export declare const SprintSchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    startDate: z.ZodOptional<z.ZodNumber>;
+    endDate: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    startDate?: number | undefined;
+    endDate?: number | undefined;
+    projectId?: string | undefined;
+}, {
+    name: string;
+    startDate?: number | undefined;
+    endDate?: number | undefined;
+    projectId?: string | undefined;
+}>;
 export declare const CommentSchema: z.ZodObject<{
     author: z.ZodString;
     text: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    text: string;
     author: string;
-}, {
     text: string;
+}, {
     author: string;
+    text: string;
 }>;
 export declare const LockSchema: z.ZodObject<{
     agentId: z.ZodString;
@@ -108,15 +253,15 @@ export declare const ArtifactSchema: z.ZodObject<{
     fileName: z.ZodOptional<z.ZodString>;
     createdBy: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    title: string;
     type: string;
+    title: string;
     createdBy: string;
     contentText?: string | undefined;
     fileBase64?: string | undefined;
     fileName?: string | undefined;
 }, {
-    title: string;
     type: string;
+    title: string;
     createdBy: string;
     contentText?: string | undefined;
     fileBase64?: string | undefined;

package/dist/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEpE,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;EAQrB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiB3B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;EAGxB,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;EAGrB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;EAEvB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;EAOzB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;EAGtB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;EAGzB,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;EAE1B,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,UAAU,EACV,QAAQ,EACT,MAAM,SAAS,CAAC;AAMjB,eAAO,MAAM,kBAAkB;;;;;;;;;EAO7B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;EAGnC,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;EAUxB,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;EAI9B,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;EAKrB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAI3B,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;EAIvB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;EAKzB,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAMH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUrB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiB3B,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;EAKvB,CAAC;AAMH,eAAO,MAAM,aAAa;;;;;;;;;EAGxB,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;EAGrB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;EAEvB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;EAOzB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;EAGtB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;EAGzB,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;EAE1B,CAAC"}

package/dist/schemas.js

@@ -1,6 +1,68 @@
 import { z } from "zod";
-import { AssigneeRole, TaskPriority, TaskStatus } from "./types.js";
+import { AssigneeRole, MembershipRole, TaskPriority, TaskStatus, UserRole, } from "./enums";
+// ============================================================================
+// Multi-tenancy Schemas
+// ============================================================================
+export const OrganizationSchema = z.object({
+    name: z.string().min(1).max(100),
+    slug: z
+        .string()
+        .min(1)
+        .max(50)
+        .regex(/^[a-z0-9-]+$/),
+});
+export const OrganizationUpdateSchema = z.object({
+    name: z.string().min(1).max(100).optional(),
+    avatarUrl: z.string().url().optional().nullable(),
+});
+export const ProjectSchema = z.object({
+    orgId: z.string().uuid(),
+    name: z.string().min(1).max(100),
+    slug: z
+        .string()
+        .min(1)
+        .max(50)
+        .regex(/^[a-z0-9-]+$/),
+    description: z.string().max(500).optional(),
+    repoUrl: z.string().url().optional(),
+});
+export const ProjectUpdateSchema = z.object({
+    name: z.string().min(1).max(100).optional(),
+    description: z.string().max(500).optional().nullable(),
+    repoUrl: z.string().url().optional().nullable(),
+});
+export const UserSchema = z.object({
+    email: z.string().email(),
+    name: z.string().min(1).max(100),
+    avatarUrl: z.string().url().optional(),
+    role: z.nativeEnum(UserRole).optional().default(UserRole.USER),
+});
+export const MembershipSchema = z.object({
+    userId: z.string().uuid(),
+    orgId: z.string().uuid(),
+    role: z.nativeEnum(MembershipRole).default(MembershipRole.MEMBER),
+});
+export const APIKeySchema = z.object({
+    projectId: z.string().uuid(),
+    name: z.string().min(1).max(100),
+    expiresAt: z.number().optional(),
+});
+export const DocumentSchema = z.object({
+    projectId: z.string().uuid(),
+    path: z.string().min(1).max(500),
+    title: z.string().min(1).max(200),
+    content: z.string(),
+});
+export const DocumentUpdateSchema = z.object({
+    path: z.string().min(1).max(500).optional(),
+    title: z.string().min(1).max(200).optional(),
+    content: z.string().optional(),
+});
+// ============================================================================
+// Task & Sprint Schemas
+// ============================================================================
 export const TaskSchema = z.object({
+    projectId: z.string().uuid().optional(), // Optional for local mode
     title: z.string().min(1),
     description: z.string().optional().default(""),
     status: z.nativeEnum(TaskStatus).optional().default(TaskStatus.BACKLOG),
@@ -8,6 +70,7 @@ export const TaskSchema = z.object({
     labels: z.array(z.string()).optional().default([]),
     assigneeRole: z.nativeEnum(AssigneeRole).optional(),
     parentId: z.number().optional().nullable(),
+    sprintId: z.number().optional().nullable(),
 });
 export const TaskUpdateSchema = z.object({
     title: z.string().optional(),
@@ -25,6 +88,15 @@ export const TaskUpdateSchema = z.object({
     }))
         .optional(),
 });
+export const SprintSchema = z.object({
+    projectId: z.string().uuid().optional(), // Optional for local mode
+    name: z.string().min(1).max(100),
+    startDate: z.number().optional(),
+    endDate: z.number().optional(),
+});
+// ============================================================================
+// Other Schemas
+// ============================================================================
 export const CommentSchema = z.object({
     author: z.string().min(1),
     text: z.string().min(1),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@locusai/shared",
-  "version": "0.1.6",
+  "version": "0.2.1",
   "type": "module",
   "main": "src/index.ts",
   "dependencies": {

package/src/common.ts

@@ -0,0 +1,106 @@
+import { z } from "zod";
+
+// ============================================================================
+// Base Entity
+// ============================================================================
+
+export const BaseEntitySchema = z.object({
+  id: z.string().uuid(),
+  createdAt: z.union([z.date(), z.number()]),
+  updatedAt: z.union([z.date(), z.number()]),
+});
+
+export type BaseEntity = z.infer<typeof BaseEntitySchema>;
+
+// ============================================================================
+// Common API Response Schemas
+// ============================================================================
+
+export const PaginationMetaSchema = z.object({
+  page: z.number(),
+  limit: z.number(),
+  total: z.number(),
+  totalPages: z.number(),
+});
+
+export type PaginationMeta = z.infer<typeof PaginationMetaSchema>;
+
+export const PaginationRequestSchema = z.object({
+  page: z.coerce.number().int().min(1).default(1),
+  limit: z.coerce.number().int().min(1).max(100).default(20),
+});
+
+export type PaginationRequest = z.infer<typeof PaginationRequestSchema>;
+
+/**
+ * Special type for cases where 'any' is absolutely necessary.
+ * Use this sparingly and document why it's needed.
+ */
+// biome-ignore lint/suspicious/noExplicitAny: We need to use any for this type
+export type $FixMe = any;
+
+export const ApiResponseSchema = z.object({
+  success: z.boolean(),
+  data: z.unknown().optional(),
+  error: z
+    .object({
+      code: z.string(),
+      message: z.string(),
+      details: z.unknown().optional(),
+    })
+    .optional(),
+  meta: z
+    .object({
+      pagination: PaginationMetaSchema.optional(),
+      timestamp: z.string(),
+      path: z.string(),
+    })
+    .optional(),
+});
+
+export type ApiResponse<T = unknown> = {
+  success: boolean;
+  data?: T;
+  error?: {
+    code: string;
+    message: string;
+    details?: unknown;
+  };
+  meta?: {
+    pagination?: PaginationMeta;
+    timestamp: string;
+    path: string;
+  };
+};
+
+export const SuccessResponseSchema = z.object({
+  success: z.literal(true),
+  message: z.string().optional(),
+});
+
+export const ErrorResponseSchema = z.object({
+  success: z.literal(false),
+  error: z.object({
+    code: z.string(),
+    message: z.string(),
+    details: z.unknown().optional(),
+  }),
+});
+
+// ============================================================================
+// Utility Types
+// ============================================================================
+
+export type SuccessResponse = z.infer<typeof SuccessResponseSchema>;
+export type ErrorResponse = z.infer<typeof ErrorResponseSchema>;
+
+/**
+ * Generates a standard v4 UUID
+ */
+export function generateUUID(): string {
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = (Math.random() * 16) | 0;
+    const v = c === "x" ? r : (r & 0x3) | 0x8;
+    return v.toString(16);
+  });
+}

package/src/enums.ts

@@ -0,0 +1,56 @@
+export enum UserRole {
+  USER = "USER",
+  ADMIN = "ADMIN",
+}
+
+export enum MembershipRole {
+  OWNER = "OWNER",
+  ADMIN = "ADMIN",
+  MEMBER = "MEMBER",
+  VIEWER = "VIEWER",
+}
+
+export enum TaskStatus {
+  BACKLOG = "BACKLOG",
+  IN_PROGRESS = "IN_PROGRESS",
+  REVIEW = "REVIEW",
+  VERIFICATION = "VERIFICATION",
+  DONE = "DONE",
+  BLOCKED = "BLOCKED",
+}
+
+export enum TaskPriority {
+  LOW = "LOW",
+  MEDIUM = "MEDIUM",
+  HIGH = "HIGH",
+  CRITICAL = "CRITICAL",
+}
+
+export enum AssigneeRole {
+  BACKEND = "BACKEND",
+  FRONTEND = "FRONTEND",
+  QA = "QA",
+  PM = "PM",
+  DESIGN = "DESIGN",
+}
+
+export enum SprintStatus {
+  PLANNED = "PLANNED",
+  ACTIVE = "ACTIVE",
+  COMPLETED = "COMPLETED",
+}
+
+export enum EventType {
+  TASK_CREATED = "TASK_CREATED",
+  TASK_UPDATED = "TASK_UPDATED",
+  TASK_DELETED = "TASK_DELETED",
+  STATUS_CHANGED = "STATUS_CHANGED",
+  COMMENT_ADDED = "COMMENT_ADDED",
+  CI_RAN = "CI_RAN",
+  WORKSPACE_CREATED = "WORKSPACE_CREATED",
+  MEMBER_ADDED = "MEMBER_ADDED",
+  MEMBER_INVITED = "MEMBER_INVITED",
+  SPRINT_CREATED = "SPRINT_CREATED",
+  SPRINT_STATUS_CHANGED = "SPRINT_STATUS_CHANGED",
+  CHECKLIST_INITIALIZED = "CHECKLIST_INITIALIZED",
+}

package/src/index.ts

@@ -1,2 +1,3 @@
-export * from "./schemas";
-export * from "./types";
+export * from "./common";
+export * from "./enums";
+export * from "./models";