@releasekit/notes 0.45.0 → 0.46.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{aggregator-T5ZE72Y6.js → aggregator-XM2XIYDF.js} +1 -1
- package/dist/{chunk-66BANKM3.js → chunk-EI7LLVJN.js} +155 -128
- package/dist/{chunk-CJRSZUD4.js → chunk-RGY5RDF2.js} +145 -48
- package/dist/cli.js +2 -2
- package/dist/index.d.ts +90 -16
- package/dist/index.js +2 -2
- package/docs/llm-providers.md +2 -2
- package/docs/llm-release-notes.md +14 -40
- package/docs/monorepo.md +41 -0
- package/docs/templates.md +62 -53
- package/package.json +1 -1
- package/templates/angular/document.hbs +12 -0
- package/templates/angular/entry.hbs +1 -2
- package/templates/angular/version.hbs +14 -4
- package/templates/github-release/release.md.ejs +40 -15
- package/templates/keep-a-changelog/document.liquid +11 -0
- package/templates/keep-a-changelog/entry.liquid +1 -2
- package/templates/keep-a-changelog/version.liquid +19 -52
|
@@ -1,22 +1,31 @@
|
|
|
1
1
|
import {
|
|
2
|
+
BREAKING_SECTION,
|
|
2
3
|
EXIT_CODES,
|
|
3
4
|
ReleaseKitError,
|
|
4
5
|
debug,
|
|
5
6
|
detectMonorepo,
|
|
6
7
|
error,
|
|
7
8
|
formatVersion,
|
|
9
|
+
groupChangelogSections,
|
|
8
10
|
info,
|
|
9
11
|
isPathWithinRoot,
|
|
10
12
|
parseGitHubOwnerRepo,
|
|
11
13
|
removeDescriptionRefs,
|
|
14
|
+
renderBundledBlocks,
|
|
15
|
+
renderChangelogEntryLine,
|
|
12
16
|
renderMarkdown,
|
|
17
|
+
resolveBundled,
|
|
13
18
|
setLogLevel,
|
|
14
19
|
setQuietMode,
|
|
20
|
+
sharedPackageBlock,
|
|
21
|
+
sharedPackageEntriesOf,
|
|
15
22
|
success,
|
|
23
|
+
unlistedEntries,
|
|
16
24
|
unwrapEnvelope,
|
|
25
|
+
versionSections,
|
|
17
26
|
warn,
|
|
18
27
|
writeChangelog
|
|
19
|
-
} from "./chunk-
|
|
28
|
+
} from "./chunk-EI7LLVJN.js";
|
|
20
29
|
|
|
21
30
|
// ../config/dist/index.js
|
|
22
31
|
import * as fs from "fs";
|
|
@@ -65,7 +74,6 @@ function parseJsonc(content) {
|
|
|
65
74
|
}
|
|
66
75
|
return result;
|
|
67
76
|
}
|
|
68
|
-
var DEFAULT_DEMOTE_SCOPES = ["deps", "deps-dev"];
|
|
69
77
|
var GitConfigSchema = z.strictObject({
|
|
70
78
|
remote: z.string().default("origin").describe("Git remote name"),
|
|
71
79
|
branch: z.string().optional().describe(
|
|
@@ -146,13 +154,13 @@ var VersionConfigBaseSchema = z.strictObject({
|
|
|
146
154
|
),
|
|
147
155
|
packages: z.array(z.string()).default([]).describe("Packages to include in versioning. Empty includes every discovered package."),
|
|
148
156
|
sharedPackages: z.array(z.string()).optional().describe(
|
|
149
|
-
'Foundational packages whose changes belong in every package\u2019s
|
|
157
|
+
'Foundational packages whose changes belong in every package\u2019s notes, as exact names or globs. In async mode (`sync: false`, no `groups`, more than one package in the run), commits touching a shared package and no non-shared package are listed under "Project-wide changes" in each released package\u2019s changelog, release notes and release body, covering those since that package\u2019s previous release. A root changelog lists them once per run in such releases, alongside commits that touch no package. Default: none.'
|
|
150
158
|
),
|
|
151
159
|
primaryPackages: z.array(z.string()).default([]).describe(
|
|
152
|
-
"Packages users install, as exact names or globs. Each anchors a release unit with its group-mates and the internal dependencies it releases with. Used by the standing-PR selection list."
|
|
160
|
+
"Packages users install, as exact names or globs. Each anchors a release unit with its group-mates and the internal dependencies it releases with. Used by the standing-PR selection list. In async mode or grouped releases with per-package tags, each primary's release notes also list its group-mates' and internal dependencies' releases since its previous release."
|
|
153
161
|
),
|
|
154
162
|
sharedChangelogFloor: z.enum(["union", "sinceLastRelease"]).default("union").describe(
|
|
155
|
-
`How
|
|
163
|
+
`How project-wide entries in the standing PR and the root changelog are bounded in async mode (see sharedPackages); each package's own notes list the shared-package entries since its previous release. "union" (default): repo-level commits accrue from the union of the releasing packages' ranges, floored by the OLDEST unreleased baseline \u2014 so a genuinely-global commit recurs in every release until the oldest-baselined package is released past it. "sinceLastRelease": floor the block by the single nearest tag reachable across the repo, so global commits already shown by the most recent release don't recur (recommended for per-package-tag monorepos).`
|
|
156
164
|
),
|
|
157
165
|
mainPackage: z.string().optional().describe(
|
|
158
166
|
"The package a single-mode release versions. In sync mode, the release bumps from this package's version and tag and, without packageSpecificTags, carries its name. The changelog still lists every commit in the release."
|
|
@@ -373,10 +381,7 @@ var ChangelogConfigSchema = z.strictObject({
|
|
|
373
381
|
file: z.string().optional().describe("Changelog file name override (default: CHANGELOG.md)"),
|
|
374
382
|
templates: TemplateConfigSchema.optional().describe("Template configuration for changelog"),
|
|
375
383
|
refs: z.enum(["strip", "escape", "link"]).default("link").describe(
|
|
376
|
-
"How `#NNN` issue/PR refs in
|
|
377
|
-
),
|
|
378
|
-
demoteScopes: z.array(z.string()).default([...DEFAULT_DEMOTE_SCOPES]).describe(
|
|
379
|
-
'Conventional-commit scopes whose changelog entries move to a trailing "Dependencies & version bumps" subsection instead of mixing with Added / Changed / Fixed. A breaking change still comes first, under Breaking. Applies to the release preview comment and the standing-PR changelogs (each releasable row and the "Show all changes" footer). Entries are moved, not dropped, so the de-duplicated change count is unchanged. Default: ["deps", "deps-dev"], the scopes Dependabot uses. Set to [] to render every scope inline.'
|
|
384
|
+
"How `#NNN` issue/PR refs in changelog entries are rendered, wherever the entries appear. Applies to the whole entry \u2014 both the appended label and any bare `#N` carried over from the commit subject into the description (a description ref that also appears in the appended label is de-duplicated away). 'link' (default): the PR and the issues it closed are labelled as `(PR #503 \xB7 closes #500)`, where the PR links to its canonical /pull/ URL with `PR #503` as the visible text \u2014 this keeps the GitHub hovercard but stops the bare-token rich inline card that duplicated the entry; closed issues link to /issues/. An entry with no identifiable PR (a non-squash commit, or a non-GitHub repo) falls back to a plain ref list. 'escape': plain text \\#NNN (no link, no hovercard, no PR/closes labelling). 'strip': refs are removed entirely. Scoped-package / @user mentions in entry text are always neutralised regardless of this setting."
|
|
380
385
|
)
|
|
381
386
|
}).describe("Changelog file configuration");
|
|
382
387
|
var LLMOptionsSchema = z.strictObject({
|
|
@@ -462,7 +467,7 @@ var LLMConfigBaseSchema = z.strictObject({
|
|
|
462
467
|
"Number of the project's past GitHub Releases (0\u20135) used as style examples in the combined enhance and categorize prompt and the releaseNotes prompt. Needs GITHUB_TOKEN or GH_TOKEN."
|
|
463
468
|
),
|
|
464
469
|
context: z.strictObject({
|
|
465
|
-
pullRequests: z.boolean().default(true).describe("Fetch the title and body of each entry's
|
|
470
|
+
pullRequests: z.boolean().default(true).describe("Fetch the title and body of each entry's own PR as LLM context. Needs GITHUB_TOKEN or GH_TOKEN.")
|
|
466
471
|
}).default({ pullRequests: true }).describe("Additional context sources for the LLM."),
|
|
467
472
|
categoryOrder: z.array(z.string()).optional().describe(
|
|
468
473
|
"Order of the rendered categories. Listed ones come first; the rest keep their order in categories, except Breaking, which stays first unless listed."
|
|
@@ -496,7 +501,7 @@ var ReleaseNotesConfigSchema = z.strictObject({
|
|
|
496
501
|
})
|
|
497
502
|
).optional().describe("Static links, each { label, url }, listed first."),
|
|
498
503
|
fromPRBodyMarker: z.string().optional().describe(
|
|
499
|
-
"Also collect links from
|
|
504
|
+
"Also collect links from each entry's own PR body: each line starting with this marker adds its markdown link or bare URL, skipping URLs already listed. Needs llm.context.pullRequests."
|
|
500
505
|
),
|
|
501
506
|
title: z.string().optional().describe("Heading for the links section. Default: Links.")
|
|
502
507
|
}).optional().describe(
|
|
@@ -877,6 +882,9 @@ function loadConfig(options) {
|
|
|
877
882
|
const configPath = options?.configPath ?? resolveConfigPath(cwd);
|
|
878
883
|
return loadConfigFile(configPath);
|
|
879
884
|
}
|
|
885
|
+
function configuredRefsMode(notes) {
|
|
886
|
+
return (notes?.changelog || void 0)?.refs ?? "link";
|
|
887
|
+
}
|
|
880
888
|
|
|
881
889
|
// src/errors/index.ts
|
|
882
890
|
var NotesError = class extends ReleaseKitError {
|
|
@@ -965,7 +973,8 @@ var VersionChangelogEntrySchema = z3.looseObject({
|
|
|
965
973
|
prNumber: z3.string().optional(),
|
|
966
974
|
scope: z3.string().optional(),
|
|
967
975
|
originalType: z3.string().optional(),
|
|
968
|
-
breaking: z3.boolean().optional()
|
|
976
|
+
breaking: z3.boolean().optional(),
|
|
977
|
+
sharedPackage: z3.boolean().optional()
|
|
969
978
|
});
|
|
970
979
|
var VersionPackageChangelogSchema = z3.looseObject({
|
|
971
980
|
packageName: z3.string(),
|
|
@@ -974,7 +983,9 @@ var VersionPackageChangelogSchema = z3.looseObject({
|
|
|
974
983
|
revisionRange: z3.string(),
|
|
975
984
|
repoUrl: z3.string().nullable(),
|
|
976
985
|
entries: z3.array(VersionChangelogEntrySchema),
|
|
977
|
-
tag: z3.string().optional()
|
|
986
|
+
tag: z3.string().optional(),
|
|
987
|
+
sharedPackageEntries: z3.array(VersionChangelogEntrySchema).optional(),
|
|
988
|
+
bundled: z3.array(z3.looseObject({ packageName: z3.string(), versions: z3.array(z3.string()) })).optional()
|
|
978
989
|
});
|
|
979
990
|
var VersionPackageUpdateSchema = z3.looseObject({
|
|
980
991
|
packageName: z3.string(),
|
|
@@ -987,6 +998,10 @@ var VersionOutputSchema = z3.looseObject({
|
|
|
987
998
|
dryRun: z3.boolean(),
|
|
988
999
|
updates: z3.array(VersionPackageUpdateSchema),
|
|
989
1000
|
changelogs: z3.array(VersionPackageChangelogSchema),
|
|
1001
|
+
sharedEntries: z3.array(VersionChangelogEntrySchema).optional(),
|
|
1002
|
+
bundledReleases: z3.array(
|
|
1003
|
+
z3.looseObject({ packageName: z3.string(), version: z3.string(), entries: z3.array(VersionChangelogEntrySchema) })
|
|
1004
|
+
).optional(),
|
|
990
1005
|
commitMessage: z3.string().optional(),
|
|
991
1006
|
tags: z3.array(z3.string()),
|
|
992
1007
|
baselineTags: z3.array(z3.string()).optional(),
|
|
@@ -994,7 +1009,13 @@ var VersionOutputSchema = z3.looseObject({
|
|
|
994
1009
|
});
|
|
995
1010
|
|
|
996
1011
|
// src/input/version-output.ts
|
|
997
|
-
var NotesVersionOutputSchema = VersionOutputSchema.pick({
|
|
1012
|
+
var NotesVersionOutputSchema = VersionOutputSchema.pick({
|
|
1013
|
+
changelogs: true,
|
|
1014
|
+
updates: true,
|
|
1015
|
+
tags: true,
|
|
1016
|
+
sharedEntries: true,
|
|
1017
|
+
bundledReleases: true
|
|
1018
|
+
}).partial({
|
|
998
1019
|
updates: true,
|
|
999
1020
|
tags: true
|
|
1000
1021
|
});
|
|
@@ -1015,6 +1036,18 @@ function normalizeEntryType(type) {
|
|
|
1015
1036
|
};
|
|
1016
1037
|
return typeMap[type.toLowerCase()] ?? "changed";
|
|
1017
1038
|
}
|
|
1039
|
+
function toChangelogEntry(entry) {
|
|
1040
|
+
return {
|
|
1041
|
+
type: normalizeEntryType(entry.type),
|
|
1042
|
+
description: entry.description,
|
|
1043
|
+
issueIds: entry.issueIds,
|
|
1044
|
+
prNumber: entry.prNumber,
|
|
1045
|
+
scope: entry.scope,
|
|
1046
|
+
originalType: entry.originalType,
|
|
1047
|
+
breaking: entry.breaking ?? entry.originalType?.includes("!") ?? false,
|
|
1048
|
+
...entry.sharedPackage ? { sharedPackage: true } : {}
|
|
1049
|
+
};
|
|
1050
|
+
}
|
|
1018
1051
|
function versionOutputToChangelogInput(data) {
|
|
1019
1052
|
if (!data.changelogs || !Array.isArray(data.changelogs)) {
|
|
1020
1053
|
throw new InputParseError('Input must contain a "changelogs" array');
|
|
@@ -1028,20 +1061,16 @@ function versionOutputToChangelogInput(data) {
|
|
|
1028
1061
|
revisionRange: changelog.revisionRange,
|
|
1029
1062
|
repoUrl: changelog.repoUrl,
|
|
1030
1063
|
date: (/* @__PURE__ */ new Date()).toISOString().split("T")[0] ?? "",
|
|
1031
|
-
entries: changelog.entries.map(
|
|
1032
|
-
|
|
1033
|
-
|
|
1034
|
-
issueIds: entry.issueIds,
|
|
1035
|
-
prNumber: entry.prNumber,
|
|
1036
|
-
scope: entry.scope,
|
|
1037
|
-
originalType: entry.originalType,
|
|
1038
|
-
breaking: entry.breaking ?? entry.originalType?.includes("!") ?? false
|
|
1039
|
-
}))
|
|
1064
|
+
entries: changelog.entries.map(toChangelogEntry),
|
|
1065
|
+
sharedPackageEntries: changelog.sharedPackageEntries?.map(toChangelogEntry),
|
|
1066
|
+
bundled: changelog.bundled
|
|
1040
1067
|
}));
|
|
1041
1068
|
const repoUrl = packages[0]?.repoUrl ?? null;
|
|
1042
1069
|
return {
|
|
1043
1070
|
source: "version",
|
|
1044
1071
|
packages,
|
|
1072
|
+
sharedEntries: data.sharedEntries?.map(toChangelogEntry),
|
|
1073
|
+
bundledReleases: data.bundledReleases?.map((r) => ({ ...r, entries: r.entries.map(toChangelogEntry) })),
|
|
1045
1074
|
metadata: {
|
|
1046
1075
|
repoUrl: repoUrl ?? void 0
|
|
1047
1076
|
}
|
|
@@ -1747,7 +1776,7 @@ function parseReleaseBodyToExample(markdown, version) {
|
|
|
1747
1776
|
}
|
|
1748
1777
|
const heading = /^#{2,4} (.+)/.exec(line)?.[1];
|
|
1749
1778
|
if (heading) {
|
|
1750
|
-
currentCategory = heading.trim();
|
|
1779
|
+
currentCategory = heading.trim().replace(/:$/, "");
|
|
1751
1780
|
continue;
|
|
1752
1781
|
}
|
|
1753
1782
|
if (line.startsWith("#")) {
|
|
@@ -1763,7 +1792,7 @@ function parseReleaseBodyToExample(markdown, version) {
|
|
|
1763
1792
|
if (leadInMatch) {
|
|
1764
1793
|
entry.leadIn = leadInMatch[1];
|
|
1765
1794
|
}
|
|
1766
|
-
if (/\*\*BREAKING\*\*/i.test(text)) {
|
|
1795
|
+
if (currentCategory === BREAKING_SECTION || /\*\*BREAKING\*\*/i.test(text)) {
|
|
1767
1796
|
entry.breaking = true;
|
|
1768
1797
|
}
|
|
1769
1798
|
entries.push(entry);
|
|
@@ -3196,6 +3225,9 @@ async function withRetry(fn, options = {}) {
|
|
|
3196
3225
|
}
|
|
3197
3226
|
|
|
3198
3227
|
// src/core/pipeline.ts
|
|
3228
|
+
function ownPrNumber(entry) {
|
|
3229
|
+
return entry.prNumber ? parseIssueNumbers([entry.prNumber])[0] : void 0;
|
|
3230
|
+
}
|
|
3199
3231
|
function findCompoundTagSepPos(tag) {
|
|
3200
3232
|
let pos = tag.lastIndexOf("-");
|
|
3201
3233
|
while (pos > 0) {
|
|
@@ -3283,7 +3315,33 @@ function createTemplateContext(pkg) {
|
|
|
3283
3315
|
isFirstRelease: pkg.previousVersion === null
|
|
3284
3316
|
};
|
|
3285
3317
|
}
|
|
3286
|
-
function
|
|
3318
|
+
function toTemplateVersion(ctx, options) {
|
|
3319
|
+
const refs = options.refs ?? "link";
|
|
3320
|
+
const withLine = (entry) => ({
|
|
3321
|
+
...entry,
|
|
3322
|
+
line: renderChangelogEntryLine(entry, refs, ctx.repoUrl)
|
|
3323
|
+
});
|
|
3324
|
+
const toTemplateSection = (s) => ({
|
|
3325
|
+
label: s.label,
|
|
3326
|
+
entries: s.items.map(withLine)
|
|
3327
|
+
});
|
|
3328
|
+
const { enhanced, sharedEntries, bundled, ...rest } = ctx;
|
|
3329
|
+
const { categories: _, ...prose } = enhanced ?? {};
|
|
3330
|
+
return {
|
|
3331
|
+
...rest,
|
|
3332
|
+
entries: ctx.entries.map(withLine),
|
|
3333
|
+
sections: versionSections(ctx, options.categoryOrder).map(toTemplateSection),
|
|
3334
|
+
shared: groupChangelogSections(sharedEntries ?? [], (e) => e).map(toTemplateSection),
|
|
3335
|
+
bundled: (bundled ?? []).map(({ entries, ...pkg }) => ({
|
|
3336
|
+
...pkg,
|
|
3337
|
+
sections: groupChangelogSections(entries, (e) => e).map(toTemplateSection)
|
|
3338
|
+
})),
|
|
3339
|
+
// Set even when absent: EJS throws on a bare `enhanced` that isn't a key.
|
|
3340
|
+
enhanced: prose.summary || prose.releaseNotes ? prose : void 0
|
|
3341
|
+
};
|
|
3342
|
+
}
|
|
3343
|
+
function createDocumentContext(contexts, repoUrl, options, sharedEntries = []) {
|
|
3344
|
+
const refs = options.refs ?? "link";
|
|
3287
3345
|
const compareUrls = {};
|
|
3288
3346
|
for (const ctx of contexts) {
|
|
3289
3347
|
if (ctx.compareUrl) {
|
|
@@ -3295,8 +3353,15 @@ function createDocumentContext(contexts, repoUrl) {
|
|
|
3295
3353
|
name: contexts[0]?.packageName ?? "project",
|
|
3296
3354
|
repoUrl
|
|
3297
3355
|
},
|
|
3298
|
-
versions: contexts,
|
|
3299
|
-
compareUrls: Object.keys(compareUrls).length > 0 ? compareUrls : void 0
|
|
3356
|
+
versions: contexts.map((ctx) => toTemplateVersion(ctx, options)),
|
|
3357
|
+
compareUrls: Object.keys(compareUrls).length > 0 ? compareUrls : void 0,
|
|
3358
|
+
shared: groupChangelogSections(sharedEntries, (e) => e).map((s) => ({
|
|
3359
|
+
label: s.label,
|
|
3360
|
+
entries: s.items.map((entry) => ({
|
|
3361
|
+
...entry,
|
|
3362
|
+
line: renderChangelogEntryLine(entry, refs, repoUrl ?? null)
|
|
3363
|
+
}))
|
|
3364
|
+
}))
|
|
3300
3365
|
};
|
|
3301
3366
|
}
|
|
3302
3367
|
async function processWithLLM(context, llmConfig, examples, packageNames) {
|
|
@@ -3410,10 +3475,21 @@ async function processWithLLM(context, llmConfig, examples, packageNames) {
|
|
|
3410
3475
|
function renderReleaseNotes(ctx, output, releaseNotesConfig, fmtOpts) {
|
|
3411
3476
|
if (releaseNotesConfig.templates?.path) {
|
|
3412
3477
|
const templatePath = path12.resolve(releaseNotesConfig.templates.path);
|
|
3413
|
-
const docCtx = {
|
|
3478
|
+
const docCtx = {
|
|
3479
|
+
...createDocumentContext([ctx], ctx.repoUrl ?? void 0, fmtOpts),
|
|
3480
|
+
perPackage: true,
|
|
3481
|
+
output
|
|
3482
|
+
};
|
|
3414
3483
|
return renderTemplate(templatePath, docCtx, releaseNotesConfig.templates.engine).content;
|
|
3415
3484
|
}
|
|
3416
|
-
|
|
3485
|
+
const refs = fmtOpts.refs ?? "link";
|
|
3486
|
+
const prose = ctx.enhanced?.releaseNotes;
|
|
3487
|
+
const own = prose ? [prose.trimEnd(), sharedPackageBlock(ctx, refs)] : [formatVersion(ctx, fmtOpts).trimEnd()];
|
|
3488
|
+
const blocks = [...own, ...renderBundledBlocks(ctx.bundled ?? [], 3, refs, ctx.repoUrl)].filter(
|
|
3489
|
+
(block) => !!block
|
|
3490
|
+
);
|
|
3491
|
+
return prose && blocks.length === 1 ? prose : `${blocks.join("\n\n")}
|
|
3492
|
+
`;
|
|
3417
3493
|
}
|
|
3418
3494
|
async function runPipeline(input, config, dryRun, pipelineOptions) {
|
|
3419
3495
|
debug(`Processing ${input.packages.length} package(s)`);
|
|
@@ -3450,19 +3526,17 @@ async function runPipeline(input, config, dryRun, pipelineOptions) {
|
|
|
3450
3526
|
const prCache = /* @__PURE__ */ new Map();
|
|
3451
3527
|
const pullRequestsEnabled = llmConfig.context?.pullRequests !== false;
|
|
3452
3528
|
if (pullRequestsEnabled && ownerRepo) {
|
|
3453
|
-
const
|
|
3454
|
-
...new Set(
|
|
3455
|
-
releaseNotesContexts.flatMap((ctx) => ctx.entries.flatMap((e) => parseIssueNumbers(e.issueIds ?? [])))
|
|
3456
|
-
)
|
|
3529
|
+
const allPrNumbers = [
|
|
3530
|
+
...new Set(releaseNotesContexts.flatMap((ctx) => ctx.entries.flatMap((e) => ownPrNumber(e) ?? [])))
|
|
3457
3531
|
];
|
|
3458
|
-
if (
|
|
3532
|
+
if (allPrNumbers.length > 0) {
|
|
3459
3533
|
const token = resolveGitHubToken();
|
|
3460
3534
|
if (!token) {
|
|
3461
3535
|
warn("No GitHub token available \u2014 skipping PR context fetch (set GITHUB_TOKEN to enable)");
|
|
3462
3536
|
} else {
|
|
3463
|
-
debug(`Fetching PR context for ${
|
|
3464
|
-
await fetchPullRequestContext(ownerRepo.owner, ownerRepo.repo,
|
|
3465
|
-
debug(`Loaded PR context for ${prCache.size}
|
|
3537
|
+
debug(`Fetching PR context for ${allPrNumbers.length} PR(s)`);
|
|
3538
|
+
await fetchPullRequestContext(ownerRepo.owner, ownerRepo.repo, allPrNumbers, token, prCache);
|
|
3539
|
+
debug(`Loaded PR context for ${prCache.size} PR(s)`);
|
|
3466
3540
|
}
|
|
3467
3541
|
}
|
|
3468
3542
|
}
|
|
@@ -3470,8 +3544,9 @@ async function runPipeline(input, config, dryRun, pipelineOptions) {
|
|
|
3470
3544
|
releaseNotesContexts = releaseNotesContexts.map((ctx) => ({
|
|
3471
3545
|
...ctx,
|
|
3472
3546
|
entries: ctx.entries.map((entry) => {
|
|
3473
|
-
const
|
|
3474
|
-
|
|
3547
|
+
const number = ownPrNumber(entry);
|
|
3548
|
+
const pr = number === void 0 ? void 0 : prCache.get(number);
|
|
3549
|
+
return pr ? { ...entry, context: { prs: [pr] } } : entry;
|
|
3475
3550
|
})
|
|
3476
3551
|
}));
|
|
3477
3552
|
}
|
|
@@ -3483,27 +3558,49 @@ async function runPipeline(input, config, dryRun, pipelineOptions) {
|
|
|
3483
3558
|
(ctx) => processWithLLM(ctx, llmConfig, examplesByPackage.get(ctx.packageName) ?? [], allPackageNames)
|
|
3484
3559
|
);
|
|
3485
3560
|
}
|
|
3561
|
+
const sharedEntries = input.sharedEntries ?? [];
|
|
3562
|
+
const packages = new Map(input.packages.map((pkg) => [pkg.packageName, pkg]));
|
|
3563
|
+
const withShared = (ctx) => {
|
|
3564
|
+
const pkg = packages.get(ctx.packageName);
|
|
3565
|
+
const shared = pkg ? sharedPackageEntriesOf(pkg, sharedEntries) : [];
|
|
3566
|
+
return shared.length > 0 ? { ...ctx, sharedEntries: shared } : ctx;
|
|
3567
|
+
};
|
|
3568
|
+
const releases = [...input.bundledReleases ?? [], ...input.packages];
|
|
3569
|
+
const withBundled = (ctx) => {
|
|
3570
|
+
const bundled = resolveBundled(packages.get(ctx.packageName)?.bundled, releases);
|
|
3571
|
+
if (bundled.length === 0) {
|
|
3572
|
+
return ctx;
|
|
3573
|
+
}
|
|
3574
|
+
const entries = ctx.entries.filter((e) => e.description !== `Update version to ${ctx.version}`);
|
|
3575
|
+
return { ...ctx, entries, bundled };
|
|
3576
|
+
};
|
|
3577
|
+
releaseNotesContexts = releaseNotesContexts.map(withShared).map(withBundled);
|
|
3486
3578
|
const files = [];
|
|
3487
3579
|
const fmtOpts = {
|
|
3488
3580
|
includePackageName: input.packages.length > 1 || changelogContexts.some((c) => c.packageName.includes("/")),
|
|
3489
3581
|
categoryOrder: llmConfig?.categoryOrder,
|
|
3490
3582
|
links: releaseNotesConfig?.links,
|
|
3491
3583
|
firstRelease: releaseNotesConfig?.firstRelease,
|
|
3492
|
-
refs: (
|
|
3584
|
+
refs: configuredRefsMode(config)
|
|
3493
3585
|
};
|
|
3494
3586
|
if (!pipelineOptions?.skipChangelogs && !releaseNotesFor && changelogConfig !== false && changelogConfig.mode) {
|
|
3495
3587
|
const fileName = changelogConfig.file ?? "CHANGELOG.md";
|
|
3496
3588
|
const mode = changelogConfig.mode;
|
|
3497
3589
|
const templates = changelogConfig.templates;
|
|
3498
|
-
const renderChangelog = (ctxs, options) => templates?.path ? renderTemplate(
|
|
3590
|
+
const renderChangelog = (ctxs, options, runSharedEntries) => templates?.path ? renderTemplate(
|
|
3499
3591
|
path12.resolve(templates.path),
|
|
3500
|
-
createDocumentContext(ctxs, ctxs[0]?.repoUrl ?? void 0),
|
|
3592
|
+
createDocumentContext(ctxs, ctxs[0]?.repoUrl ?? void 0, options, runSharedEntries),
|
|
3501
3593
|
templates.engine
|
|
3502
|
-
).content : renderMarkdown(ctxs, options);
|
|
3594
|
+
).content : renderMarkdown(ctxs, options, runSharedEntries);
|
|
3503
3595
|
info(`Generating changelog \u2192 ${fileName}`);
|
|
3504
3596
|
try {
|
|
3505
3597
|
if (mode === "root" || mode === "both") {
|
|
3506
|
-
|
|
3598
|
+
const runEntries = changelogContexts.flatMap((ctx) => ctx.entries);
|
|
3599
|
+
writeChangelog(
|
|
3600
|
+
fileName,
|
|
3601
|
+
renderChangelog(changelogContexts, fmtOpts, unlistedEntries(sharedEntries, runEntries)),
|
|
3602
|
+
dryRun
|
|
3603
|
+
);
|
|
3507
3604
|
if (!dryRun) {
|
|
3508
3605
|
files.push(fileName);
|
|
3509
3606
|
}
|
|
@@ -3511,7 +3608,7 @@ async function runPipeline(input, config, dryRun, pipelineOptions) {
|
|
|
3511
3608
|
if (mode === "packages" || mode === "both") {
|
|
3512
3609
|
const refs = fmtOpts.refs;
|
|
3513
3610
|
const monoFiles = await writeMonorepoFiles(
|
|
3514
|
-
changelogContexts,
|
|
3611
|
+
changelogContexts.map(withShared),
|
|
3515
3612
|
config,
|
|
3516
3613
|
dryRun,
|
|
3517
3614
|
fileName,
|
|
@@ -3543,7 +3640,7 @@ async function runPipeline(input, config, dryRun, pipelineOptions) {
|
|
|
3543
3640
|
const packageNotes = Object.fromEntries(
|
|
3544
3641
|
changelogContexts.map((ctx) => [
|
|
3545
3642
|
ctx.packageName,
|
|
3546
|
-
formatVersion(ctx, { firstRelease: releaseNotesConfig?.firstRelease })
|
|
3643
|
+
formatVersion(withShared(ctx), { firstRelease: releaseNotesConfig?.firstRelease })
|
|
3547
3644
|
])
|
|
3548
3645
|
);
|
|
3549
3646
|
const releaseNotesResult = {};
|
|
@@ -3571,7 +3668,7 @@ async function processInput(inputJson, config, dryRun, pipelineOptions) {
|
|
|
3571
3668
|
return runPipeline(input, config, dryRun, pipelineOptions);
|
|
3572
3669
|
}
|
|
3573
3670
|
async function writeMonorepoFiles(contexts, config, dryRun, fileName, render) {
|
|
3574
|
-
const { detectMonorepo: detectMonorepo2, writeMonorepoChangelogs } = await import("./aggregator-
|
|
3671
|
+
const { detectMonorepo: detectMonorepo2, writeMonorepoChangelogs } = await import("./aggregator-XM2XIYDF.js");
|
|
3575
3672
|
const cwd = process.cwd();
|
|
3576
3673
|
const detected = detectMonorepo2(cwd);
|
|
3577
3674
|
if (!detected.isMonorepo) {
|
package/dist/cli.js
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import {
|
|
3
3
|
createNotesCommand
|
|
4
|
-
} from "./chunk-
|
|
4
|
+
} from "./chunk-RGY5RDF2.js";
|
|
5
5
|
import {
|
|
6
6
|
readPackageVersion
|
|
7
|
-
} from "./chunk-
|
|
7
|
+
} from "./chunk-EI7LLVJN.js";
|
|
8
8
|
|
|
9
9
|
// src/cli.ts
|
|
10
10
|
import * as fs from "fs";
|
package/dist/index.d.ts
CHANGED
|
@@ -11,6 +11,13 @@ declare function loadAuth(): Record<string, string>;
|
|
|
11
11
|
declare function saveAuth(provider: string, apiKey: string): void;
|
|
12
12
|
|
|
13
13
|
type ChangelogRefsMode = 'strip' | 'escape' | 'link';
|
|
14
|
+
interface BundledPackage<T> {
|
|
15
|
+
packageName: string;
|
|
16
|
+
/** Set when the package released more than once in the range. */
|
|
17
|
+
firstVersion?: string;
|
|
18
|
+
version: string;
|
|
19
|
+
entries: T[];
|
|
20
|
+
}
|
|
14
21
|
|
|
15
22
|
declare abstract class ReleaseKitError extends Error {
|
|
16
23
|
abstract readonly code: string;
|
|
@@ -41,6 +48,8 @@ interface VersionChangelogEntry {
|
|
|
41
48
|
* extraction-error fallback, which isn't a no-change carry.
|
|
42
49
|
*/
|
|
43
50
|
synthetic?: boolean;
|
|
51
|
+
/** On a `sharedEntries` entry: its commit touched a `sharedPackages` package. Absent for a repo-level entry. */
|
|
52
|
+
sharedPackage?: boolean;
|
|
44
53
|
}
|
|
45
54
|
interface VersionPackageChangelog {
|
|
46
55
|
packageName: string;
|
|
@@ -51,6 +60,23 @@ interface VersionPackageChangelog {
|
|
|
51
60
|
entries: VersionChangelogEntry[];
|
|
52
61
|
/** The tag this changelog releases: the package's own, or a sync release's shared one. Absent in older manifests. */
|
|
53
62
|
tag?: string;
|
|
63
|
+
/**
|
|
64
|
+
* Entries from commits in this changelog's range that touch a `sharedPackages` package and no non-shared package,
|
|
65
|
+
* leaving out commits under this package's own directories. Recorded, possibly empty, by async-mode releases with
|
|
66
|
+
* shared packages; absent otherwise and in older manifests.
|
|
67
|
+
*/
|
|
68
|
+
sharedPackageEntries?: VersionChangelogEntry[];
|
|
69
|
+
/** A primary's bundled packages, each with the versions of that package the primary's notes include, oldest first. */
|
|
70
|
+
bundled?: VersionBundledPackage[];
|
|
71
|
+
}
|
|
72
|
+
interface VersionBundledPackage {
|
|
73
|
+
packageName: string;
|
|
74
|
+
versions: string[];
|
|
75
|
+
}
|
|
76
|
+
interface VersionBundledRelease {
|
|
77
|
+
packageName: string;
|
|
78
|
+
version: string;
|
|
79
|
+
entries: VersionChangelogEntry[];
|
|
54
80
|
}
|
|
55
81
|
/** `'graduated'`: a prerelease promoted to stable, ignoring any requested bump. `'first-release'`: no prior tag. */
|
|
56
82
|
type VersionAction = 'first-release' | 'graduated' | 'bumped';
|
|
@@ -68,6 +94,11 @@ interface VersionOutput {
|
|
|
68
94
|
/** Entries from commits that touch no package outside `sharedPackages`, counting the directories a package
|
|
69
95
|
* versions through `cargo.paths` / `pub.paths`. */
|
|
70
96
|
sharedEntries?: VersionChangelogEntry[];
|
|
97
|
+
/**
|
|
98
|
+
* Earlier releases a primary's `bundled` packages made since its previous release, each stored once however many
|
|
99
|
+
* primaries include it. A bundled package's release in this run is its own changelog record.
|
|
100
|
+
*/
|
|
101
|
+
bundledReleases?: VersionBundledRelease[];
|
|
71
102
|
commitMessage?: string;
|
|
72
103
|
/** Consumer-facing tags from `tagTemplate`. */
|
|
73
104
|
tags: string[];
|
|
@@ -142,6 +173,8 @@ interface ChangelogEntry {
|
|
|
142
173
|
originalType?: string;
|
|
143
174
|
breaking?: boolean;
|
|
144
175
|
leadIn?: string;
|
|
176
|
+
/** On a project-wide entry: its commit touched a `sharedPackages` package, so every package's notes list it. */
|
|
177
|
+
sharedPackage?: boolean;
|
|
145
178
|
/** Populated upstream of LLM tasks; never serialised to disk. */
|
|
146
179
|
context?: {
|
|
147
180
|
prs: PRContext[];
|
|
@@ -156,11 +189,19 @@ interface PackageChangelog {
|
|
|
156
189
|
repoUrl: string | null;
|
|
157
190
|
date: string;
|
|
158
191
|
entries: ChangelogEntry[];
|
|
192
|
+
sharedPackageEntries?: ChangelogEntry[];
|
|
193
|
+
bundled?: VersionBundledPackage[];
|
|
159
194
|
}
|
|
195
|
+
type BundledRelease = Omit<VersionBundledRelease, 'entries'> & {
|
|
196
|
+
entries: ChangelogEntry[];
|
|
197
|
+
};
|
|
160
198
|
type InputSource = 'version';
|
|
161
199
|
interface ChangelogInput {
|
|
162
200
|
source: InputSource;
|
|
163
201
|
packages: PackageChangelog[];
|
|
202
|
+
/** Project-wide entries, from commits that touch no package outside `sharedPackages`. */
|
|
203
|
+
sharedEntries?: ChangelogEntry[];
|
|
204
|
+
bundledReleases?: BundledRelease[];
|
|
164
205
|
metadata?: {
|
|
165
206
|
repoUrl?: string;
|
|
166
207
|
defaultBranch?: string;
|
|
@@ -185,15 +226,47 @@ interface TemplateContext {
|
|
|
185
226
|
compareUrl?: string;
|
|
186
227
|
enhanced?: EnhancedData;
|
|
187
228
|
isFirstRelease?: boolean;
|
|
229
|
+
/** Shared-package entries, listed after the version's own. */
|
|
230
|
+
sharedEntries?: ChangelogEntry[];
|
|
231
|
+
/** A primary's bundled packages. Release notes only: the changelog never lists them. */
|
|
232
|
+
bundled?: BundledPackage<ChangelogEntry>[];
|
|
233
|
+
}
|
|
234
|
+
interface TemplateEntry extends ChangelogEntry {
|
|
235
|
+
/** The built-in renderer's line: refs rendered, mentions and comment openers escaped. */
|
|
236
|
+
line: string;
|
|
237
|
+
}
|
|
238
|
+
interface TemplateSection {
|
|
239
|
+
label: string;
|
|
240
|
+
entries: TemplateEntry[];
|
|
241
|
+
}
|
|
242
|
+
/** What a template sees for one version. */
|
|
243
|
+
interface TemplateBundledPackage {
|
|
244
|
+
packageName: string;
|
|
245
|
+
/** Set when the package released more than once since the primary's previous release. */
|
|
246
|
+
firstVersion?: string;
|
|
247
|
+
version: string;
|
|
248
|
+
sections: TemplateSection[];
|
|
249
|
+
}
|
|
250
|
+
interface TemplateVersion extends Omit<TemplateContext, 'entries' | 'enhanced' | 'sharedEntries' | 'bundled'> {
|
|
251
|
+
entries: TemplateEntry[];
|
|
252
|
+
/** LLM categories when `categorize` ran, otherwise commit-type groups. Breaking leads unless `categoryOrder` places it. */
|
|
253
|
+
sections: TemplateSection[];
|
|
254
|
+
/** Shared-package entries in commit-type groups. Empty in a root changelog. */
|
|
255
|
+
shared: TemplateSection[];
|
|
256
|
+
/** A primary's bundled packages, each in commit-type groups. Empty outside release notes. */
|
|
257
|
+
bundled: TemplateBundledPackage[];
|
|
258
|
+
enhanced?: Omit<EnhancedData, 'categories'>;
|
|
188
259
|
}
|
|
189
260
|
interface DocumentContext {
|
|
190
261
|
project: {
|
|
191
262
|
name: string;
|
|
192
263
|
repoUrl?: string;
|
|
193
264
|
};
|
|
194
|
-
versions:
|
|
195
|
-
unreleased?:
|
|
265
|
+
versions: TemplateVersion[];
|
|
266
|
+
unreleased?: TemplateVersion;
|
|
196
267
|
compareUrls?: Record<string, string>;
|
|
268
|
+
/** A root changelog's project-wide entries for the run, in commit-type groups. Empty otherwise. */
|
|
269
|
+
shared: TemplateSection[];
|
|
197
270
|
/** Templates can use this to suppress document-level headings that are redundant
|
|
198
271
|
* when the content is embedded in a release that already shows the package/version. */
|
|
199
272
|
perPackage?: boolean;
|
|
@@ -317,6 +390,19 @@ interface ReleaseNotesConfig {
|
|
|
317
390
|
declare function loadConfig(projectDir?: string, configFile?: string): Config;
|
|
318
391
|
declare function getDefaultConfig(): Config;
|
|
319
392
|
|
|
393
|
+
interface FormatVersionOptions {
|
|
394
|
+
includePackageName?: boolean;
|
|
395
|
+
/** Order to render LLM-categorised sections. */
|
|
396
|
+
categoryOrder?: string[];
|
|
397
|
+
links?: LinksConfig;
|
|
398
|
+
firstRelease?: FirstReleaseConfig | false;
|
|
399
|
+
refs?: ChangelogRefsMode;
|
|
400
|
+
}
|
|
401
|
+
declare function formatVersion(context: TemplateContext, options?: FormatVersionOptions): string;
|
|
402
|
+
/** `sharedEntries` are listed once, after the versions, under a dated heading of their own. */
|
|
403
|
+
declare function renderMarkdown(contexts: TemplateContext[], options?: FormatVersionOptions, sharedEntries?: ChangelogEntry[]): string;
|
|
404
|
+
declare function writeChangelog(outputPath: string, content: string, dryRun: boolean): void;
|
|
405
|
+
|
|
320
406
|
declare function createTemplateContext(pkg: PackageChangelog): TemplateContext;
|
|
321
407
|
interface PipelineResult {
|
|
322
408
|
/** Per-package rendered markdown keyed by package name. */
|
|
@@ -378,7 +464,7 @@ declare class ConfigError extends NotesError {
|
|
|
378
464
|
}
|
|
379
465
|
declare function getExitCode(error: NotesError): number;
|
|
380
466
|
|
|
381
|
-
declare function versionOutputToChangelogInput(data: Pick<VersionOutput, 'changelogs'> & Partial<Pick<VersionOutput, 'updates' | 'tags'>>): ChangelogInput;
|
|
467
|
+
declare function versionOutputToChangelogInput(data: Pick<VersionOutput, 'changelogs'> & Partial<Pick<VersionOutput, 'updates' | 'tags' | 'sharedEntries' | 'bundledReleases'>>): ChangelogInput;
|
|
382
468
|
declare function parseVersionOutput(json: string): ChangelogInput;
|
|
383
469
|
declare function parseVersionOutputFile(filePath: string): ChangelogInput;
|
|
384
470
|
declare function parseVersionOutputStdin(): Promise<ChangelogInput>;
|
|
@@ -398,18 +484,6 @@ declare function detectMonorepo(cwd: string): {
|
|
|
398
484
|
declare function renderJson(contexts: TemplateContext[]): string;
|
|
399
485
|
declare function writeJson(outputPath: string, contexts: TemplateContext[], dryRun: boolean): void;
|
|
400
486
|
|
|
401
|
-
interface FormatVersionOptions {
|
|
402
|
-
includePackageName?: boolean;
|
|
403
|
-
/** Order to render LLM-categorised sections. */
|
|
404
|
-
categoryOrder?: string[];
|
|
405
|
-
links?: LinksConfig;
|
|
406
|
-
firstRelease?: FirstReleaseConfig | false;
|
|
407
|
-
refs?: ChangelogRefsMode;
|
|
408
|
-
}
|
|
409
|
-
declare function formatVersion(context: TemplateContext, options?: FormatVersionOptions): string;
|
|
410
|
-
declare function renderMarkdown(contexts: TemplateContext[], options?: FormatVersionOptions): string;
|
|
411
|
-
declare function writeChangelog(outputPath: string, content: string, dryRun: boolean): void;
|
|
412
|
-
|
|
413
487
|
/** `packageCount` is the release's, not the run's: see `writeVersionedNotes`. */
|
|
414
488
|
declare function nestsReleaseNotes(packageCount: number): boolean;
|
|
415
489
|
/**
|
|
@@ -423,4 +497,4 @@ declare function writeVersionedNotes<T extends {
|
|
|
423
497
|
}>(contexts: T[], directory: string, dryRun: boolean, nested: boolean, renderContent: (ctx: T) => string): string[];
|
|
424
498
|
|
|
425
499
|
export { ConfigError, GitHubError, InputParseError, InputValidationError, LLMError, NotesError, TemplateError, aggregateToRoot, createTemplateContext, detectMonorepo, formatVersion, getDefaultConfig, getExitCode, loadAuth, loadConfig, nestsReleaseNotes, parseVersionOutput, parseVersionOutputFile, parseVersionOutputStdin, processInput, renderJson, renderMarkdown, runPipeline, saveAuth, versionOutputToChangelogInput, writeChangelog, writeJson, writeMonorepoChangelogs, writeVersionedNotes };
|
|
426
|
-
export type { ChangelogConfig, ChangelogEntry, ChangelogInput, ChangelogType, CompleteOptions, Config, DocumentContext, EnhancedCategory, EnhancedData, FirstReleaseConfig, InputSource, JSONSchema, LLMCategory, LLMConfig, LLMOptions, LLMPromptOverrides, LLMPromptsConfig, LinksConfig, LocationMode, PRContext, PackageChangelog, PipelineOptions, PipelineResult, ReleaseNotesConfig, ReleaseNotesFileConfig, RetryOptions, ScopeConfig, ScopeRules, TemplateConfig, TemplateContext, TemplateEngine };
|
|
500
|
+
export type { BundledRelease, ChangelogConfig, ChangelogEntry, ChangelogInput, ChangelogType, CompleteOptions, Config, DocumentContext, EnhancedCategory, EnhancedData, FirstReleaseConfig, InputSource, JSONSchema, LLMCategory, LLMConfig, LLMOptions, LLMPromptOverrides, LLMPromptsConfig, LinksConfig, LocationMode, PRContext, PackageChangelog, PipelineOptions, PipelineResult, ReleaseNotesConfig, ReleaseNotesFileConfig, RetryOptions, ScopeConfig, ScopeRules, TemplateBundledPackage, TemplateConfig, TemplateContext, TemplateEngine, TemplateEntry, TemplateSection, TemplateVersion };
|
package/dist/index.js
CHANGED
|
@@ -21,7 +21,7 @@ import {
|
|
|
21
21
|
saveAuth,
|
|
22
22
|
versionOutputToChangelogInput,
|
|
23
23
|
writeVersionedNotes
|
|
24
|
-
} from "./chunk-
|
|
24
|
+
} from "./chunk-RGY5RDF2.js";
|
|
25
25
|
import {
|
|
26
26
|
aggregateToRoot,
|
|
27
27
|
debug,
|
|
@@ -32,7 +32,7 @@ import {
|
|
|
32
32
|
success,
|
|
33
33
|
writeChangelog,
|
|
34
34
|
writeMonorepoChangelogs
|
|
35
|
-
} from "./chunk-
|
|
35
|
+
} from "./chunk-EI7LLVJN.js";
|
|
36
36
|
|
|
37
37
|
// src/output/json.ts
|
|
38
38
|
import * as fs from "fs";
|
package/docs/llm-providers.md
CHANGED
|
@@ -143,7 +143,7 @@ Entry descriptions are processed in parallel (default concurrency: `5`). Adjust
|
|
|
143
143
|
{ "concurrency": 3 }
|
|
144
144
|
```
|
|
145
145
|
|
|
146
|
-
When `enhance` and `categorize` are both enabled, the pipeline runs a single combined `enhanceAndCategorize` call — see [Combined enhance + categorize](#combined-enhance--categorize). The combined call also generates `leadIn` phrases, scope assignments, and breaking flags. These drive
|
|
146
|
+
When `enhance` and `categorize` are both enabled, the pipeline runs a single combined `enhanceAndCategorize` call — see [Combined enhance + categorize](#combined-enhance--categorize). The combined call also generates `leadIn` phrases, scope assignments, and breaking flags. These drive breaking change re-routing and `**leadIn**: description` formatting in the built-in renderer, neither of which is available when running `enhance` alone. Routine fixes and bumps receive no `leadIn`.
|
|
147
147
|
|
|
148
148
|
### `summarize`
|
|
149
149
|
|
|
@@ -155,7 +155,7 @@ Generates a one-paragraph summary of the entire release, added to the template c
|
|
|
155
155
|
|
|
156
156
|
### `categorize`
|
|
157
157
|
|
|
158
|
-
Groups entries into user-friendly categories rather than conventional commit types. The result is available in templates as `
|
|
158
|
+
Groups entries into user-friendly categories rather than conventional commit types. The result is available in release-notes templates as `sections`.
|
|
159
159
|
|
|
160
160
|
```json
|
|
161
161
|
{ "tasks": { "categorize": true } }
|