@webywz/vibe-commit 0.1.12 → 0.1.14

package/README.md

@@ -17,7 +17,7 @@
 </p>
 
 Companion spirit to [diff-vibe](https://github.com/webywz/diff-vibe): commits here, pull requests there.
-Pair walkthrough (EN/中文) and a copy-pasteable helper: [`examples/pair-workflow.md`](./examples/pair-workflow.md) · [`examples/commit-msg.sh`](./examples/commit-msg.sh) (ship in the npm tarball).
+Pair walkthrough (EN/中文), helper script, and CI sample: [`examples/pair-workflow.md`](./examples/pair-workflow.md) · [`examples/commit-msg.sh`](./examples/commit-msg.sh) · [`examples/github-actions.yml`](./examples/github-actions.yml) (ship in the npm tarball).
 
 与 [diff-vibe](https://github.com/webywz/diff-vibe) 成对：这边写 commit，那边写 PR。
 成对流程与可复制脚本见 [`examples/`](./examples/)（随 npm 包发布）。
@@ -45,6 +45,7 @@ vibe-commit                         # propose from staged diff
 vibe-commit --vibe playful --commit # write the commit
 vibe-commit --breaking --dry-run    # force ! + BREAKING CHANGE footer
 vibe-commit --dry-run               # print only (default; wins over --commit)
+vibe-commit --github --quiet --no-ai  # Actions annotations (CI)
 git commit -m "$(vibe-commit --dry-run)"
 vibe-commit install                 # optional prepare-commit-msg hook
 ```
@@ -59,6 +60,9 @@ vibe-commit install                 # optional prepare-commit-msg hook
 | `--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 · 机器可读提案 |
+| `--github` | Emit GitHub Actions `::notice` / `::warning` / `::error` annotations; write `GITHUB_OUTPUT` + `GITHUB_STEP_SUMMARY` when set · 输出 Actions 注解，并在环境变量存在时写 Job 输出与 Summary |
+| `--quiet` | Suppress the pretty terminal report; `--json` / `--github` still emit · 抑制漂亮终端报告 |
+| `--max-annotations <n>` | Cap `--github` annotation lines (default: 20; invalid → UsageError) · 限制注解条数 |
 | `install [--path]` | Install the prepare-commit-msg hook · 安装钩子 |
 | `uninstall [--path]` | Remove the managed hook · 卸载钩子 |
 | `-h` / `-v` | Help / version · 帮助 / 版本 |
@@ -75,7 +79,7 @@ npx --yes @webywz/vibe-commit --commit
 npx --yes @webywz/diff-vibe@^0.1.8 --base main --create
 ```
 
-Commits here · PRs there. Full walkthrough (EN/中文) and `commit-msg.sh` live in [`examples/pair-workflow.md`](./examples/pair-workflow.md) and [`examples/commit-msg.sh`](./examples/commit-msg.sh). Companion-side snippets: [diff-vibe examples](https://github.com/webywz/diff-vibe/tree/main/examples).
+Commits here · PRs there. Full walkthrough (EN/中文), `commit-msg.sh`, and Actions sample live in [`examples/`](./examples/). Companion-side snippets: [diff-vibe examples](https://github.com/webywz/diff-vibe/tree/main/examples).
 
 这边写 commit，那边写 PR。完整成对流程与脚本见 [`examples/`](./examples/)。成对仓库示例：[diff-vibe examples](https://github.com/webywz/diff-vibe/tree/main/examples)。
 
@@ -164,6 +168,8 @@ console.log(formatCommit(message));
    **破坏性变更**：删公开 `export`、主版本升级、diff 里已有 footer，或传 `--breaking`。强制 `--breaking` 时 footer 用 **subject**；启发式仍可用更具体的双语原因。干跑说明原因；`--json` 可带 `breakingReason`。
 5. Managed `prepare-commit-msg` hook via `install` / `uninstall`.
    通过 `install` / `uninstall` 管理 `prepare-commit-msg` 钩子。
+6. **GitHub Actions** mode: `--github` emits Checks annotations; optional `--quiet` / `--max-annotations`; writes job outputs + step summary when `GITHUB_OUTPUT` / `GITHUB_STEP_SUMMARY` are set. See [`examples/github-actions.yml`](./examples/github-actions.yml).
+   **GitHub Actions** 模式：`--github` 输出 Checks 注解；可选 `--quiet` / `--max-annotations`；环境变量存在时写 Job 输出与 Summary。示例见 [`examples/github-actions.yml`](./examples/github-actions.yml)。
 
 ---
 
@@ -173,6 +179,7 @@ console.log(formatCommit(message));
 - Source · [github.com/webywz/vibe-commit](https://github.com/webywz/vibe-commit)
 - Related · [diff-vibe](https://github.com/webywz/diff-vibe) · [prompt-diff](https://github.com/webywz/prompt-diff)
 - Pair workflow · [examples/pair-workflow.md](./examples/pair-workflow.md)
+- GitHub Actions · [examples/github-actions.yml](./examples/github-actions.yml)
 - License · [MIT](./LICENSE)
 
 ```bash

package/dist/cli.js

@@ -5,6 +5,7 @@ import { fileURLToPath } from "node:url";
 import pc from "picocolors";
 import { formatCommit } from "./format.js";
 import { commitWithMessage, GitError, inspectStaged } from "./git.js";
+import { appendGitHubJobOutput, appendGitHubStepSummary, formatGitHubAnnotations, } from "./github.js";
 import { installHook, uninstallHook, runPrepareCommitMsg } from "./hook.js";
 import { helpText, parseArgs, UsageError } from "./parse-args.js";
 import { proposeMessage } from "./propose.js";
@@ -50,18 +51,48 @@ export async function main(argv = process.argv.slice(2)) {
         });
         const formatted = formatCommit(message);
         const shouldCommit = options.commit && !options.dryRun;
+        if (options.github) {
+            const ann = formatGitHubAnnotations(message, diff, {
+                maxAnnotations: options.maxAnnotations,
+            });
+            // Keep --json stdout machine-parseable; annotations ride on stderr.
+            if (options.json)
+                process.stderr.write(ann);
+            else
+                process.stdout.write(ann);
+            try {
+                appendGitHubJobOutput(message, diff);
+            }
+            catch (err) {
+                process.stderr.write(`vibe-commit: GITHUB_OUTPUT skipped (${err instanceof Error ? err.message : err})\n`);
+            }
+            try {
+                appendGitHubStepSummary(message, diff);
+            }
+            catch (err) {
+                process.stderr.write(`vibe-commit: GITHUB_STEP_SUMMARY skipped (${err instanceof Error ? err.message : err})\n`);
+            }
+        }
         if (options.json) {
             process.stdout.write(`${JSON.stringify({ ...message, formatted }, null, 2)}\n`);
         }
-        else if (piped) {
-            process.stdout.write(`${formatted}\n`);
-        }
-        else {
-            process.stdout.write(renderProposal(diff, message));
+        else if (!options.quiet) {
+            if (options.github) {
+                process.stdout.write("::group::vibe-commit report\n");
+            }
+            if (piped) {
+                process.stdout.write(`${formatted}\n`);
+            }
+            else {
+                process.stdout.write(renderProposal(diff, message));
+            }
+            if (options.github) {
+                process.stdout.write("::endgroup::\n");
+            }
         }
         if (shouldCommit) {
             commitWithMessage(formatted);
-            if (!piped && !options.json) {
+            if (!piped && !options.json && !options.quiet) {
                 process.stdout.write(`  ${pc.green("committed")}\n\n`);
             }
         }

package/dist/github.d.ts

@@ -0,0 +1,32 @@
+import type { ProposedMessage, StagedDiff } from "./types.ts";
+export interface GitHubFormatOptions {
+    /** Soft cap for PR annotation noise. Default 20. */
+    maxAnnotations?: number;
+}
+type AnnotationType = "error" | "warning" | "notice";
+/** Escape payload text for workflow command messages. */
+export declare function escapeData(value: string): string;
+/** Escape workflow command property values (file, title, …). */
+export declare function escapeProperty(value: string): string;
+export declare function annotation(type: AnnotationType, message: string, props?: {
+    file?: string;
+    line?: number;
+    title?: string;
+}): string;
+/** Heuristic risk tier → annotation level (breaking / fix weigh heavier). */
+export declare function proposalAnnotationType(proposal: ProposedMessage): AnnotationType;
+/**
+ * Emit GitHub Actions workflow commands so PR Checks show the proposed commit.
+ * Offline / local-safe: pure string formatting, no network.
+ */
+export declare function formatGitHubAnnotations(proposal: ProposedMessage, diff: StagedDiff, options?: GitHubFormatOptions): string;
+/** Append job outputs when running inside Actions (`GITHUB_OUTPUT`). */
+export declare function appendGitHubJobOutput(proposal: ProposedMessage, diff: StagedDiff): void;
+/** Build a short Markdown Job Summary for Actions (no env I/O). */
+export declare function formatGitHubStepSummary(proposal: ProposedMessage, diff: StagedDiff): string;
+/**
+ * Append a concise Job Summary when running inside Actions (`GITHUB_STEP_SUMMARY`).
+ * No-op when the env var is unset.
+ */
+export declare function appendGitHubStepSummary(proposal: ProposedMessage, diff: StagedDiff): void;
+export {};

package/dist/github.js

@@ -0,0 +1,162 @@
+import { appendFileSync } from "node:fs";
+import { formatCommit } from "./format.js";
+/** Escape payload text for workflow command messages. */
+export function escapeData(value) {
+    return value.replace(/%/g, "%25").replace(/\r/g, "%0D").replace(/\n/g, "%0A");
+}
+/** Escape workflow command property values (file, title, …). */
+export function escapeProperty(value) {
+    return escapeData(value).replace(/:/g, "%3A").replace(/,/g, "%2C");
+}
+export function annotation(type, message, props = {}) {
+    const parts = [];
+    if (props.file)
+        parts.push(`file=${escapeProperty(props.file)}`);
+    if (props.line !== undefined && Number.isFinite(props.line)) {
+        parts.push(`line=${Math.max(1, Math.trunc(props.line))}`);
+    }
+    if (props.title)
+        parts.push(`title=${escapeProperty(props.title)}`);
+    const meta = parts.length > 0 ? ` ${parts.join(",")}` : "";
+    return `::${type}${meta}::${escapeData(message)}`;
+}
+/** Heuristic risk tier → annotation level (breaking / fix weigh heavier). */
+export function proposalAnnotationType(proposal) {
+    if (proposal.breaking)
+        return "error";
+    switch (proposal.type) {
+        case "fix":
+            return "warning";
+        case "feat":
+        case "perf":
+        case "refactor":
+            return "notice";
+        default:
+            return "notice";
+    }
+}
+function oneLine(value, max = 200) {
+    const flat = value.replace(/\s+/g, " ").trim();
+    if (flat.length <= max)
+        return flat;
+    return `${flat.slice(0, max - 1)}…`;
+}
+function headerLine(proposal) {
+    return formatCommit({ ...proposal, body: undefined }).split("\n")[0] ?? "";
+}
+/**
+ * Emit GitHub Actions workflow commands so PR Checks show the proposed commit.
+ * Offline / local-safe: pure string formatting, no network.
+ */
+export function formatGitHubAnnotations(proposal, diff, options = {}) {
+    const max = options.maxAnnotations ?? 20;
+    const lines = [];
+    const push = (line) => {
+        if (lines.length < max)
+            lines.push(line);
+    };
+    const primary = diff.files[0]?.path;
+    const title = headerLine(proposal);
+    push(annotation(proposalAnnotationType(proposal), title, {
+        file: primary,
+        title: "vibe-commit · title",
+    }));
+    if (proposal.breaking) {
+        const reason = proposal.breakingReason?.trim() ||
+            "Breaking change detected in staged diff.";
+        push(annotation("error", oneLine(reason), {
+            file: primary,
+            title: "vibe-commit · breaking",
+        }));
+    }
+    if (proposal.body?.trim()) {
+        push(annotation("notice", oneLine(proposal.body), {
+            file: primary,
+            title: "vibe-commit · body",
+        }));
+    }
+    for (const file of diff.files) {
+        const status = file.status === "A"
+            ? "add"
+            : file.status === "D"
+                ? "delete"
+                : file.status === "R"
+                    ? "rename"
+                    : "update";
+        push(annotation("notice", `${status} \`${file.path}\` (+${file.additions} −${file.deletions})`, {
+            file: file.path,
+            title: "vibe-commit · file",
+        }));
+    }
+    const totals = diff.files.reduce((acc, file) => {
+        acc.add += file.additions;
+        acc.del += file.deletions;
+        return acc;
+    }, { add: 0, del: 0 });
+    push(annotation("notice", `${diff.files.length} files · +${totals.add} / −${totals.del} · engine ${proposal.engine}`, { title: "vibe-commit · meta" }));
+    return lines.length > 0 ? `${lines.join("\n")}\n` : "";
+}
+/** Append job outputs when running inside Actions (`GITHUB_OUTPUT`). */
+export function appendGitHubJobOutput(proposal, diff) {
+    const path = process.env.GITHUB_OUTPUT;
+    if (!path)
+        return;
+    const body = [
+        `title=${oneLine(headerLine(proposal), 256)}`,
+        `subject=${oneLine(proposal.subject, 200)}`,
+        `type=${proposal.type}`,
+        `scope=${proposal.scope ?? ""}`,
+        `breaking=${proposal.breaking}`,
+        `engine=${proposal.engine}`,
+        `findings=${diff.files.length}`,
+    ].join("\n");
+    appendFileSync(path, `${body}\n`, "utf8");
+}
+/** Build a short Markdown Job Summary for Actions (no env I/O). */
+export function formatGitHubStepSummary(proposal, diff) {
+    const totals = diff.files.reduce((acc, file) => {
+        acc.add += file.additions;
+        acc.del += file.deletions;
+        return acc;
+    }, { add: 0, del: 0 });
+    const lines = [
+        "## vibe-commit",
+        "",
+        `| | |`,
+        `| --- | --- |`,
+        `| **Title** | ${headerLine(proposal)} |`,
+        `| **Type** | \`${proposal.type}\`${proposal.scope ? ` (\`${proposal.scope}\`)` : ""} |`,
+        `| **Breaking** | ${proposal.breaking} |`,
+        `| **Engine** | ${proposal.engine} |`,
+        `| **Files** | ${diff.files.length} (+${totals.add} / −${totals.del}) staged |`,
+        "",
+    ];
+    if (proposal.breakingReason?.trim()) {
+        lines.push(`**Breaking:** _${oneLine(proposal.breakingReason, 280)}_`, "");
+    }
+    else if (proposal.body?.trim()) {
+        lines.push(`_${oneLine(proposal.body, 280)}_`, "");
+    }
+    const findings = [];
+    for (const file of diff.files.slice(0, 8)) {
+        findings.push(`- \`${file.path}\` (${file.status}, +${file.additions} −${file.deletions})`);
+    }
+    if (findings.length > 0) {
+        lines.push("### Staged files", "", ...findings, "");
+    }
+    else {
+        lines.push("_No staged files._", "");
+    }
+    return lines.join("\n");
+}
+/**
+ * Append a concise Job Summary when running inside Actions (`GITHUB_STEP_SUMMARY`).
+ * No-op when the env var is unset.
+ */
+export function appendGitHubStepSummary(proposal, diff) {
+    const path = process.env.GITHUB_STEP_SUMMARY;
+    if (!path)
+        return;
+    appendFileSync(path, `${formatGitHubStepSummary(proposal, diff)}\n`, "utf8");
+}
+//# sourceMappingURL=github.js.map

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export { inspectStaged, commitWithMessage, GitError } from "./git.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 { annotation, appendGitHubJobOutput, appendGitHubStepSummary, escapeData, escapeProperty, formatGitHubAnnotations, formatGitHubStepSummary, proposalAnnotationType, } from "./github.ts";
 export { assembleDiff, parseUnifiedDiff } from "./parse-diff.ts";
 export { installHook, uninstallHook, runPrepareCommitMsg, shouldSkipPrepareCommitMsg, hasNonCommentContent, HOOK_BEGIN, HOOK_END, } from "./hook.ts";
 export { proposeMessage } from "./propose.ts";

package/dist/index.js

@@ -3,6 +3,7 @@ export { formatCommit, parseCommit, normalizeSubject } from "./format.js";
 export { inspectStaged, commitWithMessage, GitError } from "./git.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 { annotation, appendGitHubJobOutput, appendGitHubStepSummary, escapeData, escapeProperty, formatGitHubAnnotations, formatGitHubStepSummary, proposalAnnotationType, } from "./github.js";
 export { assembleDiff, parseUnifiedDiff } from "./parse-diff.js";
 export { installHook, uninstallHook, runPrepareCommitMsg, shouldSkipPrepareCommitMsg, hasNonCommentContent, HOOK_BEGIN, HOOK_END, } from "./hook.js";
 export { proposeMessage } from "./propose.js";

package/dist/parse-args.d.ts

@@ -1,6 +1,7 @@
 import { type CliOptions, type CommitType, 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 parseMaxAnnotations(value: string | undefined): number;
 export declare function parseType(value: string | undefined): CommitType;
 export declare function parseVibe(value: string | undefined): Vibe;
 export declare function sanitizeScope(value: string): string;

package/dist/parse-args.js

@@ -1,16 +1,17 @@
 import { COMMIT_TYPES, VIBES, } from "./types.js";
 const HELP = `vibe-commit — stylish conventional commits, offline-first
+有品味的 Conventional Commits（离线优先）
 
-Usage
+Usage · 用法
   vibe-commit [options]
   vibe-commit install [--path <repo>]
   vibe-commit uninstall [--path <repo>]
 
-Commands
+Commands · 命令
   install             Install a prepare-commit-msg hook in the repo
   uninstall           Remove the managed prepare-commit-msg hook
 
-Options
+Options · 参数
   --commit            Create the commit with the proposed message
   --dry-run           Print the message only (default)
   --type <type>       feat | fix | docs | style | refactor | perf | test | build | ci | chore
@@ -19,6 +20,11 @@ Options
   --no-ai             Skip AI even if OPENAI_API_KEY is set
   --breaking          Force ! + BREAKING CHANGE footer (text = subject)
   --json              Print a machine-readable proposal
+  --github            Emit GitHub Actions annotations (::notice/warning/error)
+                      输出 Actions 注解；有 GITHUB_OUTPUT / GITHUB_STEP_SUMMARY 时写输出与 Job Summary
+  --quiet             Suppress the pretty terminal report (--json / --github still emit)
+                      抑制漂亮终端报告；--json / --github 仍照常
+  --max-annotations <n>  Cap GitHub annotation lines (default: 20) · 限制注解条数
   --path <repo>       Repo root for install/uninstall (default: cwd)
   -h, --help          Show help
   -v, --version       Show version
@@ -30,16 +36,28 @@ Env
   VIBE / VIBE_COMMIT_VIBE   Default vibe when --vibe 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
+PR Checks can surface the proposed commit title / body / staged files. Job outputs
+title/subject/type/scope/breaking/engine/findings are written when GITHUB_OUTPUT
+is set (findings = staged file count). A short Markdown job summary is appended when
+GITHUB_STEP_SUMMARY is set. --quiet hides the pretty report only.
+
+配合 --github 时注解走 stdout（与 --json 联用则走 stderr，保持 JSON 干净）。
+有 GITHUB_OUTPUT 时写入 title/subject 等字段；有 GITHUB_STEP_SUMMARY 时追加 Job Summary。
+--quiet 只隐藏漂亮终端报告。
+
 Git hook
   After \`vibe-commit install\`, plain \`git commit\` (no -m) fills an empty /
   comment-only message file with a vibe-commit proposal. Skips merge, squash,
   amend (source=commit), and any message that already has non-comment text.
 
-Examples
+Examples · 示例
   git add -p
   vibe-commit
   vibe-commit --vibe playful --commit
   vibe-commit --breaking --dry-run
+  vibe-commit --github --quiet --no-ai
+  vibe-commit --github --json --max-annotations 10
   git commit -m "$(vibe-commit --dry-run)"
   vibe-commit install
   vibe-commit uninstall --path ~/projects/app
@@ -56,6 +74,9 @@ export function parseArgs(argv, env = process.env) {
         vibe: defaultVibeFromEnv(env),
         noAi: false,
         json: false,
+        github: false,
+        quiet: false,
+        maxAnnotations: 20,
         help: false,
         version: false,
         breaking: false,
@@ -96,6 +117,21 @@ export function parseArgs(argv, env = process.env) {
             options.json = true;
             continue;
         }
+        if (arg === "--github") {
+            options.github = true;
+            continue;
+        }
+        if (arg === "--quiet") {
+            options.quiet = true;
+            continue;
+        }
+        if (arg === "--max-annotations" || arg.startsWith("--max-annotations=")) {
+            const value = arg.includes("=")
+                ? arg.slice("--max-annotations=".length)
+                : argv[++i];
+            options.maxAnnotations = parseMaxAnnotations(value);
+            continue;
+        }
         if (arg === "--breaking") {
             options.breaking = true;
             continue;
@@ -160,6 +196,16 @@ function parseCommand(value) {
             return null;
     }
 }
+export function parseMaxAnnotations(value) {
+    const raw = value?.trim();
+    if (!raw)
+        throw new UsageError("Missing value for --max-annotations");
+    const n = Number(raw);
+    if (!Number.isInteger(n) || n < 1) {
+        throw new UsageError("--max-annotations must be a positive integer");
+    }
+    return n;
+}
 export function parseType(value) {
     const raw = value?.trim().toLowerCase();
     if (!raw)

package/dist/types.d.ts

@@ -49,6 +49,12 @@ export interface CliOptions {
     vibe: Vibe;
     noAi: boolean;
     json: boolean;
+    /** Emit GitHub Actions annotations / job outputs / step summary. */
+    github: boolean;
+    /** Suppress the pretty terminal report (--json / --github still emit). */
+    quiet: boolean;
+    /** Soft cap for --github annotation lines (default 20). */
+    maxAnnotations: number;
     help: boolean;
     version: boolean;
     /** Force breaking change marker and footer. */

package/examples/github-actions.yml

@@ -0,0 +1,49 @@
+# Example: surface a proposed commit message as Actions annotations + job summary.
+# Copy into your app repo as .github/workflows/vibe-commit.yml
+# (typically on pull_request so Checks show the draft commit).
+#
+# 示例：把拟写的 commit message 做成 Actions 注解 + Job Summary。
+# 复制到业务仓的 .github/workflows/vibe-commit.yml（通常挂在 pull_request 上）。
+#
+# Note: vibe-commit reads *staged* changes. Stage intentionally in CI, or
+# `git add -A` / `git add -u` before the step if you want the working tree.
+
+name: Vibe commit
+
+on:
+  pull_request:
+
+jobs:
+  vibe-commit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Stage working tree (demo)
+        run: git add -A
+
+      - name: Propose commit (annotations + summary)
+        id: vibe
+        run: |
+          npx --yes @webywz/vibe-commit@^0.1.14 \
+            --github \
+            --quiet \
+            --max-annotations 20 \
+            --no-ai
+        # --github           → ::notice / ::warning / ::error on the PR Checks UI
+        # --quiet            → suppress the pretty terminal report (annotations / summary / outputs still emit)
+        # --max-annotations  → soft-cap annotation noise (default 20)
+        # When GITHUB_OUTPUT is set, also writes: title, subject, type, scope, breaking, engine, findings
+        #   findings = staged file count
+        # When GITHUB_STEP_SUMMARY is set, appends a short Markdown job summary
+
+      # Optional: use job outputs from a later step
+      # - name: Echo title
+      #   run: echo "proposed ${{ steps.vibe.outputs.title }} (findings=${{ steps.vibe.outputs.findings }})"
+
+      # Optional: Job Summary is written automatically when GITHUB_STEP_SUMMARY is set
+      # (Actions injects it). No extra step required.

package/package.json

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