@cleocode/core 2026.3.76 → 2026.4.0

package/dist/release/artifacts.js

@@ -0,0 +1,427 @@
+/**
+ * Release artifact management - pluggable artifact handlers.
+ * Ported from lib/release/release-artifacts.sh
+ *
+ * Provides a registry of artifact type handlers for build, validate,
+ * and publish operations across multiple package ecosystems.
+ *
+ * @task T4552
+ * @epic T4545
+ */
+import { execFile } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+/**
+ * Check if a command exists on the system.
+ * @task T4552
+ */
+async function commandExists(cmd) {
+    try {
+        await execFileAsync('which', [cmd]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Execute a shell command and return the result.
+ * @task T4552
+ */
+async function execCommand(command, dryRun) {
+    if (dryRun) {
+        return { success: true, output: `[DRY RUN] Would execute: ${command}`, dryRun: true };
+    }
+    try {
+        const { stdout, stderr } = await execFileAsync('sh', ['-c', command], {
+            timeout: 300_000,
+        });
+        return { success: true, output: (stdout + stderr).trim(), dryRun: false };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { success: false, output: message, dryRun: false };
+    }
+}
+// ============================================================================
+// HANDLER: generic-tarball
+// ============================================================================
+/** @task T4552 */
+const genericTarballHandler = {
+    async build(config, dryRun = false) {
+        const buildCommand = config.buildCommand ??
+            `tar czf release-${new Date().toISOString().replace(/[:.]/g, '-')}.tar.gz --exclude=.git --exclude=.cleo --exclude=node_modules .`;
+        return execCommand(buildCommand, dryRun);
+    },
+    async validate(config) {
+        if (config.buildCommand) {
+            // Just check syntax validity
+            try {
+                await execFileAsync('sh', ['-n', '-c', config.buildCommand]);
+                return { success: true, output: 'Build command syntax valid', dryRun: false };
+            }
+            catch {
+                return { success: false, output: 'Invalid build command syntax', dryRun: false };
+            }
+        }
+        return { success: true, output: 'No build command to validate', dryRun: false };
+    },
+    async publish(config, dryRun = false) {
+        if (!config.publishCommand) {
+            return {
+                success: true,
+                output: 'No publish command specified. Skipping publish.',
+                dryRun: false,
+            };
+        }
+        return execCommand(config.publishCommand, dryRun);
+    },
+};
+// ============================================================================
+// HANDLER: npm-package
+// ============================================================================
+/** @task T4552 */
+const npmPackageHandler = {
+    async build(config, dryRun = false) {
+        if (!config.buildCommand) {
+            return {
+                success: true,
+                output: 'No build command specified. Skipping build step.',
+                dryRun: false,
+            };
+        }
+        return execCommand(config.buildCommand, dryRun);
+    },
+    async validate(config) {
+        const packageFile = config.package ?? 'package.json';
+        if (!existsSync(packageFile)) {
+            return { success: false, output: `package.json not found: ${packageFile}`, dryRun: false };
+        }
+        try {
+            const content = JSON.parse(readFileSync(packageFile, 'utf-8'));
+            const requiredFields = ['name', 'version', 'description', 'license'];
+            const missing = requiredFields.filter((f) => !content[f]);
+            if (missing.length > 0) {
+                return {
+                    success: false,
+                    output: `package.json missing required fields: ${missing.join(', ')}`,
+                    dryRun: false,
+                };
+            }
+            // Validate package name format
+            const packageName = content.name;
+            if (!/^(@[a-z0-9~-][a-z0-9._~-]*\/)?[a-z0-9~-][a-z0-9._~-]*$/.test(packageName)) {
+                return {
+                    success: false,
+                    output: `Invalid npm package name: ${packageName}`,
+                    dryRun: false,
+                };
+            }
+            return { success: true, output: 'npm package validation passed', dryRun: false };
+        }
+        catch {
+            return { success: false, output: `Failed to parse ${packageFile}`, dryRun: false };
+        }
+    },
+    async publish(config, dryRun = false) {
+        let publishCommand = config.publishCommand ?? 'npm publish';
+        if (config.options?.provenance) {
+            publishCommand += ' --provenance';
+        }
+        if (config.options?.access) {
+            publishCommand += ` --access ${config.options.access}`;
+        }
+        if (config.options?.tag) {
+            publishCommand += ` --tag ${config.options.tag}`;
+        }
+        return execCommand(publishCommand, dryRun);
+    },
+};
+// ============================================================================
+// HANDLER: python-wheel
+// ============================================================================
+/** @task T4552 */
+const pythonWheelHandler = {
+    async build(config, dryRun = false) {
+        const buildCommand = config.buildCommand ?? 'python -m build';
+        return execCommand(buildCommand, dryRun);
+    },
+    async validate(config) {
+        const packageFile = config.package ?? 'pyproject.toml';
+        if (!existsSync(packageFile) && !existsSync('setup.py')) {
+            return { success: false, output: 'Neither pyproject.toml nor setup.py found', dryRun: false };
+        }
+        if (!(await commandExists('python'))) {
+            return { success: false, output: 'python command not found', dryRun: false };
+        }
+        return { success: true, output: 'Python wheel validation passed', dryRun: false };
+    },
+    async publish(config, dryRun = false) {
+        let publishCommand = config.publishCommand ?? 'twine upload dist/*';
+        if (config.options?.attestations) {
+            publishCommand += ' --attestations';
+        }
+        return execCommand(publishCommand, dryRun);
+    },
+};
+// ============================================================================
+// HANDLER: python-sdist
+// ============================================================================
+/** @task T4552 */
+const pythonSdistHandler = {
+    async build(config, dryRun = false) {
+        const buildCommand = config.buildCommand ?? 'python -m build --sdist';
+        return execCommand(buildCommand, dryRun);
+    },
+    validate: pythonWheelHandler.validate,
+    publish: pythonWheelHandler.publish,
+};
+// ============================================================================
+// HANDLER: go-module
+// ============================================================================
+/** @task T4552 */
+const goModuleHandler = {
+    async build(config, dryRun = false) {
+        const buildCommand = config.buildCommand ?? 'go mod tidy';
+        return execCommand(buildCommand, dryRun);
+    },
+    async validate(config) {
+        const packageFile = config.package ?? 'go.mod';
+        if (!existsSync(packageFile)) {
+            return { success: false, output: `go.mod not found: ${packageFile}`, dryRun: false };
+        }
+        if (!(await commandExists('go'))) {
+            return { success: false, output: 'go command not found', dryRun: false };
+        }
+        const content = readFileSync(packageFile, 'utf-8');
+        const moduleMatch = content.match(/^module\s+(\S+)/m);
+        if (!moduleMatch) {
+            return { success: false, output: 'Module path not found in go.mod', dryRun: false };
+        }
+        return { success: true, output: 'Go module validation passed', dryRun: false };
+    },
+    async publish(config, dryRun = false) {
+        if (!config.publishCommand) {
+            return {
+                success: true,
+                output: 'Go modules are published via Git tags. Create a tag with: git tag v<version> && git push --tags',
+                dryRun: false,
+            };
+        }
+        return execCommand(config.publishCommand, dryRun);
+    },
+};
+// ============================================================================
+// HANDLER: cargo-crate
+// ============================================================================
+/** @task T4552 */
+const cargoCrateHandler = {
+    async build(config, dryRun = false) {
+        const buildCommand = config.buildCommand ?? 'cargo build --release';
+        return execCommand(buildCommand, dryRun);
+    },
+    async validate(config) {
+        const packageFile = config.package ?? 'Cargo.toml';
+        if (!existsSync(packageFile)) {
+            return { success: false, output: `Cargo.toml not found: ${packageFile}`, dryRun: false };
+        }
+        if (!(await commandExists('cargo'))) {
+            return { success: false, output: 'cargo command not found', dryRun: false };
+        }
+        const content = readFileSync(packageFile, 'utf-8');
+        if (!content.includes('[package]')) {
+            return { success: false, output: '[package] section not found in Cargo.toml', dryRun: false };
+        }
+        const requiredFields = ['name', 'version', 'authors', 'edition'];
+        const missing = requiredFields.filter((f) => !new RegExp(`^${f}\\s*=`, 'm').test(content));
+        if (missing.length > 0) {
+            return {
+                success: false,
+                output: `Cargo.toml missing required fields: ${missing.join(', ')}`,
+                dryRun: false,
+            };
+        }
+        return { success: true, output: 'Cargo crate validation passed', dryRun: false };
+    },
+    async publish(config, dryRun = false) {
+        let publishCommand = config.publishCommand ?? 'cargo publish';
+        if (dryRun) {
+            publishCommand += ' --dry-run';
+        }
+        return execCommand(publishCommand, false); // cargo has built-in dry-run
+    },
+};
+// ============================================================================
+// HANDLER: ruby-gem
+// ============================================================================
+/** @task T4552 */
+const rubyGemHandler = {
+    async build(config, dryRun = false) {
+        let packageFile = config.package ?? '*.gemspec';
+        if (packageFile === '*.gemspec') {
+            // Find gemspec via glob would be ideal, but we check common patterns
+            const candidates = ['*.gemspec'];
+            // Simple check - in a real scenario we'd glob
+            packageFile = candidates[0];
+        }
+        const buildCommand = config.buildCommand ?? `gem build ${packageFile}`;
+        return execCommand(buildCommand, dryRun);
+    },
+    async validate(_config) {
+        if (!(await commandExists('gem'))) {
+            return { success: false, output: 'gem command not found', dryRun: false };
+        }
+        return { success: true, output: 'Ruby gem validation passed', dryRun: false };
+    },
+    async publish(config, dryRun = false) {
+        const publishCommand = config.publishCommand ?? 'gem push';
+        return execCommand(publishCommand, dryRun);
+    },
+};
+// ============================================================================
+// HANDLER: docker-image
+// ============================================================================
+/** @task T4552 */
+const dockerImageHandler = {
+    async build(config, dryRun = false) {
+        const buildCommand = config.buildCommand ?? `docker build -t ${config.registry ?? 'localhost'}:latest .`;
+        return execCommand(buildCommand, dryRun);
+    },
+    async validate(_config) {
+        if (!existsSync('Dockerfile') && !existsSync('dockerfile')) {
+            return { success: false, output: 'Dockerfile not found', dryRun: false };
+        }
+        if (!(await commandExists('docker'))) {
+            return { success: false, output: 'docker command not found', dryRun: false };
+        }
+        return { success: true, output: 'Docker image validation passed', dryRun: false };
+    },
+    async publish(config, dryRun = false) {
+        if (!config.publishCommand && !config.registry) {
+            return { success: false, output: 'Docker registry not specified', dryRun: false };
+        }
+        const publishCommand = config.publishCommand ?? `docker push ${config.registry}:latest`;
+        return execCommand(publishCommand, dryRun);
+    },
+};
+// ============================================================================
+// HANDLER: github-release
+// ============================================================================
+/** @task T4552 */
+const githubReleaseHandler = {
+    async build(config, dryRun = false) {
+        if (!config.buildCommand) {
+            return {
+                success: true,
+                output: 'No build command for GitHub release. Skipping.',
+                dryRun: false,
+            };
+        }
+        return execCommand(config.buildCommand, dryRun);
+    },
+    async validate(_config) {
+        if (!(await commandExists('gh'))) {
+            return { success: false, output: 'gh (GitHub CLI) command not found', dryRun: false };
+        }
+        try {
+            await execFileAsync('git', ['rev-parse', '--git-dir']);
+        }
+        catch {
+            return { success: false, output: 'Not in a git repository', dryRun: false };
+        }
+        return { success: true, output: 'GitHub release validation passed', dryRun: false };
+    },
+    async publish(config, dryRun = false) {
+        if (!config.publishCommand) {
+            return {
+                success: false,
+                output: 'GitHub release publish command not specified',
+                dryRun: false,
+            };
+        }
+        return execCommand(config.publishCommand, dryRun);
+    },
+};
+// ============================================================================
+// HANDLER REGISTRY
+// ============================================================================
+/** Built-in artifact handlers. */
+const HANDLERS = {
+    'generic-tarball': genericTarballHandler,
+    'npm-package': npmPackageHandler,
+    'python-wheel': pythonWheelHandler,
+    'python-sdist': pythonSdistHandler,
+    'go-module': goModuleHandler,
+    'cargo-crate': cargoCrateHandler,
+    'ruby-gem': rubyGemHandler,
+    'docker-image': dockerImageHandler,
+    'github-release': githubReleaseHandler,
+};
+/**
+ * Get handler for an artifact type.
+ * @task T4552
+ */
+export function getArtifactHandler(artifactType) {
+    return HANDLERS[artifactType] ?? null;
+}
+/**
+ * Check if a handler is registered for an artifact type.
+ * @task T4552
+ */
+export function hasArtifactHandler(artifactType) {
+    return artifactType in HANDLERS;
+}
+/**
+ * Build an artifact using the appropriate handler.
+ * @task T4552
+ */
+export async function buildArtifact(config, dryRun = false) {
+    const handler = getArtifactHandler(config.type);
+    if (!handler) {
+        return {
+            success: false,
+            output: `No handler registered for artifact type: ${config.type}`,
+            dryRun: false,
+        };
+    }
+    return handler.build(config, dryRun);
+}
+/**
+ * Validate an artifact using the appropriate handler.
+ * @task T4552
+ */
+export async function validateArtifact(config) {
+    const handler = getArtifactHandler(config.type);
+    if (!handler) {
+        return {
+            success: false,
+            output: `No handler registered for artifact type: ${config.type}`,
+            dryRun: false,
+        };
+    }
+    return handler.validate(config);
+}
+/**
+ * Publish an artifact using the appropriate handler.
+ * @task T4552
+ */
+export async function publishArtifact(config, dryRun = false) {
+    const handler = getArtifactHandler(config.type);
+    if (!handler) {
+        return {
+            success: false,
+            output: `No handler registered for artifact type: ${config.type}`,
+            dryRun: false,
+        };
+    }
+    return handler.publish(config, dryRun);
+}
+/**
+ * Get all supported artifact types.
+ * @task T4552
+ */
+export function getSupportedArtifactTypes() {
+    return Object.keys(HANDLERS);
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/release/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/release/artifacts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AA6C1C;;;GAGG;AACH,KAAK,UAAU,aAAa,CAAC,GAAW;IACtC,IAAI,CAAC;QACH,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,WAAW,CAAC,OAAe,EAAE,MAAe;IACzD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,4BAA4B,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACxF,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE;YACpE,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC5E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E,kBAAkB;AAClB,MAAM,qBAAqB,GAAoB;IAC7C,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;QAChC,MAAM,YAAY,GAChB,MAAM,CAAC,YAAY;YACnB,mBAAmB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,iEAAiE,CAAC;QACrI,OAAO,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAM;QACnB,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,6BAA6B;YAC7B,IAAI,CAAC;gBACH,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;gBAC7D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,4BAA4B,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;YAChF,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,8BAA8B,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;YACnF,CAAC;QACH,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,8BAA8B,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAClF,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;QAClC,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAC3B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,iDAAiD;gBACzD,MAAM,EAAE,KAAK;aACd,CAAC;QACJ,CAAC;QACD,OAAO,WAAW,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,kBAAkB;AAClB,MAAM,iBAAiB,GAAoB;IACzC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;QAChC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YACzB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,kDAAkD;gBAC1D,MAAM,EAAE,KAAK;aACd,CAAC;QACJ,CAAC;QACD,OAAO,WAAW,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAM;QACnB,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,IAAI,cAAc,CAAC;QACrD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,WAAW,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC7F,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAA4B,CAAC;YAC1F,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;YACrE,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;YAE1D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,yCAAyC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBACrE,MAAM,EAAE,KAAK;iBACd,CAAC;YACJ,CAAC;YAED,+BAA+B;YAC/B,MAAM,WAAW,GAAG,OAAO,CAAC,IAAc,CAAC;YAC3C,IAAI,CAAC,wDAAwD,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;gBAChF,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,6BAA6B,WAAW,EAAE;oBAClD,MAAM,EAAE,KAAK;iBACd,CAAC;YACJ,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,+BAA+B,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACnF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,WAAW,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACrF,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;QAClC,IAAI,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,aAAa,CAAC;QAE5D,IAAI,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;YAC/B,cAAc,IAAI,eAAe,CAAC;QACpC,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YAC3B,cAAc,IAAI,aAAa,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACzD,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC;YACxB,cAAc,IAAI,UAAU,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QACnD,CAAC;QAED,OAAO,WAAW,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,kBAAkB;AAClB,MAAM,kBAAkB,GAAoB;IAC1C,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;QAChC,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,iBAAiB,CAAC;QAC9D,OAAO,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAM;QACnB,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,IAAI,gBAAgB,CAAC;QACvD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACxD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,2CAA2C,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAChG,CAAC;QAED,IAAI,CAAC,CAAC,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACrC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,0BAA0B,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC/E,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,gCAAgC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACpF,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;QAClC,IAAI,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,qBAAqB,CAAC;QACpE,IAAI,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC;YACjC,cAAc,IAAI,iBAAiB,CAAC;QACtC,CAAC;QACD,OAAO,WAAW,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,kBAAkB;AAClB,MAAM,kBAAkB,GAAoB;IAC1C,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;QAChC,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,yBAAyB,CAAC;QACtE,OAAO,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,QAAQ,EAAE,kBAAkB,CAAC,QAAQ;IACrC,OAAO,EAAE,kBAAkB,CAAC,OAAO;CACpC,CAAC;AAEF,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,kBAAkB;AAClB,MAAM,eAAe,GAAoB;IACvC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;QAChC,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,aAAa,CAAC;QAC1D,OAAO,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAM;QACnB,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,IAAI,QAAQ,CAAC;QAC/C,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,WAAW,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACvF,CAAC;QAED,IAAI,CAAC,CAAC,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACjC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC3E,CAAC;QAED,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACtD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,iCAAiC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACtF,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,6BAA6B,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACjF,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;QAClC,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAC3B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EACJ,iGAAiG;gBACnG,MAAM,EAAE,KAAK;aACd,CAAC;QACJ,CAAC;QACD,OAAO,WAAW,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,kBAAkB;AAClB,MAAM,iBAAiB,GAAoB;IACzC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;QAChC,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,uBAAuB,CAAC;QACpE,OAAO,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAM;QACnB,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,IAAI,YAAY,CAAC;QACnD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,yBAAyB,WAAW,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC3F,CAAC;QAED,IAAI,CAAC,CAAC,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YACpC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,yBAAyB,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC9E,CAAC;QAED,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACnC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,2CAA2C,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAChG,CAAC;QAED,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QACjE,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3F,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,uCAAuC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACnE,MAAM,EAAE,KAAK;aACd,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,+BAA+B,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACnF,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;QAClC,IAAI,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,eAAe,CAAC;QAC9D,IAAI,MAAM,EAAE,CAAC;YACX,cAAc,IAAI,YAAY,CAAC;QACjC,CAAC;QACD,OAAO,WAAW,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC,CAAC,6BAA6B;IAC1E,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,kBAAkB;AAClB,MAAM,cAAc,GAAoB;IACtC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;QAChC,IAAI,WAAW,GAAG,MAAM,CAAC,OAAO,IAAI,WAAW,CAAC;QAEhD,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;YAChC,qEAAqE;YACrE,MAAM,UAAU,GAAG,CAAC,WAAW,CAAC,CAAC;YACjC,8CAA8C;YAC9C,WAAW,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;QAC/B,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,aAAa,WAAW,EAAE,CAAC;QACvE,OAAO,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAO;QACpB,IAAI,CAAC,CAAC,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAClC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC5E,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,4BAA4B,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAChF,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;QAClC,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,UAAU,CAAC;QAC3D,OAAO,WAAW,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,kBAAkB;AAClB,MAAM,kBAAkB,GAAoB;IAC1C,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;QAChC,MAAM,YAAY,GAChB,MAAM,CAAC,YAAY,IAAI,mBAAmB,MAAM,CAAC,QAAQ,IAAI,WAAW,WAAW,CAAC;QACtF,OAAO,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAO;QACpB,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC3D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC3E,CAAC;QAED,IAAI,CAAC,CAAC,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACrC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,0BAA0B,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC/E,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,gCAAgC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACpF,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;QAClC,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC/C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,+BAA+B,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACpF,CAAC;QACD,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,eAAe,MAAM,CAAC,QAAQ,SAAS,CAAC;QACxF,OAAO,WAAW,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E,kBAAkB;AAClB,MAAM,oBAAoB,GAAoB;IAC5C,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;QAChC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YACzB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,gDAAgD;gBACxD,MAAM,EAAE,KAAK;aACd,CAAC;QACJ,CAAC;QACD,OAAO,WAAW,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAO;QACpB,IAAI,CAAC,CAAC,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACjC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,mCAAmC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACxF,CAAC;QAED,IAAI,CAAC;YACH,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,yBAAyB,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC9E,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,kCAAkC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACtF,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;QAClC,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAC3B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,8CAA8C;gBACtD,MAAM,EAAE,KAAK;aACd,CAAC;QACJ,CAAC;QACD,OAAO,WAAW,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,kCAAkC;AAClC,MAAM,QAAQ,GAA0C;IACtD,iBAAiB,EAAE,qBAAqB;IACxC,aAAa,EAAE,iBAAiB;IAChC,cAAc,EAAE,kBAAkB;IAClC,cAAc,EAAE,kBAAkB;IAClC,WAAW,EAAE,eAAe;IAC5B,aAAa,EAAE,iBAAiB;IAChC,UAAU,EAAE,cAAc;IAC1B,cAAc,EAAE,kBAAkB;IAClC,gBAAgB,EAAE,oBAAoB;CACvC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAA0B;IAC3D,OAAO,QAAQ,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAAoB;IACrD,OAAO,YAAY,IAAI,QAAQ,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAsB,EACtB,MAAM,GAAG,KAAK;IAEd,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,4CAA4C,MAAM,CAAC,IAAI,EAAE;YACjE,MAAM,EAAE,KAAK;SACd,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAsB;IAC3D,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,4CAA4C,MAAM,CAAC,IAAI,EAAE;YACjE,MAAM,EAAE,KAAK;SACd,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAsB,EACtB,MAAM,GAAG,KAAK;IAEd,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,4CAA4C,MAAM,CAAC,IAAI,EAAE;YACjE,MAAM,EAAE,KAAK;SACd,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAmB,CAAC;AACjD,CAAC"}

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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"}