refactor: Update references from 'codehist' to 'AI chat' across the codebase and enhance type safety in chat import tools

Author: tikazyq

.devlog/entries/278-fix-chat-system-build-errors-and-integration-issue.json

@@ -4,10 +4,10 @@
   "title": "Fix: Chat System Build Errors and Integration Issues",
   "type": "bugfix",
   "description": "Multiple compilation errors and integration issues in the chat system implementation affecting core package build, TypeORM entity definitions, API endpoints, and MCP tool integration. Build failures are blocking development and testing of the chat feature.",
-  "status": "new",
+  "status": "cancelled",
   "priority": "high",
   "createdAt": "2025-07-24T13:52:08.420Z",
-  "updatedAt": "2025-07-24T13:52:08.420Z",
+  "updatedAt": "2025-07-24T14:26:52.365Z",
   "notes": [],
   "files": [],
   "relatedDevlogs": [],
@@ -36,5 +36,6 @@
     "suggestedNextSteps": [],
     "lastAIUpdate": "2025-07-24T13:52:08.420Z",
     "contextVersion": 1
-  }
+  },
+  "closedAt": "2025-07-24T14:26:52.365Z"
 }

.devlog/entries/279-remove-legacy-codehist-references-from-codebase.json

@@ -4,10 +4,10 @@
   "title": "Remove legacy 'codehist' references from codebase",
   "type": "refactor",
   "description": "Clean up remaining references to \"codehist\" throughout the codebase, replacing them with more appropriate terms like \"GitHub Copilot\", \"VS Code\", or generic chat import terminology. The package was renamed from @devlog/codehist → @devlog/ai-chat → @devlog/ai, but many comments, descriptions, method names, and configurations still reference the old \"codehist\" name which is confusing and outdated.",
-  "status": "in-progress",
+  "status": "done",
   "priority": "medium",
   "createdAt": "2025-07-24T13:59:47.120Z",
-  "updatedAt": "2025-07-24T14:22:20.666Z",
+  "updatedAt": "2025-07-24T14:26:09.069Z",
   "notes": [
     {
       "id": "0f7318d0-40dc-4111-bca5-5a5949cc6e46",
@@ -66,6 +66,24 @@
         "packages/ai/src/services/chat-hub-service.ts",
         "packages/web/app/api/workspaces/[id]/chat/import/route.ts"
       ]
+    },
+    {
+      "id": "5a7ba6ae-70a2-447e-9bd9-b1e69dcf12e7",
+      "timestamp": "2025-07-24T14:25:57.287Z",
+      "category": "progress",
+      "content": "🎯 **Final Cleanup Complete**:\n\n✅ **MCP Tools Updated**:\n- Updated source enum to use new ChatSource types: 'github-copilot', 'cursor', 'claude-code', 'windsurf', 'manual'\n- Updated descriptions to remove 'codehist' references\n- Default source changed to 'github-copilot'\n\n✅ **Comments Cleaned**:\n- Updated model comments: \"CodeHist\" → \"AI Chat processing\"\n- Updated exporter comments: \"CodeHist chat data\" → \"AI chat data\"\n- All legacy terminology removed from active codebase\n\n✅ **Build Verification**:\n- ✅ @devlog/ai builds successfully\n- ✅ @devlog/web builds successfully \n- ✅ @devlog/mcp builds successfully\n- ✅ All packages compile without errors\n\n**Status**: All legacy 'codehist' references removed. ChatHub architecture complete!",
+      "files": [
+        "packages/mcp/src/tools/chat-tools.ts",
+        "packages/ai/src/models/index.ts",
+        "packages/ai/src/exporters/markdown.ts",
+        "packages/ai/src/exporters/json.ts"
+      ]
+    },
+    {
+      "id": "69ad8872-d30e-4319-8782-ea2a7084b287",
+      "timestamp": "2025-07-24T14:26:09.068Z",
+      "category": "progress",
+      "content": "Completed: Successfully completed the removal of legacy 'codehist' references and transformed the architecture to use ChatHub as the central data receiver service. \n\n**Key Accomplishments**:\n- **Architectural Transformation**: Changed from local file import to client-server data streaming\n- **Service Redesign**: Created ChatHubService with data ingestion methods (ingestChatSessions, ingestChatMessages, processBulkChatData)\n- **Type Safety**: Introduced ChatSource type with proper AI assistant names\n- **API Modernization**: Updated endpoints to receive structured chat data from clients\n- **Complete Cleanup**: Removed all legacy 'codehist' references from active codebase\n- **Build Verification**: All packages compile successfully\n\n**Impact**: \n- Much cleaner client-server separation\n- Ready for @devlog/cli integration (devlog #280)\n- Scalable architecture for multiple AI assistant integrations\n- Eliminated complex cross-platform file system logic from server"
     }
   ],
   "files": [],
@@ -105,5 +123,6 @@
     ],
     "lastAIUpdate": "2025-07-24T14:04:58.728Z",
     "contextVersion": 2
-  }
+  },
+  "closedAt": "2025-07-24T14:26:09.069Z"
 }

packages/ai/src/exporters/json.ts

@@ -1,6 +1,6 @@
 /**
- * Simple JSON exporter for CodeHist chat data
- * 
+ * Simple JSON exporter for AI chat data
+ *
  * TypeScript implementation without complex configuration.
  */
 
@@ -15,13 +15,17 @@ export interface JSONExportOptions {
 export class JSONExporter {
   private defaultOptions: JSONExportOptions = {
     indent: 2,
-    ensureAscii: false
+    ensureAscii: false,
   };
 
   /**
    * Export arbitrary data to JSON file
    */
-  async exportData(data: Record<string, any>, outputPath: string, options?: JSONExportOptions): Promise<void> {
+  async exportData(
+    data: Record<string, any>,
+    outputPath: string,
+    options?: JSONExportOptions,
+  ): Promise<void> {
     const exportOptions = { ...this.defaultOptions, ...options };
 
     // Ensure output directory exists
@@ -37,7 +41,11 @@ export class JSONExporter {
   /**
    * Export chat data specifically
    */
-  async exportChatData(data: Record<string, any>, outputPath: string, options?: JSONExportOptions): Promise<void> {
+  async exportChatData(
+    data: Record<string, any>,
+    outputPath: string,
+    options?: JSONExportOptions,
+  ): Promise<void> {
     return this.exportData(data, outputPath, options);
   }
 

packages/ai/src/exporters/markdown.ts

@@ -1,5 +1,5 @@
 /**
- * Simple Markdown exporter for CodeHist chat data
+ * Simple Markdown exporter for AI chat data
  *
  * TypeScript implementation without complex configuration.
  */

packages/ai/src/models/index.ts

@@ -1,7 +1,7 @@
 /**
- * Data models for CodeHist
- * 
- * TypeScript interfaces and classes for representing chat histories 
+ * Data models for AI Chat processing
+ *
+ * TypeScript interfaces and classes for representing chat histories
  * focused on core chat functionality.
  */
 
@@ -55,7 +55,7 @@ export const MessageSchema = z.object({
   role: z.enum(['user', 'assistant']),
   content: z.string(),
   timestamp: z.string().datetime(),
-  metadata: z.record(z.unknown()).default({})
+  metadata: z.record(z.unknown()).default({}),
 });
 
 export const ChatSessionSchema = z.object({
@@ -64,15 +64,15 @@ export const ChatSessionSchema = z.object({
   messages: z.array(MessageSchema).default([]),
   workspace: z.string().optional(),
   session_id: z.string().optional(),
-  metadata: z.record(z.unknown()).default({})
+  metadata: z.record(z.unknown()).default({}),
 });
 
 export const WorkspaceDataSchema = z.object({
   agent: z.string(),
   version: z.string().optional(),
   workspace_path: z.string().optional(),
   chat_sessions: z.array(ChatSessionSchema).default([]),
-  metadata: z.record(z.unknown()).default({})
+  metadata: z.record(z.unknown()).default({}),
 });
 
 // TypeScript interfaces
@@ -133,12 +133,15 @@ export interface ChatStatistics {
   total_messages: number;
   message_types: Record<string, number>;
   session_types: Record<string, number>;
-  workspace_activity: Record<string, {
-    sessions: number;
-    messages: number;
-    first_seen: string;
-    last_seen: string;
-  }>;
+  workspace_activity: Record<
+    string,
+    {
+      sessions: number;
+      messages: number;
+      first_seen: string;
+      last_seen: string;
+    }
+  >;
   date_range: {
     earliest: string | null;
     latest: string | null;
@@ -168,7 +171,7 @@ export class MessageData implements Message {
       role: this.role,
       content: this.content,
       timestamp: this.timestamp.toISOString(),
-      metadata: this.metadata
+      metadata: this.metadata,
     };
   }
 
@@ -179,7 +182,7 @@ export class MessageData implements Message {
       role: validated.role,
       content: validated.content,
       timestamp: new Date(validated.timestamp),
-      metadata: validated.metadata as MessageMetadata
+      metadata: validated.metadata as MessageMetadata,
     });
   }
 }
@@ -205,12 +208,12 @@ export class ChatSessionData implements ChatSession {
     return {
       agent: this.agent,
       timestamp: this.timestamp.toISOString(),
-      messages: this.messages.map(msg => 
-        msg instanceof MessageData ? msg.toDict() : new MessageData(msg).toDict()
+      messages: this.messages.map((msg) =>
+        msg instanceof MessageData ? msg.toDict() : new MessageData(msg).toDict(),
       ),
       workspace: this.workspace,
       session_id: this.session_id,
-      metadata: this.metadata
+      metadata: this.metadata,
     };
   }
 
@@ -219,10 +222,12 @@ export class ChatSessionData implements ChatSession {
     return new ChatSessionData({
       agent: validated.agent,
       timestamp: new Date(validated.timestamp),
-      messages: validated.messages.map((msgData: unknown) => MessageData.fromDict(msgData as Record<string, unknown>)),
+      messages: validated.messages.map((msgData: unknown) =>
+        MessageData.fromDict(msgData as Record<string, unknown>),
+      ),
       workspace: validated.workspace,
       session_id: validated.session_id,
-      metadata: validated.metadata as ChatSessionMetadata
+      metadata: validated.metadata as ChatSessionMetadata,
     });
   }
 }
@@ -247,10 +252,12 @@ export class WorkspaceDataContainer implements WorkspaceData {
       agent: this.agent,
       version: this.version,
       workspace_path: this.workspace_path,
-      chat_sessions: this.chat_sessions.map(session => 
-        session instanceof ChatSessionData ? session.toDict() : new ChatSessionData(session).toDict()
+      chat_sessions: this.chat_sessions.map((session) =>
+        session instanceof ChatSessionData
+          ? session.toDict()
+          : new ChatSessionData(session).toDict(),
       ),
-      metadata: this.metadata
+      metadata: this.metadata,
     };
   }
 
@@ -260,8 +267,10 @@ export class WorkspaceDataContainer implements WorkspaceData {
       agent: validated.agent,
       version: validated.version,
       workspace_path: validated.workspace_path,
-      chat_sessions: validated.chat_sessions.map((sessionData: unknown) => ChatSessionData.fromDict(sessionData as Record<string, unknown>)),
-      metadata: validated.metadata as WorkspaceMetadata
+      chat_sessions: validated.chat_sessions.map((sessionData: unknown) =>
+        ChatSessionData.fromDict(sessionData as Record<string, unknown>),
+      ),
+      metadata: validated.metadata as WorkspaceMetadata,
     });
   }
 }

packages/mcp/src/tools/chat-tools.ts

@@ -25,7 +25,7 @@ function getApiClient(): DevlogApiClient {
 
 // Export MCP Tool argument interfaces for better type safety
 export interface ImportChatHistoryArgs {
-  source?: 'codehist' | 'vs-code';
+  source?: 'github-copilot' | 'cursor' | 'claude-code' | 'windsurf' | 'manual';
   autoLink?: boolean;
   autoLinkThreshold?: number;
   includeArchived?: boolean;
@@ -116,14 +116,15 @@ export interface GetChatWorkspacesArgs {
 
 export const importChatHistoryTool: Tool = {
   name: 'import_chat_history',
-  description: 'Import chat history from GitHub Copilot (via codehist) into devlog storage',
+  description:
+    'Import chat history from GitHub Copilot and other AI assistants into devlog storage',
   inputSchema: {
     type: 'object',
     properties: {
       source: {
         type: 'string',
-        enum: ['codehist', 'vs-code'],
-        default: 'codehist',
+        enum: ['github-copilot', 'cursor', 'claude-code', 'windsurf', 'manual'],
+        default: 'github-copilot',
         description: 'Source to import chat history from',
       },
       autoLink: {