@releasekit/notes 0.3.0 → 0.3.1

package/dist/cli.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+
+declare function createNotesCommand(): Command;
+
+export { createNotesCommand };

package/dist/cli.js

@@ -1 +1,197 @@
 #!/usr/bin/env node
+import {
+  NotesError,
+  getDefaultConfig,
+  getExitCode,
+  loadConfig,
+  parseVersionOutput,
+  runPipeline,
+  saveAuth
+} from "./chunk-ENAWZXFG.js";
+import {
+  EXIT_CODES,
+  error,
+  info,
+  readPackageVersion,
+  setLogLevel,
+  setQuietMode,
+  success
+} from "./chunk-E4454SIS.js";
+
+// src/cli.ts
+import * as fs from "fs";
+import * as readline from "readline";
+import { fileURLToPath } from "url";
+import { Command } from "commander";
+function createNotesCommand() {
+  const cmd = new Command("notes").description(
+    "Generate changelogs with LLM-powered enhancement and flexible templating"
+  );
+  cmd.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 = parseVersionOutput(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);
+    }
+  });
+  cmd.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}`);
+  });
+  cmd.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}`);
+  });
+  cmd.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");
+  });
+  return cmd;
+}
+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);
+}
+var isMain = (() => {
+  try {
+    return process.argv[1] ? fs.realpathSync(process.argv[1]) === fileURLToPath(import.meta.url) : false;
+  } catch {
+    return false;
+  }
+})();
+if (isMain) {
+  createNotesCommand().name("releasekit-notes").version(readPackageVersion(import.meta.url)).parse();
+}
+export {
+  createNotesCommand
+};

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { getDefaultConfig, loadAuth, loadConfig, saveAuth } from './core/config.ts';
+export { PipelineResult, createTemplateContext, processInput, runPipeline } from './core/pipeline.ts';
+export * from './core/types.ts';
+export * from './errors/index.ts';
+export { parseVersionOutput, parseVersionOutputFile, parseVersionOutputStdin } from './input/version-output.ts';
+export { aggregateToRoot, detectMonorepo, writeMonorepoChangelogs } from './monorepo/aggregator.ts';
+export { renderJson, writeJson } from './output/json.ts';
+export { formatVersion, renderMarkdown, writeMarkdown } from './output/markdown.ts';

package/dist/index.js

@@ -0,0 +1,58 @@
+import {
+  ConfigError,
+  GitHubError,
+  InputParseError,
+  LLMError,
+  NotesError,
+  TemplateError,
+  createTemplateContext,
+  getDefaultConfig,
+  getExitCode,
+  loadAuth,
+  loadConfig,
+  parseVersionOutput,
+  parseVersionOutputFile,
+  parseVersionOutputStdin,
+  processInput,
+  renderJson,
+  runPipeline,
+  saveAuth,
+  writeJson
+} from "./chunk-ENAWZXFG.js";
+import {
+  aggregateToRoot,
+  detectMonorepo,
+  writeMonorepoChangelogs
+} from "./chunk-DCQ32FVH.js";
+import {
+  formatVersion,
+  renderMarkdown,
+  writeMarkdown
+} from "./chunk-E4454SIS.js";
+export {
+  ConfigError,
+  GitHubError,
+  InputParseError,
+  LLMError,
+  NotesError,
+  TemplateError,
+  aggregateToRoot,
+  createTemplateContext,
+  detectMonorepo,
+  formatVersion,
+  getDefaultConfig,
+  getExitCode,
+  loadAuth,
+  loadConfig,
+  parseVersionOutput,
+  parseVersionOutputFile,
+  parseVersionOutputStdin,
+  processInput,
+  renderJson,
+  renderMarkdown,
+  runPipeline,
+  saveAuth,
+  writeJson,
+  writeMarkdown,
+  writeMonorepoChangelogs
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@releasekit/notes",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Release notes and changelog generation with LLM-powered enhancement and flexible templating",
   "type": "module",
   "module": "./dist/index.js",
@@ -65,8 +65,8 @@
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^4.1.0",
-    "@releasekit/config": "0.0.0",
-    "@releasekit/core": "0.0.0"
+    "@releasekit/core": "0.0.0",
+    "@releasekit/config": "0.0.0"
   },
   "engines": {
     "node": ">=20"