@amnesia2k/git-aic 2.1.0

package/dist/src/llm.js

@@ -0,0 +1,201 @@
+import axios from "axios";
+import chalk from "chalk";
+import { getStoredApiKey } from "./config.js";
+import { buildBatchDiffExplanationsPrompt, buildDiffExplanationPrompt, buildDiffFileNamePrompt, buildPrompt, } from "./prompt.js";
+const VALID_DIFF_FILE_TYPES = new Set([
+    "feat",
+    "fix",
+    "refactor",
+    "chore",
+    "docs",
+    "style",
+    "test",
+    "perf",
+    "bugfix",
+]);
+const API_URL = "https://generativelanguage.googleapis.com/v1/models/gemini-2.5-flash:generateContent";
+const MAX_RETRIES = 4;
+const getApiKey = () => process.env.GEMINI_COMMIT_MESSAGE_API_KEY || getStoredApiKey() || "";
+const ensureApiKey = () => {
+    const API_KEY = getApiKey();
+    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);
+    }
+    return API_KEY;
+};
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+const getOperationLabel = ({ operation, target }) => {
+    if (operation === "diff-filename") {
+        return "generating diff filename";
+    }
+    if (operation === "diff-explanations") {
+        return target
+            ? `generating diff explanations for ${target}`
+            : "generating diff explanations";
+    }
+    return "generating commit message";
+};
+const getFallbackLabel = ({ operation, target }) => {
+    if (operation === "diff-filename") {
+        return "using fallback filename";
+    }
+    if (operation === "diff-explanations") {
+        return target
+            ? `using fallback explanations for ${target}`
+            : "using fallback explanations";
+    }
+    return "using fallback commit message";
+};
+const isRetryableError = (error) => {
+    if (!axios.isAxiosError(error)) {
+        return false;
+    }
+    const status = error.response?.status;
+    if (status === 429) {
+        return true;
+    }
+    if (status && status >= 500) {
+        return true;
+    }
+    return [
+        "ECONNABORTED",
+        "ETIMEDOUT",
+        "ECONNRESET",
+        "ENOTFOUND",
+        "EAI_AGAIN",
+    ].includes(error.code || "");
+};
+const getRetryDelay = (error, attempt) => {
+    const retryAfterHeader = error.response?.headers?.["retry-after"];
+    if (typeof retryAfterHeader === "string") {
+        const retryAfterSeconds = Number(retryAfterHeader);
+        if (!Number.isNaN(retryAfterSeconds) && retryAfterSeconds > 0) {
+            return retryAfterSeconds * 1000;
+        }
+    }
+    return Math.min(750 * 2 ** (attempt - 1), 3000);
+};
+const requestText = async (prompt, fallback, context) => {
+    const API_KEY = ensureApiKey();
+    for (let attempt = 1; attempt <= MAX_RETRIES; attempt += 1) {
+        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()
+                ? response.data.candidates[0].content.parts[0].text.trim()
+                : fallback;
+        }
+        catch (error) {
+            if (axios.isAxiosError(error) && isRetryableError(error)) {
+                if (attempt < MAX_RETRIES) {
+                    const delay = getRetryDelay(error, attempt);
+                    const status = error.response?.status || error.code || "unknown";
+                    console.log(chalk.yellow(`Gemini request retry ${attempt}/${MAX_RETRIES - 1} while ${getOperationLabel(context)} (${status}). Waiting ${Math.ceil(delay / 1000)}s...`));
+                    await sleep(delay);
+                    continue;
+                }
+            }
+            const status = axios.isAxiosError(error)
+                ? error.response?.status || error.code || "request-error"
+                : "request-error";
+            console.log(chalk.yellow(`Gemini request failed while ${getOperationLabel(context)} (${status}); ${getFallbackLabel(context)}.`));
+            return fallback;
+        }
+    }
+    return fallback;
+};
+const sanitizeTopic = (value) => {
+    const sanitized = value
+        .trim()
+        .toLowerCase()
+        .replace(/\.md$/i, "")
+        .replace(/[^a-z0-9-]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "");
+    const tokens = sanitized.split("-").filter(Boolean).slice(0, 3);
+    return tokens.join("-");
+};
+const parseDiffFileName = (value) => {
+    const lines = value
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean);
+    const typeLine = lines.find((line) => /^type\s*:/i.test(line));
+    const topicLine = lines.find((line) => /^topic\s*:/i.test(line));
+    const rawType = typeLine
+        ?.replace(/^type\s*:/i, "")
+        .trim()
+        .toLowerCase() || "";
+    const rawTopic = topicLine?.replace(/^topic\s*:/i, "").trim() || "";
+    const type = VALID_DIFF_FILE_TYPES.has(rawType) ? rawType : "chore";
+    const topic = sanitizeTopic(rawTopic) || "changes";
+    return `${type}-${topic}`;
+};
+export const generateCommitMessage = async (rawDiff, branchName) => {
+    const prompt = buildPrompt(rawDiff, branchName);
+    return requestText(prompt, "chore: update code", {
+        operation: "commit-message",
+    });
+};
+export const generateDiffExplanation = async (filePath, rawDiff, branchName) => {
+    const prompt = buildDiffExplanationPrompt(filePath, rawDiff, branchName);
+    return requestText(prompt, `Updates ${filePath} with the selected changes shown below.`, {
+        operation: "diff-explanations",
+        target: filePath,
+    });
+};
+const parseBatchDiffExplanations = (value, filePaths) => {
+    const result = new Map();
+    const blockRegex = /FILE:\s*(.+?)\r?\nEXPLANATION:\s*([\s\S]*?)\r?\nEND_FILE/g;
+    let match;
+    while ((match = blockRegex.exec(value)) !== null) {
+        const filePath = match[1].trim();
+        const explanation = match[2].trim();
+        if (filePaths.includes(filePath) && explanation.length > 0) {
+            result.set(filePath, explanation);
+        }
+    }
+    return result;
+};
+export const generateDiffExplanations = async (fileDiffs, branchName) => {
+    const prompt = buildBatchDiffExplanationsPrompt(fileDiffs, branchName);
+    const response = await requestText(prompt, "", {
+        operation: "diff-explanations",
+        target: `${fileDiffs.length} files`,
+    });
+    const explanations = parseBatchDiffExplanations(response, fileDiffs.map(({ filePath }) => filePath));
+    if (explanations.size === fileDiffs.length) {
+        return explanations;
+    }
+    if (response.trim().length > 0) {
+        console.log(chalk.yellow("Gemini returned incomplete diff explanations; using fallback text for missing files."));
+    }
+    fileDiffs.forEach(({ filePath }) => {
+        if (!explanations.has(filePath)) {
+            explanations.set(filePath, `Updates ${filePath} with the selected changes shown below.`);
+        }
+    });
+    return explanations;
+};
+export const generateDiffFileName = async (rawDiff) => {
+    const prompt = buildDiffFileNamePrompt(rawDiff);
+    const rawName = await requestText(prompt, "type: chore\ntopic: changes", {
+        operation: "diff-filename",
+    });
+    return parseDiffFileName(rawName);
+};
+//# sourceMappingURL=llm.js.map

package/dist/src/llm.js.map

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

package/dist/src/prompt.d.ts

@@ -0,0 +1,7 @@
+export declare const buildPrompt: (diff: string, branchName: string) => string;
+export declare const buildDiffExplanationPrompt: (filePath: string, diff: string, branchName: string) => string;
+export declare const buildBatchDiffExplanationsPrompt: (fileDiffs: Array<{
+    filePath: string;
+    diff: string;
+}>, branchName: string) => string;
+export declare const buildDiffFileNamePrompt: (diff: string) => string;

package/dist/src/prompt.js

@@ -0,0 +1,127 @@
+export const buildPrompt = (diff, branchName) => `
+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>/<branch_name>): <description>
+   - type: MUST be one of: feat, fix, refactor, chore, docs, style, test, perf, bugfix
+   - scope: Should be the module/file affected (e.g., "auth", "api", "ui", "config", "feature")
+   - branch_name: The current Git branch you are on. It is "${branchName || "unknown"}"
+   - 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 the first line (the summary) under 72 characters total
+   - NO trailing punctuation on the summary line
+   - NO emojis ever
+   - MUST be a complete sentence
+   - Group related file changes together. If you change a service, controller, and route for the same feature (e.g. "auth"), summarize the collective change in just ONE line.
+   - Do NOT list every file that changed.
+
+3. MESSAGE STRUCTURE:
+   - The first line must be the summary: type(scope/${branchName || "unknown"}): description
+   - If there is ONLY ONE logical feature/fix being made (even if across multiple files), the commit message MUST BE EXACTLY ONE LINE. Do not use bullet points.
+   - ONLY if there are entirely UNRELATED distinct features changed at once, you may add a blank line after the summary, followed by a bulleted list summarizing those distinct features.
+   - Example 1 (Single logical change spanning multiple files): "feat(auth/${branchName || "unknown"}): implement jwt authentication flow"
+   - Example 2 (Unrelated distinct changes):
+feat(core/${branchName || "unknown"}): update foundational systems
+
+- handle null response in user endpoint
+- add rate limiting to requests
+
+4. QUALITY CHECKS - YOUR OUTPUT MUST PASS:
+   - Contains opening and closing parentheses
+   - Has a colon after the parentheses
+   - Description exists and is not empty
+   - Summary line 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();
+export const buildDiffExplanationPrompt = (filePath, diff, branchName) => `
+You are explaining a staged git diff to a developer.
+
+Rules:
+- Explain only the changes shown for this file
+- Write 2 to 4 short sentences
+- Be concrete and precise
+- Focus on what changed and why it matters
+- No markdown headings
+- No bullet points
+- No code fences
+- Do not restate the entire diff line by line
+- The current branch is "${branchName || "unknown"}"
+
+File:
+${filePath}
+
+Diff:
+${diff}
+
+Explanation:
+`.trim();
+export const buildBatchDiffExplanationsPrompt = (fileDiffs, branchName) => `
+You are explaining staged git diffs to a developer.
+
+Rules:
+- Write exactly one explanation block for each file shown below
+- Keep each explanation to 2 to 4 short sentences
+- Be concrete and precise
+- Focus on what changed and why it matters
+- No markdown headings
+- No bullet points
+- No code fences
+- Do not restate the diff line by line
+- Use the exact file path provided
+- Return blocks in this exact format:
+FILE: <exact file path>
+EXPLANATION: <plain text explanation>
+END_FILE
+- Return nothing except these blocks
+- The current branch is "${branchName || "unknown"}"
+
+Files and diffs:
+${fileDiffs
+    .map(({ filePath, diff }) => `
+FILE: ${filePath}
+DIFF:
+${diff}
+END_DIFF
+`.trim())
+    .join("\n\n")}
+
+Result:
+`.trim();
+export const buildDiffFileNamePrompt = (diff) => `
+Classify these staged changes and produce a concise structured filename basis.
+
+Rules:
+- Return exactly two lines and nothing else
+- First line format: type: <value>
+- Second line format: topic: <value>
+- type must be one of: feat, fix, refactor, chore, docs, style, test, perf, bugfix
+- topic must be 1 to 3 lowercase hyphen-separated words
+- topic must describe the actual change area
+- Do not include branch names
+- Do not include dates
+- Do not include the .md extension
+- Do not include quotes, markdown, bullets, or explanations
+- Avoid generic filler words like proposed, report, diff, and changes unless absolutely necessary
+
+Git diff:
+${diff}
+
+Result:
+`.trim();
+//# sourceMappingURL=prompt.js.map

package/dist/src/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/prompt.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,UAAkB,EAAU,EAAE,CACtE;;;;;;;8DAO4D,UAAU,IAAI,SAAS;;;;;;;;;;;;;;sDAc/B,UAAU,IAAI,SAAS;;;6EAGA,UAAU,IAAI,SAAS;;YAExF,UAAU,IAAI,SAAS;;;;;;;;;;;;;;;;;;;;;EAqBjC,IAAI;;;CAGL,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,QAAgB,EAChB,IAAY,EACZ,UAAkB,EACV,EAAE,CACV;;;;;;;;;;;;2BAYyB,UAAU,IAAI,SAAS;;;EAGhD,QAAQ;;;EAGR,IAAI;;;CAGL,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAC9C,SAAoD,EACpD,UAAkB,EACV,EAAE,CACV;;;;;;;;;;;;;;;;;;2BAkByB,UAAU,IAAI,SAAS;;;EAGhD,SAAS;KACR,GAAG,CACF,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACpB,QAAQ;;EAEd,IAAI;;CAEL,CAAC,IAAI,EAAE,CACL;KACA,IAAI,CAAC,MAAM,CAAC;;;CAGd,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,IAAY,EACJ,EAAE,CACV;;;;;;;;;;;;;;;;;EAiBA,IAAI;;;CAGL,CAAC,IAAI,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@amnesia2k/git-aic",
+  "type": "module",
+  "version": "2.1.0",
+  "description": "Git AIC",
+  "main": "dist/bin/cli.js",
+  "publishConfig": {
+    "access": "public"
+  },
+  "private": false,
+  "bin": {
+    "git-aic": "dist/bin/cli.js"
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "src/",
+    "README.md",
+    "package.json"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsx bin/cli.ts",
+    "commit": "tsx bin/cli.ts"
+  },
+  "keywords": [
+    "git",
+    "aic",
+    "ai",
+    "git-aic"
+  ],
+  "author": "Olatilewa Olatoye",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/conf": "^2.1.0",
+    "@types/node": "^25.5.0",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.1.0",
+    "axios": "^1.13.6",
+    "chalk": "^5.6.2",
+    "cli-loaders": "^3.0.0",
+    "commander": "^14.0.3",
+    "conf": "^15.1.0",
+    "simple-git": "^3.32.3"
+  }
+}

package/src/config.ts

@@ -0,0 +1,7 @@
+import Conf from "conf";
+
+// @ts-ignore
+export const config = new Conf({ projectName: "git-aic" });
+
+export const getStoredApiKey = () => config.get("apiKey") as string | undefined;
+export const setStoredApiKey = (key: string) => config.set("apiKey", key);

package/src/git.ts

@@ -0,0 +1,141 @@
+import { simpleGit } from "simple-git";
+import type { SimpleGit } from "simple-git";
+import { readFileSync } from "fs";
+
+const git: SimpleGit = simpleGit();
+
+export interface FileDiff {
+  filePath: string;
+  diff: string;
+}
+
+export interface HeadCommitInfo {
+  short: string;
+  full: string;
+}
+
+export const getGitDiff = async () => {
+  try {
+    await git.raw(["config", "core.autocrlf", "true"]);
+    const diff = await git.diff(["--cached", "--ignore-space-at-eol"]);
+    return diff || "";
+  } catch (error) {
+    console.error(error);
+    return "";
+  }
+};
+
+export const getBranchName = async () => {
+  try {
+    const status = await git.status();
+    return status.current || "";
+  } catch (error) {
+    console.error(error);
+    return "";
+  }
+};
+
+export const getStagedFileDiffs = async (): Promise<FileDiff[]> => {
+  try {
+    const status = await git.status();
+    const fileDiffs = await Promise.all(
+      status.staged.map(async (filePath) => {
+        const diff = await git.diff([
+          "--cached",
+          "--ignore-space-at-eol",
+          "--",
+          filePath,
+        ]);
+
+        return {
+          filePath,
+          diff: diff || "",
+        };
+      }),
+    );
+
+    return fileDiffs.filter((entry) => entry.diff.trim().length > 0);
+  } catch (error) {
+    console.error(error);
+    return [];
+  }
+};
+
+const createUntrackedFileDiff = (filePath: string) => {
+  try {
+    const contents = readFileSync(filePath, "utf8");
+    const lines = contents.split(/\r?\n/);
+    const body = lines.map((line) => `+${line}`).join("\n");
+
+    return [
+      `diff --git a/${filePath} b/${filePath}`,
+      "new file mode 100644",
+      "index 0000000..0000000",
+      "--- /dev/null",
+      `+++ b/${filePath}`,
+      `@@ -0,0 +1,${lines.length} @@`,
+      body,
+    ].join("\n");
+  } catch (error) {
+    console.error(error);
+    return "";
+  }
+};
+
+export const getSelectedFileDiffs = async (
+  filePaths: string[],
+): Promise<FileDiff[]> => {
+  try {
+    const status = await git.status();
+    const fileDiffs = await Promise.all(
+      filePaths.map(async (filePath) => {
+        if (status.not_added.includes(filePath)) {
+          return {
+            filePath,
+            diff: createUntrackedFileDiff(filePath),
+          };
+        }
+
+        const diff = await git.diff([
+          "HEAD",
+          "--ignore-space-at-eol",
+          "--",
+          filePath,
+        ]);
+
+        return {
+          filePath,
+          diff: diff || "",
+        };
+      }),
+    );
+
+    return fileDiffs.filter((entry) => entry.diff.trim().length > 0);
+  } catch (error) {
+    console.error(error);
+    return [];
+  }
+};
+
+export const getSelectedFilesDiff = async (filePaths: string[]) => {
+  const fileDiffs = await getSelectedFileDiffs(filePaths);
+  return fileDiffs.map(({ diff }) => diff).join("\n\n");
+};
+
+export const getHeadCommitInfo = async (): Promise<HeadCommitInfo> => {
+  try {
+    const full = (await git.revparse(["HEAD"])).trim();
+    const short = (await git.revparse(["--short", "HEAD"])).trim();
+
+    return {
+      short,
+      full,
+    };
+  } catch (error) {
+    console.error(error);
+    return {
+      short: "unknown",
+      full: "unknown",
+    };
+  }
+};