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

package/dist/{chunk-ACXCEHQT.js → chunk-HARXYT65.js}

@@ -534,15 +534,18 @@ For the "Developer" category, you MUST assign a scope from this exact list: ${sc
       }
     }
   }
+  const scopeValidationInstructions = scopeInstructions ? `
+
+IMPORTANT: When assigning scopes, you MUST ONLY use scopes from the predefined list above. DO NOT use scopes from conventional commit messages (like "version", "core", "api", etc.). If an entry does not fit any of the predefined scopes, leave the scope as null.` : "";
   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 in this exact order:
 
 Categories:
-${categoryList}${scopeInstructions}
+${categoryList}${scopeInstructions}${scopeValidationInstructions}
 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,7 +556,8 @@ 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 prompt = promptTemplate.replace("{{entries}}", entriesText);
@@ -567,13 +571,13 @@ 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() };
         }
       }
       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 });
         }
@@ -582,7 +586,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,7 +597,7 @@ 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 }];
   }
 }
 
@@ -727,7 +731,7 @@ async function enhanceAndCategorize(provider, entries, context) {
         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) {
@@ -1214,15 +1218,17 @@ function renderTemplate(templatePath, context, engine) {
 }
 
 // src/core/pipeline.ts
-function extractVersionFromTag(tag) {
-  if (tag.includes("@") && !tag.startsWith("@")) {
-    return tag;
+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/, "");
   }
-  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/${fromVersion}...${toVersion}`;
   }
@@ -1232,7 +1238,7 @@ function generateCompareUrl(repoUrl, 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,

package/dist/cli.cjs

@@ -380,15 +380,18 @@ For the "Developer" category, you MUST assign a scope from this exact list: ${sc
       }
     }
   }
+  const scopeValidationInstructions = scopeInstructions ? `
+
+IMPORTANT: When assigning scopes, you MUST ONLY use scopes from the predefined list above. DO NOT use scopes from conventional commit messages (like "version", "core", "api", etc.). If an entry does not fit any of the predefined scopes, leave the scope as null.` : "";
   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 in this exact order:
 
 Categories:
-${categoryList}${scopeInstructions}
+${categoryList}${scopeInstructions}${scopeValidationInstructions}
 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}}
@@ -399,7 +402,8 @@ 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 prompt = promptTemplate.replace("{{entries}}", entriesText);
@@ -413,13 +417,13 @@ 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() };
         }
       }
       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 });
         }
@@ -428,7 +432,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 });
         }
@@ -439,7 +443,7 @@ async function categorizeEntries(provider, entries, context) {
     (0, import_core3.warn)(
       `LLM categorization failed, falling back to General: ${error2 instanceof Error ? error2.message : String(error2)}`
     );
-    return [{ category: "General", entries }];
+    return [{ category: "General", entries: entriesCopy }];
   }
 }
 
@@ -573,7 +577,7 @@ async function enhanceAndCategorize(provider, entries, context) {
         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) {
@@ -1226,15 +1230,17 @@ function renderTemplate(templatePath, context, engine) {
 
 // src/core/pipeline.ts
 var import_meta = {};
-function extractVersionFromTag(tag) {
-  if (tag.includes("@") && !tag.startsWith("@")) {
-    return tag;
+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/, "");
   }
-  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/${fromVersion}...${toVersion}`;
   }
@@ -1244,7 +1250,7 @@ function generateCompareUrl(repoUrl, 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,

package/dist/cli.js

@@ -11,7 +11,7 @@ import {
   runPipeline,
   saveAuth,
   writeMonorepoChangelogs
-} from "./chunk-ACXCEHQT.js";
+} from "./chunk-HARXYT65.js";
 
 // src/cli.ts
 import * as fs from "fs";

package/dist/index.cjs

@@ -430,15 +430,18 @@ For the "Developer" category, you MUST assign a scope from this exact list: ${sc
       }
     }
   }
+  const scopeValidationInstructions = scopeInstructions ? `
+
+IMPORTANT: When assigning scopes, you MUST ONLY use scopes from the predefined list above. DO NOT use scopes from conventional commit messages (like "version", "core", "api", etc.). If an entry does not fit any of the predefined scopes, leave the scope as null.` : "";
   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 in this exact order:
 
 Categories:
-${categoryList}${scopeInstructions}
+${categoryList}${scopeInstructions}${scopeValidationInstructions}
 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}}
@@ -449,7 +452,8 @@ 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 prompt = promptTemplate.replace("{{entries}}", entriesText);
@@ -463,13 +467,13 @@ 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() };
         }
       }
       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 });
         }
@@ -478,7 +482,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 });
         }
@@ -489,7 +493,7 @@ async function categorizeEntries(provider, entries, context) {
     (0, import_core3.warn)(
       `LLM categorization failed, falling back to General: ${error instanceof Error ? error.message : String(error)}`
     );
-    return [{ category: "General", entries }];
+    return [{ category: "General", entries: entriesCopy }];
   }
 }
 
@@ -623,7 +627,7 @@ async function enhanceAndCategorize(provider, entries, context) {
         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) {
@@ -1276,15 +1280,17 @@ function renderTemplate(templatePath, context, engine) {
 
 // src/core/pipeline.ts
 var import_meta = {};
-function extractVersionFromTag(tag) {
-  if (tag.includes("@") && !tag.startsWith("@")) {
-    return tag;
+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/, "");
   }
-  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/${fromVersion}...${toVersion}`;
   }
@@ -1294,7 +1300,7 @@ function generateCompareUrl(repoUrl, 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,

package/dist/index.js

@@ -24,7 +24,7 @@ import {
   writeJson,
   writeMarkdown,
   writeMonorepoChangelogs
-} from "./chunk-ACXCEHQT.js";
+} from "./chunk-HARXYT65.js";
 export {
   NotesError as ChangelogCreatorError,
   ConfigError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@releasekit/notes",
-  "version": "0.2.0-next.10",
+  "version": "0.2.0-next.12",
   "description": "Changelog generation with LLM-powered enhancement and flexible templating",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -44,16 +44,16 @@
     "access": "public"
   },
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.39.0",
-    "@octokit/rest": "^21.1.1",
+    "@anthropic-ai/sdk": "^0.78.0",
+    "@octokit/rest": "^22.0.1",
     "@releasekit/config": "workspace:*",
     "@releasekit/core": "workspace:*",
     "chalk": "catalog:",
     "commander": "catalog:",
-    "ejs": "^3.1.10",
+    "ejs": "^4.0.1",
     "handlebars": "^4.7.8",
     "liquidjs": "^10.21.0",
-    "openai": "^4.87.0",
+    "openai": "^6.27.0",
     "zod": "catalog:"
   },
   "devDependencies": {