Initialization

.gitignore

@@ -1,5 +1,17 @@
+# Test coverage reports
+coverage/
+.nyc_output/
+
+# Test runner cache
+.cache/
+
+# Compiled test output (if using TypeScript)
+*.tsbuildinfo
+
+# Logs
+*.log
 # Logs
-logs
+logs/
 *.log
 npm-debug.log*
 yarn-debug.log*
@@ -10,73 +22,42 @@ lerna-debug.log*
 report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
 
 # Runtime data
-pids
+pids/
 *.pid
 *.seed
 *.pid.lock
 
-# Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
-
-# Coverage directory used by tools like istanbul
-coverage
+# Coverage directories
+coverage/
 *.lcov
+.nyc_output/
 
-# nyc test coverage
-.nyc_output
-
-# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
-
-# Bower dependency directory (https://bower.io/)
-bower_components
-
-# node-waf configuration
-.lock-wscript
-
-# Compiled binary addons (https://nodejs.org/api/addons.html)
-build/Release
-
-# Dependency directories
-node_modules/
-jspm_packages/
-
-# Snowpack dependency directory (https://snowpack.dev/)
-web_modules/
+# Build output
+build/
+dist/
 
-# TypeScript cache
+# TypeScript
 *.tsbuildinfo
 
-# Optional npm cache directory
-.npm
-
-# Optional eslint cache
-.eslintcache
-
-# Optional stylelint cache
-.stylelintcache
-
-# Optional REPL history
-.node_repl_history
-
-# Output of 'npm pack'
-*.tgz
-
-# Yarn Integrity file
-.yarn-integrity
+# Node modules
+node_modules/
 
-# dotenv environment variable files
+# Environment files
 .env
 .env.*
 !.env.example
 
-# parcel-bundler cache (https://parceljs.org/)
-.cache
-.parcel-cache
+# IDE and editor folders
+.vscode/
+.idea/
 
-# Next.js build output
-.next
-out
+# Misc
+*.tgz
+.cache/
+.parcel-cache/
+.next/
+out/
+.nuxt/
 
 # Nuxt.js build / generate output
 .nuxt
@@ -137,3 +118,6 @@ dist
 # Vite logs files
 vite.config.js.timestamp-*
 vite.config.ts.timestamp-*
+
+# artifacts
+*.xcresult

README.md

@@ -1 +1,38 @@
-# ios-mcp-code-quality-server
+# ios-mcp-code-quality-server
+
+# MCP Server for iOS Code Quality (Local Deployment)
+
+## Local Setup Instructions
+
+1. **Install dependencies:**
+   ```sh
+   npm install
+   ```
+
+2. **Start the server:**
+   ```sh
+   npm start
+   # or
+   node dist/index.js
+   ```
+
+3. **Configure your agent (e.g., Copilot):**
+   - Set the MCP server endpoint to `http://localhost:3000` in the agent's settings.
+
+4. **Run the agent as usual.**
+   - The agent will delegate supported functions to your MCP server.
+
+## Notes
+- No cloud hosting required; all data stays on your machine.
+- Make sure your MCP server is running before starting the agent.
+- For troubleshooting, check logs in the terminal and ensure all required environment variables are set.
+
+## Security
+- Do not share your local MCP server endpoint or credentials.
+
+## Supported Endpoints
+- `/run-task` (POST): Run a code quality or test automation task.
+- `/status` (GET): Check server status.
+
+## Error Handling
+- The server will log and return clear error messages for missing environment variables or failed requests.

jest.config.mjs

@@ -0,0 +1,22 @@
+import presets from 'ts-jest/presets/index.js';
+const { defaultsESM } = presets;
+
+export default {
+  ...defaultsESM,
+  preset: 'ts-jest/presets/default-esm',
+  testEnvironment: 'node',
+  extensionsToTreatAsEsm: ['.ts', '.mts'],
+  globals: {
+    'ts-jest': {
+      useESM: true
+    }
+  },
+  moduleNameMapper: {
+    '^(\.{1,2}/.*)\\.js$': '$1'
+  },
+  transform: {},
+  testMatch: ['**/__tests__/**/*.test.ts', '**/__tests__/**/*.test.mts'],
+  transformIgnorePatterns: [
+    '/node_modules/(?!(p-queue|eventemitter3)/)'
+  ],
+};