create-app-release 1.0.1 → 1.1.0

package/CHANGELOG.md

@@ -5,6 +5,27 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.0] - 2025-02-12
+
+### Added
+
+- Added support for multiple LLM providers:
+  - OpenAI models (default)
+  - Deepseek models
+  - QwenAI models
+  - Local LLM deployments
+- New command-line options for LLM configuration:
+  - `--openai-key`: Set API key directly
+  - `--openai-model`: Choose model (e.g., gpt-4o, deepseek-r1, qwen2.5)
+  - `--openai-base-url`: Set custom API base URL for different providers
+- Enhanced help information with detailed options and provider-specific examples
+
+## [1.0.2] - 2025-02-09
+
+### Changed
+
+- Added smart filtering to exclude PRs already included in previous releases
+
 ## [1.0.1] - 2025-02-07
 
 ### Changed

package/README.md

@@ -1,10 +1,18 @@
 # create-app-release
 
-An AI-powered GitHub release automation tool that helps you create release pull requests with automatically generated summaries using OpenAI's GPT-4 model. The tool intelligently groups your changes and creates professional release notes, making the release process smoother and more efficient.
+[![NPM Version](https://img.shields.io/npm/v/create-app-release.svg)](https://www.npmjs.com/package/create-app-release)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+An AI-powered GitHub release automation tool that helps you create release pull requests with automatically generated summaries using various LLM providers. The tool intelligently groups your changes and creates professional release notes, making the release process smoother and more efficient.
 
 ## Features
 
 - 🤖 AI-powered release notes generation using GPT-4
+- 🔄 Flexible LLM support:
+  - OpenAI models (GPT-4o, GPT-3.5-turbo)
+  - Deepseek models
+  - QwenAI models
+  - Local LLM deployments
 - 📦 Zero configuration - works right out of the box
 - 🔑 Secure token management through git config
 - 🎯 Interactive pull request selection
@@ -47,6 +55,38 @@ You'll need two tokens to use this tool:
 2. **OpenAI API Key** - Get from [OpenAI Platform](https://platform.openai.com/api-keys)
    - Will be stored in git config as `openai.token`
 
+### Command-Line Options
+
+Customize the tool's behavior using these command-line options:
+
+```bash
+# Set OpenAI API key directly (alternative to env/git config)
+--openai-key <key>
+
+# Choose OpenAI model (default: "gpt-4o")
+--openai-model <model>
+# Examples: gpt-4o, gpt-3.5-turbo, deepseek-r1, qwen2.5
+
+# Set custom OpenAI API base URL
+--openai-base-url <url>
+# Examples:
+# - Deepseek: https://api.deepseek.com/v1
+# - QwenAI: https://api.qwen.ai/v1
+# - Local: http://localhost:8000/v1
+# - Custom: https://custom-openai-endpoint.com/v1
+
+# Full example with different providers:
+
+# Using Deepseek
+npx create-app-release --openai-base-url https://api.deepseek.com/v1 --openai-key your_deepseek_key --openai-model deepseek-chat
+
+# Using QwenAI
+npx create-app-release --openai-base-url https://api.qwen.ai/v1 --openai-key your_qwen_key --openai-model qwen-14b-chat
+
+# Using Local LLM
+npx create-app-release --openai-base-url http://localhost:8000/v1 --openai-model local-model
+```
+
 ### Environment Variables (Optional)
 
 Tokens can also be provided via environment variables:
@@ -85,3 +125,7 @@ The tool generates professional release notes in this format:
 ## License
 
 MIT
+
+## Author
+
+[James Gordo](https://github.com/jamesgordo)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-app-release",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "AI-powered GitHub release automation tool",
   "main": "src/index.js",
   "type": "module",
@@ -27,6 +27,14 @@
   ],
   "author": "James Gordo",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jamesgordo/create-app-release.git"
+  },
+  "bugs": {
+    "url": "https://github.com/jamesgordo/create-app-release/issues"
+  },
+  "homepage": "https://github.com/jamesgordo/create-app-release#readme",
   "lint-staged": {
     "*.{js,jsx,ts,tsx}": [
       "eslint --fix",

package/src/index.js

@@ -18,6 +18,22 @@ const require = createRequire(import.meta.url);
 // Load environment variables
 config();
 
+// Setup graceful exit handlers
+process.stdin.setRawMode(true);
+process.stdin.resume();
+process.stdin.setEncoding('utf8');
+
+// Display exit instructions
+console.log(chalk.cyan('Press Ctrl+C or q to exit at any time'));
+
+process.stdin.on('data', (key) => {
+  // Ctrl+C or 'q' to exit
+  if (key === '\u0003' || key.toLowerCase() === 'q') {
+    console.log(chalk.yellow('\nExiting gracefully...'));
+    process.exit(0);
+  }
+});
+
 // Initialize CLI program
 const program = new Command();
 const pkg = require('../package.json');
@@ -106,17 +122,70 @@ async function initializeTokens() {
   return { githubToken, openaiToken };
 }
 
+/**
+ * Get the latest release pull request
+ * @param {string} owner - Repository owner
+ * @param {string} repo - Repository name
+ * @returns {Promise<Object|null>} Latest release PR or null
+ */
+async function getLatestReleasePR(owner, repo) {
+  try {
+    const iterator = octokit.paginate.iterator(octokit.rest.pulls.list, {
+      owner,
+      repo,
+      state: 'closed',
+      sort: 'updated',
+      direction: 'desc',
+      per_page: 100,
+    });
+
+    for await (const { data } of iterator) {
+      // SemVer regex pattern: matches X.Y.Z with optional pre-release and build metadata
+      const semverPattern =
+        /\b(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?\b/;
+
+      const recentReleasePR = data.find((pr) => semverPattern.test(pr.title));
+      if (recentReleasePR) {
+        return recentReleasePR;
+      }
+    }
+    return null;
+  } catch (error) {
+    console.error(chalk.red('Failed to fetch latest release PR:', error.message));
+    return null;
+  }
+}
+
+/**
+ * Extract PR numbers from release PR description
+ * @param {string} description - PR description
+ * @returns {Set<number>} Set of PR numbers
+ */
+function extractPRNumbersFromDescription(description) {
+  if (!description) return new Set();
+
+  // Match PR numbers in various formats like #123, (#123), or just plain 123 in PR lists
+  const prMatches = description.match(/#\d+|\(#\d+\)|(?<=PR:?\s*)\d+/g) || [];
+
+  return new Set(prMatches.map((match) => parseInt(match.replace(/[^0-9]/g, ''))));
+}
+
 /**
  * Fetch closed pull requests from the repository
  * @param {string} owner - Repository owner
  * @param {string} repo - Repository name
+ * @param {string} targetBranch - Target branch name
  * @returns {Promise<Array>} List of pull requests
  */
 async function fetchPullRequests(owner, repo) {
   const spinner = ora('Fetching pull requests...').start();
   try {
+    // Get the latest release PR first
+    const latestReleasePR = await getLatestReleasePR(owner, repo);
+
+    const includedPRNumbers = extractPRNumbersFromDescription(latestReleasePR?.body);
     const pulls = [];
-    const iterator = octokit.paginate.iterator(octokit.pulls.list, {
+    const iterator = octokit.paginate.iterator(octokit.rest.pulls.list, {
       owner,
       repo,
       state: 'closed',
@@ -126,9 +195,29 @@ async function fetchPullRequests(owner, repo) {
     });
 
     for await (const { data } of iterator) {
-      pulls.push(...data);
+      // Filter PRs that are merged after the last release and not included in it
+      const relevantPRs = data.filter((pr) => {
+        if (!pr.merged_at) return false;
+
+        const isAfterLastRelease = latestReleasePR
+          ? new Date(pr.merged_at) >= new Date(latestReleasePR.merged_at)
+          : true;
+
+        return (
+          isAfterLastRelease &&
+          !includedPRNumbers.has(`#${pr.number}`) &&
+          pr.id !== latestReleasePR?.id
+        );
+      });
+      pulls.push(...relevantPRs);
     }
-    spinner.succeed(`Found ${pulls.length} pull requests`);
+
+    const excludedCount = includedPRNumbers.size;
+    const message = latestReleasePR
+      ? `Found ${pulls.length} new merged pull requests (excluding ${excludedCount} PRs from last release)`
+      : `Found ${pulls.length} merged pull requests`;
+
+    spinner.succeed(message);
     return pulls;
   } catch (error) {
     spinner.fail('Failed to fetch pull requests');
@@ -167,8 +256,9 @@ ${JSON.stringify(prDetails, null, 2)}
 
 Keep the summary concise, clear, and focused on the user impact. Use professional but easy-to-understand language.`;
 
+    const model = program.opts().openaiModel || 'gpt-4o';
     const response = await openai.chat.completions.create({
-      model: 'gpt-4o',
+      model,
       messages: [{ role: 'user', content: prompt }],
       temperature: 0.7,
     });
@@ -268,8 +358,18 @@ ${summary}`;
 }
 
 async function run() {
-  // Initialize tokens sequentially
-  const { githubToken, openaiToken } = await initializeTokens();
+  // Get command line options
+  const options = program.opts();
+
+  // Initialize GitHub token
+  const { githubToken } = await initializeTokens();
+
+  // Get OpenAI token from command line or fallback to configuration
+  let openaiToken = options.openaiKey;
+  if (!openaiToken) {
+    const tokens = await initializeTokens();
+    openaiToken = tokens.openaiToken;
+  }
 
   // Initialize clients with tokens
   octokit = new Octokit({
@@ -278,6 +378,7 @@ async function run() {
 
   openai = new OpenAI({
     apiKey: openaiToken,
+    baseURL: options.openaiBaseUrl,
   });
 
   const { owner, repo } = await inquirer.prompt([
@@ -386,9 +487,30 @@ async function run() {
   }
 }
 
+const description = `AI-powered GitHub release automation tool
+
+Options:
+  --openai-key <key>        Set OpenAI API key directly (alternative to env/git config)
+  --openai-model <model>    Set OpenAI model to use (default: "gpt-4")
+                           Examples: gpt-4, gpt-3.5-turbo
+  --openai-base-url <url>   Set custom OpenAI API base URL
+                           Example: https://custom-openai-endpoint.com/v1
+
+Environment Variables:
+  GITHUB_TOKEN              GitHub personal access token
+  OPENAI_API_KEY            OpenAI API key (if not using --openai-key)
+
+Git Config:
+  github.token              GitHub token in git config
+  openai.token              OpenAI token in git config (if not using --openai-key)
+`;
+
 program
   .name('create-app-release')
-  .description('AI-powered GitHub release automation tool')
+  .description(description)
   .version(pkg.version)
+  .option('--openai-base-url <url>', 'Set custom OpenAI API base URL')
+  .option('--openai-model <model>', 'Set OpenAI model to use (default: "gpt-4")')
+  .option('--openai-key <key>', 'Set OpenAI API key directly (alternative to env/git config)')
   .action(run)
   .parse(process.argv);