@versu/core 0.11.0 → 0.13.0

package/README.md

@@ -8,6 +8,8 @@
 
 The core business logic powering Versu. This package is completely framework-agnostic and can be integrated into any TypeScript/JavaScript project, CI/CD system, or custom tooling.
 
+For comprehensive documentation, examples, and configuration options, please refer to the our website <https://versuhq.github.io/>.
+
 ## Installation
 
 ```bash
@@ -17,16 +19,14 @@ npm install @versu/core
 ## Quick Start
 
 ```typescript
-import { VersuRunner } from '@versu/core';
+import { VersuRunner, type RunnerOptions } from "@versu/core";
+
+const options: RunnerOptions = {
+  repoRoot: "/path/to/repository",
+  // ...other options as needed
+};
 
-const runner = new VersuRunner({
-  repoRoot: '/path/to/repository',
-  adapter: 'gradle', // Optional - auto-detected if not specified
-  dryRun: false,
-  pushTags: true,
-  pushChanges: true,
-  generateChangelog: true
-});
+const runner = new VersuRunner(options);
 
 const result = await runner.run();
 
@@ -35,173 +35,193 @@ console.log(`Changed modules:`, result.changedModules);
 console.log(`Created tags:`, result.createdTags);
 ```
 
-For detailed pre-release configuration and examples, see [PRERELEASE.md](./PRERELEASE.md).
-
 ## VersuRunner API
 
 ### Options
 
 ```typescript
-interface RunnerOptions {
-  repoRoot: string;                    // Path to repository root
-  adapter?: string;                    // Language adapter (auto-detected if not specified)
-  dryRun?: boolean;                    // Preview changes without writing (default: false)
-  pushTags?: boolean;                  // Push version tags (default: true)
-  prereleaseMode?: boolean;            // Generate pre-release versions (default: false)
-  prereleaseId?: string;               // Pre-release identifier: alpha, beta, rc, etc. (default: 'alpha')
-  bumpUnchanged?: boolean;             // Bump modules with no changes in prerelease mode (default: false)
-  addBuildMetadata?: boolean;          // Add build metadata with short SHA (default: false)
-  timestampVersions?: boolean;         // Use timestamp-based prerelease IDs (default: false)
-  appendSnapshot?: boolean;            // Add -SNAPSHOT suffix (Gradle only) (default: false)
-  pushChanges?: boolean;               // Commit and push version changes (default: true)
-  generateChangelog?: boolean;         // Generate changelogs (default: true)
-}
+type RunnerOptions = {
+  // Required
+  repoRoot: string; // Absolute path to repository root
+  prereleaseMode: boolean; // Generate pre-release versions
+  prereleaseId: string; // Pre-release identifier, e.g. 'alpha', 'beta', 'rc'
+  bumpUnchanged: boolean; // Bump modules with no changes (prerelease mode only)
+  addBuildMetadata: boolean; // Append short SHA as build metadata (+sha)
+  timestampVersions: boolean; // Use timestamp-based pre-release identifiers
+  appendSnapshot: boolean; // Append -SNAPSHOT suffix (Gradle only)
+  createTags: boolean; // Create git tags for bumped modules
+  generateChangelog: boolean; // Generate CHANGELOG.md files
+  generateReleaseNotes: boolean; // Generate release notes files (e.g. RELEASE.md)
+  pushChanges: boolean; // Commit and push version changes to remote
+  dryRun: boolean; // Preview changes without writing anything
+
+  // Optional
+  adapter?: string; // Language adapter ID (auto-detected if omitted)
+  changelogFilename?: string; // Changelog filename (default: 'CHANGELOG.md')
+  releaseNotesFilename?: string; // Release notes filename (default: 'RELEASE.md')
+  fromRef?: string; // Git ref to use as the lower boundary for commit analysis
+  provider?: string; // Version control provider name (auto-detected if omitted)
+};
 ```
 
 ### Result
 
 ```typescript
-interface RunnerResult {
-  bumped: boolean;                     // Whether any version was updated
-  changedModules: Array<{
-    name: string;                      // Module name
-    from: string;                      // Previous version
-    to: string;                        // New version
-  }>;
-  createdTags: string[];              // Git tags that were created
-  changelogPaths: string[];           // Generated changelog file paths
-}
+type RunnerResult = {
+  bumped: boolean; // Whether any version was updated
+  discoveredModules: Array<Module>; // All modules found in the repository
+  changedModules: Array<ModuleChangeResult>; // Modules whose version changed
+  createdTags: string[]; // Git tags that were created
+  changelogPaths: string[]; // Generated changelog file paths
+  releaseNotesPaths: string[]; // Generated release notes file paths
+};
 ```
 
 ## Configuration
 
 Versu core uses [cosmiconfig](https://github.com/davidtheclark/cosmiconfig) for configuration loading and [Zod](https://github.com/colinhacks/zod) for validation.
 
-### Supported Configuration Files
-
-1. `package.json` (in a `"versu"` property)
-2. `.versurc.json`
-3. `.versurc.yaml` / `.versurc.yml`
-4. `.versurc.js` or `versu.config.js` (JavaScript)
+You can provide configuration in any of the supported config files (e.g., `.versurc`, `versu.config.js`, etc.) or via `package.json` under the `versu` key. For the full list please refer to [cosmiconfig search places documentation](https://github.com/cosmiconfig/cosmiconfig?tab=readme-ov-file#searchplaces).
 
 ### Configuration Example
 
 ```json
 {
-  "versionRules": {
-    "defaultBump": "patch",
-    "commitTypeBumps": {
-      "feat": "minor",
-      "fix": "patch",
-      "perf": "patch",
-      "docs": "ignore"
+  "versioning": {
+    "breakingChange": {
+      "stable": "major",
+      "prerelease": "premajor"
+    },
+    "unknownCommitType": {
+      "stable": "patch",
+      "prerelease": "prepatch"
     },
-    "dependencyBumps": {
-      "major": "major",
-      "minor": "minor",
-      "patch": "patch"
+    "commitTypes": {
+      "feat": {
+        "stable": "minor",
+        "prerelease": "preminor"
+      },
+      "fix": {
+        "stable": "patch",
+        "prerelease": "prepatch"
+      }
+    },
+    "cascadeRules": {
+      "stable": {
+        "major": "major",
+        "minor": "minor",
+        "patch": "patch"
+      },
+      "prerelease": {
+        "major": "premajor",
+        "minor": "preminor",
+        "patch": "prepatch"
+      }
     }
   },
   "changelog": {
     "root": {
       "context": {
-        "prependPlaceholder": "<!-- CHANGELOG -->"
+        "prependPlaceholder": "<!-- Next Version Placeholder -->"
       }
     },
     "module": {
       "context": {
-        "prependPlaceholder": "<!-- CHANGELOG -->"
+        "prependPlaceholder": "<!-- Next Version Placeholder -->"
       }
     }
   }
 }
 ```
 
-**Changelog Configuration:**
+**Changelog & Release Notes Configuration:**
 
 - `changelog.root` - Configuration for root-level CHANGELOG.md generation
 - `changelog.module` - Configuration for per-module CHANGELOG.md generation
-- `context.prependPlaceholder` - Placeholder string in changelog files where new entries are inserted
-- `options` - Advanced changelog generation options (templates, grouping, sorting)
+- `changelog.context.prependPlaceholder` - Placeholder string in changelog files where new entries are inserted
+- `changelog.context.options` - Advanced changelog generation options (templates, grouping, sorting)
 
-Versu uses [conventional-changelog-writer](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-writer) for changelog generation. You can pass any options supported by conventional-changelog-writer through the `options` field. For advanced customization with functions (like `transform`, `commitsGroupsSort`), use JavaScript configuration files (`.versurc.js` or `versu.config.js`).
+Release notes follows the same pattern under `release` key.
 
-## Adapters
-
-### Gradle Adapter
-
-Gradle support is provided by the **[@versu/plugin-gradle][plugin-gradle]** package.
-
-**Features:**
-
-- Multi-module project detection
-- Version management through root `gradle.properties`
-- Dependency detection
-- Both Groovy and Kotlin DSL support
-
-**Version Format:**
+Versu uses [conventional-changelog-writer](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-writer) for changelog and release notes generation. You can pass any options supported by conventional-changelog-writer through the `options` field. For advanced customization with functions (like `transform`, `commitsGroupsSort`), use JavaScript configuration files (`.versurc.js` or `versu.config.js`).
 
-```properties
-# Root module
-version=1.0.0
+## Adapters
 
-# Submodules
-core.version=2.1.0
-api.version=1.5.0
-```
+Versu supports multiple language ecosystems through adapters. The core package includes a plugin system for adding new adapter support. In order to support additional ecosystems, you need to implement the required interfaces and register them as plugins.
 
 ### Creating Custom Adapters
 
 To add support for new project types, create a plugin package that implements the adapter interfaces:
 
 ```typescript
-import { 
-  AdapterIdentifier,
-  ModuleDetector,
-  VersionUpdateStrategy,
-  ModuleSystemFactory,
-  AdapterMetadata,
-  RawProjectInformation,
-  ProcessedModuleChange
-} from '@versu/core';
+import {
+  type AdapterIdentifier,
+  type AdapterMetadata,
+  type ModuleDetector,
+  type ProjectInformation,
+  type VersionUpdateStrategy,
+  type ModuleRegistry,
+  type ModuleSystemFactory,
+  exists,
+} from "@versu/core";
 
 // 1. Adapter identifier for auto-detection
 class MyAdapterIdentifier implements AdapterIdentifier {
   readonly metadata: AdapterMetadata = {
-    id: 'my-adapter',
-    capabilities: { supportsSnapshots: false }
+    id: "my-adapter",
+    capabilities: { supportsSnapshots: false },
   };
 
   async accept(projectRoot: string): Promise<boolean> {
     // Check for adapter-specific files
-    return await fileExists(path.join(projectRoot, 'my-build-file'));
+    return await exists(path.join(projectRoot, "my-build-file"));
   }
 }
 
 // 2. Module detector for discovering project structure
 class MyModuleDetector implements ModuleDetector {
-  async detectModules(projectRoot: string): Promise<RawProjectInformation> {
+  constructor(
+    readonly repoRoot: string,
+    readonly outputFile: string,
+  ) {}
+
+  async detect(): Promise<ProjectInformation> {
     // Discover and return modules and dependencies
     return {
+      moduleIds: ["root", "module-a"],
       modules: [
-        { name: 'root', path: projectRoot, version: '1.0.0' },
-        { name: 'module-a', path: join(projectRoot, 'module-a'), version: '2.0.0' }
+        {
+          id: "root",
+          name: "root",
+          path: this.repoRoot,
+          type: "root",
+          affectedModules: new Set(["module-a"]),
+          version: "1.0.0",
+          declaredVersion: false,
+        },
+        {
+          id: "module-a",
+          name: "module-a",
+          path: join(this.repoRoot, "module-a"),
+          type: "module",
+          affectedModules: new Set([]),
+          version: "2.0.0",
+          declaredVersion: true,
+        },
       ],
-      dependencies: [
-        { from: 'module-a', to: 'root' }
-      ]
     };
   }
 }
 
 // 3. Version update strategy for applying changes
 class MyVersionUpdateStrategy implements VersionUpdateStrategy {
-  async applyVersionUpdates(
-    changes: ProcessedModuleChange[],
-    projectRoot: string
+  constructor(private readonly moduleRegistry: ModuleRegistry) {}
+
+  async writeVersionUpdates(
+    moduleVersions: Map<string, string>,
   ): Promise<void> {
     // Apply version changes to build files
-    for (const change of changes) {
+    for (const [moduleId, newVersion] of moduleVersions) {
       // Update version in your project's format
     }
   }
@@ -209,12 +229,16 @@ class MyVersionUpdateStrategy implements VersionUpdateStrategy {
 
 // 4. Module system factory to tie it all together
 class MyModuleSystemFactory implements ModuleSystemFactory {
-  createDetector(): ModuleDetector {
-    return new MyModuleDetector();
+  constructor(private readonly repoRoot: string) {}
+
+  createDetector(outputFile: string): ModuleDetector {
+    return new MyModuleDetector(this.repoRoot, outputFile);
   }
-  
-  createVersionUpdateStrategy(): VersionUpdateStrategy {
-    return new MyVersionUpdateStrategy();
+
+  createVersionUpdateStrategy(
+    moduleRegistry: ModuleRegistry,
+  ): VersionUpdateStrategy {
+    return new MyVersionUpdateStrategy(moduleRegistry);
   }
 }
 ```
@@ -222,19 +246,20 @@ class MyModuleSystemFactory implements ModuleSystemFactory {
 Then create a plugin:
 
 ```typescript
-import type { PluginContract } from '@versu/core';
+import type { PluginContract } from "@versu/core";
 
 const myPlugin: PluginContract = {
-  id: 'my-adapter',
-  name: 'My Adapter',
-  description: 'Support for my build system',
-  version: '1.0.0',
-  author: 'Your Name',
+  id: "my-adapter",
+  name: "My Adapter",
+  description: "Support for my build system",
+  version: "1.0.0",
+  author: "Your Name",
   adapters: [
     {
-      id: 'my-adapter',
+      id: "my-adapter",
       adapterIdentifier: () => new MyAdapterIdentifier(),
-      moduleSystemFactory: (repoRoot: string) => new MyModuleSystemFactory(repoRoot),
+      moduleSystemFactory: (repoRoot: string) =>
+        new MyModuleSystemFactory(repoRoot),
     },
   ],
 };

package/dist/changes/index.d.ts

@@ -0,0 +1,13 @@
+import { ModuleChangeResult } from "../services/version-applier.js";
+import { Commit } from "conventional-commits-parser";
+import { ModuleChangesConfig } from "../config/types.js";
+/** Generate changes for multiple modules. */
+export declare function generateChangesForModules(moduleResults: ModuleChangeResult[], getCommitsForModule: (moduleId: string) => Promise<{
+    commits: Commit[];
+    lastTag: string | null;
+}>, repoRoot: string, dryRun: boolean, filename: string, multiModule: boolean, config?: ModuleChangesConfig, provider?: string): Promise<string[]>;
+export declare function generateRootChanges(moduleResults: ModuleChangeResult[], getCommitsForModule: (moduleId: string) => Promise<{
+    commits: Commit[];
+    lastTag: string | null;
+}>, repoRoot: string, dryRun: boolean, filename: string, config?: ModuleChangesConfig, provider?: string): Promise<string | undefined>;
+//# sourceMappingURL=index.d.ts.map

package/dist/changes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/changes/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAOpE,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AASrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAgDzD,6CAA6C;AAC7C,wBAAsB,yBAAyB,CAC7C,aAAa,EAAE,kBAAkB,EAAE,EACnC,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,EAC3D,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,OAAO,EACpB,MAAM,CAAC,EAAE,mBAAmB,EAC5B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC,CAoFnB;AAED,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,kBAAkB,EAAE,EACnC,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,EAC3D,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,mBAAmB,EAC5B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA4E7B"}

package/dist/{changelog → changes}/index.js

@@ -3,7 +3,7 @@ import { join } from "path";
 import { writeChangelogString, } from "conventional-changelog-writer";
 import { logger } from "../utils/logger.js";
 import { exists } from "../utils/file.js";
-import { getCurrentRepoUrl, parseRepoUrl } from "../git/index.js";
+import { getCurrentRepoUrl, getModuleTagName, parseRepoUrl, parseTagName, } from "../git/index.js";
 import { isReleaseVersion } from "../semver/index.js";
 import Handlebars from "handlebars";
 Handlebars.registerHelper("eq", (a, b) => a === b);
@@ -11,17 +11,17 @@ Handlebars.registerHelper("ne", (a, b) => a !== b);
 Handlebars.registerHelper("and", (a, b) => a && b);
 Handlebars.registerHelper("or", (a, b) => a || b);
 Handlebars.registerHelper("not", (a) => !a);
-/** Update or create a changelog file for a module. */
-export async function updateChangelogFile(changelogContent, changelogPath, prependPlaceholder) {
-    let fileContent = changelogContent;
-    if (await exists(changelogPath)) {
-        logger.info("Updating existing changelog", { path: changelogPath });
-        // Try to read existing changelog
-        const existingContent = await fs.readFile(changelogPath, "utf8");
-        const newContent = `${prependPlaceholder}\n\n${changelogContent.trimEnd()}`;
+/** Update or create changes file for a module. */
+async function updateChangesFile(content, filePath, prependPlaceholder) {
+    let fileContent = content;
+    if (await exists(filePath)) {
+        logger.info("Updating existing changes", { path: filePath });
+        // Try to read existing changes
+        const existingContent = await fs.readFile(filePath, "utf8");
+        const newContent = `${prependPlaceholder}\n\n${content.trimEnd()}`;
         fileContent = existingContent.replace(prependPlaceholder, newContent);
     }
-    await fs.writeFile(changelogPath, fileContent, "utf8");
+    await fs.writeFile(filePath, fileContent, "utf8");
 }
 async function buildContextRepository(options = {}) {
     const repoUrl = await getCurrentRepoUrl(options);
@@ -33,36 +33,36 @@ async function buildContextRepository(options = {}) {
         repository: repo,
     };
 }
-/** Generate changelog for multiple modules. */
-export async function generateChangelogsForModules(moduleResults, getCommitsForModule, repoRoot, dryRun, filename, multiModule, config, provider) {
-    const changelogPaths = [];
+/** Generate changes for multiple modules. */
+export async function generateChangesForModules(moduleResults, getCommitsForModule, repoRoot, dryRun, filename, multiModule, config, provider) {
+    const renderedPaths = [];
     if (!config) {
-        throw new Error(`Missing required changelog configuration`);
+        throw new Error(`Missing required changes rendering configuration`);
     }
     const prependPlaceholder = config?.context?.prependPlaceholder;
     if (!prependPlaceholder) {
-        throw new Error("Missing required context property 'prependPlaceholder'");
+        throw new Error("Missing required changes rendering context property 'prependPlaceholder'");
     }
     const contextRepository = await buildContextRepository({ cwd: repoRoot });
     for (const moduleResult of moduleResults) {
         if (moduleResult.type === "root" && multiModule) {
-            logger.info("Skipping root module for individual changelog generation since multi-module changelog enabled", { moduleId: moduleResult.id });
+            logger.info("Skipping root module for individual changes generation since multi-module changes enabled", { moduleId: moduleResult.id });
             continue;
         }
         if (!moduleResult.declaredVersion) {
-            logger.debug("Module has no declared version, skipping changelog generation", { moduleId: moduleResult.id });
+            logger.debug("Module has no declared version, skipping changes generation", { moduleId: moduleResult.id });
             continue;
         }
         const { commits, lastTag } = await getCommitsForModule(moduleResult.id);
         if (commits.length === 0) {
-            logger.info("No commits found, skipping changelog", {
+            logger.info("No commits found, skipping rendering changes", {
                 moduleId: moduleResult.id,
             });
             continue;
         }
-        const changelogPath = join(repoRoot, moduleResult.path, filename);
+        const renderedPath = join(repoRoot, moduleResult.path, filename);
         let prepend = true;
-        if (await exists(changelogPath)) {
+        if (await exists(renderedPath)) {
             prepend = false;
         }
         const isRelease = isReleaseVersion(moduleResult.to);
@@ -71,7 +71,7 @@ export async function generateChangelogsForModules(moduleResults, getCommitsForM
             ? `${moduleResult.name}@${moduleResult.to}`
             : undefined;
         const previousTag = lastTag || undefined;
-        const changelogContent = await writeChangelogString(commits, {
+        const changesContent = await writeChangelogString(commits, {
             version: version,
             previousTag: previousTag,
             currentTag: currentTag,
@@ -82,55 +82,58 @@ export async function generateChangelogsForModules(moduleResults, getCommitsForM
             provider,
         }, config?.options);
         if (dryRun) {
-            logger.info("Dry run enabled, skipping writing changelog to file", {
+            logger.info("Dry run enabled, skipping writing changes to file", {
                 moduleId: moduleResult.id,
             });
-            logger.debug("Generated changelog content", { changelogContent });
+            logger.debug("Generated changes content", { changesContent });
         }
         else {
-            await updateChangelogFile(changelogContent, changelogPath, prependPlaceholder);
+            await updateChangesFile(changesContent, renderedPath, prependPlaceholder);
         }
-        changelogPaths.push(changelogPath);
+        renderedPaths.push(renderedPath);
     }
-    return changelogPaths;
+    return renderedPaths;
 }
-export async function generateRootChangelog(moduleResults, getCommitsForModule, repoRoot, dryRun, filename, config, provider) {
+export async function generateRootChanges(moduleResults, getCommitsForModule, repoRoot, dryRun, filename, config, provider) {
     const moduleResult = moduleResults.find((result) => result.type === "root");
     if (!moduleResult) {
-        logger.info("No root module found, skipping root changelog generation");
+        logger.info("No root module found, skipping root changes generation");
         return;
     }
     if (!config) {
-        throw new Error(`Missing required changelog configuration`);
+        throw new Error(`Missing required changes rendering configuration`);
     }
-    logger.info("Loading root changelog configuration");
+    logger.info("Loading root changes configuration");
     const prependPlaceholder = config?.context?.prependPlaceholder;
     if (!prependPlaceholder) {
-        throw new Error("Missing required context property 'prependPlaceholder'");
+        throw new Error("Missing required changes rendering context property 'prependPlaceholder'");
     }
     const contextRepository = await buildContextRepository({ cwd: repoRoot });
     const { commits, lastTag } = await getCommitsForModule(moduleResult.id);
     if (commits.length === 0) {
-        logger.info("No commits found, skipping root changelog", {
+        logger.info("No commits found, skipping root changes", {
             moduleId: moduleResult.id,
         });
         return;
     }
-    const changelogPath = join(repoRoot, moduleResult.path, filename);
+    const renderedPath = join(repoRoot, moduleResult.path, filename);
     let prepend = true;
-    if (await exists(changelogPath)) {
+    if (await exists(renderedPath)) {
         prepend = false;
     }
     const isRelease = isReleaseVersion(moduleResult.to);
     const version = isRelease ? moduleResult.to : undefined;
     const currentTag = isRelease
-        ? `${moduleResult.name}@${moduleResult.to}`
+        ? getModuleTagName(moduleResult.name, moduleResult.to)
         : undefined;
     const previousTag = lastTag || undefined;
-    const changelogContent = await writeChangelogString(commits, {
+    const changesContent = await writeChangelogString(commits, {
         moduleResults,
         version: version,
         previousTag: previousTag,
+        previousTagVersion: previousTag
+            ? parseTagName(previousTag).version
+            : undefined,
         currentTag: currentTag,
         linkCompare: previousTag && currentTag ? true : false,
         ...contextRepository,
@@ -139,14 +142,14 @@ export async function generateRootChangelog(moduleResults, getCommitsForModule,
         provider,
     }, config?.options);
     if (dryRun) {
-        logger.info("Dry run enabled, skipping writing root changelog to file", {
+        logger.info("Dry run enabled, skipping writing root changes to file", {
             moduleId: moduleResult.id,
         });
-        logger.debug("Generated root changelog content", { changelogContent });
+        logger.debug("Generated root changes content", { changesContent });
     }
     else {
-        await updateChangelogFile(changelogContent, changelogPath, prependPlaceholder);
+        await updateChangesFile(changesContent, renderedPath, prependPlaceholder);
     }
-    return changelogPath;
+    return renderedPath;
 }
 //# sourceMappingURL=index.js.map

package/dist/changes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/changes/index.ts"],"names":[],"mappings":"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"}