gennady 0.1.0

package/.nvmrc

@@ -0,0 +1 @@
+22

package/README.md

@@ -0,0 +1,35 @@
+🤖 Gennadyᵇᵉᵗᵃ 🗯️
+-----------------
+**Gen**erate **N**ext-level **A**utomated **D**escription **Y**ntelligence.
+
+```bash
+npx gennady
+```
+
+---
+
+### Setup Local LLM
+
+```sh
+brew install ollama
+ollama pull llama3:8b
+ollama serve
+```
+
+---
+
+### Usage
+
+```bash
+# Basic usage
+npx gennady
+
+# Generate oneline commit message
+npx gennady --mode=oneline
+
+# Generate detailed commit message
+npx gennady --mode=detailed
+
+# Generate detailed commit message relative to the target branch
+npx gennady --branch=develop
+```

package/cli/gennady.js

@@ -0,0 +1,33 @@
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { CommitGen } from '../src/commit-gen/commit-gen.js';
+import { parseArgs } from '../src/utils/parse-args.js';
+import { style } from '../src/utils/style.js';
+
+const PROMPTS_DIR = join(
+	typeof __dirname !== 'string' ? dirname(fileURLToPath(import.meta.url)) : __dirname,
+	'../src/prompts',
+);
+
+const params = parseArgs(process.argv, {
+	mode: ['mode', 'm'],
+	reviewerModel: ['model'],
+	targetBranch: ['branch', 'b'],
+});
+
+const commit = new CommitGen({
+	...params,
+	onelinePromptTemplate: readFileSync(join(PROMPTS_DIR, 'oneline-prompt.md')).toString(),
+	detailedPromptTemplate: readFileSync(join(PROMPTS_DIR, 'detailed-prompt.md')).toString(),
+	composerPromptTemplate: readFileSync(join(PROMPTS_DIR, 'composer-prompt.md')).toString(),
+});
+
+console.info(`🤖`, style.whiteBright.bold(`GENNADY`), `(${style.cyan(commit.reviewerModel)} → ${style.yellow(commit.mode)})`, `🗯️`);
+console.info(style.gray(`-`.repeat(30)));
+
+const msg = await commit.generate();
+
+console.info(`-`.repeat(40), '\n');
+console.info(style.whiteBright(msg), '\n');
+console.info(`^`.repeat(40), '\n');

package/index.js

@@ -0,0 +1 @@
+export * from './src/commit-gen/commit-gen.js';

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "gennady",
+  "version": "0.1.0",
+  "author": "Konstantin Lebedev <ibnrubaxa@gmail.com>",
+  "description": "Gennady — Generate Next-level Automated Description Intelligence",
+  "keywords": [
+    "git",
+    "ai",
+    "llm",
+    "commit",
+    "generator"
+  ],
+  "license": "MIT",
+  "repository": "https://github.com/rubaxa/commit-gen",
+  "type": "module",
+  "bin": {
+    "gennady": "./cli/gennady.js",
+    "gennadi": "./cli/gennady.js"
+  },
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  }
+}

package/src/commit-gen/commit-gen.js

@@ -0,0 +1,220 @@
+import { execSync as nodeExecSync } from 'node:child_process';
+import { style } from '../utils/style.js';
+
+export class CommitGen {
+	constructor(init) {
+		this.init = {
+			mode: 'auto',
+			reviewerModel: 'llama3:8b',
+			targetBranch: undefined,
+			onelinePromptTemplate: 'Oneline commit: {diff}',
+			detailedPromptTemplate: 'Detailed commit: {diff}',
+			composerPromptTemplate: 'Compose final commit message from parts: {messages}',
+
+			maxInputTokens: init.maxInputTokens || 5000,
+			ollamaUrl: init.ollamaUrl || 'http://127.0.0.1:11434/api/generate',
+			logger: console,
+
+			...init,
+		};
+	}
+
+	get logger() {
+		return this.init.logger;
+	}
+
+	get mode() {
+		return this.init.mode;
+	}
+
+	get reviewerModel() {
+		return this.init.reviewerModel;
+	}
+
+	get targetBranch() {
+		return this.init.targetBranch;
+	}
+
+	execSync(cmd) {
+		try {
+			return nodeExecSync(cmd, { encoding: 'utf-8'});
+		} catch (e) {
+			return '';
+		}
+	}
+
+	getCommitCount() {
+		const output = this.execSync('git rev-list --count HEAD 2>/dev/null');
+		return parseInt(output, 10) || 0;
+	}
+
+	getDiff() {
+		if (this.init.targetBranch) {
+			return this.execSync(`git diff ${this.init.targetBranch}`);
+		}
+
+		return this.execSync('git diff --cached');
+	}
+
+	parseDiff(diffStr) {
+		const lines = diffStr.split('\n');
+		const files = [];
+		let currentFile = null;
+		
+		lines.forEach((line) => {
+			if (line.startsWith('diff --git')) {
+				if (currentFile) files.push(currentFile);
+				const parts = line.split(' ');
+				const bFile = parts[3] ? parts[3].replace('b/', '') : parts[2].replace('a/', '');
+				currentFile = { filename: bFile, diff: [line] };
+			} else if (currentFile) {
+				currentFile.diff.push(line);
+			}
+		});
+
+		if (currentFile) files.push(currentFile);
+
+		return files;
+	}
+
+	categorizeFiles(files) {
+		const lockFiles = [];
+		const dotFiles = [];
+		const docFiles = [];
+		const renamedFiles = [];
+		const deletedFiles = [];
+		const changedFiles = [];
+		
+		files.forEach((file) => {
+			const isRenamed = file.diff.some(
+				(line) => line.includes('rename from') || line.includes('rename to')
+			);
+			const isDeleted = file.diff.some((line) => line.includes('deleted file mode'));
+			
+			if (/\.md$/.test(file.filename)) {
+				docFiles.push(file);
+			} else if (/^\./.test(file.filename)) {
+				dotFiles.push(file);
+			} else if (/(\.lock|-lock\.json)$/.test(file.filename)) {
+				lockFiles.push(file);
+			} else if (isRenamed) {
+				renamedFiles.push(file);
+			} else if (isDeleted) {
+				deletedFiles.push(file);
+			} else {
+				changedFiles.push(file);
+			}
+		});
+
+		return { dotFiles, docFiles, lockFiles, renamedFiles, deletedFiles, changedFiles };
+	}
+
+	generateDiffText(files) {
+		return files
+			.map((file) => `File: ${file.filename}\n${file.diff.join('\n')}`)
+			.join('\n\n');
+	}
+
+	tokenCount(text) {
+		return text.split(/\s+/).length;
+	}
+
+	splitDiffByTokens(diffText, template, maxTokens) {
+		const templateTokens = this.tokenCount(template.replace('{diff}', ''));
+		const availableTokens = maxTokens - templateTokens;
+		const words = diffText.split(/\s+/);
+		const chunks = [];
+		
+		for (let i = 0; i < words.length; i += availableTokens) {
+			chunks.push(words.slice(i, i + availableTokens).join(' '));
+		}
+
+		return chunks;
+	}
+
+	async generateFromOllama(prompt) {
+		try {
+			const req = await fetch(this.init.ollamaUrl, {
+				method: 'POST',
+				headers: {'Content-Type': 'application/json'},
+				body: JSON.stringify({
+					prompt,
+					model: this.init.reviewerModel,
+					stream: false,
+				}),
+			});
+			const data = await req.json();
+			return data.response || '';
+		} catch (e) {
+			this.logger.error(`Failed to generate ollama response:`, e);
+			return '';
+		}
+	}
+
+	async generateMessage(prompt) {
+		const msg =  await this.generateFromOllama(prompt);
+		return msg.replace(/(^[\s\S]*<message>|<\/message>[\s\S]*)/g, '').replace(/\n\s*- /, '\n\n- ')
+	}
+
+	async generate() {
+		const commitCount = this.getCommitCount();
+		const diffStr = this.getDiff();
+		const parsedFiles = this.parseDiff(diffStr);
+		const categories = this.categorizeFiles(parsedFiles);
+		const mode =
+			this.init.mode === 'auto'
+				? this.init.targetBranch
+					? 'detailed'
+					: commitCount > 1 && categories.changedFiles.length < 5
+					? 'oneline'
+					: 'detailed'
+				: this.init.mode;
+
+		this.logger.info(`Generating commit message (mode: ${mode}, commits: ${commitCount}):`);
+
+		Object.entries(categories).forEach(([key, value]) => {
+			this.logger.info(`- ${style.bold(key)}:`, style.cyan(value.length + ''));
+		});
+
+		const diffText = this.generateDiffText(categories.changedFiles);
+
+		// this.logger.info(`Diff:`, diffText);
+
+		const promptTemplate = (mode === 'oneline'
+			? this.init.onelinePromptTemplate
+			: this.init.detailedPromptTemplate).trim();
+
+		const fullPrompt = promptTemplate.replace('{diff}', diffText);
+		const totalTokens = this.tokenCount(fullPrompt);
+		let finalMessage = '';
+
+		this.logger.info(`Total tokens: ${totalTokens}`);
+		
+		if (totalTokens < this.init.maxInputTokens) {
+			finalMessage = await this.generateMessage(fullPrompt);
+		} else {
+			const diffChunks = this.splitDiffByTokens(
+				diffText,
+				promptTemplate,
+				this.init.maxInputTokens,
+			);
+			const partialMessages = [];
+			
+			for (const chunk of diffChunks) {
+				const partPrompt = promptTemplate.replace('{diff}', chunk);
+				const msg = await this.generateMessage(partPrompt);
+
+				partialMessages.push(msg);
+			}
+			
+			const composerPrompt = this.init.composerPromptTemplate.replace(
+				'{messages}',
+				partialMessages.join('\n'),
+			);
+			
+			finalMessage = await this.generateMessage(composerPrompt);
+		}
+
+		return finalMessage;
+	}
+}

package/src/prompts/composer-prompt.md

@@ -0,0 +1,7 @@
+You are a IT expert tasked with writing a commit message for git based on the provided code changes. Follow these rules:
+
+- Combine and  summarize all messages into one preserving the structure
+- Messages are separated by "---"
+
+**Input:**
+{messages}

package/src/prompts/detailed-prompt.md

@@ -0,0 +1,32 @@
+You are a JavaScript/TypeScript expert tasked with writing a commit message for git based on the provided code changes. Follow these rules carefully:  
+
+**Subject:**  
+- Clearly summarize the key changes in one concise yet informative sentence.  
+- Use **present tense** and **imperative mood** (e.g., "Fix bug", "Add feature").  
+- Do **not** describe changes for each file.  
+- Do **not** mention stylistic changes or fixed typos.  
+- The subject **must** provide enough context to understand the commit at a glance.  
+- End with an **emoji** instead of a period.  
+
+**Description:**  
+- Expand on the changes by listing key modifications as an unordered list.  
+- Do **not** describe changes for each file.  
+- Do **not** mention stylistic changes or fixed typos.  
+- Group related changes into single points.  
+- Each list item **must** be less than 140 characters and should not end with a period.  
+
+**Output Format:**  
+<message>subject emoji
+description item 1
+description item 2</message>
+
+
+**Important:**  
+- The description **must** be an unordered list.  
+- Do **not** include introductory phrases like "Here's the commit message".  
+- The output must contain **only** the `<message>` tags and the commit message inside.  
+- The output **must** be wrapped inside `<message>` and `</message>` tags.  
+- Any deviation from this format is incorrect.  
+
+**Input:**  
+{diff}

package/src/prompts/oneline-prompt.md

@@ -0,0 +1,22 @@
+You are a JavaScript/TypeScript expert tasked with writing a commit message for git based on the provided code changes. Follow these rules:
+
+**Online message:**
+- Summarize changes as one sentence of key changes (e.g., broken code, new features).
+- Use present tense, imperative mood.
+- Do not describe changes for each file.
+- Do not mention stylistic changes or fixed typos.
+- Group related changes into a single point.
+
+**Output Format:**
+<message>your commit message here</message>
+
+**Input:**
+{diff}
+
+**Important:**
+- The commit message must be wrapped inside `<message>` and `</message>` tags.
+- The message must be a **single line** with no line breaks, lists, bullet points, or additional formatting.
+- Do not include any additional text, explanations, or commentary.
+- Do not include introductory phrases like "Here's the commit message".
+- The output must contain **only** the `<message>` tags and the commit message inside.
+- **Lists, multiple lines, or extra formatting are strictly forbidden.** Only a single sentence inside `<message>`.

package/src/utils/parse-args.js

@@ -0,0 +1,20 @@
+export const parseArgs = (argv, schema) => {
+    const params = {};
+    const argsList = argv.slice(2);
+    
+    argsList.forEach(arg => {
+        if (arg.startsWith('-')) {
+            const cleanArg = arg.replace(/^-+/, '');
+            const [key, value] = cleanArg.split('=');
+            
+            for (const [optionKey, aliases] of Object.entries(schema)) {
+                if (aliases.includes(key)) {
+                    params[optionKey] = value || true;
+                    break;
+                }
+            }
+        }
+    });
+    
+    return params;
+}

package/src/utils/style.js

@@ -0,0 +1,71 @@
+const ansiCodes = {
+	// Modifiers
+	reset: '\x1b[0m',
+	bold: '\x1b[1m',
+	dim: '\x1b[2m',
+	italic: '\x1b[3m',
+	underline: '\x1b[4m',
+	overline: '\x1b[53m',
+	inverse: '\x1b[7m',
+	hidden: '\x1b[8m',
+	strikethrough: '\x1b[9m',
+
+	// Colors (foreground)
+	black: '\x1b[30m',
+	red: '\x1b[31m',
+	green: '\x1b[32m',
+	yellow: '\x1b[33m',
+	blue: '\x1b[34m',
+	magenta: '\x1b[35m',
+	cyan: '\x1b[36m',
+	white: '\x1b[37m',
+	gray: '\x1b[90m',
+	redBright: '\x1b[91m',
+	greenBright: '\x1b[92m',
+	yellowBright: '\x1b[93m',
+	blueBright: '\x1b[94m',
+	magentaBright: '\x1b[95m',
+	cyanBright: '\x1b[96m',
+	whiteBright: '\x1b[97m',
+	
+	// Background colors
+	bgBlack: '\x1b[40m',
+	bgRed: '\x1b[41m',
+	bgGreen: '\x1b[42m',
+	bgYellow: '\x1b[43m',
+	bgBlue: '\x1b[44m',
+	bgMagenta: '\x1b[45m',
+	bgCyan: '\x1b[46m',
+	bgWhite: '\x1b[47m',
+	bgGray: '\x1b[100m',
+	bgRedBright: '\x1b[101m',
+	bgGreenBright: '\x1b[102m',
+	bgYellowBright: '\x1b[103m',
+	bgBlueBright: '\x1b[104m',
+	bgMagentaBright: '\x1b[105m',
+	bgCyanBright: '\x1b[106m',
+	bgWhiteBright: '\x1b[107m'
+};
+
+function createStyler(appliedStyles = []) {
+	return new Proxy(() => {}, {
+		get(_target, prop) {
+			if (prop === 'toString') {
+				return () => appliedStyles.join('') + '%s' + ansiCodes.reset;
+			}
+
+			if (prop in ansiCodes) {
+				return createStyler([...appliedStyles, ansiCodes[prop]]);
+			}
+
+			return undefined;
+		},
+
+		apply(_target, _thisArg, args) {
+			const text = args[0] || '';
+			return appliedStyles.join('') + text + ansiCodes.reset;
+		}
+	});
+}
+
+export const style = createStyler();