mlgym-deploy 3.3.43 → 3.3.44

package/README.md

@@ -60,7 +60,7 @@ cp ADD_TO_CURSOR_SETTINGS.json.example ADD_TO_CURSOR_SETTINGS.json
   "mcpServers": {
     "gitlab-backend": {
       "command": "node",
-      "args": ["/your/absolute/path/to/gitlab_backend/mcp-server/index.js"],
+      "args": ["/your/absolute/path/to/mcp-server/index.js"],
       "env": {
         "GITLAB_BACKEND_URL": "https://backend.eu.ezb.net",
         "GITLAB_URL": "https://git.mlgym.io",

package/docs/NPM_RELEASE.md

@@ -0,0 +1,230 @@
+# NPM Release Procedure
+
+This document describes how to publish the `mlgym-deploy` MCP server package to npm.
+
+## Prerequisites
+
+- npm account with publish access to `mlgym-deploy` package
+- npm access token (preferred method)
+- Package version must be incremented before publishing
+
+## Authentication Methods
+
+### Method 1: Access Token (Recommended) ✅
+
+Using an access token is **preferred** because:
+- ✅ No 2FA/OTP required during publish
+- ✅ Faster and more automated
+- ✅ Works in CI/CD pipelines
+- ✅ Can be revoked/rotated easily
+- ✅ Suitable for scripted deployments
+
+#### Setup Access Token
+
+1. **Configure token locally:**
+   ```bash
+   npm config set //registry.npmjs.org/:_authToken <YOUR_TOKEN>
+   ```
+
+2. **Verify authentication:**
+   ```bash
+   npm whoami
+   # Should output: chka_s5
+   ```
+
+3. **Publish:**
+   ```bash
+   cd mcp-server
+   npm publish
+   ```
+
+### Method 2: OTP/2FA (Alternative)
+
+If you don't have an access token, you can use 2FA:
+
+```bash
+npm publish --otp=<6-DIGIT-CODE>
+```
+
+**Downsides:**
+- Requires manual 2FA code entry each time
+- Codes expire quickly (30 seconds)
+- Not suitable for automation
+- Slower workflow
+
+## Release Workflow
+
+### Step 1: Increment Version
+
+Edit `mcp-server/package.json` and `mcp-server/index.js`:
+
+```json
+{
+  "version": "3.3.44"
+}
+```
+
+```javascript
+const CURRENT_VERSION = '3.3.44';  // Update with change description
+```
+
+### Step 2: Update CHANGELOG (if exists)
+
+Document what changed in this release.
+
+### Step 3: Commit Changes
+
+```bash
+git add mcp-server/package.json mcp-server/index.js
+git commit -m "Bump version to 3.3.44
+
+- Description of changes
+- What was fixed/added/improved"
+```
+
+### Step 4: Publish to npm
+
+**Using Access Token (Recommended):**
+
+```bash
+cd mcp-server
+npm publish
+```
+
+**Using OTP:**
+
+```bash
+cd mcp-server
+npm publish --otp=123456
+```
+
+### Step 5: Verify Publication
+
+```bash
+# Check latest version
+npm view mlgym-deploy version
+
+# Check publication time
+npm view mlgym-deploy time.modified
+
+# Test installation
+npm install -g mlgym-deploy@latest
+mlgym-mcp --help
+```
+
+### Step 6: Tag Release (Optional)
+
+```bash
+git tag -a v3.3.44 -m "Release v3.3.44"
+git push origin v3.3.44
+```
+
+## NPM Access Token Management
+
+### Current Token
+
+**Token:** `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`
+**User:** chka_s5
+**Scope:** Publish access to mlgym-deploy
+
+### Token Storage
+
+**Local config (recommended for development):**
+```bash
+npm config set //registry.npmjs.org/:_authToken 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
+```
+
+**Per-project .npmrc (not recommended - security risk):**
+```
+//registry.npmjs.org/:_authToken=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
+```
+⚠️ **Never commit .npmrc with tokens to git!**
+
+**Environment variable (good for CI/CD):**
+```bash
+export NPM_TOKEN=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
+echo "//registry.npmjs.org/:_authToken=${NPM_TOKEN}" > ~/.npmrc
+```
+
+### Revoking a Token
+
+If token is compromised:
+
+1. Login to npmjs.com
+2. Go to Account Settings → Access Tokens
+3. Find the token and click "Delete"
+4. Generate a new token
+5. Update local config with new token
+
+## Common Issues
+
+### Issue: "npm ERR! code E404"
+
+**Cause:** Package name doesn't exist or you don't have access
+**Solution:** Verify package name and permissions
+
+### Issue: "npm ERR! code EOTP"
+
+**Cause:** 2FA required but not provided
+**Solution:** Use access token method instead of OTP
+
+### Issue: "npm ERR! 403 Forbidden"
+
+**Cause:** Invalid or expired token
+**Solution:** Regenerate access token
+
+### Issue: "Version already exists"
+
+**Cause:** Version number in package.json hasn't been incremented
+**Solution:** Bump version before publishing
+
+### Issue: "npm auto-corrected some errors"
+
+**Cause:** package.json formatting issues
+**Solution:** Run `npm pkg fix` and commit the changes
+
+## Automated CI/CD Publishing
+
+For GitLab CI/CD pipeline:
+
+```yaml
+publish_npm:
+  stage: publish
+  only:
+    - tags
+  script:
+    - cd mcp-server
+    - echo "//registry.npmjs.org/:_authToken=${NPM_TOKEN}" > ~/.npmrc
+    - npm publish
+  variables:
+    NPM_TOKEN: $NPM_TOKEN  # Set in GitLab CI/CD variables
+```
+
+## Version History
+
+| Version | Date | SDK Version | Notable Changes |
+|---------|------|-------------|-----------------|
+| 3.3.43  | 2026-01-22 | 1.25.3 | SDK security upgrade, contact info |
+| 3.3.42  | 2025-XX-XX | 0.6.1  | deploy_dollie tool |
+| 3.0.0   | 2024-XX-XX | 0.6.0  | Monolithic workflows |
+
+## Quick Reference
+
+```bash
+# Configure token (one-time setup)
+npm config set //registry.npmjs.org/:_authToken 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
+
+# Verify auth
+npm whoami
+
+# Publish
+cd mcp-server && npm publish
+
+# Verify publication
+npm view mlgym-deploy version
+```
+
+---
+
+**Last Updated:** 2026-01-22
+**Maintainer:** chka_s5 (operations@stratus5.com)

package/index.js

@@ -18,7 +18,7 @@ import crypto from 'crypto';
 const execAsync = promisify(exec);
 
 // Current version of this MCP server - INCREMENT FOR WORKFLOW FIXES
-const CURRENT_VERSION = '3.3.43';  // Add embedded contact info (operations@stratus5.com) and hide infrastructure URLs from help
+const CURRENT_VERSION = '3.3.44';  // Update README with installation and configuration instructions
 const PACKAGE_NAME = 'mlgym-deploy';
 
 // Debug logging configuration - ENABLED BY DEFAULT

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "mlgym-deploy",
-  "version": "3.3.43",
+  "version": "3.3.44",
   "description": "MCP server for MLGym - Complete deployment management: deploy, configure, monitor, and rollback applications",
   "main": "index.js",
   "type": "module",
   "bin": {
-    "mlgym-mcp": "./index.js"
+    "mlgym-mcp": "index.js"
   },
   "scripts": {
     "start": "node index.js"