chore: update version to 0.4.0 in package.json and enhance changelog with new features and fixes

Author: Thavarshan

CHANGELOG.md

@@ -7,28 +7,63 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+---
+
+## [0.4.0] - 2025-09-14
+
 ### Added
 
-- JSDoc docblocks and inline comments for the migrations CLI (`src/cli/index.ts`) to improve developer understanding of flags, commands, and edge cases. This change is documentation-only and does not modify runtime behavior.
+#### **Node-based CLI System**
+
+- **Migration CLI** - Complete Node.js-based CLI for database migrations with comprehensive command support
+- **CLI Integration Tests** - Full test coverage for CLI commands and migration workflows
+- **Developer-friendly CLI** - Enhanced CLI with better error handling and user feedback
+
+#### **Heroku Deployment Support**
+
+- **Heroku Configuration** - Complete Heroku deployment support with environment variables and scripts
+- **Database Connection Utilities** - Enhanced database connection handling for cloud environments
+- **Production Optimizations** - Database configuration and logging setup optimized for production
 
-### Quality
+#### **Authentication System Enhancements**
 
-- Verified TypeScript typecheck, ESLint linting, and Prettier formatting after the documentation updates (`npm run check`).
+- **JWT Authentication** - Enhanced JWT-based authentication for analytics and database management routes
+- **Authentication Migration** - Updated authentication mechanism from API key to JWT for specific routes
+- **CORS Configuration** - Enhanced CORS configuration with updated allowed origins for development
+
+#### **Development Experience Improvements**
+
+- **JSON Error Handling** - Enhanced JSON parsing and error handling for invalid JSON requests
+- **Repository Guidelines** - Added comprehensive repository guidelines document
+- **Environment Variable Testing** - Comprehensive tests for environment variable validation and error handling
+- **Error Handling Tests** - Extensive error handling tests across config, analytics, database, AI service, and logger utilities
+
+### Fixed
+
+- **Database Integration Tests** - Resolved database integration test failures
+- **Password Field Consistency** - Updated password field handling in database queries and integration tests
+- **README Corrections** - Fixed repository links to point to correct API repository
+- **CI Workflow** - Updated CI workflow for unit tests and corrected performance test commands
+- **Dependency Management** - Fixed prepare script to handle missing husky installation and restored uuid dependency
+- **Release Commands** - Updated release command to run migration status instead of build
+- **SQL Query Optimization** - Updated SQL query in AnalyticsController to remove DISTINCT and group by query_text
 
 ### Changed
 
-- README: corrected repository path (`cd core`), prefer `npm ci`, and updated required npm version to 10+
-- README: standardized migration CLI usage to `./bin/altus` (deprecated `./bin/migrate` references removed)
-- README: fixed health checks section (removed non-existent `/health/db` and `/health/redis` endpoints; pointed to `/health`)
-- README: adjusted Docker notes to clarify no app Dockerfile is present; recommend `npm run dev:start|stop|reset` for local MySQL/Redis
-- README: updated link to CLI docs (`docs/cli.md`)
-- README: updated health response example version to `0.3.0`
-- Package metadata: set `license` to `Apache-2.0` to match LICENSE file
-- README: corrected authentication columns for `/api/v1/keys/*` and `/api/v1/databases/*` (require JWT for management endpoints)
+#### **Code Quality & Refactoring**
+
+- **Response Status Codes** - Refactored response status codes to use centralized constants
+- **Logging Improvements** - Updated logging messages and improved readability across scripts
+- **Connection Status Updates** - Enhanced connection status handling and fallback search logging
+- **Migration Scripts** - Added migration scripts to adjust API keys key_prefix column length
 
-### Housekeeping
+#### **Documentation & Metadata**
 
-- Relabeled the later `0.3.0` entry as `0.3.1` to resolve duplication.
+- **Version Updates** - Updated version number to 0.3.0 in middleware and routes
+- **Project Title** - Updated project title in README to include API reference
+- **CODEOWNERS** - Updated CODEOWNERS to assign ownership to @Thavarshan
+- **License** - Changed license to Apache-2.0 in package.json to match LICENSE file
+- **Documentation Exclusions** - Added 'docs/' to .gitignore to exclude documentation build outputs
 
 ---
 

README.md

@@ -430,7 +430,7 @@ Expected response:
 {
   "status": "healthy",
   "timestamp": "2024-01-15T10:30:00.000Z",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "uptime": 1234.567
 }
 ```

bin/test/README.md

@@ -353,7 +353,7 @@ The script includes security-focused tests:
 
 The script is designed to work with:
 
-- **Altus 4 v0.3.0+** - Current version support
+- **Altus 4 v0.4.0+** - Current version support
 - **OpenAPI 3.0.3** - Specification format
 - **Node.js 20+** - Runtime compatibility
 - **MySQL 8.0+** - Database compatibility

openapi/altus4.openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: Altus4 Core API
-  version: 0.3.0
+  version: 0.4.0
   description: |
     Complete API specification for Altus4 - AI-Enhanced MySQL Full-Text Search Engine.
 
@@ -475,7 +475,7 @@ paths:
                     format: date-time
                   version:
                     type: string
-                    example: '0.3.0'
+                    example: '0.4.0'
                   uptime:
                     type: number
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@altus4/core",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "AI-Enhanced MySQL Full-Text Search Engine",
   "main": "dist/src/index.js",
   "bin": {

src/controllers/ApiKeyController.test.ts

@@ -149,7 +149,7 @@ describe('ApiKeyController', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'unknown',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -263,7 +263,7 @@ describe('ApiKeyController', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'unknown',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -357,7 +357,7 @@ describe('ApiKeyController', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'unknown',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -456,7 +456,7 @@ describe('ApiKeyController', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'unknown',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -584,7 +584,7 @@ describe('ApiKeyController', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'unknown',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -674,7 +674,7 @@ describe('ApiKeyController', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'unknown',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });

src/middleware/errorHandler.test.ts

@@ -115,7 +115,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'test-request-id',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -137,7 +137,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'test-request-id',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -162,7 +162,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'test-request-id',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -187,7 +187,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'test-request-id',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -212,7 +212,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'test-request-id',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -235,7 +235,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'test-request-id',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -259,7 +259,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'test-request-id',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -281,7 +281,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'test-request-id',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -305,7 +305,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'test-request-id',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -327,7 +327,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'test-request-id',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -356,7 +356,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'test-request-id',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -380,7 +380,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'test-request-id',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -459,7 +459,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'test-request-id',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -476,7 +476,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'unknown',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -514,7 +514,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'test-request-id',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
 
@@ -540,7 +540,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'test-request-id',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
 
@@ -566,7 +566,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'test-request-id',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
 
@@ -595,7 +595,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'test-request-id',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
 
@@ -626,7 +626,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'test-request-id',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -650,7 +650,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'test-request-id',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -672,7 +672,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'unknown',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -715,7 +715,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'test-request-id',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });
@@ -740,7 +740,7 @@ describe('Error Handler Middleware', () => {
         meta: {
           timestamp: expect.any(Date),
           requestId: 'test-request-id',
-          version: '0.3.0',
+          version: '0.4.0',
         },
       });
     });

src/middleware/errorHandler.ts

@@ -63,7 +63,7 @@ export const errorHandler = (
       meta: {
         timestamp: new Date(),
         requestId: req.get('X-Request-ID') || 'unknown',
-        version: process.env.npm_package_version || '0.3.0',
+        version: process.env.npm_package_version || '0.4.0',
       },
     };
 
@@ -140,7 +140,7 @@ export const errorHandler = (
     meta: {
       timestamp: new Date(),
       requestId: req.get('X-Request-ID') || 'unknown',
-      version: process.env.npm_package_version || '0.3.0',
+      version: process.env.npm_package_version || '0.4.0',
     },
   };