@cleocode/core 2026.3.66 → 2026.3.68

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

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.js

@@ -0,0 +1,225 @@
+import { execFileSync } from 'node:child_process';
+// --- Functions (all exported) ---
+/**
+ * Check if the `gh` CLI is available by attempting to run `gh --version`.
+ * Does NOT use `which` to remain cross-platform.
+ */
+export function isGhCliAvailable() {
+    try {
+        execFileSync('gh', ['--version'], { stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 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 function extractRepoOwnerAndName(remote) {
+    const trimmed = remote.trim();
+    // HTTPS pattern: https://github.com/owner/repo[.git]
+    const httpsMatch = trimmed.match(/^https?:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?$/);
+    if (httpsMatch) {
+        return { owner: httpsMatch[1], repo: httpsMatch[2] };
+    }
+    // SSH pattern: git@github.com:owner/repo[.git]
+    const sshMatch = trimmed.match(/^git@github\.com:([^/]+)\/([^/]+?)(?:\.git)?$/);
+    if (sshMatch) {
+        return { owner: sshMatch[1], repo: sshMatch[2] };
+    }
+    return 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 async function detectBranchProtection(branch, remote, projectRoot) {
+    const cwdOpts = projectRoot ? { cwd: projectRoot } : {};
+    // Strategy 1: gh CLI via GitHub API
+    if (isGhCliAvailable()) {
+        try {
+            const remoteUrl = execFileSync('git', ['remote', 'get-url', remote], {
+                encoding: 'utf-8',
+                stdio: 'pipe',
+                ...cwdOpts,
+            }).trim();
+            const identity = extractRepoOwnerAndName(remoteUrl);
+            if (identity) {
+                const { owner, repo } = identity;
+                try {
+                    execFileSync('gh', ['api', `/repos/${owner}/${repo}/branches/${branch}/protection`], {
+                        encoding: 'utf-8',
+                        stdio: 'pipe',
+                        ...cwdOpts,
+                    });
+                    // Exit code 0 means protection rules exist
+                    return { protected: true, detectionMethod: 'gh-api' };
+                }
+                catch (apiErr) {
+                    const stderr = apiErr instanceof Error && 'stderr' in apiErr
+                        ? String(apiErr.stderr ?? '')
+                        : '';
+                    if (stderr.includes('404') || stderr.includes('Not Found')) {
+                        // 404 means no protection configured
+                        return { protected: false, detectionMethod: 'gh-api' };
+                    }
+                    // Any other API error — fall through to strategy 2
+                }
+            }
+            // Parse failure — fall through to strategy 2
+        }
+        catch {
+            // git remote get-url failed — fall through to strategy 2
+        }
+    }
+    // Strategy 2: git push --dry-run
+    try {
+        const result = execFileSync('git', ['push', '--dry-run', remote, `HEAD:${branch}`], {
+            encoding: 'utf-8',
+            stdio: 'pipe',
+            ...cwdOpts,
+        });
+        // If stderr from a successful dry-run contains protection signals
+        const output = typeof result === 'string' ? result : '';
+        if (output.includes('protected branch') ||
+            output.includes('GH006') ||
+            output.includes('refusing to allow')) {
+            return { protected: true, detectionMethod: 'push-dry-run' };
+        }
+        return { protected: false, detectionMethod: 'push-dry-run' };
+    }
+    catch (pushErr) {
+        const stderr = pushErr instanceof Error && 'stderr' in pushErr
+            ? String(pushErr.stderr ?? '')
+            : pushErr instanceof Error
+                ? pushErr.message
+                : String(pushErr);
+        if (stderr.includes('protected branch') ||
+            stderr.includes('GH006') ||
+            stderr.includes('refusing to allow')) {
+            return { protected: true, detectionMethod: 'push-dry-run' };
+        }
+        return {
+            protected: false,
+            detectionMethod: 'unknown',
+            error: stderr,
+        };
+    }
+}
+/**
+ * Build the markdown body for a GitHub pull request.
+ */
+export function buildPRBody(opts) {
+    const epicLine = opts.epicId ? `**Epic**: ${opts.epicId}\n\n` : '';
+    return [
+        `## Release v${opts.version}`,
+        '',
+        `${epicLine}This PR merges the ${opts.head} branch into ${opts.base} to publish the release.`,
+        '',
+        '### Checklist',
+        '- [ ] CHANGELOG.md updated',
+        '- [ ] All release tasks complete',
+        '- [ ] Version bump committed',
+        '',
+        '---',
+        '*Created by CLEO release pipeline*',
+    ].join('\n');
+}
+/**
+ * Format human-readable instructions for creating a PR manually.
+ */
+export function formatManualPRInstructions(opts) {
+    const epicSuffix = opts.epicId ? ` (${opts.epicId})` : '';
+    return [
+        'Branch protection detected or gh CLI unavailable. Create the PR manually:',
+        '',
+        `  gh pr create \\`,
+        `    --base ${opts.base} \\`,
+        `    --head ${opts.head} \\`,
+        `    --title "${opts.title}" \\`,
+        `    --body "Release v${opts.version}${epicSuffix}"`,
+        '',
+        `Or visit: https://github.com/[owner]/[repo]/compare/${opts.base}...${opts.head}`,
+        '',
+        'After merging, CI will automatically publish to npm.',
+    ].join('\n');
+}
+/**
+ * Create a GitHub pull request using the `gh` CLI, or return manual instructions
+ * if the CLI is unavailable or the operation fails.
+ */
+export async function createPullRequest(opts) {
+    if (!isGhCliAvailable()) {
+        return {
+            mode: 'manual',
+            instructions: formatManualPRInstructions(opts),
+        };
+    }
+    const body = buildPRBody(opts);
+    const args = [
+        'pr',
+        'create',
+        '--base',
+        opts.base,
+        '--head',
+        opts.head,
+        '--title',
+        opts.title,
+        '--body',
+        body,
+    ];
+    if (opts.labels && opts.labels.length > 0) {
+        for (const label of opts.labels) {
+            args.push('--label', label);
+        }
+    }
+    try {
+        const output = execFileSync('gh', args, {
+            encoding: 'utf-8',
+            stdio: 'pipe',
+            ...(opts.projectRoot ? { cwd: opts.projectRoot } : {}),
+        });
+        const prUrl = output.trim();
+        const numberMatch = prUrl.match(/\/pull\/(\d+)$/);
+        const prNumber = numberMatch ? parseInt(numberMatch[1], 10) : undefined;
+        return {
+            mode: 'created',
+            prUrl,
+            prNumber,
+        };
+    }
+    catch (err) {
+        const stderr = err instanceof Error && 'stderr' in err
+            ? String(err.stderr ?? '')
+            : err instanceof Error
+                ? err.message
+                : String(err);
+        // Handle case where PR already exists
+        if (stderr.includes('already exists')) {
+            // Attempt to extract existing PR URL from stderr
+            const urlMatch = stderr.match(/https:\/\/github\.com\/[^\s]+\/pull\/\d+/);
+            const existingUrl = urlMatch ? urlMatch[0] : undefined;
+            return {
+                mode: 'skipped',
+                prUrl: existingUrl,
+                instructions: 'PR already exists',
+            };
+        }
+        return {
+            mode: 'manual',
+            instructions: formatManualPRInstructions(opts),
+            error: stderr,
+        };
+    }
+}
+//# sourceMappingURL=github-pr.js.map

package/dist/release/github-pr.js.map

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