@codebakers/cli 3.3.11 → 3.3.13

package/src/lib/api.ts

@@ -260,3 +260,258 @@ export async function reportCliError(
     // Never fail on error reporting
   }
 }
+
+// ============================================================================
+// PROJECT TRACKING API
+// ============================================================================
+
+export interface ProjectSyncData {
+  // Project updates
+  project?: {
+    status?: 'discovery' | 'planning' | 'building' | 'testing' | 'completed' | 'paused' | 'failed';
+    overallProgress?: number;
+    prdContent?: string;
+    discoveryAnswers?: Record<string, unknown>;
+    patternsUsed?: string[];
+    detectedStack?: Record<string, string>;
+  };
+
+  // Phases to sync
+  phases?: Array<{
+    id?: string;
+    phaseNumber: number;
+    phaseName: string;
+    phaseDescription?: string;
+    status?: 'pending' | 'in_progress' | 'completed' | 'skipped' | 'failed';
+    progress?: number;
+    requiredPatterns?: string[];
+    aiConfidence?: number;
+    aiNotes?: string;
+    alternativesConsidered?: string[];
+    requiresApproval?: boolean;
+  }>;
+
+  // Events to record
+  events?: Array<{
+    eventType: string;
+    eventTitle: string;
+    eventDescription?: string;
+    eventData?: Record<string, unknown>;
+    phaseId?: string;
+    featureId?: string;
+    filePath?: string;
+    fileAction?: string;
+    linesChanged?: number;
+    aiConfidence?: number;
+    riskLevel?: 'low' | 'medium' | 'high' | 'critical';
+    riskReason?: string;
+  }>;
+
+  // Test runs to record
+  testRuns?: Array<{
+    testType: string;
+    testCommand?: string;
+    passed: boolean;
+    totalTests: number;
+    passedTests: number;
+    failedTests: number;
+    skippedTests: number;
+    durationMs?: number;
+    phaseId?: string;
+    featureId?: string;
+  }>;
+
+  // Files to track
+  files?: Array<{
+    filePath: string;
+    fileName: string;
+    fileType?: string;
+    lineCount?: number;
+    complexity?: number;
+    parentPath?: string;
+    depth?: number;
+    status?: 'active' | 'deleted' | 'renamed';
+    featureId?: string;
+  }>;
+
+  // Dependencies to track
+  dependencies?: Array<{
+    sourceFile: string;
+    sourceType?: string;
+    targetFile: string;
+    targetType?: string;
+    dependencyType?: string;
+    importName?: string;
+    featureId?: string;
+  }>;
+
+  // Risk flags to create
+  riskFlags?: Array<{
+    riskLevel: 'low' | 'medium' | 'high' | 'critical';
+    riskCategory: string;
+    riskTitle: string;
+    riskDescription?: string;
+    triggerFile?: string;
+    triggerCode?: string;
+    triggerReason?: string;
+    aiRecommendation?: string;
+    phaseId?: string;
+    featureId?: string;
+  }>;
+
+  // Resource usage to track
+  resources?: Array<{
+    resourceType: string;
+    apiEndpoint?: string;
+    apiMethod?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    durationMs?: number;
+    estimatedCostMillicents?: number;
+    phaseId?: string;
+    featureId?: string;
+  }>;
+
+  // Create snapshot
+  createSnapshot?: {
+    snapshotName: string;
+    snapshotDescription?: string;
+    isAutomatic?: boolean;
+    gitCommitHash?: string;
+    gitBranch?: string;
+    projectState?: Record<string, unknown>;
+    fileTree?: Array<Record<string, unknown>>;
+    phaseId?: string;
+  };
+}
+
+export interface ProjectSyncResult {
+  projectId: string;
+  synced: {
+    project: boolean;
+    phases: number;
+    events: number;
+    testRuns: number;
+    files: number;
+    dependencies: number;
+    riskFlags: number;
+    resources: number;
+    snapshot: boolean;
+  };
+}
+
+/**
+ * Get or create a project on the server
+ */
+export async function getOrCreateProject(
+  projectHash: string,
+  projectName: string,
+  projectDescription?: string,
+  detectedStack?: Record<string, string>,
+  authHeaders?: Record<string, string>
+): Promise<{ projectId: string; isNew: boolean }> {
+  const apiUrl = getApiUrl();
+
+  const response = await fetch(`${apiUrl}/api/projects`, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      ...authHeaders,
+    },
+    body: JSON.stringify({
+      projectHash,
+      projectName,
+      projectDescription,
+      detectedStack,
+    }),
+  });
+
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({ error: 'Unknown error' }));
+    throw createApiError(
+      error.error || 'Failed to create/get project',
+      'PROJECT_ERROR',
+      ['Check your internet connection', 'Verify your API key is valid']
+    );
+  }
+
+  const result = await response.json();
+  return {
+    projectId: result.data?.id || result.id,
+    isNew: result.data?.isNew || result.isNew || false,
+  };
+}
+
+/**
+ * Sync project data to the server
+ * This is the main endpoint for keeping the server updated with local state
+ */
+export async function syncProjectData(
+  projectId: string,
+  data: ProjectSyncData,
+  authHeaders?: Record<string, string>
+): Promise<ProjectSyncResult> {
+  const apiUrl = getApiUrl();
+
+  const response = await fetch(`${apiUrl}/api/projects/${projectId}/sync`, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      ...authHeaders,
+    },
+    body: JSON.stringify(data),
+  });
+
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({ error: 'Unknown error' }));
+    throw createApiError(
+      error.error || 'Failed to sync project data',
+      'SYNC_ERROR',
+      ['Check your internet connection', 'Try again in a few moments']
+    );
+  }
+
+  const result = await response.json();
+  return result.data || result;
+}
+
+/**
+ * Get project dashboard data from the server
+ */
+export async function getProjectDashboard(
+  projectId: string,
+  authHeaders?: Record<string, string>
+): Promise<Record<string, unknown>> {
+  const apiUrl = getApiUrl();
+
+  const response = await fetch(`${apiUrl}/api/projects/${projectId}`, {
+    method: 'GET',
+    headers: {
+      'Accept': 'application/json',
+      ...authHeaders,
+    },
+  });
+
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({ error: 'Unknown error' }));
+    throw createApiError(
+      error.error || 'Failed to get project dashboard',
+      'PROJECT_ERROR',
+      ['Check your internet connection', 'Verify the project exists']
+    );
+  }
+
+  const result = await response.json();
+  return result.data || result;
+}
+
+/**
+ * Create a project hash from the project directory
+ * Uses a combination of directory path and package.json name for uniqueness
+ */
+export function createProjectHash(projectDir: string, packageName?: string): string {
+  const crypto = require('crypto');
+  const hashInput = packageName ? `${projectDir}:${packageName}` : projectDir;
+  return crypto.createHash('sha256').update(hashInput).digest('hex').substring(0, 16);
+}