@releasekit/notes 0.3.0-next.4 → 0.3.0

package/README.md

@@ -19,6 +19,8 @@ npm install -g @releasekit/notes
 pnpm add -g @releasekit/notes
 ```
 
+> **Note:** This package is ESM only and requires Node.js 20+.
+
 ## Quick Start
 
 ```bash

package/dist/cli.js

@@ -1,174 +1 @@
 #!/usr/bin/env node
-import {
-  EXIT_CODES,
-  NotesError,
-  getDefaultConfig,
-  getExitCode,
-  loadConfig,
-  parsePackageVersioner,
-  runPipeline,
-  saveAuth
-} from "./chunk-QUBVC5LF.js";
-import "./chunk-QCF6V2IY.js";
-
-// src/cli.ts
-import * as fs from "fs";
-import * as readline from "readline";
-import { error, info, setLogLevel, setQuietMode, success } from "@releasekit/core";
-import { Command } from "commander";
-var program = new Command();
-program.name("releasekit-notes").description("Generate changelogs with LLM-powered enhancement and flexible templating").version("0.1.0");
-program.command("generate", { isDefault: true }).description("Generate changelog from input data").option("-i, --input <file>", "Input file (default: stdin)").option("-o, --output <spec>", "Output spec (format:file)", collectOutputs, []).option("-t, --template <path>", "Template file or directory").option("-e, --engine <engine>", "Template engine (handlebars|liquid|ejs)").option("--monorepo <mode>", "Monorepo mode (root|packages|both)").option("--llm-provider <provider>", "LLM provider").option("--llm-model <model>", "LLM model").option("--llm-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) setQuietMode(true);
-  try {
-    const config = loadConfig(process.cwd(), options.config);
-    if (options.output.length > 0) {
-      config.output = options.output;
-    }
-    if (config.output.length === 0) {
-      config.output = getDefaultConfig().output;
-    }
-    if (options.regenerate) {
-      config.updateStrategy = "regenerate";
-    }
-    if (options.template) {
-      config.templates = { ...config.templates, path: options.template };
-    }
-    if (options.engine) {
-      config.templates = { ...config.templates, engine: options.engine };
-    }
-    if (options.llm === false) {
-      info("LLM processing disabled via --no-llm flag");
-      delete config.llm;
-    } else if (options.llmProvider || options.llmModel || options.llmBaseUrl || options.llmTasks) {
-      config.llm = config.llm ?? { provider: "openai-compatible", model: "" };
-      if (options.llmProvider) config.llm.provider = options.llmProvider;
-      if (options.llmModel) config.llm.model = options.llmModel;
-      if (options.llmBaseUrl) config.llm.baseURL = options.llmBaseUrl;
-      if (options.llmTasks) {
-        const taskNames = options.llmTasks.split(",").map((t) => t.trim());
-        config.llm.tasks = {
-          enhance: taskNames.includes("enhance"),
-          summarize: taskNames.includes("summarize"),
-          categorize: taskNames.includes("categorize"),
-          releaseNotes: taskNames.includes("release-notes") || taskNames.includes("releaseNotes")
-        };
-      }
-      info(`LLM configured: ${config.llm.provider}${config.llm.model ? ` (${config.llm.model})` : ""}`);
-      if (config.llm.baseURL) {
-        info(`LLM base URL: ${config.llm.baseURL}`);
-      }
-      const taskList = Object.entries(config.llm.tasks || {}).filter(([, enabled]) => enabled).map(([name]) => name).join(", ");
-      if (taskList) {
-        info(`LLM tasks: ${taskList}`);
-      }
-    }
-    let inputJson;
-    if (options.input) {
-      inputJson = fs.readFileSync(options.input, "utf-8");
-    } else {
-      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) {
-        info(`No changelog found for package "${options.target}" (had ${before} package(s))`);
-        return;
-      }
-      info(`Filtered to package: ${options.target}`);
-    }
-    if (options.monorepo) {
-      config.monorepo = { ...config.monorepo, mode: options.monorepo };
-    }
-    await runPipeline(input, config, options.dryRun ?? false);
-    if (options.dryRun) {
-      info("Dry run complete - no files were written");
-    } else {
-      success("Changelog generation complete");
-    }
-  } catch (err) {
-    handleError(err);
-  }
-});
-program.command("init").description("Create default configuration file").option("-f, --force", "Overwrite existing config").action((options) => {
-  const configPath = "releasekit.config.json";
-  if (fs.existsSync(configPath) && !options.force) {
-    error(`Config file already exists at ${configPath}. Use --force to overwrite.`);
-    process.exit(EXIT_CODES.GENERAL_ERROR);
-  }
-  const defaultConfig = {
-    $schema: "https://releasekit.dev/schema.json",
-    notes: {
-      output: [{ format: "markdown", file: "CHANGELOG.md" }],
-      updateStrategy: "prepend"
-    }
-  };
-  fs.writeFileSync(configPath, JSON.stringify(defaultConfig, null, 2), "utf-8");
-  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;
-  if (options.key) {
-    apiKey = options.key;
-  } else {
-    apiKey = await promptSecret(`Enter API key for ${provider}: `);
-  }
-  if (!apiKey.trim()) {
-    error("API key cannot be empty");
-    process.exit(EXIT_CODES.GENERAL_ERROR);
-  }
-  saveAuth(provider, apiKey.trim());
-  success(`API key saved for ${provider}`);
-});
-program.command("providers").description("List available LLM providers").action(() => {
-  info("Available LLM providers:");
-  console.log("  openai          - OpenAI (GPT models)");
-  console.log("  anthropic       - Anthropic (Claude models)");
-  console.log("  ollama          - Ollama (local models)");
-  console.log("  openai-compatible - Any OpenAI-compatible endpoint");
-});
-function collectOutputs(value, previous) {
-  const parts = value.split(":");
-  const format = parts[0] ?? "markdown";
-  const file = parts[1];
-  const spec = { format };
-  if (file) {
-    spec.file = file;
-  }
-  return [...previous, spec];
-}
-function increaseVerbosity(_, previous) {
-  return previous + 1;
-}
-function setVerbosity(level) {
-  const levels = ["info", "debug", "trace"];
-  setLogLevel(levels[Math.min(level, levels.length - 1)] ?? "info");
-}
-async function readStdin() {
-  const chunks = [];
-  for await (const chunk of process.stdin) {
-    chunks.push(chunk);
-  }
-  return chunks.join("");
-}
-function promptSecret(prompt) {
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve) => {
-    rl.question(prompt, (answer) => {
-      rl.close();
-      resolve(answer);
-    });
-  });
-}
-function handleError(err) {
-  if (err instanceof NotesError) {
-    err.logError();
-    process.exit(getExitCode(err));
-  }
-  error(err instanceof Error ? err.message : String(err));
-  process.exit(EXIT_CODES.GENERAL_ERROR);
-}
-program.parse();

package/package.json

@@ -1,9 +1,8 @@
 {
   "name": "@releasekit/notes",
-  "version": "0.3.0-next.4",
+  "version": "0.3.0",
   "description": "Release notes and changelog generation with LLM-powered enhancement and flexible templating",
   "type": "module",
-  "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -11,10 +10,12 @@
       "import": {
         "types": "./dist/index.d.ts",
         "default": "./dist/index.js"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
+      }
+    },
+    "./cli": {
+      "import": {
+        "types": "./dist/cli.d.ts",
+        "default": "./dist/cli.js"
       }
     }
   },
@@ -53,9 +54,8 @@
     "handlebars": "^4.7.8",
     "liquidjs": "^10.25.0",
     "openai": "^6.27.0",
-    "zod": "^4.3.6",
-    "@releasekit/config": "0.1.0",
-    "@releasekit/core": "0.1.0"
+    "smol-toml": "^1.6.1",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.6",
@@ -64,14 +64,16 @@
     "@vitest/coverage-v8": "^4.1.0",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.0"
+    "vitest": "^4.1.0",
+    "@releasekit/config": "0.0.0",
+    "@releasekit/core": "0.0.0"
   },
   "engines": {
     "node": ">=20"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/cli.ts --format esm,cjs --dts",
-    "dev": "tsup src/index.ts src/cli.ts --format esm,cjs --watch --dts",
+    "build": "tsup",
+    "dev": "tsup --watch",
     "clean": "rm -rf dist coverage .turbo",
     "test": "vitest run",
     "test:unit": "vitest run --coverage",

package/dist/aggregator-JZ3VUZKP.js

@@ -1,13 +0,0 @@
-import {
-  aggregateToRoot,
-  detectMonorepo,
-  splitByPackage,
-  writeMonorepoChangelogs
-} from "./chunk-TSLTZ26C.js";
-import "./chunk-QCF6V2IY.js";
-export {
-  aggregateToRoot,
-  detectMonorepo,
-  splitByPackage,
-  writeMonorepoChangelogs
-};

package/dist/chunk-QCF6V2IY.js

@@ -1,135 +0,0 @@
-// src/output/markdown.ts
-import * as fs from "fs";
-import * as path from "path";
-import { debug, 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, options) {
-  const lines = [];
-  const versionLabel = options?.includePackageName && context.packageName ? `${context.packageName}@${context.version}` : context.version;
-  const versionHeader = context.previousVersion ? `## [${versionLabel}]` : `## ${versionLabel}`;
-  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, options) {
-  const sections = [formatHeader()];
-  for (const context of contexts) {
-    sections.push(formatVersion(context, options));
-  }
-  return sections.join("\n");
-}
-function prependVersion(existingPath, context, options) {
-  let existing = "";
-  if (fs.existsSync(existingPath)) {
-    existing = fs.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, options);
-      return `${header}
-
-${newVersion}
-${body}`;
-    }
-  }
-  return renderMarkdown([context]);
-}
-function writeMarkdown(outputPath, contexts, config, dryRun) {
-  const content = renderMarkdown(contexts);
-  if (dryRun) {
-    info(`Would write changelog to ${outputPath}`);
-    debug("--- Changelog Preview ---");
-    debug(content);
-    debug("--- End Preview ---");
-    return;
-  }
-  const dir = path.dirname(outputPath);
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-  }
-  if (outputPath === "-") {
-    process.stdout.write(content);
-    return;
-  }
-  if (config.updateStrategy === "prepend" && fs.existsSync(outputPath) && contexts.length === 1) {
-    const firstContext = contexts[0];
-    if (firstContext) {
-      const updated = prependVersion(outputPath, firstContext);
-      fs.writeFileSync(outputPath, updated, "utf-8");
-    }
-  } else {
-    fs.writeFileSync(outputPath, content, "utf-8");
-  }
-  success(`Changelog written to ${outputPath}`);
-}
-
-export {
-  formatVersion,
-  renderMarkdown,
-  prependVersion,
-  writeMarkdown
-};