Compatibility

July 28, 2025 ยท View on GitHub

Plugin System

Yuki-no maintains backward compatibility for all existing workflows. Recent updates introduced a plugin system that automatically handles legacy options.

Legacy release-tracking Support

Your existing release-tracking configurations continue to work without changes:

# Legacy style (still fully supported)
- uses: Gumball12/yuki-no@v1
  with:
    release-tracking: true
    release-tracking-labels: |
      pending
      needs-release

For new projects, we recommend using the explicit plugin syntax with environment variables:

# Recommended style
- uses: Gumball12/yuki-no@v1
  env:
    YUKI_NO_RELEASE_TRACKING_LABELS: |
      pending
      needs-release
  with:
    plugins: |
      @yuki-no/plugin-release-tracking@latest

Key Changes

  • Plugin System: Release tracking is now implemented as a plugin @yuki-no/plugin-release-tracking
  • Environment Variables: release-tracking-labels option moved to YUKI_NO_RELEASE_TRACKING_LABELS environment variable
  • Automatic Migration: Legacy release-tracking option automatically enables the plugin

Deprecated Options

The following options are deprecated but still supported for backward compatibility:

  • release-tracking: Use plugins: ["@yuki-no/plugin-release-tracking"] instead
  • release-tracking-labels: Use env.YUKI_NO_RELEASE_TRACKING_LABELS instead