@webywz/vibe-commit 0.1.14 → 0.1.16

package/README.md

@@ -57,6 +57,7 @@ vibe-commit install                 # optional prepare-commit-msg hook
 | `--type <type>` | Force `feat` / `fix` / `docs` / `style` / `refactor` / `perf` / `test` / `build` / `ci` / `chore` |
 | `--scope <scope>` | Override inferred scope · 覆盖推断出的 scope |
 | `--vibe <style>` | `playful` \| `pro` \| `terse` (default: `pro`) |
+| `--locale <locale>` | `en` \| `zh` (default: `en`) · 提交信息主题语言 |
 | `--no-ai` | Skip the API even if `OPENAI_API_KEY` is set · 即使有 Key 也不走 AI |
 | `--breaking` | Force breaking (`!` + `BREAKING CHANGE:` footer = **subject**) · 强制破坏性变更（`!` + footer 文本即 **subject**） |
 | `--json` | Machine-readable proposal · 机器可读提案 |
@@ -125,6 +126,45 @@ Hook stays **offline by default** (`VIBE_COMMIT_HOOK_AI=1` to allow AI). Unique
 
 钩子默认离线；设 `VIBE_COMMIT_HOOK_AI=1` 才允许 AI。用标记块保证干净卸载。已有外来钩子会备份并链式调用。
 
+### Locale support · 语言支持
+
+vibe-commit supports English (`en`, default) and Chinese (`zh`) commit subjects:
+
+vibe-commit 支持英文（`en`，默认）和中文（`zh`）提交信息主题：
+
+```bash
+vibe-commit --locale zh --dry-run        # Chinese subject: 添加/修复/更新...
+vibe-commit --locale en --dry-run        # English subject: add/fix/update...
+```
+
+**Configuration precedence** · 配置优先级：
+1. CLI flag `--locale`
+2. Environment variable `VIBE_COMMIT_LOCALE`
+3. Project config (`.vibe-commit.json` or `package.json#vibeCommit`)
+4. Default `en`
+
+```json
+// .vibe-commit.json
+{
+  "locale": "zh",
+  "vibe": "pro"
+}
+```
+
+```json
+// package.json
+{
+  "vibeCommit": {
+    "locale": "zh",
+    "vibe": "terse"
+  }
+}
+```
+
+Both heuristic and AI engines respect the locale setting. The `--json` output includes a `locale` field.
+
+启发式引擎和 AI 引擎都会遵循 locale 设置。`--json` 输出包含 `locale` 字段。
+
 ### AI (optional) · AI（可选）
 
 ```bash
@@ -132,6 +172,7 @@ export OPENAI_API_KEY=sk-...
 export OPENAI_MODEL=gpt-4o-mini          # optional
 export OPENAI_BASE_URL=https://api.openai.com/v1
 export VIBE_COMMIT_VIBE=pro              # or VIBE
+export VIBE_COMMIT_LOCALE=zh             # or en (default)
 ```
 
 OpenAI-compatible Chat Completions. Missing key, timeout, or 4xx/5xx → silent fallback to the offline heuristic. See [`.env.example`](.env.example). Unstaged files are never sent; huge diffs are truncated.

package/dist/ai.d.ts

@@ -1,8 +1,9 @@
-import type { ProposedMessage, StagedDiff, Vibe } from "./types.ts";
+import type { Locale, ProposedMessage, StagedDiff, Vibe } from "./types.ts";
 import type { CommitType } from "./types.ts";
 export interface AiContext {
     diff: StagedDiff;
     vibe: Vibe;
+    locale: Locale;
     type?: CommitType;
     scope?: string;
 }

package/dist/ai.js

@@ -17,7 +17,7 @@ export async function proposeWithAi(context, env = process.env) {
                 model,
                 temperature: context.vibe === "playful" ? 0.7 : 0.2,
                 messages: [
-                    { role: "system", content: systemPrompt(context.vibe) },
+                    { role: "system", content: systemPrompt(context.vibe, context.locale) },
                     { role: "user", content: userPrompt(context) },
                 ],
             }),
@@ -35,24 +35,29 @@ export async function proposeWithAi(context, env = process.env) {
             parsed.type = context.type;
         if (context.scope)
             parsed.scope = context.scope;
+        parsed.locale = context.locale;
         return parsed;
     }
     catch {
         return null;
     }
 }
-function systemPrompt(vibe) {
+function systemPrompt(vibe, locale) {
     const vibeLine = vibe === "playful"
         ? "Tone: witty, still professional; no memes, no emoji, no slang that would embarrass a code review."
         : vibe === "terse"
             ? "Tone: as short as possible. Headline only, no body."
             : "Tone: clear, professional, imperative mood.";
+    const langLine = locale === "zh"
+        ? "Subject language: Chinese (中文). Use Chinese verbs like 添加/修复/更新/重构/优化/删除/格式化 etc."
+        : "Subject language: English.";
     return `You write conventional commit messages.
 Return only the commit message, no quotes, no markdown fences.
 Format: type(scope): subject
 Optional body after a blank line.
 Types: feat, fix, docs, style, refactor, perf, test, build, ci, chore
 Subject: lowercase, imperative, no trailing period, <= 72 chars.
+${langLine}
 ${vibeLine}`;
 }
 function userPrompt(context) {

package/dist/cli.js

@@ -46,6 +46,7 @@ export async function main(argv = process.argv.slice(2)) {
             type: options.type,
             scope: options.scope,
             vibe: options.vibe,
+            locale: options.locale,
             preferAi: !options.noAi,
             breaking: options.breaking,
         });

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+import type { Locale, Vibe } from "./types.ts";
+export interface ProjectConfig {
+    locale?: Locale;
+    vibe?: Vibe;
+}
+export declare function loadProjectConfig(cwd?: string): ProjectConfig | undefined;

package/dist/config.js

@@ -0,0 +1,49 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { LOCALES, VIBES } from "./types.js";
+export function loadProjectConfig(cwd = process.cwd()) {
+    const vibeCommitPath = join(cwd, ".vibe-commit.json");
+    if (existsSync(vibeCommitPath)) {
+        try {
+            const raw = readFileSync(vibeCommitPath, "utf8");
+            const parsed = JSON.parse(raw);
+            return normalizeConfig(parsed);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    const pkgPath = join(cwd, "package.json");
+    if (existsSync(pkgPath)) {
+        try {
+            const raw = readFileSync(pkgPath, "utf8");
+            const parsed = JSON.parse(raw);
+            if (parsed.vibeCommit &&
+                typeof parsed.vibeCommit === "object" &&
+                !Array.isArray(parsed.vibeCommit)) {
+                return normalizeConfig(parsed.vibeCommit);
+            }
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return undefined;
+}
+function normalizeConfig(raw) {
+    const config = {};
+    if (typeof raw.locale === "string") {
+        const locale = raw.locale.trim().toLowerCase();
+        if (LOCALES.includes(locale)) {
+            config.locale = locale;
+        }
+    }
+    if (typeof raw.vibe === "string") {
+        const vibe = raw.vibe.trim().toLowerCase();
+        if (VIBES.includes(vibe)) {
+            config.vibe = vibe;
+        }
+    }
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/format.js

@@ -61,6 +61,7 @@ export function parseCommit(text, engine = "heuristic") {
         body: rest || undefined,
         breaking,
         engine,
+        locale: "en",
     };
 }
 export function stripFences(text) {

package/dist/heuristic.d.ts

@@ -1,9 +1,10 @@
-import type { CommitType, DiffHunk, ProposedMessage, StagedDiff, StagedFile, Vibe } from "./types.ts";
+import type { CommitType, DiffHunk, Locale, ProposedMessage, StagedDiff, StagedFile, Vibe } from "./types.ts";
 export interface HeuristicInput {
     diff: StagedDiff;
     type?: CommitType;
     scope?: string;
     vibe: Vibe;
+    locale: Locale;
     /** Force breaking: true (ORs with inferBreaking). */
     breaking?: boolean;
 }
@@ -12,7 +13,7 @@ export declare function inferType(diff: StagedDiff): CommitType;
 export declare function primaryRole(path: string): CommitType;
 export declare function classifyPath(path: string): CommitType[];
 export declare function inferScope(files: StagedFile[]): string | undefined;
-export declare function inferSubject(diff: StagedDiff, type: CommitType, scope?: string): string;
+export declare function inferSubject(diff: StagedDiff, type: CommitType, scope: string | undefined, locale: Locale): string;
 export type BreakingKind = "export-removed" | "major-bump" | "footer" | "forced";
 export declare function inferBreaking(diff: StagedDiff): boolean;
 /** Why breaking was set — heuristic signal first, then --breaking. */

package/dist/heuristic.js

@@ -23,10 +23,10 @@ const FEAT_WORD_RE = /\b(add|added|feat|feature|implement|introduce|support|enab
 const REFACTOR_WORD_RE = /\b(refactor|rename|move|extract|simplify|cleanup|clean up|restructure)\b/i;
 const PERF_WORD_RE = /\b(perf|performance|optimiz|cache|faster|speed)\b/i;
 export function proposeHeuristic(input) {
-    const { diff, vibe } = input;
+    const { diff, vibe, locale } = input;
     const type = input.type ?? inferType(diff);
     const scope = input.scope ?? inferScope(diff.files);
-    const subject = inferSubject(diff, type, scope);
+    const subject = inferSubject(diff, type, scope, locale);
     const body = inferBody(diff, type);
     const forced = Boolean(input.breaking);
     const kind = detectBreakingKind(diff, forced);
@@ -35,6 +35,7 @@ export function proposeHeuristic(input) {
     const message = {
         ...styled,
         engine: "heuristic",
+        locale,
         breakingReason: kind ? formatBreakingReason(kind) : undefined,
     };
     // Forced --breaking: prefer subject in the footer (not bilingual default).
@@ -144,10 +145,11 @@ export function inferScope(files) {
         return undefined;
     return name.slice(0, 32);
 }
-export function inferSubject(diff, type, scope) {
+export function inferSubject(diff, type, scope, locale) {
     const files = diff.files;
-    if (files.length === 0)
-        return "update project files";
+    if (files.length === 0) {
+        return normalizeSubject(locale === "zh" ? "更新项目文件" : "update project files");
+    }
     const added = files.filter((file) => file.status === "A");
     const deleted = files.filter((file) => file.status === "D");
     const renamed = files.filter((file) => file.status === "R");
@@ -156,31 +158,67 @@ export function inferSubject(diff, type, scope) {
         added.length >= files.length - 1 &&
         !scope &&
         type === "feat") {
-        return normalizeSubject("add initial implementation");
+        return normalizeSubject(locale === "zh" ? "添加初始实现" : "add initial implementation");
     }
     if (renamed.length === 1 && files.length === 1) {
         const file = renamed[0];
-        return normalizeSubject(`rename ${stem(file.fromPath ?? file.path)} to ${stem(file.path)}`);
+        const fromName = stem(file.fromPath ?? file.path);
+        const toName = stem(file.path);
+        return normalizeSubject(locale === "zh"
+            ? `重命名 ${fromName} 为 ${toName}`
+            : `rename ${fromName} to ${toName}`);
     }
     if (deleted.length === files.length) {
-        return normalizeSubject(`remove ${joinNames(deleted.map((file) => stem(file.path)))}`);
+        const names = joinNames(deleted.map((file) => stem(file.path)));
+        return normalizeSubject(locale === "zh" ? `删除 ${names}` : `remove ${names}`);
     }
     if (idents.length > 0 && (type === "feat" || type === "fix")) {
-        const verb = type === "fix" ? "fix" : "add";
+        const verb = type === "fix" ? (locale === "zh" ? "修复" : "fix") : (locale === "zh" ? "添加" : "add");
         return normalizeSubject(`${verb} ${joinNames(idents.map(humanizeIdent))}`);
     }
     if (added.length === 1 && files.length === 1) {
-        return normalizeSubject(`add ${stem(added[0].path)}`);
+        const name = stem(added[0].path);
+        return normalizeSubject(locale === "zh" ? `添加 ${name}` : `add ${name}`);
     }
     if (added.length > 1 && added.length === files.length) {
-        return normalizeSubject(`add ${summarizeFiles(added, scope)}`);
+        const summary = summarizeFiles(added, scope);
+        return normalizeSubject(locale === "zh" ? `添加 ${summary}` : `add ${summary}`);
     }
     const focus = files.length === 1 ? stem(files[0].path) : summarizeFiles(files, scope);
-    return normalizeSubject(verbFor(type, focus, files));
+    return normalizeSubject(verbFor(type, focus, files, locale));
 }
-function verbFor(type, focus, files) {
+function verbFor(type, focus, files, locale) {
     const mostlyAdd = files.reduce((sum, file) => sum + file.additions, 0) >
         files.reduce((sum, file) => sum + file.deletions, 0) * 1.4;
+    if (locale === "zh") {
+        switch (type) {
+            case "feat":
+                return mostlyAdd ? `添加 ${focus}` : `更新 ${focus}`;
+            case "fix":
+                return `修复 ${focus}`;
+            case "docs":
+                return files.some((file) => /readme/i.test(file.path))
+                    ? "更新 readme"
+                    : `更新 ${focus}`;
+            case "test":
+                return mostlyAdd ? `添加 ${focus} 测试` : `更新 ${focus} 测试`;
+            case "refactor":
+                return `重构 ${focus}`;
+            case "perf":
+                return `优化 ${focus} 性能`;
+            case "style":
+                return `格式化 ${focus}`;
+            case "ci":
+                return `更新 ${focus} 工作流`;
+            case "build":
+                return `更新 ${focus} 构建`;
+            case "chore":
+                if (files.some((file) => /package(-lock)?\.json|pnpm-lock|yarn\.lock/.test(file.path))) {
+                    return "更新依赖";
+                }
+                return `更新 ${focus}`;
+        }
+    }
     switch (type) {
         case "feat":
             return mostlyAdd ? `add ${focus}` : `update ${focus}`;

package/dist/hook.js

@@ -4,8 +4,9 @@ import { dirname, isAbsolute, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { formatCommit } from "./format.js";
 import { assertRepo, GitError, inspectStaged } from "./git.js";
-import { defaultVibeFromEnv } from "./parse-args.js";
+import { defaultLocaleFromEnv, defaultVibeFromEnv } from "./parse-args.js";
 import { proposeMessage } from "./propose.js";
+import { loadProjectConfig } from "./config.js";
 export const HOOK_BEGIN = "# BEGIN VIBE-COMMIT";
 export const HOOK_END = "# END VIBE-COMMIT";
 export const HOOK_NAME = "prepare-commit-msg";
@@ -42,8 +43,10 @@ export async function runPrepareCommitMsg(messageFile, source, cwd = process.cwd
         const diff = inspectStaged(cwd);
         // Avoid hanging `git commit` on network — hooks stay offline unless opted in.
         const useAi = env.VIBE_COMMIT_HOOK_AI === "1";
+        const projectConfig = loadProjectConfig(cwd);
         const message = await proposeMessage(diff, {
-            vibe: defaultVibeFromEnv(env),
+            vibe: projectConfig?.vibe ?? defaultVibeFromEnv(env),
+            locale: projectConfig?.locale ?? defaultLocaleFromEnv(env),
             preferAi: useAi,
         }, env);
         const formatted = formatCommit(message);

package/dist/parse-args.d.ts

@@ -1,9 +1,11 @@
-import { type CliOptions, type CommitType, type Vibe } from "./types.ts";
+import { type CliOptions, type CommitType, type Locale, type Vibe } from "./types.ts";
 export declare function defaultVibeFromEnv(env?: NodeJS.ProcessEnv): Vibe;
-export declare function parseArgs(argv: string[], env?: NodeJS.ProcessEnv): CliOptions;
+export declare function defaultLocaleFromEnv(env?: NodeJS.ProcessEnv): Locale;
+export declare function parseArgs(argv: string[], env?: NodeJS.ProcessEnv, cwd?: string): CliOptions;
 export declare function parseMaxAnnotations(value: string | undefined): number;
 export declare function parseType(value: string | undefined): CommitType;
 export declare function parseVibe(value: string | undefined): Vibe;
+export declare function parseLocale(value: string | undefined): Locale;
 export declare function sanitizeScope(value: string): string;
 export declare class UsageError extends Error {
     constructor(message: string);

package/dist/parse-args.js

@@ -1,4 +1,5 @@
-import { COMMIT_TYPES, VIBES, } from "./types.js";
+import { COMMIT_TYPES, LOCALES, VIBES, } from "./types.js";
+import { loadProjectConfig } from "./config.js";
 const HELP = `vibe-commit — stylish conventional commits, offline-first
 有品味的 Conventional Commits（离线优先）
 
@@ -17,6 +18,7 @@ Options · 参数
   --type <type>       feat | fix | docs | style | refactor | perf | test | build | ci | chore
   --scope <scope>     Override inferred scope
   --vibe <style>      playful | pro | terse          (default: pro)
+  --locale <locale>   en | zh                        (default: en)
   --no-ai             Skip AI even if OPENAI_API_KEY is set
   --breaking          Force ! + BREAKING CHANGE footer (text = subject)
   --json              Print a machine-readable proposal
@@ -33,7 +35,8 @@ Env
   OPENAI_API_KEY      Optional. When set, draft with an OpenAI-compatible API
   OPENAI_MODEL        Default: gpt-4o-mini
   OPENAI_BASE_URL     Default: https://api.openai.com/v1
-  VIBE / VIBE_COMMIT_VIBE   Default vibe when --vibe is omitted
+  VIBE / VIBE_COMMIT_VIBE     Default vibe when --vibe is omitted
+  VIBE_COMMIT_LOCALE          Default locale when --locale is omitted
   VIBE_COMMIT_HOOK_AI Set to 1 to allow AI inside the git hook (off by default)
 
 With --github, annotations go to stdout (or stderr when combined with --json) so
@@ -51,10 +54,16 @@ Git hook
   comment-only message file with a vibe-commit proposal. Skips merge, squash,
   amend (source=commit), and any message that already has non-comment text.
 
+Project config
+  .vibe-commit.json or package.json#vibeCommit
+    { "locale": "zh", "vibe": "pro" }
+  Precedence: CLI > env > project config > default
+
 Examples · 示例
   git add -p
   vibe-commit
   vibe-commit --vibe playful --commit
+  vibe-commit --locale zh --dry-run
   vibe-commit --breaking --dry-run
   vibe-commit --github --quiet --no-ai
   vibe-commit --github --json --max-annotations 10
@@ -66,12 +75,18 @@ export function defaultVibeFromEnv(env = process.env) {
     const raw = (env.VIBE_COMMIT_VIBE ?? env.VIBE ?? "pro").trim().toLowerCase();
     return VIBES.includes(raw) ? raw : "pro";
 }
-export function parseArgs(argv, env = process.env) {
+export function defaultLocaleFromEnv(env = process.env) {
+    const raw = (env.VIBE_COMMIT_LOCALE ?? "en").trim().toLowerCase();
+    return LOCALES.includes(raw) ? raw : "en";
+}
+export function parseArgs(argv, env = process.env, cwd = process.cwd()) {
+    const projectConfig = loadProjectConfig(cwd);
     const options = {
         command: "propose",
         commit: false,
         dryRun: false,
-        vibe: defaultVibeFromEnv(env),
+        vibe: projectConfig?.vibe ?? defaultVibeFromEnv(env),
+        locale: projectConfig?.locale ?? defaultLocaleFromEnv(env),
         noAi: false,
         json: false,
         github: false,
@@ -153,6 +168,11 @@ export function parseArgs(argv, env = process.env) {
             options.vibe = parseVibe(value);
             continue;
         }
+        if (arg === "--locale" || arg.startsWith("--locale=")) {
+            const value = arg.includes("=") ? arg.slice("--locale=".length) : argv[++i];
+            options.locale = parseLocale(value);
+            continue;
+        }
         if (arg === "--path" || arg.startsWith("--path=")) {
             const value = arg.includes("=") ? arg.slice("--path=".length) : argv[++i];
             if (!value)
@@ -224,6 +244,15 @@ export function parseVibe(value) {
     }
     return raw;
 }
+export function parseLocale(value) {
+    const raw = value?.trim().toLowerCase();
+    if (!raw)
+        throw new UsageError("Missing value for --locale");
+    if (!LOCALES.includes(raw)) {
+        throw new UsageError(`Invalid --locale "${value}". Use: ${LOCALES.join(", ")}`);
+    }
+    return raw;
+}
 export function sanitizeScope(value) {
     const scope = value.trim().replace(/^[\s(/]+|[\s)/]+$/g, "");
     if (!scope)

package/dist/propose.js

@@ -6,6 +6,7 @@ export async function proposeMessage(diff, options, env = process.env) {
         type: options.type,
         scope: options.scope,
         vibe: options.vibe,
+        locale: options.locale,
         breaking: options.breaking,
     });
     let message = heuristic;
@@ -15,6 +16,7 @@ export async function proposeMessage(diff, options, env = process.env) {
             const ai = await proposeWithAi({
                 diff,
                 vibe: options.vibe,
+                locale: options.locale,
                 type: options.type,
                 scope: options.scope,
             }, env);

package/dist/types.d.ts

@@ -1,5 +1,7 @@
 export declare const VIBES: readonly ["playful", "pro", "terse"];
 export type Vibe = (typeof VIBES)[number];
+export declare const LOCALES: readonly ["en", "zh"];
+export type Locale = (typeof LOCALES)[number];
 export declare const COMMIT_TYPES: readonly ["feat", "fix", "docs", "style", "refactor", "perf", "test", "build", "ci", "chore"];
 export type CommitType = (typeof COMMIT_TYPES)[number];
 export type FileStatus = "A" | "M" | "D" | "R" | "C" | "T" | "U";
@@ -30,11 +32,13 @@ export interface ProposedMessage {
     /** Short cause when breaking (export removed / major bump / --breaking / footer). */
     breakingReason?: string;
     engine: Engine;
+    locale: Locale;
 }
 export interface ProposeOptions {
     type?: CommitType;
     scope?: string;
     vibe: Vibe;
+    locale: Locale;
     preferAi?: boolean;
     /** Force a breaking change (! + BREAKING CHANGE footer). */
     breaking?: boolean;
@@ -47,6 +51,7 @@ export interface CliOptions {
     type?: CommitType;
     scope?: string;
     vibe: Vibe;
+    locale: Locale;
     noAi: boolean;
     json: boolean;
     /** Emit GitHub Actions annotations / job outputs / step summary. */

package/dist/types.js

@@ -1,4 +1,5 @@
 export const VIBES = ["playful", "pro", "terse"];
+export const LOCALES = ["en", "zh"];
 export const COMMIT_TYPES = [
     "feat",
     "fix",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webywz/vibe-commit",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Stylish conventional commit messages with personality. Offline-first, AI-optional.",
   "keywords": [
     "git",