@codeguide/core 0.0.35 → 0.0.37

package/dist/services/prompt-generations/prompt-generations-types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Persona types for prompt generation
+ */
+export type PersonaType = 'expert' | 'assistant' | 'teacher' | 'analyst' | 'creative';
+/**
+ * Output format types for generated prompts
+ */
+export type OutputFormatType = 'markdown' | 'json' | 'xml' | 'plain' | 'code';
+/**
+ * Request body for creating a new prompt generation
+ */
+export interface CreatePromptGenerationRequest {
+    /** User's description of their AI assistant */
+    input: string;
+    /** Persona type: expert, assistant, teacher, analyst, creative */
+    persona?: PersonaType;
+    /** Format: markdown, json, xml, plain, code */
+    output_format?: OutputFormatType;
+    /** Creativity level (0-2) */
+    temperature?: number;
+    /** Response length (256-8192) */
+    max_tokens?: number;
+    /** Include examples in prompt */
+    include_examples?: boolean;
+    /** Add constraints to prompt */
+    include_constraints?: boolean;
+    /** Include error handling guidance */
+    include_error_handling?: boolean;
+    /** Enable chain of thought */
+    chain_of_thought?: boolean;
+    /** Use JSON output schema */
+    structured_output?: boolean;
+}
+/**
+ * Prompt generation data model
+ */
+export interface PromptGeneration {
+    /** Unique identifier (UUID v4) */
+    id: string;
+    /** User ID who owns this generation */
+    user_id: string;
+    /** User's original input */
+    input: string;
+    /** Persona type used */
+    persona: PersonaType;
+    /** Output format */
+    output_format: OutputFormatType;
+    /** Temperature value */
+    temperature: number;
+    /** Max tokens setting */
+    max_tokens: number;
+    /** Include examples flag */
+    include_examples: boolean;
+    /** Include constraints flag */
+    include_constraints: boolean;
+    /** Include error handling flag */
+    include_error_handling: boolean;
+    /** Chain of thought flag */
+    chain_of_thought: boolean;
+    /** Structured output flag */
+    structured_output: boolean;
+    /** The generated AI system prompt */
+    generated_prompt: string;
+    /** Creation timestamp (ISO 8601 UTC) */
+    created_at: string;
+}
+/**
+ * Response for creating a prompt generation
+ */
+export interface CreatePromptGenerationResponse {
+    /** The created prompt generation */
+    data: PromptGeneration;
+}
+/**
+ * Response for listing prompt generations
+ */
+export interface ListPromptGenerationsResponse {
+    /** Array of prompt generations */
+    data: PromptGeneration[];
+}
+/**
+ * Response for getting a single prompt generation
+ */
+export interface GetPromptGenerationResponse {
+    /** The requested prompt generation */
+    data: PromptGeneration;
+}
+/**
+ * Response for deleting a prompt generation
+ */
+export interface DeletePromptGenerationResponse {
+    /** The deleted prompt generation */
+    data: PromptGeneration;
+}

package/dist/services/prompt-generations/prompt-generations-types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/services/tasks/task-service.d.ts

@@ -27,6 +27,7 @@ export declare class TaskService extends BaseService {
     generateTasks(request: GenerateTasksRequest): Promise<GenerateTasksResponse>;
     generateTasksCustomBackground(request: GenerateTasksCustomBackgroundRequest): Promise<GenerateTasksCustomBackgroundResponse>;
     getTasksByProject(request: GetTasksByProjectRequest): Promise<GetTasksByProjectResponse>;
+    getLatestTasksByProject(projectId: string): Promise<GetTasksByProjectResponse>;
     updateTask(taskId: string, request: UpdateTaskRequest): Promise<UpdateTaskResponse>;
     getProjectTasksbyCodespace(codespaceTaskId: string): Promise<ProjectTaskListResponse>;
     generatePrompt(taskId: string, request?: GeneratePromptRequest): Promise<GeneratePromptResponse>;

package/dist/services/tasks/task-service.js

@@ -130,6 +130,11 @@ class TaskService extends base_service_1.BaseService {
         const url = `/project-tasks/by-project/${request.project_id}${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
         return this.get(url);
     }
+    // Get Latest Tasks by Project (from most recent task group)
+    async getLatestTasksByProject(projectId) {
+        const url = `/project-tasks/by-project/${projectId}/latest`;
+        return this.get(url);
+    }
     // Update Task
     async updateTask(taskId, request) {
         return this.put(`/project-tasks/${taskId}`, request);

package/dist/services/usage/usage-types.d.ts

@@ -69,6 +69,7 @@ export interface PlanLimits {
         storage_gb: LimitInfo;
         projects: LimitInfo;
         collaborators: LimitInfo;
+        softwarev2_access?: LimitInfo;
     };
 }
 export interface AuthorizationSubscription {

package/dist/services/users/user-service.d.ts

@@ -1,5 +1,5 @@
 import { BaseService } from '../base/base-service';
-import { GetCurrentClerkUserResponse } from './user-types';
+import { GetCurrentClerkUserResponse, CheckAdminStatusResponse } from './user-types';
 export declare class UserService extends BaseService {
     /**
      * Get the current Clerk user information
@@ -9,4 +9,12 @@ export declare class UserService extends BaseService {
      * @returns Promise resolving to the current Clerk user data
      */
     getCurrentClerkUser(): Promise<GetCurrentClerkUserResponse>;
+    /**
+     * Check if the current authenticated user has admin role
+     *
+     * GET /users/me/admin
+     *
+     * @returns Promise resolving to admin status data
+     */
+    checkAdminStatus(): Promise<CheckAdminStatusResponse>;
 }

package/dist/services/users/user-service.js

@@ -13,5 +13,15 @@ class UserService extends base_service_1.BaseService {
     async getCurrentClerkUser() {
         return this.get('/users/me/clerk');
     }
+    /**
+     * Check if the current authenticated user has admin role
+     *
+     * GET /users/me/admin
+     *
+     * @returns Promise resolving to admin status data
+     */
+    async checkAdminStatus() {
+        return this.get('/users/me/admin');
+    }
 }
 exports.UserService = UserService;

package/dist/services/users/user-types.d.ts

@@ -53,3 +53,17 @@ export interface GetCurrentClerkUserResponse {
     status: 'success' | 'error';
     data: ClerkUserData;
 }
+/**
+ * Admin status check data
+ */
+export interface AdminStatusData {
+    is_admin: boolean;
+    user_id: string;
+}
+/**
+ * Response for checking if current user is admin
+ */
+export interface CheckAdminStatusResponse {
+    status: 'success' | 'error';
+    data: AdminStatusData;
+}

package/index.ts

@@ -57,3 +57,10 @@ export type {
   GetStarterKitsRequest,
   GetStarterKitsResponse,
 } from './services/starter-kits/starter-kits-types'
+
+// Export data management types for convenience
+export type {
+  DataStatsResponse,
+  DeleteAllDataRequest,
+  DeleteAllDataResponse,
+} from './services/data-management/data-management-types'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codeguide/core",
-  "version": "0.0.35",
+  "version": "0.0.37",
   "description": "Core package for code guidance with programmatic API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/services/data-management/data-management-service.ts

@@ -0,0 +1,74 @@
+import { BaseService } from '../base/base-service'
+import {
+  DataStatsResponse,
+  DeleteAllDataRequest,
+  DeleteAllDataResponse,
+  DataExportResponse,
+} from './data-management-types'
+
+export class DataManagementService extends BaseService {
+  /**
+   * Get comprehensive statistics of all user data
+   *
+   * Calls GET /data/stats to retrieve aggregate counts of:
+   * - Projects
+   * - Project documents
+   * - Project repositories
+   * - Project tasks
+   * - Task groups
+   * - Chat conversations
+   * - Chat messages
+   * - Codespace tasks
+   *
+   * @returns Promise resolving to DataStatsResponse with counts for each entity type
+   */
+  async getDataStats(): Promise<DataStatsResponse> {
+    return this.get<DataStatsResponse>('/data/stats')
+  }
+
+  /**
+   * Export all user data
+   *
+   * Calls GET /data/export to retrieve complete export of all user data.
+   * This includes all projects, documents, repositories, tasks, conversations,
+   * messages, and codespace tasks with their full details.
+   *
+   * Use this for:
+   * - Creating backups
+   * - Migrating data to another system
+   * - Data analysis
+   * - Compliance and auditing
+   *
+   * @returns Promise resolving to DataExportResponse with complete user data
+   */
+  async exportData(): Promise<DataExportResponse> {
+    return this.get<DataExportResponse>('/data/export')
+  }
+
+  /**
+   * Delete all user data with explicit confirmation
+   *
+   * Calls DELETE /data/all to perform bulk deletion of all user data.
+   * This operation requires confirmation to prevent accidental data loss.
+   *
+   * The deletion will affect:
+   * - All projects (including documents and repositories)
+   * - All task groups and project tasks
+   * - All chat conversations and messages
+   * - All codespace tasks
+   *
+   * @param request - DeleteAllDataRequest with confirm flag set to true
+   * @returns Promise resolving to DeleteAllDataResponse with deletion summary
+   * @throws Error if confirmation is not true
+   */
+  async deleteAllData(request: DeleteAllDataRequest): Promise<DeleteAllDataResponse> {
+    // Validate confirmation flag to prevent accidental deletion
+    if (!request.confirm) {
+      throw new Error(
+        'Confirmation required. Set confirm: true to delete all data. This action cannot be undone.'
+      )
+    }
+
+    return this.delete<DeleteAllDataResponse>('/data/all')
+  }
+}

package/services/data-management/data-management-types.ts

@@ -0,0 +1,163 @@
+/**
+ * Data Management Service Types
+ *
+ * Provides interfaces for viewing data statistics and bulk deleting user data
+ */
+
+/**
+ * Response structure for GET /data/stats endpoint
+ * Contains aggregate counts of all user data across the platform
+ */
+export interface DataStatsResponse {
+  status: string
+  data: DataStats
+}
+
+/**
+ * Aggregate statistics for all user data entities
+ */
+export interface DataStats {
+  projects: number
+  project_documents: number
+  project_repositories: number
+  project_tasks: number
+  task_groups: number
+  chat_conversations: number
+  chat_messages: number
+  codespace_tasks: number
+}
+
+/**
+ * Request structure for DELETE /data/all endpoint
+ * Requires explicit confirmation to prevent accidental data loss
+ */
+export interface DeleteAllDataRequest {
+  confirm: boolean
+}
+
+/**
+ * Response structure for DELETE /data/all endpoint
+ * Provides summary of deleted data counts
+ */
+export interface DeleteAllDataResponse {
+  status: string
+  message: string
+  deleted: DataStats
+}
+
+/**
+ * Response structure for GET /data/export endpoint
+ * Contains complete export of all user data
+ */
+export interface DataExportResponse {
+  status: string
+  exported_at: string
+  user_id: string
+  data: ExportedData
+}
+
+/**
+ * Complete exported data containing all user entities
+ */
+export interface ExportedData {
+  projects: ExportedProject[]
+  project_documents: ExportedProjectDocument[]
+  project_repositories: ExportedProjectRepository[]
+  project_tasks: ExportedProjectTask[]
+  task_groups: ExportedTaskGroup[]
+  chat_conversations: ExportedChatConversation[]
+  chat_messages: ExportedChatMessage[]
+  codespace_tasks: ExportedCodespaceTask[]
+}
+
+/**
+ * Exported project entity
+ */
+export interface ExportedProject {
+  id: string
+  title: string
+  description: string
+  status: string
+  user_id: string
+  created_at: string
+  updated_at: string
+  project_outline?: Record<string, any>
+  ai_questionaire?: Record<string, any>
+}
+
+/**
+ * Exported project document entity
+ */
+export interface ExportedProjectDocument {
+  id: string
+  project_id: string
+  content: string
+  custom_document_type: string
+  is_current_version: boolean
+  created_at: string
+}
+
+/**
+ * Exported project repository entity
+ */
+export interface ExportedProjectRepository {
+  id: string
+  project_id: string
+  repo_url: string
+  created_at: string
+}
+
+/**
+ * Exported project task entity
+ */
+export interface ExportedProjectTask {
+  id: string
+  project_id: string
+  title: string
+  status: string
+  priority: string
+  created_at: string
+}
+
+/**
+ * Exported task group entity
+ */
+export interface ExportedTaskGroup {
+  id: string
+  project_id: string
+  name: string
+  created_at: string
+}
+
+/**
+ * Exported chat conversation entity
+ */
+export interface ExportedChatConversation {
+  id: string
+  title: string
+  model: string
+  created_at: string
+  last_message_at: string
+}
+
+/**
+ * Exported chat message entity
+ */
+export interface ExportedChatMessage {
+  id: string
+  conversation_id: string
+  role: 'user' | 'assistant'
+  content: string
+  token_count: number
+  created_at: string
+}
+
+/**
+ * Exported codespace task entity
+ */
+export interface ExportedCodespaceTask {
+  id: string
+  project_id: string
+  status: string
+  created_at: string
+}

package/services/data-management/index.ts

@@ -0,0 +1,2 @@
+export { DataManagementService } from './data-management-service'
+export * from './data-management-types'

package/services/generation/generation-types.ts

@@ -155,9 +155,39 @@ export interface GenerateAnswersResponse {
   }>
 }
 
+export type ProjectMode = 'prd_only' | 'full_application' | 'prototype' | 'mvp'
+
+export interface ProjectOutline {
+  core_features: Array<{
+    id: number
+    title: string
+    description: string
+    icon_key: string
+  }>
+  app_flow: Array<{
+    id: number
+    title: string
+    description: string
+  }>
+  tech_stack: Array<{
+    id: number
+    type: string
+    name: string
+    icon_key: string
+  }>
+  document_types: Array<{
+    id: number
+    name: string
+    description: string
+  }>
+  is_generated: boolean
+  project_mode: ProjectMode
+}
+
 export interface GenerateProjectOutlineRequest {
   description: string
   project_type: string
+  project_mode?: ProjectMode
   title?: string
   selected_tools?: string[]
   answers?: Record<string, any>
@@ -166,7 +196,7 @@ export interface GenerateProjectOutlineRequest {
 }
 
 export interface GenerateProjectOutlineResponse {
-  outline: string
+  project_outline: ProjectOutline
   project_id: string
   project_created: boolean
 }

package/services/index.ts

@@ -23,6 +23,8 @@ export { UserService } from './users'
 export { StarterKitsService } from './starter-kits'
 export { StreamingService } from './streaming'
 export { ChatService } from './chat'
+export { DataManagementService } from './data-management'
+export { PromptGenerationsService } from './prompt-generations'
 
 // Re-export all types for convenience
 export * from './generation'
@@ -40,3 +42,5 @@ export * from './users'
 export * from './starter-kits'
 export * from './streaming'
 export * from './chat'
+export * from './data-management'
+export * from './prompt-generations'

package/services/projects/project-types.ts

@@ -32,8 +32,26 @@ export interface Project {
   }
   tools_selected?: string[]
   project_outline?: {
-    features?: string[]
-    architecture?: string
+    core_features?: Array<{
+      id?: number
+      title?: string
+      description?: string
+      icon_key?: string
+    }>
+    app_flow?: Array<{
+      id?: number
+      title?: string
+      description?: string
+    }>
+    tech_stack?: Array<{
+      id?: number
+      type?: string
+      name?: string
+      icon_key?: string
+    }>
+    document_types?: string[]
+    is_generated?: boolean
+    project_mode?: 'prd_only' | 'full_application' | 'prototype' | 'mvp' | 'task_only'
   }
   codie_tool_id?: string
   existing_project_repo_url?: string | null
@@ -96,7 +114,7 @@ export interface StarterKitReference {
 
 export interface CreateProjectRequest {
   title?: string // Optional - will be auto-generated if not provided
-  description: string
+  description?: string
   status?: 'prompt' | 'draft' | 'in_progress' | 'completed'
   category_id?: string
   starter_kit_id?: string
@@ -107,8 +125,26 @@ export interface CreateProjectRequest {
   }
   tools_selected?: string[]
   project_outline?: {
-    features?: string[]
-    architecture?: string
+    core_features?: Array<{
+      id?: number
+      title?: string
+      description?: string
+      icon_key?: string
+    }>
+    app_flow?: Array<{
+      id?: number
+      title?: string
+      description?: string
+    }>
+    tech_stack?: Array<{
+      id?: number
+      type?: string
+      name?: string
+      icon_key?: string
+    }>
+    document_types?: string[]
+    is_generated?: boolean
+    project_mode?: 'prd_only' | 'full_application' | 'prototype' | 'mvp' | 'task_only'
   }
   codie_tool_id?: string
   existing_project_repo_url?: string
@@ -127,8 +163,26 @@ export interface UpdateProjectRequest {
   }
   tools_selected?: string[]
   project_outline?: {
-    features?: string[]
-    architecture?: string
+    core_features?: Array<{
+      id?: number
+      title?: string
+      description?: string
+      icon_key?: string
+    }>
+    app_flow?: Array<{
+      id?: number
+      title?: string
+      description?: string
+    }>
+    tech_stack?: Array<{
+      id?: number
+      type?: string
+      name?: string
+      icon_key?: string
+    }>
+    document_types?: string[]
+    is_generated?: boolean
+    project_mode?: 'prd_only' | 'full_application' | 'prototype' | 'mvp' | 'task_only'
   }
   codie_tool_id?: string
   existing_project_repo_url?: string

package/services/prompt-generations/index.ts

@@ -0,0 +1,2 @@
+export { PromptGenerationsService } from './prompt-generations-service'
+export * from './prompt-generations-types'

package/services/prompt-generations/prompt-generations-service.ts

@@ -0,0 +1,75 @@
+import { BaseService } from '../base/base-service'
+import {
+  CreatePromptGenerationRequest,
+  CreatePromptGenerationResponse,
+  ListPromptGenerationsResponse,
+  GetPromptGenerationResponse,
+  DeletePromptGenerationResponse,
+} from './prompt-generations-types'
+
+export class PromptGenerationsService extends BaseService {
+  /**
+   * Create a new AI system prompt generation
+   *
+   * Generates a new AI system prompt based on user input using GPT-5.1.
+   *
+   * POST /prompt-generations/
+   *
+   * @param request - The prompt generation request parameters
+   * @returns Promise resolving to the created prompt generation data
+   */
+  async createPromptGeneration(
+    request: CreatePromptGenerationRequest
+  ): Promise<CreatePromptGenerationResponse> {
+    return this.post<CreatePromptGenerationResponse>('/prompt-generations/', request)
+  }
+
+  /**
+   * List all prompt generations for the authenticated user
+   *
+   * Retrieves all prompt generations that belong to the current user.
+   *
+   * GET /prompt-generations/
+   *
+   * @returns Promise resolving to an array of prompt generations
+   */
+  async listPromptGenerations(): Promise<ListPromptGenerationsResponse> {
+    return this.get<ListPromptGenerationsResponse>('/prompt-generations/')
+  }
+
+  /**
+   * Get a specific prompt generation by ID
+   *
+   * Retrieves detailed information about a single prompt generation.
+   *
+   * GET /prompt-generations/{generation_id}
+   *
+   * @param generationId - The UUID of the prompt generation to retrieve
+   * @returns Promise resolving to the prompt generation data
+   */
+  async getPromptGeneration(
+    generationId: string
+  ): Promise<GetPromptGenerationResponse> {
+    return this.get<GetPromptGenerationResponse>(
+      `/prompt-generations/${generationId}`
+    )
+  }
+
+  /**
+   * Delete a specific prompt generation by ID
+   *
+   * Permanently removes a prompt generation from the database.
+   *
+   * DELETE /prompt-generations/{generation_id}
+   *
+   * @param generationId - The UUID of the prompt generation to delete
+   * @returns Promise resolving to the deleted prompt generation data
+   */
+  async deletePromptGeneration(
+    generationId: string
+  ): Promise<DeletePromptGenerationResponse> {
+    return this.delete<DeletePromptGenerationResponse>(
+      `/prompt-generations/${generationId}`
+    )
+  }
+}