glab-setup-git-identity 0.6.0

package/experiments/test-failure-detection.mjs

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+
+/**
+ * Test script to verify the failure detection logic works correctly
+ * Reference: link-assistant/agent PR #116
+ *
+ * This script simulates the output that changeset publish produces
+ * when packages fail to publish, and verifies that our detection
+ * logic correctly identifies the failure.
+ */
+
+// Copy of the failure patterns from publish-to-npm.mjs
+const FAILURE_PATTERNS = [
+  'packages failed to publish',
+  'error occurred while publishing',
+  'npm error code E',
+  'npm error 404',
+  'npm error 401',
+  'npm error 403',
+  'Access token expired',
+  'ENEEDAUTH',
+];
+
+/**
+ * Check if the output contains any failure patterns
+ * @param {string} output - Combined stdout and stderr
+ * @returns {string|null} - The matched failure pattern or null if no failure detected
+ */
+function detectPublishFailure(output) {
+  const lowerOutput = output.toLowerCase();
+  for (const pattern of FAILURE_PATTERNS) {
+    if (lowerOutput.includes(pattern.toLowerCase())) {
+      return pattern;
+    }
+  }
+  return null;
+}
+
+// Test cases based on real CI failure output from link-assistant/agent issue #115
+const testCases = [
+  {
+    name: 'Real changeset failure output (E404)',
+    output: `🦋  info npm info @link-assistant/agent
+🦋  info @link-assistant/agent is being published because our local version (0.8.0) has not been published on npm
+🦋  info Publishing "@link-assistant/agent" at "0.8.0"
+🦋  error an error occurred while publishing @link-assistant/agent: E404 Not Found - PUT https://registry.npmjs.org/@link-assistant%2fagent - Not found
+🦋  error The requested resource '@link-assistant/agent@0.8.0' could not be found or you do not have permission to access it.
+🦋  error npm error code E404
+🦋  error npm error 404 Not Found - PUT https://registry.npmjs.org/@link-assistant%2fagent - Not found
+🦋  error packages failed to publish:
+🦋  @link-assistant/agent@0.8.0`,
+    shouldFail: true,
+  },
+  {
+    name: 'Access token expired error',
+    output: `🦋  error npm notice Access token expired or revoked. Please try logging in again.`,
+    shouldFail: true,
+  },
+  {
+    name: '401 Unauthorized error',
+    output: `npm error 401 Unauthorized - PUT https://registry.npmjs.org/@link-assistant%2fagent`,
+    shouldFail: true,
+  },
+  {
+    name: '403 Forbidden error',
+    output: `npm error 403 Forbidden - PUT https://registry.npmjs.org/@link-assistant%2fagent`,
+    shouldFail: true,
+  },
+  {
+    name: 'ENEEDAUTH error',
+    output: `npm error code ENEEDAUTH`,
+    shouldFail: true,
+  },
+  {
+    name: 'Generic npm error code E',
+    output: `npm error code E500`,
+    shouldFail: true,
+  },
+  {
+    name: 'Error occurred while publishing',
+    output: `🦋  error an error occurred while publishing my-package: Something went wrong`,
+    shouldFail: true,
+  },
+  {
+    name: 'Successful publish output',
+    output: `🦋  info npm info @link-assistant/agent
+🦋  info @link-assistant/agent is being published because our local version (0.8.0) has not been published on npm
+🦋  info Publishing "@link-assistant/agent" at "0.8.0"
+🦋  success packages published successfully:
+🦋  @link-assistant/agent@0.8.0`,
+    shouldFail: false,
+  },
+  {
+    name: 'No output (empty)',
+    output: '',
+    shouldFail: false,
+  },
+  {
+    name: 'Normal npm info messages',
+    output: `npm notice package.json name is @link-assistant/agent@0.8.0
+npm notice Publishing to https://registry.npmjs.org/ with tag latest`,
+    shouldFail: false,
+  },
+];
+
+console.log('Testing failure detection logic...\n');
+console.log('Failure patterns:');
+FAILURE_PATTERNS.forEach((p) => console.log(`  - "${p}"`));
+console.log(`\n${'='.repeat(60)}\n`);
+
+let passed = 0;
+let failed = 0;
+
+for (const tc of testCases) {
+  const result = detectPublishFailure(tc.output);
+  const detected = result !== null;
+  const isCorrect = detected === tc.shouldFail;
+
+  if (isCorrect) {
+    console.log(`✅ PASS: ${tc.name}`);
+    if (detected) {
+      console.log(`   Detected pattern: "${result}"`);
+    }
+    passed++;
+  } else {
+    console.log(`❌ FAIL: ${tc.name}`);
+    console.log(`   Expected failure: ${tc.shouldFail}, but got: ${detected}`);
+    if (detected) {
+      console.log(`   Detected pattern: "${result}"`);
+    }
+    failed++;
+  }
+  console.log();
+}
+
+console.log('='.repeat(60));
+console.log(`\nResults: ${passed} passed, ${failed} failed`);
+
+if (failed > 0) {
+  process.exit(1);
+}
+
+console.log('\n✅ All failure detection tests passed!');

package/experiments/test-format-major-changes.mjs

@@ -0,0 +1,49 @@
+#!/usr/bin/env bun
+
+/**
+ * Test script to validate format-release-notes.mjs with Major Changes
+ */
+
+// Test Major Changes pattern matching
+const testBody = `### Major Changes
+
+- abc1234: Breaking change: Completely rewrite core API
+
+  This is a major breaking change that requires users to update their code.
+  - Updated all method signatures
+  - Removed deprecated functions
+  - Added new required parameters`;
+
+// The pattern from our fixed script
+const changesPattern =
+  /### (Major|Minor|Patch) Changes\s*\n\s*-\s+(?:([a-f0-9]+):\s+)?(.+?)$/s;
+const changesMatch = testBody.match(changesPattern);
+
+let commitHash = null;
+let rawDescription = null;
+let changeType = null;
+
+if (changesMatch) {
+  [, changeType, commitHash, rawDescription] = changesMatch;
+  console.log(`✅ Pattern matched successfully`);
+  console.log(`   Change Type: ${changeType}`);
+  console.log(`   Commit Hash: ${commitHash || 'none'}`);
+  console.log(`   Description: ${rawDescription.substring(0, 50)}...`);
+
+  // If commitHash is undefined and description contains it, try to extract
+  if (!commitHash && rawDescription) {
+    const descWithHashMatch = rawDescription.match(/^([a-f0-9]+):\s+(.+)$/s);
+    if (descWithHashMatch) {
+      [, commitHash, rawDescription] = descWithHashMatch;
+      console.log(`   Extracted Hash: ${commitHash}`);
+      console.log(
+        `   Cleaned Description: ${rawDescription.substring(0, 50)}...`
+      );
+    }
+  }
+} else {
+  console.log('❌ Pattern did not match');
+  process.exit(1);
+}
+
+console.log('\n✅ Major Changes test passed!');

package/experiments/test-format-minor-changes.mjs

@@ -0,0 +1,52 @@
+#!/usr/bin/env bun
+
+/**
+ * Test script to validate format-release-notes.mjs with Minor Changes
+ */
+
+// Test Minor Changes pattern matching (mimics the actual v0.1.0 release)
+const testBody = `### Minor Changes
+
+- 65d76dc: Initial template setup with complete AI-driven development pipeline
+
+  Features:
+  - Multi-runtime support for Node.js, Bun, and Deno
+  - Universal testing with test-anywhere framework
+  - Automated release workflow with changesets
+  - GitHub Actions CI/CD pipeline with 9 test combinations
+  - Code quality tools: ESLint + Prettier with Husky pre-commit hooks
+  - Package manager agnostic design`;
+
+// The pattern from our fixed script
+const changesPattern =
+  /### (Major|Minor|Patch) Changes\s*\n\s*-\s+(?:([a-f0-9]+):\s+)?(.+?)$/s;
+const changesMatch = testBody.match(changesPattern);
+
+let commitHash = null;
+let rawDescription = null;
+let changeType = null;
+
+if (changesMatch) {
+  [, changeType, commitHash, rawDescription] = changesMatch;
+  console.log(`✅ Pattern matched successfully`);
+  console.log(`   Change Type: ${changeType}`);
+  console.log(`   Commit Hash: ${commitHash || 'none'}`);
+  console.log(`   Description: ${rawDescription.substring(0, 50)}...`);
+
+  // If commitHash is undefined and description contains it, try to extract
+  if (!commitHash && rawDescription) {
+    const descWithHashMatch = rawDescription.match(/^([a-f0-9]+):\s+(.+)$/s);
+    if (descWithHashMatch) {
+      [, commitHash, rawDescription] = descWithHashMatch;
+      console.log(`   Extracted Hash: ${commitHash}`);
+      console.log(
+        `   Cleaned Description: ${rawDescription.substring(0, 50)}...`
+      );
+    }
+  }
+} else {
+  console.log('❌ Pattern did not match');
+  process.exit(1);
+}
+
+console.log('\n✅ Minor Changes test passed!');

package/experiments/test-format-no-hash.mjs

@@ -0,0 +1,43 @@
+#!/usr/bin/env bun
+
+/**
+ * Test script to validate format-release-notes.mjs without commit hash
+ */
+
+// Test without commit hash
+const testBody = `### Minor Changes
+
+- Add new feature for improved performance`;
+
+// The pattern from our fixed script
+const changesPattern =
+  /### (Major|Minor|Patch) Changes\s*\n\s*-\s+(?:([a-f0-9]+):\s+)?(.+?)$/s;
+const changesMatch = testBody.match(changesPattern);
+
+let commitHash = null;
+let rawDescription = null;
+let changeType = null;
+
+if (changesMatch) {
+  [, changeType, commitHash, rawDescription] = changesMatch;
+  console.log(`✅ Pattern matched successfully`);
+  console.log(`   Change Type: ${changeType}`);
+  console.log(`   Commit Hash: ${commitHash || 'none'}`);
+  console.log(`   Description: ${rawDescription}`);
+
+  // Verify that no commit hash is extracted (as expected)
+  if (!commitHash && rawDescription) {
+    const descWithHashMatch = rawDescription.match(/^([a-f0-9]+):\s+(.+)$/s);
+    if (descWithHashMatch) {
+      console.log('❌ Unexpected hash extraction from plain description');
+      process.exit(1);
+    } else {
+      console.log('   ✅ Correctly handled description without hash');
+    }
+  }
+} else {
+  console.log('❌ Pattern did not match');
+  process.exit(1);
+}
+
+console.log('\n✅ No-hash test passed!');

package/experiments/test-format-patch-changes.mjs

@@ -0,0 +1,46 @@
+#!/usr/bin/env bun
+
+/**
+ * Test script to validate format-release-notes.mjs with Patch Changes
+ */
+
+// Test Patch Changes pattern matching
+const testBody = `### Patch Changes
+
+- def5678: Fix issue with error handling in release script
+
+  This patch fixes a bug where the script would crash on empty descriptions.`;
+
+// The pattern from our fixed script
+const changesPattern =
+  /### (Major|Minor|Patch) Changes\s*\n\s*-\s+(?:([a-f0-9]+):\s+)?(.+?)$/s;
+const changesMatch = testBody.match(changesPattern);
+
+let commitHash = null;
+let rawDescription = null;
+let changeType = null;
+
+if (changesMatch) {
+  [, changeType, commitHash, rawDescription] = changesMatch;
+  console.log(`✅ Pattern matched successfully`);
+  console.log(`   Change Type: ${changeType}`);
+  console.log(`   Commit Hash: ${commitHash || 'none'}`);
+  console.log(`   Description: ${rawDescription.substring(0, 50)}...`);
+
+  // If commitHash is undefined and description contains it, try to extract
+  if (!commitHash && rawDescription) {
+    const descWithHashMatch = rawDescription.match(/^([a-f0-9]+):\s+(.+)$/s);
+    if (descWithHashMatch) {
+      [, commitHash, rawDescription] = descWithHashMatch;
+      console.log(`   Extracted Hash: ${commitHash}`);
+      console.log(
+        `   Cleaned Description: ${rawDescription.substring(0, 50)}...`
+      );
+    }
+  }
+} else {
+  console.log('❌ Pattern did not match');
+  process.exit(1);
+}
+
+console.log('\n✅ Patch Changes test passed!');

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "glab-setup-git-identity",
+  "version": "0.6.0",
+  "description": "A tool to setup git identity based on current GitLab user",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "glab-setup-git-identity": "src/cli.js"
+  },
+  "types": "src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js"
+    }
+  },
+  "scripts": {
+    "test": "node --test tests/",
+    "test:bun": "bun test tests/",
+    "test:deno": "deno test --allow-all",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "check:duplication": "jscpd .",
+    "check": "npm run lint && npm run format:check && npm run check:duplication",
+    "prepare": "husky || true",
+    "changeset": "changeset",
+    "changeset:version": "node scripts/changeset-version.mjs",
+    "changeset:publish": "changeset publish",
+    "changeset:status": "changeset status --since=origin/main"
+  },
+  "keywords": [
+    "gitlab",
+    "glab",
+    "git",
+    "identity",
+    "setup",
+    "cli",
+    "git-config",
+    "user-name",
+    "user-email"
+  ],
+  "author": "Link Foundation",
+  "license": "Unlicense",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/link-foundation/glab-setup-git-identity"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "command-stream": "^0.9.4",
+    "lino-arguments": "^0.2.1",
+    "yargs": "^17.7.2"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.29.7",
+    "eslint": "^9.38.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "husky": "^9.1.7",
+    "jscpd": "^4.0.5",
+    "lint-staged": "^16.2.6",
+    "prettier": "^3.6.2",
+    "test-anywhere": "^0.8.48"
+  },
+  "lint-staged": {
+    "*.{js,mjs,cjs}": [
+      "eslint --fix --max-warnings 0",
+      "prettier --write",
+      "prettier --check"
+    ],
+    "*.md": [
+      "prettier --write",
+      "prettier --check"
+    ]
+  }
+}

package/scripts/changeset-version.mjs

@@ -0,0 +1,75 @@
+#!/usr/bin/env bun
+
+/**
+ * Custom changeset version script that ensures package-lock.json is synchronized
+ * with package.json after version bumps.
+ *
+ * This script:
+ * 1. Detects the JavaScript package root (supports both single-language and multi-language repos)
+ * 2. Runs `changeset version` to update package versions
+ * 3. Runs `npm install` to synchronize package-lock.json with the new versions
+ *
+ * Configuration:
+ * - CLI: --js-root <path> to explicitly set JavaScript root
+ * - Environment: JS_ROOT=<path>
+ *
+ * Uses link-foundation libraries:
+ * - use-m: Dynamic package loading without package.json dependencies
+ * - command-stream: Modern shell command execution with streaming support
+ *
+ * Addresses issues documented in:
+ * - Issue #21: Supporting both single and multi-language repository structures
+ * - Reference: link-assistant/agent PR #112 (--legacy-peer-deps fix)
+ * - Reference: link-assistant/agent PR #114 (configurable package root)
+ */
+
+import { getJsRoot, needsCd, parseJsRootConfig } from './js-paths.mjs';
+
+// Load use-m dynamically
+const { use } = eval(
+  await (await fetch('https://unpkg.com/use-m/use.js')).text()
+);
+
+// Import command-stream for shell command execution
+const { $ } = await use('command-stream');
+
+// Store the original working directory to restore after cd commands
+// IMPORTANT: command-stream's cd is a virtual command that calls process.chdir()
+const originalCwd = process.cwd();
+
+try {
+  // Get JavaScript package root (auto-detect or use explicit config)
+  const jsRootConfig = parseJsRootConfig();
+  const jsRoot = getJsRoot({ jsRoot: jsRootConfig, verbose: true });
+
+  console.log('Running changeset version...');
+
+  // IMPORTANT: cd is a virtual command that calls process.chdir(), so we restore after
+  if (needsCd({ jsRoot })) {
+    await $`cd ${jsRoot} && npx changeset version`;
+    process.chdir(originalCwd);
+  } else {
+    await $`npx changeset version`;
+  }
+
+  console.log('\nSynchronizing package-lock.json...');
+
+  // Use --legacy-peer-deps to handle peer dependency conflicts
+  // This addresses npm ERESOLVE errors documented in issue #111 / PR #112
+  if (needsCd({ jsRoot })) {
+    await $`cd ${jsRoot} && npm install --package-lock-only --legacy-peer-deps`;
+    process.chdir(originalCwd);
+  } else {
+    await $`npm install --package-lock-only --legacy-peer-deps`;
+  }
+
+  console.log('\n✅ Version bump complete with synchronized package-lock.json');
+} catch (error) {
+  // Restore cwd on error
+  process.chdir(originalCwd);
+  console.error('Error during version bump:', error.message);
+  if (process.env.DEBUG) {
+    console.error('Stack trace:', error.stack);
+  }
+  process.exit(1);
+}

package/scripts/check-changesets.mjs

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+
+/**
+ * Check for pending changeset files
+ *
+ * This script checks for pending changeset files in the .changeset directory
+ * and outputs the count and status for use in GitHub Actions workflow conditions.
+ *
+ * Usage:
+ *   node scripts/check-changesets.mjs
+ *
+ * Outputs (written to GITHUB_OUTPUT):
+ *   - has_changesets: 'true' if there are pending changesets
+ *   - changeset_count: number of changeset files found
+ */
+
+import { readdirSync, existsSync, appendFileSync } from 'fs';
+
+const CHANGESET_DIR = '.changeset';
+
+/**
+ * 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}`);
+}
+
+/**
+ * Count changeset files in the .changeset directory
+ * @returns {number} Number of changeset files found
+ */
+function countChangesetFiles() {
+  if (!existsSync(CHANGESET_DIR)) {
+    return 0;
+  }
+
+  const files = readdirSync(CHANGESET_DIR);
+  // Filter to only count .md files, excluding README.md
+  const changesetFiles = files.filter(
+    (file) => file.endsWith('.md') && file !== 'README.md'
+  );
+
+  return changesetFiles.length;
+}
+
+/**
+ * Main function to check for changesets
+ */
+function checkChangesets() {
+  console.log('Checking for pending changeset files...\n');
+
+  const changesetCount = countChangesetFiles();
+
+  console.log(`Found ${changesetCount} changeset file(s)`);
+
+  setOutput('has_changesets', changesetCount > 0 ? 'true' : 'false');
+  setOutput('changeset_count', String(changesetCount));
+}
+
+// Run the check
+checkChangesets();

package/scripts/check-version.mjs

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+
+/**
+ * Check for manual version modifications in package.json
+ *
+ * This script prevents manual version changes in pull requests.
+ * Versions should only be changed by the CI/CD pipeline using changesets.
+ *
+ * Key behavior:
+ * - For PRs: compares PR head against base branch to detect version changes
+ * - Skips check for automated release PRs (changeset-release/* branches)
+ * - Fails the build if manual version changes are detected
+ *
+ * Usage:
+ *   node scripts/check-version.mjs
+ *
+ * Environment variables (set by GitHub Actions):
+ *   - GITHUB_HEAD_REF: Branch name of the PR head
+ *   - GITHUB_BASE_REF: Branch name of the PR base
+ *
+ * Exit codes:
+ *   - 0: No manual version changes detected (or skipped for release PRs)
+ *   - 1: Manual version changes detected
+ */
+
+import { execSync } from 'child_process';
+
+/**
+ * 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 '';
+  }
+}
+
+/**
+ * Check if this is an automated release PR that should skip version check
+ * @returns {boolean} True if version check should be skipped
+ */
+function shouldSkipVersionCheck() {
+  const headRef = process.env.GITHUB_HEAD_REF || '';
+
+  // Skip check for automated release PRs created by changeset
+  const skipPatterns = ['changeset-release/', 'changeset-manual-release-'];
+
+  for (const pattern of skipPatterns) {
+    if (headRef.startsWith(pattern)) {
+      return true;
+    }
+  }
+
+  return false;
+}
+
+/**
+ * Get the version diff from package.json
+ * @returns {string} The version diff line if found, empty string otherwise
+ */
+function getVersionDiff() {
+  const baseRef = process.env.GITHUB_BASE_REF || 'main';
+
+  // Get the diff for package.json, looking for added lines with "version"
+  const diffCommand = `git diff origin/${baseRef}...HEAD -- package.json`;
+  const diff = exec(diffCommand);
+
+  if (!diff) {
+    return '';
+  }
+
+  // Look for added lines (starting with +) containing "version"
+  // Match pattern: +"version": "x.y.z"
+  const versionChangePattern = /^\+\s*"version"\s*:\s*"[^"]+"/m;
+  const match = diff.match(versionChangePattern);
+
+  return match ? match[0] : '';
+}
+
+/**
+ * Main function to check for version changes
+ */
+function checkVersion() {
+  console.log('Checking for manual version changes in package.json...\n');
+
+  // Check if we should skip the version check
+  if (shouldSkipVersionCheck()) {
+    const headRef = process.env.GITHUB_HEAD_REF || '';
+    console.log(`Skipping version check for automated release PR: ${headRef}`);
+    process.exit(0);
+  }
+
+  // Get the version diff
+  const versionDiff = getVersionDiff();
+
+  if (versionDiff) {
+    console.error('::error::Manual version change detected in package.json');
+    console.error('');
+    console.error(
+      'Version changes in package.json are prohibited in pull requests.'
+    );
+    console.error(
+      'Versions are managed automatically by the CI/CD pipeline using changesets.'
+    );
+    console.error('');
+    console.error('To request a release:');
+    console.error(
+      '  1. Add a changeset file describing your changes (npx changeset)'
+    );
+    console.error(
+      '  2. The release workflow will automatically bump the version when merged'
+    );
+    console.error('');
+    console.error('Detected change:');
+    console.error(versionDiff);
+    process.exit(1);
+  }
+
+  console.log('No manual version changes detected - check passed');
+  process.exit(0);
+}
+
+// Run the check
+checkVersion();