feat(release): version advisory composite action (ci#369 consolidated)

.github/scripts/test-fixtures/version-advisory/a-internal-removal/after.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Foo
+  # @api public
+  def self.public_thing(x)
+    x + 1
+  end
+end

.github/scripts/test-fixtures/version-advisory/a-internal-removal/before.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Foo
+  # @api private
+  def self.internal_helper(x)
+    x * 2
+  end
+
+  # @api public
+  def self.public_thing(x)
+    x + 1
+  end
+end

.github/scripts/test-fixtures/version-advisory/a-internal-removal/expected.md

@@ -0,0 +1,14 @@
+::notice title=Version advisory::Detected changes suggest 'patch'.
+
+
+## Version advisory
+
+Range: v0.1.0 → HEAD
+Overall suggested bump: **patch**
+You selected: `patch`.
+
+| Change | Classification | Evidence | Suggested |
+|---|---|---|---|
+| Removed `Foo::internal_helper` | internal | annotation `# @api private` at lib/foo.rb:5 | patch |
+
+_Advisory only. Maintainer selects the bump. See ci#369 for the design brief._

.github/scripts/test-fixtures/version-advisory/b-public-addition/after.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Foo
+  # @api public
+  def self.existing_method(x)
+    x
+  end
+
+  # @api public
+  def self.new_public_method(x, y)
+    x + y
+  end
+end

.github/scripts/test-fixtures/version-advisory/b-public-addition/before.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Foo
+  # @api public
+  def self.existing_method(x)
+    x
+  end
+end

.github/scripts/test-fixtures/version-advisory/b-public-addition/expected.md

@@ -0,0 +1,14 @@
+::notice title=Version advisory::Detected changes suggest 'minor'. You selected 'patch'. See run summary.
+
+
+## Version advisory
+
+Range: v0.1.0 → HEAD
+Overall suggested bump: **minor**
+You selected: `patch`.
+
+| Change | Classification | Evidence | Suggested |
+|---|---|---|---|
+| Added `Foo::new_public_method` | public | annotation `# @api public` at lib/foo.rb:10 | minor |
+
+_Advisory only. Maintainer selects the bump. See ci#369 for the design brief._

.github/scripts/test-fixtures/version-advisory/c-public-body-change/after.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Foo
+  # @api public
+  def self.public_thing(x)
+    x * 2
+  end
+end

.github/scripts/test-fixtures/version-advisory/c-public-body-change/before.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Foo
+  # @api public
+  def self.public_thing(x)
+    x + 1
+  end
+end

.github/scripts/test-fixtures/version-advisory/c-public-body-change/expected.md

@@ -0,0 +1,14 @@
+::notice title=Version advisory::Detected changes suggest 'unknown'. You selected 'patch'. See run summary.
+
+
+## Version advisory
+
+Range: v0.1.0 → HEAD
+Overall suggested bump: **unknown**
+You selected: `patch`.
+
+| Change | Classification | Evidence | Suggested |
+|---|---|---|---|
+| Body-changed (undetectable) `Foo::public_thing` | public | annotation `# @api public` at lib/foo.rb:5 | unknown |
+
+_Advisory only. Maintainer selects the bump. See ci#369 for the design brief._

.github/scripts/test-fixtures/version-advisory/d-no-change/after.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Foo
+  # @api public
+  # Updated comment describing the method a bit more.
+  def self.method_a(x)
+    x
+  end
+end

.github/scripts/test-fixtures/version-advisory/d-no-change/before.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Foo
+  # @api public
+  def self.method_a(x)
+    x
+  end
+end

.github/scripts/test-fixtures/version-advisory/d-no-change/expected.md

@@ -0,0 +1,10 @@
+::notice title=Version advisory::Detected changes suggest 'none'. You selected 'patch'. See run summary.
+
+
+## Version advisory
+
+Range: v0.1.0 → HEAD
+Overall suggested bump: **none**
+You selected: `patch`.
+
+_No lib/ symbol changes detected._

.github/scripts/test-fixtures/version-advisory/e-public-signature-broken/after.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Foo
+  # @api public
+  def self.transform(x)
+    x * 2
+  end
+end

.github/scripts/test-fixtures/version-advisory/e-public-signature-broken/before.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Foo
+  # @api public
+  def self.transform(x, mode)
+    mode == :double ? x * 2 : x
+  end
+end

.github/scripts/test-fixtures/version-advisory/e-public-signature-broken/expected.md

@@ -0,0 +1,14 @@
+::notice title=Version advisory::Detected changes suggest 'minor'. You selected 'patch'. See run summary.
+
+
+## Version advisory
+
+Range: v0.1.0 → HEAD
+Overall suggested bump: **minor**
+You selected: `patch`.
+
+| Change | Classification | Evidence | Suggested |
+|---|---|---|---|
+| Signature-changed `Foo::transform` | public | annotation `# @api public` at lib/foo.rb:5; demoted major→minor per pre-1.0 SemVer convention | minor |
+
+_Advisory only. Maintainer selects the bump. See ci#369 for the design brief._

.github/scripts/test-fixtures/version-advisory/f-public-removal/after.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Foo
+  # @api public
+  def self.public_thing(x)
+    x + 1
+  end
+end

.github/scripts/test-fixtures/version-advisory/f-public-removal/before.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Foo
+  # @api public
+  def self.public_thing(x)
+    x + 1
+  end
+
+  # @api public
+  def self.doomed(x)
+    x
+  end
+end

.github/scripts/test-fixtures/version-advisory/f-public-removal/expected.md

@@ -0,0 +1,14 @@
+::notice title=Version advisory::Detected changes suggest 'minor'. You selected 'patch'. See run summary.
+
+
+## Version advisory
+
+Range: v0.1.0 → HEAD
+Overall suggested bump: **minor**
+You selected: `patch`.
+
+| Change | Classification | Evidence | Suggested |
+|---|---|---|---|
+| Removed `Foo::doomed` | public | annotation `# @api public` at lib/foo.rb:10; demoted major→minor per pre-1.0 SemVer convention | minor |
+
+_Advisory only. Maintainer selects the bump. See ci#369 for the design brief._

.github/scripts/test-fixtures/version-advisory/g-nodoc-removal/after.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Foo
+  # @api public
+  def self.public_thing(x)
+    x + 1
+  end
+end

.github/scripts/test-fixtures/version-advisory/g-nodoc-removal/before.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Foo
+  # :nodoc:
+  def self.hidden_helper(x)
+    x * 2
+  end
+
+  # @api public
+  def self.public_thing(x)
+    x + 1
+  end
+end

.github/scripts/test-fixtures/version-advisory/g-nodoc-removal/expected.md

@@ -0,0 +1,14 @@
+::notice title=Version advisory::Detected changes suggest 'patch'.
+
+
+## Version advisory
+
+Range: v0.1.0 → HEAD
+Overall suggested bump: **patch**
+You selected: `patch`.
+
+| Change | Classification | Evidence | Suggested |
+|---|---|---|---|
+| Removed `Foo::hidden_helper` | internal | `:nodoc:` at lib/foo.rb:5 | patch |
+
+_Advisory only. Maintainer selects the bump. See ci#369 for the design brief._

.github/scripts/test-fixtures/version-advisory/h-public-api-txt/after.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Foo
+  def self.listed(x)
+    x
+  end
+end

.github/scripts/test-fixtures/version-advisory/h-public-api-txt/before.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Foo
+  def self.listed(x)
+    x
+  end
+
+  def self.unlisted(x)
+    x
+  end
+end

.github/scripts/test-fixtures/version-advisory/h-public-api-txt/expected.md

@@ -0,0 +1,14 @@
+::notice title=Version advisory::Detected changes suggest 'patch'.
+
+
+## Version advisory
+
+Range: v0.1.0 → HEAD
+Overall suggested bump: **patch**
+You selected: `patch`.
+
+| Change | Classification | Evidence | Suggested |
+|---|---|---|---|
+| Removed `Foo::unlisted` | internal | not listed in public_api.txt | patch |
+
+_Advisory only. Maintainer selects the bump. See ci#369 for the design brief._

.github/scripts/test-fixtures/version-advisory/h-public-api-txt/public_api.txt

@@ -0,0 +1,2 @@
+# Contract file — listed symbols are public
+Foo::listed