licenseguard-cli 2.2.0 → 2.3.1

package/.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git remote:*)"
+    ]
+  }
+}

package/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.3.0] - 2026-02-21
+
+### Added
+
+- **ESM (ECMAScript Module) Support** - Git hooks now work in ESM projects
+  - Auto-detects ESM projects via `package.json` `"type": "module"`
+  - Generates ESM-compatible git hooks using `import` syntax for ESM projects
+  - Generates CommonJS hooks using `require` syntax for CJS projects
+  - `isEsmProject()` utility function for ESM detection
+  - ESM hook generators: `generatePostCheckoutScriptEsm()`, `generatePreCommitScriptEsm()`
+  - ESM global hooks in `postinstall.js` for `npm install -g` compatibility
+  - Full test coverage: 23 unit tests + 5 integration tests
+  - Backward compatible - existing CJS projects unaffected
+
 ## [2.2.0] - 2025-11-25
 
 ### Added

package/lib/postinstall.js

@@ -15,7 +15,10 @@ const templateDir = path.join(homeDir, '.git-templates')
 const hooksDir = path.join(templateDir, 'hooks')
 
 // Self-contained hook scripts (only needs Node.js, not licenseguard)
-const postCheckoutHook = `#!/usr/bin/env node
+
+// CommonJS hook generators
+function generatePostCheckoutHookCjs() {
+  return `#!/usr/bin/env node
 const fs = require('fs')
 const path = require('path')
 
@@ -33,8 +36,10 @@ try {
 }
 process.exit(0)
 `
+}
 
-const preCommitHook = `#!/usr/bin/env node
+function generatePreCommitHookCjs() {
+  return `#!/usr/bin/env node
 const fs = require('fs')
 const path = require('path')
 
@@ -52,6 +57,50 @@ try {
 }
 process.exit(0)
 `
+}
+
+// ESM hook generators
+function generatePostCheckoutHookEsm() {
+  return `#!/usr/bin/env node
+import fs from 'fs'
+import path from 'path'
+
+try {
+  const configPath = path.join(process.cwd(), '.licenseguardrc')
+  if (!fs.existsSync(configPath)) process.exit(0)
+
+  const config = JSON.parse(fs.readFileSync(configPath, 'utf8'))
+  const blue = '\\x1b[34m'
+  const reset = '\\x1b[0m'
+
+  console.log(\`\${blue}📜 This project uses \${config.license.toUpperCase()} License by \${config.owner}\${reset}\`)
+} catch (e) {
+  // Silent fail - never block git
+}
+process.exit(0)
+`
+}
+
+function generatePreCommitHookEsm() {
+  return `#!/usr/bin/env node
+import fs from 'fs'
+import path from 'path'
+
+try {
+  const configPath = path.join(process.cwd(), '.licenseguardrc')
+  if (!fs.existsSync(configPath)) process.exit(0)
+
+  const config = JSON.parse(fs.readFileSync(configPath, 'utf8'))
+  const blue = '\\x1b[34m'
+  const reset = '\\x1b[0m'
+
+  console.log(\`\${blue}ℹ️  Reminder: This project is licensed under \${config.license.toUpperCase()}\${reset}\`)
+} catch (e) {
+  // Silent fail - never block git
+}
+process.exit(0)
+`
+}
 
 function setupGlobalHooks() {
   try {
@@ -68,6 +117,11 @@ function setupGlobalHooks() {
       return
     }
 
+    // Always use ESM for global hooks - ESM works in both ESM and CJS projects
+    // CJS hooks fail in ESM projects, but ESM hooks work everywhere
+    const postCheckoutHook = generatePostCheckoutHookEsm()
+    const preCommitHook = generatePreCommitHookEsm()
+
     // Create template directories
     if (!fs.existsSync(hooksDir)) {
       fs.mkdirSync(hooksDir, { recursive: true })

package/lib/utils/git-helpers.js

@@ -15,6 +15,22 @@ function isGitRepo() {
   }
 }
 
+/**
+ * Check if current project is an ESM (ECMAScript Module) project
+ * @returns {boolean} true if package.json has "type": "module"
+ */
+function isEsmProject() {
+  try {
+    if (!fs.existsSync('package.json')) {
+      return false
+    }
+    const pkg = JSON.parse(fs.readFileSync('package.json', 'utf-8'))
+    return pkg.type === 'module'
+  } catch (error) {
+    return false
+  }
+}
+
 /**
  * Initialize a git repository in the current directory
  * @returns {boolean} true if git init succeeded
@@ -36,6 +52,7 @@ function initGitRepo() {
 function installHooks() {
   try {
     const hooksDir = path.join('.git', 'hooks')
+    const isEsm = isEsmProject()
 
     // Ensure hooks directory exists
     if (!fs.existsSync(hooksDir)) {
@@ -43,8 +60,8 @@ function installHooks() {
     }
 
     const hooks = [
-      { name: 'post-checkout', script: generatePostCheckoutScript() },
-      { name: 'pre-commit', script: generatePreCommitScript() },
+      { name: 'post-checkout', script: isEsm ? generatePostCheckoutScriptEsm() : generatePostCheckoutScript() },
+      { name: 'pre-commit', script: isEsm ? generatePreCommitScriptEsm() : generatePreCommitScript() },
     ]
 
     let hasConflicts = false
@@ -167,8 +184,91 @@ try {
 `
 }
 
+/**
+ * Generate post-checkout hook script (ESM version)
+ * @returns {string} Hook script content
+ */
+function generatePostCheckoutScriptEsm() {
+  return `#!/usr/bin/env node
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+try {
+  // Read .licenseguardrc from project root (relative to .git/hooks/)
+  const configPath = path.resolve(__dirname, '..', '..', '.licenseguardrc')
+
+  if (!fs.existsSync(configPath)) {
+    // No config file, silently exit
+    process.exit(0)
+  }
+
+  const configContent = fs.readFileSync(configPath, 'utf8')
+  const config = JSON.parse(configContent)
+
+  // Display license notification with color
+  const blue = '\\x1b[34m'
+  const reset = '\\x1b[0m'
+
+  console.log(\`\${blue}📜 This project uses \${config.license.toUpperCase()} License by \${config.owner}\${reset}\`)
+
+  process.exit(0)
+} catch (error) {
+  // Errors should not block git operations
+  process.exit(0)
+}
+`
+}
+
+/**
+ * Generate pre-commit hook script (ESM version)
+ * @returns {string} Hook script content
+ */
+function generatePreCommitScriptEsm() {
+  return `#!/usr/bin/env node
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+try {
+  // Read .licenseguardrc from project root (relative to .git/hooks/)
+  const configPath = path.resolve(__dirname, '..', '..', '.licenseguardrc')
+
+  if (!fs.existsSync(configPath)) {
+    // No config file, silently exit
+    process.exit(0)
+  }
+
+  const configContent = fs.readFileSync(configPath, 'utf8')
+  const config = JSON.parse(configContent)
+
+  // Display license reminder with color
+  const blue = '\\x1b[34m'
+  const reset = '\\x1b[0m'
+
+  console.log(\`\${blue}ℹ️  Reminder: This project is licensed under \${config.license.toUpperCase()}\${reset}\`)
+
+  process.exit(0)
+} catch (error) {
+  // Errors should not block git operations
+  process.exit(0)
+}
+`
+}
+
 module.exports = {
   isGitRepo,
   initGitRepo,
   installHooks,
+  isEsmProject,
+  generatePostCheckoutScript,
+  generatePreCommitScript,
+  generatePostCheckoutScriptEsm,
+  generatePreCommitScriptEsm,
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "licenseguard-cli",
-  "version": "2.2.0",
+  "version": "2.3.1",
   "description": "License setup & compliance guard for developers",
   "bin": {
     "licenseguard": "bin/licenseguard.js"