@releasekit/notes 0.2.0-next.0 → 0.2.0-next.10

package/dist/cli.cjs

@@ -26,7 +26,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 // src/cli.ts
 var fs10 = __toESM(require("fs"), 1);
 var readline = __toESM(require("readline"), 1);
-var import_core9 = require("@releasekit/core");
+var import_core10 = require("@releasekit/core");
 var import_commander = require("commander");
 
 // src/core/config.ts
@@ -45,7 +45,7 @@ function getDefaultConfig() {
 // src/core/pipeline.ts
 var fs8 = __toESM(require("fs"), 1);
 var path6 = __toESM(require("path"), 1);
-var import_core7 = require("@releasekit/core");
+var import_core8 = require("@releasekit/core");
 
 // src/input/package-versioner.ts
 var fs = __toESM(require("fs"), 1);
@@ -366,15 +366,26 @@ 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");
+  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(", ")}.
+`;
+      }
+    }
+  }
   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.
+Given the following entries, group them into the specified categories. Only use the categories listed below in this exact order:
 
 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").
-
+${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
@@ -406,7 +417,8 @@ async function categorizeEntries(provider, entries, context) {
           entries[idx] = { ...entries[idx], scope };
         }
       }
-      for (const [category, indices] of Object.entries(categoryMap)) {
+      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);
         if (categoryEntries.length > 0) {
           result.push({ category, entries: categoryEntries });
@@ -414,7 +426,8 @@ async function categorizeEntries(provider, entries, context) {
       }
     } else {
       const categoryMap = parsed;
-      for (const [category, indices] of Object.entries(categoryMap)) {
+      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);
         if (categoryEntries.length > 0) {
           result.push({ category, entries: categoryEntries });
@@ -472,6 +485,113 @@ async function enhanceEntries(provider, entries, context, concurrency = LLM_DEFA
   return results;
 }
 
+// src/llm/tasks/enhance-and-categorize.ts
+var import_core4 = require("@releasekit/core");
+
+// src/utils/retry.ts
+function sleep(ms) {
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
+}
+async function withRetry(fn, options = {}) {
+  const maxAttempts = options.maxAttempts ?? 3;
+  const initialDelay = options.initialDelay ?? 1e3;
+  const maxDelay = options.maxDelay ?? 3e4;
+  const backoffFactor = options.backoffFactor ?? 2;
+  let lastError;
+  for (let attempt = 0; attempt < maxAttempts; attempt++) {
+    try {
+      return await fn();
+    } catch (error2) {
+      lastError = error2;
+      if (attempt < maxAttempts - 1) {
+        const base = Math.min(initialDelay * backoffFactor ** attempt, maxDelay);
+        const jitter = base * 0.2 * (Math.random() * 2 - 1);
+        await sleep(Math.max(0, base + jitter));
+      }
+    }
+  }
+  throw lastError;
+}
+
+// src/llm/tasks/enhance-and-categorize.ts
+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").`;
+  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
+2. **Categorize** each entry into the appropriate category
+
+Style guidelines:
+- ${styleText}
+- 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").' : ""}
+
+Entries:
+${entriesText}
+
+Output a JSON object with:
+- "entries": array of objects, one per input entry (same order), each with: { "description": "rewritten text", "category": "CategoryName", "scope": "optional subcategory label or null" }
+
+Output only valid JSON, nothing else:`;
+}
+async function enhanceAndCategorize(provider, entries, context) {
+  if (entries.length === 0) {
+    return { enhancedEntries: [], categories: [] };
+  }
+  const retryOpts = LLM_DEFAULTS.retry;
+  try {
+    return await withRetry(async () => {
+      const prompt = buildPrompt(entries, context.categories, context.style);
+      const response = await provider.complete(prompt);
+      const cleaned = response.replace(/^```(?:json)?\n?/, "").replace(/\n?```$/, "").trim();
+      const parsed = JSON.parse(cleaned);
+      if (!Array.isArray(parsed.entries)) {
+        throw new Error('Response missing "entries" array');
+      }
+      const enhancedEntries = entries.map((original, i) => {
+        const result = parsed.entries[i];
+        if (!result) return original;
+        return {
+          ...original,
+          description: result.description || original.description,
+          scope: result.scope || original.scope
+        };
+      });
+      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];
+        if (!entry) continue;
+        if (!categoryMap.has(category)) {
+          categoryMap.set(category, []);
+        }
+        categoryMap.get(category).push(entry);
+      }
+      const categories = [];
+      for (const [category, catEntries] of categoryMap) {
+        categories.push({ category, entries: catEntries });
+      }
+      return { enhancedEntries, categories };
+    }, retryOpts);
+  } catch (error2) {
+    (0, import_core4.warn)(
+      `Combined enhance+categorize failed after ${retryOpts.maxAttempts} attempts: ${error2 instanceof Error ? error2.message : String(error2)}`
+    );
+    return {
+      enhancedEntries: entries,
+      categories: [{ category: "General", entries }]
+    };
+  }
+}
+
 // src/llm/tasks/release-notes.ts
 var RELEASE_NOTES_PROMPT = `You are writing release notes for a software project.
 
@@ -572,12 +692,12 @@ function createProvider(config) {
 
 // src/output/github-release.ts
 var import_rest = require("@octokit/rest");
-var import_core5 = require("@releasekit/core");
+var import_core6 = require("@releasekit/core");
 
 // src/output/markdown.ts
 var fs2 = __toESM(require("fs"), 1);
 var path = __toESM(require("path"), 1);
-var import_core4 = require("@releasekit/core");
+var import_core5 = require("@releasekit/core");
 var TYPE_ORDER = ["added", "changed", "deprecated", "removed", "fixed", "security"];
 var TYPE_LABELS = {
   added: "Added",
@@ -676,15 +796,19 @@ ${body}`;
 function writeMarkdown(outputPath, contexts, config, dryRun) {
   const content = renderMarkdown(contexts);
   if (dryRun) {
-    (0, import_core4.info)("--- Changelog Preview ---");
+    (0, import_core5.info)("--- Changelog Preview ---");
     console.log(content);
-    (0, import_core4.info)("--- End Preview ---");
+    (0, import_core5.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) {
@@ -694,7 +818,7 @@ function writeMarkdown(outputPath, contexts, config, dryRun) {
   } else {
     fs2.writeFileSync(outputPath, content, "utf-8");
   }
-  (0, import_core4.success)(`Changelog written to ${outputPath}`);
+  (0, import_core5.success)(`Changelog written to ${outputPath}`);
 }
 
 // src/output/github-release.ts
@@ -719,7 +843,7 @@ var GitHubClient = class {
     } else {
       body = renderMarkdown([context]);
     }
-    (0, import_core5.info)(`Creating GitHub release for ${tagName}`);
+    (0, import_core6.info)(`Creating GitHub release for ${tagName}`);
     try {
       const response = await this.octokit.repos.createRelease({
         owner: this.owner,
@@ -731,7 +855,7 @@ var GitHubClient = class {
         prerelease: options.prerelease ?? false,
         generate_release_notes: options.generateNotes ?? false
       });
-      (0, import_core5.success)(`Release created: ${response.data.html_url}`);
+      (0, import_core6.success)(`Release created: ${response.data.html_url}`);
       return {
         id: response.data.id,
         htmlUrl: response.data.html_url,
@@ -749,7 +873,7 @@ var GitHubClient = class {
     } else {
       body = renderMarkdown([context]);
     }
-    (0, import_core5.info)(`Updating GitHub release ${releaseId}`);
+    (0, import_core6.info)(`Updating GitHub release ${releaseId}`);
     try {
       const response = await this.octokit.repos.updateRelease({
         owner: this.owner,
@@ -761,7 +885,7 @@ var GitHubClient = class {
         draft: options.draft ?? false,
         prerelease: options.prerelease ?? false
       });
-      (0, import_core5.success)(`Release updated: ${response.data.html_url}`);
+      (0, import_core6.success)(`Release updated: ${response.data.html_url}`);
       return {
         id: response.data.id,
         htmlUrl: response.data.html_url,
@@ -813,7 +937,7 @@ async function createGitHubRelease(context, options) {
 // src/output/json.ts
 var fs3 = __toESM(require("fs"), 1);
 var path2 = __toESM(require("path"), 1);
-var import_core6 = require("@releasekit/core");
+var import_core7 = require("@releasekit/core");
 function renderJson(contexts) {
   return JSON.stringify(
     {
@@ -833,9 +957,9 @@ function renderJson(contexts) {
 function writeJson(outputPath, contexts, dryRun) {
   const content = renderJson(contexts);
   if (dryRun) {
-    (0, import_core6.info)("--- JSON Output Preview ---");
+    (0, import_core7.info)("--- JSON Output Preview ---");
     console.log(content);
-    (0, import_core6.info)("--- End Preview ---");
+    (0, import_core7.info)("--- End Preview ---");
     return;
   }
   const dir = path2.dirname(outputPath);
@@ -843,7 +967,7 @@ function writeJson(outputPath, contexts, dryRun) {
     fs3.mkdirSync(dir, { recursive: true });
   }
   fs3.writeFileSync(outputPath, content, "utf-8");
-  (0, import_core6.success)(`JSON output written to ${outputPath}`);
+  (0, import_core7.success)(`JSON output written to ${outputPath}`);
 }
 
 // src/templates/ejs.ts
@@ -1100,41 +1224,24 @@ function renderTemplate(templatePath, context, engine) {
   return renderComposable(templatePath, context, engine);
 }
 
-// src/utils/retry.ts
-function sleep(ms) {
-  return new Promise((resolve2) => setTimeout(resolve2, ms));
-}
-async function withRetry(fn, options = {}) {
-  const maxAttempts = options.maxAttempts ?? 3;
-  const initialDelay = options.initialDelay ?? 1e3;
-  const maxDelay = options.maxDelay ?? 3e4;
-  const backoffFactor = options.backoffFactor ?? 2;
-  let lastError;
-  for (let attempt = 0; attempt < maxAttempts; attempt++) {
-    try {
-      return await fn();
-    } catch (error2) {
-      lastError = error2;
-      if (attempt < maxAttempts - 1) {
-        const base = Math.min(initialDelay * backoffFactor ** attempt, maxDelay);
-        const jitter = base * 0.2 * (Math.random() * 2 - 1);
-        await sleep(Math.max(0, base + jitter));
-      }
-    }
-  }
-  throw lastError;
-}
-
 // src/core/pipeline.ts
 var import_meta = {};
+function extractVersionFromTag(tag) {
+  if (tag.includes("@") && !tag.startsWith("@")) {
+    return tag;
+  }
+  return tag.replace(/^v/, "");
+}
 function generateCompareUrl(repoUrl, from, to) {
+  const fromVersion = extractVersionFromTag(from);
+  const toVersion = extractVersionFromTag(to);
   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;
@@ -1181,9 +1288,9 @@ async function processWithLLM(context, config) {
     entries: context.entries
   };
   try {
-    (0, import_core7.info)(`Using LLM provider: ${config.llm.provider}${config.llm.model ? ` (${config.llm.model})` : ""}`);
+    (0, import_core8.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}`);
+      (0, import_core8.info)(`LLM base URL: ${config.llm.baseURL}`);
     }
     const rawProvider = createProvider(config.llm);
     const retryOpts = config.llm.retry ?? LLM_DEFAULTS.retry;
@@ -1192,38 +1299,49 @@ 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);
-    (0, import_core7.info)(`Running LLM tasks: ${activeTasks.join(", ")}`);
-    if (tasks.enhance) {
-      (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`);
+    (0, import_core8.info)(`Running LLM tasks: ${activeTasks.join(", ")}`);
+    if (tasks.enhance && tasks.categorize) {
+      (0, import_core8.info)("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;
+      }
+      (0, import_core8.info)(`Enhanced ${enhanced.entries.length} entries into ${result.categories.length} categories`);
+    } else {
+      if (tasks.enhance) {
+        (0, import_core8.info)("Enhancing entries with LLM...");
+        enhanced.entries = await enhanceEntries(provider, context.entries, llmContext, config.llm.concurrency);
+        (0, import_core8.info)(`Enhanced ${enhanced.entries.length} entries`);
+      }
+      if (tasks.categorize) {
+        (0, import_core8.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_core8.info)(`Created ${categorized.length} categories`);
+      }
     }
     if (tasks.summarize) {
-      (0, import_core7.info)("Summarizing entries with LLM...");
+      (0, import_core8.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)}...`);
+        (0, import_core8.info)("Summary generated successfully");
+        (0, import_core8.debug)(`Summary: ${enhanced.summary.substring(0, 100)}...`);
       } else {
-        (0, import_core7.warn)("Summary generation returned empty result");
-      }
-    }
-    if (tasks.categorize) {
-      (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_core8.warn)("Summary generation returned empty result");
       }
-      (0, import_core7.info)(`Created ${categorized.length} categories`);
     }
     if (tasks.releaseNotes) {
-      (0, import_core7.info)("Generating release notes with LLM...");
+      (0, import_core8.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");
+        (0, import_core8.info)("Release notes generated successfully");
       } else {
-        (0, import_core7.warn)("Release notes generation returned empty result");
+        (0, import_core8.warn)("Release notes generation returned empty result");
       }
     }
     return {
@@ -1232,8 +1350,8 @@ async function processWithLLM(context, config) {
       enhanced
     };
   } catch (error2) {
-    (0, import_core7.warn)(`LLM processing failed: ${error2 instanceof Error ? error2.message : String(error2)}`);
-    (0, import_core7.warn)("Falling back to raw entries");
+    (0, import_core8.warn)(`LLM processing failed: ${error2 instanceof Error ? error2.message : String(error2)}`);
+    (0, import_core8.warn)("Falling back to raw entries");
     return context;
   }
 }
@@ -1261,9 +1379,13 @@ async function generateWithTemplate(contexts, config, outputPath, dryRun) {
   );
   const result = renderTemplate(templatePath, documentContext, config.templates?.engine);
   if (dryRun) {
-    (0, import_core7.info)("--- Changelog Preview ---");
+    (0, import_core8.info)("--- Changelog Preview ---");
     console.log(result.content);
-    (0, import_core7.info)("--- End Preview ---");
+    (0, import_core8.info)("--- End Preview ---");
+    return;
+  }
+  if (outputPath === "-") {
+    process.stdout.write(result.content);
     return;
   }
   const dir = path6.dirname(outputPath);
@@ -1271,17 +1393,17 @@ async function generateWithTemplate(contexts, config, outputPath, dryRun) {
     fs8.mkdirSync(dir, { recursive: true });
   }
   fs8.writeFileSync(outputPath, result.content, "utf-8");
-  (0, import_core7.success)(`Changelog written to ${outputPath} (using ${result.engine} template)`);
+  (0, import_core8.success)(`Changelog written to ${outputPath} (using ${result.engine} template)`);
 }
 async function runPipeline(input, config, dryRun) {
-  (0, import_core7.debug)(`Processing ${input.packages.length} package(s)`);
+  (0, import_core8.debug)(`Processing ${input.packages.length} package(s)`);
   let contexts = input.packages.map(createTemplateContext);
   if (config.llm && !process.env.CHANGELOG_NO_LLM) {
-    (0, import_core7.info)("Processing with LLM enhancement");
+    (0, import_core8.info)("Processing with LLM enhancement");
     contexts = await Promise.all(contexts.map((ctx) => processWithLLM(ctx, config)));
   }
   for (const output of config.output) {
-    (0, import_core7.info)(`Generating ${output.format} output`);
+    (0, import_core8.info)(`Generating ${output.format} output`);
     switch (output.format) {
       case "markdown": {
         const file = output.file ?? "CHANGELOG.md";
@@ -1299,22 +1421,22 @@ async function runPipeline(input, config, dryRun) {
       }
       case "github-release": {
         if (dryRun) {
-          (0, import_core7.info)("[DRY RUN] Would create GitHub release");
+          (0, import_core8.info)("[DRY RUN] Would create GitHub release");
           break;
         }
         const firstContext = contexts[0];
         if (!firstContext) {
-          (0, import_core7.warn)("No context available for GitHub release");
+          (0, import_core8.warn)("No context available for GitHub release");
           break;
         }
         const repoUrl = firstContext.repoUrl;
         if (!repoUrl) {
-          (0, import_core7.warn)("No repo URL available, cannot create GitHub release");
+          (0, import_core8.warn)("No repo URL available, cannot create GitHub release");
           break;
         }
         const parsed = parseRepoUrl(repoUrl);
         if (!parsed) {
-          (0, import_core7.warn)(`Could not parse repo URL: ${repoUrl}`);
+          (0, import_core8.warn)(`Could not parse repo URL: ${repoUrl}`);
           break;
         }
         await createGitHubRelease(firstContext, {
@@ -1332,7 +1454,7 @@ async function runPipeline(input, config, dryRun) {
 // src/monorepo/aggregator.ts
 var fs9 = __toESM(require("fs"), 1);
 var path7 = __toESM(require("path"), 1);
-var import_core8 = require("@releasekit/core");
+var import_core9 = require("@releasekit/core");
 
 // src/monorepo/splitter.ts
 function splitByPackage(contexts) {
@@ -1346,7 +1468,7 @@ function splitByPackage(contexts) {
 // src/monorepo/aggregator.ts
 function writeFile(outputPath, content, dryRun) {
   if (dryRun) {
-    (0, import_core8.info)(`[DRY RUN] Would write to ${outputPath}`);
+    (0, import_core9.info)(`[DRY RUN] Would write to ${outputPath}`);
     console.log(content);
     return;
   }
@@ -1355,7 +1477,7 @@ function writeFile(outputPath, content, dryRun) {
     fs9.mkdirSync(dir, { recursive: true });
   }
   fs9.writeFileSync(outputPath, content, "utf-8");
-  (0, import_core8.success)(`Changelog written to ${outputPath}`);
+  (0, import_core9.success)(`Changelog written to ${outputPath}`);
 }
 function aggregateToRoot(contexts) {
   const aggregated = {
@@ -1380,7 +1502,7 @@ 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");
-    (0, import_core8.info)(`Writing root changelog to ${rootPath}`);
+    (0, import_core9.info)(`Writing root changelog to ${rootPath}`);
     const rootContent = config.updateStrategy === "prepend" && fs9.existsSync(rootPath) ? prependVersion(rootPath, aggregated) : renderMarkdown([aggregated]);
     writeFile(rootPath, rootContent, dryRun);
   }
@@ -1392,11 +1514,11 @@ function writeMonorepoChangelogs(contexts, options, config, dryRun) {
       const packageDir = packageDirMap.get(packageName) ?? (simpleName ? packageDirMap.get(simpleName) : void 0) ?? null;
       if (packageDir) {
         const changelogPath = path7.join(packageDir, "CHANGELOG.md");
-        (0, import_core8.info)(`Writing changelog for ${packageName} to ${changelogPath}`);
+        (0, import_core9.info)(`Writing changelog for ${packageName} to ${changelogPath}`);
         const pkgContent = config.updateStrategy === "prepend" && fs9.existsSync(changelogPath) ? prependVersion(changelogPath, ctx) : renderMarkdown([ctx]);
         writeFile(changelogPath, pkgContent, dryRun);
       } else {
-        (0, import_core8.info)(`Could not find directory for package ${packageName}, skipping`);
+        (0, import_core9.info)(`Could not find directory for package ${packageName}, skipping`);
       }
     }
   }
@@ -1461,9 +1583,9 @@ 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-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) => {
+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("--target <package>", "Filter to a specific package name").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);
+  if (options.quiet) (0, import_core10.setQuietMode)(true);
   try {
     const config = loadConfig(process.cwd(), options.config);
     if (options.output.length > 0) {
@@ -1482,7 +1604,7 @@ 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");
+      (0, import_core10.info)("LLM processing disabled via --no-llm flag");
       delete config.llm;
     } else if (options.llmProvider || options.llmModel || options.llmBaseUrl || options.llmTasks) {
       config.llm = config.llm ?? { provider: "openai-compatible", model: "" };
@@ -1498,13 +1620,13 @@ 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})` : ""}`);
+      (0, import_core10.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}`);
+        (0, import_core10.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}`);
+        (0, import_core10.info)(`LLM tasks: ${taskList}`);
       }
     }
     let inputJson;
@@ -1514,14 +1636,23 @@ program.command("generate", { isDefault: true }).description("Generate changelog
       inputJson = await readStdin();
     }
     const input = parsePackageVersioner(inputJson);
+    if (options.target) {
+      const before = input.packages.length;
+      input.packages = input.packages.filter((p) => p.packageName === options.target);
+      if (input.packages.length === 0) {
+        (0, import_core10.info)(`No changelog found for package "${options.target}" (had ${before} package(s))`);
+        return;
+      }
+      (0, import_core10.info)(`Filtered to package: ${options.target}`);
+    }
     if (options.monorepo || config.monorepo) {
       const monorepoMode = options.monorepo ?? config.monorepo?.mode ?? "both";
       const detected = detectMonorepo(process.cwd());
       if (!detected.isMonorepo) {
-        (0, import_core9.info)("No monorepo detected, using single package mode");
+        (0, import_core10.info)("No monorepo detected, using single package mode");
         await runPipeline(input, config, options.dryRun ?? false);
       } else {
-        (0, import_core9.info)(`Monorepo detected with packages at ${detected.packagesPath}`);
+        (0, import_core10.info)(`Monorepo detected with packages at ${detected.packagesPath}`);
         const contexts = input.packages.map(createTemplateContext);
         writeMonorepoChangelogs(
           contexts,
@@ -1538,9 +1669,9 @@ program.command("generate", { isDefault: true }).description("Generate changelog
       await runPipeline(input, config, options.dryRun ?? false);
     }
     if (options.dryRun) {
-      (0, import_core9.info)("Dry run complete - no files were written");
+      (0, import_core10.info)("Dry run complete - no files were written");
     } else {
-      (0, import_core9.success)("Changelog generation complete");
+      (0, import_core10.success)("Changelog generation complete");
     }
   } catch (err) {
     handleError(err);
@@ -1549,7 +1680,7 @@ program.command("generate", { isDefault: true }).description("Generate changelog
 program.command("init").description("Create default configuration file").option("-f, --force", "Overwrite existing config").action((options) => {
   const configPath = "releasekit.config.json";
   if (fs10.existsSync(configPath) && !options.force) {
-    (0, import_core9.error)(`Config file already exists at ${configPath}. Use --force to overwrite.`);
+    (0, import_core10.error)(`Config file already exists at ${configPath}. Use --force to overwrite.`);
     process.exit(import_core2.EXIT_CODES.GENERAL_ERROR);
   }
   const defaultConfig = {
@@ -1560,7 +1691,7 @@ program.command("init").description("Create default configuration file").option(
     }
   };
   fs10.writeFileSync(configPath, JSON.stringify(defaultConfig, null, 2), "utf-8");
-  (0, import_core9.success)(`Created config file at ${configPath}`);
+  (0, import_core10.success)(`Created config file at ${configPath}`);
 });
 program.command("auth <provider>").description("Configure API key for an LLM provider").option("--key <key>", "API key (omit to be prompted)").action(async (provider, options) => {
   let apiKey;
@@ -1570,14 +1701,14 @@ program.command("auth <provider>").description("Configure API key for an LLM pro
     apiKey = await promptSecret(`Enter API key for ${provider}: `);
   }
   if (!apiKey.trim()) {
-    (0, import_core9.error)("API key cannot be empty");
+    (0, import_core10.error)("API key cannot be empty");
     process.exit(import_core2.EXIT_CODES.GENERAL_ERROR);
   }
   (0, import_config.saveAuth)(provider, apiKey.trim());
-  (0, import_core9.success)(`API key saved for ${provider}`);
+  (0, import_core10.success)(`API key saved for ${provider}`);
 });
 program.command("providers").description("List available LLM providers").action(() => {
-  (0, import_core9.info)("Available LLM providers:");
+  (0, import_core10.info)("Available LLM providers:");
   console.log("  openai          - OpenAI (GPT models)");
   console.log("  anthropic       - Anthropic (Claude models)");
   console.log("  ollama          - Ollama (local models)");
@@ -1598,7 +1729,7 @@ function increaseVerbosity(_, previous) {
 }
 function setVerbosity(level) {
   const levels = ["info", "debug", "trace"];
-  (0, import_core9.setLogLevel)(levels[Math.min(level, levels.length - 1)] ?? "info");
+  (0, import_core10.setLogLevel)(levels[Math.min(level, levels.length - 1)] ?? "info");
 }
 async function readStdin() {
   const chunks = [];
@@ -1621,7 +1752,7 @@ function handleError(err) {
     err.logError();
     process.exit(getExitCode(err));
   }
-  (0, import_core9.error)(err instanceof Error ? err.message : String(err));
+  (0, import_core10.error)(err instanceof Error ? err.message : String(err));
   process.exit(import_core2.EXIT_CODES.GENERAL_ERROR);
 }
 program.parse();