FM / changelog

/home/techb158/balacoffee.com/wp-content/themes/Divi/tools/changelog/

/home/techb158/balacoffee.com/wp-content/themes/Divi/tools/changelog

Name	Size	Mode	Actions
changelog-from-milestone-auto.js	17431	0644	edit dl rm
fetchData.js	3103	0644	edit dl rm
getPRLinks.js	4073	0644	edit dl rm
README.md	1681	0644	edit dl rm

Edit: /home/techb158/balacoffee.com/wp-content/themes/Divi/tools/changelog/README.md (1681B)

# Divi Changelog Tools

Generates `changelog.txt`, `changelog.json`, and `changelog-internal.md` by
pulling changelog copy from PRs attached to a GitHub milestone in the
`elegantthemes/Divi` repository.

## How It Works

- Fetches a milestone and its closed issues.
- Reads each issue's **Attached PR(s)** section to find PR links.
- Extracts **Changelog Copy** from each PR body.
- Writes a new version entry to:
  - `changelog.txt`
  - `changelog.json`
  - `changelog-internal.md` (includes PR links)

## Requirements

- Node.js (20+ recommended).
- `GITHUB_TOKEN` with access to `elegantthemes/Divi`.

## Run Locally

```bash
cd tools/changelog
npm ci
GITHUB_TOKEN=ghp_... node changelog-from-milestone-auto.js \
  --target-dir=/path/to/Divi
```

### Optional Flags

- `--milestone` (`-m`): Milestone number. Optional; defaults to latest open
  **5.x.x** milestone by semver.
- `--release-version` (`-v`): Override version (otherwise derived from milestone
  title).
- `--target-dir` (`-d`): Repo root containing changelog files (default: repo root).
- `--version-output`: Write resolved version to a file path.
- `--dry-run`: Show actions without writing files.

> Local runs only update files. They do not create PRs.

## Run via GitHub Actions

Workflow: **Actions → Update Changelog**

- The milestone input is optional. When omitted, the workflow picks the latest
  open **5.x.x** milestone.
- The workflow creates a PR targeting the latest `release-5.x` branch.
- PR branch name: `chore/changelog-<version>`.

## Expected Issue / PR Format

- Issues must include an **Attached PR(s)** section with PR links.
- PRs must include a **Changelog Copy** section in the body.

# Divi Changelog Tools Generates `changelog.txt`, `changelog.json`, and `changelog-internal.md` by pulling changelog copy from PRs attached to a GitHub milestone in the `elegantthemes/Divi` repository. ## How It Works - Fetches a milestone and its closed issues. - Reads each issue's **Attached PR(s)** section to find PR links. - Extracts **Changelog Copy** from each PR body. - Writes a new version entry to: - `changelog.txt` - `changelog.json` - `changelog-internal.md` (includes PR links) ## Requirements - Node.js (20+ recommended). - `GITHUB_TOKEN` with access to `elegantthemes/Divi`. ## Run Locally ```bash cd tools/changelog npm ci GITHUB_TOKEN=ghp_... node changelog-from-milestone-auto.js \ --target-dir=/path/to/Divi ``` ### Optional Flags - `--milestone` (`-m`): Milestone number. Optional; defaults to latest open **5.x.x** milestone by semver. - `--release-version` (`-v`): Override version (otherwise derived from milestone title). - `--target-dir` (`-d`): Repo root containing changelog files (default: repo root). - `--version-output`: Write resolved version to a file path. - `--dry-run`: Show actions without writing files. > Local runs only update files. They do not create PRs. ## Run via GitHub Actions Workflow: **Actions → Update Changelog** - The milestone input is optional. When omitted, the workflow picks the latest open **5.x.x** milestone. - The workflow creates a PR targeting the latest `release-5.x` branch. - PR branch name: `chore/changelog-`. ## Expected Issue / PR Format - Issues must include an **Attached PR(s)** section with PR links. - PRs must include a **Changelog Copy** section in the body.