@stephansama/ai-commit-msg 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+         MIT License
+
+Copyright (c) 2025 Stephan Randle
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,43 @@
+# @stephansama/ai-commit-msg
+
+[![Source code](https://img.shields.io/badge/Source-666666?style=flat&logo=github&label=Github&labelColor=211F1F)](https://github.com/stephansama/packages/tree/main/core/ai-commit-msg)
+[![Documentation](https://img.shields.io/badge/Documentation-211F1F?style=flat&logo=Wikibooks&labelColor=211F1F)](https://packages.stephansama.info/api/@stephansama/ai-commit-msg)
+[![NPM Version](https://img.shields.io/npm/v/%40stephansama%2Fai-commit-msg?logo=npm&logoColor=red&color=211F1F&labelColor=211F1F)](https://www.npmjs.com/package/@stephansama/ai-commit-msg)
+[![npm downloads](https://img.shields.io/npm/dw/@stephansama/ai-commit-msg?labelColor=211F1F)](https://www.npmjs.com/package/@stephansama/ai-commit-msg)
+
+generate commit messages using ai
+
+##### Table of contents
+
+<details><summary>Open Table of contents</summary>
+
+- [Installation](#installation)
+- [Usage](#usage)
+  - [Husky](#husky)
+
+</details>
+
+## Installation
+
+```sh
+pnpm install @stephansama/ai-commit-msg
+```
+
+## Usage
+
+### Husky
+
+1. Install and initialize husky
+
+   ```sh
+   npm install --save-dev husky && npx husky init
+   ```
+
+2. create the `prepare-commit-msg` hook by creating a file located at
+   `.husky/prepare-commit-msg`
+
+   ```sh
+   #!/bin/sh
+
+   ai-commit-msg -o "$1"
+   ```

package/cli.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+"use strict";
+
+import("./dist/index.js").then((mod) => mod.run());

package/config/schema.cjs

@@ -0,0 +1,63 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let zod = require("zod");
+zod = __toESM(zod);
+
+//#region src/schema.ts
+const defaultPrompt = `generate a conventional commit message based on the following diff. the subject should be all lowercase, and lines should not exceed 100 characters \n\n{{diff}}`;
+const models = ["gemini-2.5-flash"];
+const providers = [
+	"google",
+	"openai",
+	"ollama"
+];
+const envSchema = {
+	google: zod.object({ GOOGLE_GENERATIVE_AI_API_KEY: zod.string().min(1) }),
+	ollama: zod.object({}),
+	openai: zod.object({ OPENAI_API_KEY: zod.string().min(1) })
+};
+const providerSchema = zod.enum(providers);
+const configSchema = zod.object({
+	baseURL: zod.string().optional(),
+	headers: zod.record(zod.string(), zod.string()).optional(),
+	model: zod.string().meta({ description: "model to use from provider" }),
+	prompt: zod.string().default(defaultPrompt).meta({ description: "prompt used to fuel generated commit" }),
+	provider: providerSchema,
+	skipNextRun: zod.boolean().optional().meta({ description: "skip the next git hook invocation (usually used when manually running cli)" }),
+	useConventionalCommits: zod.boolean().default(true),
+	verbose: zod.union([
+		zod.literal(0),
+		zod.literal(1),
+		zod.literal(2),
+		zod.literal(3)
+	]).default(0)
+});
+
+//#endregion
+exports.configSchema = configSchema;
+exports.defaultPrompt = defaultPrompt;
+exports.envSchema = envSchema;
+exports.models = models;
+exports.providerSchema = providerSchema;
+exports.providers = providers;

package/config/schema.d.cts

@@ -0,0 +1,39 @@
+import * as z from "zod";
+
+//#region src/schema.d.ts
+declare const defaultPrompt = "generate a conventional commit message based on the following diff. the subject should be all lowercase, and lines should not exceed 100 characters \n\n{{diff}}";
+declare const models: readonly ["gemini-2.5-flash"];
+type Model = (typeof models)[number];
+declare const providers: readonly ["google", "openai", "ollama"];
+type Provider = (typeof providers)[number];
+declare const envSchema: {
+  google: z.ZodObject<{
+    GOOGLE_GENERATIVE_AI_API_KEY: z.ZodString;
+  }, z.core.$strip>;
+  ollama: z.ZodObject<{}, z.core.$strip>;
+  openai: z.ZodObject<{
+    OPENAI_API_KEY: z.ZodString;
+  }, z.core.$strip>;
+};
+declare const providerSchema: z.ZodEnum<{
+  google: "google";
+  openai: "openai";
+  ollama: "ollama";
+}>;
+declare const configSchema: z.ZodObject<{
+  baseURL: z.ZodOptional<z.ZodString>;
+  headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  model: z.ZodString;
+  prompt: z.ZodDefault<z.ZodString>;
+  provider: z.ZodEnum<{
+    google: "google";
+    openai: "openai";
+    ollama: "ollama";
+  }>;
+  skipNextRun: z.ZodOptional<z.ZodBoolean>;
+  useConventionalCommits: z.ZodDefault<z.ZodBoolean>;
+  verbose: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
+}, z.core.$strip>;
+type Config = Partial<z.infer<typeof configSchema>>;
+//#endregion
+export { Config, Model, Provider, configSchema, defaultPrompt, envSchema, models, providerSchema, providers };

package/config/schema.d.ts

@@ -0,0 +1,39 @@
+import * as z from "zod";
+
+//#region src/schema.d.ts
+declare const defaultPrompt = "generate a conventional commit message based on the following diff. the subject should be all lowercase, and lines should not exceed 100 characters \n\n{{diff}}";
+declare const models: readonly ["gemini-2.5-flash"];
+type Model = (typeof models)[number];
+declare const providers: readonly ["google", "openai", "ollama"];
+type Provider = (typeof providers)[number];
+declare const envSchema: {
+  google: z.ZodObject<{
+    GOOGLE_GENERATIVE_AI_API_KEY: z.ZodString;
+  }, z.core.$strip>;
+  ollama: z.ZodObject<{}, z.core.$strip>;
+  openai: z.ZodObject<{
+    OPENAI_API_KEY: z.ZodString;
+  }, z.core.$strip>;
+};
+declare const providerSchema: z.ZodEnum<{
+  google: "google";
+  openai: "openai";
+  ollama: "ollama";
+}>;
+declare const configSchema: z.ZodObject<{
+  baseURL: z.ZodOptional<z.ZodString>;
+  headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  model: z.ZodString;
+  prompt: z.ZodDefault<z.ZodString>;
+  provider: z.ZodEnum<{
+    google: "google";
+    openai: "openai";
+    ollama: "ollama";
+  }>;
+  skipNextRun: z.ZodOptional<z.ZodBoolean>;
+  useConventionalCommits: z.ZodDefault<z.ZodBoolean>;
+  verbose: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
+}, z.core.$strip>;
+type Config = Partial<z.infer<typeof configSchema>>;
+//#endregion
+export { Config, Model, Provider, configSchema, defaultPrompt, envSchema, models, providerSchema, providers };

package/config/schema.js

@@ -0,0 +1,34 @@
+import * as z from "zod";
+
+//#region src/schema.ts
+const defaultPrompt = `generate a conventional commit message based on the following diff. the subject should be all lowercase, and lines should not exceed 100 characters \n\n{{diff}}`;
+const models = ["gemini-2.5-flash"];
+const providers = [
+	"google",
+	"openai",
+	"ollama"
+];
+const envSchema = {
+	google: z.object({ GOOGLE_GENERATIVE_AI_API_KEY: z.string().min(1) }),
+	ollama: z.object({}),
+	openai: z.object({ OPENAI_API_KEY: z.string().min(1) })
+};
+const providerSchema = z.enum(providers);
+const configSchema = z.object({
+	baseURL: z.string().optional(),
+	headers: z.record(z.string(), z.string()).optional(),
+	model: z.string().meta({ description: "model to use from provider" }),
+	prompt: z.string().default(defaultPrompt).meta({ description: "prompt used to fuel generated commit" }),
+	provider: providerSchema,
+	skipNextRun: z.boolean().optional().meta({ description: "skip the next git hook invocation (usually used when manually running cli)" }),
+	useConventionalCommits: z.boolean().default(true),
+	verbose: z.union([
+		z.literal(0),
+		z.literal(1),
+		z.literal(2),
+		z.literal(3)
+	]).default(0)
+});
+
+//#endregion
+export { configSchema, defaultPrompt, envSchema, models, providerSchema, providers };

package/config/schema.json

@@ -0,0 +1 @@
+{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"baseURL":{"type":"string"},"headers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"model":{"description":"model to use from provider","type":"string"},"prompt":{"description":"prompt used to fuel generated commit","default":"generate a conventional commit message based on the following diff. the subject should be all lowercase, and lines should not exceed 100 characters \n\n{{diff}}","type":"string"},"provider":{"type":"string","enum":["google","openai","ollama"]},"skipNextRun":{"description":"skip the next git hook invocation (usually used when manually running cli)","type":"boolean"},"useConventionalCommits":{"default":true,"type":"boolean"},"verbose":{"default":0,"anyOf":[{"type":"number","const":0},{"type":"number","const":1},{"type":"number","const":2},{"type":"number","const":3}]}},"required":["model","prompt","provider","useConventionalCommits","verbose"],"additionalProperties":false}

package/dist/index.cjs

@@ -0,0 +1,194 @@
+#!/usr/bin/env node
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let __dotenvx_dotenvx = require("@dotenvx/dotenvx");
+__dotenvx_dotenvx = __toESM(__dotenvx_dotenvx);
+let ai = require("ai");
+ai = __toESM(ai);
+let node_child_process = require("node:child_process");
+node_child_process = __toESM(node_child_process);
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = __toESM(node_fs_promises);
+let __ai_sdk_google = require("@ai-sdk/google");
+__ai_sdk_google = __toESM(__ai_sdk_google);
+let __ai_sdk_openai = require("@ai-sdk/openai");
+__ai_sdk_openai = __toESM(__ai_sdk_openai);
+let neverthrow = require("neverthrow");
+neverthrow = __toESM(neverthrow);
+let ollama_ai_provider_v2 = require("ollama-ai-provider-v2");
+ollama_ai_provider_v2 = __toESM(ollama_ai_provider_v2);
+let zod = require("zod");
+zod = __toESM(zod);
+let obug = require("obug");
+obug = __toESM(obug);
+let yargs = require("yargs");
+yargs = __toESM(yargs);
+let yargs_helpers = require("yargs/helpers");
+yargs_helpers = __toESM(yargs_helpers);
+let cosmiconfig = require("cosmiconfig");
+cosmiconfig = __toESM(cosmiconfig);
+
+//#region src/schema.ts
+const defaultPrompt = `generate a conventional commit message based on the following diff. the subject should be all lowercase, and lines should not exceed 100 characters \n\n{{diff}}`;
+const providers = [
+	"google",
+	"openai",
+	"ollama"
+];
+const envSchema = {
+	google: zod.object({ GOOGLE_GENERATIVE_AI_API_KEY: zod.string().min(1) }),
+	ollama: zod.object({}),
+	openai: zod.object({ OPENAI_API_KEY: zod.string().min(1) })
+};
+const providerSchema = zod.enum(providers);
+const configSchema = zod.object({
+	baseURL: zod.string().optional(),
+	headers: zod.record(zod.string(), zod.string()).optional(),
+	model: zod.string().meta({ description: "model to use from provider" }),
+	prompt: zod.string().default(defaultPrompt).meta({ description: "prompt used to fuel generated commit" }),
+	provider: providerSchema,
+	skipNextRun: zod.boolean().optional().meta({ description: "skip the next git hook invocation (usually used when manually running cli)" }),
+	useConventionalCommits: zod.boolean().default(true),
+	verbose: zod.union([
+		zod.literal(0),
+		zod.literal(1),
+		zod.literal(2),
+		zod.literal(3)
+	]).default(0)
+});
+
+//#endregion
+//#region src/ai.ts
+const providerMap = {
+	google: __ai_sdk_google.google,
+	ollama: ollama_ai_provider_v2.ollama,
+	openai: __ai_sdk_openai.openai
+};
+function getProvider(provider, model) {
+	const result = envSchema[provider].safeParse(process.env);
+	if (result.error) return (0, neverthrow.err)(new Error(result.error.message));
+	const selected = providerMap[provider];
+	if (selected) return (0, neverthrow.ok)(selected(model));
+	return (0, neverthrow.err)(/* @__PURE__ */ new Error("unable to find message"));
+}
+
+//#endregion
+//#region package.json
+var name = "@stephansama/ai-commit-msg";
+
+//#endregion
+//#region src/util.ts
+const moduleName = name.split("/").at(-1).replace(/-/g, "");
+const debug = (0, obug.createDebug)(namespace("debug"));
+const info = (0, obug.createDebug)(namespace("info"));
+const warn = (0, obug.createDebug)(namespace("warn"));
+function namespace(space) {
+	return [moduleName, space].join(":");
+}
+
+//#endregion
+//#region src/args.ts
+const args = {
+	config: {
+		alias: "c",
+		description: "Path to config file",
+		type: "string"
+	},
+	output: {
+		alias: "o",
+		description: "Output file for commit-msg",
+		type: "string"
+	},
+	verbose: {
+		alias: "v",
+		description: "Enable verbose logging",
+		type: "boolean"
+	}
+};
+async function parseArgs() {
+	const yargsInstance = (0, yargs.default)((0, yargs_helpers.hideBin)(process.argv)).options(args).help("h").alias("h", "help").epilogue(`--> @stephansama open-source ${(/* @__PURE__ */ new Date()).getFullYear()}`);
+	const parsed = await yargsInstance.wrap(yargsInstance.terminalWidth()).parse();
+	if (parsed.verbose) (0, obug.enable)(`${moduleName}*`);
+	return parsed;
+}
+
+//#endregion
+//#region src/config.ts
+const searchPlaces = getSearchPlaces();
+const defaultConfig = {
+	model: "llama2",
+	provider: "ollama",
+	useConventionalCommits: true
+};
+async function loadConfig() {
+	const result = await (0, cosmiconfig.cosmiconfig)(moduleName, { searchPlaces }).search();
+	return configSchema.parse(result?.config || defaultConfig);
+}
+function getSearchPlaces() {
+	return [
+		...(0, cosmiconfig.getDefaultSearchPlaces)(moduleName),
+		`.config/.${moduleName}rc.json`,
+		`.config/.${moduleName}rc.yaml`,
+		`.config/.${moduleName}rc.yml`,
+		`.config/.${moduleName}rc`
+	];
+}
+
+//#endregion
+//#region src/index.ts
+async function run() {
+	__dotenvx_dotenvx.default.config();
+	const args$1 = await parseArgs();
+	if (!args$1.output) args$1.output = getCommitEditMsgFile();
+	const config = await loadConfig();
+	if (config.skipNextRun) {
+		console.warn("skipNextRun flag supplied skipping current run");
+		return process.exit(0);
+	}
+	const providerResult = getProvider(config.provider, config.model);
+	if (providerResult.isErr()) {
+		console.error(providerResult.error.message);
+		return process.exit(1);
+	}
+	const model = providerResult.value;
+	const diff = getDiff();
+	if (!diff) throw new Error("unable to get git diff");
+	const { text } = await (0, ai.generateText)({
+		model,
+		prompt: (config.prompt || defaultPrompt).replace("{{diff}}", diff)
+	});
+	await node_fs_promises.writeFile(args$1.output, text);
+}
+function getCommitEditMsgFile() {
+	const output = node_child_process.execSync(`git rev-parse --git-path COMMIT_EDITMSG`, { encoding: "utf8" });
+	if (output) return output.trim();
+	throw new Error("unable to find commit edit msg. please use within a git directory or provide the output flag -o");
+}
+function getDiff() {
+	const output = node_child_process.execSync(`git --no-pager diff --staged`, { encoding: "utf8" });
+	if (output) return output.substring(0, 8e3).trim();
+}
+
+//#endregion
+exports.run = run;

package/dist/index.d.cts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+//#region src/index.d.ts
+declare function run(): Promise<undefined>;
+//#endregion
+export { run };

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+//#region src/index.d.ts
+declare function run(): Promise<undefined>;
+//#endregion
+export { run };

package/dist/index.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+import dotenvx from "@dotenvx/dotenvx";
+import { generateText } from "ai";
+import * as cp from "node:child_process";
+import * as fsp from "node:fs/promises";
+import { google } from "@ai-sdk/google";
+import { openai } from "@ai-sdk/openai";
+import { err, ok } from "neverthrow";
+import { ollama } from "ollama-ai-provider-v2";
+import * as z from "zod";
+import { createDebug, enable } from "obug";
+import yargs from "yargs";
+import { hideBin } from "yargs/helpers";
+import { cosmiconfig, getDefaultSearchPlaces } from "cosmiconfig";
+
+//#region src/schema.ts
+const defaultPrompt = `generate a conventional commit message based on the following diff. the subject should be all lowercase, and lines should not exceed 100 characters \n\n{{diff}}`;
+const providers = [
+	"google",
+	"openai",
+	"ollama"
+];
+const envSchema = {
+	google: z.object({ GOOGLE_GENERATIVE_AI_API_KEY: z.string().min(1) }),
+	ollama: z.object({}),
+	openai: z.object({ OPENAI_API_KEY: z.string().min(1) })
+};
+const providerSchema = z.enum(providers);
+const configSchema = z.object({
+	baseURL: z.string().optional(),
+	headers: z.record(z.string(), z.string()).optional(),
+	model: z.string().meta({ description: "model to use from provider" }),
+	prompt: z.string().default(defaultPrompt).meta({ description: "prompt used to fuel generated commit" }),
+	provider: providerSchema,
+	skipNextRun: z.boolean().optional().meta({ description: "skip the next git hook invocation (usually used when manually running cli)" }),
+	useConventionalCommits: z.boolean().default(true),
+	verbose: z.union([
+		z.literal(0),
+		z.literal(1),
+		z.literal(2),
+		z.literal(3)
+	]).default(0)
+});
+
+//#endregion
+//#region src/ai.ts
+const providerMap = {
+	google,
+	ollama,
+	openai
+};
+function getProvider(provider, model) {
+	const result = envSchema[provider].safeParse(process.env);
+	if (result.error) return err(new Error(result.error.message));
+	const selected = providerMap[provider];
+	if (selected) return ok(selected(model));
+	return err(/* @__PURE__ */ new Error("unable to find message"));
+}
+
+//#endregion
+//#region package.json
+var name = "@stephansama/ai-commit-msg";
+
+//#endregion
+//#region src/util.ts
+const moduleName = name.split("/").at(-1).replace(/-/g, "");
+const debug = createDebug(namespace("debug"));
+const info = createDebug(namespace("info"));
+const warn = createDebug(namespace("warn"));
+function namespace(space) {
+	return [moduleName, space].join(":");
+}
+
+//#endregion
+//#region src/args.ts
+const args = {
+	config: {
+		alias: "c",
+		description: "Path to config file",
+		type: "string"
+	},
+	output: {
+		alias: "o",
+		description: "Output file for commit-msg",
+		type: "string"
+	},
+	verbose: {
+		alias: "v",
+		description: "Enable verbose logging",
+		type: "boolean"
+	}
+};
+async function parseArgs() {
+	const yargsInstance = yargs(hideBin(process.argv)).options(args).help("h").alias("h", "help").epilogue(`--> @stephansama open-source ${(/* @__PURE__ */ new Date()).getFullYear()}`);
+	const parsed = await yargsInstance.wrap(yargsInstance.terminalWidth()).parse();
+	if (parsed.verbose) enable(`${moduleName}*`);
+	return parsed;
+}
+
+//#endregion
+//#region src/config.ts
+const searchPlaces = getSearchPlaces();
+const defaultConfig = {
+	model: "llama2",
+	provider: "ollama",
+	useConventionalCommits: true
+};
+async function loadConfig() {
+	const result = await cosmiconfig(moduleName, { searchPlaces }).search();
+	return configSchema.parse(result?.config || defaultConfig);
+}
+function getSearchPlaces() {
+	return [
+		...getDefaultSearchPlaces(moduleName),
+		`.config/.${moduleName}rc.json`,
+		`.config/.${moduleName}rc.yaml`,
+		`.config/.${moduleName}rc.yml`,
+		`.config/.${moduleName}rc`
+	];
+}
+
+//#endregion
+//#region src/index.ts
+async function run() {
+	dotenvx.config();
+	const args$1 = await parseArgs();
+	if (!args$1.output) args$1.output = getCommitEditMsgFile();
+	const config = await loadConfig();
+	if (config.skipNextRun) {
+		console.warn("skipNextRun flag supplied skipping current run");
+		return process.exit(0);
+	}
+	const providerResult = getProvider(config.provider, config.model);
+	if (providerResult.isErr()) {
+		console.error(providerResult.error.message);
+		return process.exit(1);
+	}
+	const model = providerResult.value;
+	const diff = getDiff();
+	if (!diff) throw new Error("unable to get git diff");
+	const { text } = await generateText({
+		model,
+		prompt: (config.prompt || defaultPrompt).replace("{{diff}}", diff)
+	});
+	await fsp.writeFile(args$1.output, text);
+}
+function getCommitEditMsgFile() {
+	const output = cp.execSync(`git rev-parse --git-path COMMIT_EDITMSG`, { encoding: "utf8" });
+	if (output) return output.trim();
+	throw new Error("unable to find commit edit msg. please use within a git directory or provide the output flag -o");
+}
+function getDiff() {
+	const output = cp.execSync(`git --no-pager diff --staged`, { encoding: "utf8" });
+	if (output) return output.substring(0, 8e3).trim();
+}
+
+//#endregion
+export { run };

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@stephansama/ai-commit-msg",
+  "version": "1.0.0",
+  "description": "generate commit messages using ai",
+  "keywords": [
+    "ai-commit-msg"
+  ],
+  "homepage": "https://packages.stephansama.info/api/@stephansama/ai-commit-msg",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/stephansama/packages",
+    "directory": "core/ai-commit-msg"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Stephan Randle",
+    "email": "stephanrandle.dev@gmail.com",
+    "url": "https://stephansama.info"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./config/schema.d.ts",
+        "default": "./config/schema.js"
+      },
+      "require": {
+        "types": "./config/schema.d.cts",
+        "default": "./config/schema.cjs"
+      }
+    },
+    "./schema.json": "./config/schema.json",
+    "./package.json": "./package.json"
+  },
+  "main": "./config/schema.js",
+  "module": "./config/schema.js",
+  "types": "./config/schema.d.ts",
+  "bin": "./cli.mjs",
+  "files": [
+    "./dist",
+    "./config",
+    "./cli.mjs"
+  ],
+  "dependencies": {
+    "@ai-sdk/google": "^3.0.1",
+    "@ai-sdk/openai": "^3.0.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@dotenvx/dotenvx": "^1.51.2",
+    "ai": "^6.0.3",
+    "cosmiconfig": "9.0.0",
+    "es-toolkit": "1.43.0",
+    "neverthrow": "^8.2.0",
+    "obug": "2.1.1",
+    "ollama-ai-provider-v2": "^1.5.5",
+    "yargs": "18.0.0",
+    "zod": "4.2.1"
+  },
+  "devDependencies": {
+    "@types/yargs": "^17.0.33",
+    "tsdown": "0.15.12"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "node build.mjs",
+    "dev": "tsdown --watch",
+    "lint": "eslint ./src/ --pass-on-no-patterns --no-error-on-unmatched-pattern"
+  }
+}