gitpal-harshit 1.0.0

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "gitpal-harshit",
+  "version": "1.0.0",
+  "description": "AI-powered Git assistant CLI",
+  "main": "src/index.js",
+  "bin": {
+    "gitpal": "./bin/gitpal.js"
+  },
+  "scripts": {
+    "test": "node --experimental-vm-modules node_modules/.bin/jest"
+  },
+  "keywords": [
+    "git",
+    "cli",
+    "ai",
+    "automation"
+  ],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0",
+    "dotenv": "^16.3.1",
+    "inquirer": "^9.2.12",
+    "node-fetch": "^3.3.2",
+    "ora": "^7.0.1",
+    "simple-git": "^3.21.0"
+  },
+  "type": "module"
+}

package/src/ai.js

@@ -0,0 +1,110 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+// Config file stored in user's home directory
+const CONFIG_PATH = path.join(os.homedir(), '.gitpal.json');
+
+export function loadConfig() {
+  if (!fs.existsSync(CONFIG_PATH)) return {};
+  return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
+}
+
+export function saveConfig(config) {
+  fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));
+}
+
+// ─── AI PROVIDER ROUTER ───────────────────────────────────────────────────────
+// All providers receive the same prompt and return a plain string response.
+// Adding a new provider = add one function + one case below.
+
+async function callAnthropic(prompt, apiKey) {
+  const res = await fetch('https://api.anthropic.com/v1/messages', {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      'x-api-key': apiKey,
+      'anthropic-version': '2023-06-01',
+    },
+    body: JSON.stringify({
+      model: 'claude-3-haiku-20240307',
+      max_tokens: 500,
+      messages: [{ role: 'user', content: prompt }],
+    }),
+  });
+  const data = await res.json();
+  if (!res.ok) throw new Error(data.error?.message || 'Anthropic API error');
+  return data.content[0].text.trim();
+}
+
+async function callOpenAI(prompt, apiKey) {
+  const res = await fetch('https://api.openai.com/v1/chat/completions', {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      Authorization: `Bearer ${apiKey}`,
+    },
+    body: JSON.stringify({
+      model: 'gpt-3.5-turbo',
+      max_tokens: 500,
+      messages: [{ role: 'user', content: prompt }],
+    }),
+  });
+  const data = await res.json();
+  if (!res.ok) throw new Error(data.error?.message || 'OpenAI API error');
+  return data.choices[0].message.content.trim();
+}
+
+async function callGemini(prompt, apiKey) {
+  const url = `https://generativelanguage.googleapis.com/v1beta/models/gemini-pro:generateContent?key=${apiKey}`;
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({
+      contents: [{ parts: [{ text: prompt }] }],
+    }),
+  });
+  const data = await res.json();
+  if (!res.ok) throw new Error(data.error?.message || 'Gemini API error');
+  return data.candidates[0].content.parts[0].text.trim();
+}
+
+async function callGroq(prompt, apiKey) {
+  const res = await fetch('https://api.groq.com/openai/v1/chat/completions', {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      Authorization: `Bearer ${apiKey}`,
+    },
+    body: JSON.stringify({
+      model: 'llama-3.3-70b-versatile',
+      max_tokens: 500,
+      messages: [{ role: 'user', content: prompt }],
+    }),
+  });
+  const data = await res.json();
+  if (!res.ok) throw new Error(data.error?.message || 'Groq API error');
+  return data.choices[0].message.content.trim();
+}
+
+// ─── MAIN EXPORT ─────────────────────────────────────────────────────────────
+
+export async function askAI(prompt) {
+  const config = loadConfig();
+
+  const provider = config.provider;
+  const apiKey = config.apiKey;
+
+  if (!provider || !apiKey) {
+    throw new Error('No AI provider configured. Run: gitpal config');
+  }
+
+  switch (provider) {
+    case 'anthropic': return callAnthropic(prompt, apiKey);
+    case 'openai':    return callOpenAI(prompt, apiKey);
+    case 'gemini':    return callGemini(prompt, apiKey);
+    case 'groq':      return callGroq(prompt, apiKey);
+    default:
+      throw new Error(`Unknown provider "${provider}". Run: gitpal config`);
+  }
+}

package/src/commands/changelog.js

@@ -0,0 +1,66 @@
+import chalk from "chalk";
+import ora from "ora";
+import { getRecentCommits, isGitRepo } from "../git.js";
+import { askAI } from "../ai.js";
+
+export async function changelogCommand(options) {
+  if (!(await isGitRepo())) {
+    console.log(chalk.red("❌ Not a git repository."));
+    process.exit(1);
+  }
+
+  const version = options.ver || "1.0.0";
+  const n = options.last || 20;
+
+  const spinner = ora(`Fetching last ${n} commits for changelog...`).start();
+  const commits = await getRecentCommits(n);
+
+  if (!commits.length) {
+    spinner.fail("No commits found.");
+    process.exit(1);
+  }
+  spinner.succeed(`Found ${commits.length} commits.`);
+
+  const aiSpinner = ora("Generating changelog with AI...").start();
+
+  const date = new Date().toISOString().split("T")[0];
+
+  const prompt = `Generate a professional CHANGELOG entry from these git commits.
+
+Format exactly like this:
+## [${version}] - ${date}
+
+### Features
+- (new features added)
+
+### Bug Fixes
+- (bugs fixed)
+
+### Improvements
+- (improvements/refactors)
+
+### Documentation
+- (doc changes if any)
+
+Rules:
+- Only include sections that have relevant commits
+- Be concise and user-friendly
+- Skip merge commits
+- Group similar changes
+
+Commits:
+${commits.join("\n")}`;
+
+  try {
+    const changelog = await askAI(prompt);
+    aiSpinner.succeed("Changelog ready!\n");
+
+    console.log(chalk.bold(`📄 CHANGELOG v${version}:\n`));
+    console.log(chalk.white(changelog));
+    console.log("");
+    console.log(chalk.dim("💡 Add this to your CHANGELOG.md file."));
+  } catch (err) {
+    aiSpinner.fail(chalk.red(`AI Error: ${err.message}`));
+    process.exit(1);
+  }
+}

package/src/commands/commit.js

@@ -0,0 +1,91 @@
+import chalk from "chalk";
+import ora from "ora";
+import inquirer from "inquirer";
+import { getStagedDiff, doCommit, isGitRepo } from "../git.js";
+import { askAI } from "../ai.js";
+
+export async function commitCommand(options) {
+  // 1. Guard: must be inside a git repo
+  if (!(await isGitRepo())) {
+    console.log(chalk.red("❌ Not a git repository."));
+    process.exit(1);
+  }
+
+  // 2. Get staged diff
+  const spinner = ora("Reading your staged changes...").start();
+  const diff = await getStagedDiff();
+
+  if (!diff || diff.trim() === "") {
+    spinner.fail(chalk.yellow("No staged changes found. Run: git add <files>"));
+    process.exit(1);
+  }
+  spinner.succeed("Staged changes found.");
+
+  // 3. Ask AI to generate commit message
+  const aiSpinner = ora("Generating commit message with AI...").start();
+
+  const prompt = `You are an expert developer. Analyze this git diff and write a concise, conventional commit message.
+
+Rules:
+- Use conventional commits format: type(scope): description
+- Types: feat, fix, docs, style, refactor, test, chore
+- Keep it under 72 characters
+- Be specific about what changed
+- Return ONLY the commit message, nothing else
+
+Git Diff:
+${diff.slice(0, 3000)}`; // Limit diff size to avoid token limits
+
+  let message;
+  try {
+    message = await askAI(prompt);
+    aiSpinner.succeed(chalk.green("Commit message generated!"));
+  } catch (err) {
+    aiSpinner.fail(chalk.red(`AI Error: ${err.message}`));
+    process.exit(1);
+  }
+
+  // 4. Show the message
+  console.log("\n" + chalk.bold("Suggested commit message:"));
+  console.log(chalk.cyan(`  ${message}\n`));
+
+  // 5. Confirm or skip
+  if (options.yes) {
+    await doCommit(message);
+    console.log(chalk.green.bold("✅ Committed successfully!"));
+    return;
+  }
+
+  const { action } = await inquirer.prompt([
+    {
+      type: "list",
+      name: "action",
+      message: "What would you like to do?",
+      choices: [
+        { name: "✅ Use this message and commit", value: "commit" },
+        { name: "✏️  Edit the message", value: "edit" },
+        { name: "❌ Cancel", value: "cancel" },
+      ],
+    },
+  ]);
+
+  if (action === "cancel") {
+    console.log(chalk.yellow("Cancelled."));
+    return;
+  }
+
+  if (action === "edit") {
+    const { edited } = await inquirer.prompt([
+      {
+        type: "input",
+        name: "edited",
+        message: "Edit commit message:",
+        default: message,
+      },
+    ]);
+    message = edited;
+  }
+
+  await doCommit(message);
+  console.log(chalk.green.bold("\n✅ Committed successfully!"));
+}

package/src/commands/config.js

@@ -0,0 +1,81 @@
+import chalk from "chalk";
+import inquirer from "inquirer";
+import { loadConfig, saveConfig } from "../ai.js";
+
+const PROVIDERS = {
+  anthropic: {
+    label: "Anthropic (Claude) — claude-3-haiku",
+    keyHint: "Get free credits at console.anthropic.com",
+  },
+  openai: {
+    label: "OpenAI (GPT-3.5) — gpt-3.5-turbo",
+    keyHint: "Get API key at platform.openai.com",
+  },
+  gemini: {
+    label: "Google Gemini — gemini-pro (Free tier)",
+    keyHint: "Get free API key at aistudio.google.com",
+  },
+  groq: {
+    label: "Groq — llama3-8b (Free & Ultra Fast)",
+    keyHint: "Get free API key at console.groq.com",
+  },
+};
+
+export async function configCommand() {
+  const existing = loadConfig();
+
+  console.log(chalk.bold("\n⚙️  GitPal Configuration\n"));
+
+  if (existing.provider) {
+    console.log(chalk.dim(`Current provider: ${existing.provider}`));
+    console.log(
+      chalk.dim(`Current API key: ${existing.apiKey?.slice(0, 8)}...\n`),
+    );
+  }
+
+  const { provider } = await inquirer.prompt([
+    {
+      type: "list",
+      name: "provider",
+      message: "Choose your AI provider:",
+      choices: Object.entries(PROVIDERS).map(([value, { label }]) => ({
+        name: label,
+        value,
+      })),
+      default: existing.provider,
+    },
+  ]);
+
+  const hint = PROVIDERS[provider].keyHint;
+  console.log(chalk.dim(`\n💡 ${hint}\n`));
+
+  const { apiKey } = await inquirer.prompt([
+    {
+      type: "password",
+      name: "apiKey",
+      message: `Enter your ${provider} API key:`,
+      mask: "*",
+      validate: (val) => val.trim().length > 0 || "API key cannot be empty",
+    },
+  ]);
+
+  saveConfig({ provider, apiKey: apiKey.trim() });
+
+  console.log(chalk.green.bold("\n✅ Configuration saved!"));
+  console.log(chalk.dim("Config stored at: ~/.gitpal.json\n"));
+  console.log(chalk.white("You can now run:"));
+  console.log(
+    chalk.cyan("  gitpal commit     ") + chalk.dim("— auto commit message"),
+  );
+  console.log(
+    chalk.cyan("  gitpal summary    ") +
+      chalk.dim("— summarize recent commits"),
+  );
+  console.log(
+    chalk.cyan("  gitpal pr         ") + chalk.dim("— generate PR description"),
+  );
+  console.log(
+    chalk.cyan("  gitpal changelog  ") + chalk.dim("— generate changelog"),
+  );
+  console.log("");
+}

package/src/commands/pr.js

@@ -0,0 +1,72 @@
+import chalk from "chalk";
+import ora from "ora";
+import { getBranchDiff, getCurrentBranch, isGitRepo } from "../git.js";
+import { askAI } from "../ai.js";
+
+export async function prCommand(options) {
+  if (!(await isGitRepo())) {
+    console.log(chalk.red("❌ Not a git repository."));
+    process.exit(1);
+  }
+
+  const baseBranch = options.base || "main";
+  const currentBranch = await getCurrentBranch();
+
+  console.log(
+    chalk.dim(
+      `Comparing ${chalk.cyan(currentBranch)} → ${chalk.cyan(baseBranch)}\n`,
+    ),
+  );
+
+  const spinner = ora("Reading branch diff...").start();
+  let diff;
+  try {
+    diff = await getBranchDiff(baseBranch);
+  } catch {
+    spinner.fail(
+      `Could not diff against "${baseBranch}". Is the branch name correct?`,
+    );
+    process.exit(1);
+  }
+
+  if (!diff || diff.trim() === "") {
+    spinner.warn("No differences found between branches.");
+    process.exit(0);
+  }
+  spinner.succeed("Diff ready.");
+
+  const aiSpinner = ora("Generating PR description with AI...").start();
+
+  const prompt = `You are a senior developer. Write a professional GitHub Pull Request description based on this git diff.
+
+Format it exactly like this:
+## What changed
+(bullet points of main changes)
+
+## Why
+(brief reason for the change)
+
+## Type of change
+(Bug fix / New feature / Refactor / Documentation)
+
+## Testing
+(what to test or how it was tested)
+
+Git Diff:
+${diff.slice(0, 4000)}`;
+
+  try {
+    const prDesc = await askAI(prompt);
+    aiSpinner.succeed("PR description ready!\n");
+
+    console.log(chalk.bold("📝 Pull Request Description:\n"));
+    console.log(chalk.white(prDesc));
+    console.log("");
+    console.log(
+      chalk.dim("💡 Copy the above and paste into your GitHub PR description."),
+    );
+  } catch (err) {
+    aiSpinner.fail(chalk.red(`AI Error: ${err.message}`));
+    process.exit(1);
+  }
+}

package/src/commands/summary.js

@@ -0,0 +1,46 @@
+import chalk from "chalk";
+import ora from "ora";
+import { getRecentCommits, isGitRepo } from "../git.js";
+import { askAI } from "../ai.js";
+
+export async function summaryCommand(options) {
+  if (!(await isGitRepo())) {
+    console.log(chalk.red("❌ Not a git repository."));
+    process.exit(1);
+  }
+
+  const n = options.last || 5;
+  const spinner = ora(`Fetching last ${n} commits...`).start();
+  const commits = await getRecentCommits(n);
+
+  if (!commits.length) {
+    spinner.fail("No commits found.");
+    process.exit(1);
+  }
+  spinner.succeed(`Found ${commits.length} commits.`);
+
+  const aiSpinner = ora("Generating summary with AI...").start();
+
+  const prompt = `Summarize these git commits in plain English for a developer.
+  
+Rules:
+- Group related changes together
+- Use bullet points
+- Be concise but informative
+- Highlight the most important changes
+- Use past tense
+
+Commits:
+${commits.join("\n")}`;
+
+  try {
+    const summary = await askAI(prompt);
+    aiSpinner.succeed("Summary ready!\n");
+    console.log(chalk.bold(`📋 Summary of last ${n} commits:\n`));
+    console.log(chalk.white(summary));
+    console.log("");
+  } catch (err) {
+    aiSpinner.fail(chalk.red(`AI Error: ${err.message}`));
+    process.exit(1);
+  }
+}

package/src/git.js

@@ -0,0 +1,43 @@
+import simpleGit from 'simple-git';
+
+const git = simpleGit();
+
+// Get staged diff (what you've git add-ed)
+export async function getStagedDiff() {
+  const diff = await git.diff(['--staged']);
+  return diff;
+}
+
+// Get diff between current branch and base branch
+export async function getBranchDiff(baseBranch = 'main') {
+  const currentBranch = await getCurrentBranch();
+  const diff = await git.diff([`${baseBranch}...${currentBranch}`]);
+  return diff;
+}
+
+// Get last N commit messages
+export async function getRecentCommits(n = 5) {
+  const log = await git.log({ maxCount: parseInt(n) });
+  return log.all.map(c => `${c.hash.slice(0, 7)} ${c.message}`);
+}
+
+// Get current branch name
+export async function getCurrentBranch() {
+  const status = await git.status();
+  return status.current;
+}
+
+// Do the actual commit
+export async function doCommit(message) {
+  await git.commit(message);
+}
+
+// Check if we're inside a git repo
+export async function isGitRepo() {
+  try {
+    await git.status();
+    return true;
+  } catch {
+    return false;
+  }
+}

package/src/index.js

@@ -0,0 +1,54 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { commitCommand } from './commands/commit.js';
+import { summaryCommand } from './commands/summary.js';
+import { prCommand } from './commands/pr.js';
+import { changelogCommand } from './commands/changelog.js';
+import { configCommand } from './commands/config.js';
+
+const program = new Command();
+
+console.log(chalk.cyan.bold('\n🤖 GitPal — Your AI Git Assistant\n'));
+
+program
+  .name('gitpal')
+  .description('AI-powered Git CLI — commit messages, PR descriptions, summaries & changelogs')
+  .version('1.0.0');
+
+program
+  .command('commit')
+  .description('Auto-generate a commit message from your staged changes')
+  .option('-y, --yes', 'Skip confirmation and commit directly')
+  .action(commitCommand);
+
+program
+  .command('summary')
+  .description('Summarize recent commits in plain English')
+  .option('-n, --last <number>', 'Number of commits to summarize', '5')
+  .action(summaryCommand);
+
+program
+  .command('pr')
+  .description('Generate a pull request description from branch diff')
+  .option('-b, --base <branch>', 'Base branch to compare against', 'main')
+  .option('-c, --copy', 'Copy output to clipboard')
+  .action(prCommand);
+
+program
+  .command('changelog')
+  .description('Generate a changelog from commit history')
+  .option('-v, --ver <version>', 'Version number for changelog', '1.0.0')
+  .option('-n, --last <number>', 'Number of commits to include', '20')
+  .action(changelogCommand);
+
+program
+  .command('config')
+  .description('Configure your AI provider and API key')
+  .action(configCommand);
+
+program.parse(process.argv);
+
+// Show help if no command given
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+}