@releasekit/notes 0.2.0-next.9 → 0.3.0-next.0

package/dist/{chunk-BLWJTLRD.js → chunk-X4LY5WGG.js}

@@ -1,3 +1,9 @@
+import {
+  formatVersion,
+  renderMarkdown,
+  writeMarkdown
+} from "./chunk-H7G2HRHI.js";
+
 // src/core/config.ts
 import {
   loadAuth,
@@ -145,137 +151,10 @@ async function parsePackageVersionerStdin() {
   return parsePackageVersioner(content);
 }
 
-// src/output/markdown.ts
+// src/output/json.ts
 import * as fs2 from "fs";
 import * as path from "path";
-import { info, success } from "@releasekit/core";
-var TYPE_ORDER = ["added", "changed", "deprecated", "removed", "fixed", "security"];
-var TYPE_LABELS = {
-  added: "Added",
-  changed: "Changed",
-  deprecated: "Deprecated",
-  removed: "Removed",
-  fixed: "Fixed",
-  security: "Security"
-};
-function groupEntriesByType(entries) {
-  const grouped = /* @__PURE__ */ new Map();
-  for (const type of TYPE_ORDER) {
-    grouped.set(type, []);
-  }
-  for (const entry of entries) {
-    const existing = grouped.get(entry.type) ?? [];
-    existing.push(entry);
-    grouped.set(entry.type, existing);
-  }
-  return grouped;
-}
-function formatEntry(entry) {
-  let line;
-  if (entry.breaking && entry.scope) {
-    line = `- **BREAKING** **${entry.scope}**: ${entry.description}`;
-  } else if (entry.breaking) {
-    line = `- **BREAKING** ${entry.description}`;
-  } else if (entry.scope) {
-    line = `- **${entry.scope}**: ${entry.description}`;
-  } else {
-    line = `- ${entry.description}`;
-  }
-  if (entry.issueIds && entry.issueIds.length > 0) {
-    line += ` (${entry.issueIds.join(", ")})`;
-  }
-  return line;
-}
-function formatVersion(context) {
-  const lines = [];
-  const versionHeader = context.previousVersion ? `## [${context.version}]` : `## ${context.version}`;
-  lines.push(`${versionHeader} - ${context.date}`);
-  lines.push("");
-  if (context.compareUrl) {
-    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;
-    lines.push(`### ${TYPE_LABELS[type]}`);
-    for (const entry of entries) {
-      lines.push(formatEntry(entry));
-    }
-    lines.push("");
-  }
-  return lines.join("\n");
-}
-function formatHeader() {
-  return `# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-`;
-}
-function renderMarkdown(contexts) {
-  const sections = [formatHeader()];
-  for (const context of contexts) {
-    sections.push(formatVersion(context));
-  }
-  return sections.join("\n");
-}
-function prependVersion(existingPath, context) {
-  let existing = "";
-  if (fs2.existsSync(existingPath)) {
-    existing = fs2.readFileSync(existingPath, "utf-8");
-    const headerEnd = existing.indexOf("\n## ");
-    if (headerEnd >= 0) {
-      const header = existing.slice(0, headerEnd);
-      const body = existing.slice(headerEnd + 1);
-      const newVersion = formatVersion(context);
-      return `${header}
-
-${newVersion}
-${body}`;
-    }
-  }
-  return renderMarkdown([context]);
-}
-function writeMarkdown(outputPath, contexts, config, dryRun) {
-  const content = renderMarkdown(contexts);
-  if (dryRun) {
-    info("--- Changelog Preview ---");
-    console.log(content);
-    info("--- End Preview ---");
-    return;
-  }
-  const dir = path.dirname(outputPath);
-  if (!fs2.existsSync(dir)) {
-    fs2.mkdirSync(dir, { recursive: true });
-  }
-  if (outputPath === "-") {
-    process.stdout.write(content);
-    return;
-  }
-  if (config.updateStrategy === "prepend" && fs2.existsSync(outputPath) && contexts.length === 1) {
-    const firstContext = contexts[0];
-    if (firstContext) {
-      const updated = prependVersion(outputPath, firstContext);
-      fs2.writeFileSync(outputPath, updated, "utf-8");
-    }
-  } else {
-    fs2.writeFileSync(outputPath, content, "utf-8");
-  }
-  success(`Changelog written to ${outputPath}`);
-}
-
-// src/output/json.ts
-import * as fs3 from "fs";
-import * as path2 from "path";
-import { info as info2, success as success2 } from "@releasekit/core";
+import { debug, info, success } from "@releasekit/core";
 function renderJson(contexts) {
   return JSON.stringify(
     {
@@ -295,23 +174,24 @@ function renderJson(contexts) {
 function writeJson(outputPath, contexts, dryRun) {
   const content = renderJson(contexts);
   if (dryRun) {
-    info2("--- JSON Output Preview ---");
-    console.log(content);
-    info2("--- End Preview ---");
+    info(`Would write JSON output to ${outputPath}`);
+    debug("--- JSON Output Preview ---");
+    debug(content);
+    debug("--- End Preview ---");
     return;
   }
-  const dir = path2.dirname(outputPath);
-  if (!fs3.existsSync(dir)) {
-    fs3.mkdirSync(dir, { recursive: true });
+  const dir = path.dirname(outputPath);
+  if (!fs2.existsSync(dir)) {
+    fs2.mkdirSync(dir, { recursive: true });
   }
-  fs3.writeFileSync(outputPath, content, "utf-8");
-  success2(`JSON output written to ${outputPath}`);
+  fs2.writeFileSync(outputPath, content, "utf-8");
+  success(`JSON output written to ${outputPath}`);
 }
 
 // src/core/pipeline.ts
-import * as fs8 from "fs";
-import * as path6 from "path";
-import { debug, info as info4, success as success4, warn as warn3 } from "@releasekit/core";
+import * as fs7 from "fs";
+import * as path5 from "path";
+import { debug as debug2, info as info3, success as success3, warn as warn3 } from "@releasekit/core";
 
 // src/llm/defaults.ts
 var LLM_DEFAULTS = {
@@ -508,6 +388,83 @@ var OpenAICompatibleProvider = class extends BaseLLMProvider {
 
 // src/llm/tasks/categorize.ts
 import { warn } from "@releasekit/core";
+
+// src/llm/prompts.ts
+function resolvePrompt(taskName, defaultPrompt, promptsConfig) {
+  if (!promptsConfig) return defaultPrompt;
+  const fullTemplate = promptsConfig.templates?.[taskName];
+  if (fullTemplate) return fullTemplate;
+  const additionalInstructions = promptsConfig.instructions?.[taskName];
+  if (additionalInstructions) {
+    const insertionPoint = defaultPrompt.lastIndexOf("Output only valid JSON");
+    if (insertionPoint !== -1) {
+      return `${defaultPrompt.slice(0, insertionPoint)}Additional instructions:
+${additionalInstructions}
+
+${defaultPrompt.slice(insertionPoint)}`;
+    }
+    return `${defaultPrompt}
+
+Additional instructions:
+${additionalInstructions}`;
+  }
+  return defaultPrompt;
+}
+
+// src/llm/scopes.ts
+function getAllowedScopesFromCategories(categories) {
+  const scopeMap = /* @__PURE__ */ new Map();
+  for (const cat of categories) {
+    if (cat.scopes && cat.scopes.length > 0) {
+      scopeMap.set(cat.name, cat.scopes);
+    }
+  }
+  return scopeMap;
+}
+function resolveAllowedScopes(scopeConfig, categories, packageNames) {
+  if (!scopeConfig || scopeConfig.mode === "unrestricted") return null;
+  if (scopeConfig.mode === "none") return [];
+  if (scopeConfig.mode === "packages") return packageNames ?? [];
+  if (scopeConfig.mode === "restricted") {
+    const explicit = scopeConfig.rules?.allowed ?? [];
+    const all = new Set(explicit);
+    if (categories) {
+      const fromCategories = getAllowedScopesFromCategories(categories);
+      for (const scopes of fromCategories.values()) {
+        for (const s of scopes) all.add(s);
+      }
+    }
+    return [...all];
+  }
+  return null;
+}
+function validateScope(scope, allowedScopes, rules) {
+  if (!scope || allowedScopes === null) return scope;
+  if (allowedScopes.length === 0) return void 0;
+  const caseSensitive = rules?.caseSensitive ?? false;
+  const normalise = (s) => caseSensitive ? s : s.toLowerCase();
+  const isAllowed = allowedScopes.some((a) => normalise(a) === normalise(scope));
+  if (isAllowed) return scope;
+  switch (rules?.invalidScopeAction ?? "remove") {
+    case "keep":
+      return scope;
+    case "fallback":
+      return rules?.fallbackScope;
+    case "remove":
+    default:
+      return void 0;
+  }
+}
+function validateEntryScopes(entries, scopeConfig, categories) {
+  const allowedScopes = resolveAllowedScopes(scopeConfig, categories);
+  if (allowedScopes === null) return entries;
+  return entries.map((entry) => ({
+    ...entry,
+    scope: validateScope(entry.scope, allowedScopes, scopeConfig?.rules)
+  }));
+}
+
+// src/llm/tasks/categorize.ts
 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").
@@ -519,20 +476,21 @@ Entries:
 
 Output only valid JSON, nothing else:`;
 function buildCustomCategorizePrompt(categories) {
-  const categoryList = categories.map((c) => `- "${c.name}": ${c.description}`).join("\n");
-  const developerCategory = categories.find((c) => c.name === "Developer");
+  const categoryList = categories.map((c) => {
+    const scopeInfo = c.scopes?.length ? ` Allowed scopes: ${c.scopes.join(", ")}.` : "";
+    return `- "${c.name}": ${c.description}${scopeInfo}`;
+  }).join("\n");
+  const scopeMap = getAllowedScopesFromCategories(categories);
   let scopeInstructions = "";
-  if (developerCategory) {
-    const scopeMatch = developerCategory.description.match(/from:\s*([^.]+)/);
-    if (scopeMatch?.[1]) {
-      const scopes = scopeMatch[1].split(",").map((s) => s.trim()).filter(Boolean);
-      if (scopes.length > 0) {
-        scopeInstructions = `
-
-For the "Developer" category, you MUST assign a scope from this exact list: ${scopes.join(", ")}.
-`;
-      }
+  if (scopeMap.size > 0) {
+    const entries = [];
+    for (const [catName, scopes] of scopeMap) {
+      entries.push(`For "${catName}", assign a scope from: ${scopes.join(", ")}.`);
     }
+    scopeInstructions = `
+
+${entries.join("\n")}
+Only use scopes from these predefined lists. If an entry does not fit any scope, set scope to null.`;
   }
   return `You are categorizing changelog entries for a software release.
 
@@ -540,9 +498,10 @@ Given the following entries, group them into the specified categories. Only use
 
 Categories:
 ${categoryList}${scopeInstructions}
+
 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
+- "scopes": an object where keys are entry indices (as strings) and values are scope labels. Only include entries that have a valid scope from the predefined list.
 
 Entries:
 {{entries}}
@@ -553,9 +512,11 @@ 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 entriesCopy = entries.map((e) => ({ ...e, scope: void 0 }));
+  const entriesText = entriesCopy.map((e, i) => `${i}. [${e.type}]: ${e.description}`).join("\n");
   const hasCustomCategories = context.categories && context.categories.length > 0;
-  const promptTemplate = hasCustomCategories ? buildCustomCategorizePrompt(context.categories) : DEFAULT_CATEGORIZE_PROMPT;
+  const defaultPrompt = hasCustomCategories ? buildCustomCategorizePrompt(context.categories) : DEFAULT_CATEGORIZE_PROMPT;
+  const promptTemplate = resolvePrompt("categorize", defaultPrompt, context.prompts);
   const prompt = promptTemplate.replace("{{entries}}", entriesText);
   try {
     const response = await provider.complete(prompt);
@@ -567,13 +528,14 @@ async function categorizeEntries(provider, entries, context) {
       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 };
+        if (entriesCopy[idx] && scope && scope.trim()) {
+          entriesCopy[idx] = { ...entriesCopy[idx], scope: scope.trim() };
         }
       }
+      const validatedEntries = validateEntryScopes(entriesCopy, context.scopes, context.categories);
       for (const [category, rawIndices] of Object.entries(categoryMap)) {
         const indices = Array.isArray(rawIndices) ? rawIndices : [];
-        const categoryEntries = indices.map((i) => entries[i]).filter((e) => e !== void 0);
+        const categoryEntries = indices.map((i) => validatedEntries[i]).filter((e) => e !== void 0);
         if (categoryEntries.length > 0) {
           result.push({ category, entries: categoryEntries });
         }
@@ -582,7 +544,7 @@ async function categorizeEntries(provider, entries, context) {
       const categoryMap = parsed;
       for (const [category, rawIndices] of Object.entries(categoryMap)) {
         const indices = Array.isArray(rawIndices) ? rawIndices : [];
-        const categoryEntries = indices.map((i) => entries[i]).filter((e) => e !== void 0);
+        const categoryEntries = indices.map((i) => entriesCopy[i]).filter((e) => e !== void 0);
         if (categoryEntries.length > 0) {
           result.push({ category, entries: categoryEntries });
         }
@@ -593,12 +555,12 @@ async function categorizeEntries(provider, entries, context) {
     warn(
       `LLM categorization failed, falling back to General: ${error instanceof Error ? error.message : String(error)}`
     );
-    return [{ category: "General", entries }];
+    return [{ category: "General", entries: entriesCopy }];
   }
 }
 
 // src/llm/tasks/enhance.ts
-var ENHANCE_PROMPT = `You are improving changelog entries for a software project.
+var DEFAULT_ENHANCE_PROMPT = `You are improving changelog entries for a software project.
 Given a technical commit message, rewrite it as a clear, user-friendly changelog entry.
 
 Rules:
@@ -614,9 +576,10 @@ Type: {{type}}
 Description: {{description}}
 
 Rewritten description (only output the new description, nothing else):`;
-async function enhanceEntry(provider, entry, _context) {
-  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);
+async function enhanceEntry(provider, entry, context) {
+  const styleText = context.style ? `- ${context.style}` : '- Use present tense ("Add feature" not "Added feature")';
+  const defaultPrompt = DEFAULT_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 prompt = resolvePrompt("enhance", defaultPrompt, context.prompts);
   const response = await provider.complete(prompt);
   return response.trim();
 }
@@ -672,7 +635,23 @@ function buildPrompt(entries, categories, style) {
   const entriesText = entries.map((e, i) => `${i}. [${e.type}]${e.scope ? ` (${e.scope})` : ""}: ${e.description}`).join("\n");
   const styleText = style || 'Use present tense ("Add feature" not "Added feature"). Be concise.';
   const categorySection = categories ? `Categories (use ONLY these):
-${categories.map((c) => `- "${c.name}": ${c.description}`).join("\n")}` : `Categories: Group into meaningful categories (e.g., "New", "Fixed", "Changed", "Removed").`;
+${categories.map((c) => {
+    const scopeInfo = c.scopes?.length ? ` Allowed scopes: ${c.scopes.join(", ")}.` : "";
+    return `- "${c.name}": ${c.description}${scopeInfo}`;
+  }).join("\n")}` : `Categories: Group into meaningful categories (e.g., "New", "Fixed", "Changed", "Removed").`;
+  let scopeInstruction = "";
+  if (categories) {
+    const scopeMap = getAllowedScopesFromCategories(categories);
+    if (scopeMap.size > 0) {
+      const parts = [];
+      for (const [catName, scopes] of scopeMap) {
+        parts.push(`For "${catName}" entries, assign a scope from: ${scopes.join(", ")}.`);
+      }
+      scopeInstruction = `
+${parts.join("\n")}
+Only use scopes from these predefined lists. Set scope to null if no scope applies.`;
+    }
+  }
   return `You are generating release notes for a software project. Given the following changelog entries, do two things:
 
 1. **Rewrite** each entry as a clear, user-friendly description
@@ -683,9 +662,7 @@ Style guidelines:
 - Be concise (1 short sentence per entry)
 - Focus on what changed, not implementation details
 
-${categorySection}
-
-${categories ? 'For entries in categories involving internal/developer changes, set a "scope" field with a short subcategory label (e.g., "CI", "Dependencies", "Testing").' : ""}
+${categorySection}${scopeInstruction}
 
 Entries:
 ${entriesText}
@@ -702,7 +679,8 @@ async function enhanceAndCategorize(provider, entries, context) {
   const retryOpts = LLM_DEFAULTS.retry;
   try {
     return await withRetry(async () => {
-      const prompt = buildPrompt(entries, context.categories, context.style);
+      const defaultPrompt = buildPrompt(entries, context.categories, context.style);
+      const prompt = resolvePrompt("enhanceAndCategorize", defaultPrompt, context.prompts);
       const response = await provider.complete(prompt);
       const cleaned = response.replace(/^```(?:json)?\n?/, "").replace(/\n?```$/, "").trim();
       const parsed = JSON.parse(cleaned);
@@ -718,22 +696,23 @@ async function enhanceAndCategorize(provider, entries, context) {
           scope: result.scope || original.scope
         };
       });
+      const validatedEntries = validateEntryScopes(enhancedEntries, context.scopes, context.categories);
       const categoryMap = /* @__PURE__ */ new Map();
       for (let i = 0; i < parsed.entries.length; i++) {
         const result = parsed.entries[i];
         const category = result?.category || "General";
-        const entry = enhancedEntries[i];
+        const entry = validatedEntries[i];
         if (!entry) continue;
         if (!categoryMap.has(category)) {
           categoryMap.set(category, []);
         }
-        categoryMap.get(category).push(entry);
+        categoryMap.get(category)?.push(entry);
       }
       const categories = [];
       for (const [category, catEntries] of categoryMap) {
         categories.push({ category, entries: catEntries });
       }
-      return { enhancedEntries, categories };
+      return { enhancedEntries: validatedEntries, categories };
     }, retryOpts);
   } catch (error) {
     warn2(
@@ -747,7 +726,7 @@ async function enhanceAndCategorize(provider, entries, context) {
 }
 
 // src/llm/tasks/release-notes.ts
-var RELEASE_NOTES_PROMPT = `You are writing release notes for a software project.
+var DEFAULT_RELEASE_NOTES_PROMPT = `You are writing release notes for a software project.
 
 Create engaging, user-friendly release notes for the following changes.
 
@@ -780,16 +759,17 @@ No notable changes in this release.`;
     if (e.breaking) line += " **BREAKING**";
     return line;
   }).join("\n");
-  const prompt = RELEASE_NOTES_PROMPT.replace("{{version}}", context.version ?? "v1.0.0").replace(
+  const defaultPrompt = DEFAULT_RELEASE_NOTES_PROMPT.replace("{{version}}", context.version ?? "v1.0.0").replace(
     "{{#if previousVersion}}Previous version: {{previousVersion}}{{/if}}",
     context.previousVersion ? `Previous version: ${context.previousVersion}` : ""
   ).replace("{{date}}", context.date ?? (/* @__PURE__ */ new Date()).toISOString().split("T")[0] ?? "").replace("{{entries}}", entriesText);
+  const prompt = resolvePrompt("releaseNotes", defaultPrompt, context.prompts);
   const response = await provider.complete(prompt);
   return response.trim();
 }
 
 // src/llm/tasks/summarize.ts
-var SUMMARIZE_PROMPT = `You are creating a summary of changes for a software release.
+var DEFAULT_SUMMARIZE_PROMPT = `You are creating a summary of changes for a software release.
 
 Given the following changelog entries, create a brief summary (2-3 sentences) that captures the main themes of this release.
 
@@ -797,12 +777,13 @@ Entries:
 {{entries}}
 
 Summary (only output the summary, nothing else):`;
-async function summarizeEntries(provider, entries, _context) {
+async function summarizeEntries(provider, entries, context) {
   if (entries.length === 0) {
     return "";
   }
   const entriesText = entries.map((e) => `- [${e.type}]${e.scope ? ` (${e.scope})` : ""}: ${e.description}`).join("\n");
-  const prompt = SUMMARIZE_PROMPT.replace("{{entries}}", entriesText);
+  const defaultPrompt = DEFAULT_SUMMARIZE_PROMPT.replace("{{entries}}", entriesText);
+  const prompt = resolvePrompt("summarize", defaultPrompt, context.prompts);
   const response = await provider.complete(prompt);
   return response.trim();
 }
@@ -846,7 +827,7 @@ function createProvider(config) {
 
 // src/output/github-release.ts
 import { Octokit } from "@octokit/rest";
-import { info as info3, success as success3 } from "@releasekit/core";
+import { info as info2, success as success2 } from "@releasekit/core";
 var GitHubClient = class {
   octokit;
   owner;
@@ -868,7 +849,7 @@ var GitHubClient = class {
     } else {
       body = renderMarkdown([context]);
     }
-    info3(`Creating GitHub release for ${tagName}`);
+    info2(`Creating GitHub release for ${tagName}`);
     try {
       const response = await this.octokit.repos.createRelease({
         owner: this.owner,
@@ -880,7 +861,7 @@ var GitHubClient = class {
         prerelease: options.prerelease ?? false,
         generate_release_notes: options.generateNotes ?? false
       });
-      success3(`Release created: ${response.data.html_url}`);
+      success2(`Release created: ${response.data.html_url}`);
       return {
         id: response.data.id,
         htmlUrl: response.data.html_url,
@@ -898,7 +879,7 @@ var GitHubClient = class {
     } else {
       body = renderMarkdown([context]);
     }
-    info3(`Updating GitHub release ${releaseId}`);
+    info2(`Updating GitHub release ${releaseId}`);
     try {
       const response = await this.octokit.repos.updateRelease({
         owner: this.owner,
@@ -910,7 +891,7 @@ var GitHubClient = class {
         draft: options.draft ?? false,
         prerelease: options.prerelease ?? false
       });
-      success3(`Release updated: ${response.data.html_url}`);
+      success2(`Release updated: ${response.data.html_url}`);
       return {
         id: response.data.id,
         htmlUrl: response.data.html_url,
@@ -960,7 +941,7 @@ async function createGitHubRelease(context, options) {
 }
 
 // src/templates/ejs.ts
-import * as fs4 from "fs";
+import * as fs3 from "fs";
 import ejs from "ejs";
 function renderEjs(template, context) {
   try {
@@ -970,16 +951,16 @@ function renderEjs(template, context) {
   }
 }
 function renderEjsFile(filePath, context) {
-  if (!fs4.existsSync(filePath)) {
+  if (!fs3.existsSync(filePath)) {
     throw new TemplateError(`Template file not found: ${filePath}`);
   }
-  const template = fs4.readFileSync(filePath, "utf-8");
+  const template = fs3.readFileSync(filePath, "utf-8");
   return renderEjs(template, context);
 }
 
 // src/templates/handlebars.ts
-import * as fs5 from "fs";
-import * as path3 from "path";
+import * as fs4 from "fs";
+import * as path2 from "path";
 import Handlebars from "handlebars";
 function registerHandlebarsHelpers() {
   Handlebars.registerHelper("capitalize", (str) => {
@@ -1005,28 +986,28 @@ function renderHandlebars(template, context) {
   }
 }
 function renderHandlebarsFile(filePath, context) {
-  if (!fs5.existsSync(filePath)) {
+  if (!fs4.existsSync(filePath)) {
     throw new TemplateError(`Template file not found: ${filePath}`);
   }
-  const template = fs5.readFileSync(filePath, "utf-8");
+  const template = fs4.readFileSync(filePath, "utf-8");
   return renderHandlebars(template, context);
 }
 function renderHandlebarsComposable(templateDir, context) {
   registerHandlebarsHelpers();
-  const versionPath = path3.join(templateDir, "version.hbs");
-  const entryPath = path3.join(templateDir, "entry.hbs");
-  const documentPath = path3.join(templateDir, "document.hbs");
-  if (!fs5.existsSync(documentPath)) {
+  const versionPath = path2.join(templateDir, "version.hbs");
+  const entryPath = path2.join(templateDir, "entry.hbs");
+  const documentPath = path2.join(templateDir, "document.hbs");
+  if (!fs4.existsSync(documentPath)) {
     throw new TemplateError(`Document template not found: ${documentPath}`);
   }
-  if (fs5.existsSync(versionPath)) {
-    Handlebars.registerPartial("version", fs5.readFileSync(versionPath, "utf-8"));
+  if (fs4.existsSync(versionPath)) {
+    Handlebars.registerPartial("version", fs4.readFileSync(versionPath, "utf-8"));
   }
-  if (fs5.existsSync(entryPath)) {
-    Handlebars.registerPartial("entry", fs5.readFileSync(entryPath, "utf-8"));
+  if (fs4.existsSync(entryPath)) {
+    Handlebars.registerPartial("entry", fs4.readFileSync(entryPath, "utf-8"));
   }
   try {
-    const compiled = Handlebars.compile(fs5.readFileSync(documentPath, "utf-8"));
+    const compiled = Handlebars.compile(fs4.readFileSync(documentPath, "utf-8"));
     return compiled(context);
   } catch (error) {
     throw new TemplateError(`Handlebars render error: ${error instanceof Error ? error.message : String(error)}`);
@@ -1034,8 +1015,8 @@ function renderHandlebarsComposable(templateDir, context) {
 }
 
 // src/templates/liquid.ts
-import * as fs6 from "fs";
-import * as path4 from "path";
+import * as fs5 from "fs";
+import * as path3 from "path";
 import { Liquid } from "liquidjs";
 function createLiquidEngine(root) {
   return new Liquid({
@@ -1053,15 +1034,15 @@ function renderLiquid(template, context) {
   }
 }
 function renderLiquidFile(filePath, context) {
-  if (!fs6.existsSync(filePath)) {
+  if (!fs5.existsSync(filePath)) {
     throw new TemplateError(`Template file not found: ${filePath}`);
   }
-  const template = fs6.readFileSync(filePath, "utf-8");
+  const template = fs5.readFileSync(filePath, "utf-8");
   return renderLiquid(template, context);
 }
 function renderLiquidComposable(templateDir, context) {
-  const documentPath = path4.join(templateDir, "document.liquid");
-  if (!fs6.existsSync(documentPath)) {
+  const documentPath = path3.join(templateDir, "document.liquid");
+  if (!fs5.existsSync(documentPath)) {
     throw new TemplateError(`Document template not found: ${documentPath}`);
   }
   const engine = createLiquidEngine(templateDir);
@@ -1073,10 +1054,10 @@ function renderLiquidComposable(templateDir, context) {
 }
 
 // src/templates/loader.ts
-import * as fs7 from "fs";
-import * as path5 from "path";
+import * as fs6 from "fs";
+import * as path4 from "path";
 function getEngineFromFile(filePath) {
-  const ext = path5.extname(filePath).toLowerCase();
+  const ext = path4.extname(filePath).toLowerCase();
   switch (ext) {
     case ".liquid":
       return "liquid";
@@ -1110,10 +1091,10 @@ function getRenderFileFn(engine) {
   }
 }
 function detectTemplateMode(templatePath) {
-  if (!fs7.existsSync(templatePath)) {
+  if (!fs6.existsSync(templatePath)) {
     throw new TemplateError(`Template path not found: ${templatePath}`);
   }
-  const stat = fs7.statSync(templatePath);
+  const stat = fs6.statSync(templatePath);
   if (stat.isFile()) {
     return "single";
   }
@@ -1131,7 +1112,7 @@ function renderSingleFile(templatePath, context, engine) {
   };
 }
 function renderComposable(templateDir, context, engine) {
-  const files = fs7.readdirSync(templateDir);
+  const files = fs6.readdirSync(templateDir);
   const engineMap = {
     liquid: { document: "document.liquid", version: "version.liquid", entry: "entry.liquid" },
     handlebars: { document: "document.hbs", version: "version.hbs", entry: "entry.hbs" },
@@ -1154,15 +1135,15 @@ function renderComposable(templateDir, context, engine) {
     return { content: renderHandlebarsComposable(templateDir, context), engine: resolvedEngine };
   }
   const expectedFiles = engineMap[resolvedEngine];
-  const documentPath = path5.join(templateDir, expectedFiles.document);
-  if (!fs7.existsSync(documentPath)) {
+  const documentPath = path4.join(templateDir, expectedFiles.document);
+  if (!fs6.existsSync(documentPath)) {
     throw new TemplateError(`Document template not found: ${expectedFiles.document}`);
   }
-  const versionPath = path5.join(templateDir, expectedFiles.version);
-  const entryPath = path5.join(templateDir, expectedFiles.entry);
+  const versionPath = path4.join(templateDir, expectedFiles.version);
+  const entryPath = path4.join(templateDir, expectedFiles.entry);
   const render = getRenderFn(resolvedEngine);
-  const entryTemplate = fs7.existsSync(entryPath) ? fs7.readFileSync(entryPath, "utf-8") : null;
-  const versionTemplate = fs7.existsSync(versionPath) ? fs7.readFileSync(versionPath, "utf-8") : null;
+  const entryTemplate = fs6.existsSync(entryPath) ? fs6.readFileSync(entryPath, "utf-8") : null;
+  const versionTemplate = fs6.existsSync(versionPath) ? fs6.readFileSync(versionPath, "utf-8") : null;
   if (entryTemplate && versionTemplate) {
     const versionsWithEntries = context.versions.map((versionCtx) => {
       const entries = versionCtx.entries.map((entry) => {
@@ -1173,7 +1154,7 @@ function renderComposable(templateDir, context, engine) {
     });
     const docContext = { ...context, renderedVersions: versionsWithEntries };
     return {
-      content: render(fs7.readFileSync(documentPath, "utf-8"), docContext),
+      content: render(fs6.readFileSync(documentPath, "utf-8"), docContext),
       engine: resolvedEngine
     };
   }
@@ -1214,17 +1195,27 @@ function renderTemplate(templatePath, context, engine) {
 }
 
 // src/core/pipeline.ts
-function generateCompareUrl(repoUrl, from, to) {
+function generateCompareUrl(repoUrl, from, to, packageName) {
+  const isPackageSpecific = from.includes("@") && packageName && from.includes(packageName);
+  let fromVersion;
+  let toVersion;
+  if (isPackageSpecific) {
+    fromVersion = from;
+    toVersion = `${packageName}@${to.startsWith("v") ? "" : "v"}${to}`;
+  } else {
+    fromVersion = from.replace(/^v/, "");
+    toVersion = to.replace(/^v/, "");
+  }
   if (/gitlab\.com/i.test(repoUrl)) {
-    return `${repoUrl}/-/compare/${from}...${to}`;
+    return `${repoUrl}/-/compare/${fromVersion}...${toVersion}`;
   }
   if (/bitbucket\.org/i.test(repoUrl)) {
-    return `${repoUrl}/branches/compare/${from}..${to}`;
+    return `${repoUrl}/branches/compare/${fromVersion}..${toVersion}`;
   }
-  return `${repoUrl}/compare/${from}...${to}`;
+  return `${repoUrl}/compare/${fromVersion}...${toVersion}`;
 }
 function createTemplateContext(pkg) {
-  const compareUrl = pkg.repoUrl && pkg.previousVersion ? generateCompareUrl(pkg.repoUrl, pkg.previousVersion, pkg.version) : void 0;
+  const compareUrl = pkg.repoUrl && pkg.previousVersion ? generateCompareUrl(pkg.repoUrl, pkg.previousVersion, pkg.version, pkg.packageName) : void 0;
   return {
     packageName: pkg.packageName,
     version: pkg.version,
@@ -1262,15 +1253,17 @@ async function processWithLLM(context, config) {
     previousVersion: context.previousVersion ?? void 0,
     date: context.date,
     categories: config.llm.categories,
-    style: config.llm.style
+    style: config.llm.style,
+    scopes: config.llm.scopes,
+    prompts: config.llm.prompts
   };
   const enhanced = {
     entries: context.entries
   };
   try {
-    info4(`Using LLM provider: ${config.llm.provider}${config.llm.model ? ` (${config.llm.model})` : ""}`);
+    info3(`Using LLM provider: ${config.llm.provider}${config.llm.model ? ` (${config.llm.model})` : ""}`);
     if (config.llm.baseURL) {
-      info4(`LLM base URL: ${config.llm.baseURL}`);
+      info3(`LLM base URL: ${config.llm.baseURL}`);
     }
     const rawProvider = createProvider(config.llm);
     const retryOpts = config.llm.retry ?? LLM_DEFAULTS.retry;
@@ -1279,54 +1272,53 @@ async function processWithLLM(context, config) {
       complete: (prompt, opts) => withRetry(() => rawProvider.complete(prompt, opts), retryOpts)
     };
     const activeTasks = Object.entries(tasks).filter(([, enabled]) => enabled).map(([name]) => name);
-    info4(`Running LLM tasks: ${activeTasks.join(", ")}`);
+    info3(`Running LLM tasks: ${activeTasks.join(", ")}`);
     if (tasks.enhance && tasks.categorize) {
-      info4("Enhancing and categorizing entries with LLM...");
+      info3("Enhancing and categorizing entries with LLM...");
       const result = await enhanceAndCategorize(provider, context.entries, llmContext);
       enhanced.entries = result.enhancedEntries;
       enhanced.categories = {};
       for (const cat of result.categories) {
         enhanced.categories[cat.category] = cat.entries;
       }
-      info4(`Enhanced ${enhanced.entries.length} entries into ${result.categories.length} categories`);
+      info3(`Enhanced ${enhanced.entries.length} entries into ${result.categories.length} categories`);
     } else {
       if (tasks.enhance) {
-        info4("Enhancing entries with LLM...");
+        info3("Enhancing entries with LLM...");
         enhanced.entries = await enhanceEntries(provider, context.entries, llmContext, config.llm.concurrency);
-        info4(`Enhanced ${enhanced.entries.length} entries`);
+        info3(`Enhanced ${enhanced.entries.length} entries`);
       }
       if (tasks.categorize) {
-        info4("Categorizing entries with LLM...");
+        info3("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;
         }
-        info4(`Created ${categorized.length} categories`);
+        info3(`Created ${categorized.length} categories`);
       }
     }
     if (tasks.summarize) {
-      info4("Summarizing entries with LLM...");
+      info3("Summarizing entries with LLM...");
       enhanced.summary = await summarizeEntries(provider, enhanced.entries, llmContext);
       if (enhanced.summary) {
-        info4("Summary generated successfully");
-        debug(`Summary: ${enhanced.summary.substring(0, 100)}...`);
+        info3("Summary generated successfully");
+        debug2(`Summary: ${enhanced.summary.substring(0, 100)}...`);
       } else {
         warn3("Summary generation returned empty result");
       }
     }
     if (tasks.releaseNotes) {
-      info4("Generating release notes with LLM...");
+      info3("Generating release notes with LLM...");
       enhanced.releaseNotes = await generateReleaseNotes(provider, enhanced.entries, llmContext);
       if (enhanced.releaseNotes) {
-        info4("Release notes generated successfully");
+        info3("Release notes generated successfully");
       } else {
         warn3("Release notes generation returned empty result");
       }
     }
     return {
       ...context,
-      entries: enhanced.entries,
       enhanced
     };
   } catch (error) {
@@ -1339,17 +1331,17 @@ function getBuiltinTemplatePath(style) {
   let packageRoot;
   try {
     const currentUrl = import.meta.url;
-    packageRoot = path6.dirname(new URL(currentUrl).pathname);
-    packageRoot = path6.join(packageRoot, "..", "..");
+    packageRoot = path5.dirname(new URL(currentUrl).pathname);
+    packageRoot = path5.join(packageRoot, "..", "..");
   } catch {
     packageRoot = __dirname;
   }
-  return path6.join(packageRoot, "templates", style);
+  return path5.join(packageRoot, "templates", style);
 }
 async function generateWithTemplate(contexts, config, outputPath, dryRun) {
   let templatePath;
   if (config.templates?.path) {
-    templatePath = path6.resolve(config.templates.path);
+    templatePath = path5.resolve(config.templates.path);
   } else {
     templatePath = getBuiltinTemplatePath("keep-a-changelog");
   }
@@ -1359,49 +1351,63 @@ async function generateWithTemplate(contexts, config, outputPath, dryRun) {
   );
   const result = renderTemplate(templatePath, documentContext, config.templates?.engine);
   if (dryRun) {
-    info4("--- Changelog Preview ---");
-    console.log(result.content);
-    info4("--- End Preview ---");
+    info3(`Would write templated output to ${outputPath}`);
+    debug2("--- Changelog Preview ---");
+    debug2(result.content);
+    debug2("--- End Preview ---");
     return;
   }
   if (outputPath === "-") {
     process.stdout.write(result.content);
     return;
   }
-  const dir = path6.dirname(outputPath);
-  if (!fs8.existsSync(dir)) {
-    fs8.mkdirSync(dir, { recursive: true });
+  const dir = path5.dirname(outputPath);
+  if (!fs7.existsSync(dir)) {
+    fs7.mkdirSync(dir, { recursive: true });
   }
-  fs8.writeFileSync(outputPath, result.content, "utf-8");
-  success4(`Changelog written to ${outputPath} (using ${result.engine} template)`);
+  fs7.writeFileSync(outputPath, result.content, "utf-8");
+  success3(`Changelog written to ${outputPath} (using ${result.engine} template)`);
 }
 async function runPipeline(input, config, dryRun) {
-  debug(`Processing ${input.packages.length} package(s)`);
+  debug2(`Processing ${input.packages.length} package(s)`);
   let contexts = input.packages.map(createTemplateContext);
   if (config.llm && !process.env.CHANGELOG_NO_LLM) {
-    info4("Processing with LLM enhancement");
+    info3("Processing with LLM enhancement");
     contexts = await Promise.all(contexts.map((ctx) => processWithLLM(ctx, config)));
   }
+  const files = [];
   for (const output of config.output) {
-    info4(`Generating ${output.format} output`);
+    info3(`Generating ${output.format} output`);
     switch (output.format) {
       case "markdown": {
         const file = output.file ?? "CHANGELOG.md";
-        if (config.templates?.path || output.options?.template) {
-          await generateWithTemplate(contexts, config, file, dryRun);
-        } else {
-          writeMarkdown(file, contexts, config, dryRun);
+        try {
+          const effectiveTemplateConfig = output.templates ?? config.templates;
+          if (effectiveTemplateConfig?.path || output.options?.template) {
+            const configWithTemplate = { ...config, templates: effectiveTemplateConfig };
+            await generateWithTemplate(contexts, configWithTemplate, file, dryRun);
+          } else {
+            writeMarkdown(file, contexts, config, dryRun);
+          }
+          if (!dryRun) files.push(file);
+        } catch (error) {
+          warn3(`Failed to write ${file}: ${error instanceof Error ? error.message : String(error)}`);
         }
         break;
       }
       case "json": {
         const file = output.file ?? "changelog.json";
-        writeJson(file, contexts, dryRun);
+        try {
+          writeJson(file, contexts, dryRun);
+          if (!dryRun) files.push(file);
+        } catch (error) {
+          warn3(`Failed to write ${file}: ${error instanceof Error ? error.message : String(error)}`);
+        }
         break;
       }
       case "github-release": {
         if (dryRun) {
-          info4("[DRY RUN] Would create GitHub release");
+          info3("[DRY RUN] Would create GitHub release");
           break;
         }
         const firstContext = contexts[0];
@@ -1429,139 +1435,33 @@ async function runPipeline(input, config, dryRun) {
       }
     }
   }
-}
-async function processInput(inputJson, config, dryRun) {
-  const input = parsePackageVersioner(inputJson);
-  await runPipeline(input, config, dryRun);
-}
-
-// src/monorepo/aggregator.ts
-import * as fs9 from "fs";
-import * as path7 from "path";
-import { info as info5, success as success5 } from "@releasekit/core";
-
-// src/monorepo/splitter.ts
-function splitByPackage(contexts) {
-  const byPackage = /* @__PURE__ */ new Map();
-  for (const ctx of contexts) {
-    byPackage.set(ctx.packageName, ctx);
-  }
-  return byPackage;
-}
-
-// src/monorepo/aggregator.ts
-function writeFile(outputPath, content, dryRun) {
-  if (dryRun) {
-    info5(`[DRY RUN] Would write to ${outputPath}`);
-    console.log(content);
-    return;
-  }
-  const dir = path7.dirname(outputPath);
-  if (!fs9.existsSync(dir)) {
-    fs9.mkdirSync(dir, { recursive: true });
-  }
-  fs9.writeFileSync(outputPath, content, "utf-8");
-  success5(`Changelog written to ${outputPath}`);
-}
-function aggregateToRoot(contexts) {
-  const aggregated = {
-    packageName: "monorepo",
-    version: contexts[0]?.version ?? "0.0.0",
-    previousVersion: contexts[0]?.previousVersion ?? null,
-    date: (/* @__PURE__ */ new Date()).toISOString().split("T")[0] ?? "",
-    repoUrl: contexts[0]?.repoUrl ?? null,
-    entries: []
-  };
-  for (const ctx of contexts) {
-    for (const entry of ctx.entries) {
-      aggregated.entries.push({
-        ...entry,
-        scope: entry.scope ? `${ctx.packageName}/${entry.scope}` : ctx.packageName
-      });
-    }
-  }
-  return aggregated;
-}
-function writeMonorepoChangelogs(contexts, options, config, dryRun) {
-  if (options.mode === "root" || options.mode === "both") {
-    const aggregated = aggregateToRoot(contexts);
-    const rootPath = path7.join(options.rootPath, "CHANGELOG.md");
-    info5(`Writing root changelog to ${rootPath}`);
-    const rootContent = config.updateStrategy === "prepend" && fs9.existsSync(rootPath) ? prependVersion(rootPath, aggregated) : renderMarkdown([aggregated]);
-    writeFile(rootPath, rootContent, dryRun);
-  }
-  if (options.mode === "packages" || options.mode === "both") {
-    const byPackage = splitByPackage(contexts);
-    const packageDirMap = buildPackageDirMap(options.rootPath, options.packagesPath);
-    for (const [packageName, ctx] of byPackage) {
-      const simpleName = packageName.split("/").pop();
-      const packageDir = packageDirMap.get(packageName) ?? (simpleName ? packageDirMap.get(simpleName) : void 0) ?? null;
-      if (packageDir) {
-        const changelogPath = path7.join(packageDir, "CHANGELOG.md");
-        info5(`Writing changelog for ${packageName} to ${changelogPath}`);
-        const pkgContent = config.updateStrategy === "prepend" && fs9.existsSync(changelogPath) ? prependVersion(changelogPath, ctx) : renderMarkdown([ctx]);
-        writeFile(changelogPath, pkgContent, dryRun);
-      } else {
-        info5(`Could not find directory for package ${packageName}, skipping`);
-      }
+  if (config.monorepo?.mode) {
+    const { detectMonorepo, writeMonorepoChangelogs } = await import("./aggregator-BDTUZWOA.js");
+    const cwd = process.cwd();
+    const detected = detectMonorepo(cwd);
+    if (detected.isMonorepo) {
+      const monoFiles = writeMonorepoChangelogs(
+        contexts,
+        {
+          rootPath: config.monorepo.rootPath ?? cwd,
+          packagesPath: config.monorepo.packagesPath ?? detected.packagesPath,
+          mode: config.monorepo.mode
+        },
+        config,
+        dryRun
+      );
+      files.push(...monoFiles);
     }
   }
-}
-function buildPackageDirMap(rootPath, packagesPath) {
-  const map = /* @__PURE__ */ new Map();
-  const packagesDir = path7.join(rootPath, packagesPath);
-  if (!fs9.existsSync(packagesDir)) {
-    return map;
-  }
-  for (const entry of fs9.readdirSync(packagesDir, { withFileTypes: true })) {
-    if (!entry.isDirectory()) continue;
-    const dirPath = path7.join(packagesDir, entry.name);
-    map.set(entry.name, dirPath);
-    const packageJsonPath = path7.join(dirPath, "package.json");
-    if (fs9.existsSync(packageJsonPath)) {
-      try {
-        const pkg = JSON.parse(fs9.readFileSync(packageJsonPath, "utf-8"));
-        if (pkg.name) {
-          map.set(pkg.name, dirPath);
-        }
-      } catch {
-      }
-    }
+  const packageNotes = {};
+  for (const ctx of contexts) {
+    packageNotes[ctx.packageName] = formatVersion(ctx);
   }
-  return map;
+  return { packageNotes, files };
 }
-function detectMonorepo(cwd) {
-  const pnpmWorkspacesPath = path7.join(cwd, "pnpm-workspace.yaml");
-  const packageJsonPath = path7.join(cwd, "package.json");
-  if (fs9.existsSync(pnpmWorkspacesPath)) {
-    const content = fs9.readFileSync(pnpmWorkspacesPath, "utf-8");
-    const packagesMatch = content.match(/packages:\s*\n\s*-\s*['"]([^'"]+)['"]/);
-    if (packagesMatch?.[1]) {
-      const packagesGlob = packagesMatch[1];
-      const packagesPath = packagesGlob.replace(/\/?\*$/, "").replace(/\/\*\*$/, "");
-      return { isMonorepo: true, packagesPath: packagesPath || "packages" };
-    }
-    return { isMonorepo: true, packagesPath: "packages" };
-  }
-  if (fs9.existsSync(packageJsonPath)) {
-    try {
-      const content = fs9.readFileSync(packageJsonPath, "utf-8");
-      const pkg = JSON.parse(content);
-      if (pkg.workspaces) {
-        const workspaces = Array.isArray(pkg.workspaces) ? pkg.workspaces : pkg.workspaces.packages;
-        if (workspaces?.length) {
-          const firstWorkspace = workspaces[0];
-          if (firstWorkspace) {
-            const packagesPath = firstWorkspace.replace(/\/?\*$/, "").replace(/\/\*\*$/, "");
-            return { isMonorepo: true, packagesPath: packagesPath || "packages" };
-          }
-        }
-      }
-    } catch {
-      return { isMonorepo: false, packagesPath: "" };
-    }
-  }
-  return { isMonorepo: false, packagesPath: "" };
+async function processInput(inputJson, config, dryRun) {
+  const input = parsePackageVersioner(inputJson);
+  return runPipeline(input, config, dryRun);
 }
 
 export {
@@ -1580,14 +1480,9 @@ export {
   parsePackageVersioner,
   parsePackageVersionerFile,
   parsePackageVersionerStdin,
-  renderMarkdown,
-  writeMarkdown,
   renderJson,
   writeJson,
   createTemplateContext,
   runPipeline,
-  processInput,
-  aggregateToRoot,
-  writeMonorepoChangelogs,
-  detectMonorepo
+  processInput
 };