[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6F84X9137P1T5G4XFC4WKSP":3,"skill-same:01M6F84X9137P1T5G4XFC4WKSP":72},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":40,"linkOnly":41,"markdownContent":42,"markdownBody":43,"frontMatter":44,"refName":49,"commitSha":50,"skillDirectory":51,"forksCount":52,"repositoryHtmlUrl":53,"repositoryHomepageUrl":6,"ownerHtmlUrl":54,"ownerBlogUrl":55,"ownerDescription":56,"updatedAt":57,"install":58,"resources":71},"01M6F84X9137P1T5G4XFC4WKSP","maintainx-upgrade-migration",null,"Migrate MaintainX API versions and handle breaking changes.\nUse when upgrading API versions, handling deprecations,\nor migrating between MaintainX API releases.\nTrigger with phrases like \"maintainx upgrade\", \"maintainx api version\",\n\"maintainx migration\", \"maintainx breaking changes\", \"maintainx deprecation\".","Dicklesworthstone\u002Fpi_agent_rust","Dicklesworthstone","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F35050222?v=4","01M6CG26AR942CSVMN1M5E3DSE","Jeff Emanuel","01M6CG26EPP71PSHW1VDS71121",1992,"MIT","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fmaintainx-pack\u002Fskills\u002Fmaintainx-upgrade-migration\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39],"maintainx upgrade migration","upgrade","migration","when","npm","api version","deprecation","changes","with","trigger","io","releases","version","use","edit","write","read","grep","migrate","Bash","api","2026-11-10 10:12:30",false,"---\nname: maintainx-upgrade-migration\ndescription: |\n  Migrate MaintainX API versions and handle breaking changes.\n  Use when upgrading API versions, handling deprecations,\n  or migrating between MaintainX API releases.\n  Trigger with phrases like \"maintainx upgrade\", \"maintainx api version\",\n  \"maintainx migration\", \"maintainx breaking changes\", \"maintainx deprecation\".\nallowed-tools: Read, Write, Edit, Bash(npm:*), Grep\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\n---\n\n# MaintainX Upgrade & Migration\n\n## Overview\n\nGuide for handling MaintainX API version upgrades, deprecations, and breaking changes in your integrations.\n\n## Prerequisites\n\n- Existing MaintainX integration\n- Understanding of current API usage\n- Test environment available\n\n## Migration Planning\n\n### Step 1: Assess Current Usage\n\n```typescript\n\u002F\u002F scripts\u002Fanalyze-api-usage.ts\n\ninterface ApiUsageReport {\n  endpoints: Map\u003Cstring, number>;\n  methods: Map\u003Cstring, number>;\n  fields: Map\u003Cstring, Set\u003Cstring>>;\n  deprecations: string[];\n}\n\nasync function analyzeApiUsage(logFile: string): Promise\u003CApiUsageReport> {\n  const fs = require('fs');\n  const logs = JSON.parse(fs.readFileSync(logFile, 'utf8'));\n\n  const report: ApiUsageReport = {\n    endpoints: new Map(),\n    methods: new Map(),\n    fields: new Map(),\n    deprecations: [],\n  };\n\n  logs.forEach((log: any) => {\n    \u002F\u002F Count endpoint usage\n    const endpoint = log.url?.replace(\u002F\\\u002F[a-z0-9_-]+$\u002Fi, '\u002F:id');\n    if (endpoint) {\n      report.endpoints.set(endpoint, (report.endpoints.get(endpoint) || 0) + 1);\n    }\n\n    \u002F\u002F Count HTTP methods\n    if (log.method) {\n      report.methods.set(log.method, (report.methods.get(log.method) || 0) + 1);\n    }\n\n    \u002F\u002F Track fields used in requests\n    if (log.requestBody) {\n      const fields = Object.keys(log.requestBody);\n      const endpointFields = report.fields.get(endpoint) || new Set();\n      fields.forEach(f => endpointFields.add(f));\n      report.fields.set(endpoint, endpointFields);\n    }\n\n    \u002F\u002F Check for deprecation warnings\n    if (log.responseHeaders?.['x-deprecation-warning']) {\n      report.deprecations.push(log.responseHeaders['x-deprecation-warning']);\n    }\n  });\n\n  return report;\n}\n\n\u002F\u002F Print report\nasync function printUsageReport() {\n  const report = await analyzeApiUsage('.\u002Flogs\u002Fapi-requests.json');\n\n  console.log('=== MaintainX API Usage Analysis ===\\n');\n\n  console.log('Endpoints Used:');\n  report.endpoints.forEach((count, endpoint) => {\n    console.log(`  ${endpoint}: ${count} calls`);\n  });\n\n  console.log('\\nHTTP Methods:');\n  report.methods.forEach((count, method) => {\n    console.log(`  ${method}: ${count} calls`);\n  });\n\n  console.log('\\nFields by Endpoint:');\n  report.fields.forEach((fields, endpoint) => {\n    console.log(`  ${endpoint}: ${[...fields].join(', ')}`);\n  });\n\n  if (report.deprecations.length > 0) {\n    console.log('\\nDeprecation Warnings:');\n    [...new Set(report.deprecations)].forEach(d => {\n      console.log(`  - ${d}`);\n    });\n  }\n}\n```\n\n### Step 2: Version Compatibility Layer\n\n```typescript\n\u002F\u002F src\u002Fapi\u002Fversion-adapter.ts\n\n\u002F\u002F API version types\ntype ApiVersion = 'v1' | 'v2';\n\ninterface VersionAdapter {\n  transformRequest(data: any): any;\n  transformResponse(data: any): any;\n  getBaseUrl(): string;\n}\n\n\u002F\u002F V1 Adapter (current)\nclass V1Adapter implements VersionAdapter {\n  getBaseUrl(): string {\n    return 'https:\u002F\u002Fapi.getmaintainx.com\u002Fv1';\n  }\n\n  transformRequest(data: any): any {\n    return data;  \u002F\u002F No transformation needed for current version\n  }\n\n  transformResponse(data: any): any {\n    return data;\n  }\n}\n\n\u002F\u002F V2 Adapter (future\u002Fhypothetical)\nclass V2Adapter implements VersionAdapter {\n  getBaseUrl(): string {\n    return 'https:\u002F\u002Fapi.getmaintainx.com\u002Fv2';\n  }\n\n  transformRequest(data: any): any {\n    \u002F\u002F Transform V1 request format to V2\n    const transformed = { ...data };\n\n    \u002F\u002F Example: V2 might rename 'assignees' to 'assigned_users'\n    if (transformed.assignees) {\n      transformed.assigned_users = transformed.assignees;\n      delete transformed.assignees;\n    }\n\n    \u002F\u002F Example: V2 might use different priority values\n    if (transformed.priority) {\n      const priorityMap: Record\u003Cstring, string> = {\n        'NONE': 'P4',\n        'LOW': 'P3',\n        'MEDIUM': 'P2',\n        'HIGH': 'P1',\n      };\n      transformed.priority = priorityMap[transformed.priority] || transformed.priority;\n    }\n\n    return transformed;\n  }\n\n  transformResponse(data: any): any {\n    \u002F\u002F Transform V2 response format to V1 for backward compatibility\n    const transformed = { ...data };\n\n    \u002F\u002F Reverse the transformations\n    if (transformed.assigned_users) {\n      transformed.assignees = transformed.assigned_users;\n      delete transformed.assigned_users;\n    }\n\n    if (transformed.priority) {\n      const priorityMap: Record\u003Cstring, string> = {\n        'P4': 'NONE',\n        'P3': 'LOW',\n        'P2': 'MEDIUM',\n        'P1': 'HIGH',\n      };\n      transformed.priority = priorityMap[transformed.priority] || transformed.priority;\n    }\n\n    return transformed;\n  }\n}\n\n\u002F\u002F Factory\nfunction createAdapter(version: ApiVersion): VersionAdapter {\n  switch (version) {\n    case 'v2':\n      return new V2Adapter();\n    case 'v1':\n    default:\n      return new V1Adapter();\n  }\n}\n\n\u002F\u002F Version-aware client\nclass VersionedMaintainXClient {\n  private adapter: VersionAdapter;\n  private client: AxiosInstance;\n\n  constructor(version: ApiVersion = 'v1') {\n    this.adapter = createAdapter(version);\n    this.client = axios.create({\n      baseURL: this.adapter.getBaseUrl(),\n      headers: {\n        'Authorization': `Bearer ${process.env.MAINTAINX_API_KEY}`,\n        'Content-Type': 'application\u002Fjson',\n      },\n    });\n  }\n\n  async createWorkOrder(data: any) {\n    const transformedRequest = this.adapter.transformRequest(data);\n    const response = await this.client.post('\u002Fworkorders', transformedRequest);\n    return this.adapter.transformResponse(response.data);\n  }\n}\n```\n\n### Step 3: Feature Flag for Gradual Migration\n\n```typescript\n\u002F\u002F src\u002Fconfig\u002Ffeature-flags.ts\n\ninterface FeatureFlags {\n  useV2Api: boolean;\n  useNewWorkOrderFormat: boolean;\n  enableBetaFeatures: boolean;\n}\n\nfunction getFeatureFlags(): FeatureFlags {\n  return {\n    useV2Api: process.env.USE_V2_API === 'true',\n    useNewWorkOrderFormat: process.env.USE_NEW_WO_FORMAT === 'true',\n    enableBetaFeatures: process.env.ENABLE_BETA === 'true',\n  };\n}\n\n\u002F\u002F Feature-flagged API client\nclass MigratableMaintainXClient {\n  private v1Client: MaintainXClient;\n  private v2Client?: MaintainXClient;\n  private flags: FeatureFlags;\n\n  constructor() {\n    this.flags = getFeatureFlags();\n    this.v1Client = new MaintainXClient();\n\n    if (this.flags.useV2Api) {\n      \u002F\u002F Initialize V2 client when ready\n      \u002F\u002F this.v2Client = new MaintainXClientV2();\n    }\n  }\n\n  async createWorkOrder(data: any) {\n    if (this.flags.useV2Api && this.v2Client) {\n      return this.v2Client.createWorkOrder(data);\n    }\n    return this.v1Client.createWorkOrder(data);\n  }\n}\n```\n\n### Step 4: Migration Testing\n\n```typescript\n\u002F\u002F tests\u002Fmigration.test.ts\n\ndescribe('API Migration Tests', () => {\n  describe('Request Transformation', () => {\n    it('should transform V1 work order to V2 format', () => {\n      const v1Data = {\n        title: 'Test Work Order',\n        priority: 'HIGH',\n        assignees: ['user1', 'user2'],\n      };\n\n      const adapter = new V2Adapter();\n      const v2Data = adapter.transformRequest(v1Data);\n\n      expect(v2Data.title).toBe('Test Work Order');\n      expect(v2Data.priority).toBe('P1');\n      expect(v2Data.assigned_users).toEqual(['user1', 'user2']);\n      expect(v2Data.assignees).toBeUndefined();\n    });\n  });\n\n  describe('Response Transformation', () => {\n    it('should transform V2 response to V1 format', () => {\n      const v2Response = {\n        id: 'wo_123',\n        title: 'Test',\n        priority: 'P1',\n        assigned_users: ['user1'],\n      };\n\n      const adapter = new V2Adapter();\n      const v1Response = adapter.transformResponse(v2Response);\n\n      expect(v1Response.priority).toBe('HIGH');\n      expect(v1Response.assignees).toEqual(['user1']);\n      expect(v1Response.assigned_users).toBeUndefined();\n    });\n  });\n\n  describe('Parallel API Calls', () => {\n    it('should return same results from both API versions', async () => {\n      const v1Client = new VersionedMaintainXClient('v1');\n      \u002F\u002F const v2Client = new VersionedMaintainXClient('v2');\n\n      const v1WorkOrders = await v1Client.getWorkOrders({ limit: 10 });\n      \u002F\u002F const v2WorkOrders = await v2Client.getWorkOrders({ limit: 10 });\n\n      \u002F\u002F Compare results (accounting for transformations)\n      \u002F\u002F expect(v1WorkOrders.length).toBe(v2WorkOrders.length);\n    });\n  });\n});\n```\n\n### Step 5: Rollback Plan\n\n```typescript\n\u002F\u002F scripts\u002Frollback.ts\n\ninterface RollbackStep {\n  name: string;\n  execute: () => Promise\u003Cvoid>;\n}\n\nconst rollbackSteps: RollbackStep[] = [\n  {\n    name: 'Disable V2 API flag',\n    execute: async () => {\n      \u002F\u002F Update feature flag\n      console.log('Setting USE_V2_API=false');\n      \u002F\u002F In practice, update your feature flag service\n    },\n  },\n  {\n    name: 'Restart services',\n    execute: async () => {\n      console.log('Restarting services to pick up flag change');\n      \u002F\u002F kubectl rollout restart deployment\u002Fyour-app\n    },\n  },\n  {\n    name: 'Verify V1 API usage',\n    execute: async () => {\n      console.log('Verifying API calls are using V1');\n      \u002F\u002F Check logs for API version\n    },\n  },\n  {\n    name: 'Monitor for errors',\n    execute: async () => {\n      console.log('Monitoring error rates...');\n      \u002F\u002F Check monitoring dashboards\n    },\n  },\n];\n\nasync function executeRollback() {\n  console.log('=== Executing API Rollback ===\\n');\n\n  for (const step of rollbackSteps) {\n    console.log(`Executing: ${step.name}`);\n    try {\n      await step.execute();\n      console.log(`  [DONE]\\n`);\n    } catch (error: any) {\n      console.error(`  [FAILED] ${error.message}`);\n      console.error('Rollback halted. Manual intervention required.');\n      process.exit(1);\n    }\n  }\n\n  console.log('=== Rollback Complete ===');\n}\n```\n\n## Migration Checklist\n\n- [ ] Analyzed current API usage\n- [ ] Identified deprecated features\n- [ ] Created version adapter layer\n- [ ] Set up feature flags\n- [ ] Written migration tests\n- [ ] Documented rollback procedure\n- [ ] Tested in staging environment\n- [ ] Communicated timeline to stakeholders\n- [ ] Scheduled maintenance window\n- [ ] Prepared monitoring dashboards\n\n## Output\n\n- API usage analysis report\n- Version compatibility layer\n- Feature flag configuration\n- Migration tests passing\n- Rollback procedure documented\n\n## Resources\n\n- [MaintainX API Documentation](https:\u002F\u002Fmaintainx.dev\u002F)\n- [MaintainX Changelog](https:\u002F\u002Fmaintainx.dev\u002Fchangelog)\n- [Strangler Fig Pattern](https:\u002F\u002Fmartinfowler.com\u002Fbliki\u002FStranglerFigApplication.html)\n\n## Next Steps\n\nFor CI\u002FCD integration, see `maintainx-ci-integration`.\n","# MaintainX Upgrade & Migration\n\n## Overview\n\nGuide for handling MaintainX API version upgrades, deprecations, and breaking changes in your integrations.\n\n## Prerequisites\n\n- Existing MaintainX integration\n- Understanding of current API usage\n- Test environment available\n\n## Migration Planning\n\n### Step 1: Assess Current Usage\n\n```typescript\n\u002F\u002F scripts\u002Fanalyze-api-usage.ts\n\ninterface ApiUsageReport {\n  endpoints: Map\u003Cstring, number>;\n  methods: Map\u003Cstring, number>;\n  fields: Map\u003Cstring, Set\u003Cstring>>;\n  deprecations: string[];\n}\n\nasync function analyzeApiUsage(logFile: string): Promise\u003CApiUsageReport> {\n  const fs = require('fs');\n  const logs = JSON.parse(fs.readFileSync(logFile, 'utf8'));\n\n  const report: ApiUsageReport = {\n    endpoints: new Map(),\n    methods: new Map(),\n    fields: new Map(),\n    deprecations: [],\n  };\n\n  logs.forEach((log: any) => {\n    \u002F\u002F Count endpoint usage\n    const endpoint = log.url?.replace(\u002F\\\u002F[a-z0-9_-]+$\u002Fi, '\u002F:id');\n    if (endpoint) {\n      report.endpoints.set(endpoint, (report.endpoints.get(endpoint) || 0) + 1);\n    }\n\n    \u002F\u002F Count HTTP methods\n    if (log.method) {\n      report.methods.set(log.method, (report.methods.get(log.method) || 0) + 1);\n    }\n\n    \u002F\u002F Track fields used in requests\n    if (log.requestBody) {\n      const fields = Object.keys(log.requestBody);\n      const endpointFields = report.fields.get(endpoint) || new Set();\n      fields.forEach(f => endpointFields.add(f));\n      report.fields.set(endpoint, endpointFields);\n    }\n\n    \u002F\u002F Check for deprecation warnings\n    if (log.responseHeaders?.['x-deprecation-warning']) {\n      report.deprecations.push(log.responseHeaders['x-deprecation-warning']);\n    }\n  });\n\n  return report;\n}\n\n\u002F\u002F Print report\nasync function printUsageReport() {\n  const report = await analyzeApiUsage('.\u002Flogs\u002Fapi-requests.json');\n\n  console.log('=== MaintainX API Usage Analysis ===\\n');\n\n  console.log('Endpoints Used:');\n  report.endpoints.forEach((count, endpoint) => {\n    console.log(`  ${endpoint}: ${count} calls`);\n  });\n\n  console.log('\\nHTTP Methods:');\n  report.methods.forEach((count, method) => {\n    console.log(`  ${method}: ${count} calls`);\n  });\n\n  console.log('\\nFields by Endpoint:');\n  report.fields.forEach((fields, endpoint) => {\n    console.log(`  ${endpoint}: ${[...fields].join(', ')}`);\n  });\n\n  if (report.deprecations.length > 0) {\n    console.log('\\nDeprecation Warnings:');\n    [...new Set(report.deprecations)].forEach(d => {\n      console.log(`  - ${d}`);\n    });\n  }\n}\n```\n\n### Step 2: Version Compatibility Layer\n\n```typescript\n\u002F\u002F src\u002Fapi\u002Fversion-adapter.ts\n\n\u002F\u002F API version types\ntype ApiVersion = 'v1' | 'v2';\n\ninterface VersionAdapter {\n  transformRequest(data: any): any;\n  transformResponse(data: any): any;\n  getBaseUrl(): string;\n}\n\n\u002F\u002F V1 Adapter (current)\nclass V1Adapter implements VersionAdapter {\n  getBaseUrl(): string {\n    return 'https:\u002F\u002Fapi.getmaintainx.com\u002Fv1';\n  }\n\n  transformRequest(data: any): any {\n    return data;  \u002F\u002F No transformation needed for current version\n  }\n\n  transformResponse(data: any): any {\n    return data;\n  }\n}\n\n\u002F\u002F V2 Adapter (future\u002Fhypothetical)\nclass V2Adapter implements VersionAdapter {\n  getBaseUrl(): string {\n    return 'https:\u002F\u002Fapi.getmaintainx.com\u002Fv2';\n  }\n\n  transformRequest(data: any): any {\n    \u002F\u002F Transform V1 request format to V2\n    const transformed = { ...data };\n\n    \u002F\u002F Example: V2 might rename 'assignees' to 'assigned_users'\n    if (transformed.assignees) {\n      transformed.assigned_users = transformed.assignees;\n      delete transformed.assignees;\n    }\n\n    \u002F\u002F Example: V2 might use different priority values\n    if (transformed.priority) {\n      const priorityMap: Record\u003Cstring, string> = {\n        'NONE': 'P4',\n        'LOW': 'P3',\n        'MEDIUM': 'P2',\n        'HIGH': 'P1',\n      };\n      transformed.priority = priorityMap[transformed.priority] || transformed.priority;\n    }\n\n    return transformed;\n  }\n\n  transformResponse(data: any): any {\n    \u002F\u002F Transform V2 response format to V1 for backward compatibility\n    const transformed = { ...data };\n\n    \u002F\u002F Reverse the transformations\n    if (transformed.assigned_users) {\n      transformed.assignees = transformed.assigned_users;\n      delete transformed.assigned_users;\n    }\n\n    if (transformed.priority) {\n      const priorityMap: Record\u003Cstring, string> = {\n        'P4': 'NONE',\n        'P3': 'LOW',\n        'P2': 'MEDIUM',\n        'P1': 'HIGH',\n      };\n      transformed.priority = priorityMap[transformed.priority] || transformed.priority;\n    }\n\n    return transformed;\n  }\n}\n\n\u002F\u002F Factory\nfunction createAdapter(version: ApiVersion): VersionAdapter {\n  switch (version) {\n    case 'v2':\n      return new V2Adapter();\n    case 'v1':\n    default:\n      return new V1Adapter();\n  }\n}\n\n\u002F\u002F Version-aware client\nclass VersionedMaintainXClient {\n  private adapter: VersionAdapter;\n  private client: AxiosInstance;\n\n  constructor(version: ApiVersion = 'v1') {\n    this.adapter = createAdapter(version);\n    this.client = axios.create({\n      baseURL: this.adapter.getBaseUrl(),\n      headers: {\n        'Authorization': `Bearer ${process.env.MAINTAINX_API_KEY}`,\n        'Content-Type': 'application\u002Fjson',\n      },\n    });\n  }\n\n  async createWorkOrder(data: any) {\n    const transformedRequest = this.adapter.transformRequest(data);\n    const response = await this.client.post('\u002Fworkorders', transformedRequest);\n    return this.adapter.transformResponse(response.data);\n  }\n}\n```\n\n### Step 3: Feature Flag for Gradual Migration\n\n```typescript\n\u002F\u002F src\u002Fconfig\u002Ffeature-flags.ts\n\ninterface FeatureFlags {\n  useV2Api: boolean;\n  useNewWorkOrderFormat: boolean;\n  enableBetaFeatures: boolean;\n}\n\nfunction getFeatureFlags(): FeatureFlags {\n  return {\n    useV2Api: process.env.USE_V2_API === 'true',\n    useNewWorkOrderFormat: process.env.USE_NEW_WO_FORMAT === 'true',\n    enableBetaFeatures: process.env.ENABLE_BETA === 'true',\n  };\n}\n\n\u002F\u002F Feature-flagged API client\nclass MigratableMaintainXClient {\n  private v1Client: MaintainXClient;\n  private v2Client?: MaintainXClient;\n  private flags: FeatureFlags;\n\n  constructor() {\n    this.flags = getFeatureFlags();\n    this.v1Client = new MaintainXClient();\n\n    if (this.flags.useV2Api) {\n      \u002F\u002F Initialize V2 client when ready\n      \u002F\u002F this.v2Client = new MaintainXClientV2();\n    }\n  }\n\n  async createWorkOrder(data: any) {\n    if (this.flags.useV2Api && this.v2Client) {\n      return this.v2Client.createWorkOrder(data);\n    }\n    return this.v1Client.createWorkOrder(data);\n  }\n}\n```\n\n### Step 4: Migration Testing\n\n```typescript\n\u002F\u002F tests\u002Fmigration.test.ts\n\ndescribe('API Migration Tests', () => {\n  describe('Request Transformation', () => {\n    it('should transform V1 work order to V2 format', () => {\n      const v1Data = {\n        title: 'Test Work Order',\n        priority: 'HIGH',\n        assignees: ['user1', 'user2'],\n      };\n\n      const adapter = new V2Adapter();\n      const v2Data = adapter.transformRequest(v1Data);\n\n      expect(v2Data.title).toBe('Test Work Order');\n      expect(v2Data.priority).toBe('P1');\n      expect(v2Data.assigned_users).toEqual(['user1', 'user2']);\n      expect(v2Data.assignees).toBeUndefined();\n    });\n  });\n\n  describe('Response Transformation', () => {\n    it('should transform V2 response to V1 format', () => {\n      const v2Response = {\n        id: 'wo_123',\n        title: 'Test',\n        priority: 'P1',\n        assigned_users: ['user1'],\n      };\n\n      const adapter = new V2Adapter();\n      const v1Response = adapter.transformResponse(v2Response);\n\n      expect(v1Response.priority).toBe('HIGH');\n      expect(v1Response.assignees).toEqual(['user1']);\n      expect(v1Response.assigned_users).toBeUndefined();\n    });\n  });\n\n  describe('Parallel API Calls', () => {\n    it('should return same results from both API versions', async () => {\n      const v1Client = new VersionedMaintainXClient('v1');\n      \u002F\u002F const v2Client = new VersionedMaintainXClient('v2');\n\n      const v1WorkOrders = await v1Client.getWorkOrders({ limit: 10 });\n      \u002F\u002F const v2WorkOrders = await v2Client.getWorkOrders({ limit: 10 });\n\n      \u002F\u002F Compare results (accounting for transformations)\n      \u002F\u002F expect(v1WorkOrders.length).toBe(v2WorkOrders.length);\n    });\n  });\n});\n```\n\n### Step 5: Rollback Plan\n\n```typescript\n\u002F\u002F scripts\u002Frollback.ts\n\ninterface RollbackStep {\n  name: string;\n  execute: () => Promise\u003Cvoid>;\n}\n\nconst rollbackSteps: RollbackStep[] = [\n  {\n    name: 'Disable V2 API flag',\n    execute: async () => {\n      \u002F\u002F Update feature flag\n      console.log('Setting USE_V2_API=false');\n      \u002F\u002F In practice, update your feature flag service\n    },\n  },\n  {\n    name: 'Restart services',\n    execute: async () => {\n      console.log('Restarting services to pick up flag change');\n      \u002F\u002F kubectl rollout restart deployment\u002Fyour-app\n    },\n  },\n  {\n    name: 'Verify V1 API usage',\n    execute: async () => {\n      console.log('Verifying API calls are using V1');\n      \u002F\u002F Check logs for API version\n    },\n  },\n  {\n    name: 'Monitor for errors',\n    execute: async () => {\n      console.log('Monitoring error rates...');\n      \u002F\u002F Check monitoring dashboards\n    },\n  },\n];\n\nasync function executeRollback() {\n  console.log('=== Executing API Rollback ===\\n');\n\n  for (const step of rollbackSteps) {\n    console.log(`Executing: ${step.name}`);\n    try {\n      await step.execute();\n      console.log(`  [DONE]\\n`);\n    } catch (error: any) {\n      console.error(`  [FAILED] ${error.message}`);\n      console.error('Rollback halted. Manual intervention required.');\n      process.exit(1);\n    }\n  }\n\n  console.log('=== Rollback Complete ===');\n}\n```\n\n## Migration Checklist\n\n- [ ] Analyzed current API usage\n- [ ] Identified deprecated features\n- [ ] Created version adapter layer\n- [ ] Set up feature flags\n- [ ] Written migration tests\n- [ ] Documented rollback procedure\n- [ ] Tested in staging environment\n- [ ] Communicated timeline to stakeholders\n- [ ] Scheduled maintenance window\n- [ ] Prepared monitoring dashboards\n\n## Output\n\n- API usage analysis report\n- Version compatibility layer\n- Feature flag configuration\n- Migration tests passing\n- Rollback procedure documented\n\n## Resources\n\n- [MaintainX API Documentation](https:\u002F\u002Fmaintainx.dev\u002F)\n- [MaintainX Changelog](https:\u002F\u002Fmaintainx.dev\u002Fchangelog)\n- [Strangler Fig Pattern](https:\u002F\u002Fmartinfowler.com\u002Fbliki\u002FStranglerFigApplication.html)\n\n## Next Steps\n\nFor CI\u002FCD integration, see `maintainx-ci-integration`.\n",{"name":5,"author":45,"license":15,"version":46,"description":47,"allowed-tools":48},"Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Migrate MaintainX API versions and handle breaking changes.\nUse when upgrading API versions, handling deprecations,\nor migrating between MaintainX API releases.\nTrigger with phrases like \"maintainx upgrade\", \"maintainx api version\",\n\"maintainx migration\", \"maintainx breaking changes\", \"maintainx deprecation\".\n","Read, Write, Edit, Bash(npm:*), Grep","main","90b50ed0778745a80fd5bfb13b1843d45b9e82f7","tests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fmaintainx-pack\u002Fskills\u002Fmaintainx-upgrade-migration",233,"https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust","https:\u002F\u002Fgithub.com\u002FDicklesworthstone","https:\u002F\u002Fwww.jeffreyemanuel.com\u002F","Building in NY","2026-11-15 01:54:15",{"source":8,"skillName":5,"commands":59,"prompt":69,"zipAvailable":70},[60,63,66],{"tool":61,"command":62},"npx","npx skills add Dicklesworthstone\u002Fpi_agent_rust --skill maintainx-upgrade-migration",{"tool":64,"command":65},"bunx","bunx skills add Dicklesworthstone\u002Fpi_agent_rust --skill maintainx-upgrade-migration",{"tool":67,"command":68},"pnpm","pnpm dlx skills add Dicklesworthstone\u002Fpi_agent_rust --skill maintainx-upgrade-migration","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fmaintainx-pack\u002Fskills\u002Fmaintainx-upgrade-migration\u002FSKILL.md",true,[],[73,106,141,164,190,217],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":77,"licenseFileUrl":78,"sourceHtmlUrl":79,"categories":80,"keywords":86,"publishedAt":105},"01M6FCR7G5A005P364Z6ZWCJDP","theme-factory","Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors\u002Ffonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fcreative-design\u002Ftheme-factory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fcreative-design\u002Ftheme-factory\u002FSKILL.md",[81],{"categoryNo":82,"categoryName":83,"taxonomyType":84,"taxonomyTypeDesc":85},"01JBSEEDCAT000000000000015","视觉设计","SCENARIO","使用场景",[87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,27,103,104],"theme factory","factory","theme","docs","toolkit","generate","artifacts","SET","fly","slides","landing","html","styling","artifact","pages","themes","you","fonts","2026-11-11 15:11:14",{"skillNo":107,"name":108,"nameZh":6,"description":109,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":77,"licenseFileUrl":110,"sourceHtmlUrl":111,"categories":112,"keywords":116,"publishedAt":40},"01M6FEGPPK0ZTKCCM0R3E3KS33","web-artifacts-builder","Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn\u002Fui). Use for complex artifacts requiring state management, routing, or shadcn\u002Fui components - not for simple single-file HTML\u002FJSX artifacts.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FSKILL.md",[113],{"categoryNo":114,"categoryName":115,"taxonomyType":84,"taxonomyTypeDesc":85},"01JBSEEDCAT000000000000009","前端开发",[117,118,93,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,32,98,134,135,136,137,138,139,140],"web artifacts builder","web","artifacts builder","builder","frontend","css","components","react","component","routing","state management","state","shadcn","file","ui","Tools","Tailwind","single-file","simple","ui components","multi","for","jsx","suite",{"skillNo":142,"name":143,"nameZh":6,"description":144,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":77,"licenseFileUrl":145,"sourceHtmlUrl":146,"categories":147,"keywords":152,"publishedAt":40},"01M6FEE9VTK1W4GY21AKREJXRG","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FSKILL.md",[148,151],{"categoryNo":149,"categoryName":150,"taxonomyType":84,"taxonomyTypeDesc":85},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":114,"categoryName":115,"taxonomyType":84,"taxonomyTypeDesc":85},[153,154,155,121,156,157,118,158,91,159,131,160,161,162,163,27,138],"testing","webapp testing","webapp","screenshots","playwright","debugging","browser","logs","applications","behavior","local",{"skillNo":165,"name":166,"nameZh":6,"description":167,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":168,"sourceHtmlUrl":169,"categories":170,"keywords":171,"publishedAt":40},"01M6FE20F7ZTQBFWKF4MPJ2SBX","neuropixels-analysis","Neuropixels neural recording analysis. Load SpikeGLX\u002FOpenEphys data, preprocess, motion correction, Kilosort4 spike sorting, quality metrics, Allen\u002FIBL curation, AI-assisted visual analysis, for Neuropixels 1.0\u002F2.0 extracellular electrophysiology. Use when working with neural recordings, spike sorting, extracellular electrophysiology, or when the user mentions Neuropixels, SpikeGLX, Open Ephys, Kilosort, quality metrics, or unit curation.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FSKILL.md",[],[172,173,174,175,176,177,178,179,32,180,181,182,183,184,185,186,27,187,188,189,138,22],"analysis","neuropixels analysis","spike","metrics","data","open","quality","user","recordings","Neural","motion","visual","quality metrics","unit","sorting","curation","recording","load",{"skillNo":191,"name":192,"nameZh":6,"description":193,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":77,"licenseFileUrl":194,"sourceHtmlUrl":195,"categories":196,"keywords":200,"publishedAt":40},"01M6FDP0PDK6F1GGX395C7625Z","skill-creator","Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FSKILL.md",[197],{"categoryNo":198,"categoryName":199,"taxonomyType":84,"taxonomyTypeDesc":85},"01JBSEEDCAT000000000000023","Skill与智能体开发",[201,202,203,204,205,206,207,208,209,210,211,212,213,214,27,138,215,22,216],"skill creator","creator","workflows","create","update","capabilities","knowledge","tool","integrations","specialized","guide","new skill","existing skill","users","Existing","new",{"skillNo":218,"name":219,"nameZh":6,"description":220,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":221,"sourceHtmlUrl":222,"categories":223,"keywords":225,"publishedAt":40},"01M6FDM8Y7VK7NYG9SM7QPA3PW","notebooklm","Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. Browser automation, library management, persistent auth. Drastically reduced hallucinations through document-only responses.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FSKILL.md",[224],{"categoryNo":198,"categoryName":199,"taxonomyType":84,"taxonomyTypeDesc":85},[219,226,227,228,229,230,231,159,232,233,32,234,235,236,237,138,238],"google","browser automation","gemini","automation","auth","code","library","management","only","document","query","Citation","source"]