@releasekit/notes 0.1.0 → 0.2.0-next.0

package/dist/cli.cjs

@@ -233,15 +233,17 @@ var OllamaProvider = class extends BaseLLMProvider {
   name = "ollama";
   baseURL;
   model;
+  apiKey;
   constructor(config = {}) {
     super();
     this.baseURL = config.baseURL ?? process.env.OLLAMA_BASE_URL ?? "http://localhost:11434";
     this.model = config.model ?? LLM_DEFAULTS.models.ollama;
+    this.apiKey = config.apiKey ?? process.env.OLLAMA_API_KEY;
   }
   async complete(prompt, options) {
     const requestBody = {
       model: this.model,
-      prompt,
+      messages: [{ role: "user", content: prompt }],
       stream: false,
       options: {
         num_predict: this.getMaxTokens(options),
@@ -249,11 +251,16 @@ var OllamaProvider = class extends BaseLLMProvider {
       }
     };
     try {
-      const response = await fetch(`${this.baseURL}/api/generate`, {
+      const headers = {
+        "Content-Type": "application/json"
+      };
+      if (this.apiKey) {
+        headers["Authorization"] = `Bearer ${this.apiKey}`;
+      }
+      const baseUrl = this.baseURL.endsWith("/api") ? this.baseURL.slice(0, -4) : this.baseURL;
+      const response = await fetch(`${baseUrl}/api/chat`, {
         method: "POST",
-        headers: {
-          "Content-Type": "application/json"
-        },
+        headers,
         body: JSON.stringify(requestBody)
       });
       if (!response.ok) {
@@ -261,10 +268,10 @@ var OllamaProvider = class extends BaseLLMProvider {
         throw new LLMError(`Ollama request failed: ${response.status} ${text}`);
       }
       const data = await response.json();
-      if (!data.response) {
+      if (!data.message?.content) {
         throw new LLMError("Empty response from Ollama");
       }
-      return data.response;
+      return data.message.content;
     } catch (error2) {
       if (error2 instanceof LLMError) throw error2;
       throw new LLMError(`Ollama error: ${error2 instanceof Error ? error2.message : String(error2)}`);
@@ -347,7 +354,7 @@ var OpenAICompatibleProvider = class extends BaseLLMProvider {
 
 // src/llm/tasks/categorize.ts
 var import_core3 = require("@releasekit/core");
-var CATEGORIZE_PROMPT = `You are categorizing changelog entries for a software release.
+var DEFAULT_CATEGORIZE_PROMPT = `You are categorizing changelog entries for a software release.
 
 Given the following entries, group them into meaningful categories (e.g., "Core", "UI", "API", "Performance", "Bug Fixes", "Documentation").
 
@@ -357,24 +364,61 @@ Entries:
 {{entries}}
 
 Output only valid JSON, nothing else:`;
-async function categorizeEntries(provider, entries, _context) {
+function buildCustomCategorizePrompt(categories) {
+  const categoryList = categories.map((c) => `- "${c.name}": ${c.description}`).join("\n");
+  return `You are categorizing changelog entries for a software release.
+
+Given the following entries, group them into the specified categories. Only use the categories listed below.
+
+Categories:
+${categoryList}
+
+For entries in categories that involve internal/developer changes, set a "scope" field on those entries with a short subcategory label (e.g., "CI", "Dependencies", "Testing", "Code Quality", "Build System").
+
+Output a JSON object with two fields:
+- "categories": an object where keys are category names and values are arrays of entry indices (0-based)
+- "scopes": an object where keys are entry indices (as strings) and values are scope labels
+
+Entries:
+{{entries}}
+
+Output only valid JSON, nothing else:`;
+}
+async function categorizeEntries(provider, entries, context) {
   if (entries.length === 0) {
     return [];
   }
   const entriesText = entries.map((e, i) => `${i}. [${e.type}]${e.scope ? ` (${e.scope})` : ""}: ${e.description}`).join("\n");
-  const prompt = CATEGORIZE_PROMPT.replace("{{entries}}", entriesText);
+  const hasCustomCategories = context.categories && context.categories.length > 0;
+  const promptTemplate = hasCustomCategories ? buildCustomCategorizePrompt(context.categories) : DEFAULT_CATEGORIZE_PROMPT;
+  const prompt = promptTemplate.replace("{{entries}}", entriesText);
   try {
     const response = await provider.complete(prompt);
     const cleaned = response.replace(/^```(?:json)?\n?/, "").replace(/\n?```$/, "").trim();
     const parsed = JSON.parse(cleaned);
     const result = [];
-    for (const [category, indices] of Object.entries(parsed)) {
-      const categoryEntries = indices.map((i) => entries[i]).filter((e) => e !== void 0);
-      if (categoryEntries.length > 0) {
-        result.push({
-          category,
-          entries: categoryEntries
-        });
+    if (hasCustomCategories && parsed.categories) {
+      const categoryMap = parsed.categories;
+      const scopeMap = parsed.scopes || {};
+      for (const [indexStr, scope] of Object.entries(scopeMap)) {
+        const idx = Number.parseInt(indexStr, 10);
+        if (entries[idx] && scope) {
+          entries[idx] = { ...entries[idx], scope };
+        }
+      }
+      for (const [category, indices] of Object.entries(categoryMap)) {
+        const categoryEntries = indices.map((i) => entries[i]).filter((e) => e !== void 0);
+        if (categoryEntries.length > 0) {
+          result.push({ category, entries: categoryEntries });
+        }
+      }
+    } else {
+      const categoryMap = parsed;
+      for (const [category, indices] of Object.entries(categoryMap)) {
+        const categoryEntries = indices.map((i) => entries[i]).filter((e) => e !== void 0);
+        if (categoryEntries.length > 0) {
+          result.push({ category, entries: categoryEntries });
+        }
       }
     }
     return result;
@@ -392,10 +436,10 @@ Given a technical commit message, rewrite it as a clear, user-friendly changelog
 
 Rules:
 - Be concise (1-2 sentences max)
-- Use present tense ("Add feature" not "Added feature")
 - Focus on user impact, not implementation details
 - Don't use technical jargon unless necessary
 - Preserve the scope if mentioned (e.g., "core:", "api:")
+{{style}}
 
 Original entry:
 Type: {{type}}
@@ -404,7 +448,8 @@ Description: {{description}}
 
 Rewritten description (only output the new description, nothing else):`;
 async function enhanceEntry(provider, entry, _context) {
-  const prompt = ENHANCE_PROMPT.replace("{{type}}", entry.type).replace("{{#if scope}}Scope: {{scope}}{{/if}}", entry.scope ? `Scope: ${entry.scope}` : "").replace("{{description}}", entry.description);
+  const styleText = _context.style ? `- ${_context.style}` : '- Use present tense ("Add feature" not "Added feature")';
+  const prompt = ENHANCE_PROMPT.replace("{{style}}", styleText).replace("{{type}}", entry.type).replace("{{#if scope}}Scope: {{scope}}{{/if}}", entry.scope ? `Scope: ${entry.scope}` : "").replace("{{description}}", entry.description);
   const response = await provider.complete(prompt);
   return response.trim();
 }
@@ -506,6 +551,7 @@ function createProvider(config) {
       });
     case "ollama":
       return new OllamaProvider({
+        apiKey,
         baseURL: config.baseURL,
         model: config.model
       });
@@ -578,6 +624,10 @@ function formatVersion(context) {
     lines.push(`[Full Changelog](${context.compareUrl})`);
     lines.push("");
   }
+  if (context.enhanced?.summary) {
+    lines.push(context.enhanced.summary);
+    lines.push("");
+  }
   const grouped = groupEntriesByType(context.entries);
   for (const [type, entries] of grouped) {
     if (entries.length === 0) continue;
@@ -1123,37 +1173,58 @@ async function processWithLLM(context, config) {
     packageName: context.packageName,
     version: context.version,
     previousVersion: context.previousVersion ?? void 0,
-    date: context.date
+    date: context.date,
+    categories: config.llm.categories,
+    style: config.llm.style
   };
   const enhanced = {
     entries: context.entries
   };
   try {
+    (0, import_core7.info)(`Using LLM provider: ${config.llm.provider}${config.llm.model ? ` (${config.llm.model})` : ""}`);
+    if (config.llm.baseURL) {
+      (0, import_core7.info)(`LLM base URL: ${config.llm.baseURL}`);
+    }
     const rawProvider = createProvider(config.llm);
     const retryOpts = config.llm.retry ?? LLM_DEFAULTS.retry;
     const provider = {
       name: rawProvider.name,
       complete: (prompt, opts) => withRetry(() => rawProvider.complete(prompt, opts), retryOpts)
     };
+    const activeTasks = Object.entries(tasks).filter(([, enabled]) => enabled).map(([name]) => name);
+    (0, import_core7.info)(`Running LLM tasks: ${activeTasks.join(", ")}`);
     if (tasks.enhance) {
-      (0, import_core7.debug)("Enhancing entries with LLM");
+      (0, import_core7.info)("Enhancing entries with LLM...");
       enhanced.entries = await enhanceEntries(provider, context.entries, llmContext, config.llm.concurrency);
+      (0, import_core7.info)(`Enhanced ${enhanced.entries.length} entries`);
     }
     if (tasks.summarize) {
-      (0, import_core7.debug)("Summarizing entries with LLM");
+      (0, import_core7.info)("Summarizing entries with LLM...");
       enhanced.summary = await summarizeEntries(provider, enhanced.entries, llmContext);
+      if (enhanced.summary) {
+        (0, import_core7.info)("Summary generated successfully");
+        (0, import_core7.debug)(`Summary: ${enhanced.summary.substring(0, 100)}...`);
+      } else {
+        (0, import_core7.warn)("Summary generation returned empty result");
+      }
     }
     if (tasks.categorize) {
-      (0, import_core7.debug)("Categorizing entries with LLM");
+      (0, import_core7.info)("Categorizing entries with LLM...");
       const categorized = await categorizeEntries(provider, enhanced.entries, llmContext);
       enhanced.categories = {};
       for (const cat of categorized) {
         enhanced.categories[cat.category] = cat.entries;
       }
+      (0, import_core7.info)(`Created ${categorized.length} categories`);
     }
     if (tasks.releaseNotes) {
-      (0, import_core7.debug)("Generating release notes with LLM");
+      (0, import_core7.info)("Generating release notes with LLM...");
       enhanced.releaseNotes = await generateReleaseNotes(provider, enhanced.entries, llmContext);
+      if (enhanced.releaseNotes) {
+        (0, import_core7.info)("Release notes generated successfully");
+      } else {
+        (0, import_core7.warn)("Release notes generation returned empty result");
+      }
     }
     return {
       ...context,
@@ -1205,11 +1276,9 @@ async function generateWithTemplate(contexts, config, outputPath, dryRun) {
 async function runPipeline(input, config, dryRun) {
   (0, import_core7.debug)(`Processing ${input.packages.length} package(s)`);
   let contexts = input.packages.map(createTemplateContext);
-  if (config.llm && !process.env.CHANGELOG_NO_LLM && !dryRun) {
+  if (config.llm && !process.env.CHANGELOG_NO_LLM) {
     (0, import_core7.info)("Processing with LLM enhancement");
     contexts = await Promise.all(contexts.map((ctx) => processWithLLM(ctx, config)));
-  } else if (config.llm && dryRun) {
-    (0, import_core7.info)("Skipping LLM processing in dry-run mode");
   }
   for (const output of config.output) {
     (0, import_core7.info)(`Generating ${output.format} output`);
@@ -1392,7 +1461,7 @@ function detectMonorepo(cwd) {
 // src/cli.ts
 var program = new import_commander.Command();
 program.name("releasekit-notes").description("Generate changelogs with LLM-powered enhancement and flexible templating").version("0.1.0");
-program.command("generate", { isDefault: true }).description("Generate changelog from input data").option("-i, --input <file>", "Input file (default: stdin)").option("-o, --output <spec>", "Output spec (format:file)", collectOutputs, []).option("-t, --template <path>", "Template file or directory").option("-e, --engine <engine>", "Template engine (handlebars|liquid|ejs)").option("--monorepo <mode>", "Monorepo mode (root|packages|both)").option("--llm-provider <provider>", "LLM provider").option("--llm-model <model>", "LLM model").option("--llm-tasks <tasks>", "Comma-separated LLM tasks").option("--no-llm", "Disable LLM processing").option("--config <path>", "Config file path").option("--dry-run", "Preview without writing").option("--regenerate", "Regenerate entire changelog").option("-v, --verbose", "Increase verbosity", increaseVerbosity, 0).option("-q, --quiet", "Suppress non-error output").action(async (options) => {
+program.command("generate", { isDefault: true }).description("Generate changelog from input data").option("-i, --input <file>", "Input file (default: stdin)").option("-o, --output <spec>", "Output spec (format:file)", collectOutputs, []).option("-t, --template <path>", "Template file or directory").option("-e, --engine <engine>", "Template engine (handlebars|liquid|ejs)").option("--monorepo <mode>", "Monorepo mode (root|packages|both)").option("--llm-provider <provider>", "LLM provider").option("--llm-model <model>", "LLM model").option("--llm-base-url <url>", "LLM base URL (for openai-compatible provider)").option("--llm-tasks <tasks>", "Comma-separated LLM tasks").option("--no-llm", "Disable LLM processing").option("--config <path>", "Config file path").option("--dry-run", "Preview without writing").option("--regenerate", "Regenerate entire changelog").option("-v, --verbose", "Increase verbosity", increaseVerbosity, 0).option("-q, --quiet", "Suppress non-error output").action(async (options) => {
   setVerbosity(options.verbose);
   if (options.quiet) (0, import_core9.setQuietMode)(true);
   try {
@@ -1413,11 +1482,13 @@ program.command("generate", { isDefault: true }).description("Generate changelog
       config.templates = { ...config.templates, engine: options.engine };
     }
     if (options.llm === false) {
+      (0, import_core9.info)("LLM processing disabled via --no-llm flag");
       delete config.llm;
-    } else if (options.llmProvider || options.llmModel || options.llmTasks) {
+    } else if (options.llmProvider || options.llmModel || options.llmBaseUrl || options.llmTasks) {
       config.llm = config.llm ?? { provider: "openai-compatible", model: "" };
       if (options.llmProvider) config.llm.provider = options.llmProvider;
       if (options.llmModel) config.llm.model = options.llmModel;
+      if (options.llmBaseUrl) config.llm.baseURL = options.llmBaseUrl;
       if (options.llmTasks) {
         const taskNames = options.llmTasks.split(",").map((t) => t.trim());
         config.llm.tasks = {
@@ -1427,6 +1498,14 @@ program.command("generate", { isDefault: true }).description("Generate changelog
           releaseNotes: taskNames.includes("release-notes") || taskNames.includes("releaseNotes")
         };
       }
+      (0, import_core9.info)(`LLM configured: ${config.llm.provider}${config.llm.model ? ` (${config.llm.model})` : ""}`);
+      if (config.llm.baseURL) {
+        (0, import_core9.info)(`LLM base URL: ${config.llm.baseURL}`);
+      }
+      const taskList = Object.entries(config.llm.tasks || {}).filter(([, enabled]) => enabled).map(([name]) => name).join(", ");
+      if (taskList) {
+        (0, import_core9.info)(`LLM tasks: ${taskList}`);
+      }
     }
     let inputJson;
     if (options.input) {
@@ -1458,7 +1537,11 @@ program.command("generate", { isDefault: true }).description("Generate changelog
     } else {
       await runPipeline(input, config, options.dryRun ?? false);
     }
-    (0, import_core9.success)("Changelog generation complete");
+    if (options.dryRun) {
+      (0, import_core9.info)("Dry run complete - no files were written");
+    } else {
+      (0, import_core9.success)("Changelog generation complete");
+    }
   } catch (err) {
     handleError(err);
   }
@@ -1514,8 +1597,8 @@ function increaseVerbosity(_, previous) {
   return previous + 1;
 }
 function setVerbosity(level) {
-  const levels = ["error", "warn", "info", "debug", "trace"];
-  (0, import_core9.setLogLevel)(levels[Math.min(level, levels.length - 1)] ?? "error");
+  const levels = ["info", "debug", "trace"];
+  (0, import_core9.setLogLevel)(levels[Math.min(level, levels.length - 1)] ?? "info");
 }
 async function readStdin() {
   const chunks = [];

package/dist/cli.js

@@ -11,7 +11,7 @@ import {
   runPipeline,
   saveAuth,
   writeMonorepoChangelogs
-} from "./chunk-GN5RQW3G.js";
+} from "./chunk-NHDLQLG2.js";
 
 // src/cli.ts
 import * as fs from "fs";
@@ -20,7 +20,7 @@ import { error, info, setLogLevel, setQuietMode, success } from "@releasekit/cor
 import { Command } from "commander";
 var program = new Command();
 program.name("releasekit-notes").description("Generate changelogs with LLM-powered enhancement and flexible templating").version("0.1.0");
-program.command("generate", { isDefault: true }).description("Generate changelog from input data").option("-i, --input <file>", "Input file (default: stdin)").option("-o, --output <spec>", "Output spec (format:file)", collectOutputs, []).option("-t, --template <path>", "Template file or directory").option("-e, --engine <engine>", "Template engine (handlebars|liquid|ejs)").option("--monorepo <mode>", "Monorepo mode (root|packages|both)").option("--llm-provider <provider>", "LLM provider").option("--llm-model <model>", "LLM model").option("--llm-tasks <tasks>", "Comma-separated LLM tasks").option("--no-llm", "Disable LLM processing").option("--config <path>", "Config file path").option("--dry-run", "Preview without writing").option("--regenerate", "Regenerate entire changelog").option("-v, --verbose", "Increase verbosity", increaseVerbosity, 0).option("-q, --quiet", "Suppress non-error output").action(async (options) => {
+program.command("generate", { isDefault: true }).description("Generate changelog from input data").option("-i, --input <file>", "Input file (default: stdin)").option("-o, --output <spec>", "Output spec (format:file)", collectOutputs, []).option("-t, --template <path>", "Template file or directory").option("-e, --engine <engine>", "Template engine (handlebars|liquid|ejs)").option("--monorepo <mode>", "Monorepo mode (root|packages|both)").option("--llm-provider <provider>", "LLM provider").option("--llm-model <model>", "LLM model").option("--llm-base-url <url>", "LLM base URL (for openai-compatible provider)").option("--llm-tasks <tasks>", "Comma-separated LLM tasks").option("--no-llm", "Disable LLM processing").option("--config <path>", "Config file path").option("--dry-run", "Preview without writing").option("--regenerate", "Regenerate entire changelog").option("-v, --verbose", "Increase verbosity", increaseVerbosity, 0).option("-q, --quiet", "Suppress non-error output").action(async (options) => {
   setVerbosity(options.verbose);
   if (options.quiet) setQuietMode(true);
   try {
@@ -41,11 +41,13 @@ program.command("generate", { isDefault: true }).description("Generate changelog
       config.templates = { ...config.templates, engine: options.engine };
     }
     if (options.llm === false) {
+      info("LLM processing disabled via --no-llm flag");
       delete config.llm;
-    } else if (options.llmProvider || options.llmModel || options.llmTasks) {
+    } else if (options.llmProvider || options.llmModel || options.llmBaseUrl || options.llmTasks) {
       config.llm = config.llm ?? { provider: "openai-compatible", model: "" };
       if (options.llmProvider) config.llm.provider = options.llmProvider;
       if (options.llmModel) config.llm.model = options.llmModel;
+      if (options.llmBaseUrl) config.llm.baseURL = options.llmBaseUrl;
       if (options.llmTasks) {
         const taskNames = options.llmTasks.split(",").map((t) => t.trim());
         config.llm.tasks = {
@@ -55,6 +57,14 @@ program.command("generate", { isDefault: true }).description("Generate changelog
           releaseNotes: taskNames.includes("release-notes") || taskNames.includes("releaseNotes")
         };
       }
+      info(`LLM configured: ${config.llm.provider}${config.llm.model ? ` (${config.llm.model})` : ""}`);
+      if (config.llm.baseURL) {
+        info(`LLM base URL: ${config.llm.baseURL}`);
+      }
+      const taskList = Object.entries(config.llm.tasks || {}).filter(([, enabled]) => enabled).map(([name]) => name).join(", ");
+      if (taskList) {
+        info(`LLM tasks: ${taskList}`);
+      }
     }
     let inputJson;
     if (options.input) {
@@ -86,7 +96,11 @@ program.command("generate", { isDefault: true }).description("Generate changelog
     } else {
       await runPipeline(input, config, options.dryRun ?? false);
     }
-    success("Changelog generation complete");
+    if (options.dryRun) {
+      info("Dry run complete - no files were written");
+    } else {
+      success("Changelog generation complete");
+    }
   } catch (err) {
     handleError(err);
   }
@@ -142,8 +156,8 @@ function increaseVerbosity(_, previous) {
   return previous + 1;
 }
 function setVerbosity(level) {
-  const levels = ["error", "warn", "info", "debug", "trace"];
-  setLogLevel(levels[Math.min(level, levels.length - 1)] ?? "error");
+  const levels = ["info", "debug", "trace"];
+  setLogLevel(levels[Math.min(level, levels.length - 1)] ?? "info");
 }
 async function readStdin() {
   const chunks = [];

package/dist/index.cjs

@@ -283,15 +283,17 @@ var OllamaProvider = class extends BaseLLMProvider {
   name = "ollama";
   baseURL;
   model;
+  apiKey;
   constructor(config = {}) {
     super();
     this.baseURL = config.baseURL ?? process.env.OLLAMA_BASE_URL ?? "http://localhost:11434";
     this.model = config.model ?? LLM_DEFAULTS.models.ollama;
+    this.apiKey = config.apiKey ?? process.env.OLLAMA_API_KEY;
   }
   async complete(prompt, options) {
     const requestBody = {
       model: this.model,
-      prompt,
+      messages: [{ role: "user", content: prompt }],
       stream: false,
       options: {
         num_predict: this.getMaxTokens(options),
@@ -299,11 +301,16 @@ var OllamaProvider = class extends BaseLLMProvider {
       }
     };
     try {
-      const response = await fetch(`${this.baseURL}/api/generate`, {
+      const headers = {
+        "Content-Type": "application/json"
+      };
+      if (this.apiKey) {
+        headers["Authorization"] = `Bearer ${this.apiKey}`;
+      }
+      const baseUrl = this.baseURL.endsWith("/api") ? this.baseURL.slice(0, -4) : this.baseURL;
+      const response = await fetch(`${baseUrl}/api/chat`, {
         method: "POST",
-        headers: {
-          "Content-Type": "application/json"
-        },
+        headers,
         body: JSON.stringify(requestBody)
       });
       if (!response.ok) {
@@ -311,10 +318,10 @@ var OllamaProvider = class extends BaseLLMProvider {
         throw new LLMError(`Ollama request failed: ${response.status} ${text}`);
       }
       const data = await response.json();
-      if (!data.response) {
+      if (!data.message?.content) {
         throw new LLMError("Empty response from Ollama");
       }
-      return data.response;
+      return data.message.content;
     } catch (error) {
       if (error instanceof LLMError) throw error;
       throw new LLMError(`Ollama error: ${error instanceof Error ? error.message : String(error)}`);
@@ -397,7 +404,7 @@ var OpenAICompatibleProvider = class extends BaseLLMProvider {
 
 // src/llm/tasks/categorize.ts
 var import_core3 = require("@releasekit/core");
-var CATEGORIZE_PROMPT = `You are categorizing changelog entries for a software release.
+var DEFAULT_CATEGORIZE_PROMPT = `You are categorizing changelog entries for a software release.
 
 Given the following entries, group them into meaningful categories (e.g., "Core", "UI", "API", "Performance", "Bug Fixes", "Documentation").
 
@@ -407,24 +414,61 @@ Entries:
 {{entries}}
 
 Output only valid JSON, nothing else:`;
-async function categorizeEntries(provider, entries, _context) {
+function buildCustomCategorizePrompt(categories) {
+  const categoryList = categories.map((c) => `- "${c.name}": ${c.description}`).join("\n");
+  return `You are categorizing changelog entries for a software release.
+
+Given the following entries, group them into the specified categories. Only use the categories listed below.
+
+Categories:
+${categoryList}
+
+For entries in categories that involve internal/developer changes, set a "scope" field on those entries with a short subcategory label (e.g., "CI", "Dependencies", "Testing", "Code Quality", "Build System").
+
+Output a JSON object with two fields:
+- "categories": an object where keys are category names and values are arrays of entry indices (0-based)
+- "scopes": an object where keys are entry indices (as strings) and values are scope labels
+
+Entries:
+{{entries}}
+
+Output only valid JSON, nothing else:`;
+}
+async function categorizeEntries(provider, entries, context) {
   if (entries.length === 0) {
     return [];
   }
   const entriesText = entries.map((e, i) => `${i}. [${e.type}]${e.scope ? ` (${e.scope})` : ""}: ${e.description}`).join("\n");
-  const prompt = CATEGORIZE_PROMPT.replace("{{entries}}", entriesText);
+  const hasCustomCategories = context.categories && context.categories.length > 0;
+  const promptTemplate = hasCustomCategories ? buildCustomCategorizePrompt(context.categories) : DEFAULT_CATEGORIZE_PROMPT;
+  const prompt = promptTemplate.replace("{{entries}}", entriesText);
   try {
     const response = await provider.complete(prompt);
     const cleaned = response.replace(/^```(?:json)?\n?/, "").replace(/\n?```$/, "").trim();
     const parsed = JSON.parse(cleaned);
     const result = [];
-    for (const [category, indices] of Object.entries(parsed)) {
-      const categoryEntries = indices.map((i) => entries[i]).filter((e) => e !== void 0);
-      if (categoryEntries.length > 0) {
-        result.push({
-          category,
-          entries: categoryEntries
-        });
+    if (hasCustomCategories && parsed.categories) {
+      const categoryMap = parsed.categories;
+      const scopeMap = parsed.scopes || {};
+      for (const [indexStr, scope] of Object.entries(scopeMap)) {
+        const idx = Number.parseInt(indexStr, 10);
+        if (entries[idx] && scope) {
+          entries[idx] = { ...entries[idx], scope };
+        }
+      }
+      for (const [category, indices] of Object.entries(categoryMap)) {
+        const categoryEntries = indices.map((i) => entries[i]).filter((e) => e !== void 0);
+        if (categoryEntries.length > 0) {
+          result.push({ category, entries: categoryEntries });
+        }
+      }
+    } else {
+      const categoryMap = parsed;
+      for (const [category, indices] of Object.entries(categoryMap)) {
+        const categoryEntries = indices.map((i) => entries[i]).filter((e) => e !== void 0);
+        if (categoryEntries.length > 0) {
+          result.push({ category, entries: categoryEntries });
+        }
       }
     }
     return result;
@@ -442,10 +486,10 @@ Given a technical commit message, rewrite it as a clear, user-friendly changelog
 
 Rules:
 - Be concise (1-2 sentences max)
-- Use present tense ("Add feature" not "Added feature")
 - Focus on user impact, not implementation details
 - Don't use technical jargon unless necessary
 - Preserve the scope if mentioned (e.g., "core:", "api:")
+{{style}}
 
 Original entry:
 Type: {{type}}
@@ -454,7 +498,8 @@ Description: {{description}}
 
 Rewritten description (only output the new description, nothing else):`;
 async function enhanceEntry(provider, entry, _context) {
-  const prompt = ENHANCE_PROMPT.replace("{{type}}", entry.type).replace("{{#if scope}}Scope: {{scope}}{{/if}}", entry.scope ? `Scope: ${entry.scope}` : "").replace("{{description}}", entry.description);
+  const styleText = _context.style ? `- ${_context.style}` : '- Use present tense ("Add feature" not "Added feature")';
+  const prompt = ENHANCE_PROMPT.replace("{{style}}", styleText).replace("{{type}}", entry.type).replace("{{#if scope}}Scope: {{scope}}{{/if}}", entry.scope ? `Scope: ${entry.scope}` : "").replace("{{description}}", entry.description);
   const response = await provider.complete(prompt);
   return response.trim();
 }
@@ -556,6 +601,7 @@ function createProvider(config) {
       });
     case "ollama":
       return new OllamaProvider({
+        apiKey,
         baseURL: config.baseURL,
         model: config.model
       });
@@ -628,6 +674,10 @@ function formatVersion(context) {
     lines.push(`[Full Changelog](${context.compareUrl})`);
     lines.push("");
   }
+  if (context.enhanced?.summary) {
+    lines.push(context.enhanced.summary);
+    lines.push("");
+  }
   const grouped = groupEntriesByType(context.entries);
   for (const [type, entries] of grouped) {
     if (entries.length === 0) continue;
@@ -1173,37 +1223,58 @@ async function processWithLLM(context, config) {
     packageName: context.packageName,
     version: context.version,
     previousVersion: context.previousVersion ?? void 0,
-    date: context.date
+    date: context.date,
+    categories: config.llm.categories,
+    style: config.llm.style
   };
   const enhanced = {
     entries: context.entries
   };
   try {
+    (0, import_core7.info)(`Using LLM provider: ${config.llm.provider}${config.llm.model ? ` (${config.llm.model})` : ""}`);
+    if (config.llm.baseURL) {
+      (0, import_core7.info)(`LLM base URL: ${config.llm.baseURL}`);
+    }
     const rawProvider = createProvider(config.llm);
     const retryOpts = config.llm.retry ?? LLM_DEFAULTS.retry;
     const provider = {
       name: rawProvider.name,
       complete: (prompt, opts) => withRetry(() => rawProvider.complete(prompt, opts), retryOpts)
     };
+    const activeTasks = Object.entries(tasks).filter(([, enabled]) => enabled).map(([name]) => name);
+    (0, import_core7.info)(`Running LLM tasks: ${activeTasks.join(", ")}`);
     if (tasks.enhance) {
-      (0, import_core7.debug)("Enhancing entries with LLM");
+      (0, import_core7.info)("Enhancing entries with LLM...");
       enhanced.entries = await enhanceEntries(provider, context.entries, llmContext, config.llm.concurrency);
+      (0, import_core7.info)(`Enhanced ${enhanced.entries.length} entries`);
     }
     if (tasks.summarize) {
-      (0, import_core7.debug)("Summarizing entries with LLM");
+      (0, import_core7.info)("Summarizing entries with LLM...");
       enhanced.summary = await summarizeEntries(provider, enhanced.entries, llmContext);
+      if (enhanced.summary) {
+        (0, import_core7.info)("Summary generated successfully");
+        (0, import_core7.debug)(`Summary: ${enhanced.summary.substring(0, 100)}...`);
+      } else {
+        (0, import_core7.warn)("Summary generation returned empty result");
+      }
     }
     if (tasks.categorize) {
-      (0, import_core7.debug)("Categorizing entries with LLM");
+      (0, import_core7.info)("Categorizing entries with LLM...");
       const categorized = await categorizeEntries(provider, enhanced.entries, llmContext);
       enhanced.categories = {};
       for (const cat of categorized) {
         enhanced.categories[cat.category] = cat.entries;
       }
+      (0, import_core7.info)(`Created ${categorized.length} categories`);
     }
     if (tasks.releaseNotes) {
-      (0, import_core7.debug)("Generating release notes with LLM");
+      (0, import_core7.info)("Generating release notes with LLM...");
       enhanced.releaseNotes = await generateReleaseNotes(provider, enhanced.entries, llmContext);
+      if (enhanced.releaseNotes) {
+        (0, import_core7.info)("Release notes generated successfully");
+      } else {
+        (0, import_core7.warn)("Release notes generation returned empty result");
+      }
     }
     return {
       ...context,
@@ -1255,11 +1326,9 @@ async function generateWithTemplate(contexts, config, outputPath, dryRun) {
 async function runPipeline(input, config, dryRun) {
   (0, import_core7.debug)(`Processing ${input.packages.length} package(s)`);
   let contexts = input.packages.map(createTemplateContext);
-  if (config.llm && !process.env.CHANGELOG_NO_LLM && !dryRun) {
+  if (config.llm && !process.env.CHANGELOG_NO_LLM) {
     (0, import_core7.info)("Processing with LLM enhancement");
     contexts = await Promise.all(contexts.map((ctx) => processWithLLM(ctx, config)));
-  } else if (config.llm && dryRun) {
-    (0, import_core7.info)("Skipping LLM processing in dry-run mode");
   }
   for (const output of config.output) {
     (0, import_core7.info)(`Generating ${output.format} output`);

package/dist/index.d.cts

@@ -84,6 +84,11 @@ interface LLMConfig {
         categorize?: boolean;
         releaseNotes?: boolean;
     };
+    categories?: Array<{
+        name: string;
+        description: string;
+    }>;
+    style?: string;
 }
 type OutputFormat = 'markdown' | 'github-release' | 'json';
 interface OutputConfig {

package/dist/index.d.ts

@@ -84,6 +84,11 @@ interface LLMConfig {
         categorize?: boolean;
         releaseNotes?: boolean;
     };
+    categories?: Array<{
+        name: string;
+        description: string;
+    }>;
+    style?: string;
 }
 type OutputFormat = 'markdown' | 'github-release' | 'json';
 interface OutputConfig {