Changeset parsing and version prediction from .changeset/*.md files.
Reads changesets to determine which packages need publishing and their version bumps. For auto-generating changesets during publishing, see changeset_generator.ts.
7 declarations
changeset_reader.ts view source
ChangesetInfo import type {ChangesetInfo} from '@fuzdev/fuz_gitops/changeset_reader.js'; filenametype string
packagestype Array<{name: string; bump_type: BumpType}>
summarytype string
changeset_reader.ts view source
(changesets: ChangesetInfo[], package_name: string): BumpType | null import {determine_bump_from_changesets} from '@fuzdev/fuz_gitops/changeset_reader.js'; Determines the bump type for a package from its changesets.
When multiple changesets exist for the same package, returns the highest bump type (major > minor > patch) to ensure the most significant change is reflected in the version bump.
changesetsChangesetInfo[]package_namestringBumpType | null the highest bump type, or null if package has no changesets
changeset_reader.ts view source
(repo: LocalRepo): Promise<boolean> import {has_changesets} from '@fuzdev/fuz_gitops/changeset_reader.js'; Checks if a repo has any changeset files (excluding README.md).
Used by preflight checks and publishing workflow to determine which packages
need to be published. Returns false if .changeset directory doesn't exist
or contains only README.md.
repoPromise<boolean> true if repo has unpublished changesets
changeset_reader.ts view source
(content: string, filename?: string): ChangesetInfo | null import {parse_changeset_content} from '@fuzdev/fuz_gitops/changeset_reader.js'; Parses changeset content string from markdown format.
Pure function for testability - no file I/O, just string parsing. Extracts package names, bump types, and summary from YAML frontmatter format. Returns null if format is invalid or no packages found.
Expected format:
---
"package-name": patch
"@scope/package": minor
---
Summary of changescontentchangeset markdown with YAML frontmatter
stringfilenameoptional filename for error reporting context
string'changeset.md'ChangesetInfo | null parsed changeset info or null if invalid format
changeset_reader.ts view source
(filepath: string, log?: Logger | undefined): Promise<ChangesetInfo | null> import {parse_changeset_file} from '@fuzdev/fuz_gitops/changeset_reader.js'; filepathstringlog?Logger | undefinedPromise<ChangesetInfo | null> changeset_reader.ts view source
(repo: LocalRepo, log?: Logger | undefined): Promise<{ version: string; bump_type: BumpType; } | null> import {predict_next_version} from '@fuzdev/fuz_gitops/changeset_reader.js'; Predicts the next version by analyzing all changesets in a repo.
Reads all changesets, determines the highest bump type for the package, and calculates the next version. Returns null if no changesets found.
Critical for dry-run mode accuracy - allows simulating publishes without
actually running gro publish which consumes changesets.
repolog?Logger | undefinedPromise<{ version: string; bump_type: BumpType; } | null> predicted version and bump type, or null if no changesets
changeset_reader.ts view source
(repo: LocalRepo, log?: Logger | undefined): Promise<ChangesetInfo[]> import {read_changesets} from '@fuzdev/fuz_gitops/changeset_reader.js'; repolog?Logger | undefinedPromise<ChangesetInfo[]>