git-aic 1.0.0

package/dist/cli.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { simpleGit } from "simple-git";
+import chalk from "chalk";
+import { getGitDiff } from "./git.js";
+import { generateCommitMessage } from "./llm.js";
+import { getUserConfirmation } from "./confirm.js";
+const git = simpleGit();
+const program = new Command();
+program
+    .name("commit")
+    .description("AI-powered Git commit generator using Google Gemini")
+    .version("1.0.0")
+    .option("-p, --push", "push after committing");
+program.action(async (options) => {
+    try {
+        const diff = await getGitDiff();
+        if (!diff) {
+            console.log(chalk.yellow("No changes to commit!"));
+            process.exit(0);
+        }
+        const status = await git.status();
+        console.log(chalk.blue("\nFiles being committed:"));
+        status.staged.forEach((file) => console.log(chalk.cyan(`- ${file}`)));
+        console.log("");
+        let currentMessage = "";
+        let confirmed = false;
+        console.log(chalk.blue("Analyzing staged changes...\n"));
+        while (!confirmed) {
+            currentMessage = await generateCommitMessage(diff);
+            const { choice, message } = await getUserConfirmation(currentMessage);
+            if (choice === 'y') {
+                currentMessage = message;
+                confirmed = true;
+            }
+            else if (choice === 'r') {
+                console.log(chalk.yellow("Regenerating...\n"));
+                continue;
+            }
+            else {
+                console.log(chalk.red("Aborted."));
+                process.exit(0);
+            }
+        }
+        console.log(chalk.blue(`> ran: git commit -m "${currentMessage}"`));
+        await git.commit(currentMessage);
+        console.log(chalk.green("\nCommit successful"));
+        if (options.push) {
+            console.log(chalk.blue("> ran: git push"));
+            await git.push();
+            console.log(chalk.green("Push successful"));
+        }
+    }
+    catch (error) {
+        console.error(chalk.red("\nCommit failed:"), error);
+        process.exit(1);
+    }
+});
+program.parse(process.argv);

package/dist/confirm.js

@@ -0,0 +1,25 @@
+import readline from "node:readline/promises";
+import chalk from "chalk";
+export const getUserConfirmation = async (message) => {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    console.log(chalk.green(`\nProposed: "${message}"`));
+    const answer = await rl.question(chalk.blue('Confirm commit? [y=yes, n=no, r=retry, e=edit]: '));
+    rl.close();
+    const choice = (answer.toLowerCase() || 'y').trim();
+    if (choice === 'e') {
+        const editRl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            terminal: true
+        });
+        console.log(chalk.cyan("\nEdit the message:"));
+        editRl.write(message);
+        const editedMessage = await editRl.question("> ");
+        editRl.close();
+        return { choice: 'y', message: editedMessage };
+    }
+    return { choice, message };
+};

package/dist/git.js

@@ -0,0 +1,20 @@
+import { simpleGit } from "simple-git";
+const git = simpleGit();
+export const getGitDiff = async () => {
+    try {
+        await git.raw(["config", "core.autocrlf", "true"]);
+        let diff = await git.diff(["--cached", "--ignore-space-at-eol"]);
+        if (!diff) {
+            console.log("No staged changes detected. Auto-staging all files...");
+            await git.add(".");
+            diff = await git.diff(["--cached", "--ignore-space-at-eol"]);
+            if (!diff)
+                return "";
+        }
+        return diff;
+    }
+    catch (error) {
+        console.error(error);
+        return "";
+    }
+};

package/dist/llm.js

@@ -0,0 +1,49 @@
+import axios from "axios";
+import chalk from "chalk";
+import { buildPrompt } from "./prompt.js";
+export const generateCommitMessage = async (rawDiff) => {
+    const API_URL = "https://generativelanguage.googleapis.com/v1/models/gemini-2.5-flash:generateContent";
+    const API_KEY = process.env.GEMINI_COMMIT_MESSAGE_API_KEY;
+    if (!API_KEY) {
+        console.error(chalk.red("\nMissing GEMINI_COMMIT_MESSAGE_API_KEY environment variable.\n"));
+        console.log("Please set your API key before running this command.\n");
+        console.log(chalk.yellow("How to fix this:\n"));
+        console.log(chalk.cyan("macOS / Linux:"));
+        console.log("  export GEMINI_COMMIT_MESSAGE_API_KEY=your_api_key_here\n");
+        console.log(chalk.cyan("Windows (PowerShell):"));
+        console.log('  setx GEMINI_COMMIT_MESSAGE_API_KEY "your_api_key_here"\n');
+        console.log(chalk.gray("After setting the variable, restart your terminal.\n"));
+        process.exit(1);
+    }
+    const prompt = buildPrompt(rawDiff);
+    try {
+        const response = await axios.post(API_URL, {
+            contents: [{ parts: [{ text: prompt }] }],
+        }, {
+            headers: {
+                "Content-Type": "application/json",
+                "x-goog-api-key": API_KEY,
+            },
+        });
+        return (response.data.candidates?.[0]?.content?.parts?.[0]?.text?.trim() ||
+            "chore: update code");
+    }
+    catch (error) {
+        if (axios.isAxiosError(error)) {
+            if (error.response) {
+                const apiMessage = error.response.data?.error?.message || error.message;
+                console.error(chalk.red(`LLM request failed: ${apiMessage}`));
+            }
+            else if (error.request) {
+                console.error(chalk.red("Network error: Could not connect to Google API. Check your internet."));
+            }
+            else {
+                console.error(chalk.red(`An unknown error occurred during the LLM request: ${error.message}`));
+            }
+        }
+        else {
+            console.error(chalk.red("Unexpected Error:"), error);
+        }
+        return "chore: update code";
+    }
+};

package/dist/prompt.js

@@ -0,0 +1,44 @@
+export const buildPrompt = (diff) => `
+CRITICAL INSTRUCTIONS - READ CAREFULLY:
+You are an expert Git commit message writer. You MUST follow ALL these rules:
+
+1. FORMAT: Use Conventional Commits format: <type>(<scope>): <description>
+   - type: MUST be one of: feat, fix, refactor, chore, docs, style, test, perf
+   - scope: Should be the module/file affected (e.g., "auth", "api", "ui", "config")
+   - description: Clear, imperative description in present tense
+
+2. DESCRIPTION REQUIREMENTS:
+   - Start with an imperative verb (add, fix, remove, update, refactor, etc.)
+   - Be specific about what changed
+   - Keep it under 72 characters total (including type and scope)
+   - NO trailing punctuation
+   - NO emojis ever
+   - MUST be a complete sentence
+
+3. MESSAGE STRUCTURE:
+   - The entire commit message must be exactly one line
+   - Format: type(scope): description
+   - Example: "feat(auth): add password reset functionality"
+   - Example: "fix(api): handle null response in user endpoint"
+   - Example: "refactor(ui): simplify component state management"
+
+4. QUALITY CHECKS - YOUR OUTPUT MUST PASS:
+   - Contains opening and closing parentheses
+   - Has a colon after the parentheses
+   - Description exists and is not empty
+   - Total length ≤ 72 characters
+   - No markdown formatting
+   - No code blocks
+   - No explanations or notes
+
+5. FAILURE MODE:
+   - If you cannot generate a proper message, return exactly: "chore: update code"
+
+YOUR TASK:
+Analyze this git diff and generate exactly ONE proper commit message following all rules above.
+
+Git diff:
+${diff}
+
+Commit message:
+`.trim();

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "git-aic",
+  "version": "1.0.0",
+  "description": "AI-powered Git commit generator using Google Gemini",
+  "homepage": "https://github.com/samueltuoyo15/Commit-Message-Tool/tree/#readme",
+  "bugs": {
+    "url": "https://github.com/samueltuoyo15/Commit-Message-Tool/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/samueltuoyo15/Commit-Message-Tool.git"
+  },
+  "license": "ISC",
+  "author": "Spectra010s",
+  "type": "module",
+  "main": "./dist/cli.js",
+  "bin": {
+    "git-aic": "./dist/cli.js"
+  },
+    "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "commit message tool",
+    "git",
+    "git-plugin",
+    "git-aic",
+    "automated-commits",
+    "ai-commits",
+    "gemini"
+  ],
+  "dependencies": {
+    "axios": "^1.13.2",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.2",
+    "simple-git": "^3.30.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "typescript": "^5.9.3"
+  }
+}