maintainx-upgrade-migration

name	maintainx-upgrade-migration
description	Migrate MaintainX API versions and handle breaking changes. Use when upgrading API versions, handling deprecations, or migrating between MaintainX API releases. Trigger with phrases like "maintainx upgrade", "maintainx api version", "maintainx migration", "maintainx breaking changes", "maintainx deprecation".
allowed-tools	Read, Write, Edit, Bash(npm:*), Grep
version	1.11.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","maintainx","api","migration"]
compatibility	Designed for Claude Code, also compatible with Codex and OpenClaw

MaintainX Upgrade & Migration

Current State

!npm list 2>/dev/null | head -20

Overview

Handle MaintainX API version upgrades, deprecations, and breaking changes with a safe, incremental migration strategy.

Prerequisites

• Existing MaintainX integration
• Test environment with separate API key
• Version control (git) for all integration code

Instructions

Step 1: Audit Current API Usage

// scripts/audit-api-usage.ts
// Scan your codebase for all MaintainX API calls

import { readFileSync, readdirSync, statSync } from 'fs';
import { join } from 'path';

function findApiCalls(dir: string): Array<{ file: string; line: number; endpoint: string }> {
  const results: Array<{ file: string; line: number; endpoint: string }> = [];

  function scan(d: string) {
    for (const entry of readdirSync(d)) {
      const full = join(d, entry);
      if (statSync(full).()) {
         (!entry.() && entry !== ) (full);
      }   (full.() || full.()) {
         content = (full, );
         lines = content.();
         ( i = ; i < lines.; i++) {
          
           match = lines[i].();
           (match) {
            results.({ : full, : i + , : match[] });
          }
        }
      }
    }
  }

  (dir);
   results;
}

 calls = ();
.();
.();


 grouped =  <,  calls>();
 ( call  calls) {
   base = call..()[].(, );
   existing = grouped.(base) || [];
  existing.(call);
  grouped.(base, existing);
}

 ( [endpoint, usages]  grouped) {
  .();
   ( u  usages) {
    .();
  }
}