Skip to content

@W-22934319: [API Management] Add manage-api-version Vibes skill#148

Open
taliyahhh wants to merge 2 commits into
mulesoft:masterfrom
taliyahhh:feature/manage-api-version-skill
Open

@W-22934319: [API Management] Add manage-api-version Vibes skill#148
taliyahhh wants to merge 2 commits into
mulesoft:masterfrom
taliyahhh:feature/manage-api-version-skill

Conversation

@taliyahhh

@taliyahhh taliyahhh commented Jun 30, 2026

Copy link
Copy Markdown

@W-22934319: [API Management] Add manage-api-version Vibes skill

Description

  • New Skill

Adds the manage-api-version Vibes skill for reading, checking, and updating API spec dependency versions in a Mule project. Versions are stored as <{artifactId}.version> properties in pom.xml — the same values the Anypoint Studio Project Properties → API Specs tab manages.

Changes

  • Add skills/mule-development/manage-api-version/SKILL.md with four execution paths:
    • DISPLAY ALL — reads pom.xml and lists all API spec version properties
    • DISPLAY SPECIFIC — lists versions for named APIs only
    • CHECK ALL / CHECK SPECIFIC — queries Exchange for newer versions and surfaces them
    • CHANGE — interactive semver-sorted version selection, pom.xml update, automatic mvn clean package -DskipTests rescaffold, and pom.xml backup/restore on failure
  • Bump package version 1.5.01.6.0 and update CHANGELOG.md

Checklist

  • My code follows the style guidelines.
  • I have performed a self-review of my own code.
  • I have made corresponding changes to the documentation.
  • I have updated the CHANGELOG.md with any new feature/bugfix/known issue
  • This PR does not include Third Party Products (3PP) under categories B and X.

Related Links

taliyahhh and others added 2 commits June 30, 2026 15:36
Add command-line skill for managing API dependency versions in Mule projects.
Provides natural language interface to the API Management feature in Anypoint Studio.

Features:
- Display current API dependency versions
- Check for available updates from Exchange
- Update API versions with automatic rescaffold
- Multi-API batch updates
- Integration with Project Properties → API Specs tab functionality

This skill wraps the API Management UI (PR #3742) for CLI/AI-driven workflows.

Related:
- Main repo PR #3742: API Management UI implementation
- API component PR #1665: POM property placeholder support

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- Fix ---2 typo in SKILL.md body separator
- Add Prerequisites section (anypoint-cli-v4 + mvn checks, install steps,
  note that DISPLAY paths work without CLI)
- Expand API spec classifier list to the authoritative set used by the
  backend: raml, oas, graphql, protobuf, fat-protobuf, evented-api
  (was: raml, oas, zip — zip is not a valid API spec classifier)
- Make otherVersions parsing concrete everywhere: each element has a
  version string; sort descending by semver; include jq one-liner for
  the CHANGE path with Python fallback
- Add jq rule and Python fallback to Rules section
- Add two Troubleshooting entries: CLI auth conflict (ANYPOINT_BEARER +
  ANYPOINT_CLIENT_ID/SECRET), empty otherVersions for single-version assets
- Remove accidental nested skills/mule-development/skills/ directory
- Bump package version 1.4.0 → 1.4.1 and update CHANGELOG

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@taliyahhh taliyahhh force-pushed the feature/manage-api-version-skill branch from fd22c94 to cd6bdf3 Compare June 30, 2026 22:37
@taliyahhh taliyahhh marked this pull request as ready for review June 30, 2026 22:41
@taliyahhh

Copy link
Copy Markdown
Author

@mlinsf ready for review!

@taliyahhh taliyahhh changed the title @W-22934319: Add manage-api-version skill (mule-development) @W-22934319: [API Management] Add manage-api-version Vibes skill Jun 30, 2026
@leandrogilcarrano leandrogilcarrano self-requested a review July 1, 2026 20:20

@leandrogilcarrano leandrogilcarrano left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All validators pass. New skill is well-structured, trigger-rich description, correct semver-sorted version selection logic, proper pom.xml backup/restore on failure, and follows established mule-development skill patterns. Minor: semver convention suggests 1.6.0 (new feature) over 1.5.1 (patch), but not a blocker.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants