@cleocode/core 2.0.0

package/dist/release/changelog-writer.js

@@ -0,0 +1,151 @@
+/**
+ * Section-aware CHANGELOG writer with custom-log block support.
+ *
+ * @task T5579
+ * @epic T5576
+ */
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { atomicWrite } from '../store/atomic.js';
+// ── Custom-log block parsing ──────────────────────────────────────────
+/**
+ * Parse [custom-log]...[/custom-log] blocks from a CHANGELOG section.
+ * Returns the extracted block content (tags stripped) and the content
+ * with tags+content removed.
+ */
+export function parseChangelogBlocks(content) {
+    const customBlocks = [];
+    const blockRe = /\[custom-log\]([\s\S]*?)\[\/custom-log\]/gi;
+    for (const match of content.matchAll(blockRe)) {
+        const inner = match[1].trim();
+        if (inner.length > 0) {
+            customBlocks.push(inner);
+        }
+    }
+    const strippedContent = content.replace(/\[custom-log\][\s\S]*?\[\/custom-log\]/gi, '');
+    return { customBlocks, strippedContent };
+}
+// ── Section helpers ───────────────────────────────────────────────────
+/**
+ * Build the full section text for a given version.
+ */
+function buildSection(version, generatedContent, customBlocks) {
+    const date = new Date().toISOString().split('T')[0];
+    const lines = [];
+    lines.push(`## [${version}] (${date})`);
+    lines.push('');
+    lines.push(generatedContent.trimEnd());
+    if (customBlocks.length > 0) {
+        lines.push('');
+        for (const block of customBlocks) {
+            lines.push(block);
+            lines.push('');
+        }
+    }
+    lines.push('---');
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Write or update a CHANGELOG.md section for a specific version.
+ *
+ * - If ## [VERSION] section exists: replaces it in-place.
+ * - If not: prepends as new section after any top-level # heading.
+ * - Custom block content (from [custom-log] blocks) is appended after
+ *   generated content.
+ * - Section header format: '## [VERSION] (YYYY-MM-DD)'
+ */
+export async function writeChangelogSection(version, generatedContent, customBlocks, changelogPath) {
+    let existing = '';
+    if (existsSync(changelogPath)) {
+        existing = await readFile(changelogPath, 'utf8');
+    }
+    // Extract any custom blocks already stored in the existing section
+    const existingSection = extractExistingSection(existing, version);
+    const { customBlocks: existingCustomBlocks } = parseChangelogBlocks(existingSection);
+    // Merge: passed-in blocks first, then any unique blocks from file
+    const mergedBlocks = [...customBlocks];
+    for (const block of existingCustomBlocks) {
+        if (!mergedBlocks.includes(block)) {
+            mergedBlocks.push(block);
+        }
+    }
+    const newSection = buildSection(version, generatedContent, mergedBlocks);
+    const updated = replaceOrInsertSection(existing, version, newSection);
+    await atomicWrite(changelogPath, updated);
+}
+// ── Internal helpers ──────────────────────────────────────────────────
+/**
+ * Extract the existing section text for a version (empty string if none).
+ */
+function extractExistingSection(changelog, version) {
+    const escapedVersion = escapeRegex(version);
+    const sectionStart = new RegExp(`^## \\[?${escapedVersion}\\]?`, 'm');
+    const startMatch = sectionStart.exec(changelog);
+    if (!startMatch)
+        return '';
+    const fromStart = changelog.slice(startMatch.index);
+    const afterFirstLine = fromStart.indexOf('\n') + 1;
+    const nextSection = /^## /m.exec(fromStart.slice(afterFirstLine));
+    if (nextSection) {
+        return fromStart.slice(0, afterFirstLine + nextSection.index);
+    }
+    return fromStart;
+}
+/**
+ * Remove any ## [Unreleased] section from the changelog.
+ * Called before inserting a versioned section so stale [Unreleased] blocks
+ * don't remain alongside the real release entry.
+ */
+function removeUnreleasedSection(changelog) {
+    const unreleasedRe = /^## \[Unreleased\][^\n]*/im;
+    const match = unreleasedRe.exec(changelog);
+    if (!match)
+        return changelog;
+    const before = changelog.slice(0, match.index);
+    const fromStart = changelog.slice(match.index);
+    const afterFirstLine = fromStart.indexOf('\n') + 1;
+    const nextSection = /^## /m.exec(fromStart.slice(afterFirstLine));
+    if (nextSection) {
+        const after = fromStart.slice(afterFirstLine + nextSection.index);
+        return (before + after).replace(/\n{3,}/g, '\n\n');
+    }
+    // [Unreleased] was the last section — remove it entirely
+    return before.replace(/\n+$/, '\n\n');
+}
+/**
+ * Replace an existing section for version, or insert after the title heading.
+ * Also absorbs any [Unreleased] section, since the versioned section supersedes it.
+ */
+function replaceOrInsertSection(changelog, version, newSection) {
+    // Remove any [Unreleased] section so it doesn't coexist with the versioned one
+    const cleaned = removeUnreleasedSection(changelog);
+    const escapedVersion = escapeRegex(version);
+    const sectionStart = new RegExp(`^## \\[?${escapedVersion}\\]?`, 'm');
+    const startMatch = sectionStart.exec(cleaned);
+    if (startMatch) {
+        const before = cleaned.slice(0, startMatch.index);
+        const fromStart = cleaned.slice(startMatch.index);
+        const afterFirstLine = fromStart.indexOf('\n') + 1;
+        const nextSection = /^## /m.exec(fromStart.slice(afterFirstLine));
+        if (nextSection) {
+            const after = fromStart.slice(afterFirstLine + nextSection.index);
+            return before + newSection + after;
+        }
+        return before + newSection;
+    }
+    // Insert after top-level # heading if present
+    const titleMatch = /^# .+$/m.exec(cleaned);
+    if (titleMatch) {
+        const insertAt = titleMatch.index + titleMatch[0].length;
+        const rest = cleaned.slice(insertAt);
+        const trimmedRest = rest.startsWith('\n') ? rest.slice(1) : rest;
+        return cleaned.slice(0, insertAt) + '\n\n' + newSection + trimmedRest;
+    }
+    // No existing content — prepend
+    return newSection + cleaned;
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=changelog-writer.js.map

package/dist/release/changelog-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog-writer.js","sourceRoot":"","sources":["../../src/release/changelog-writer.ts"],"names":[],"mappings":"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"}

package/dist/release/channel.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Release channel resolution and validation.
+ *
+ * Maps Git branches to npm dist-tags and validates that version strings
+ * conform to the expectations of their target channel.
+ *
+ * @task T5586
+ */
+import type { ChannelConfig } from './release-config.js';
+export type { ChannelConfig };
+/** npm dist-tag channel for a release. */
+export type ReleaseChannel = 'latest' | 'beta' | 'alpha';
+/** Result of validating a version string against a channel's expectations. */
+export interface ChannelValidationResult {
+    valid: boolean;
+    expected?: string;
+    actual?: string;
+    message: string;
+}
+/** Return the default branch-to-channel mapping. */
+export declare function getDefaultChannelConfig(): ChannelConfig;
+/**
+ * Resolve the release channel for a given Git branch name.
+ *
+ * Resolution order:
+ * 1. Exact match in `config.custom`
+ * 2. Prefix match in `config.custom`
+ * 3. Exact match against `config.main` → 'latest'
+ * 4. Exact match against `config.develop` → 'beta'
+ * 5. Starts with 'feature/', 'hotfix/', 'release/', or `config.feature` → 'alpha'
+ * 6. Fallback → 'alpha'
+ */
+export declare function resolveChannelFromBranch(branch: string, config?: ChannelConfig): ReleaseChannel;
+/**
+ * Map a release channel to its npm dist-tag string.
+ *
+ * Kept as an explicit function (rather than a direct cast) so that callers
+ * remain decoupled from the string values and the mapping can be extended
+ * without changing call sites.
+ */
+export declare function channelToDistTag(channel: ReleaseChannel): string;
+/**
+ * Validate that a version string satisfies the pre-release conventions for
+ * the given channel.
+ *
+ * Rules:
+ * - 'latest': version must NOT contain '-' (no pre-release suffix)
+ * - 'beta':   version must contain '-beta' or '-rc'
+ * - 'alpha':  version must contain '-alpha', '-dev', '-rc', or '-beta'
+ */
+export declare function validateVersionChannel(version: string, channel: ReleaseChannel): ChannelValidationResult;
+/** Return a human-readable description of the given release channel. */
+export declare function describeChannel(channel: ReleaseChannel): string;
+//# sourceMappingURL=channel.d.ts.map

package/dist/release/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/release/channel.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B,0CAA0C;AAC1C,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzD,8EAA8E;AAC9E,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oDAAoD;AACpD,wBAAgB,uBAAuB,IAAI,aAAa,CAMvD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,cAAc,CA8C/F;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAOhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,GACtB,uBAAuB,CA6CzB;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAO/D"}

package/dist/release/channel.js

@@ -0,0 +1,144 @@
+/**
+ * Release channel resolution and validation.
+ *
+ * Maps Git branches to npm dist-tags and validates that version strings
+ * conform to the expectations of their target channel.
+ *
+ * @task T5586
+ */
+/** Return the default branch-to-channel mapping. */
+export function getDefaultChannelConfig() {
+    return {
+        main: 'main',
+        develop: 'develop',
+        feature: 'feature/',
+    };
+}
+/**
+ * Resolve the release channel for a given Git branch name.
+ *
+ * Resolution order:
+ * 1. Exact match in `config.custom`
+ * 2. Prefix match in `config.custom`
+ * 3. Exact match against `config.main` → 'latest'
+ * 4. Exact match against `config.develop` → 'beta'
+ * 5. Starts with 'feature/', 'hotfix/', 'release/', or `config.feature` → 'alpha'
+ * 6. Fallback → 'alpha'
+ */
+export function resolveChannelFromBranch(branch, config) {
+    const cfg = config ?? getDefaultChannelConfig();
+    // 1. Exact match in custom map
+    if (cfg.custom) {
+        if (Object.hasOwn(cfg.custom, branch)) {
+            return cfg.custom[branch];
+        }
+        // 2. Prefix match in custom map (longest matching prefix wins)
+        let bestPrefix = '';
+        let bestChannel;
+        for (const [key, channel] of Object.entries(cfg.custom)) {
+            if (branch.startsWith(key) && key.length > bestPrefix.length) {
+                bestPrefix = key;
+                bestChannel = channel;
+            }
+        }
+        if (bestChannel !== undefined) {
+            return bestChannel;
+        }
+    }
+    // 3. Exact match against main branch → stable
+    if (branch === cfg.main) {
+        return 'latest';
+    }
+    // 4. Exact match against develop branch → beta
+    if (branch === cfg.develop) {
+        return 'beta';
+    }
+    // 5. Well-known prefixes and configured feature prefix → alpha
+    const alphaPrefixes = ['feature/', 'hotfix/', 'release/'];
+    if (cfg.feature && !alphaPrefixes.includes(cfg.feature)) {
+        alphaPrefixes.push(cfg.feature);
+    }
+    for (const prefix of alphaPrefixes) {
+        if (branch.startsWith(prefix)) {
+            return 'alpha';
+        }
+    }
+    // 6. Default fallback
+    return 'alpha';
+}
+/**
+ * Map a release channel to its npm dist-tag string.
+ *
+ * Kept as an explicit function (rather than a direct cast) so that callers
+ * remain decoupled from the string values and the mapping can be extended
+ * without changing call sites.
+ */
+export function channelToDistTag(channel) {
+    const tags = {
+        latest: 'latest',
+        beta: 'beta',
+        alpha: 'alpha',
+    };
+    return tags[channel];
+}
+/**
+ * Validate that a version string satisfies the pre-release conventions for
+ * the given channel.
+ *
+ * Rules:
+ * - 'latest': version must NOT contain '-' (no pre-release suffix)
+ * - 'beta':   version must contain '-beta' or '-rc'
+ * - 'alpha':  version must contain '-alpha', '-dev', '-rc', or '-beta'
+ */
+export function validateVersionChannel(version, channel) {
+    switch (channel) {
+        case 'latest': {
+            if (version.includes('-')) {
+                return {
+                    valid: false,
+                    expected: 'no pre-release suffix (e.g. 2026.3.16)',
+                    actual: version,
+                    message: `Version "${version}" has a pre-release suffix but channel is 'latest'. Stable releases must not include '-'.`,
+                };
+            }
+            return { valid: true, message: 'ok' };
+        }
+        case 'beta': {
+            const hasBetaOrRc = version.includes('-beta') || version.includes('-rc');
+            if (!hasBetaOrRc) {
+                return {
+                    valid: false,
+                    expected: 'pre-release suffix containing -beta or -rc (e.g. 2026.3.16-beta.1)',
+                    actual: version,
+                    message: `Version "${version}" does not contain '-beta' or '-rc' required for the 'beta' channel.`,
+                };
+            }
+            return { valid: true, message: 'ok' };
+        }
+        case 'alpha': {
+            const hasAlphaSuffix = version.includes('-alpha') ||
+                version.includes('-dev') ||
+                version.includes('-rc') ||
+                version.includes('-beta');
+            if (!hasAlphaSuffix) {
+                return {
+                    valid: false,
+                    expected: 'pre-release suffix containing -alpha, -dev, -rc, or -beta (e.g. 2026.3.16-alpha.1)',
+                    actual: version,
+                    message: `Version "${version}" does not contain a recognized pre-release suffix for the 'alpha' channel.`,
+                };
+            }
+            return { valid: true, message: 'ok' };
+        }
+    }
+}
+/** Return a human-readable description of the given release channel. */
+export function describeChannel(channel) {
+    const descriptions = {
+        latest: 'stable release published to npm @latest',
+        beta: 'pre-release published to npm @beta (develop branch)',
+        alpha: 'early pre-release published to npm @alpha (feature/hotfix branches)',
+    };
+    return descriptions[channel];
+}
+//# sourceMappingURL=channel.js.map

package/dist/release/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../src/release/channel.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH,oDAAoD;AACpD,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,UAAU;KACpB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAc,EAAE,MAAsB;IAC7E,MAAM,GAAG,GAAG,MAAM,IAAI,uBAAuB,EAAE,CAAC;IAEhD,+BAA+B;IAC/B,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACf,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;YACtC,OAAO,GAAG,CAAC,MAAM,CAAC,MAAM,CAAmB,CAAC;QAC9C,CAAC;QAED,+DAA+D;QAC/D,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,IAAI,WAAuC,CAAC;QAC5C,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACxD,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;gBAC7D,UAAU,GAAG,GAAG,CAAC;gBACjB,WAAW,GAAG,OAAyB,CAAC;YAC1C,CAAC;QACH,CAAC;QACD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,WAAW,CAAC;QACrB,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,IAAI,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC;QACxB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,+CAA+C;IAC/C,IAAI,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,+DAA+D;IAC/D,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC1D,IAAI,GAAG,CAAC,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACxD,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAuB;IACtD,MAAM,IAAI,GAAmC;QAC3C,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,OAAO;KACf,CAAC;IACF,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAe,EACf,OAAuB;IAEvB,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO;oBACL,KAAK,EAAE,KAAK;oBACZ,QAAQ,EAAE,wCAAwC;oBAClD,MAAM,EAAE,OAAO;oBACf,OAAO,EAAE,YAAY,OAAO,2FAA2F;iBACxH,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACxC,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACzE,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,OAAO;oBACL,KAAK,EAAE,KAAK;oBACZ,QAAQ,EAAE,oEAAoE;oBAC9E,MAAM,EAAE,OAAO;oBACf,OAAO,EAAE,YAAY,OAAO,sEAAsE;iBACnG,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACxC,CAAC;QAED,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,cAAc,GAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;gBACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC5B,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,OAAO;oBACL,KAAK,EAAE,KAAK;oBACZ,QAAQ,EACN,oFAAoF;oBACtF,MAAM,EAAE,OAAO;oBACf,OAAO,EAAE,YAAY,OAAO,6EAA6E;iBAC1G,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACxC,CAAC;IACH,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,eAAe,CAAC,OAAuB;IACrD,MAAM,YAAY,GAAmC;QACnD,MAAM,EAAE,yCAAyC;QACjD,IAAI,EAAE,qDAAqD;QAC3D,KAAK,EAAE,qEAAqE;KAC7E,CAAC;IACF,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC"}

package/dist/release/ci.d.ts

@@ -0,0 +1,35 @@
+/**
+ * CI/CD template generation for release workflows.
+ *
+ * Generates platform-specific CI/CD configurations (GitHub Actions,
+ * GitLab CI, CircleCI) from templates and project configuration.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Supported CI/CD platforms. */
+export type CIPlatform = 'github-actions' | 'gitlab-ci' | 'circleci';
+/** All supported platforms. */
+export declare const SUPPORTED_PLATFORMS: CIPlatform[];
+/** Get the output path for a CI platform. */
+export declare function getPlatformPath(platform: CIPlatform): string;
+/** Detect the CI platform from the project. */
+export declare function detectCIPlatform(projectDir?: string): CIPlatform | null;
+/** Generate CI config for a platform. */
+export declare function generateCIConfig(platform: CIPlatform, cwd?: string): string;
+/** Write CI config to the appropriate path. */
+export declare function writeCIConfig(platform: CIPlatform, options?: {
+    projectDir?: string;
+    dryRun?: boolean;
+}): {
+    action: string;
+    path: string;
+    content: string;
+};
+/** Validate an existing CI config. */
+export declare function validateCIConfig(platform: CIPlatform, projectDir?: string): {
+    valid: boolean;
+    exists: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=ci.d.ts.map

package/dist/release/ci.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci.d.ts","sourceRoot":"","sources":["../../src/release/ci.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,iCAAiC;AACjC,MAAM,MAAM,UAAU,GAAG,gBAAgB,GAAG,WAAW,GAAG,UAAU,CAAC;AAErE,+BAA+B;AAC/B,eAAO,MAAM,mBAAmB,EAAE,UAAU,EAAgD,CAAC;AAS7F,6CAA6C;AAC7C,wBAAgB,eAAe,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,CAE5D;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAOvE;AAmGD,yCAAyC;AACzC,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAY3E;AAED,+CAA+C;AAC/C,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,UAAU,EACpB,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACtD;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAanD;AAED,sCAAsC;AACtC,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,UAAU,EACpB,UAAU,CAAC,EAAE,MAAM,GAClB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAiBvD"}

package/dist/release/ci.js

@@ -0,0 +1,166 @@
+/**
+ * CI/CD template generation for release workflows.
+ *
+ * Generates platform-specific CI/CD configurations (GitHub Actions,
+ * GitLab CI, CircleCI) from templates and project configuration.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { loadReleaseConfig } from './release-config.js';
+/** All supported platforms. */
+export const SUPPORTED_PLATFORMS = ['github-actions', 'gitlab-ci', 'circleci'];
+/** Platform-specific output paths. */
+const PLATFORM_PATHS = {
+    'github-actions': '.github/workflows/release.yml',
+    'gitlab-ci': '.gitlab-ci.yml',
+    circleci: '.circleci/config.yml',
+};
+/** Get the output path for a CI platform. */
+export function getPlatformPath(platform) {
+    return PLATFORM_PATHS[platform];
+}
+/** Detect the CI platform from the project. */
+export function detectCIPlatform(projectDir) {
+    const dir = projectDir ?? process.cwd();
+    if (existsSync(join(dir, '.github')))
+        return 'github-actions';
+    if (existsSync(join(dir, '.gitlab-ci.yml')))
+        return 'gitlab-ci';
+    if (existsSync(join(dir, '.circleci')))
+        return 'circleci';
+    return null;
+}
+/** Generate GitHub Actions workflow YAML. */
+function generateGitHubActions(config) {
+    const gateSteps = config.gates
+        .map((g) => `      - name: ${g.name}\n        run: ${g.command}`)
+        .join('\n');
+    return `name: Release
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      - name: Install dependencies
+        run: npm ci
+${gateSteps}
+      - name: Create Release
+        uses: softprops/action-gh-release@v1
+        with:
+          generate_release_notes: true
+`;
+}
+/** Generate GitLab CI YAML. */
+function generateGitLabCI(config) {
+    const stages = config.gates.map((g) => g.name.toLowerCase().replace(/\s+/g, '-'));
+    return `stages:
+  - test
+  - release
+${stages.map((s) => `  - ${s}`).join('\n')}
+
+${config.gates
+        .map((g) => `${g.name.toLowerCase().replace(/\s+/g, '-')}:
+  stage: ${g.name.toLowerCase().replace(/\s+/g, '-')}
+  script:
+    - ${g.command}`)
+        .join('\n\n')}
+
+release:
+  stage: release
+  only:
+    - tags
+  script:
+    - echo "Creating release"
+`;
+}
+/** Generate CircleCI config YAML. */
+function generateCircleCI(config) {
+    return `version: 2.1
+
+jobs:
+  test:
+    docker:
+      - image: cimg/node:20.0
+    steps:
+      - checkout
+      - run: npm ci
+${config.gates.map((g) => `      - run:\n          name: ${g.name}\n          command: ${g.command}`).join('\n')}
+
+  release:
+    docker:
+      - image: cimg/node:20.0
+    steps:
+      - checkout
+      - run: echo "Creating release"
+
+workflows:
+  release:
+    jobs:
+      - test:
+          filters:
+            tags:
+              only: /^v.*/
+      - release:
+          requires:
+            - test
+          filters:
+            tags:
+              only: /^v.*/
+`;
+}
+/** Generate CI config for a platform. */
+export function generateCIConfig(platform, cwd) {
+    const releaseConfig = loadReleaseConfig(cwd);
+    const gates = releaseConfig.gates.map((g) => ({ name: g.name, command: g.command }));
+    switch (platform) {
+        case 'github-actions':
+            return generateGitHubActions({ gates });
+        case 'gitlab-ci':
+            return generateGitLabCI({ gates });
+        case 'circleci':
+            return generateCircleCI({ gates });
+    }
+}
+/** Write CI config to the appropriate path. */
+export function writeCIConfig(platform, options = {}) {
+    const projectDir = options.projectDir ?? process.cwd();
+    const outputPath = join(projectDir, getPlatformPath(platform));
+    const content = generateCIConfig(platform, projectDir);
+    if (options.dryRun) {
+        return { action: 'would_write', path: outputPath, content };
+    }
+    mkdirSync(dirname(outputPath), { recursive: true });
+    writeFileSync(outputPath, content, 'utf-8');
+    return { action: 'wrote', path: outputPath, content };
+}
+/** Validate an existing CI config. */
+export function validateCIConfig(platform, projectDir) {
+    const dir = projectDir ?? process.cwd();
+    const configPath = join(dir, getPlatformPath(platform));
+    if (!existsSync(configPath)) {
+        return { valid: false, exists: false, errors: ['Config file not found'] };
+    }
+    const errors = [];
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        if (!content.trim())
+            errors.push('Config file is empty');
+    }
+    catch (err) {
+        errors.push(`Cannot read config: ${String(err)}`);
+    }
+    return { valid: errors.length === 0, exists: true, errors };
+}
+//# sourceMappingURL=ci.js.map

package/dist/release/ci.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci.js","sourceRoot":"","sources":["../../src/release/ci.ts"],"names":[],"mappings":"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"}

package/dist/release/github-pr.d.ts

@@ -0,0 +1,63 @@
+export interface BranchProtectionResult {
+    protected: boolean;
+    detectionMethod: 'gh-api' | 'push-dry-run' | 'unknown';
+    error?: string;
+}
+export interface PRCreateOptions {
+    base: string;
+    head: string;
+    title: string;
+    body: string;
+    labels?: string[];
+    version: string;
+    epicId?: string;
+    projectRoot?: string;
+}
+export interface PRResult {
+    mode: 'created' | 'manual' | 'skipped';
+    prUrl?: string;
+    prNumber?: number;
+    instructions?: string;
+    error?: string;
+}
+export interface RepoIdentity {
+    owner: string;
+    repo: string;
+}
+/**
+ * Check if the `gh` CLI is available by attempting to run `gh --version`.
+ * Does NOT use `which` to remain cross-platform.
+ */
+export declare function isGhCliAvailable(): boolean;
+/**
+ * Parse a GitHub remote URL (HTTPS or SSH) into owner and repo components.
+ * Returns null if the URL cannot be parsed.
+ *
+ * Supported formats:
+ *   https://github.com/owner/repo.git
+ *   https://github.com/owner/repo
+ *   git@github.com:owner/repo.git
+ *   git@github.com:owner/repo
+ */
+export declare function extractRepoOwnerAndName(remote: string): RepoIdentity | null;
+/**
+ * Detect whether a branch has protection rules enabled.
+ *
+ * Strategy 1 (preferred): use `gh api` to query GitHub branch protection.
+ * Strategy 2 (fallback): use `git push --dry-run` and inspect stderr.
+ */
+export declare function detectBranchProtection(branch: string, remote: string, projectRoot?: string): Promise<BranchProtectionResult>;
+/**
+ * Build the markdown body for a GitHub pull request.
+ */
+export declare function buildPRBody(opts: PRCreateOptions): string;
+/**
+ * Format human-readable instructions for creating a PR manually.
+ */
+export declare function formatManualPRInstructions(opts: PRCreateOptions): string;
+/**
+ * Create a GitHub pull request using the `gh` CLI, or return manual instructions
+ * if the CLI is unavailable or the operation fails.
+ */
+export declare function createPullRequest(opts: PRCreateOptions): Promise<PRResult>;
+//# sourceMappingURL=github-pr.d.ts.map

package/dist/release/github-pr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-pr.d.ts","sourceRoot":"","sources":["../../src/release/github-pr.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAO1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAgB3E;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,sBAAsB,CAAC,CAgFjC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAezD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAexE;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAuEhF"}