🪞 Use Iris to document Iris: add binary-path input for self-release

hyperb1iss · hyperb1iss · commit b6ea4f532cda · 2025-12-16T21:43:22.000-08:00
Teach Iris the ancient art of self-reflection. The release workflows
now use pre-built artifacts to generate their own release notes and
changelogs, creating a beautifully recursive loop where Iris describes
her own evolution.

Key improvements:
- Add binary-path input to skip download/build when artifact exists
- Switch from OpenAI to Anthropic for release note generation
- Generate both changelog and release notes in CI/CD pipeline
- Include changelog section in release assets
- Add release notes preview to workflow summary
- Quiet mode ensures clean markdown output without terminal noise

The snake now eats its own tail, and it tastes like well-documented
release automation.
diff --git a/.github/workflows/cicd.yml b/.github/workflows/cicd.yml
@@ -361,17 +361,38 @@ jobs:
           echo "tag=$PREVIOUS_TAG" >> $GITHUB_OUTPUT
           echo "Previous tag: $PREVIOUS_TAG"
 
+      - name: 🔧 Prepare git-iris binary
+        run: |
+          chmod +x ./artifacts/git-iris-linux-amd64/git-iris
+          echo "Binary ready: ./artifacts/git-iris-linux-amd64/git-iris"
+          ./artifacts/git-iris-linux-amd64/git-iris --version
+
+      - name: 📋 Generate changelog with Git-Iris
+        id: changelog
+        if: steps.prev_tag.outputs.tag != ''
+        uses: ./
+        with:
+          command: changelog
+          from: ${{ steps.prev_tag.outputs.tag }}
+          to: ${{ github.ref_name }}
+          version-name: ${{ github.ref_name }}
+          provider: anthropic
+          api-key: ${{ secrets.ANTHROPIC_API_KEY }}
+          output-file: CHANGELOG_SECTION.md
+          binary-path: ./artifacts/git-iris-linux-amd64/git-iris
+
       - name: 📝 Generate release notes with Git-Iris
         id: release_notes
         if: steps.prev_tag.outputs.tag != ''
         uses: ./
         with:
+          command: release-notes
           from: ${{ steps.prev_tag.outputs.tag }}
           to: ${{ github.ref_name }}
-          provider: openai
-          api-key: ${{ secrets.OPENAI_API_KEY }}
+          provider: anthropic
+          api-key: ${{ secrets.ANTHROPIC_API_KEY }}
           output-file: RELEASE_NOTES.md
-          build-from-source: "true"
+          binary-path: ./artifacts/git-iris-linux-amd64/git-iris
 
       - name: 📝 Fallback release notes
         if: steps.prev_tag.outputs.tag == '' || steps.release_notes.outcome == 'failure'
@@ -388,6 +409,7 @@ jobs:
           prerelease: false
           files: |
             ./release-assets/*
+            CHANGELOG_SECTION.md
           body_path: RELEASE_NOTES.md
 
   # Auto-update major version tag (v1, v2, etc.) for GitHub Action users
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -100,14 +100,17 @@ jobs:
           sed -i 's/^version = ".*"/version = "${{ steps.version.outputs.version }}"/' Cargo.toml
           echo "Updated Cargo.toml to version ${{ steps.version.outputs.version }}"
 
+      - name: "📦 Update Cargo.lock"
+        run: cargo update -p git-iris
+
       - name: "🔨 Build"
         run: cargo build --release --locked
 
       - name: "🧪 Run tests"
         run: cargo test --locked
 
       - name: "📋 Generate changelog"
-        if: ${{ !inputs.skip_changelog && !inputs.dry_run && secrets.OPENAI_API_KEY != '' }}
+        if: ${{ !inputs.skip_changelog && !inputs.dry_run }}
         uses: ./
         with:
           command: changelog
@@ -116,11 +119,22 @@ jobs:
           version-name: ${{ steps.version.outputs.version }}
           output-file: CHANGELOG.md
           update-file: "true"
-          api-key: ${{ secrets.OPENAI_API_KEY }}
-          build-from-source: "true"
+          provider: anthropic
+          api-key: ${{ secrets.ANTHROPIC_API_KEY }}
+          binary-path: ./target/release/git-iris
 
-      - name: "📦 Update Cargo.lock"
-        run: cargo update -p git-iris
+      - name: "📝 Generate release notes"
+        if: ${{ !inputs.dry_run }}
+        id: release_notes
+        uses: ./
+        with:
+          command: release-notes
+          from: v${{ steps.version.outputs.current }}
+          to: HEAD
+          version-name: ${{ steps.version.outputs.version }}
+          provider: anthropic
+          api-key: ${{ secrets.ANTHROPIC_API_KEY }}
+          binary-path: ./target/release/git-iris
 
       - name: "✨ Commit version bump"
         if: ${{ !inputs.dry_run }}
@@ -156,9 +170,15 @@ jobs:
             echo "- Build .deb and .rpm packages" >> $GITHUB_STEP_SUMMARY
             echo "- Publish Docker image to Docker Hub" >> $GITHUB_STEP_SUMMARY
             echo "- Publish to crates.io" >> $GITHUB_STEP_SUMMARY
-            echo "- Generate release notes with git-iris" >> $GITHUB_STEP_SUMMARY
-            echo "- Create GitHub Release" >> $GITHUB_STEP_SUMMARY
+            echo "- Create GitHub Release with release notes" >> $GITHUB_STEP_SUMMARY
             echo "- Update v1 action tag" >> $GITHUB_STEP_SUMMARY
             echo "" >> $GITHUB_STEP_SUMMARY
             echo "📦 [View CI/CD progress](https://github.com/${{ github.repository }}/actions)" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "---" >> $GITHUB_STEP_SUMMARY
+            echo "### 📝 Release Notes Preview" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            cat << 'EOF' >> $GITHUB_STEP_SUMMARY
+          ${{ steps.release_notes.outputs.content }}
+          EOF
           fi
diff --git a/action.yml b/action.yml
@@ -48,6 +48,9 @@ inputs:
     description: "Build from source instead of downloading binary"
     required: false
     default: "false"
+  binary-path:
+    description: "Path to pre-built git-iris binary (skips download and build)"
+    required: false
 
 outputs:
   content:
@@ -94,16 +97,23 @@ runs:
             ;;
         esac
 
+    - name: Use pre-built binary
+      if: inputs.binary-path != ''
+      shell: bash
+      run: |
+        echo "Using pre-built binary: ${{ inputs.binary-path }}"
+        echo "GIT_IRIS_BIN=${{ inputs.binary-path }}" >> $GITHUB_ENV
+
     - name: Install Rust (for build-from-source)
-      if: inputs.build-from-source == 'true'
+      if: inputs.binary-path == '' && inputs.build-from-source == 'true'
       uses: dtolnay/rust-toolchain@stable
 
     - name: Rust cache (for build-from-source)
-      if: inputs.build-from-source == 'true'
+      if: inputs.binary-path == '' && inputs.build-from-source == 'true'
       uses: Swatinem/rust-cache@v2
 
     - name: Download git-iris binary
-      if: inputs.build-from-source != 'true'
+      if: inputs.binary-path == '' && inputs.build-from-source != 'true'
       shell: bash
       env:
         GH_TOKEN: ${{ github.token }}
@@ -131,7 +141,7 @@ runs:
         echo "::endgroup::"
 
     - name: Build git-iris from source
-      if: inputs.build-from-source == 'true'
+      if: inputs.binary-path == '' && inputs.build-from-source == 'true'
       shell: bash
       run: |
         echo "::group::Building git-iris from source"
@@ -143,20 +153,26 @@ runs:
       id: generate
       shell: bash
       env:
+        # LLM provider configuration
         OPENAI_API_KEY: ${{ inputs.provider == 'openai' && inputs.api-key || '' }}
         ANTHROPIC_API_KEY: ${{ inputs.provider == 'anthropic' && inputs.api-key || '' }}
         GOOGLE_API_KEY: ${{ inputs.provider == 'google' && inputs.api-key || '' }}
         IRIS_PROVIDER: ${{ inputs.provider }}
         IRIS_MODEL: ${{ inputs.model }}
         IRIS_INSTRUCTIONS: ${{ inputs.custom-instructions }}
+        # Ensure clean markdown output - no colors or formatting
+        NO_COLOR: "1"
+        TERM: dumb
+        CLICOLOR: "0"
+        CLICOLOR_FORCE: "0"
       run: |
         echo "::group::Running git-iris ${{ inputs.command }}"
 
         GIT_IRIS="${GIT_IRIS_BIN:-git-iris}"
         COMMAND="${{ inputs.command }}"
 
-        # Build base command
-        CMD="$GIT_IRIS $COMMAND --from '${{ inputs.from }}' --to '${{ inputs.to }}' --raw"
+        # Build base command (--raw ensures markdown output, --quiet suppresses spinners)
+        CMD="$GIT_IRIS $COMMAND --from '${{ inputs.from }}' --to '${{ inputs.to }}' --raw --quiet"
 
         # Add version name if specified
         if [ -n "${{ inputs.version-name }}" ]; then
