Function collectChanges

@vtx-labs/repo2post — programmatic API.

Turn a git range, tag diff, or pull request into a release blog post, changelog, release notes, launch thread, or technical breakdown — with a single AI call. The library reads the change set from git (read-only), builds a grounded prompt in the chosen style, and generates the content through the AI SDK (any provider/model string, routed via the Vercel AI Gateway).

Example

import { collectChanges, generatePost } from "@vtx-labs/repo2post";

const changes = await collectChanges({ from: "v1.0.0", to: "v1.1.0" });
const post = await generatePost(
  { changes, style: "changelog", project: "my-lib" },
  { model: "anthropic/claude-sonnet-4.5" },
);
console.log(post.content);

collectChanges(options?: CollectOptions): Promise<ChangeSet>
Collect the change set for a git range. Resolves a sensible default range (previous tag → HEAD) when from/to are omitted.
Parameters
- options: CollectOptions = {}
Returns Promise<ChangeSet>
Throws
GitError if the directory is not a repo or git fails.
- Defined in src/git.ts:163

Function collectChanges

Example

Parameters

Returns Promise<ChangeSet>

Throws

Settings