Versionado semántico automático: de los commits a la versión y el changelog

1const lineas = require("fs").readFileSync(0, "utf8").split("\n");
2
3const RE_VERSION = /^v?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([a-z]+)\.(\d+))?$/;
4const RE_COMMIT = /^([a-z]+)(?:\(([^()\s]+)\))?(!)?: (\S.*)$/;
5const TIPOS = ["feat", "fix", "perf", "docs", "style", "refactor", "test", "build", "ci", "chore", "revert"];
6const NIVEL = { feat: 2, fix: 1, perf: 1 };            // 3 = major, 2 = minor, 1 = patch
7const SECCIONES = [["feat", "Nuevas funciones"], ["fix", "Correcciones"], ["perf", "Rendimiento"]];
8
9/** Lee los commits; un «BREAKING CHANGE: nota» se une al commit anterior. */
10function leerCommits(filas) {
11  const commits = [];
12  for (const fila of filas) {
13    const ruptura = /^BREAKING[ -]CHANGE: (.+)$/.exec(fila);
14    if (ruptura && commits.length) {
15      const ultimo = commits[commits.length - 1];
16      ultimo.rompe = true;
17      ultimo.nota = ruptura[1];
18      continue;
19    }
20    const m = RE_COMMIT.exec(fila);
21    if (!m) {
22      console.log(`Aviso: «${fila}» no sigue Conventional Commits`);
23      continue;
24    }
25    if (!TIPOS.includes(m[1])) {
26      console.log(`Aviso: tipo desconocido «${m[1]}» en «${fila}»`);
27      continue;
28    }
29    commits.push({ tipo: m[1], ambito: m[2], rompe: Boolean(m[3]), texto: m[4], nota: null });
30  }
31  return commits;
32}
33
34const linea = (c) => `- ${c.ambito ? `**${c.ambito}:** ` : ""}${c.texto}${c.nota ? ` — ${c.nota}` : ""}`;
35
36function main() {
37  const filas = lineas.map((l) => l.trim()).filter(Boolean);
38  const cabecera = /^version (\S+)$/.exec(filas[0] ?? "");
39  if (!cabecera) {
40    console.log("Falta la línea «version X.Y.Z»");
41    return;
42  }
43  const v = RE_VERSION.exec(cabecera[1]);
44  if (!v) {
45    console.log(`Versión no válida: ${cabecera[1]}`);
46    return;
47  }
48  let resto = filas.slice(1), canal = null;
49  const c = /^canal (\S+)$/.exec(resto[0] ?? "");
50  if (c) {
51    if (!/^[a-z]+$/.test(c[1])) {
52      console.log(`Canal no válido: ${c[1]}`);
53      return;
54    }
55    canal = c[1];
56    resto = resto.slice(1);
57  }
58  const [mayor, menor, parche] = v.slice(1, 4).map(Number);
59  const pre = v[4] ? { canal: v[4], n: Number(v[5]) } : null;
60  const actual = `${mayor}.${menor}.${parche}` + (pre ? `-${pre.canal}.${pre.n}` : "");
61  console.log(`Versión actual: ${actual}`);
62
63  const commits = leerCommits(resto);
64  let nivel = Math.max(0, ...commits.map((k) => (k.rompe ? 3 : NIVEL[k.tipo] ?? 0)));
65  if (nivel === 0) {
66    console.log("No hay cambios que publicar");
67    return;
68  }
69  const base = `${mayor}.${menor}.${parche}`;
70  let nueva, motivo;
71  if (pre) {
72    // una prerelease ya tiene decidida su versión base: solo cambia la etiqueta
73    if (canal === pre.canal) [nueva, motivo] = [`${base}-${canal}.${pre.n + 1}`, `nueva prerelease del canal ${canal}`];
74    else if (canal) [nueva, motivo] = [`${base}-${canal}.1`, `cambio al canal ${canal}`];
75    else [nueva, motivo] = [base, `se publica ${actual} como estable`];
76  } else {
77    // en 0.x todo puede cambiar: un cambio incompatible solo sube la minor
78    const cero = mayor === 0 && nivel === 3;
79    if (cero) nivel = 2;
80    nueva = nivel === 3 ? `${mayor + 1}.0.0` : nivel === 2 ? `${mayor}.${menor + 1}.0` : `${mayor}.${menor}.${parche + 1}`;
81    motivo = cero ? "minor: hay cambios incompatibles, pero la versión es 0.x"
82      : ["", "patch: solo hay correcciones", "minor: hay funciones nuevas", "major: hay cambios incompatibles"][nivel];
83    if (canal) {
84      nueva += `-${canal}.1`;
85      motivo += `; prerelease del canal ${canal}`;
86    }
87  }
88  console.log(`Siguiente versión: ${nueva} (${motivo})`);
89  console.log(`Etiqueta: v${nueva}`);
90  console.log(`## ${nueva}`);
91  const rompen = commits.filter((k) => k.rompe);
92  if (rompen.length) {
93    console.log("### Cambios incompatibles");
94    rompen.forEach((k) => console.log(linea(k)));
95  }
96  for (const [tipo, titulo] of SECCIONES) {
97    const lista = commits.filter((k) => k.tipo === tipo && !k.rompe);
98    if (lista.length === 0) continue;
99    console.log(`### ${titulo}`);
100    lista.forEach((k) => console.log(linea(k)));
101  }
102  const otros = commits.filter((k) => !k.rompe && !NIVEL[k.tipo]);
103  if (otros.length) console.log(`Otros cambios: ${otros.length} (${[...new Set(otros.map((k) => k.tipo))].sort().join(", ")})`);
104}
105
106main();