@kud/ai-conventional-commit-cli 0.11.0 → 0.12.0

package/dist/index.js

@@ -2,12 +2,27 @@
 import {
   loadConfig
 } from "./chunk-DCGUX6KW.js";
+import {
+  OpenCodeProvider,
+  abortMessage,
+  animateHeaderBase,
+  borderLine,
+  buildGenerationMessages,
+  buildRefineMessages,
+  checkCandidate,
+  createPhasedSpinner,
+  extractJSON,
+  finalSuccess,
+  formatCommitTitle,
+  renderCommitBlock,
+  sectionTitle
+} from "./chunk-H4W6AMGZ.js";
 
 // src/index.ts
 import { Cli, Command, Option } from "clipanion";
 
 // src/workflow/generate.ts
-import chalk2 from "chalk";
+import chalk from "chalk";
 import ora from "ora";
 
 // src/git.ts
@@ -146,265 +161,6 @@ var buildStyleProfile = (messages) => {
   };
 };
 
-// src/prompt.ts
-var summarizeDiffForPrompt = (files, privacy) => {
-  if (privacy === "high") {
-    return files.map((f) => `file: ${f.file} (+${f.additions} -${f.deletions}) hunks:${f.hunks.length}`).join("\n");
-  }
-  if (privacy === "medium") {
-    return files.map(
-      (f) => `file: ${f.file}
-` + f.hunks.map(
-        (h) => `  hunk ${h.hash} context:${h.functionContext || ""} +${h.added} -${h.removed}`
-      ).join("\n")
-    ).join("\n");
-  }
-  return files.map(
-    (f) => `file: ${f.file}
-` + f.hunks.map(
-      (h) => `${h.header}
-${h.lines.slice(0, 40).join("\n")}${h.lines.length > 40 ? "\n[truncated]" : ""}`
-    ).join("\n")
-  ).join("\n");
-};
-var buildGenerationMessages = (opts) => {
-  const { files, style, config, mode, desiredCommits } = opts;
-  const diff = summarizeDiffForPrompt(files, config.privacy);
-  const TYPE_MAP = {
-    feat: "A new feature or capability added for the user",
-    fix: "A bug fix resolving incorrect behavior",
-    chore: "Internal change with no user-facing impact",
-    docs: "Documentation-only changes",
-    refactor: "Code change that neither fixes a bug nor adds a feature",
-    test: "Adding or improving tests only",
-    ci: "Changes to CI configuration or scripts",
-    perf: "Performance improvement",
-    style: "Formatting or stylistic change (no logic)",
-    build: "Build system or dependency changes",
-    revert: "Revert a previous commit",
-    merge: "Merge branches (rare; only if truly a merge commit)",
-    security: "Security-related change or hardening",
-    release: "Version bump or release meta change"
-  };
-  const specLines = [];
-  specLines.push(
-    "Purpose: Generate high-quality Conventional Commit messages for the provided git diff."
-  );
-  specLines.push("Locale: en");
-  specLines.push(
-    'Output JSON Schema: { "commits": [ { "title": string, "body": string, "score": 0-100, "reasons": string[], "files"?: string[] } ], "meta": { "splitRecommended": boolean } }'
-  );
-  specLines.push("Primary Output Field: commits[ ].title");
-  specLines.push("Title Format: <type>(<optional-scope>): <subject>");
-  specLines.push(
-    "Title Length Guidance: Aim for <=50 chars ideal; absolute max 72 (do not exceed)."
-  );
-  specLines.push("Types (JSON mapping follows on next line)");
-  specLines.push("TypeMap: " + JSON.stringify(TYPE_MAP));
-  specLines.push("Scope Rules: optional; if present, lowercase kebab-case; omit when unclear.");
-  specLines.push(
-    "Subject Rules: imperative mood, present tense, no leading capital unless proper noun, no trailing period."
-  );
-  specLines.push(
-    "Length Rule: Keep titles concise; prefer 50 or fewer chars; MUST be <=72 including type/scope."
-  );
-  specLines.push(
-    "Emoji Rule: " + (config.style === "gitmoji" || config.style === "gitmoji-pure" ? "OPTIONAL single leading gitmoji BEFORE the type only if confidently adds clarity; do not invent or stack; omit if unsure." : "Disallow all emojis and gitmoji codes; output must start directly with the type.")
-  );
-  specLines.push(
-    "Forbidden: breaking changes notation, exclamation mark after type unless truly semver-major (avoid unless diff clearly indicates)."
-  );
-  specLines.push("Fallback Type: use chore when no other type clearly fits.");
-  specLines.push("Consistency: prefer existing top prefixes: " + style.topPrefixes.join(", "));
-  specLines.push("Provide score (0-100) measuring clarity & specificity (higher is better).");
-  specLines.push(
-    "Provide reasons array citing concrete diff elements: filenames, functions, tests, metrics."
-  );
-  specLines.push(
-    'When mode is split, WHERE POSSIBLE add a "files" array per commit listing the most relevant changed file paths (1-6, minimize overlap across commits).'
-  );
-  specLines.push("Return ONLY the JSON object. No surrounding text or markdown.");
-  specLines.push("Do not add fields not listed in schema.");
-  specLines.push("Never fabricate content not present or implied by the diff.");
-  specLines.push(
-    "If mode is split and multiple logical changes exist, set meta.splitRecommended=true."
-  );
-  return [
-    {
-      role: "system",
-      content: specLines.join("\n")
-    },
-    {
-      role: "user",
-      content: `Mode: ${mode}
-RequestedCommitCount: ${desiredCommits || (mode === "split" ? "2-6" : 1)}
-StyleFingerprint: ${JSON.stringify(style)}
-Diff:
-${diff}
-Generate commit candidates now.`
-    }
-  ];
-};
-var buildRefineMessages = (opts) => {
-  const { originalPlan, index, instructions, config } = opts;
-  const target = originalPlan.commits[index];
-  const spec = [];
-  spec.push("Purpose: Refine a single Conventional Commit message while preserving intent.");
-  spec.push("Locale: en");
-  spec.push("Input: one existing commit JSON object.");
-  spec.push(
-    'Output JSON Schema: { "commits": [ { "title": string, "body": string, "score": 0-100, "reasons": string[] } ] }'
-  );
-  spec.push("Title Format: <type>(<optional-scope>): <subject> (<=72 chars)");
-  spec.push("Subject: imperative, present tense, no trailing period.");
-  spec.push(
-    "Emoji Rule: " + (config.style === "gitmoji" || config.style === "gitmoji-pure" ? "OPTIONAL single leading gitmoji BEFORE type if it adds clarity; omit if unsure." : "Disallow all emojis; start directly with the type.")
-  );
-  spec.push("Preserve semantic meaning; only improve clarity, scope, brevity, conformity.");
-  spec.push("If instructions request scope or emoji, incorporate only if justified by content.");
-  spec.push("Return ONLY JSON (commits array length=1).");
-  return [
-    { role: "system", content: spec.join("\n") },
-    {
-      role: "user",
-      content: `Current commit object:
-${JSON.stringify(target, null, 2)}
-Instructions:
-${instructions.join("\n") || "None"}
-Refine now.`
-    }
-  ];
-};
-
-// src/model/provider.ts
-import { z } from "zod";
-import { execa } from "execa";
-var OpenCodeProvider = class {
-  constructor(model = "github-copilot/gpt-4.1") {
-    this.model = model;
-  }
-  name() {
-    return "opencode";
-  }
-  async chat(messages, _opts) {
-    const debug = process.env.AICC_DEBUG === "true";
-    const mockMode = process.env.AICC_DEBUG_PROVIDER === "mock";
-    const timeoutMs = parseInt(process.env.AICC_MODEL_TIMEOUT_MS || "120000", 10);
-    const eager = process.env.AICC_EAGER_PARSE !== "false";
-    const userAggregate = messages.map((m) => `${m.role.toUpperCase()}: ${m.content}`).join("\n\n");
-    const command = `Generate high-quality commit message candidates based on the staged git diff.`;
-    const fullPrompt = `${command}
-
-Context:
-${userAggregate}`;
-    if (mockMode) {
-      if (debug) console.error("[ai-cc][mock] Returning deterministic mock response");
-      return JSON.stringify({
-        commits: [
-          {
-            title: "chore: mock commit from provider",
-            body: "",
-            score: 80,
-            reasons: ["mock mode"]
-          }
-        ],
-        meta: { splitRecommended: false }
-      });
-    }
-    const start = Date.now();
-    return await new Promise((resolve2, reject) => {
-      let resolved = false;
-      let acc = "";
-      const includeLogs = process.env.AICC_PRINT_LOGS === "true";
-      const args = ["run", fullPrompt, "--model", this.model];
-      if (includeLogs) args.push("--print-logs");
-      const subprocess = execa("opencode", args, {
-        timeout: timeoutMs,
-        input: ""
-        // immediately close stdin in case CLI waits for it
-      });
-      const finish = (value) => {
-        if (resolved) return;
-        resolved = true;
-        const elapsed = Date.now() - start;
-        if (debug) {
-          console.error(
-            `[ai-cc][provider] model=${this.model} elapsedMs=${elapsed} promptChars=${fullPrompt.length} bytesOut=${value.length}`
-          );
-        }
-        resolve2(value);
-      };
-      const tryEager = () => {
-        if (!eager) return;
-        const first = acc.indexOf("{");
-        const last = acc.lastIndexOf("}");
-        if (first !== -1 && last !== -1 && last > first) {
-          const candidate = acc.slice(first, last + 1).trim();
-          try {
-            JSON.parse(candidate);
-            if (debug) console.error("[ai-cc][provider] eager JSON detected, terminating process");
-            subprocess.kill("SIGTERM");
-            finish(candidate);
-          } catch {
-          }
-        }
-      };
-      subprocess.stdout?.on("data", (chunk) => {
-        const text = chunk.toString();
-        acc += text;
-        tryEager();
-      });
-      subprocess.stderr?.on("data", (chunk) => {
-        if (debug) console.error("[ai-cc][provider][stderr]", chunk.toString().trim());
-      });
-      subprocess.then(({ stdout }) => {
-        if (!resolved) finish(stdout);
-      }).catch((e) => {
-        if (resolved) return;
-        const elapsed = Date.now() - start;
-        if (e.timedOut) {
-          return reject(
-            new Error(`Model call timed out after ${timeoutMs}ms (elapsed=${elapsed}ms)`)
-          );
-        }
-        if (debug) console.error("[ai-cc][provider] failure", e.stderr || e.message);
-        reject(new Error(e.stderr || e.message || "opencode invocation failed"));
-      });
-    });
-  }
-};
-var CommitSchema = z.object({
-  title: z.string().min(5).max(150),
-  body: z.string().optional().default(""),
-  score: z.number().min(0).max(100),
-  reasons: z.array(z.string()).optional().default([]),
-  files: z.array(z.string()).optional().default([])
-});
-var PlanSchema = z.object({
-  commits: z.array(CommitSchema).min(1),
-  meta: z.object({
-    splitRecommended: z.boolean().optional()
-  }).optional()
-});
-var extractJSON = (raw) => {
-  const trimmed = raw.trim();
-  let jsonText = null;
-  if (trimmed.startsWith("{") && trimmed.endsWith("}")) {
-    jsonText = trimmed;
-  } else {
-    const match = raw.match(/\{[\s\S]*\}$/m);
-    if (match) jsonText = match[0];
-  }
-  if (!jsonText) throw new Error("No JSON object detected.");
-  let parsed;
-  try {
-    parsed = JSON.parse(jsonText);
-  } catch (e) {
-    throw new Error("Invalid JSON parse");
-  }
-  return PlanSchema.parse(parsed);
-};
-
 // src/plugins.ts
 import { resolve } from "path";
 async function loadPlugins(config, cwd = process.cwd()) {
@@ -443,283 +199,10 @@ async function runValidations(candidate, plugins, ctx) {
   return errors;
 }
 
-// src/guardrails.ts
-var SECRET_PATTERNS = [
-  /AWS_[A-Z0-9_]+/i,
-  /BEGIN RSA PRIVATE KEY/,
-  /-----BEGIN PRIVATE KEY-----/,
-  /ssh-rsa AAAA/
-];
-var CONVENTIONAL_RE = /^(?:([\p{Emoji}\p{So}\p{Sk}]+)\s+(feat|fix|chore|docs|refactor|test|ci|perf|style|build|revert|merge|security|release)(\(.+\))?:\s|([\p{Emoji}\p{So}\p{Sk}]+):\s.*|([\p{Emoji}\p{So}\p{Sk}]+):\s*$|(feat|fix|chore|docs|refactor|test|ci|perf|style|build|revert|merge|security|release)(\(.+\))?:\s)/u;
-var sanitizeTitle = (title, allowEmoji) => {
-  let t = title.trim();
-  if (allowEmoji) {
-    const multi = t.match(/^((?:[\p{Emoji}\p{So}\p{Sk}]+)[\p{Emoji}\p{So}\p{Sk}\s]*)+/u);
-    if (multi) {
-      const first = Array.from(multi[0].trim())[0];
-      t = first + " " + t.slice(multi[0].length).trimStart();
-    }
-  } else {
-    t = t.replace(/^([\p{Emoji}\p{So}\p{Sk}\p{P}]+\s*)+/u, "").trimStart();
-  }
-  return t;
-};
-var normalizeConventionalTitle = (title) => {
-  let original = title.trim();
-  let leadingEmoji = "";
-  const emojiCluster = original.match(/^[\p{Emoji}\p{So}\p{Sk}]+/u);
-  if (emojiCluster) {
-    leadingEmoji = Array.from(emojiCluster[0])[0];
-  }
-  let t = original.replace(/^([\p{Emoji}\p{So}\p{Sk}\p{P}]+\s*)+/u, "").trim();
-  const m = t.match(/^(\w+)(\(.+\))?:\s+(.*)$/);
-  let result;
-  if (m) {
-    const type = m[1].toLowerCase();
-    const scope = m[2] || "";
-    let subject = m[3].trim();
-    subject = subject.replace(/\.$/, "");
-    subject = subject.charAt(0).toLowerCase() + subject.slice(1);
-    result = `${type}${scope}: ${subject}`;
-  } else if (!/^\w+\(.+\)?: /.test(t)) {
-    t = t.replace(/\.$/, "");
-    t = t.charAt(0).toLowerCase() + t.slice(1);
-    result = `chore: ${t}`;
-  } else {
-    result = t;
-  }
-  if (leadingEmoji) {
-    result = `${leadingEmoji} ${result}`;
-  }
-  return result;
-};
-var checkCandidate = (candidate) => {
-  const errs = [];
-  if (!CONVENTIONAL_RE.test(candidate.title)) {
-    errs.push("Not a valid conventional commit title.");
-  }
-  if (/^[A-Z]/.test(candidate.title)) {
-  }
-  const body = candidate.body || "";
-  for (const pat of SECRET_PATTERNS) {
-    if (pat.test(body)) {
-      errs.push("Potential secret detected.");
-      break;
-    }
-  }
-  return errs;
-};
-
-// src/title-format.ts
-var EMOJI_MAP = {
-  feat: "\u2728",
-  fix: "\u{1F41B}",
-  chore: "\u{1F9F9}",
-  docs: "\u{1F4DD}",
-  refactor: "\u267B\uFE0F",
-  test: "\u2705",
-  ci: "\u{1F916}",
-  perf: "\u26A1\uFE0F",
-  style: "\u{1F3A8}",
-  build: "\u{1F3D7}\uFE0F",
-  revert: "\u23EA",
-  merge: "\u{1F500}",
-  security: "\u{1F512}",
-  release: "\u{1F3F7}\uFE0F"
-};
-var EMOJI_TYPE_RE = /^([\p{Emoji}\p{So}\p{Sk}])\s+(\w+)(\(.+\))?:\s+(.*)$/u;
-var TYPE_RE = /^(\w+)(\(.+\))?:\s+(.*)$/;
-var formatCommitTitle = (raw, opts) => {
-  const { allowGitmoji, mode = "standard" } = opts;
-  let norm = normalizeConventionalTitle(sanitizeTitle(raw, allowGitmoji));
-  if (!allowGitmoji || mode !== "gitmoji" && mode !== "gitmoji-pure") {
-    return norm;
-  }
-  if (mode === "gitmoji-pure") {
-    let m2 = norm.match(EMOJI_TYPE_RE);
-    if (m2) {
-      const emoji = m2[1];
-      const subject = m2[4];
-      norm = `${emoji}: ${subject}`;
-    } else if (m2 = norm.match(TYPE_RE)) {
-      const type = m2[1];
-      const subject = m2[3];
-      const em = EMOJI_MAP[type] || "\u{1F527}";
-      norm = `${em}: ${subject}`;
-    } else if (!/^([\p{Emoji}\p{So}\p{Sk}])+:/u.test(norm)) {
-      norm = `\u{1F527}: ${norm}`;
-    }
-    return norm;
-  }
-  let m = norm.match(EMOJI_TYPE_RE);
-  if (m) {
-    return norm;
-  }
-  if (m = norm.match(TYPE_RE)) {
-    const type = m[1];
-    const scope = m[2] || "";
-    const subject = m[3];
-    const em = EMOJI_MAP[type] || "\u{1F527}";
-    norm = `${em} ${type}${scope}: ${subject}`;
-  } else if (!/^([\p{Emoji}\p{So}\p{Sk}])+\s+\w+.*:/u.test(norm)) {
-    norm = `\u{1F527} chore: ${norm}`;
-  }
-  return norm;
-};
-
 // src/workflow/generate.ts
 import { writeFileSync, mkdirSync, existsSync } from "fs";
 import { join } from "path";
 import inquirer from "inquirer";
-
-// src/workflow/ui.ts
-import chalk from "chalk";
-function animateHeaderBase(text = "ai-conventional-commit", modelSegment) {
-  const mainText = text;
-  const modelSeg = modelSegment ? ` (using ${modelSegment})` : "";
-  if (!process.stdout.isTTY || process.env.AICC_NO_ANIMATION) {
-    if (modelSeg) console.log("\n\u250C " + chalk.bold(mainText) + chalk.dim(modelSeg));
-    else console.log("\n\u250C " + chalk.bold(mainText));
-    return Promise.resolve();
-  }
-  const palette = [
-    "#3a0d6d",
-    "#5a1ea3",
-    "#7a32d6",
-    "#9a4dff",
-    "#b267ff",
-    "#c37dff",
-    "#b267ff",
-    "#9a4dff",
-    "#7a32d6",
-    "#5a1ea3"
-  ];
-  process.stdout.write("\n");
-  return palette.reduce(async (p, color) => {
-    await p;
-    const frame = chalk.bold.hex(color)(mainText);
-    if (modelSeg) process.stdout.write("\r\u250C " + frame + chalk.dim(modelSeg));
-    else process.stdout.write("\r\u250C " + frame);
-    await new Promise((r) => setTimeout(r, 60));
-  }, Promise.resolve()).then(() => process.stdout.write("\n"));
-}
-function borderLine(content) {
-  if (!content) console.log("\u2502");
-  else console.log("\u2502 " + content);
-}
-function sectionTitle(label) {
-  console.log("\u2299 " + chalk.bold(label));
-}
-function abortMessage() {
-  console.log("\u2514 \u{1F645}\u200D\u2640\uFE0F No commit created.");
-  console.log();
-}
-function finalSuccess(opts) {
-  const elapsedMs = Date.now() - opts.startedAt;
-  const seconds = elapsedMs / 1e3;
-  const dur = seconds >= 0.1 ? seconds.toFixed(1) + "s" : elapsedMs + "ms";
-  const plural = opts.count !== 1;
-  if (plural) console.log(`\u2514 \u2728 ${opts.count} commits created in ${dur}.`);
-  else console.log(`\u2514 \u2728 commit created in ${dur}.`);
-  console.log();
-}
-function createPhasedSpinner(oraLib) {
-  const useAnim = process.stdout.isTTY && !process.env.AICC_NO_ANIMATION && !process.env.AICC_NO_SPINNER_ANIM;
-  const palette = [
-    "#3a0d6d",
-    "#5a1ea3",
-    "#7a32d6",
-    "#9a4dff",
-    "#b267ff",
-    "#c37dff",
-    "#b267ff",
-    "#9a4dff",
-    "#7a32d6",
-    "#5a1ea3"
-  ];
-  let label = "Starting";
-  let i = 0;
-  const spinner = oraLib({ text: chalk.bold(label), spinner: "dots" }).start();
-  let interval = null;
-  function frame() {
-    if (!useAnim) return;
-    spinner.text = chalk.bold.hex(palette[i])(label);
-    i = (i + 1) % palette.length;
-  }
-  if (useAnim) {
-    frame();
-    interval = setInterval(frame, 80);
-  }
-  function setLabel(next) {
-    label = next;
-    if (useAnim) {
-      i = 0;
-      frame();
-    } else {
-      spinner.text = chalk.bold(label);
-    }
-  }
-  function stopAnim() {
-    if (interval) {
-      clearInterval(interval);
-      interval = null;
-    }
-  }
-  return {
-    spinner,
-    async step(l, fn) {
-      setLabel(l);
-      try {
-        return await fn();
-      } catch (e) {
-        stopAnim();
-        const msg = `${l} failed: ${e?.message || e}`.replace(/^\s+/, "");
-        spinner.fail(msg);
-        throw e;
-      }
-    },
-    phase(l) {
-      setLabel(l);
-    },
-    stop() {
-      stopAnim();
-      spinner.stop();
-    }
-  };
-}
-function renderCommitBlock(opts) {
-  const dim = (s) => chalk.dim(s);
-  const white = (s) => chalk.white(s);
-  const msgColor = opts.messageLabelColor || dim;
-  const descColor = opts.descriptionLabelColor || dim;
-  const titleColor = opts.titleColor || white;
-  const bodyFirst = opts.bodyFirstLineColor || white;
-  const bodyRest = opts.bodyLineColor || white;
-  if (opts.fancy) {
-    const heading = opts.heading ? chalk.hex("#9a4dff").bold(opts.heading) : void 0;
-    if (heading) borderLine(heading);
-    borderLine(msgColor("Title:") + " " + titleColor(`${opts.indexPrefix || ""}${opts.title}`));
-  } else {
-    if (opts.heading) borderLine(chalk.bold(opts.heading));
-    if (!opts.hideMessageLabel)
-      borderLine(msgColor("Message:") + " " + titleColor(`${opts.indexPrefix || ""}${opts.title}`));
-    else
-      borderLine(msgColor("Title:") + " " + titleColor(`${opts.indexPrefix || ""}${opts.title}`));
-  }
-  borderLine();
-  if (opts.body) {
-    const lines = opts.body.split("\n");
-    lines.forEach((line, i) => {
-      if (line.trim().length === 0) borderLine();
-      else if (i === 0) {
-        borderLine(descColor("Description:"));
-        borderLine(bodyFirst(line));
-      } else borderLine(bodyRest(line));
-    });
-  }
-}
-
-// src/workflow/generate.ts
 async function runGenerate(config) {
   const startedAt = Date.now();
   if (!await ensureStagedChanges()) {
@@ -743,7 +226,7 @@ async function runGenerate(config) {
     const deltas = files.map((f) => (f.additions || 0) + (f.deletions || 0));
     const maxDelta = Math.max(...deltas, 1);
     borderLine(
-      chalk2.dim(`Detected ${files.length} staged ${files.length === 1 ? "file" : "files"}:`)
+      chalk.dim(`Detected ${files.length} staged ${files.length === 1 ? "file" : "files"}:`)
     );
     let totalAdd = 0;
     let totalDel = 0;
@@ -760,13 +243,13 @@ async function runGenerate(config) {
       const barLen = Math.max(1, Math.round(delta / maxDelta * BAR_WIDTH));
       const addPortion = Math.min(barLen, Math.round(barLen * (add / (delta || 1))));
       const delPortion = barLen - addPortion;
-      const bar = chalk2.green("+".repeat(addPortion)) + chalk2.red("-".repeat(delPortion));
-      const counts = chalk2.green("+" + add) + " " + chalk2.red("-" + del);
+      const bar = chalk.green("+".repeat(addPortion)) + chalk.red("-".repeat(delPortion));
+      const counts = chalk.green("+" + add) + " " + chalk.red("-" + del);
       const name = f.file.length > maxName ? f.file.slice(0, maxName - 1) + "\u2026" : f.file;
       borderLine(name.padEnd(maxName) + " | " + counts.padEnd(12) + " " + bar);
     });
     borderLine(
-      chalk2.dim(
+      chalk.dim(
         `${files.length} file${files.length === 1 ? "" : "s"} changed, ${totalAdd} insertion${totalAdd === 1 ? "" : "s"}(+), ${totalDel} deletion${totalDel === 1 ? "" : "s"}(-)`
       )
     );
@@ -819,8 +302,8 @@ async function runGenerate(config) {
   const errors = [...pluginErrors, ...guardErrors];
   if (errors.length) {
     borderLine();
-    console.log("\u2299 " + chalk2.bold("Checks"));
-    const errorLines = ["Validation issues:", ...errors.map((e) => chalk2.red("\u2022 " + e))];
+    console.log("\u2299 " + chalk.bold("Checks"));
+    const errorLines = ["Validation issues:", ...errors.map((e) => chalk.red("\u2022 " + e))];
     errorLines.forEach((l) => borderLine(l));
   }
   borderLine();
@@ -857,7 +340,7 @@ async function selectYesNo() {
 }
 
 // src/workflow/split.ts
-import chalk3 from "chalk";
+import chalk2 from "chalk";
 import ora2 from "ora";
 
 // src/cluster.ts
@@ -926,7 +409,7 @@ async function runSplit(config, desired) {
     const deltas = files.map((f) => (f.additions || 0) + (f.deletions || 0));
     const maxDelta = Math.max(...deltas, 1);
     borderLine(
-      chalk3.dim(`Detected ${files.length} staged ${files.length === 1 ? "file" : "files"}:`)
+      chalk2.dim(`Detected ${files.length} staged ${files.length === 1 ? "file" : "files"}:`)
     );
     let totalAdd = 0;
     let totalDel = 0;
@@ -943,13 +426,13 @@ async function runSplit(config, desired) {
       const barLen = Math.max(1, Math.round(delta / maxDelta * BAR_WIDTH));
       const addPortion = Math.min(barLen, Math.round(barLen * (add / (delta || 1))));
       const delPortion = barLen - addPortion;
-      const bar = chalk3.green("+".repeat(addPortion)) + chalk3.red("-".repeat(delPortion));
-      const counts = chalk3.green("+" + add) + " " + chalk3.red("-" + del);
+      const bar = chalk2.green("+".repeat(addPortion)) + chalk2.red("-".repeat(delPortion));
+      const counts = chalk2.green("+" + add) + " " + chalk2.red("-" + del);
       const name = f.file.length > maxName ? f.file.slice(0, maxName - 1) + "\u2026" : f.file;
       borderLine(name.padEnd(maxName) + " | " + counts.padEnd(12) + " " + bar);
     });
     borderLine(
-      chalk3.dim(
+      chalk2.dim(
         `${files.length} file${files.length === 1 ? "" : "s"} changed, ${totalAdd} insertion${totalAdd === 1 ? "" : "s"}(+), ${totalDel} deletion${totalDel === 1 ? "" : "s"}(-)`
       )
     );
@@ -1061,7 +544,7 @@ function saveSession2(data) {
 }
 
 // src/workflow/refine.ts
-import chalk4 from "chalk";
+import chalk3 from "chalk";
 import ora3 from "ora";
 import inquirer3 from "inquirer";
 import { readFileSync, existsSync as existsSync3, writeFileSync as writeFileSync3, mkdirSync as mkdirSync3 } from "fs";
@@ -1114,11 +597,11 @@ async function runRefine(config, options) {
   }
   sectionTitle("Original");
   const original = plan.commits[index];
-  const originalLines = [chalk4.yellow(original.title)];
+  const originalLines = [chalk3.yellow(original.title)];
   if (original.body) {
     original.body.split("\n").forEach((line) => {
       if (line.trim().length === 0) originalLines.push("");
-      else originalLines.push(chalk4.white(line));
+      else originalLines.push(chalk3.white(line));
     });
   }
   originalLines.forEach((l) => l.trim().length === 0 ? borderLine() : borderLine(l));
@@ -1157,7 +640,7 @@ async function runRefine(config, options) {
   renderCommitBlock({
     title: refinedPlan.commits[0].title,
     body: refinedPlan.commits[0].body,
-    titleColor: (s) => chalk4.yellow(s)
+    titleColor: (s) => chalk3.yellow(s)
   });
   borderLine();
   const { ok } = await inquirer3.prompt([
@@ -1186,7 +669,7 @@ async function runRefine(config, options) {
 // package.json
 var package_default = {
   name: "@kud/ai-conventional-commit-cli",
-  version: "0.11.0",
+  version: "0.12.0",
   type: "module",
   description: "Opinionated, style-aware AI assistant for crafting and splitting git commits (opencode-based, provider-agnostic).",
   bin: {
@@ -1256,7 +739,7 @@ var package_default = {
 };
 
 // src/index.ts
-import { execa as execa2 } from "execa";
+import { execa } from "execa";
 import inquirer4 from "inquirer";
 var pkgVersion = package_default.version || "0.0.0";
 var RootCommand = class extends Command {
@@ -1436,7 +919,7 @@ var ModelsCommand = class extends Command {
       return;
     }
     try {
-      const { stdout } = await execa2("opencode", ["models"]).catch(async (err) => {
+      const { stdout } = await execa("opencode", ["models"]).catch(async (err) => {
         if (err.shortMessage && /ENOENT/.test(err.shortMessage)) {
           this.context.stderr.write(
             "opencode CLI not found in PATH. Install it from https://github.com/opencodejs/opencode or ensure the binary is available.\n"
@@ -1587,6 +1070,58 @@ var ConfigSetCommand = class extends Command {
 `);
   }
 };
+var RewordCommand = class extends Command {
+  static paths = [[`reword`]];
+  static usage = Command.Usage({
+    description: "AI-assisted reword of an existing commit (by hash).",
+    details: "Generate an improved Conventional Commit message for the given commit hash. If the hash is HEAD the commit is amended; otherwise rebase instructions are shown. If no hash is provided, an interactive picker of recent commits appears.",
+    examples: [
+      ["Interactive pick", "ai-conventional-commit reword"],
+      ["Reword HEAD", "ai-conventional-commit reword HEAD"],
+      ["Reword older commit", "ai-conventional-commit reword d30fd1b"]
+    ]
+  });
+  hash = Option.String({ required: false });
+  async execute() {
+    const { runReword } = await import("./reword-FE5N4MGV.js");
+    const config = await loadConfig();
+    let target = this.hash;
+    if (!target) {
+      try {
+        const { simpleGit: simpleGit2 } = await import("simple-git");
+        const git2 = simpleGit2();
+        const log = await git2.log({ maxCount: 20 });
+        if (!log.all.length) {
+          this.context.stderr.write("No commits available to select.\n");
+          return;
+        }
+        const choices = log.all.map((c) => ({
+          name: `${c.hash.slice(0, 7)} ${c.message.split("\n")[0]}`.slice(0, 80),
+          value: c.hash
+        }));
+        choices.push({ name: "Cancel", value: "__CANCEL__" });
+        const { picked } = await inquirer4.prompt([
+          {
+            type: "list",
+            name: "picked",
+            message: "Select a commit to reword",
+            choices,
+            pageSize: Math.min(choices.length, 15)
+          }
+        ]);
+        if (picked === "__CANCEL__") {
+          this.context.stdout.write("Aborted.\n");
+          return;
+        }
+        target = picked;
+      } catch (e) {
+        this.context.stderr.write("Failed to list commits: " + (e?.message || e) + "\n");
+        return;
+      }
+    }
+    await runReword(config, target);
+  }
+};
 var VersionCommand = class extends Command {
   static paths = [[`--version`], [`-V`]];
   async execute() {
@@ -1607,6 +1142,7 @@ cli.register(ModelsCommand);
 cli.register(ConfigShowCommand);
 cli.register(ConfigGetCommand);
 cli.register(ConfigSetCommand);
+cli.register(RewordCommand);
 cli.register(VersionCommand);
 cli.runExit(process.argv.slice(2), {
   stdin: process.stdin,