@programinglive/dev-workflow-mcp-server 1.7.13 → 1.7.16

package/CHANGELOG.md

@@ -2,6 +2,76 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [1.7.16](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.7.15...v1.7.16) (2025-12-24)
+
+
+### 🐛 Bug Fixes
+
+* align database schema with dashboard and improve user ID handling ([69e7f38](https://github.com/programinglive/dev-workflow-mcp-server/commit/69e7f381955d15bb727a6e309082a344729d1c1e))
+
+
+### 🧹 Chores
+
+* cleanup temporary debugging scripts ([a5e2b15](https://github.com/programinglive/dev-workflow-mcp-server/commit/a5e2b15b894632efadce46d83caf4d008e50fdd3))
+* sync version to 1.7.15 across web and landing pages ([c520e4a](https://github.com/programinglive/dev-workflow-mcp-server/commit/c520e4a5d795c880fb74f31142b128a9c55beb6f))
+
+
+### 📝 Documentation
+
+* update macOS MCP config instructions ([1e368da](https://github.com/programinglive/dev-workflow-mcp-server/commit/1e368da37bede45e0282b1312002f2fedeb6ad60))
+
+### [1.7.15](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.7.14...v1.7.15) (2025-12-19)
+
+
+### 🐛 Bug Fixes
+
+* optimize startup performance and add database connection resilience ([bff2714](https://github.com/programinglive/dev-workflow-mcp-server/commit/bff27146fe9537788741e4a084191bce93588569))
+* refactor Navbar and History to use absolute API client URLs v1.7.18 ([dc33eae](https://github.com/programinglive/dev-workflow-mcp-server/commit/dc33eae612067c5246ca69d08960090c0a0ad6bd))
+* sync all version labels to 1.7.14 and improve netlify routing ([78712eb](https://github.com/programinglive/dev-workflow-mcp-server/commit/78712eb398458605f77b2ba78c9ff61a0be1d335))
+* sync all version strings to 1.7.14 ([e2a1795](https://github.com/programinglive/dev-workflow-mcp-server/commit/e2a1795a7b794c8874b1e610de3370cd6ed5fa7a))
+* sync version to 1.7.14 and fix static routing via trailingSlash ([1c152bd](https://github.com/programinglive/dev-workflow-mcp-server/commit/1c152bd23bbfd30a73e0a89107f4ea18564d20d0))
+
+### [1.7.14](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.7.13...v1.7.14) (2025-12-19)
+
+
+### ✨ Features
+
+* add API dependencies and update login to use API client ([94bb42f](https://github.com/programinglive/dev-workflow-mcp-server/commit/94bb42f27b4bd225bb3813b81d5f2bff973edb16))
+* add REST API server for frontend database access ([cdb347c](https://github.com/programinglive/dev-workflow-mcp-server/commit/cdb347cf204ce423b94db7e72980783e986a124d))
+* implement JWT authentication and update client ([8efbe80](https://github.com/programinglive/dev-workflow-mcp-server/commit/8efbe80c3a69046f716b247fc359158dc8fec3e2))
+
+
+### ♻️ Refactors
+
+* remove session cookies, enforce JWT only ([bacd83a](https://github.com/programinglive/dev-workflow-mcp-server/commit/bacd83a16510499667143f4906d0cc8de0127d61))
+
+
+### 🐛 Bug Fixes
+
+* add credentials:include to getCurrentUser to persist session ([b8f2df5](https://github.com/programinglive/dev-workflow-mcp-server/commit/b8f2df531a2d2bae78ad3c3ea2c7dcda62e5e835))
+* add root netlify.toml for monorepo support ([54c5ed3](https://github.com/programinglive/dev-workflow-mcp-server/commit/54c5ed3960aafd5a814773efa487efe9197d4385))
+* enable trust proxy and force secure cookies for cross-domain session ([2c5d6e8](https://github.com/programinglive/dev-workflow-mcp-server/commit/2c5d6e858d05de06304d88286b931b1f12a95bf1))
+* ensure getMe uses full API URL ([b3bd0da](https://github.com/programinglive/dev-workflow-mcp-server/commit/b3bd0da097de57b42d9253615f791677011486af))
+* force API URL to tunnel address to resolve cached old IP ([1883731](https://github.com/programinglive/dev-workflow-mcp-server/commit/18837313a7b96395f1cf04b56d7fe1a74e13b1ed))
+* inline auth functions in API server ([eefd73c](https://github.com/programinglive/dev-workflow-mcp-server/commit/eefd73c82dcf47d419662eaeb8854f6047e6464a))
+* remove duplicate variable declarations in API server ([31d3621](https://github.com/programinglive/dev-workflow-mcp-server/commit/31d3621213ddb3560ee0570fdf6411d9acf7018f))
+* remove dynamic API route for static export ([05a4dd0](https://github.com/programinglive/dev-workflow-mcp-server/commit/05a4dd0e4901e5ac329e50ebe392839d1242de4e))
+* remove explicit publish path to fix netlify build ([cd64bcf](https://github.com/programinglive/dev-workflow-mcp-server/commit/cd64bcf0b4effb71be090235357d665d1f26b567))
+* remove incorrect netlify publish dir for dynamic build ([ea34cf4](https://github.com/programinglive/dev-workflow-mcp-server/commit/ea34cf464466b4ddc8eaa6432434d1fbabb3583e))
+* remove incorrect publish dir from netlify config ([010236f](https://github.com/programinglive/dev-workflow-mcp-server/commit/010236fd0eb1419f7cae4429159f4aac1a988174))
+* restore static export for netlify deployment ([685d841](https://github.com/programinglive/dev-workflow-mcp-server/commit/685d84178b239b5cd681b4d479456e69519a8af8))
+* update API URL to use Cloudflare Tunnel for HTTPS ([ab72f6c](https://github.com/programinglive/dev-workflow-mcp-server/commit/ab72f6c0b8acc6974aba7c8df8418e35da6f2a51))
+* use apiClient in history page and add version indicator ([4889669](https://github.com/programinglive/dev-workflow-mcp-server/commit/48896694166cd5d42ab4134d4dbfdb0df8ca0d44))
+* use npm install instead of ci to avoid lockfile issues ([e5fae26](https://github.com/programinglive/dev-workflow-mcp-server/commit/e5fae26f767c5f0e4aba2593df321c700ac14a38))
+
+
+### 🧹 Chores
+
+* bump version to 1.7.14 to ensure fresh build ([f7d8886](https://github.com/programinglive/dev-workflow-mcp-server/commit/f7d88861ceb111c57e3b34bf4b5a5cc25a19805b))
+* bump version to 1.7.15 for JWT frontend deploy ([7850268](https://github.com/programinglive/dev-workflow-mcp-server/commit/7850268d019251619d60a0a841db2bab8061be04))
+* cleanup post-release and update website version to 1.7.13 ([7341d44](https://github.com/programinglive/dev-workflow-mcp-server/commit/7341d446bbddcb9232e70606acaf950fde7ff5c2))
+* save pending changes before release ([4d4b1c9](https://github.com/programinglive/dev-workflow-mcp-server/commit/4d4b1c9e6122baed3cc6782a572fe3700dabf19b))
+
 ### [1.7.13](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.7.12...v1.7.13) (2025-12-18)
 
 

package/README.md

@@ -8,6 +8,11 @@
 
 An MCP (Model Context Protocol) server that helps enforce development discipline and workflow best practices. This server acts as your coding conscience, reminding you to follow proper development workflows.
 
+### 🛡️ Resilience Features
+- **Startup Resilience**: 5-second connection timeouts for external databases.
+- **Background Loading**: Non-critical assets (compatibility mirrors) initialize in the background to ensure sub-second startup.
+- **Diagnostic Mode**: Automatic startup timing logs displayed in stderr.
+
 ## 🎯 Purpose
 
 This MCP server guides you through a disciplined development workflow:
@@ -100,7 +105,12 @@ Point your MCP client to the server entry point. Replace `<PROJECT_ROOT>` with t
   "mcpServers": {
     "dev-workflow": {
       "command": "node",
-      "args": ["<PROJECT_ROOT>/index.js"]
+      "cwd": "<PROJECT_ROOT>",
+      "args": ["index.js"],
+      "env": {
+        "DEV_WORKFLOW_DB_TYPE": "postgres",
+        "DEV_WORKFLOW_DB_URL": "postgres://USER:PASS@HOST:5432/devworkflow"
+      }
     }
   }
 }
@@ -177,6 +187,28 @@ Point your MCP client to the server entry point. Replace `<PROJECT_ROOT>` with t
 
 > **Note:** On Windows paths in JSON require escaped backslashes (e.g., `"C:\\path\\to\\project"`).
 
+#### Full Windsurf MCP Config Example (macOS)
+
+If you keep this repository checked out at `/Users/alex/code/dev-workflow-mcp-server` and want to point Windsurf at a hosted PostgreSQL instance, drop the following into `~/Library/Application Support/Windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "dev-workflow": {
+      "command": "node",
+      "cwd": "/Users/alex/code/dev-workflow-mcp-server",
+      "args": ["index.js"],
+      "env": {
+        "DEV_WORKFLOW_DB_TYPE": "postgres",
+        "DEV_WORKFLOW_DB_URL": "postgres://devworkflow:devworkflow_secure_password@34.50.121.142:5432/devworkflow"
+      }
+    }
+  }
+}
+```
+
+This mirrors the Windows configuration shared in previous releases, but avoids `npx` lookup issues on macOS by launching the local `index.js` directly.
+
 ### 4. Restart Windsurf/Claude Desktop
 
 After adding the configuration, restart the application to load the MCP server.
@@ -201,6 +233,29 @@ Antigravity users should configure the MCP server in their `mcp_config.json`.
 
 See [Antigravity Getting Started](./docs/antigravity/GETTING-STARTED.md) for detailed instructions and troubleshooting.
 
+### ⚡ Performance Optimization (Recommended)
+
+To ensure the fastest possible startup (critical for IDE-integrated clients like Claude Desktop), we recommend pointing directly to `index.js` using `node` rather than `npx`. This avoids the overhead of checking for package updates.
+
+**Optimized Configuration:**
+
+```json
+{
+  "mcpServers": {
+    "dev-workflow": {
+      "command": "node",
+      "args": ["<PROJECT_ROOT>\\index.js"],
+      "env": {
+        "DEV_WORKFLOW_USER_ID": "your_user_id"
+      }
+    }
+  }
+}
+```
+
+The server automatically times its own startup and logs it to stderr:
+`Dev Workflow MCP Server running on stdio (startup took 15ms)`
+
 ## ⚙️ Configuration
 
 ### Database Setup
@@ -241,6 +296,19 @@ export DEV_WORKFLOW_DB_TYPE=postgres
 export DEV_WORKFLOW_DB_URL="postgresql://user:password@localhost:5432/dev_workflow"
 ```
 
+#### 🛠️ Database Schema Normalization (Postgres/MySQL)
+To ensure compatibility with existing reporting dashboards, the `PostgresAdapter` and `MysqlAdapter` automatically normalize column names:
+- `task_description` → DB column: `description`
+- `timestamp` → DB column: `completed_at`
+
+The adapters use aliases in queries so the MCP tools still receive the expected `task_description` and `timestamp` fields.
+
+#### 👤 User ID Handling (Postgres/MySQL)
+These databases use an `INTEGER` column for `user_id`.
+- **Numeric strings** (e.g., `"1"`) are parsed directly into integers.
+- **Non-numeric strings** (e.g., `"programinglive"`) are automatically hashed into a consistent, positive integer to ensure compatibility with the schema while maintaining unique user isolation.
+
+
 ### User & State Management
 
 | Variable | Description |

package/cloudflared-config.yml

@@ -0,0 +1,3 @@
+url: http://localhost:8080
+tunnel: api-devworkflow
+credentials-file: /home/dhika/.cloudflared/credentials.json

package/db/adapters/postgres.js

@@ -15,11 +15,25 @@ export class PostgresAdapter extends DbAdapter {
         this.pool = null;
     }
 
+    getNumericUserId(userId) {
+        let numericUserId = parseInt(userId, 10);
+        if (isNaN(numericUserId)) {
+            let hash = 0;
+            for (let i = 0; i < userId.length; i++) {
+                hash = (hash << 5) - hash + userId.charCodeAt(i);
+                hash |= 0;
+            }
+            numericUserId = Math.abs(hash);
+        }
+        return numericUserId;
+    }
+
     async connect() {
         if (!this.pool) {
             this.pool = new Pool({
                 connectionString: this.config.connectionUrl,
-                // pg pool handles connections automatically
+                connectionTimeoutMillis: 5000, // 5 second timeout for new connections
+                idleTimeoutMillis: 10000,      // close idle connections after 10 seconds
             });
             await this.migrate();
         }
@@ -31,23 +45,55 @@ export class PostgresAdapter extends DbAdapter {
             await client.query(`
         CREATE TABLE IF NOT EXISTS workflow_history (
           id SERIAL PRIMARY KEY,
-          user_id TEXT NOT NULL,
+          user_id INTEGER NOT NULL,
           project_path TEXT DEFAULT '',
-          task_description TEXT NOT NULL,
+          description TEXT NOT NULL,
           task_type TEXT NOT NULL,
           commit_message TEXT,
-          timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+          completed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
           forced BOOLEAN DEFAULT FALSE,
           force_reason TEXT,
           dropped BOOLEAN DEFAULT FALSE,
           drop_reason TEXT,
-          UNIQUE (user_id, project_path, timestamp, task_description)
+          UNIQUE (user_id, project_path, completed_at, description)
         )
       `);
 
+            // Migration: Add columns to existing table if they don't exist
+            const columns = await client.query(`
+                SELECT column_name FROM information_schema.columns WHERE table_name = 'workflow_history'
+            `);
+            const existingColumns = columns.rows.map(r => r.column_name);
+
+            if (!existingColumns.includes('project_path')) {
+                await client.query('ALTER TABLE workflow_history ADD COLUMN project_path TEXT DEFAULT \'\'');
+            }
+            if (!existingColumns.includes('forced')) {
+                await client.query('ALTER TABLE workflow_history ADD COLUMN forced BOOLEAN DEFAULT FALSE');
+            }
+            if (!existingColumns.includes('force_reason')) {
+                await client.query('ALTER TABLE workflow_history ADD COLUMN force_reason TEXT');
+            }
+            if (!existingColumns.includes('dropped')) {
+                await client.query('ALTER TABLE workflow_history ADD COLUMN dropped BOOLEAN DEFAULT FALSE');
+            }
+            if (!existingColumns.includes('drop_reason')) {
+                await client.query('ALTER TABLE workflow_history ADD COLUMN drop_reason TEXT');
+            }
+            // Ensure completed_at vs timestamp handled if table exists
+            if (!existingColumns.includes('completed_at') && existingColumns.includes('timestamp')) {
+                await client.query('ALTER TABLE workflow_history RENAME COLUMN timestamp TO completed_at');
+            } else if (existingColumns.includes('completed_at') && !existingColumns.includes('timestamp')) {
+                // Keep completed_at
+            }
+            // Logic for description vs task_description
+            if (!existingColumns.includes('description') && existingColumns.includes('task_description')) {
+                await client.query('ALTER TABLE workflow_history RENAME COLUMN task_description TO description');
+            }
+
             await client.query(`
         CREATE TABLE IF NOT EXISTS project_summary (
-          user_id TEXT,
+          user_id INTEGER,
           project_path TEXT DEFAULT '',
           total_tasks INTEGER DEFAULT 0,
           task_types JSONB,
@@ -60,7 +106,7 @@ export class PostgresAdapter extends DbAdapter {
 
             await client.query(`
         CREATE TABLE IF NOT EXISTS workflow_state (
-          user_id TEXT,
+          user_id INTEGER,
           project_path TEXT DEFAULT '',
           state_json JSONB,
           updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
@@ -75,12 +121,13 @@ export class PostgresAdapter extends DbAdapter {
     async insertHistoryEntry(userId, projectPath, entry) {
         await this.connect();
         const normalizedProjectPath = projectPath || '';
+        const numericUserId = this.getNumericUserId(userId);
 
         const query = `
       INSERT INTO workflow_history
-      (user_id, project_path, task_description, task_type, commit_message, timestamp, forced, force_reason, dropped, drop_reason)
+      (user_id, project_path, description, task_type, commit_message, completed_at, forced, force_reason, dropped, drop_reason)
       VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10)
-      ON CONFLICT (user_id, project_path, timestamp, task_description) DO UPDATE SET
+      ON CONFLICT (user_id, project_path, completed_at, description) DO UPDATE SET
         commit_message=EXCLUDED.commit_message,
         forced=EXCLUDED.forced,
         force_reason=EXCLUDED.force_reason,
@@ -89,12 +136,12 @@ export class PostgresAdapter extends DbAdapter {
     `;
 
         await this.pool.query(query, [
-            userId,
+            numericUserId,
             normalizedProjectPath,
-            entry.taskDescription,
+            entry.taskDescription || entry.description,
             entry.taskType,
             entry.commitMessage,
-            entry.timestamp || new Date().toISOString(),
+            entry.timestamp || entry.completed_at || new Date().toISOString(),
             entry.forced || false,
             entry.forceReason || null,
             entry.dropped || false,
@@ -107,14 +154,16 @@ export class PostgresAdapter extends DbAdapter {
     async updateSummaryForUser(userId, projectPath) {
         await this.connect();
         const normalizedProjectPath = projectPath || '';
+        const numericUserId = this.getNumericUserId(userId);
 
         const res = await this.pool.query(`
-      SELECT task_type, timestamp, task_description
+      SELECT task_type, completed_at as timestamp, description as task_description
       FROM workflow_history
       WHERE user_id = $1 AND project_path = $2
-      ORDER BY timestamp DESC
+      ORDER BY completed_at DESC
       LIMIT 20
-    `, [userId, normalizedProjectPath]);
+    `, [numericUserId, normalizedProjectPath]);
+        // ... (lines continue similarly)
 
         const rows = res.rows;
 
@@ -144,7 +193,7 @@ export class PostgresAdapter extends DbAdapter {
     `;
 
         await this.pool.query(upsert, [
-            userId,
+            numericUserId,
             normalizedProjectPath,
             rows.length,
             JSON.stringify(taskTypes),
@@ -157,10 +206,11 @@ export class PostgresAdapter extends DbAdapter {
     async getSummaryForUser(userId, projectPath) {
         await this.connect();
         const normalizedProjectPath = projectPath || '';
+        const numericUserId = this.getNumericUserId(userId);
 
         const res = await this.pool.query(`
       SELECT * FROM project_summary WHERE user_id = $1 AND project_path = $2
-    `, [userId, normalizedProjectPath]);
+    `, [numericUserId, normalizedProjectPath]);
 
         const row = res.rows[0];
         if (!row) return null;
@@ -183,16 +233,18 @@ export class PostgresAdapter extends DbAdapter {
         const sanitizedPageSize = Math.min(100, Math.max(1, Number.isFinite(Number(pageSize)) ? Math.floor(Number(pageSize)) : 20));
         const offset = (sanitizedPage - 1) * sanitizedPageSize;
 
+        const numericUserId = this.getNumericUserId(userId);
+
         const clauses = [];
-        const params = [userId, normalizedProjectPath];
+        const params = [numericUserId, normalizedProjectPath];
         let paramIdx = 3;
 
         if (startDate) {
-            clauses.push(`DATE(timestamp) >= DATE($${paramIdx++})`);
+            clauses.push(`DATE(completed_at) >= DATE($${paramIdx++})`);
             params.push(startDate);
         }
         if (endDate) {
-            clauses.push(`DATE(timestamp) <= DATE($${paramIdx++})`);
+            clauses.push(`DATE(completed_at) <= DATE($${paramIdx++})`);
             params.push(endDate);
         }
 
@@ -205,10 +257,10 @@ export class PostgresAdapter extends DbAdapter {
         const total = parseInt(countRes.rows[0].total, 10);
 
         const entriesRes = await this.pool.query(`
-      SELECT *
+      SELECT *, description as task_description, completed_at as timestamp
       FROM workflow_history
       WHERE ${where}
-      ORDER BY timestamp DESC
+      ORDER BY completed_at DESC
       LIMIT $${paramIdx++}
       OFFSET $${paramIdx++}
     `, [...params, sanitizedPageSize, offset]);
@@ -228,23 +280,25 @@ export class PostgresAdapter extends DbAdapter {
         const { startDate, endDate, frequency = "daily" } = options;
         const format = FREQUENCY_FORMATS[frequency] || FREQUENCY_FORMATS.daily;
 
+        const numericUserId = this.getNumericUserId(userId);
+
         const clauses = [];
-        const params = [userId, normalizedProjectPath];
+        const params = [numericUserId, normalizedProjectPath];
         let paramIdx = 3;
 
         if (startDate) {
-            clauses.push(`DATE(timestamp) >= DATE($${paramIdx++})`);
+            clauses.push(`DATE(completed_at) >= DATE($${paramIdx++})`);
             params.push(startDate);
         }
         if (endDate) {
-            clauses.push(`DATE(timestamp) <= DATE($${paramIdx++})`);
+            clauses.push(`DATE(completed_at) <= DATE($${paramIdx++})`);
             params.push(endDate);
         }
 
         const where = [`user_id = $1`, `project_path = $2`, ...clauses].join(" AND ");
 
         const res = await this.pool.query(`
-      SELECT to_char(timestamp, '${format}') AS period, COUNT(*) AS count
+      SELECT to_char(completed_at, '${format}') AS period, COUNT(*) AS count
       FROM workflow_history
       WHERE ${where}
       GROUP BY period
@@ -267,8 +321,10 @@ export class PostgresAdapter extends DbAdapter {
         updated_at=EXCLUDED.updated_at
     `;
 
+        const numericUserId = this.getNumericUserId(userId);
+
         await this.pool.query(query, [
-            userId,
+            numericUserId,
             normalizedProjectPath,
             JSON.stringify(state),
             new Date().toISOString()
@@ -278,10 +334,11 @@ export class PostgresAdapter extends DbAdapter {
     async getState(userId, projectPath) {
         await this.connect();
         const normalizedProjectPath = projectPath || '';
+        const numericUserId = this.getNumericUserId(userId);
 
         const res = await this.pool.query(`
       SELECT state_json FROM workflow_state WHERE user_id = $1 AND project_path = $2
-    `, [userId, normalizedProjectPath]);
+    `, [numericUserId, normalizedProjectPath]);
 
         const row = res.rows[0];
         if (!row) return null;

package/db/adapters/sqlite.js

@@ -25,9 +25,15 @@ export class SqliteAdapter extends DbAdapter {
         // Otherwise, attempt to find project root relative to CWD
         const initCwd = process.env.INIT_CWD || process.cwd();
         let projectRoot = initCwd;
-        while (projectRoot !== path.dirname(projectRoot)) {
+        let limit = 20; // Prevent infinite loop in weird environments
+        while (projectRoot !== path.dirname(projectRoot) && limit > 0) {
             if (existsSync(path.join(projectRoot, "package.json"))) break;
             projectRoot = path.dirname(projectRoot);
+            limit--;
+        }
+        if (limit === 0) {
+            console.error("Warning: Could not find project root effectively, defaulting to INIT_CWD");
+            projectRoot = initCwd;
         }
         return path.join(projectRoot, ".state", DB_FILENAME);
     }

package/docker-compose.yml

@@ -19,6 +19,23 @@ services:
       timeout: 5s
       retries: 5
 
+  api:
+    build:
+      context: ./web
+      dockerfile: Dockerfile.api
+    container_name: dev-workflow-api
+    ports:
+      - "8080:8080"
+    environment:
+      - DEV_WORKFLOW_DB_URL=${DEV_WORKFLOW_DB_URL}
+      - SESSION_SECRET=${SESSION_SECRET:-dev-workflow-secret-change-in-production}
+      - NODE_ENV=${NODE_ENV:-production}
+      - API_PORT=8080
+    depends_on:
+      postgres:
+        condition: service_healthy
+    restart: unless-stopped
+
 volumes:
   postgres_data:
     driver: local

package/docs/product/PRD.md

@@ -4,7 +4,7 @@
 - **Product**: Development Workflow MCP Server
 - **Prepared by**: Cascade (AI assistant)
 - **Date**: 2025-12-16
-- **Status**: Live v1.7.11
+- **Status**: Live v1.7.15
 
 ## 2. Problem Statement
 Developers need structured guidance to maintain disciplined workflows across projects. Existing tooling lacks enforcement of sequential best practices (testing, documentation, release hygiene) and offers limited visibility into historical task execution.
@@ -67,7 +67,9 @@ Developers need structured guidance to maintain disciplined workflows across pro
 3. **v1.5.0**: Netlify deployment support for static web dashboard (complete).
 4. **v1.6.0+**: Dark/Light mode, UI Improvements (complete).
 5. **Multi-Database Support**: Refactor storage layer to support MySQL and PostgreSQL (complete v1.7.1).
-6. **Future**: Expanded dashboard analytics, customizable workflows, richer integrations.
+7. **v1.7.14 Performance & Resilience**: Implemented connection timeouts and optimized startup sequence for stdio clients (complete).
+8. **v1.7.15 Schema Alignment**: Implemented Postgres/MySQL column normalization and automated integer User ID hashing for cross-dashboard compatibility (complete).
+9. **Future**: Expanded dashboard analytics, customizable workflows, richer integrations.
 
 ## 11. Risks & Mitigations
 - **Risk**: Workflow feels overly prescriptive. **Mitigation**: Provide escape hatches (`force_complete_task`, `drop_task`) with audit trails.

package/docs/release-notes/RELEASE_NOTES.md

@@ -4,6 +4,10 @@ Authoritative history of user-visible changes for the Development Workflow MCP S
 
 | Version | Date | Notes |
 |---------|------|-------|
+| 1.7.16 | 2025-12-24 | align database schema with dashboard and improve user ID handling (69e7f38) |
+| 1.7.15 | 2025-12-19 | optimize startup performance and add database connection resilience (bff2714) |
+| 1.7.14 | 2025-12-19 | add API dependencies and update login to use API client (94bb42f) |
+| 1.7.13 | 2025-12-18 | remote db connection, history api 500 errors, and windows startup (ce559a6) |
 | 1.7.12 | 2025-12-17 | post-release cleanup v1.7.11 (c2ee733) |
 | 1.7.11 | 2025-12-17 | test: comprehensive DB adapter tests, env support, and warning fixes (64b029a) |
 | 1.7.10 | 2025-12-16 | update release notes and finalize ci config (92ac78a) |
@@ -37,6 +41,63 @@ Authoritative history of user-visible changes for the Development Workflow MCP S
 
 
 
+
+
+
+
+## 1.7.16 – 🐛 Bug Fixes
+
+Released on **2025-12-24**.
+
+- align database schema with dashboard and improve user ID handling (69e7f38)
+- cleanup temporary debugging scripts (a5e2b15)
+- sync version to 1.7.15 across web and landing pages (c520e4a)
+- update macOS MCP config instructions (1e368da)
+
+## 1.7.15 – 🐛 Bug Fixes
+
+Released on **2025-12-19**.
+
+- optimize startup performance and add database connection resilience (bff2714)
+- refactor Navbar and History to use absolute API client URLs v1.7.18 (dc33eae)
+- sync all version labels to 1.7.14 and improve netlify routing (78712eb)
+- sync all version strings to 1.7.14 (e2a1795)
+- sync version to 1.7.14 and fix static routing via trailingSlash (1c152bd)
+
+## 1.7.14 – ✨ Features
+
+Released on **2025-12-19**.
+
+- add API dependencies and update login to use API client (94bb42f)
+- add REST API server for frontend database access (cdb347c)
+- implement JWT authentication and update client (8efbe80)
+- remove session cookies, enforce JWT only (bacd83a)
+- add credentials:include to getCurrentUser to persist session (b8f2df5)
+- add root netlify.toml for monorepo support (54c5ed3)
+- enable trust proxy and force secure cookies for cross-domain session (2c5d6e8)
+- ensure getMe uses full API URL (b3bd0da)
+- force API URL to tunnel address to resolve cached old IP (1883731)
+- inline auth functions in API server (eefd73c)
+- remove duplicate variable declarations in API server (31d3621)
+- remove dynamic API route for static export (05a4dd0)
+- remove explicit publish path to fix netlify build (cd64bcf)
+- remove incorrect netlify publish dir for dynamic build (ea34cf4)
+- remove incorrect publish dir from netlify config (010236f)
+- restore static export for netlify deployment (685d841)
+- update API URL to use Cloudflare Tunnel for HTTPS (ab72f6c)
+- use apiClient in history page and add version indicator (4889669)
+- use npm install instead of ci to avoid lockfile issues (e5fae26)
+- bump version to 1.7.14 to ensure fresh build (f7d8886)
+- bump version to 1.7.15 for JWT frontend deploy (7850268)
+- cleanup post-release and update website version to 1.7.13 (7341d44)
+- save pending changes before release (4d4b1c9)
+
+## 1.7.13 – 🐛 Bug Fixes
+
+Released on **2025-12-18**.
+
+- remote db connection, history api 500 errors, and windows startup (ce559a6)
+
 ## 1.7.12 – 📝 Documentation
 
 Released on **2025-12-17**.

package/index.js

@@ -191,20 +191,30 @@ Use 'check_ready_to_commit' to verify workflow completion.
 
 // Start server
 export async function main() {
+  const startTime = Date.now();
+  console.error(`[${new Date().toISOString()}] MCP Server starting...`);
+
   try {
     // Initialize workflow state
     workflowState = new WorkflowState();
+    console.error(`[${new Date().toISOString()}] Loading workflow state...`);
     await workflowState.load();
+    console.error(`[${new Date().toISOString()}] Workflow state loaded.`);
+
+    console.error(`[${new Date().toISOString()}] Ensuring primary file...`);
     await workflowState.ensurePrimaryFile();
+    console.error(`[${new Date().toISOString()}] Workflow state initialization complete.`);
   } catch (error) {
-    console.error("Warning: Failed to initialize workflow state:", error.message);
+    console.error(`[${new Date().toISOString()}] Warning: Failed to initialize workflow state:`, error.message);
     // Continue anyway - workflow state is optional for MCP to function
     workflowState = new WorkflowState();
   }
 
   const transport = new StdioServerTransport();
+  console.error(`[${new Date().toISOString()}] Connecting transport...`);
   await server.connect(transport);
-  console.error("Dev Workflow MCP Server running on stdio");
+  const duration = Date.now() - startTime;
+  console.error(`[${new Date().toISOString()}] Dev Workflow MCP Server running on stdio (startup took ${duration}ms)`);
 }
 
 // --- Lightweight CLI: dev-workflow-mcp call <toolName> [--args '<json>'] ---

package/netlify.toml

@@ -0,0 +1,7 @@
+[build]
+  base = "web"
+  command = "npm run build"
+  # publish = ".next" (Removed to allow auto-detection)
+
+[[plugins]]
+  package = "@netlify/plugin-nextjs"

package/nginx-api.conf

@@ -0,0 +1,27 @@
+server {
+    listen 80;
+    server_name api.devworkflow.programinglive.com;
+
+    location / {
+        proxy_pass http://localhost:8080;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection 'upgrade';
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        proxy_cache_bypass $http_upgrade;
+        
+        # CORS headers (backup in case API doesn't set them)
+        add_header 'Access-Control-Allow-Origin' 'https://devworkflow.programinglive.com' always;
+        add_header 'Access-Control-Allow-Credentials' 'true' always;
+        add_header 'Access-Control-Allow-Methods' 'GET, POST, PUT, DELETE, OPTIONS' always;
+        add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization' always;
+        
+        # Handle preflight requests
+        if ($request_method = 'OPTIONS') {
+            return 204;
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@programinglive/dev-workflow-mcp-server",
-  "version": "1.7.13",
+  "version": "1.7.16",
   "description": "MCP server to enforce development workflow discipline",
   "homepage": "https://devworkflow.programinglive.com/",
   "mcpName": "io.github.programinglive/dev-workflow-mcp-server",