feat(chat): Introduce ChatHub service for importing chat history and refactor related components

Author: tikazyq

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

@@ -0,0 +1,40 @@
+{
+  "id": 278,
+  "key": "fix-chat-system-build-errors-and-integration-issue",
+  "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",
+  "priority": "high",
+  "createdAt": "2025-07-24T13:52:08.420Z",
+  "updatedAt": "2025-07-24T13:52:08.420Z",
+  "notes": [],
+  "files": [],
+  "relatedDevlogs": [],
+  "context": {
+    "businessContext": "The chat history feature implementation is currently broken with build failures preventing testing and integration. This blocks completion of the chat visualization system and impacts developer productivity.",
+    "technicalContext": "Issues identified in multiple packages: core package TypeScript compilation errors in chat entities, potential API endpoint configuration problems, and MCP tool integration issues. Need systematic diagnosis and targeted fixes to restore functionality.",
+    "dependencies": [],
+    "decisions": [],
+    "acceptanceCriteria": [
+      "Core package builds successfully without TypeScript errors",
+      "Chat entities compile correctly with proper TypeORM decorators",
+      "API endpoints respond correctly to requests",
+      "MCP tools can communicate with chat APIs",
+      "Import functionality works end-to-end",
+      "No runtime errors in chat-related operations",
+      "All affected packages build and test successfully",
+      "Integration between packages works correctly"
+    ],
+    "risks": []
+  },
+  "aiContext": {
+    "currentSummary": "",
+    "keyInsights": [],
+    "openQuestions": [],
+    "relatedPatterns": [],
+    "suggestedNextSteps": [],
+    "lastAIUpdate": "2025-07-24T13:52:08.420Z",
+    "contextVersion": 1
+  }
+}

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

@@ -0,0 +1,81 @@
+{
+  "id": 279,
+  "key": "remove-legacy-codehist-references-from-codebase",
+  "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",
+  "priority": "medium",
+  "createdAt": "2025-07-24T13:59:47.120Z",
+  "updatedAt": "2025-07-24T14:11:12.587Z",
+  "notes": [
+    {
+      "id": "0f7318d0-40dc-4111-bca5-5a5949cc6e46",
+      "timestamp": "2025-07-24T14:02:03.781Z",
+      "category": "progress",
+      "content": "Starting implementation with \"ChatHub\" as the new catchy name for the AI chat history handling module. This will replace all \"codehist\" references with \"ChatHub\" terminology throughout the codebase."
+    },
+    {
+      "id": "7cd6abe4-816b-46af-866f-eb7404b5d727",
+      "timestamp": "2025-07-24T14:05:04.685Z",
+      "category": "idea",
+      "content": "**Architecture Redesign Decision**: Instead of having a generic chat-import-service that references ChatHub, ChatHub itself should be the primary service. This means:\n\n1. Rename `chat-import-service.ts` → `chat-hub-service.ts` \n2. `DefaultChatImportService` → `ChatHubService`\n3. Methods become source-specific: `importFromGitHubCopilot()`, `importFromCursor()`, etc.\n4. ChatHub is positioned as the central hub for all AI chat history processing\n\nThis is much cleaner architecturally and makes the naming intuitive."
+    },
+    {
+      "id": "a1ac9e15-3b6a-4b71-8f9e-4ea35d9cd823",
+      "timestamp": "2025-07-24T14:05:25.356Z",
+      "category": "progress",
+      "content": "Updated Acceptance Criteria to reflect the ChatHub-centric architecture. The plan now focuses on making ChatHub the primary service rather than just removing 'codehist' references. This includes:\n\n- File rename: chat-import-service.ts → chat-hub-service.ts\n- Class rename: DefaultChatImportService → ChatHubService  \n- Interface rename: ChatImportService → ChatHubService\n- Source-specific methods: importFromGitHubCopilot(), etc.\n- Complete package-wide refactoring to use ChatHub terminology\n\nThis gives us a much cleaner and more intuitive architecture."
+    },
+    {
+      "id": "89fc76b4-27e2-44b3-873c-5ff60630e60c",
+      "timestamp": "2025-07-24T14:11:12.587Z",
+      "category": "progress",
+      "content": "**Core refactoring completed**:\n\n✅ **Architecture Changes**:\n- Renamed `chat-import-service.ts` → `chat-hub-service.ts`\n- Created `IChatHubService` interface and `ChatHubService` implementation\n- Added typed `ChatSource` type with proper values: 'github-copilot', 'cursor', 'claude-code', 'windsurf', 'manual'\n\n✅ **Types Updated**:\n- Updated `ChatImportConfig.source` to use `ChatSource` type\n- Updated `ChatImportProgress.source` to use `ChatSource` type\n- Updated file comments to reference proper AI chat sources\n\n✅ **API Updates**:\n- Updated web API route to import and use `ChatHubService`\n- Default source changed to 'github-copilot'\n- Updated service exports in AI package\n\n**Next**: Update MCP tools and complete remaining references",
+      "files": [
+        "packages/core/src/types/chat.ts",
+        "packages/ai/src/services/chat-hub-service.ts",
+        "packages/ai/src/services/index.ts",
+        "packages/web/app/api/workspaces/[id]/chat/import/route.ts"
+      ]
+    }
+  ],
+  "files": [],
+  "relatedDevlogs": [],
+  "context": {
+    "businessContext": "Removing outdated terminology improves code maintainability and reduces confusion for new developers. The \"codehist\" name was specific to the original Python project and doesn't clearly communicate the current functionality of GitHub Copilot chat import capabilities.",
+    "technicalContext": "Architecture decision: ChatHub should be the primary service name, not just a source reference. The current chat-import-service.ts is too generic - ChatHub itself should be the service that handles importing from various AI chat history sources (GitHub Copilot, Cursor, Claude, etc.). This requires renaming the service file and restructuring the architecture to be ChatHub-centric.",
+    "dependencies": [],
+    "decisions": [],
+    "acceptanceCriteria": [
+      "Rename chat-import-service.ts to chat-hub-service.ts",
+      "Create ChatHubService class to replace DefaultChatImportService",
+      "Update ChatImportService interface to ChatHubService interface",
+      "Method names become source-specific: importFromGitHubCopilot(), importFromCursor(), etc.",
+      "All imports across packages updated to use ChatHubService",
+      "MCP tools reference ChatHub as the primary service",
+      "API routes use ChatHubService instead of DefaultChatImportService",
+      "Comments and documentation position ChatHub as the central AI chat processing hub",
+      "Remove all legacy 'codehist' references from active code",
+      "Update type definitions and interfaces to use ChatHub terminology",
+      "Maintain backward compatibility in API responses where possible"
+    ],
+    "risks": []
+  },
+  "aiContext": {
+    "currentSummary": "",
+    "keyInsights": [],
+    "openQuestions": [],
+    "relatedPatterns": [],
+    "suggestedNextSteps": [
+      "Rename chat-import-service.ts to chat-hub-service.ts",
+      "Create ChatHubService class to replace DefaultChatImportService",
+      "Update method names to be source-specific (importFromGitHubCopilot)",
+      "Update all imports and references across packages",
+      "Update MCP tools to use ChatHub terminology",
+      "Update API routes to use ChatHub service"
+    ],
+    "lastAIUpdate": "2025-07-24T14:04:58.728Z",
+    "contextVersion": 2
+  }
+}

.github/workflows/ci.yml

@@ -13,7 +13,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [ 22 ]
+        node-version: [ 20, 22 ]
 
     steps:
       - name: Checkout code

package.json

@@ -56,10 +56,8 @@
     "vitest": "^2.1.9"
   },
   "engines": {
-    "node": ">=22",
-    "pnpm": ">=10.13.1"
+    "node": ">=20"
   },
-  "packageManager": "[email protected]",
   "lint-staged": {
     "packages/**/*.{ts,tsx}": [
       "prettier --write"

packages/ai/package.json

@@ -55,6 +55,6 @@
     "rimraf": "^5.0.5"
   },
   "engines": {
-    "node": ">=22"
+    "node": ">=20"
   }
 }

…s/ai/src/services/chat-import-service.ts …ages/ai/src/services/chat-hub-service.tspackages/ai/src/services/chat-import-service.ts renamed to packages/ai/src/services/chat-hub-service.ts packages/ai/src/services/chat-import-service.ts renamed to packages/ai/src/services/chat-hub-service.ts

@@ -1,7 +1,7 @@
 /**
  * Chat import service for importing chat history from various sources
  *
- * This service handles importing chat data from sources like codehist (GitHub Copilot)
+ * This service handles importing chat data through ChatHub (GitHub Copilot, etc.)
  * into the devlog storage system with proper workspace mapping and linking.
  */
 
@@ -14,16 +14,17 @@ import type {
   ChatMessage,
   ChatSession,
   ChatSessionId,
+  ChatSource,
   ChatStatus,
   DevlogEntry,
   StorageProvider,
 } from '@devlog/core';
 
-export interface ChatImportService {
+export interface IChatHubService {
   /**
-   * Import chat history from codehist parser
+   * Import chat history from GitHub Copilot
    */
-  importFromCodehist(config: ChatImportConfig): Promise<ChatImportProgress>;
+  importFromGitHubCopilot(config: ChatImportConfig): Promise<ChatImportProgress>;
 
   /**
    * Get import progress by ID
@@ -44,20 +45,20 @@ export interface ChatImportService {
   autoLinkSessions(sessionIds: ChatSessionId[], threshold?: number): Promise<ChatDevlogLink[]>;
 }
 
-export class DefaultChatImportService implements ChatImportService {
+export class ChatHubService implements IChatHubService {
   private storageProvider: StorageProvider;
   private activeImports = new Map<string, ChatImportProgress>();
 
   constructor(storageProvider: StorageProvider) {
     this.storageProvider = storageProvider;
   }
 
-  async importFromCodehist(config: ChatImportConfig): Promise<ChatImportProgress> {
+  async importFromGitHubCopilot(config: ChatImportConfig): Promise<ChatImportProgress> {
     const importId = this.generateImportId();
     const progress: ChatImportProgress = {
       importId,
       status: 'pending',
-      source: 'codehist',
+      source: 'github-copilot',
       progress: {
         totalSessions: 0,
         processedSessions: 0,
@@ -178,9 +179,9 @@ export class DefaultChatImportService implements ChatImportService {
     progress.status = 'running';
 
     try {
-      console.log(`[ChatImportService] Starting import ${importId} from ${config.source}`);
+      console.log(`[ChatHubService] Starting import ${importId} from ${config.source}`);
 
-      // Initialize codehist parser
+      // Initialize GitHub Copilot parser
       const parser = new CopilotParser();
       const workspaceData = await parser.discoverVSCodeCopilotData();
 

packages/ai/src/services/index.ts

@@ -1,5 +1,5 @@
 /**
- * AI Services - Chat import and other AI-related services
+ * AI Services - ChatHub and other AI-related services
  */
 
-export { DefaultChatImportService, type ChatImportService } from './chat-import-service.js';
+export { ChatHubService, type IChatHubService } from './chat-hub-service.js';

packages/core/package.json

@@ -58,6 +58,6 @@
     "vitest": "^2.1.9"
   },
   "engines": {
-    "node": ">=22"
+    "node": ">=20"
   }
 }

packages/core/src/types/chat.ts

@@ -2,7 +2,7 @@
  * Chat history types and interfaces for devlog integration
  *
  * These types support importing and managing AI chat histories from various sources
- * (primarily GitHub Copilot via codehist) and linking them to devlog entries.
+ * (GitHub Copilot, Cursor, Claude Code, etc.) and linking them to devlog entries.
  */
 
 import type { DevlogId } from './core.js';
@@ -302,7 +302,7 @@ export interface ChatImportProgress {
   status: 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
 
   /** Source being imported from */
-  source: string;
+  source: ChatSource;
 
   /** Progress information */
   progress: {
@@ -336,11 +336,16 @@ export interface ChatImportProgress {
 }
 
 /**
- * Configuration for chat import operations
+ * Chat import source types
+ */
+export type ChatSource = 'github-copilot' | 'cursor' | 'claude-code' | 'windsurf' | 'manual';
+
+/**
+ * Configuration for importing chat history from various sources
  */
 export interface ChatImportConfig {
   /** Source type */
-  source: 'codehist' | 'vs-code' | 'cursor' | 'manual';
+  source: ChatSource;
 
   /** Source-specific configuration */
   sourceConfig: Record<string, any>;

packages/mcp/package.json

@@ -65,6 +65,6 @@
     "vitest": "^2.1.9"
   },
   "engines": {
-    "node": ">=22"
+    "node": ">=20"
   }
 }