ai-release-notes 0.0.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.
Files changed (59) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +261 -0
  3. package/dist/bin/cli.d.ts +6 -0
  4. package/dist/bin/cli.d.ts.map +1 -0
  5. package/dist/bin/cli.js +723 -0
  6. package/dist/bin/cli.js.map +1 -0
  7. package/dist/config.d.ts +23 -0
  8. package/dist/config.d.ts.map +1 -0
  9. package/dist/config.js +176 -0
  10. package/dist/config.js.map +1 -0
  11. package/dist/context.d.ts +11 -0
  12. package/dist/context.d.ts.map +1 -0
  13. package/dist/context.js +58 -0
  14. package/dist/context.js.map +1 -0
  15. package/dist/generator.d.ts +21 -0
  16. package/dist/generator.d.ts.map +1 -0
  17. package/dist/generator.js +258 -0
  18. package/dist/generator.js.map +1 -0
  19. package/dist/git.d.ts +28 -0
  20. package/dist/git.d.ts.map +1 -0
  21. package/dist/git.js +116 -0
  22. package/dist/git.js.map +1 -0
  23. package/dist/index.d.ts +15 -0
  24. package/dist/index.d.ts.map +1 -0
  25. package/dist/index.js +36 -0
  26. package/dist/index.js.map +1 -0
  27. package/dist/llm.d.ts +23 -0
  28. package/dist/llm.d.ts.map +1 -0
  29. package/dist/llm.js +105 -0
  30. package/dist/llm.js.map +1 -0
  31. package/dist/output-index.d.ts +13 -0
  32. package/dist/output-index.d.ts.map +1 -0
  33. package/dist/output-index.js +53 -0
  34. package/dist/output-index.js.map +1 -0
  35. package/dist/prompts/builder.d.ts +26 -0
  36. package/dist/prompts/builder.d.ts.map +1 -0
  37. package/dist/prompts/builder.js +82 -0
  38. package/dist/prompts/builder.js.map +1 -0
  39. package/dist/prompts/translation-system.md +8 -0
  40. package/dist/release.d.ts +37 -0
  41. package/dist/release.d.ts.map +1 -0
  42. package/dist/release.js +288 -0
  43. package/dist/release.js.map +1 -0
  44. package/dist/types.d.ts +224 -0
  45. package/dist/types.d.ts.map +1 -0
  46. package/dist/types.js +78 -0
  47. package/dist/types.js.map +1 -0
  48. package/dist/version.d.ts +3 -0
  49. package/dist/version.d.ts.map +1 -0
  50. package/dist/version.js +10 -0
  51. package/dist/version.js.map +1 -0
  52. package/package.json +63 -0
  53. package/prompts/release-notes-instructions.md +21 -0
  54. package/prompts/release-notes-system.md +7 -0
  55. package/prompts/release-notes-translation-system.md +20 -0
  56. package/templates/default-release-note.html +133 -0
  57. package/templates/default-release-note.md +8 -0
  58. package/templates/default-release-summary.html +126 -0
  59. package/templates/default-release-summary.md +11 -0
@@ -0,0 +1,288 @@
1
+ "use strict";
2
+ /**
3
+ * Release note formatting
4
+ */
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.renderOutputIndexLanguageSwitcher = renderOutputIndexLanguageSwitcher;
7
+ exports.applyOutputIndexLanguageSwitcher = applyOutputIndexLanguageSwitcher;
8
+ exports.hasOutputIndexLanguageSwitcher = hasOutputIndexLanguageSwitcher;
9
+ exports.insertOrUpdateOutputIndexReleaseEntry = insertOrUpdateOutputIndexReleaseEntry;
10
+ exports.formatReleaseNote = formatReleaseNote;
11
+ exports.renderReleaseNoteHtml = renderReleaseNoteHtml;
12
+ exports.markdownToHtml = markdownToHtml;
13
+ const version_js_1 = require("./version.js");
14
+ const OUTPUT_INDEX_LANGUAGES_MARKER = "<!-- ai-release-notes:languages -->";
15
+ const OUTPUT_INDEX_LANGUAGES_END_MARKER = "<!-- ai-release-notes:/languages -->";
16
+ /** Render links between the localized variants of an output index. */
17
+ function renderOutputIndexLanguageSwitcher(format, links) {
18
+ const uniqueLinks = links.filter((link, index) => links.findIndex((candidate) => candidate.language === link.language) === index);
19
+ if (uniqueLinks.length < 2) {
20
+ return `${OUTPUT_INDEX_LANGUAGES_MARKER}\n${OUTPUT_INDEX_LANGUAGES_END_MARKER}`;
21
+ }
22
+ const options = uniqueLinks.map((link) => {
23
+ const label = link.language.toUpperCase();
24
+ const href = link.href.replaceAll("(", "%28").replaceAll(")", "%29");
25
+ if (format === "html") {
26
+ return link.active
27
+ ? ` <span class="language-option is-active" aria-current="page">${escapeHtml(label)}</span>`
28
+ : ` <a class="language-option" href="${escapeHtml(href)}">${escapeHtml(label)}</a>`;
29
+ }
30
+ return link.active
31
+ ? `**${escapeMarkdownLabel(label)}**`
32
+ : `[${escapeMarkdownLabel(label)}](${href})`;
33
+ });
34
+ const selector = format === "html"
35
+ ? `<nav class="language-switcher" aria-label="Languages">\n${options.join("\n")}\n</nav>`
36
+ : options.join(" · ");
37
+ return `${OUTPUT_INDEX_LANGUAGES_MARKER}\n${selector}\n${OUTPUT_INDEX_LANGUAGES_END_MARKER}`;
38
+ }
39
+ /** Replace either supported template token, or refresh an existing switcher block. */
40
+ function applyOutputIndexLanguageSwitcher(content, switcher) {
41
+ const languageSlot = /<!-- ai-release-notes:languages -->[\s\S]*?<!-- ai-release-notes:\/languages -->|\{\{languages\}\}|\{\{langages\}\}/g;
42
+ let rendered = false;
43
+ return content.replace(languageSlot, () => {
44
+ if (rendered)
45
+ return "";
46
+ rendered = true;
47
+ return switcher;
48
+ });
49
+ }
50
+ /** Whether an index already provides a generated switcher region or template slot. */
51
+ function hasOutputIndexLanguageSwitcher(content) {
52
+ return /<!-- ai-release-notes:languages -->[\s\S]*?<!-- ai-release-notes:\/languages -->|\{\{languages\}\}|\{\{langages\}\}/.test(content);
53
+ }
54
+ /** Insert a new index entry or replace the matching release without consuming later template content. */
55
+ function insertOrUpdateOutputIndexReleaseEntry(existing, entry, releaseId) {
56
+ const marker = `<!-- ai-release-notes:release ${releaseId} -->`;
57
+ const entryPattern = new RegExp(`${escapeRegExp(marker)}[\\s\\S]*?` +
58
+ `(?=(?:<br>)?\\s*<!-- ai-release-notes:(?:release [^>]+|/releases|languages) -->|` +
59
+ `\\n\\s*(?:---\\s*\\n|</main>|<footer\\b)|$)`);
60
+ if (entryPattern.test(existing)) {
61
+ return existing.replace(entryPattern, entry);
62
+ }
63
+ const releasesMarker = "<!-- ai-release-notes:releases -->";
64
+ if (existing.includes(releasesMarker)) {
65
+ return existing.replace(releasesMarker, `${releasesMarker}\n${entry}`);
66
+ }
67
+ return existing.trimEnd() + "\n\n" + entry + "\n";
68
+ }
69
+ /**
70
+ * Format the final release note with header.
71
+ */
72
+ function formatReleaseNote(llmOutput, params) {
73
+ const project = params.projectName ? `${params.projectName} · ` : "";
74
+ const header = `# ${project}Release ${params.toVersion}
75
+
76
+ _${params.environment} · ${params.date} · Changes since ${params.fromVersion}_
77
+
78
+ ---
79
+
80
+ `;
81
+ return header + llmOutput.trim();
82
+ }
83
+ /** Render a release note inside an HTML template. */
84
+ function renderReleaseNoteHtml(template, content, params) {
85
+ const title = `${params.projectName ? params.projectName + " · " : ""}Release ${params.toVersion}`;
86
+ return template
87
+ .replaceAll("{{title}}", escapeHtml(title))
88
+ .replaceAll("{{projectName}}", escapeHtml(params.projectName || ""))
89
+ .replaceAll("{{fromVersion}}", escapeHtml(params.fromVersion))
90
+ .replaceAll("{{toVersion}}", escapeHtml(params.toVersion))
91
+ .replaceAll("{{environment}}", escapeHtml(params.environment))
92
+ .replaceAll("{{date}}", escapeHtml(params.date))
93
+ .replaceAll("{{version}}", version_js_1.AI_RELEASE_NOTES_VERSION)
94
+ .replaceAll("{{content}}", renderMarkdown(content));
95
+ }
96
+ /** Convert Markdown to self-contained, browser-friendly HTML. */
97
+ function markdownToHtml(markdown, title = "Release Notes", footer = "") {
98
+ const html = renderMarkdown(markdown);
99
+ return `<!DOCTYPE html>
100
+ <html lang="en">
101
+ <head>
102
+ <meta charset="utf-8">
103
+ <meta name="viewport" content="width=device-width, initial-scale=1">
104
+ <title>${escapeHtml(title)}</title>
105
+ <style>
106
+ :root { color-scheme: light dark; --page: #ffffff; --surface: #f6f7f8; --text: #202124; --muted: #5f6368; --line: #d9dde3; --link: #1558d6; }
107
+ @media (prefers-color-scheme: dark) { :root { --page: #181a1b; --surface: #242729; --text: #e8eaed; --muted: #b8bec5; --line: #3c4043; --link: #8ab4f8; } }
108
+ * { box-sizing: border-box; }
109
+ html { background: var(--page); }
110
+ body { max-width: 54rem; margin: 0 auto; padding: 3rem 1.5rem; background: var(--page); color: var(--text); font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; font-size: 1rem; line-height: 1.65; }
111
+ main { min-width: 0; }
112
+ h1, h2, h3, h4, h5, h6 { color: var(--text); line-height: 1.25; letter-spacing: -0.015em; }
113
+ h1 { margin: 0 0 1.75rem; font-size: clamp(1.9rem, 4vw, 2.6rem); }
114
+ h2 { margin: 2.25rem 0 0.85rem; padding-bottom: 0.45rem; border-bottom: 1px solid var(--line); font-size: 1.4rem; }
115
+ h3 { margin: 1.75rem 0 0.65rem; font-size: 1.1rem; }
116
+ h4 { margin: 1.5rem 0 0.55rem; font-size: 1rem; }
117
+ h5, h6 { margin: 1.25rem 0 0.45rem; font-size: 0.95rem; }
118
+ p { margin: 0.85rem 0; }
119
+ section { margin: 2rem 0; }
120
+ .release-entry { margin: 1.25rem 0; padding: 1.35rem 1.5rem; border: 1px solid var(--line); border-radius: 0.75rem; background: var(--surface); }
121
+ .release-entry h2 { margin: 0; padding: 0; border: 0; font-size: 1.2rem; }
122
+ .release-meta { margin: 0.45rem 0 1rem; color: var(--muted); font-size: 0.925rem; }
123
+ .release-link { margin: 0; font-weight: 600; }
124
+ ul, ol { margin: 0.85rem 0; padding-left: 1.35rem; }
125
+ li + li { margin-top: 0.35rem; }
126
+ a { color: var(--link); text-decoration-thickness: 1px; text-underline-offset: 0.16em; }
127
+ a:hover { text-decoration-thickness: 2px; }
128
+ blockquote { margin: 1.25rem 0; padding: 0.15rem 0 0.15rem 1rem; border-left: 3px solid var(--line); color: var(--muted); }
129
+ code { padding: 0.12em 0.35em; border-radius: 0.3rem; background: var(--surface); font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; font-size: 0.9em; }
130
+ pre { margin: 1.25rem 0; padding: 1rem; overflow-x: auto; border: 1px solid var(--line); border-radius: 0.6rem; background: var(--surface); }
131
+ pre code { padding: 0; background: none; font-size: 0.875rem; }
132
+ hr { height: 1px; margin: 2.5rem 0; border: 0; background: var(--line); }
133
+ footer { margin-top: 2.5rem; padding-top: 1rem; border-top: 1px solid var(--line); color: var(--muted); font-size: 0.875rem; }
134
+ </style>
135
+ </head>
136
+ <body>
137
+ <main>
138
+ ${html}
139
+ ${footer}
140
+ </main>
141
+ </body>
142
+ </html>`;
143
+ }
144
+ function renderMarkdown(markdown) {
145
+ const output = [];
146
+ const paragraph = [];
147
+ const codeLines = [];
148
+ const listStack = [];
149
+ let inCodeBlock = false;
150
+ const closeList = () => {
151
+ while (listStack.length > 0) {
152
+ const list = listStack.pop();
153
+ if (list.itemOpen)
154
+ output.push("</li>");
155
+ output.push(`</${list.type}>`);
156
+ }
157
+ };
158
+ const closeParagraph = () => {
159
+ if (paragraph.length > 0)
160
+ output.push(`<p>${inlineMarkdown(paragraph.join(" "))}</p>`);
161
+ paragraph.length = 0;
162
+ };
163
+ const closeCodeBlock = () => {
164
+ output.push(`<pre><code>${escapeHtml(codeLines.join("\n"))}</code></pre>`);
165
+ codeLines.length = 0;
166
+ inCodeBlock = false;
167
+ };
168
+ const openListItem = (type, indent, content) => {
169
+ let current = listStack.at(-1);
170
+ while (current && indent < current.indent) {
171
+ const list = listStack.pop();
172
+ if (list.itemOpen)
173
+ output.push("</li>");
174
+ output.push(`</${list.type}>`);
175
+ current = listStack.at(-1);
176
+ }
177
+ if (!current || indent > current.indent) {
178
+ output.push(`<${type}>`);
179
+ current = { type, indent, itemOpen: false };
180
+ listStack.push(current);
181
+ }
182
+ else if (current.type !== type) {
183
+ if (current.itemOpen)
184
+ output.push("</li>");
185
+ output.push(`</${current.type}>`);
186
+ listStack.pop();
187
+ output.push(`<${type}>`);
188
+ current = { type, indent, itemOpen: false };
189
+ listStack.push(current);
190
+ }
191
+ else if (current.itemOpen) {
192
+ output.push("</li>");
193
+ }
194
+ output.push(`<li>${inlineMarkdown(content)}`);
195
+ current.itemOpen = true;
196
+ };
197
+ for (const line of markdown.replace(/\r\n/g, "\n").split("\n")) {
198
+ if (/^\s*(```|~~~)/.test(line)) {
199
+ if (inCodeBlock)
200
+ closeCodeBlock();
201
+ else {
202
+ closeParagraph();
203
+ closeList();
204
+ inCodeBlock = true;
205
+ }
206
+ continue;
207
+ }
208
+ if (inCodeBlock) {
209
+ codeLines.push(line);
210
+ continue;
211
+ }
212
+ if (!line.trim()) {
213
+ closeParagraph();
214
+ closeList();
215
+ continue;
216
+ }
217
+ const heading = /^\s{0,3}(#{1,6})\s+(.+)$/.exec(line);
218
+ const listItem = /^(\s*)[-+*]\s+(.+)$/.exec(line);
219
+ const numberedItem = /^(\s*)\d+[.)]\s+(.+)$/.exec(line);
220
+ if (heading) {
221
+ closeParagraph();
222
+ closeList();
223
+ const level = heading[1].length;
224
+ const title = heading[2].replace(/\s+#+\s*$/, "");
225
+ output.push(`<h${level}>${inlineMarkdown(title)}</h${level}>`);
226
+ }
227
+ else if (/^(?:[-*_]\s*){3,}$/.test(line.trim())) {
228
+ closeParagraph();
229
+ closeList();
230
+ output.push("<hr>");
231
+ }
232
+ else if (listItem || numberedItem) {
233
+ closeParagraph();
234
+ const nextListType = numberedItem ? "ol" : "ul";
235
+ const indentation = (listItem?.[1] || numberedItem?.[1] || "").replace(/\t/g, " ").length;
236
+ const content = listItem?.[2] || numberedItem?.[2] || "";
237
+ openListItem(nextListType, indentation, content);
238
+ }
239
+ else if (/^\s{0,3}>\s?/.test(line)) {
240
+ closeParagraph();
241
+ closeList();
242
+ output.push(`<blockquote>${inlineMarkdown(line.replace(/^\s{0,3}>\s?/, ""))}</blockquote>`);
243
+ }
244
+ else if (/^<!--.*-->$/.test(line.trim()) || /^<\/?[a-z][\s\S]*>$/i.test(line.trim())) {
245
+ closeParagraph();
246
+ closeList();
247
+ output.push(line);
248
+ }
249
+ else {
250
+ closeList();
251
+ paragraph.push(line.trim());
252
+ }
253
+ }
254
+ if (inCodeBlock)
255
+ closeCodeBlock();
256
+ closeParagraph();
257
+ closeList();
258
+ return output.join("\n");
259
+ }
260
+ function inlineMarkdown(value) {
261
+ const codeTokens = [];
262
+ const rendered = escapeHtml(value)
263
+ .replace(/`([^`]+)`/g, (_match, code) => {
264
+ const token = `\u0000CODE_${codeTokens.length}\u0000`;
265
+ codeTokens.push(`<code>${code}</code>`);
266
+ return token;
267
+ })
268
+ .replace(/\[([^\]]+)\]\(([^\s)]+)\)/g, '<a href="$2">$1</a>')
269
+ .replace(/\*\*\*(.+?)\*\*\*/g, "<strong><em>$1</em></strong>")
270
+ .replace(/\*\*(.+?)\*\*/g, "<strong>$1</strong>")
271
+ .replace(/\*(.+?)\*/g, "<em>$1</em>")
272
+ .replace(/(^|[^\w])_([^\s](?:.*?[^\s])?)_(?!\w)/g, "$1<em>$2</em>");
273
+ return codeTokens.reduce((html, code, index) => html.replace(`\u0000CODE_${index}\u0000`, code), rendered);
274
+ }
275
+ function escapeHtml(value) {
276
+ return value
277
+ .replaceAll("&", "&amp;")
278
+ .replaceAll("<", "&lt;")
279
+ .replaceAll(">", "&gt;")
280
+ .replaceAll('"', "&quot;");
281
+ }
282
+ function escapeMarkdownLabel(value) {
283
+ return value.replace(/[\\[\]*_`]/g, "\\$&");
284
+ }
285
+ function escapeRegExp(value) {
286
+ return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
287
+ }
288
+ //# sourceMappingURL=release.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"release.js","sourceRoot":"","sources":["../src/release.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,224 @@
1
+ /**
2
+ * Core types for ai-release-notes
3
+ */
4
+ import { z } from "zod";
5
+ export interface ParsedCommit {
6
+ hash: string;
7
+ type: string;
8
+ scope?: string;
9
+ message: string;
10
+ body?: string;
11
+ author: string;
12
+ date: string;
13
+ }
14
+ export declare const ProviderConfigSchema: z.ZodObject<{
15
+ model: z.ZodOptional<z.ZodString>;
16
+ baseURL: z.ZodOptional<z.ZodString>;
17
+ temperature: z.ZodOptional<z.ZodNumber>;
18
+ maxTokens: z.ZodOptional<z.ZodNumber>;
19
+ }, z.core.$strip>;
20
+ export type ProviderConfig = z.infer<typeof ProviderConfigSchema>;
21
+ export type ProviderName = "openai" | "anthropic" | "mistral" | "google" | "azure-openai" | "ollama";
22
+ export declare const InstructionsConfigSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
23
+ file: z.ZodString;
24
+ }, z.core.$strip>]>;
25
+ export type InstructionsConfig = z.infer<typeof InstructionsConfigSchema>;
26
+ export declare const PromptConfigSchema: z.ZodObject<{
27
+ system: z.ZodOptional<z.ZodString>;
28
+ user: z.ZodOptional<z.ZodString>;
29
+ languages: z.ZodDefault<z.ZodArray<z.ZodString>>;
30
+ instructions: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
31
+ file: z.ZodString;
32
+ }, z.core.$strip>]>>;
33
+ }, z.core.$strip>;
34
+ export type PromptConfig = z.infer<typeof PromptConfigSchema>;
35
+ export declare const GitConfigSchema: z.ZodObject<{
36
+ commitFormat: z.ZodDefault<z.ZodEnum<{
37
+ conventional: "conventional";
38
+ raw: "raw";
39
+ }>>;
40
+ excludeTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
41
+ maxCommits: z.ZodDefault<z.ZodNumber>;
42
+ }, z.core.$strip>;
43
+ export declare const OutputConfigSchema: z.ZodObject<{
44
+ format: z.ZodDefault<z.ZodEnum<{
45
+ html: "html";
46
+ markdown: "markdown";
47
+ }>>;
48
+ template: z.ZodOptional<z.ZodString>;
49
+ saveTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
50
+ clipboard: z.ZodDefault<z.ZodBoolean>;
51
+ }, z.core.$strip>;
52
+ export declare const OutputsConfigSchema: z.ZodUnion<readonly [z.ZodObject<{
53
+ format: z.ZodDefault<z.ZodEnum<{
54
+ html: "html";
55
+ markdown: "markdown";
56
+ }>>;
57
+ template: z.ZodOptional<z.ZodString>;
58
+ saveTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
59
+ clipboard: z.ZodDefault<z.ZodBoolean>;
60
+ }, z.core.$strip>, z.ZodArray<z.ZodObject<{
61
+ format: z.ZodDefault<z.ZodEnum<{
62
+ html: "html";
63
+ markdown: "markdown";
64
+ }>>;
65
+ template: z.ZodOptional<z.ZodString>;
66
+ saveTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
67
+ clipboard: z.ZodDefault<z.ZodBoolean>;
68
+ }, z.core.$strip>>]>;
69
+ export declare const OutputIndexConfigSchema: z.ZodObject<{
70
+ format: z.ZodDefault<z.ZodEnum<{
71
+ html: "html";
72
+ markdown: "markdown";
73
+ }>>;
74
+ template: z.ZodOptional<z.ZodString>;
75
+ templateLanguage: z.ZodDefault<z.ZodString>;
76
+ saveTo: z.ZodString;
77
+ }, z.core.$strip>;
78
+ export declare const OutputIndexesConfigSchema: z.ZodUnion<readonly [z.ZodObject<{
79
+ format: z.ZodDefault<z.ZodEnum<{
80
+ html: "html";
81
+ markdown: "markdown";
82
+ }>>;
83
+ template: z.ZodOptional<z.ZodString>;
84
+ templateLanguage: z.ZodDefault<z.ZodString>;
85
+ saveTo: z.ZodString;
86
+ }, z.core.$strip>, z.ZodArray<z.ZodObject<{
87
+ format: z.ZodDefault<z.ZodEnum<{
88
+ html: "html";
89
+ markdown: "markdown";
90
+ }>>;
91
+ template: z.ZodOptional<z.ZodString>;
92
+ templateLanguage: z.ZodDefault<z.ZodString>;
93
+ saveTo: z.ZodString;
94
+ }, z.core.$strip>>]>;
95
+ export declare const ReleaseNotesConfigSchema: z.ZodObject<{
96
+ projectName: z.ZodOptional<z.ZodString>;
97
+ provider: z.ZodDefault<z.ZodString>;
98
+ providers: z.ZodRecord<z.ZodString, z.ZodObject<{
99
+ model: z.ZodOptional<z.ZodString>;
100
+ baseURL: z.ZodOptional<z.ZodString>;
101
+ temperature: z.ZodOptional<z.ZodNumber>;
102
+ maxTokens: z.ZodOptional<z.ZodNumber>;
103
+ }, z.core.$strip>>;
104
+ prompt: z.ZodOptional<z.ZodObject<{
105
+ system: z.ZodOptional<z.ZodString>;
106
+ user: z.ZodOptional<z.ZodString>;
107
+ languages: z.ZodDefault<z.ZodArray<z.ZodString>>;
108
+ instructions: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
109
+ file: z.ZodString;
110
+ }, z.core.$strip>]>>;
111
+ }, z.core.$strip>>;
112
+ git: z.ZodOptional<z.ZodObject<{
113
+ commitFormat: z.ZodDefault<z.ZodEnum<{
114
+ conventional: "conventional";
115
+ raw: "raw";
116
+ }>>;
117
+ excludeTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
118
+ maxCommits: z.ZodDefault<z.ZodNumber>;
119
+ }, z.core.$strip>>;
120
+ output: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
121
+ format: z.ZodDefault<z.ZodEnum<{
122
+ html: "html";
123
+ markdown: "markdown";
124
+ }>>;
125
+ template: z.ZodOptional<z.ZodString>;
126
+ saveTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
127
+ clipboard: z.ZodDefault<z.ZodBoolean>;
128
+ }, z.core.$strip>, z.ZodArray<z.ZodObject<{
129
+ format: z.ZodDefault<z.ZodEnum<{
130
+ html: "html";
131
+ markdown: "markdown";
132
+ }>>;
133
+ template: z.ZodOptional<z.ZodString>;
134
+ saveTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
135
+ clipboard: z.ZodDefault<z.ZodBoolean>;
136
+ }, z.core.$strip>>]>>;
137
+ outputIndex: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
138
+ format: z.ZodDefault<z.ZodEnum<{
139
+ html: "html";
140
+ markdown: "markdown";
141
+ }>>;
142
+ template: z.ZodOptional<z.ZodString>;
143
+ templateLanguage: z.ZodDefault<z.ZodString>;
144
+ saveTo: z.ZodString;
145
+ }, z.core.$strip>, z.ZodArray<z.ZodObject<{
146
+ format: z.ZodDefault<z.ZodEnum<{
147
+ html: "html";
148
+ markdown: "markdown";
149
+ }>>;
150
+ template: z.ZodOptional<z.ZodString>;
151
+ templateLanguage: z.ZodDefault<z.ZodString>;
152
+ saveTo: z.ZodString;
153
+ }, z.core.$strip>>]>>;
154
+ }, z.core.$strip>;
155
+ export type ReleaseNotesConfig = z.infer<typeof ReleaseNotesConfigSchema>;
156
+ export interface ContextFile {
157
+ path: string;
158
+ content: string;
159
+ }
160
+ export interface GenerateOptions {
161
+ /** Previous version tag (e.g. "v1.0.0") */
162
+ fromVersion: string;
163
+ /** Current version tag (e.g. "v1.1.0") */
164
+ toVersion: string;
165
+ /** Environment name: PROD, QUA, DEV, etc. */
166
+ environment: string;
167
+ /** Explicit display date. Prefer releaseDate for a date selector. */
168
+ date?: string;
169
+ /** Release date selector: "now", "tag", or an ISO date such as "2026-07-20". */
170
+ releaseDate?: string;
171
+ /** Override LLM provider */
172
+ provider?: ProviderName | string;
173
+ /** Path to config file */
174
+ configPath?: string;
175
+ /** Raw changelog text (skip git extraction) */
176
+ changelog?: string;
177
+ /** Path to a changelog file (skip git extraction) */
178
+ changelogFile?: string;
179
+ /** Dry-run: show prompt without calling LLM */
180
+ dryRun?: boolean;
181
+ /** Copy result to clipboard */
182
+ clipboard?: boolean;
183
+ /** Output file path */
184
+ outputPath?: string;
185
+ /** Output folder (default: current dir) */
186
+ outputDir?: string;
187
+ /** Output format: md or html */
188
+ format?: "md" | "html";
189
+ /** Template file path (Handlebars/Mustache) */
190
+ template?: string;
191
+ /**
192
+ * Context files or directories to include in the prompt.
193
+ * Files are loaded directly. Directories are scanned recursively.
194
+ * Example: ["./specs/api.md", "./docs/models/"]
195
+ */
196
+ context?: string[];
197
+ }
198
+ export interface GenerateResult {
199
+ markdown: string;
200
+ html?: string;
201
+ localized: Array<{
202
+ language: string;
203
+ markdown: string;
204
+ html?: string;
205
+ }>;
206
+ metadata: {
207
+ fromVersion: string;
208
+ toVersion: string;
209
+ environment: string;
210
+ date: string;
211
+ provider: string;
212
+ commitCount: number;
213
+ contextFiles?: string[];
214
+ usage: GenerationUsage;
215
+ };
216
+ }
217
+ export interface GenerationUsage {
218
+ inputTokens: number;
219
+ outputTokens: number;
220
+ totalTokens: number;
221
+ modelCalls: number;
222
+ durationMs: number;
223
+ }
224
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/dist/types.js ADDED
@@ -0,0 +1,78 @@
1
+ "use strict";
2
+ /**
3
+ * Core types for ai-release-notes
4
+ */
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.ReleaseNotesConfigSchema = exports.OutputIndexesConfigSchema = exports.OutputIndexConfigSchema = exports.OutputsConfigSchema = exports.OutputConfigSchema = exports.GitConfigSchema = exports.PromptConfigSchema = exports.InstructionsConfigSchema = exports.ProviderConfigSchema = void 0;
7
+ const zod_1 = require("zod");
8
+ // ─────────────────────────────────────────
9
+ // Provider configuration
10
+ // ─────────────────────────────────────────
11
+ exports.ProviderConfigSchema = zod_1.z.object({
12
+ model: zod_1.z.string().optional(),
13
+ baseURL: zod_1.z.string().url().optional(),
14
+ temperature: zod_1.z.number().min(0).max(2).optional(),
15
+ maxTokens: zod_1.z.number().positive().optional(),
16
+ });
17
+ // ─────────────────────────────────────────
18
+ // Instructions — can be inline text or a file path
19
+ // ─────────────────────────────────────────
20
+ exports.InstructionsConfigSchema = zod_1.z.union([
21
+ zod_1.z.string(), // inline instructions
22
+ zod_1.z.object({
23
+ file: zod_1.z.string(),
24
+ }),
25
+ ]);
26
+ // ─────────────────────────────────────────
27
+ // Prompt configuration
28
+ // ─────────────────────────────────────────
29
+ exports.PromptConfigSchema = zod_1.z.object({
30
+ system: zod_1.z.string().optional(),
31
+ user: zod_1.z.string().optional(),
32
+ languages: zod_1.z.array(zod_1.z.string().min(1)).min(1).default(["en"]),
33
+ /**
34
+ * Additional instructions for the LLM.
35
+ * Can be:
36
+ * - A string (inline instructions)
37
+ * - { file: "path/to/instructions.md" } (load from file)
38
+ */
39
+ instructions: exports.InstructionsConfigSchema.optional(),
40
+ });
41
+ // ─────────────────────────────────────────
42
+ // Full configuration schema
43
+ // ─────────────────────────────────────────
44
+ exports.GitConfigSchema = zod_1.z.object({
45
+ commitFormat: zod_1.z.enum(["conventional", "raw"]).default("conventional"),
46
+ excludeTypes: zod_1.z.array(zod_1.z.string()).optional(),
47
+ maxCommits: zod_1.z.number().positive().default(200),
48
+ });
49
+ exports.OutputConfigSchema = zod_1.z.object({
50
+ format: zod_1.z.enum(["markdown", "html"]).default("markdown"),
51
+ template: zod_1.z.string().optional(),
52
+ saveTo: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string()).min(1)]).optional(),
53
+ clipboard: zod_1.z.boolean().default(false),
54
+ });
55
+ exports.OutputsConfigSchema = zod_1.z.union([
56
+ exports.OutputConfigSchema,
57
+ zod_1.z.array(exports.OutputConfigSchema).min(1),
58
+ ]);
59
+ exports.OutputIndexConfigSchema = zod_1.z.object({
60
+ format: zod_1.z.enum(["markdown", "html"]).default("markdown"),
61
+ template: zod_1.z.string().optional(),
62
+ templateLanguage: zod_1.z.string().min(2).default("en"),
63
+ saveTo: zod_1.z.string().min(1),
64
+ });
65
+ exports.OutputIndexesConfigSchema = zod_1.z.union([
66
+ exports.OutputIndexConfigSchema,
67
+ zod_1.z.array(exports.OutputIndexConfigSchema).min(1),
68
+ ]);
69
+ exports.ReleaseNotesConfigSchema = zod_1.z.object({
70
+ projectName: zod_1.z.string().min(1).optional(),
71
+ provider: zod_1.z.string().default("openai"),
72
+ providers: zod_1.z.record(zod_1.z.string(), exports.ProviderConfigSchema),
73
+ prompt: exports.PromptConfigSchema.optional(),
74
+ git: exports.GitConfigSchema.optional(),
75
+ output: exports.OutputsConfigSchema.optional(),
76
+ outputIndex: exports.OutputIndexesConfigSchema.optional(),
77
+ });
78
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ /** Package version used by built-in templates and the CLI. */
2
+ export declare const AI_RELEASE_NOTES_VERSION: string;
3
+ //# sourceMappingURL=version.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAEA,8DAA8D;AAC9D,eAAO,MAAM,wBAAwB,QAAsB,CAAC"}
@@ -0,0 +1,10 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.AI_RELEASE_NOTES_VERSION = void 0;
7
+ const package_json_1 = __importDefault(require("../package.json"));
8
+ /** Package version used by built-in templates and the CLI. */
9
+ exports.AI_RELEASE_NOTES_VERSION = package_json_1.default.version;
10
+ //# sourceMappingURL=version.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":";;;;;;AAAA,mEAA0C;AAE1C,8DAA8D;AACjD,QAAA,wBAAwB,GAAG,sBAAW,CAAC,OAAO,CAAC"}