glab-setup-git-identity 0.6.0

package/scripts/create-github-release.mjs

@@ -0,0 +1,93 @@
+#!/usr/bin/env bun
+
+/**
+ * Create GitHub Release from CHANGELOG.md
+ * Usage: node scripts/create-github-release.mjs --release-version <version> --repository <repository>
+ *   release-version: Version number (e.g., 1.0.0)
+ *   repository: GitHub repository (e.g., owner/repo)
+ *
+ * Uses link-foundation libraries:
+ * - use-m: Dynamic package loading without package.json dependencies
+ * - command-stream: Modern shell command execution with streaming support
+ * - lino-arguments: Unified configuration from CLI args, env vars, and .lenv files
+ */
+
+import { readFileSync } from 'fs';
+
+// Load use-m dynamically
+const { use } = eval(
+  await (await fetch('https://unpkg.com/use-m/use.js')).text()
+);
+
+// Import link-foundation libraries
+const { $ } = await use('command-stream');
+const { makeConfig } = await use('lino-arguments');
+
+// Parse CLI arguments using lino-arguments
+// Note: Using --release-version instead of --version to avoid conflict with yargs' built-in --version flag
+const config = makeConfig({
+  yargs: ({ yargs, getenv }) =>
+    yargs
+      .option('release-version', {
+        type: 'string',
+        default: getenv('VERSION', ''),
+        describe: 'Version number (e.g., 1.0.0)',
+      })
+      .option('repository', {
+        type: 'string',
+        default: getenv('REPOSITORY', ''),
+        describe: 'GitHub repository (e.g., owner/repo)',
+      }),
+});
+
+const { releaseVersion: version, repository } = config;
+
+if (!version || !repository) {
+  console.error('Error: Missing required arguments');
+  console.error(
+    'Usage: node scripts/create-github-release.mjs --release-version <version> --repository <repository>'
+  );
+  process.exit(1);
+}
+
+const tag = `v${version}`;
+
+console.log(`Creating GitHub release for ${tag}...`);
+
+try {
+  // Read CHANGELOG.md
+  const changelog = readFileSync('./CHANGELOG.md', 'utf8');
+
+  // Extract changelog entry for this version
+  // Read from CHANGELOG.md between this version header and the next version header
+  const versionHeaderRegex = new RegExp(`## ${version}[\\s\\S]*?(?=## \\d|$)`);
+  const match = changelog.match(versionHeaderRegex);
+
+  let releaseNotes = '';
+  if (match) {
+    // Remove the version header itself and trim
+    releaseNotes = match[0].replace(`## ${version}`, '').trim();
+  }
+
+  if (!releaseNotes) {
+    releaseNotes = `Release ${version}`;
+  }
+
+  // Create release using GitHub API with JSON input
+  // This avoids shell escaping issues that occur when passing text via command-line arguments
+  // (Previously caused apostrophes like "didn't" to appear as "didn'''" in releases)
+  const payload = JSON.stringify({
+    tag_name: tag,
+    name: version,
+    body: releaseNotes,
+  });
+
+  await $`gh api repos/${repository}/releases -X POST --input -`.run({
+    stdin: payload,
+  });
+
+  console.log(`\u2705 Created GitHub release: ${tag}`);
+} catch (error) {
+  console.error('Error creating release:', error.message);
+  process.exit(1);
+}

package/scripts/create-manual-changeset.mjs

@@ -0,0 +1,89 @@
+#!/usr/bin/env bun
+
+/**
+ * Create a changeset file for manual releases
+ * Usage: node scripts/create-manual-changeset.mjs --bump-type <major|minor|patch> [--description <description>]
+ *
+ * IMPORTANT: Update the PACKAGE_NAME constant below to match your package.json
+ *
+ * Uses link-foundation libraries:
+ * - use-m: Dynamic package loading without package.json dependencies
+ * - command-stream: Modern shell command execution with streaming support
+ * - lino-arguments: Unified configuration from CLI args, env vars, and .lenv files
+ */
+
+import { writeFileSync } from 'fs';
+import { randomBytes } from 'crypto';
+
+// TODO: Update this to match your package name in package.json
+const PACKAGE_NAME = 'glab-setup-git-identity';
+
+// Load use-m dynamically
+const { use } = eval(
+  await (await fetch('https://unpkg.com/use-m/use.js')).text()
+);
+
+// Import link-foundation libraries
+const { $ } = await use('command-stream');
+const { makeConfig } = await use('lino-arguments');
+
+// Parse CLI arguments using lino-arguments
+const config = makeConfig({
+  yargs: ({ yargs, getenv }) =>
+    yargs
+      .option('bump-type', {
+        type: 'string',
+        default: getenv('BUMP_TYPE', ''),
+        describe: 'Version bump type: major, minor, or patch',
+        choices: ['major', 'minor', 'patch'],
+      })
+      .option('description', {
+        type: 'string',
+        default: getenv('DESCRIPTION', ''),
+        describe: 'Description for the changeset',
+      }),
+});
+
+try {
+  const { bumpType, description: descriptionArg } = config;
+
+  // Use provided description or default based on bump type
+  const description = descriptionArg || `Manual ${bumpType} release`;
+
+  if (!bumpType || !['major', 'minor', 'patch'].includes(bumpType)) {
+    console.error(
+      'Usage: node scripts/create-manual-changeset.mjs --bump-type <major|minor|patch> [--description <description>]'
+    );
+    process.exit(1);
+  }
+
+  // Generate a random changeset ID
+  const changesetId = randomBytes(4).toString('hex');
+  const changesetFile = `.changeset/manual-release-${changesetId}.md`;
+
+  // Create the changeset file with single quotes to match Prettier config
+  const content = `---
+'${PACKAGE_NAME}': ${bumpType}
+---
+
+${description}
+`;
+
+  writeFileSync(changesetFile, content, 'utf-8');
+
+  console.log(`Created changeset: ${changesetFile}`);
+  console.log('Content:');
+  console.log(content);
+
+  // Format with Prettier
+  console.log('\nFormatting with Prettier...');
+  await $`npx prettier --write "${changesetFile}"`;
+
+  console.log('\n✅ Changeset created and formatted successfully');
+} catch (error) {
+  console.error('Error creating changeset:', error.message);
+  if (process.env.DEBUG) {
+    console.error('Stack trace:', error.stack);
+  }
+  process.exit(1);
+}

package/scripts/detect-code-changes.mjs

@@ -0,0 +1,194 @@
+#!/usr/bin/env node
+
+/**
+ * Detect code changes for CI/CD pipeline
+ *
+ * This script detects what types of files have changed between two commits
+ * and outputs the results for use in GitHub Actions workflow conditions.
+ *
+ * Key behavior:
+ * - For PRs: compares PR head against base branch
+ * - For pushes: compares HEAD against HEAD^
+ * - Excludes certain folders and file types from "code changes" detection
+ *
+ * Excluded from code changes (don't require changesets):
+ * - Markdown files (*.md) in any folder
+ * - .changeset/ folder (changeset metadata)
+ * - docs/ folder (documentation)
+ * - experiments/ folder (experimental scripts)
+ * - examples/ folder (example scripts)
+ *
+ * Usage:
+ *   node scripts/detect-code-changes.mjs
+ *
+ * Environment variables (set by GitHub Actions):
+ *   - GITHUB_EVENT_NAME: 'pull_request' or 'push'
+ *   - GITHUB_BASE_SHA: Base commit SHA for PR
+ *   - GITHUB_HEAD_SHA: Head commit SHA for PR
+ *
+ * Outputs (written to GITHUB_OUTPUT):
+ *   - mjs: 'true' if any .mjs files changed
+ *   - js: 'true' if any .js files changed
+ *   - package: 'true' if package.json changed
+ *   - docs: 'true' if any .md files changed
+ *   - workflow: 'true' if any .github/workflows/ files changed
+ *   - any-code-changed: 'true' if any code files changed (excludes docs, changesets, experiments, examples)
+ */
+
+import { execSync } from 'child_process';
+import { appendFileSync } from 'fs';
+
+/**
+ * Execute a shell command and return trimmed output
+ * @param {string} command - The command to execute
+ * @returns {string} - The trimmed command output
+ */
+function exec(command) {
+  try {
+    return execSync(command, { encoding: 'utf-8' }).trim();
+  } catch (error) {
+    console.error(`Error executing command: ${command}`);
+    console.error(error.message);
+    return '';
+  }
+}
+
+/**
+ * Write output to GitHub Actions output file
+ * @param {string} name - Output name
+ * @param {string} value - Output value
+ */
+function setOutput(name, value) {
+  const outputFile = process.env.GITHUB_OUTPUT;
+  if (outputFile) {
+    appendFileSync(outputFile, `${name}=${value}\n`);
+  }
+  console.log(`${name}=${value}`);
+}
+
+/**
+ * Get the list of changed files between two commits
+ * @returns {string[]} Array of changed file paths
+ */
+function getChangedFiles() {
+  const eventName = process.env.GITHUB_EVENT_NAME || 'local';
+
+  if (eventName === 'pull_request') {
+    const baseSha = process.env.GITHUB_BASE_SHA;
+    const headSha = process.env.GITHUB_HEAD_SHA;
+
+    if (baseSha && headSha) {
+      console.log(`Comparing PR: ${baseSha}...${headSha}`);
+      try {
+        // Ensure we have the base commit
+        try {
+          execSync(`git cat-file -e ${baseSha}`, { stdio: 'ignore' });
+        } catch {
+          console.log('Base commit not available locally, attempting fetch...');
+          execSync(`git fetch origin ${baseSha}`, { stdio: 'inherit' });
+        }
+        const output = exec(`git diff --name-only ${baseSha} ${headSha}`);
+        return output ? output.split('\n').filter(Boolean) : [];
+      } catch (error) {
+        console.error(`Git diff failed: ${error.message}`);
+      }
+    }
+  }
+
+  // For push events or fallback
+  console.log('Comparing HEAD^ to HEAD');
+  try {
+    const output = exec('git diff --name-only HEAD^ HEAD');
+    return output ? output.split('\n').filter(Boolean) : [];
+  } catch {
+    // If HEAD^ doesn't exist (first commit), list all files in HEAD
+    console.log('HEAD^ not available, listing all files in HEAD');
+    const output = exec('git ls-tree --name-only -r HEAD');
+    return output ? output.split('\n').filter(Boolean) : [];
+  }
+}
+
+/**
+ * Check if a file should be excluded from code changes detection
+ * @param {string} filePath - The file path to check
+ * @returns {boolean} True if the file should be excluded
+ */
+function isExcludedFromCodeChanges(filePath) {
+  // Exclude markdown files in any folder
+  if (filePath.endsWith('.md')) {
+    return true;
+  }
+
+  // Exclude specific folders from code changes
+  const excludedFolders = ['.changeset/', 'docs/', 'experiments/', 'examples/'];
+
+  for (const folder of excludedFolders) {
+    if (filePath.startsWith(folder)) {
+      return true;
+    }
+  }
+
+  return false;
+}
+
+/**
+ * Main function to detect changes
+ */
+function detectChanges() {
+  console.log('Detecting file changes for CI/CD...\n');
+
+  const changedFiles = getChangedFiles();
+
+  console.log('Changed files:');
+  if (changedFiles.length === 0) {
+    console.log('  (none)');
+  } else {
+    changedFiles.forEach((file) => console.log(`  ${file}`));
+  }
+  console.log('');
+
+  // Detect .mjs file changes
+  const mjsChanged = changedFiles.some((file) => file.endsWith('.mjs'));
+  setOutput('mjs-changed', mjsChanged ? 'true' : 'false');
+
+  // Detect .js file changes
+  const jsChanged = changedFiles.some((file) => file.endsWith('.js'));
+  setOutput('js-changed', jsChanged ? 'true' : 'false');
+
+  // Detect package.json changes
+  const packageChanged = changedFiles.some((file) => file === 'package.json');
+  setOutput('package-changed', packageChanged ? 'true' : 'false');
+
+  // Detect documentation changes (any .md file)
+  const docsChanged = changedFiles.some((file) => file.endsWith('.md'));
+  setOutput('docs-changed', docsChanged ? 'true' : 'false');
+
+  // Detect workflow changes
+  const workflowChanged = changedFiles.some((file) =>
+    file.startsWith('.github/workflows/')
+  );
+  setOutput('workflow-changed', workflowChanged ? 'true' : 'false');
+
+  // Detect code changes (excluding docs, changesets, experiments, examples folders, and markdown files)
+  const codeChangedFiles = changedFiles.filter(
+    (file) => !isExcludedFromCodeChanges(file)
+  );
+
+  console.log('\nFiles considered as code changes:');
+  if (codeChangedFiles.length === 0) {
+    console.log('  (none)');
+  } else {
+    codeChangedFiles.forEach((file) => console.log(`  ${file}`));
+  }
+  console.log('');
+
+  // Check if any code files changed (.mjs, .js, .json, .yml, .yaml, or workflow files)
+  const codePattern = /\.(mjs|js|json|yml|yaml)$|\.github\/workflows\//;
+  const codeChanged = codeChangedFiles.some((file) => codePattern.test(file));
+  setOutput('any-code-changed', codeChanged ? 'true' : 'false');
+
+  console.log('\nChange detection completed.');
+}
+
+// Run the detection
+detectChanges();

package/scripts/format-github-release.mjs

@@ -0,0 +1,83 @@
+#!/usr/bin/env bun
+
+/**
+ * Format GitHub release notes using the format-release-notes.mjs script
+ * Usage: node scripts/format-github-release.mjs --release-version <version> --repository <repository> --commit-sha <commit_sha>
+ *   release-version: Version number (e.g., 1.0.0)
+ *   repository: GitHub repository (e.g., owner/repo)
+ *   commit_sha: Commit SHA for PR detection
+ *
+ * Uses link-foundation libraries:
+ * - use-m: Dynamic package loading without package.json dependencies
+ * - command-stream: Modern shell command execution with streaming support
+ * - lino-arguments: Unified configuration from CLI args, env vars, and .lenv files
+ */
+
+// Load use-m dynamically
+const { use } = eval(
+  await (await fetch('https://unpkg.com/use-m/use.js')).text()
+);
+
+// Import link-foundation libraries
+const { $ } = await use('command-stream');
+const { makeConfig } = await use('lino-arguments');
+
+// Parse CLI arguments using lino-arguments
+// Note: Using --release-version instead of --version to avoid conflict with yargs' built-in --version flag
+const config = makeConfig({
+  yargs: ({ yargs, getenv }) =>
+    yargs
+      .option('release-version', {
+        type: 'string',
+        default: getenv('VERSION', ''),
+        describe: 'Version number (e.g., 1.0.0)',
+      })
+      .option('repository', {
+        type: 'string',
+        default: getenv('REPOSITORY', ''),
+        describe: 'GitHub repository (e.g., owner/repo)',
+      })
+      .option('commit-sha', {
+        type: 'string',
+        default: getenv('COMMIT_SHA', ''),
+        describe: 'Commit SHA for PR detection',
+      }),
+});
+
+const { releaseVersion: version, repository, commitSha } = config;
+
+if (!version || !repository || !commitSha) {
+  console.error('Error: Missing required arguments');
+  console.error(
+    'Usage: node scripts/format-github-release.mjs --release-version <version> --repository <repository> --commit-sha <commit_sha>'
+  );
+  process.exit(1);
+}
+
+const tag = `v${version}`;
+
+try {
+  // Get the release ID for this version
+  let releaseId = '';
+  try {
+    const result =
+      await $`gh api "repos/${repository}/releases/tags/${tag}" --jq '.id'`.run(
+        { capture: true }
+      );
+    releaseId = result.stdout.trim();
+  } catch {
+    console.log(`\u26A0\uFE0F Could not find release for ${tag}`);
+    process.exit(0);
+  }
+
+  if (releaseId) {
+    console.log(`Formatting release notes for ${tag}...`);
+    // Pass the trigger commit SHA for PR detection
+    // This allows proper PR lookup even if the changelog doesn't have a commit hash
+    await $`node scripts/format-release-notes.mjs --release-id "${releaseId}" --release-version "${tag}" --repository "${repository}" --commit-sha "${commitSha}"`;
+    console.log(`\u2705 Formatted release notes for ${tag}`);
+  }
+} catch (error) {
+  console.error('Error formatting release:', error.message);
+  process.exit(1);
+}

package/scripts/format-release-notes.mjs

@@ -0,0 +1,219 @@
+#!/usr/bin/env node
+
+/**
+ * Script to format GitHub release notes with proper formatting:
+ * - Fix special characters like \n
+ * - Add link to PR that contains the release commit (if found)
+ * - Add shields.io NPM version badge
+ * - Format nicely with proper markdown
+ *
+ * IMPORTANT: Update the PACKAGE_NAME constant below to match your package.json
+ *
+ * PR Detection Logic:
+ * 1. Extract commit hash from changelog entry (if present)
+ * 2. Fall back to --commit-sha argument (passed from workflow)
+ * 3. Look up PRs that contain the commit via GitHub API
+ * 4. If no PR found, simply don't display any PR link (no guessing)
+ *
+ * Uses link-foundation libraries:
+ * - use-m: Dynamic package loading without package.json dependencies
+ * - command-stream: Modern shell command execution with streaming support
+ * - lino-arguments: Unified configuration from CLI args, env vars, and .lenv files
+ *
+ * Note: Uses --release-version instead of --version to avoid conflict with yargs' built-in --version flag.
+ */
+
+// TODO: Update this to match your package name in package.json
+const PACKAGE_NAME = 'glab-setup-git-identity';
+
+// Load use-m dynamically
+const { use } = eval(
+  await (await fetch('https://unpkg.com/use-m/use.js')).text()
+);
+
+// Import link-foundation libraries
+const { $ } = await use('command-stream');
+const { makeConfig } = await use('lino-arguments');
+
+// Parse CLI arguments using lino-arguments
+// Note: Using --release-version instead of --version to avoid conflict with yargs' built-in --version flag
+const config = makeConfig({
+  yargs: ({ yargs, getenv }) =>
+    yargs
+      .option('release-version', {
+        type: 'string',
+        default: getenv('VERSION', ''),
+        describe: 'Version number (e.g., v0.8.36)',
+      })
+      .option('release-id', {
+        type: 'string',
+        default: getenv('RELEASE_ID', ''),
+        describe: 'GitHub release ID',
+      })
+      .option('repository', {
+        type: 'string',
+        default: getenv('REPOSITORY', ''),
+        describe: 'GitHub repository (e.g., owner/repo)',
+      })
+      .option('commit-sha', {
+        type: 'string',
+        default: getenv('COMMIT_SHA', ''),
+        describe: 'Commit SHA for PR detection',
+      }),
+});
+
+const releaseId = config.releaseId;
+const version = config.releaseVersion;
+const repository = config.repository;
+const passedCommitSha = config.commitSha;
+
+if (!releaseId || !version || !repository) {
+  console.error(
+    'Usage: format-release-notes.mjs --release-id <releaseId> --release-version <version> --repository <repository> [--commit-sha <sha>]'
+  );
+  process.exit(1);
+}
+
+try {
+  // Get current release body
+  const result = await $`gh api repos/${repository}/releases/${releaseId}`.run({
+    capture: true,
+  });
+  const releaseData = JSON.parse(result.stdout);
+
+  const currentBody = releaseData.body || '';
+
+  // Skip if already formatted (has shields.io badge image)
+  if (currentBody.includes('img.shields.io')) {
+    console.log('ℹ️ Release notes already formatted');
+    process.exit(0);
+  }
+
+  // Extract changes section (Major, Minor, or Patch)
+  // This regex handles multiple formats:
+  // 1. With commit hash: "### [Major|Minor|Patch] Changes\n- abc1234: Description"
+  // 2. Without commit hash: "### [Major|Minor|Patch] Changes\n- Description"
+  const changesPattern =
+    /### (Major|Minor|Patch) Changes\s*\n\s*-\s+(?:([a-f0-9]+):\s+)?(.+?)$/s;
+  const changesMatch = currentBody.match(changesPattern);
+
+  let commitHash = null;
+  let rawDescription = null;
+  let changeType = null;
+
+  if (changesMatch) {
+    // Extract: [full match, changeType, commitHash (optional), description]
+    [, changeType, commitHash, rawDescription] = changesMatch;
+    console.log(`ℹ️ Found ${changeType} Changes section`);
+
+    // If commitHash is undefined and description contains it, try to extract
+    if (!commitHash && rawDescription) {
+      // This handles the case where description itself might be null/undefined
+      // and we need to safely check for commit hash at the start
+      const descWithHashMatch = rawDescription.match(/^([a-f0-9]+):\s+(.+)$/s);
+      if (descWithHashMatch) {
+        [, commitHash, rawDescription] = descWithHashMatch;
+      }
+    }
+  } else {
+    console.log('⚠️ Could not parse changes from release notes');
+    console.log('   Looking for pattern: ### [Major|Minor|Patch] Changes');
+    process.exit(0);
+  }
+
+  // Clean up the description:
+  // 1. Convert literal \n sequences (escaped newlines from GitHub API) to actual newlines
+  // 2. Remove leading/trailing quotes (including escaped quotes from command-stream shell escaping)
+  // 3. Remove any trailing npm package links or markdown that might be there
+  // 4. Normalize whitespace while preserving line breaks
+  const cleanDescription = rawDescription
+    .replace(/\\n/g, '\n') // Convert escaped \n to actual newlines
+    .replace(/^(\\['"])+/g, '') // Remove leading escaped quotes (e.g., \', \", \'', \'')
+    .replace(/(['"])+$/g, '') // Remove trailing unescaped quotes (e.g., ', ", '', '')
+    .replace(/^(['"])+/g, '') // Remove leading unescaped quotes
+    .replace(/📦.*$/s, '') // Remove any existing npm package info
+    .replace(/---.*$/s, '') // Remove any existing separators and everything after
+    .trim()
+    .split('\n') // Split by lines
+    .map((line) => line.trim()) // Trim whitespace from each line
+    .join('\n') // Rejoin with newlines
+    .replace(/\n{3,}/g, '\n\n'); // Normalize excessive blank lines (3+ becomes 2)
+
+  // Find the PR that contains the release commit
+  // Uses commit hash from changelog or passed commit SHA from workflow
+  let prNumber = null;
+
+  // Determine which commit SHA to use for PR lookup
+  const commitShaToLookup = commitHash || passedCommitSha;
+
+  if (commitShaToLookup) {
+    const source = commitHash ? 'changelog' : 'workflow';
+    console.log(
+      `ℹ️ Looking up PR for commit ${commitShaToLookup} (from ${source})`
+    );
+
+    try {
+      const prResult =
+        await $`gh api "repos/${repository}/commits/${commitShaToLookup}/pulls"`.run(
+          { capture: true }
+        );
+      const prsData = JSON.parse(prResult.stdout);
+
+      // Find the PR that's not the version bump PR (not "chore: version packages")
+      const relevantPr = prsData.find(
+        (pr) => !pr.title.includes('version packages')
+      );
+
+      if (relevantPr) {
+        prNumber = relevantPr.number;
+        console.log(`✅ Found PR #${prNumber} containing commit`);
+      } else if (prsData.length > 0) {
+        console.log(
+          '⚠️ Found PRs but all are version bump PRs, not linking any'
+        );
+      } else {
+        console.log(
+          'ℹ️ No PR found containing this commit - not adding PR link'
+        );
+      }
+    } catch (error) {
+      console.log('⚠️ Could not find PR for commit', commitShaToLookup);
+      console.log('   Error:', error.message);
+      if (process.env.DEBUG) {
+        console.error(error);
+      }
+    }
+  } else {
+    // No commit hash available from any source
+    console.log('ℹ️ No commit SHA available - not adding PR link');
+  }
+
+  // Build formatted release notes
+  const versionWithoutV = version.replace(/^v/, '');
+  const npmBadge = `[![npm version](https://img.shields.io/badge/npm-${versionWithoutV}-blue.svg)](https://www.npmjs.com/package/${PACKAGE_NAME}/v/${versionWithoutV})`;
+
+  let formattedBody = `${cleanDescription}`;
+
+  // Add PR link if available
+  if (prNumber) {
+    formattedBody += `\n\n**Related Pull Request:** #${prNumber}`;
+  }
+
+  formattedBody += `\n\n---\n\n${npmBadge}`;
+
+  // Update the release using JSON input to properly handle special characters
+  const updatePayload = JSON.stringify({ body: formattedBody });
+  await $`gh api repos/${repository}/releases/${releaseId} -X PATCH --input -`.run(
+    { stdin: updatePayload }
+  );
+
+  console.log(`✅ Formatted release notes for v${versionWithoutV}`);
+  if (prNumber) {
+    console.log(`   - Added link to PR #${prNumber}`);
+  }
+  console.log('   - Added shields.io npm badge');
+  console.log('   - Cleaned up formatting');
+} catch (error) {
+  console.error('❌ Error formatting release notes:', error.message);
+  process.exit(1);
+}