pipecraft 0.0.0-releaseit → 0.26.0

package/dist/utils/versioning.js

@@ -1,13 +1,75 @@
+/**
+ * Version Management and Semantic Versioning Utilities
+ *
+ * This module provides comprehensive version management using release-it and
+ * conventional commits. It handles:
+ * - Automatic version calculation based on commit history
+ * - Generation of release-it, commitlint, and husky configurations
+ * - Git tag creation and management
+ * - Conventional commit validation
+ * - Changelog generation
+ *
+ * The VersionManager integrates with the trunk-based workflow to automatically
+ * bump versions when code is promoted through the pipeline.
+ *
+ * @module utils/versioning
+ */
 import { execSync } from 'child_process';
 import { existsSync, readFileSync, writeFileSync } from 'fs';
 import { join } from 'path';
+/**
+ * Manager for semantic versioning and release automation.
+ *
+ * This class handles all version-related operations including configuration
+ * generation, version calculation, and commit validation. It integrates with
+ * release-it for automated versioning and conventional-changelog for
+ * changelog generation.
+ *
+ * @example
+ * ```typescript
+ * const versionManager = new VersionManager(config)
+ *
+ * // Setup version management (creates config files)
+ * versionManager.setupVersionManagement()
+ *
+ * // Get current version from git tags
+ * const currentVersion = versionManager.getCurrentVersion()
+ *
+ * // Calculate next version based on commits
+ * const { version, type } = versionManager.calculateNextVersion()
+ * console.log(`Next version: ${version} (${type} bump)`)
+ * ```
+ */
 export class VersionManager {
     config;
+    /**
+     * Create a new VersionManager instance.
+     *
+     * @param config - PipeCraft configuration object
+     */
     constructor(config) {
         this.config = config;
     }
     /**
-     * Generate release-it configuration
+     * Generate release-it configuration file content.
+     *
+     * Creates a CommonJS module exporting release-it configuration that:
+     * - Disables npm publishing (for monorepos/private packages)
+     * - Configures git tagging with conventional versioning
+     * - Sets up conventional-changelog plugin for automatic version bumping
+     * - Merges user-defined bump rules with sensible defaults
+     *
+     * The generated config uses a custom whatBump function that analyzes
+     * conventional commits to determine the appropriate version bump level
+     * (major, minor, or patch).
+     *
+     * @returns JavaScript module string ready to write to .release-it.cjs
+     *
+     * @example
+     * ```typescript
+     * const config = versionManager.generateReleaseItConfig()
+     * writeFileSync('.release-it.cjs', config)
+     * ```
      */
     generateReleaseItConfig() {
         const defaultConfig = {
@@ -74,7 +136,20 @@ export class VersionManager {
         return `module.exports = ${JSON.stringify(defaultConfig, null, 2)}`;
     }
     /**
-     * Generate commitlint configuration
+     * Generate commitlint configuration file content.
+     *
+     * Creates a CommonJS module that configures commitlint to enforce
+     * conventional commit message format. This ensures all commits follow
+     * a consistent structure that can be parsed for automatic versioning.
+     *
+     * Enforced rules include:
+     * - Valid commit types (feat, fix, docs, etc.)
+     * - Lowercase types
+     * - Non-empty subjects
+     * - Lowercase subject (except proper nouns)
+     * - No trailing period in subject
+     *
+     * @returns JavaScript module string ready to write to commitlint.config.js
      */
     generateCommitlintConfig() {
         return `module.exports = {
@@ -106,7 +181,13 @@ export class VersionManager {
 }`;
     }
     /**
-     * Generate husky configuration
+     * Generate husky commit-msg hook script.
+     *
+     * Creates a shell script that runs commitlint on every commit message.
+     * This hook automatically validates commit messages before they're accepted,
+     * preventing non-conventional commits from entering the repository.
+     *
+     * @returns Shell script string ready to write to .husky/commit-msg
      */
     generateHuskyConfig() {
         return `#!/usr/bin/env sh
@@ -115,7 +196,27 @@ export class VersionManager {
 npx commitlint --edit $1`;
     }
     /**
-     * Setup version management files
+     * Setup version management infrastructure.
+     *
+     * Creates all necessary configuration files and hooks for automated
+     * version management:
+     * - .release-it.cjs (release-it configuration)
+     * - commitlint.config.js (commit message linting)
+     * - .husky/commit-msg (git hook for commit validation)
+     * - package.json scripts (release, changelog commands)
+     *
+     * Only runs if versioning is enabled in configuration.
+     * Installs husky if not already present.
+     *
+     * @example
+     * ```typescript
+     * versionManager.setupVersionManagement()
+     * // Files created:
+     * // - .release-it.cjs
+     * // - commitlint.config.js
+     * // - .husky/commit-msg
+     * // - Updated package.json
+     * ```
      */
     setupVersionManagement() {
         if (!this.config.versioning?.enabled) {
@@ -127,24 +228,36 @@ npx commitlint --edit $1`;
         // Generate commitlint.config.js
         const commitlintConfig = this.generateCommitlintConfig();
         writeFileSync('commitlint.config.js', commitlintConfig);
-        // Generate .husky/commit-msg
+        // Setup husky and commit-msg hook
         const huskyDir = '.husky';
         if (!existsSync(huskyDir)) {
             execSync('npx husky install', { stdio: 'inherit' });
-            // Ensure directory exists (in case husky install was mocked/failed)
+            // Ensure directory exists (in case husky install was mocked/failed in tests)
             if (!existsSync(huskyDir)) {
                 const { mkdirSync } = require('fs');
                 mkdirSync(huskyDir, { recursive: true });
             }
         }
+        // Create commit-msg hook script
         const commitMsgHook = this.generateHuskyConfig();
         writeFileSync(join(huskyDir, 'commit-msg'), commitMsgHook);
+        // Make hook executable (required for git to run it)
         execSync(`chmod +x ${join(huskyDir, 'commit-msg')}`);
-        // Update package.json scripts
+        // Update package.json with version management scripts
         this.updatePackageJsonScripts();
     }
     /**
-     * Update package.json with version management scripts
+     * Update package.json with version management scripts.
+     *
+     * Adds npm scripts for common version management tasks:
+     * - release: Run release-it to create a new version
+     * - release:dry: Preview what release-it would do
+     * - version:check: Check what version would be bumped to
+     * - changelog: Generate CHANGELOG.md from commits
+     * - commit: Stage and commit with interactive prompting
+     * - prepare: Install husky hooks (runs automatically on npm install)
+     *
+     * @private
      */
     updatePackageJsonScripts() {
         const packageJsonPath = 'package.json';
@@ -152,6 +265,7 @@ npx commitlint --edit $1`;
             return;
         }
         const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+        // Merge with existing scripts, preserving any user-defined ones
         packageJson.scripts = {
             ...packageJson.scripts,
             'release': 'release-it',
@@ -164,34 +278,83 @@ npx commitlint --edit $1`;
         writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
     }
     /**
-     * Check if conventional commits are being used
+     * Validate that recent commits follow conventional commit format.
+     *
+     * Checks the last 10 commits to determine if the repository is following
+     * conventional commit conventions. This can be used as a pre-flight check
+     * before enabling versioning features.
+     *
+     * Expected format: `type(scope?): subject`
+     * Valid types: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
+     *
+     * @returns true if all recent commits follow conventional format
+     *
+     * @example
+     * ```typescript
+     * if (!versionManager.validateConventionalCommits()) {
+     *   console.warn('⚠ Some commits do not follow conventional format')
+     *   console.log('Enable with: git config commit.template .gitmessage')
+     * }
+     * ```
      */
     validateConventionalCommits() {
         try {
-            const result = execSync('git log --oneline -10', { encoding: 'utf8' });
+            const result = execSync('git log --oneline -10', {
+                encoding: 'utf8',
+                stdio: ['pipe', 'pipe', 'ignore'] // Suppress stderr to avoid "not a git repository" errors in tests
+            });
             const commits = result.split('\n').filter(line => line.trim());
-            // Check if commits follow conventional format
+            // Check if commits follow conventional format: type(scope?): subject
             const conventionalPattern = /^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\(.+\))?: .+/;
             return commits.every(commit => conventionalPattern.test(commit));
         }
         catch (error) {
+            // Not a git repository or other git error
             return false;
         }
     }
     /**
-     * Get current version from git tags
+     * Get the current version from git tags.
+     *
+     * Finds the most recent git tag matching semantic versioning format (v*.*.*)
+     * and returns it as a version string. Strips the leading 'v' if present.
+     *
+     * @returns Current version string (e.g., "1.2.3") or "0.0.0" if no tags exist
+     *
+     * @example
+     * ```typescript
+     * const currentVersion = versionManager.getCurrentVersion()
+     * console.log(`Current version: v${currentVersion}`)
+     * ```
      */
     getCurrentVersion() {
         try {
-            const result = execSync('git describe --tags --abbrev=0', { encoding: 'utf8' });
+            const result = execSync('git describe --tags --abbrev=0', {
+                encoding: 'utf8',
+                stdio: ['pipe', 'pipe', 'ignore'] // Suppress stderr to avoid "not a git repository" errors in tests
+            });
             return result.trim().replace('v', '');
         }
         catch (error) {
+            // No tags exist yet, or not a git repository
             return '0.0.0';
         }
     }
     /**
-     * Calculate next version based on conventional commits
+     * Calculate the next version based on conventional commits.
+     *
+     * Runs release-it in dry-run mode to determine what version would be
+     * created based on commits since the last tag. Analyzes conventional
+     * commit messages to determine the appropriate bump level.
+     *
+     * @returns Object containing the next version string and bump type
+     *
+     * @example
+     * ```typescript
+     * const { version, type } = versionManager.calculateNextVersion()
+     * console.log(`Next ${type} version: ${version}`)
+     * // Output: "Next minor version: 1.3.0"
+     * ```
      */
     calculateNextVersion() {
         try {
@@ -200,7 +363,7 @@ npx commitlint --edit $1`;
                 encoding: 'utf8',
                 stdio: 'pipe'
             });
-            // Parse release-it output to get version info
+            // Parse release-it output to extract version and bump type
             const versionMatch = result.match(/version\s+(\d+\.\d+\.\d+)/);
             const typeMatch = result.match(/bump\s+(\w+)/);
             return {
@@ -209,6 +372,7 @@ npx commitlint --edit $1`;
             };
         }
         catch (error) {
+            // release-it not installed, or other error
             return {
                 version: this.getCurrentVersion(),
                 type: 'patch'

package/dist/utils/versioning.js.map

@@ -1 +1 @@
-{"version":3,"file":"versioning.js","sourceRoot":"","sources":["../../src/utils/versioning.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"versioning.js","sourceRoot":"","sources":["../../src/utils/versioning.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,16 +1,30 @@
 {
   "name": "pipecraft",
-  "version": "0.0.0-releaseit",
+  "version": "0.26.0",
   "description": "CLI tool for managing trunk-based development workflows",
   "license": "MIT",
   "type": "module",
   "bin": {
     "pipecraft": "./dist/cli/index.js"
   },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jamesvillarrubia/pipecraft.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "scripts": {
     "build": "tsc",
     "dev": "tsx src/cli/index.ts",
-    "test": "vitest",
+    "test": "vitest run",
     "test:ui": "vitest --ui",
     "test:run": "vitest run",
     "test:coverage": "vitest run --coverage",
@@ -20,13 +34,17 @@
     "lint:strict": "eslint . --ext .js,.jsx,.ts,.tsx --max-warnings=0",
     "format": "prettier --write '**/*.{js,jsx,ts,tsx,json,css,scss,md}'",
     "format:check": "prettier --check '**/*.{js,jsx,ts,tsx,json,css,scss,md}'",
-    "validate:pipeline": "node scripts/validate-pipeline.cjs",
+    "validate:pipeline": "node tests/tools/validation/validate-pipeline.cjs",
     "pipecraft": "tsx src/cli/index.ts",
     "init": "tsx src/cli/index.ts init --interactive",
     "generate": "tsx src/cli/index.ts generate",
-    "verify": "tsx src/cli/index.ts verify"
+    "verify": "tsx src/cli/index.ts verify",
+    "docs:build": "cd docs && pnpm run build",
+    "docs:dev": "cd docs && pnpm run start",
+    "docs:serve": "cd docs && pnpm run serve",
+    "docs:typedoc": "cd docs && pnpm run typedoc",
+    "docs:deploy": "npm run build && cd docs && pnpm run typedoc && pnpm run build"
   },
-  "private": false,
   "devDependencies": {
     "@eslint/eslintrc": "^3.3.1",
     "@eslint/js": "^9.24.0",
@@ -41,6 +59,7 @@
     "commander": "^14.0.1",
     "conventional-changelog-angular": "latest",
     "cosmiconfig": "^9.0.0",
+    "docusaurus-plugin-typedoc": "^1.4.2",
     "eslint": "^9.24.0",
     "eslint-plugin-import": "^2.31.0",
     "eslint-plugin-jsx-a11y": "^6.10.2",
@@ -49,6 +68,8 @@
     "globals": "^16.0.0",
     "prettier": "^2.8.8",
     "release-it": "^18.1.2",
+    "typedoc": "^0.28.14",
+    "typedoc-plugin-markdown": "^4.9.0",
     "vitest": "^2.1.8"
   },
   "dependencies": {

package/.claude/settings.local.json

@@ -1,35 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(test:*)",
-      "Bash(git commit -m \"$(cat <<''EOF''\nrefactor: rename project from FlowCraft to PipeCraft\n\nRename the entire project to PipeCraft to better align with the -craft naming convention (matching pullcraft). The new name emphasizes pipeline crafting and CI/CD automation.\n\nChanges:\n- Rename package from ''flowcraft'' to ''pipecraft''\n- Rename CLI command from ''flowcraft'' to ''pipecraft''\n- Rename config file from .flowcraftrc.json to .pipecraftrc.json\n- Update all documentation and branding\n- Update all source code references\n- Update all test files\n- Update all script files\n- Update GitHub Actions setup messaging\n\nThe functionality remains identical - only the branding has changed.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\nEOF\n)\")",
-      "Bash(git rev-parse:*)",
-      "Bash(gh run list:*)",
-      "Bash(gh workflow list:*)",
-      "Bash(gh run view:*)",
-      "Bash(git fetch:*)",
-      "Bash(pnpm build)",
-      "Bash(node:*)",
-      "Bash(pnpm pipecraft generate:*)",
-      "Bash(git restore:*)",
-      "Bash(git add:*)",
-      "Bash(git commit -m \"$(cat <<''EOF''\nfeat: add per-branch autoMerge configuration for hybrid manual/auto workflow\n\nAdd support for configurable auto-merge behavior per target branch, allowing\nteams to choose when to automatically fast-forward branches vs requiring manual\nPR review.\n\nChanges:\n- Add autoMerge config option supporting both boolean and per-branch object\n- Update pipeline template to conditionally generate branch job based on config\n- Add branch output to manage-branch action for workflow triggering\n- Implement workflow dispatch triggering to run pipeline on target branch\n- Add logic to remove branch job when autoMerge is disabled\n\nConfiguration:\n- Set autoMerge per target branch in .pipecraftrc.json\n- Example: { \"staging\": true, \"main\": false }\n- Enables auto-merge to staging, manual review for production\n\nWorkflow behavior:\n- When autoMerge enabled: creates PR + auto fast-forward + triggers workflow\n- When autoMerge disabled: creates PR + waits for manual merge (human merge triggers workflow)\n- Uses GITHUB_TOKEN with gh workflow run (no PAT needed)\n- Branch job includes conditional if statement based on source branch\n\nThis solves the issue where GITHUB_TOKEN pushes don''t trigger workflows by\nexplicitly triggering them, while maintaining flexibility for manual review\nwhen needed (e.g., before production deploys).\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\nEOF\n)\")",
-      "Bash(git push:*)",
-      "Bash(git commit:*)",
-      "Bash(gh pr list:*)",
-      "Bash(cat:*)",
-      "Read(//private/tmp/**)",
-      "Bash(pnpm test:*)",
-      "Bash(/dev/null)",
-      "Bash(gh api:*)",
-      "Bash(gh pr merge:*)",
-      "Bash(xargs -I {} git show {}:.github/workflows/pipeline.yml)",
-      "Bash(git checkout:*)",
-      "Bash(npm test)",
-      "Bash(pkill:*)",
-      "Bash(npm run build)"
-    ],
-    "deny": [],
-    "ask": []
-  }
-}

package/.github/actions/calculate-version/action.yml

@@ -1,106 +0,0 @@
-name: 'Calculate Version'
-description: 'Calculate semantic version using release-it and conventional commits'
-author: 'Pipecraft'
-
-inputs:
-  baseRef:
-    description: 'Base reference for version calculation'
-    required: false
-    default: 'main'
-
-outputs:
-  version:
-    description: 'The determined version'
-    value: ${{ steps.set_version.outputs.version }}
-
-runs:
-  using: 'composite'
-  steps:
-    - name: Checkout Code
-      uses: actions/checkout@v4
-      with:
-        fetch-depth: 0
-
-    - name: Install Node.js
-      uses: actions/setup-node@v4
-      with:
-        node-version: 22
-
-    - name: Configure Git
-      shell: bash
-      run: |
-        git config --global user.name "github-actions[bot]"
-        git config --global user.email "github-actions[bot]@users.noreply.github.com"
-
-    - name: Get existing version tag
-      id: get_version_old
-      shell: bash
-      run: |
-        set -x  # Enable debugging output
-        # Get the current commit hash
-        git rev-parse HEAD
-        COMMIT_HASH=$(git rev-parse HEAD)
-        echo "Current commit hash: $COMMIT_HASH"
-        
-        # Check for tags on the current commit
-        TAG=$(git tag --points-at $COMMIT_HASH | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+\$' || true)
-        echo "Tags found: $TAG"
-        
-        if [ -z "$TAG" ]; then
-          echo "No existing tag found on the current commit"
-        else
-          echo "Found existing tag: $TAG"
-          echo "version=$TAG" >> $GITHUB_OUTPUT
-        fi
-
-    - name: Set up minimal package.json
-      shell: bash
-      run: |
-        echo '{
-          "name": "temporary-lib",
-          "version": "0.0.0-release-it"
-        }' > package.json
-
-    - name: Install dependencies
-      shell: bash
-      run: npm install @release-it/conventional-changelog conventional-changelog-angular
-
-    - name: Get version
-      if: steps.get_version_old.outputs.version == ''
-      id: get_version_new
-      shell: bash
-      run: |
-        # Get version and filter out warnings
-        RAW_OUTPUT=$(npx release-it --ci --release-version 2>&1 || echo "")
-        # Extract just the version number (last line that looks like a version)
-        VERSION=$(echo "$RAW_OUTPUT" | grep -E '^[0-9]+\.[0-9]+\.[0-9]+' | tail -1 || true)
-
-        if [[ "$RAW_OUTPUT" == *"No new version to release"* || -z "$VERSION" ]]; then
-          echo "No new version to release"
-          echo "VERSION=" >> $GITHUB_ENV
-          echo "version=" >> $GITHUB_OUTPUT
-        else
-          echo "New version to release: $VERSION"
-          echo "VERSION=v$VERSION" >> $GITHUB_ENV
-          echo "version=v$VERSION" >> $GITHUB_OUTPUT
-        fi
-
-    - name: Set version output
-      id: set_version
-      shell: bash
-      run: |
-        if [ -n "${{ steps.get_version_old.outputs.version }}" ]; then
-          echo "Using old version: ${{ steps.get_version_old.outputs.version }}"
-          echo "version=${{ steps.get_version_old.outputs.version }}" >> $GITHUB_OUTPUT
-        elif [ -n "${{ steps.get_version_new.outputs.version }}" ]; then
-          echo "Using new version: ${{ steps.get_version_new.outputs.version }}"
-          echo "version=${{ steps.get_version_new.outputs.version }}" >> $GITHUB_OUTPUT
-        else
-          echo "No version determined"
-          echo "version=" >> $GITHUB_OUTPUT
-        fi
-
-    - name: Output version
-      shell: bash
-      run: |
-        echo "Version determined: ${{ steps.set_version.outputs.version }}"

package/.github/actions/create-pr/action.yml

@@ -1,122 +0,0 @@
-name: 'Create Pull Request'
-description: 'Create a pull request between source and target branches'
-author: 'Pipecraft'
-
-inputs:
-  sourceBranch:
-    description: 'Source branch for the PR'
-    required: true
-  targetBranch:
-    description: 'Target branch for the PR'
-    required: true
-  title:
-    description: 'Title for the PR'
-    required: true
-  body:
-    description: 'Body/description for the PR'
-    required: false
-  labels:
-    description: 'Comma-separated list of labels'
-    required: false
-  token:
-    description: 'GitHub token for authentication'
-    required: false
-    default: ${{ github.token }}
-
-outputs:
-  prNumber:
-    description: 'The created PR number'
-    value: ${{ steps.create-pr.outputs.prNumber }}
-  prUrl:
-    description: 'The created PR URL'
-    value: ${{ steps.create-pr.outputs.prUrl }}
-
-runs:
-  using: 'composite'
-  steps:
-    - name: Checkout Code
-      uses: actions/checkout@v4
-      with:
-        fetch-depth: 0
-        token: ${{ inputs.token }}
-
-    - name: Check if PR Already Exists
-      id: check-existing-pr
-      shell: bash
-      run: |
-        SOURCE="${{ inputs.sourceBranch }}"
-        TARGET="${{ inputs.targetBranch }}"
-        
-        # Check if PR already exists
-        EXISTING_PR=$(gh pr list --head "$SOURCE" --base "$TARGET" --json number --jq '.[0].number' 2>/dev/null || echo "")
-        
-        if [ -n "$EXISTING_PR" ]; then
-          echo "exists=true" >> $GITHUB_OUTPUT
-          echo "pr_number=$EXISTING_PR" >> $GITHUB_OUTPUT
-          echo "⚠️  PR already exists: #$EXISTING_PR"
-        else
-          echo "exists=false" >> $GITHUB_OUTPUT
-          echo "✅ No existing PR found"
-        fi
-
-    - name: Create Pull Request
-      if: steps.check-existing-pr.outputs.exists == 'false'
-      id: create-pr
-      shell: bash
-      run: |
-        SOURCE="${{ inputs.sourceBranch }}"
-        TARGET="${{ inputs.targetBranch }}"
-        TITLE="${{ inputs.title }}"
-        BODY="${{ inputs.body }}"
-        LABELS="${{ inputs.labels }}"
-        
-        # Prepare labels array
-        LABEL_ARGS=""
-        if [ -n "$LABELS" ]; then
-          IFS=',' read -ra LABEL_ARRAY <<< "$LABELS"
-          for label in "${LABEL_ARRAY[@]}"; do
-            LABEL_ARGS="$LABEL_ARGS --label \"${label// /}\""
-          done
-        fi
-        
-        # Create the PR
-        PR_OUTPUT=$(gh pr create \--title "$TITLE" \--body "$BODY" \--head "$SOURCE" \--base "$TARGET" \$LABEL_ARGS \--json number,url --jq '.number,.url' 2>&1)
-
-        if echo "$PR_OUTPUT" | grep -q '"number":'; then
-          PR_NUMBER=$(echo "$PR_OUTPUT" | jq -r '.number')
-          PR_URL=$(echo "$PR_OUTPUT" | jq -r '.url')
-          echo "prNumber=$PR_NUMBER" >> $GITHUB_OUTPUT
-          echo "prUrl=$PR_URL" >> $GITHUB_OUTPUT
-          echo "✅ Created PR #$PR_NUMBER"
-          echo "🔗 URL: $PR_URL"
-        else
-          echo "❌ Failed to create PR"
-          echo "Error output:"
-          echo "$PR_OUTPUT"
-          exit 1
-        fi
-
-    - name: Use Existing PR
-      if: steps.check-existing-pr.outputs.exists == 'true'
-      id: use-existing-pr
-      shell: bash
-      run: |
-        PR_NUMBER="${{ steps.check-existing-pr.outputs.pr_number }}"
-        PR_URL="https://github.com/${{ github.repository }}/pull/$PR_NUMBER"
-        echo "prNumber=$PR_NUMBER" >> $GITHUB_OUTPUT
-        echo "prUrl=$PR_URL" >> $GITHUB_OUTPUT
-        echo "✅ Using existing PR #$PR_NUMBER"
-        echo "🔗 URL: $PR_URL"
-
-    - name: Action Summary
-      shell: bash
-      run: |
-        if [ "${{ steps.create-pr.outputs.prNumber }}" != "" ]; then
-          echo "✅ Successfully created PR #${{ steps.create-pr.outputs.prNumber }}"
-          echo "🔗 URL: ${{ steps.create-pr.outputs.prUrl }}"
-        elif [ "${{ steps.use-existing-pr.outputs.prNumber }}" != "" ]; then
-          echo "ℹ️  Using existing PR #${{ steps.use-existing-pr.outputs.prNumber }}"
-          echo "🔗 URL: ${{ steps.use-existing-pr.outputs.prUrl }}"
-        else
-          echo "❌ No PR created or found"
-        fi