@releasekit/notes 0.2.0-next.9 → 0.2.1

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

@@ -1,12 +1,376 @@
-// src/core/config.ts
 import {
-  loadAuth,
-  loadNotesConfig as loadSharedNotesConfig,
-  saveAuth
-} from "@releasekit/config";
-function loadConfig(projectDir = process.cwd(), configFile) {
+  EXIT_CODES,
+  ReleaseKitError,
+  debug,
+  formatVersion,
+  info,
+  renderMarkdown,
+  success,
+  warn,
+  writeMarkdown
+} from "./chunk-SAUES3BF.js";
+
+// ../config/dist/index.js
+import * as fs from "fs";
+import * as path from "path";
+import * as TOML from "smol-toml";
+import * as fs3 from "fs";
+import * as path3 from "path";
+import { z as z2 } from "zod";
+import { z } from "zod";
+import * as fs2 from "fs";
+import * as os from "os";
+import * as path2 from "path";
+var ConfigError = class extends ReleaseKitError {
+  code = "CONFIG_ERROR";
+  suggestions;
+  constructor(message, suggestions) {
+    super(message);
+    this.suggestions = suggestions ?? [
+      "Check that releasekit.config.json exists and is valid JSON",
+      "Run with --verbose for more details"
+    ];
+  }
+};
+var MAX_JSONC_LENGTH = 1e5;
+function parseJsonc(content) {
+  if (content.length > MAX_JSONC_LENGTH) {
+    throw new Error(`JSONC content too long: ${content.length} characters (max ${MAX_JSONC_LENGTH})`);
+  }
+  try {
+    return JSON.parse(content);
+  } catch {
+    const cleaned = content.replace(/\/\/[^\r\n]{0,10000}$/gm, "").replace(/\/\*[\s\S]{0,50000}?\*\//g, "").trim();
+    return JSON.parse(cleaned);
+  }
+}
+var GitConfigSchema = z.object({
+  remote: z.string().default("origin"),
+  branch: z.string().default("main"),
+  pushMethod: z.enum(["auto", "ssh", "https"]).default("auto"),
+  /**
+   * Optional env var name containing a GitHub token for HTTPS pushes.
+   * When set, publish steps can use this token without mutating git remotes.
+   */
+  httpsTokenEnv: z.string().optional(),
+  push: z.boolean().optional(),
+  skipHooks: z.boolean().optional()
+});
+var MonorepoConfigSchema = z.object({
+  mode: z.enum(["root", "packages", "both"]).optional(),
+  rootPath: z.string().optional(),
+  packagesPath: z.string().optional(),
+  mainPackage: z.string().optional()
+});
+var BranchPatternSchema = z.object({
+  pattern: z.string(),
+  releaseType: z.enum(["major", "minor", "patch", "prerelease"])
+});
+var VersionCargoConfigSchema = z.object({
+  enabled: z.boolean().default(true),
+  paths: z.array(z.string()).optional()
+});
+var VersionConfigSchema = z.object({
+  tagTemplate: z.string().default("v{version}"),
+  packageSpecificTags: z.boolean().default(false),
+  preset: z.string().default("conventional"),
+  sync: z.boolean().default(true),
+  packages: z.array(z.string()).default([]),
+  mainPackage: z.string().optional(),
+  updateInternalDependencies: z.enum(["major", "minor", "patch", "no-internal-update"]).default("minor"),
+  skip: z.array(z.string()).optional(),
+  commitMessage: z.string().optional(),
+  versionStrategy: z.enum(["branchPattern", "commitMessage"]).default("commitMessage"),
+  branchPatterns: z.array(BranchPatternSchema).optional(),
+  defaultReleaseType: z.enum(["major", "minor", "patch", "prerelease"]).optional(),
+  mismatchStrategy: z.enum(["error", "warn", "ignore", "prefer-package", "prefer-git"]).default("warn"),
+  versionPrefix: z.string().default(""),
+  prereleaseIdentifier: z.string().optional(),
+  strictReachable: z.boolean().default(false),
+  cargo: VersionCargoConfigSchema.optional()
+});
+var NpmConfigSchema = z.object({
+  enabled: z.boolean().default(true),
+  auth: z.enum(["auto", "oidc", "token"]).default("auto"),
+  provenance: z.boolean().default(true),
+  access: z.enum(["public", "restricted"]).default("public"),
+  registry: z.string().default("https://registry.npmjs.org"),
+  copyFiles: z.array(z.string()).default(["LICENSE"]),
+  tag: z.string().default("latest")
+});
+var CargoPublishConfigSchema = z.object({
+  enabled: z.boolean().default(false),
+  noVerify: z.boolean().default(false),
+  publishOrder: z.array(z.string()).default([]),
+  clean: z.boolean().default(false)
+});
+var PublishGitConfigSchema = z.object({
+  push: z.boolean().default(true),
+  pushMethod: z.enum(["auto", "ssh", "https"]).optional(),
+  remote: z.string().optional(),
+  branch: z.string().optional(),
+  httpsTokenEnv: z.string().optional(),
+  skipHooks: z.boolean().optional()
+});
+var GitHubReleaseConfigSchema = z.object({
+  enabled: z.boolean().default(true),
+  draft: z.boolean().default(true),
+  perPackage: z.boolean().default(true),
+  prerelease: z.union([z.literal("auto"), z.boolean()]).default("auto"),
+  /**
+   * Controls how release notes are sourced for GitHub releases.
+   * - 'auto': Use RELEASE_NOTES.md if it exists, then per-package changelog
+   *   data from the version output, then GitHub's auto-generated notes.
+   * - 'github': Always use GitHub's auto-generated notes.
+   * - 'none': No notes body.
+   * - Any other string: Treated as a file path to read notes from.
+   */
+  releaseNotes: z.union([z.literal("auto"), z.literal("github"), z.literal("none"), z.string()]).default("auto")
+});
+var VerifyRegistryConfigSchema = z.object({
+  enabled: z.boolean().default(true),
+  maxAttempts: z.number().int().positive().default(5),
+  initialDelay: z.number().int().positive().default(15e3),
+  backoffMultiplier: z.number().positive().default(2)
+});
+var VerifyConfigSchema = z.object({
+  npm: VerifyRegistryConfigSchema.default({
+    enabled: true,
+    maxAttempts: 5,
+    initialDelay: 15e3,
+    backoffMultiplier: 2
+  }),
+  cargo: VerifyRegistryConfigSchema.default({
+    enabled: true,
+    maxAttempts: 10,
+    initialDelay: 3e4,
+    backoffMultiplier: 2
+  })
+});
+var PublishConfigSchema = z.object({
+  git: PublishGitConfigSchema.optional(),
+  npm: NpmConfigSchema.default({
+    enabled: true,
+    auth: "auto",
+    provenance: true,
+    access: "public",
+    registry: "https://registry.npmjs.org",
+    copyFiles: ["LICENSE"],
+    tag: "latest"
+  }),
+  cargo: CargoPublishConfigSchema.default({
+    enabled: false,
+    noVerify: false,
+    publishOrder: [],
+    clean: false
+  }),
+  githubRelease: GitHubReleaseConfigSchema.default({
+    enabled: true,
+    draft: true,
+    perPackage: true,
+    prerelease: "auto",
+    releaseNotes: "auto"
+  }),
+  verify: VerifyConfigSchema.default({
+    npm: {
+      enabled: true,
+      maxAttempts: 5,
+      initialDelay: 15e3,
+      backoffMultiplier: 2
+    },
+    cargo: {
+      enabled: true,
+      maxAttempts: 10,
+      initialDelay: 3e4,
+      backoffMultiplier: 2
+    }
+  })
+});
+var TemplateConfigSchema = z.object({
+  path: z.string().optional(),
+  engine: z.enum(["handlebars", "liquid", "ejs"]).optional()
+});
+var OutputConfigSchema = z.object({
+  format: z.enum(["markdown", "github-release", "json"]),
+  file: z.string().optional(),
+  options: z.record(z.string(), z.unknown()).optional(),
+  templates: TemplateConfigSchema.optional()
+});
+var LLMOptionsSchema = z.object({
+  timeout: z.number().optional(),
+  maxTokens: z.number().optional(),
+  temperature: z.number().optional()
+});
+var LLMRetryConfigSchema = z.object({
+  maxAttempts: z.number().int().positive().optional(),
+  initialDelay: z.number().nonnegative().optional(),
+  maxDelay: z.number().positive().optional(),
+  backoffFactor: z.number().positive().optional()
+});
+var LLMTasksConfigSchema = z.object({
+  summarize: z.boolean().optional(),
+  enhance: z.boolean().optional(),
+  categorize: z.boolean().optional(),
+  releaseNotes: z.boolean().optional()
+});
+var LLMCategorySchema = z.object({
+  name: z.string(),
+  description: z.string(),
+  scopes: z.array(z.string()).optional()
+});
+var ScopeRulesSchema = z.object({
+  allowed: z.array(z.string()).optional(),
+  caseSensitive: z.boolean().default(false),
+  invalidScopeAction: z.enum(["remove", "keep", "fallback"]).default("remove"),
+  fallbackScope: z.string().optional()
+});
+var ScopeConfigSchema = z.object({
+  mode: z.enum(["restricted", "packages", "none", "unrestricted"]).default("unrestricted"),
+  rules: ScopeRulesSchema.optional()
+});
+var LLMPromptOverridesSchema = z.object({
+  enhance: z.string().optional(),
+  categorize: z.string().optional(),
+  enhanceAndCategorize: z.string().optional(),
+  summarize: z.string().optional(),
+  releaseNotes: z.string().optional()
+});
+var LLMPromptsConfigSchema = z.object({
+  instructions: LLMPromptOverridesSchema.optional(),
+  templates: LLMPromptOverridesSchema.optional()
+});
+var LLMConfigSchema = z.object({
+  provider: z.string(),
+  model: z.string(),
+  baseURL: z.string().optional(),
+  apiKey: z.string().optional(),
+  options: LLMOptionsSchema.optional(),
+  concurrency: z.number().int().positive().optional(),
+  retry: LLMRetryConfigSchema.optional(),
+  tasks: LLMTasksConfigSchema.optional(),
+  categories: z.array(LLMCategorySchema).optional(),
+  style: z.string().optional(),
+  scopes: ScopeConfigSchema.optional(),
+  prompts: LLMPromptsConfigSchema.optional()
+});
+var NotesInputConfigSchema = z.object({
+  source: z.string().optional(),
+  file: z.string().optional()
+});
+var NotesConfigSchema = z.object({
+  input: NotesInputConfigSchema.optional(),
+  output: z.array(OutputConfigSchema).default([{ format: "markdown", file: "CHANGELOG.md" }]),
+  monorepo: MonorepoConfigSchema.optional(),
+  templates: TemplateConfigSchema.optional(),
+  llm: LLMConfigSchema.optional(),
+  updateStrategy: z.enum(["prepend", "regenerate"]).default("prepend")
+});
+var ReleaseKitConfigSchema = z.object({
+  git: GitConfigSchema.optional(),
+  monorepo: MonorepoConfigSchema.optional(),
+  version: VersionConfigSchema.optional(),
+  publish: PublishConfigSchema.optional(),
+  notes: NotesConfigSchema.optional()
+});
+var MAX_INPUT_LENGTH = 1e4;
+function substituteVariables(value) {
+  if (value.length > MAX_INPUT_LENGTH) {
+    throw new Error(`Input too long: ${value.length} characters (max ${MAX_INPUT_LENGTH})`);
+  }
+  const envPattern = /\{env:([^}]{1,1000})\}/g;
+  const filePattern = /\{file:([^}]{1,1000})\}/g;
+  let result = value;
+  result = result.replace(envPattern, (_, varName) => {
+    return process.env[varName] ?? "";
+  });
+  result = result.replace(filePattern, (_, filePath) => {
+    const expandedPath = filePath.startsWith("~") ? path2.join(os.homedir(), filePath.slice(1)) : filePath;
+    try {
+      return fs2.readFileSync(expandedPath, "utf-8").trim();
+    } catch {
+      return "";
+    }
+  });
+  return result;
+}
+var SOLE_REFERENCE_PATTERN = /^\{(?:env|file):[^}]+\}$/;
+function substituteInObject(obj) {
+  if (typeof obj === "string") {
+    const result = substituteVariables(obj);
+    if (result === "" && SOLE_REFERENCE_PATTERN.test(obj)) {
+      return void 0;
+    }
+    return result;
+  }
+  if (Array.isArray(obj)) {
+    return obj.map((item) => substituteInObject(item));
+  }
+  if (obj && typeof obj === "object") {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+      result[key] = substituteInObject(value);
+    }
+    return result;
+  }
+  return obj;
+}
+var AUTH_DIR = path2.join(os.homedir(), ".config", "releasekit");
+var AUTH_FILE = path2.join(AUTH_DIR, "auth.json");
+function loadAuth() {
+  if (fs2.existsSync(AUTH_FILE)) {
+    try {
+      const content = fs2.readFileSync(AUTH_FILE, "utf-8");
+      return JSON.parse(content);
+    } catch {
+      return {};
+    }
+  }
+  return {};
+}
+function saveAuth(provider, apiKey) {
+  if (!fs2.existsSync(AUTH_DIR)) {
+    fs2.mkdirSync(AUTH_DIR, { recursive: true });
+  }
+  const existing = loadAuth();
+  existing[provider] = apiKey;
+  fs2.writeFileSync(AUTH_FILE, JSON.stringify(existing, null, 2), { encoding: "utf-8", mode: 384 });
+}
+var CONFIG_FILE = "releasekit.config.json";
+function loadConfigFile(configPath) {
+  if (!fs3.existsSync(configPath)) {
+    return {};
+  }
+  try {
+    const content = fs3.readFileSync(configPath, "utf-8");
+    const parsed = parseJsonc(content);
+    const substituted = substituteInObject(parsed);
+    return ReleaseKitConfigSchema.parse(substituted);
+  } catch (error) {
+    if (error instanceof z2.ZodError) {
+      const issues = error.issues.map((i) => `  ${i.path.join(".")}: ${i.message}`).join("\n");
+      throw new ConfigError(`Config validation errors:
+${issues}`);
+    }
+    if (error instanceof SyntaxError) {
+      throw new ConfigError(`Invalid JSON in config file: ${error.message}`);
+    }
+    throw error;
+  }
+}
+function loadConfig(options) {
+  const cwd = options?.cwd ?? process.cwd();
+  const configPath = options?.configPath ?? path3.join(cwd, CONFIG_FILE);
+  return loadConfigFile(configPath);
+}
+function loadNotesConfig(options) {
+  const config = loadConfig(options);
+  return config.notes;
+}
+
+// src/core/config.ts
+function loadConfig2(projectDir = process.cwd(), configFile) {
   const options = { cwd: projectDir, configPath: configFile };
-  return loadSharedNotesConfig(options) ?? getDefaultConfig();
+  return loadNotesConfig(options) ?? getDefaultConfig();
 }
 function getDefaultConfig() {
   return {
@@ -16,8 +380,6 @@ function getDefaultConfig() {
 }
 
 // src/errors/index.ts
-import { EXIT_CODES, ReleaseKitError } from "@releasekit/core";
-import { EXIT_CODES as EXIT_CODES2 } from "@releasekit/core";
 var NotesError = class extends ReleaseKitError {
 };
 var InputParseError = class extends NotesError {
@@ -53,7 +415,7 @@ var GitHubError = class extends NotesError {
     "Verify repository exists and is accessible"
   ];
 };
-var ConfigError = class extends NotesError {
+var ConfigError2 = class extends NotesError {
   code = "CONFIG_ERROR";
   suggestions = [
     "Check config file syntax",
@@ -79,7 +441,7 @@ function getExitCode(error) {
 }
 
 // src/input/package-versioner.ts
-import * as fs from "fs";
+import * as fs4 from "fs";
 function normalizeEntryType(type) {
   const typeMap = {
     added: "added",
@@ -133,7 +495,7 @@ function parsePackageVersioner(json) {
   };
 }
 function parsePackageVersionerFile(filePath) {
-  const content = fs.readFileSync(filePath, "utf-8");
+  const content = fs4.readFileSync(filePath, "utf-8");
   return parsePackageVersioner(content);
 }
 async function parsePackageVersionerStdin() {
@@ -145,137 +507,9 @@ async function parsePackageVersionerStdin() {
   return parsePackageVersioner(content);
 }
 
-// src/output/markdown.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 * as fs5 from "fs";
+import * as path4 from "path";
 function renderJson(contexts) {
   return JSON.stringify(
     {
@@ -295,28 +529,28 @@ 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 = path4.dirname(outputPath);
+  if (!fs5.existsSync(dir)) {
+    fs5.mkdirSync(dir, { recursive: true });
   }
-  fs3.writeFileSync(outputPath, content, "utf-8");
-  success2(`JSON output written to ${outputPath}`);
+  fs5.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 fs10 from "fs";
+import * as path8 from "path";
 
 // src/llm/defaults.ts
 var LLM_DEFAULTS = {
   timeout: 6e4,
-  maxTokens: 2e3,
+  maxTokens: 4e3,
   temperature: 0.7,
   concurrency: 5,
   retry: {
@@ -409,7 +643,7 @@ var OllamaProvider = class extends BaseLLMProvider {
         "Content-Type": "application/json"
       };
       if (this.apiKey) {
-        headers["Authorization"] = `Bearer ${this.apiKey}`;
+        headers.Authorization = `Bearer ${this.apiKey}`;
       }
       const baseUrl = this.baseURL.endsWith("/api") ? this.baseURL.slice(0, -4) : this.baseURL;
       const response = await fetch(`${baseUrl}/api/chat`, {
@@ -506,8 +740,91 @@ var OpenAICompatibleProvider = class extends BaseLLMProvider {
   }
 };
 
+// src/utils/json.ts
+function extractJsonFromResponse(response) {
+  const stripped = response.replace(/^```(?:json)?\n?/, "").replace(/\n?```$/, "").trim();
+  const objectMatch = stripped.match(/\{[\s\S]*\}/);
+  if (objectMatch) return objectMatch[0];
+  const arrayMatch = stripped.match(/\[[\s\S]*\]/);
+  if (arrayMatch) return arrayMatch[0];
+  return stripped;
+}
+
+// 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;
+    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
-import { warn } from "@releasekit/core";
 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 +836,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 +858,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,27 +872,29 @@ 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);
-    const cleaned = response.replace(/^```(?:json)?\n?/, "").replace(/\n?```$/, "").trim();
-    const parsed = JSON.parse(cleaned);
+    const parsed = JSON.parse(extractJsonFromResponse(response));
     const result = [];
     if (hasCustomCategories && parsed.categories) {
       const categoryMap = parsed.categories;
       const scopeMap = parsed.scopes || {};
       for (const [indexStr, scope] of Object.entries(scopeMap)) {
         const idx = Number.parseInt(indexStr, 10);
-        if (entries[idx] && scope) {
-          entries[idx] = { ...entries[idx], scope };
+        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 +903,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 +914,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 +935,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();
 }
@@ -639,9 +961,6 @@ async function enhanceEntries(provider, entries, context, concurrency = LLM_DEFA
   return results;
 }
 
-// src/llm/tasks/enhance-and-categorize.ts
-import { warn as warn2 } from "@releasekit/core";
-
 // src/utils/retry.ts
 function sleep(ms) {
   return new Promise((resolve2) => setTimeout(resolve2, ms));
@@ -672,7 +991,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 +1018,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,10 +1035,10 @@ 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);
+      const parsed = JSON.parse(extractJsonFromResponse(response));
       if (!Array.isArray(parsed.entries)) {
         throw new Error('Response missing "entries" array');
       }
@@ -718,25 +1051,26 @@ 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(
+    warn(
       `Combined enhance+categorize failed after ${retryOpts.maxAttempts} attempts: ${error instanceof Error ? error.message : String(error)}`
     );
     return {
@@ -747,7 +1081,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 +1114,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 +1132,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 +1182,6 @@ function createProvider(config) {
 
 // src/output/github-release.ts
 import { Octokit } from "@octokit/rest";
-import { info as info3, success as success3 } from "@releasekit/core";
 var GitHubClient = class {
   octokit;
   owner;
@@ -868,7 +1203,7 @@ var GitHubClient = class {
     } else {
       body = renderMarkdown([context]);
     }
-    info3(`Creating GitHub release for ${tagName}`);
+    info(`Creating GitHub release for ${tagName}`);
     try {
       const response = await this.octokit.repos.createRelease({
         owner: this.owner,
@@ -880,7 +1215,7 @@ var GitHubClient = class {
         prerelease: options.prerelease ?? false,
         generate_release_notes: options.generateNotes ?? false
       });
-      success3(`Release created: ${response.data.html_url}`);
+      success(`Release created: ${response.data.html_url}`);
       return {
         id: response.data.id,
         htmlUrl: response.data.html_url,
@@ -898,7 +1233,7 @@ var GitHubClient = class {
     } else {
       body = renderMarkdown([context]);
     }
-    info3(`Updating GitHub release ${releaseId}`);
+    info(`Updating GitHub release ${releaseId}`);
     try {
       const response = await this.octokit.repos.updateRelease({
         owner: this.owner,
@@ -910,7 +1245,7 @@ var GitHubClient = class {
         draft: options.draft ?? false,
         prerelease: options.prerelease ?? false
       });
-      success3(`Release updated: ${response.data.html_url}`);
+      success(`Release updated: ${response.data.html_url}`);
       return {
         id: response.data.id,
         htmlUrl: response.data.html_url,
@@ -960,7 +1295,7 @@ async function createGitHubRelease(context, options) {
 }
 
 // src/templates/ejs.ts
-import * as fs4 from "fs";
+import * as fs6 from "fs";
 import ejs from "ejs";
 function renderEjs(template, context) {
   try {
@@ -970,16 +1305,16 @@ function renderEjs(template, context) {
   }
 }
 function renderEjsFile(filePath, context) {
-  if (!fs4.existsSync(filePath)) {
+  if (!fs6.existsSync(filePath)) {
     throw new TemplateError(`Template file not found: ${filePath}`);
   }
-  const template = fs4.readFileSync(filePath, "utf-8");
+  const template = fs6.readFileSync(filePath, "utf-8");
   return renderEjs(template, context);
 }
 
 // src/templates/handlebars.ts
-import * as fs5 from "fs";
-import * as path3 from "path";
+import * as fs7 from "fs";
+import * as path5 from "path";
 import Handlebars from "handlebars";
 function registerHandlebarsHelpers() {
   Handlebars.registerHelper("capitalize", (str) => {
@@ -1005,28 +1340,28 @@ function renderHandlebars(template, context) {
   }
 }
 function renderHandlebarsFile(filePath, context) {
-  if (!fs5.existsSync(filePath)) {
+  if (!fs7.existsSync(filePath)) {
     throw new TemplateError(`Template file not found: ${filePath}`);
   }
-  const template = fs5.readFileSync(filePath, "utf-8");
+  const template = fs7.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 = path5.join(templateDir, "version.hbs");
+  const entryPath = path5.join(templateDir, "entry.hbs");
+  const documentPath = path5.join(templateDir, "document.hbs");
+  if (!fs7.existsSync(documentPath)) {
     throw new TemplateError(`Document template not found: ${documentPath}`);
   }
-  if (fs5.existsSync(versionPath)) {
-    Handlebars.registerPartial("version", fs5.readFileSync(versionPath, "utf-8"));
+  if (fs7.existsSync(versionPath)) {
+    Handlebars.registerPartial("version", fs7.readFileSync(versionPath, "utf-8"));
   }
-  if (fs5.existsSync(entryPath)) {
-    Handlebars.registerPartial("entry", fs5.readFileSync(entryPath, "utf-8"));
+  if (fs7.existsSync(entryPath)) {
+    Handlebars.registerPartial("entry", fs7.readFileSync(entryPath, "utf-8"));
   }
   try {
-    const compiled = Handlebars.compile(fs5.readFileSync(documentPath, "utf-8"));
+    const compiled = Handlebars.compile(fs7.readFileSync(documentPath, "utf-8"));
     return compiled(context);
   } catch (error) {
     throw new TemplateError(`Handlebars render error: ${error instanceof Error ? error.message : String(error)}`);
@@ -1034,8 +1369,8 @@ function renderHandlebarsComposable(templateDir, context) {
 }
 
 // src/templates/liquid.ts
-import * as fs6 from "fs";
-import * as path4 from "path";
+import * as fs8 from "fs";
+import * as path6 from "path";
 import { Liquid } from "liquidjs";
 function createLiquidEngine(root) {
   return new Liquid({
@@ -1053,15 +1388,15 @@ function renderLiquid(template, context) {
   }
 }
 function renderLiquidFile(filePath, context) {
-  if (!fs6.existsSync(filePath)) {
+  if (!fs8.existsSync(filePath)) {
     throw new TemplateError(`Template file not found: ${filePath}`);
   }
-  const template = fs6.readFileSync(filePath, "utf-8");
+  const template = fs8.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 = path6.join(templateDir, "document.liquid");
+  if (!fs8.existsSync(documentPath)) {
     throw new TemplateError(`Document template not found: ${documentPath}`);
   }
   const engine = createLiquidEngine(templateDir);
@@ -1073,10 +1408,10 @@ function renderLiquidComposable(templateDir, context) {
 }
 
 // src/templates/loader.ts
-import * as fs7 from "fs";
-import * as path5 from "path";
+import * as fs9 from "fs";
+import * as path7 from "path";
 function getEngineFromFile(filePath) {
-  const ext = path5.extname(filePath).toLowerCase();
+  const ext = path7.extname(filePath).toLowerCase();
   switch (ext) {
     case ".liquid":
       return "liquid";
@@ -1110,10 +1445,10 @@ function getRenderFileFn(engine) {
   }
 }
 function detectTemplateMode(templatePath) {
-  if (!fs7.existsSync(templatePath)) {
+  if (!fs9.existsSync(templatePath)) {
     throw new TemplateError(`Template path not found: ${templatePath}`);
   }
-  const stat = fs7.statSync(templatePath);
+  const stat = fs9.statSync(templatePath);
   if (stat.isFile()) {
     return "single";
   }
@@ -1131,7 +1466,7 @@ function renderSingleFile(templatePath, context, engine) {
   };
 }
 function renderComposable(templateDir, context, engine) {
-  const files = fs7.readdirSync(templateDir);
+  const files = fs9.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 +1489,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 = path7.join(templateDir, expectedFiles.document);
+  if (!fs9.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 = path7.join(templateDir, expectedFiles.version);
+  const entryPath = path7.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 = fs9.existsSync(entryPath) ? fs9.readFileSync(entryPath, "utf-8") : null;
+  const versionTemplate = fs9.existsSync(versionPath) ? fs9.readFileSync(versionPath, "utf-8") : null;
   if (entryTemplate && versionTemplate) {
     const versionsWithEntries = context.versions.map((versionCtx) => {
       const entries = versionCtx.entries.map((entry) => {
@@ -1173,7 +1508,7 @@ function renderComposable(templateDir, context, engine) {
     });
     const docContext = { ...context, renderedVersions: versionsWithEntries };
     return {
-      content: render(fs7.readFileSync(documentPath, "utf-8"), docContext),
+      content: render(fs9.readFileSync(documentPath, "utf-8"), docContext),
       engine: resolvedEngine
     };
   }
@@ -1214,17 +1549,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,76 +1607,80 @@ 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})` : ""}`);
+    info(`Using LLM provider: ${config.llm.provider}${config.llm.model ? ` (${config.llm.model})` : ""}`);
     if (config.llm.baseURL) {
-      info4(`LLM base URL: ${config.llm.baseURL}`);
+      info(`LLM base URL: ${config.llm.baseURL}`);
     }
     const rawProvider = createProvider(config.llm);
     const retryOpts = config.llm.retry ?? LLM_DEFAULTS.retry;
+    const configOptions = config.llm.options;
     const provider = {
       name: rawProvider.name,
-      complete: (prompt, opts) => withRetry(() => rawProvider.complete(prompt, opts), retryOpts)
+      // Merge user-configured options (timeout, maxTokens, temperature) as base defaults,
+      // allowing any per-call overrides to take precedence.
+      complete: (prompt, opts) => withRetry(() => rawProvider.complete(prompt, { ...configOptions, ...opts }), retryOpts)
     };
     const activeTasks = Object.entries(tasks).filter(([, enabled]) => enabled).map(([name]) => name);
-    info4(`Running LLM tasks: ${activeTasks.join(", ")}`);
+    info(`Running LLM tasks: ${activeTasks.join(", ")}`);
     if (tasks.enhance && tasks.categorize) {
-      info4("Enhancing and categorizing entries with LLM...");
+      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;
       }
-      info4(`Enhanced ${enhanced.entries.length} entries into ${result.categories.length} categories`);
+      info(`Enhanced ${enhanced.entries.length} entries into ${result.categories.length} categories`);
     } else {
       if (tasks.enhance) {
-        info4("Enhancing entries with LLM...");
+        info("Enhancing entries with LLM...");
         enhanced.entries = await enhanceEntries(provider, context.entries, llmContext, config.llm.concurrency);
-        info4(`Enhanced ${enhanced.entries.length} entries`);
+        info(`Enhanced ${enhanced.entries.length} entries`);
       }
       if (tasks.categorize) {
-        info4("Categorizing entries with LLM...");
+        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;
         }
-        info4(`Created ${categorized.length} categories`);
+        info(`Created ${categorized.length} categories`);
       }
     }
     if (tasks.summarize) {
-      info4("Summarizing entries with LLM...");
+      info("Summarizing entries with LLM...");
       enhanced.summary = await summarizeEntries(provider, enhanced.entries, llmContext);
       if (enhanced.summary) {
-        info4("Summary generated successfully");
+        info("Summary generated successfully");
         debug(`Summary: ${enhanced.summary.substring(0, 100)}...`);
       } else {
-        warn3("Summary generation returned empty result");
+        warn("Summary generation returned empty result");
       }
     }
     if (tasks.releaseNotes) {
-      info4("Generating release notes with LLM...");
+      info("Generating release notes with LLM...");
       enhanced.releaseNotes = await generateReleaseNotes(provider, enhanced.entries, llmContext);
       if (enhanced.releaseNotes) {
-        info4("Release notes generated successfully");
+        info("Release notes generated successfully");
       } else {
-        warn3("Release notes generation returned empty result");
+        warn("Release notes generation returned empty result");
       }
     }
     return {
       ...context,
-      entries: enhanced.entries,
       enhanced
     };
   } catch (error) {
-    warn3(`LLM processing failed: ${error instanceof Error ? error.message : String(error)}`);
-    warn3("Falling back to raw entries");
+    warn(`LLM processing failed: ${error instanceof Error ? error.message : String(error)}`);
+    warn("Falling back to raw entries");
     return context;
   }
 }
@@ -1339,17 +1688,17 @@ function getBuiltinTemplatePath(style) {
   let packageRoot;
   try {
     const currentUrl = import.meta.url;
-    packageRoot = path6.dirname(new URL(currentUrl).pathname);
-    packageRoot = path6.join(packageRoot, "..", "..");
+    packageRoot = path8.dirname(new URL(currentUrl).pathname);
+    packageRoot = path8.join(packageRoot, "..", "..");
   } catch {
     packageRoot = __dirname;
   }
-  return path6.join(packageRoot, "templates", style);
+  return path8.join(packageRoot, "templates", style);
 }
 async function generateWithTemplate(contexts, config, outputPath, dryRun) {
   let templatePath;
   if (config.templates?.path) {
-    templatePath = path6.resolve(config.templates.path);
+    templatePath = path8.resolve(config.templates.path);
   } else {
     templatePath = getBuiltinTemplatePath("keep-a-changelog");
   }
@@ -1359,64 +1708,85 @@ 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 ---");
+    info(`Would write templated output to ${outputPath}`);
+    debug("--- Changelog Preview ---");
+    debug(result.content);
+    debug("--- 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 = path8.dirname(outputPath);
+  if (!fs10.existsSync(dir)) {
+    fs10.mkdirSync(dir, { recursive: true });
   }
-  fs8.writeFileSync(outputPath, result.content, "utf-8");
-  success4(`Changelog written to ${outputPath} (using ${result.engine} template)`);
+  fs10.writeFileSync(outputPath, result.content, "utf-8");
+  const label = /changelog/i.test(outputPath) ? "Changelog" : "Release notes";
+  success(`${label} written to ${outputPath} (using ${result.engine} template)`);
 }
 async function runPipeline(input, config, dryRun) {
   debug(`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");
+    info("Processing with LLM enhancement");
     contexts = await Promise.all(contexts.map((ctx) => processWithLLM(ctx, config)));
   }
+  const files = [];
+  const fmtOpts = {
+    includePackageName: contexts.length > 1 || contexts.some((c) => c.packageName.includes("/"))
+  };
   for (const output of config.output) {
-    info4(`Generating ${output.format} output`);
+    const file = output.file ?? (output.format === "json" ? "changelog.json" : "CHANGELOG.md");
+    const isChangelog = /changelog/i.test(file);
+    const outputKind = isChangelog ? "changelog" : "release notes";
+    info(`Generating ${outputKind} \u2192 ${file}`);
     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);
+        const file2 = output.file ?? "CHANGELOG.md";
+        try {
+          const effectiveTemplateConfig = output.templates ?? config.templates;
+          if (effectiveTemplateConfig?.path || output.options?.template) {
+            const configWithTemplate = { ...config, templates: effectiveTemplateConfig };
+            await generateWithTemplate(contexts, configWithTemplate, file2, dryRun);
+          } else {
+            writeMarkdown(file2, contexts, config, dryRun, fmtOpts);
+          }
+          if (!dryRun) files.push(file2);
+        } catch (error) {
+          warn(`Failed to write ${file2}: ${error instanceof Error ? error.message : String(error)}`);
         }
         break;
       }
       case "json": {
-        const file = output.file ?? "changelog.json";
-        writeJson(file, contexts, dryRun);
+        const file2 = output.file ?? "changelog.json";
+        try {
+          writeJson(file2, contexts, dryRun);
+          if (!dryRun) files.push(file2);
+        } catch (error) {
+          warn(`Failed to write ${file2}: ${error instanceof Error ? error.message : String(error)}`);
+        }
         break;
       }
       case "github-release": {
         if (dryRun) {
-          info4("[DRY RUN] Would create GitHub release");
+          info("[DRY RUN] Would create GitHub release");
           break;
         }
         const firstContext = contexts[0];
         if (!firstContext) {
-          warn3("No context available for GitHub release");
+          warn("No context available for GitHub release");
           break;
         }
         const repoUrl = firstContext.repoUrl;
         if (!repoUrl) {
-          warn3("No repo URL available, cannot create GitHub release");
+          warn("No repo URL available, cannot create GitHub release");
           break;
         }
         const parsed = parseRepoUrl(repoUrl);
         if (!parsed) {
-          warn3(`Could not parse repo URL: ${repoUrl}`);
+          warn(`Could not parse repo URL: ${repoUrl}`);
           break;
         }
         await createGitHubRelease(firstContext, {
@@ -1429,165 +1799,53 @@ 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-YA7LC3KJ.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 {
   loadAuth,
   saveAuth,
-  loadConfig,
+  loadConfig2 as loadConfig,
   getDefaultConfig,
   NotesError,
   InputParseError,
   TemplateError,
   LLMError,
   GitHubError,
-  ConfigError,
+  ConfigError2 as ConfigError,
   getExitCode,
-  EXIT_CODES2 as EXIT_CODES,
   parsePackageVersioner,
   parsePackageVersionerFile,
   parsePackageVersionerStdin,
-  renderMarkdown,
-  writeMarkdown,
   renderJson,
   writeJson,
   createTemplateContext,
   runPipeline,
-  processInput,
-  aggregateToRoot,
-  writeMonorepoChangelogs,
-  detectMonorepo
+  processInput
 };