feat: complete Task 1 - Setup core infrastructure and shared types

- Create comprehensive shared types package with core interfaces
  - UploadResult, Dataset, AccessCondition interfaces in core.ts
  - MCP protocol types (MCPToolDefinition, MCPRequest, MCPResponse)
  - Authentication types (AuthConfig, TokenInfo, APICredentials)
  - Error handling types (LighthouseError, RetryConfig)
  - Workspace context types (WorkspaceContext, ProjectFile)

- Configure Jest testing framework with robust patterns
  - Jest config with 80% coverage thresholds
  - Custom matchers and test utilities
  - Mock factories and fixtures for consistent testing
  - Timer utilities and async testing helpers
  - Comprehensive test patterns established

- Setup build scripts and development workflows
  - Turbo.js monorepo configuration
  - TypeScript compilation for all packages
  - Package scripts for build, test, lint, format
  - Development tools: Prettier, ESLint, Husky, lint-staged

- Create shared utilities and constants
  - File size limits, supported file types
  - Default configurations, encryption settings
  - Error handling with retry logic
  - Async operations and concurrency utilities
  - Comprehensive logging system

Author: Patrick-Ehimen

.vscode/settings.json

@@ -4,6 +4,6 @@
   "eslint.useFlatConfig": true,
   "eslint.validate": ["javascript", "typescript", "typescriptreact"],
   "editor.codeActionsOnSave": {
-    "source.fixAll.eslint": true
+    "source.fixAll.eslint": "explicit"
   }
 }

apps/mcp-server/package.json

@@ -7,20 +7,18 @@
     "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
-    "lint": "eslint src/**/*.ts",
     "clean": "rm -rf dist",
-    "dev": "ts-node src/index.ts"
+    "dev": "ts-node src/index.ts",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check ."
   },
   "dependencies": {
     "@lighthouse-tooling/sdk-wrapper": "workspace:*",
     "@lighthouse-tooling/types": "workspace:*",
     "@modelcontextprotocol/sdk": "latest"
   },
-  "scripts": {
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "format": "prettier --write .",
-    "format:check": "prettier --check ."
   "devDependencies": {
     "jest": "^29.7.0",
     "ts-jest": "^29.1.1",

package.json

@@ -18,7 +18,7 @@
     "ci:local": "pnpm run lint && pnpm run format:check",
     "test": "turbo run test",
     "clean": "turbo run clean",
-    "prepare": "husky"
+    "prepare": "husky",
     "test:coverage": "turbo run test:coverage",
     "verify-tests": "node scripts/verify-tests.js"
   },
@@ -42,7 +42,10 @@
     "eslint": "^9.36.0",
     "prettier": "^3.3.3",
     "husky": "^9.1.6",
-    "lint-staged": "^15.2.10"
+    "lint-staged": "^15.2.10",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.1",
+    "@types/jest": "^29.5.5"
   },
   "pnpm": {
     "overrides": {
@@ -52,10 +55,5 @@
       "typescript-eslint": "8.36.0",
       "@eslint/js": "^9.31.0"
     }
-    "eslint": "^8.0.0",
-    "prettier": "^3.0.0",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.1.1",
-    "@types/jest": "^29.5.5"
   }
 }

packages/shared/package.json

@@ -5,30 +5,23 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
-    "build": "tsc",
+    "build": "tsc -p tsconfig.build.json",
     "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
-    "lint": "eslint src/**/*.ts",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
     "clean": "rm -rf dist"
   },
   "devDependencies": {
     "jest": "^29.7.0",
     "ts-jest": "^29.1.1",
     "@types/jest": "^29.5.5",
     "typescript": "^5.0.0"
-    "dev": "tsc --watch",
-    "lint": "eslint src/**/*.ts",
-    "lint:fix": "eslint src/**/*.ts --fix",
-    "clean": "rm -rf dist"
   },
   "dependencies": {
     "@lighthouse-tooling/types": "workspace:*"
-  },
-  "scripts": {
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "format": "prettier --write .",
-    "format:check": "prettier --check ."
   }
 }

packages/shared/src/index.ts

@@ -23,3 +23,6 @@ export type {
   LoggerConfig,
   ConcurrencyConfig,
 } from "./utils";
+
+// Test utilities are only exported in development/test environments
+// They are not included in the production build

packages/shared/src/test-utils-export.ts

@@ -0,0 +1,6 @@
+/**
+ * Test utilities export - only for testing environments
+ * This file is excluded from the main build
+ */
+
+export * from "./test-utils";

packages/shared/tsconfig.build.json

@@ -0,0 +1,12 @@
+{
+  "extends": "./tsconfig.json",
+  "exclude": [
+    "dist",
+    "node_modules",
+    "**/*.test.ts",
+    "**/*.spec.ts",
+    "src/test-utils/**/*",
+    "src/test-utils-export.ts",
+    "__tests__/**/*"
+  ]
+}

packages/shared/tsconfig.json

@@ -13,5 +13,5 @@
     "noFallthroughCasesInSwitch": true
   },
   "include": ["src/**/*"],
-  "exclude": ["dist", "node_modules", "**/*.test.ts", "**/*.spec.ts"]
+  "exclude": ["dist", "node_modules", "**/*.test.ts", "**/*.spec.ts", "src/test-utils"]
 }

packages/types/package.json

@@ -9,6 +9,7 @@
     "lint:fix": "eslint . --fix",
     "format": "prettier --write .",
     "format:check": "prettier --check ."
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",