@webywz/vibe-commit 0.1.7 → 0.1.9

package/README.md

@@ -55,15 +55,15 @@ vibe-commit install                 # optional prepare-commit-msg hook
 | `--scope <scope>` | Override inferred scope · 覆盖推断出的 scope |
 | `--vibe <style>` | `playful` \| `pro` \| `terse` (default: `pro`) |
 | `--no-ai` | Skip the API even if `OPENAI_API_KEY` is set · 即使有 Key 也不走 AI |
-| `--breaking` | Force breaking change (`!` + `BREAKING CHANGE:` footer) · 强制破坏性变更（`!` + footer） |
+| `--breaking` | Force breaking (`!` + `BREAKING CHANGE:` footer = **subject**) · 强制破坏性变更（`!` + footer 文本即 **subject**） |
 | `--json` | Machine-readable proposal · 机器可读提案 |
 | `install [--path]` | Install the prepare-commit-msg hook · 安装钩子 |
 | `uninstall [--path]` | Remove the managed hook · 卸载钩子 |
 | `-h` / `-v` | Help / version · 帮助 / 版本 |
 
-Offline heuristic also marks breaking when the staged diff removes public `export`s or bumps a `package.json` major version, and always attaches a `BREAKING CHANGE:` footer when `breaking` is true (so `--json` body matches the formatted message). Dry-run prints a one-line cause; `--json` may include `breakingReason`.
+Offline heuristic also marks breaking when the staged diff removes public `export`s or bumps a `package.json` major version, and always attaches a `BREAKING CHANGE:` footer when `breaking` is true (so `--json` body matches the formatted message). Forced `--breaking` puts the **subject** in the footer; heuristic breaking still prefers a more specific bilingual reason when one is available. Dry-run prints a one-line cause; `--json` may include `breakingReason`.
 
-离线启发式在删掉公开 `export`、或 `package.json` 主版本升级时也会标 breaking；只要 `breaking` 为真就会补上 `BREAKING CHANGE:` footer（`--json` 的 body 与格式化输出一致）。干跑会打一行原因；`--json` 可带 `breakingReason`。
+离线启发式在删掉公开 `export`、或 `package.json` 主版本升级时也会标 breaking；只要 `breaking` 为真就会补上 `BREAKING CHANGE:` footer（`--json` 的 body 与格式化输出一致）。强制 `--breaking` 时 footer 文本即 **subject**；启发式推断 breaking 时仍可用更具体的双语原因。干跑会打一行原因；`--json` 可带 `breakingReason`。
 
 **Vibes** · 语气
 
@@ -146,8 +146,8 @@ console.log(formatCommit(message));
    - new files / `export function` → `feat`
 3. Optional AI draft with automatic heuristic fallback.
    可选 AI 草稿，失败自动回退启发式。
-4. **Breaking** when the diff removes a public `export`, bumps a `package.json` major, adds a `BREAKING CHANGE:` footer, or you pass `--breaking`. Dry-run shows why; `--json` may include `breakingReason`.
-   **破坏性变更**：删公开 `export`、主版本升级、diff 里已有 footer，或传 `--breaking`。干跑说明原因；`--json` 可带 `breakingReason`。
+4. **Breaking** when the diff removes a public `export`, bumps a `package.json` major, already has a `BREAKING CHANGE:` footer, or you pass `--breaking`. Forced `--breaking` puts the **subject** in the footer; heuristic cases keep a more specific bilingual reason when available. Dry-run shows why; `--json` may include `breakingReason`.
+   **破坏性变更**：删公开 `export`、主版本升级、diff 里已有 footer，或传 `--breaking`。强制 `--breaking` 时 footer 用 **subject**；启发式仍可用更具体的双语原因。干跑说明原因；`--json` 可带 `breakingReason`。
 5. Managed `prepare-commit-msg` hook via `install` / `uninstall`.
    通过 `install` / `uninstall` 管理 `prepare-commit-msg` 钩子。
 

package/dist/heuristic.d.ts

@@ -21,9 +21,13 @@ export declare function detectBreakingKind(diff: StagedDiff, forced?: boolean):
 export declare function formatBreakingReason(kind: BreakingKind): string;
 /** Detail text for the BREAKING CHANGE footer, or undefined when not inferred. */
 export declare function breakingFooterDetail(diff: StagedDiff): string | undefined;
+/** Generic bilingual footer when no better reason (or empty subject) exists. */
+export declare const DEFAULT_BREAKING_FOOTER_DETAIL = "incompatible API change \u00B7 \u4E0D\u517C\u5BB9\u7684 API \u53D8\u66F4";
 /**
  * Ensure body carries a conventional BREAKING CHANGE footer when breaking.
- * Skips if the body already mentions one. Uses subject as a last-resort reason.
+ * Skips if the body already mentions one.
+ * Prefers subject when reason is empty or the generic bilingual default.
+ * Heuristic major/export/footer-specific bilingual details are kept as-is.
  */
 export declare function ensureBreakingFooter(message: ProposedMessage, reason?: string): ProposedMessage;
 export declare function collectAddedIdentifiers(hunks: DiffHunk[]): string[];

package/dist/heuristic.js

@@ -37,7 +37,9 @@ export function proposeHeuristic(input) {
         engine: "heuristic",
         breakingReason: kind ? formatBreakingReason(kind) : undefined,
     };
-    return ensureBreakingFooter(message, breakingFooterDetail(diff));
+    // Forced --breaking: prefer subject in the footer (not bilingual default).
+    const footerReason = kind === "forced" ? message.subject : breakingFooterDetail(diff);
+    return ensureBreakingFooter(message, footerReason);
 }
 export function inferType(diff) {
     const files = diff.files;
@@ -269,9 +271,13 @@ export function breakingFooterDetail(diff) {
     }
     return undefined;
 }
+/** Generic bilingual footer when no better reason (or empty subject) exists. */
+export const DEFAULT_BREAKING_FOOTER_DETAIL = "incompatible API change · 不兼容的 API 变更";
 /**
  * Ensure body carries a conventional BREAKING CHANGE footer when breaking.
- * Skips if the body already mentions one. Uses subject as a last-resort reason.
+ * Skips if the body already mentions one.
+ * Prefers subject when reason is empty or the generic bilingual default.
+ * Heuristic major/export/footer-specific bilingual details are kept as-is.
  */
 export function ensureBreakingFooter(message, reason) {
     if (!message.breaking)
@@ -280,8 +286,13 @@ export function ensureBreakingFooter(message, reason) {
     if (/BREAKING CHANGE:/i.test(body)) {
         return body === (message.body ?? "") ? message : { ...message, body };
     }
-    const detail = (reason ?? message.subject).replace(/\s+/g, " ").trim() ||
-        "incompatible API change · 不兼容的 API 变更";
+    const subject = message.subject.replace(/\s+/g, " ").trim();
+    const normalized = (reason ?? "").replace(/\s+/g, " ").trim();
+    const useSubject = Boolean(subject) &&
+        (!normalized || normalized === DEFAULT_BREAKING_FOOTER_DETAIL);
+    const detail = (useSubject ? subject : normalized) ||
+        subject ||
+        DEFAULT_BREAKING_FOOTER_DETAIL;
     const footer = `BREAKING CHANGE: ${detail}`;
     return {
         ...message,
@@ -298,7 +309,7 @@ function detectBreakingFooter(diff) {
     }
     // Presence of the token alone still counts as breaking.
     if (diff.hunks.some((hunk) => hunk.lines.some((line) => /^\+\s*BREAKING CHANGE:/i.test(line)))) {
-        return "incompatible API change · 不兼容的 API 变更";
+        return DEFAULT_BREAKING_FOOTER_DETAIL;
     }
     return undefined;
 }

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { proposeWithAi } from "./ai.ts";
 export { formatCommit, parseCommit, normalizeSubject } from "./format.ts";
 export { inspectStaged, commitWithMessage, GitError } from "./git.ts";
-export { proposeHeuristic, inferType, inferScope, inferSubject, inferBreaking, detectBreakingKind, formatBreakingReason, breakingFooterDetail, ensureBreakingFooter, classifyPath, } from "./heuristic.ts";
+export { proposeHeuristic, inferType, inferScope, inferSubject, inferBreaking, detectBreakingKind, formatBreakingReason, breakingFooterDetail, DEFAULT_BREAKING_FOOTER_DETAIL, ensureBreakingFooter, classifyPath, } from "./heuristic.ts";
 export type { BreakingKind } from "./heuristic.ts";
 export { parseArgs, helpText, UsageError } from "./parse-args.ts";
 export { assembleDiff, parseUnifiedDiff } from "./parse-diff.ts";

package/dist/index.js

@@ -1,7 +1,7 @@
 export { proposeWithAi } from "./ai.js";
 export { formatCommit, parseCommit, normalizeSubject } from "./format.js";
 export { inspectStaged, commitWithMessage, GitError } from "./git.js";
-export { proposeHeuristic, inferType, inferScope, inferSubject, inferBreaking, detectBreakingKind, formatBreakingReason, breakingFooterDetail, ensureBreakingFooter, classifyPath, } from "./heuristic.js";
+export { proposeHeuristic, inferType, inferScope, inferSubject, inferBreaking, detectBreakingKind, formatBreakingReason, breakingFooterDetail, DEFAULT_BREAKING_FOOTER_DETAIL, ensureBreakingFooter, classifyPath, } from "./heuristic.js";
 export { parseArgs, helpText, UsageError } from "./parse-args.js";
 export { assembleDiff, parseUnifiedDiff } from "./parse-diff.js";
 export { installHook, uninstallHook, runPrepareCommitMsg, shouldSkipPrepareCommitMsg, hasNonCommentContent, HOOK_BEGIN, HOOK_END, } from "./hook.js";

package/dist/parse-args.js

@@ -17,7 +17,7 @@ Options
   --scope <scope>     Override inferred scope
   --vibe <style>      playful | pro | terse          (default: pro)
   --no-ai             Skip AI even if OPENAI_API_KEY is set
-  --breaking          Force breaking change (! + BREAKING CHANGE footer)
+  --breaking          Force ! + BREAKING CHANGE footer (text = subject)
   --json              Print a machine-readable proposal
   --path <repo>       Repo root for install/uninstall (default: cwd)
   -h, --help          Show help

package/dist/propose.js

@@ -30,6 +30,9 @@ export async function proposeMessage(diff, options, env = process.env) {
         : breaking
             ? heuristic.breakingReason ?? message.breakingReason
             : undefined;
-    return ensureBreakingFooter({ ...message, breaking, breakingReason }, breakingFooterDetail(diff));
+    const withMeta = { ...message, breaking, breakingReason };
+    // Forced --breaking: footer uses subject, not bilingual default.
+    const footerReason = kind === "forced" ? withMeta.subject : breakingFooterDetail(diff);
+    return ensureBreakingFooter(withMeta, footerReason);
 }
 //# sourceMappingURL=propose.js.map

package/package.json

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