feat: add Codex AI coding tool support

Add support for detecting Codex AI coding tool through environment
variables CODEX_MANAGED_BY_NPM and CODEX_MANAGED_BY_BUN.

Changes:
- Create src/ai-tools/codex.ts configuration file
- Add Codex to AI tools index with CLI type (highest priority)
- Update test expectations from 8 to 9 tools
- Add comprehensive tests for Codex environment variables:
  * Integration tests for CODEX_MANAGED_BY_NPM and CODEX_MANAGED_BY_BUN
  * Unit tests in exec.test.ts for getCoDevelopedBy function
  * Production build tests for compiled code
  * Installed package tests for npm pack scenarios

The Codex tool is detected when either CODEX_MANAGED_BY_NPM=1 or
CODEX_MANAGED_BY_BUN=1 is set, and will add "Co-developed-by: Codex
<noreply@openai.com>" to commit messages.

Change-Id: Id9ccec1427a942df35a7c0c4ecd3040c28167afa
Co-developed-by: Cursor <noreply@cursor.com>

Author: jiangxin

src/ai-tools/codex.ts

@@ -0,0 +1,13 @@
+import type { AIToolConfig } from './index.js';
+
+const config: AIToolConfig = {
+  type: 'cli',
+  userName: 'Codex',
+  userEmail: 'noreply@openai.com',
+  envVars: [
+    { key: 'CODEX_MANAGED_BY_NPM', value: '1' },
+    { key: 'CODEX_MANAGED_BY_BUN', value: '1' },
+  ],
+};
+
+export default config;

src/ai-tools/index.ts

@@ -69,6 +69,7 @@ function compareByPriority(a: AIToolConfig, b: AIToolConfig): number {
 
 // Import all tool configurations
 import claudeConfig from './claude.js';
+import codexConfig from './codex.js';
 import cursorConfig from './cursor.js';
 import geminiConfig from './gemini.js';
 import iflowConfig from './iflow.js';
@@ -83,6 +84,7 @@ import qwenCodeConfig from './qwen-code.js';
  */
 const allConfigs: AIToolConfig[] = [
   claudeConfig,
+  codexConfig,
   iflowConfig,
   qwenCodeConfig,
   geminiConfig,

test/commands/exec.test.ts

@@ -787,6 +787,20 @@ describe('exec command utilities', () => {
       expect(getCoDevelopedBy()).toBe('iFlow <noreply@iflow.cn>');
     });
 
+    it('should return Codex CoDevelopedBy when CODEX_MANAGED_BY_NPM=1 is set', () => {
+      // Clear all environment variables to ensure proper order testing
+      clearCoDevelopedByEnvVars();
+      process.env.CODEX_MANAGED_BY_NPM = '1';
+      expect(getCoDevelopedBy()).toBe('Codex <noreply@openai.com>');
+    });
+
+    it('should return Codex CoDevelopedBy when CODEX_MANAGED_BY_BUN=1 is set', () => {
+      // Clear all environment variables to ensure proper order testing
+      clearCoDevelopedByEnvVars();
+      process.env.CODEX_MANAGED_BY_BUN = '1';
+      expect(getCoDevelopedBy()).toBe('Codex <noreply@openai.com>');
+    });
+
     it('should return Kiro CoDevelopedBy when __CFBundleIdentifier=dev.kiro.desktop is set', () => {
       // Clear all environment variables to ensure proper order testing
       clearCoDevelopedByEnvVars();

test/integration.test.ts

@@ -310,6 +310,108 @@ This feature uses AI technology to enhance the application.`;
     );
   });
 
+  it('should work with CODEX_MANAGED_BY_NPM environment variable', () => {
+    // Create a commit message file
+    const messageFile = path.join(tempDir, 'codex-npm-message.txt');
+    const commitMessage = `feat: implement feature with Codex
+
+This feature was developed using Codex via npm.`;
+    writeFileSync(messageFile, commitMessage, 'utf8');
+
+    // Test with CODEX_MANAGED_BY_NPM environment variable, but first unset higher priority variables
+    const env = {
+      ...process.env,
+      CLAUDECODE: undefined,
+      CODEX_MANAGED_BY_NPM: '1',
+      QWEN_CODE: undefined,
+      GEMINI_CLI: undefined,
+      VSCODE_BRAND: undefined,
+      CURSOR_TRACE_ID: undefined,
+    };
+
+    // Execute the commit-msg hook directly
+    const execResult = spawnSync(
+      'node',
+      [path.join(originalCwd, 'dist/bin/commit-msg.js'), 'exec', messageFile],
+      {
+        cwd: testRepoDir,
+        encoding: 'utf-8',
+        timeout: 30000,
+        env: env,
+      }
+    );
+
+    expect(execResult.status).toBe(0);
+
+    // Read the processed commit message
+    const processedMessage = readFileSync(messageFile, 'utf8');
+
+    // Should have added Change-Id
+    expect(processedMessage).toMatch(/Change-Id: I[a-f0-9]{8,}/);
+
+    // Should have added Co-developed-by for Codex
+    expect(processedMessage).toContain(
+      'Co-developed-by: Codex <noreply@openai.com>'
+    );
+
+    // Verify original content is preserved
+    expect(processedMessage).toContain('feat: implement feature with Codex');
+    expect(processedMessage).toContain(
+      'This feature was developed using Codex via npm.'
+    );
+  });
+
+  it('should work with CODEX_MANAGED_BY_BUN environment variable', () => {
+    // Create a commit message file
+    const messageFile = path.join(tempDir, 'codex-bun-message.txt');
+    const commitMessage = `feat: implement feature with Codex
+
+This feature was developed using Codex via bun.`;
+    writeFileSync(messageFile, commitMessage, 'utf8');
+
+    // Test with CODEX_MANAGED_BY_BUN environment variable, but first unset higher priority variables
+    const env = {
+      ...process.env,
+      CLAUDECODE: undefined,
+      CODEX_MANAGED_BY_BUN: '1',
+      QWEN_CODE: undefined,
+      GEMINI_CLI: undefined,
+      VSCODE_BRAND: undefined,
+      CURSOR_TRACE_ID: undefined,
+    };
+
+    // Execute the commit-msg hook directly
+    const execResult = spawnSync(
+      'node',
+      [path.join(originalCwd, 'dist/bin/commit-msg.js'), 'exec', messageFile],
+      {
+        cwd: testRepoDir,
+        encoding: 'utf-8',
+        timeout: 30000,
+        env: env,
+      }
+    );
+
+    expect(execResult.status).toBe(0);
+
+    // Read the processed commit message
+    const processedMessage = readFileSync(messageFile, 'utf8');
+
+    // Should have added Change-Id
+    expect(processedMessage).toMatch(/Change-Id: I[a-f0-9]{8,}/);
+
+    // Should have added Co-developed-by for Codex
+    expect(processedMessage).toContain(
+      'Co-developed-by: Codex <noreply@openai.com>'
+    );
+
+    // Verify original content is preserved
+    expect(processedMessage).toContain('feat: implement feature with Codex');
+    expect(processedMessage).toContain(
+      'This feature was developed using Codex via bun.'
+    );
+  });
+
   it('should work with disabled CoDevelopedBy configuration', () => {
     // Create a commit message file
     const messageFile = path.join(tempDir, 'no-co-developed-message.txt');

test/pack.test.ts

@@ -413,6 +413,62 @@ describe('commit-msg CLI npm pack tests', () => {
       );
     });
 
+    it('should generate Co-developed-by for CODEX_MANAGED_BY_NPM in installed package', () => {
+      const messageFile = path.join(tempDir, 'codevelopedby-codex-npm.txt');
+      const commitMessage = 'feat: test codex npm co-developed-by';
+      writeFileSync(messageFile, commitMessage, 'utf8');
+
+      const env = {
+        ...process.env,
+        CODEX_MANAGED_BY_NPM: '1',
+      };
+
+      const execResult = spawnSync(
+        'node',
+        [installedBinPath, 'exec', messageFile],
+        {
+          encoding: 'utf-8',
+          timeout: 30000,
+          env: env,
+        }
+      );
+
+      expect(execResult.status).toBe(0);
+
+      const processedMessage = readFileSync(messageFile, 'utf8');
+      expect(processedMessage).toContain(
+        'Co-developed-by: Codex <noreply@openai.com>'
+      );
+    });
+
+    it('should generate Co-developed-by for CODEX_MANAGED_BY_BUN in installed package', () => {
+      const messageFile = path.join(tempDir, 'codevelopedby-codex-bun.txt');
+      const commitMessage = 'feat: test codex bun co-developed-by';
+      writeFileSync(messageFile, commitMessage, 'utf8');
+
+      const env = {
+        ...process.env,
+        CODEX_MANAGED_BY_BUN: '1',
+      };
+
+      const execResult = spawnSync(
+        'node',
+        [installedBinPath, 'exec', messageFile],
+        {
+          encoding: 'utf-8',
+          timeout: 30000,
+          env: env,
+        }
+      );
+
+      expect(execResult.status).toBe(0);
+
+      const processedMessage = readFileSync(messageFile, 'utf8');
+      expect(processedMessage).toContain(
+        'Co-developed-by: Codex <noreply@openai.com>'
+      );
+    });
+
     it('should respect priority order (CLI over IDE) in installed package', () => {
       const messageFile = path.join(tempDir, 'priority-test.txt');
       const commitMessage = 'feat: test priority';
@@ -462,7 +518,7 @@ describe('commit-msg CLI npm pack tests', () => {
       const configs = installedAITools.getAllToolConfigs();
       expect(configs).toBeDefined();
       expect(Array.isArray(configs)).toBe(true);
-      expect(configs.length).toBe(8); // Should have 8 tools
+      expect(configs.length).toBe(9); // Should have 9 tools
 
       // Verify all configs have required fields
       for (const config of configs) {

test/production-build.test.ts

@@ -52,8 +52,8 @@ describe('Production Build Tests', () => {
   describe('Configuration Structure Tests', () => {
     it('should have correct number of tool configurations', () => {
       const configs = productionAITools.getAllToolConfigs();
-      // Should have 8 tools: claude, iflow, qwen-code, gemini, qoder-cli, cursor, kiro, qoder-ide
-      expect(configs.length).toBe(8);
+      // Should have 9 tools: claude, codex, iflow, qwen-code, gemini, qoder-cli, cursor, kiro, qoder-ide
+      expect(configs.length).toBe(9);
     });
 
     it('should have all required fields in each configuration', () => {
@@ -123,6 +123,7 @@ describe('Production Build Tests', () => {
       const configs = productionAITools.getAllToolConfigs();
       const toolNames = configs.map((c) => c.userName);
       const expectedTools = [
+        'Codex',
         'Claude',
         'iFlow',
         'Qwen-Coder',
@@ -196,6 +197,20 @@ describe('Production Build Tests', () => {
       expect(result).toBe('Cursor <noreply@cursor.com>');
     });
 
+    it('should return Codex CoDevelopedBy when CODEX_MANAGED_BY_NPM=1 is set', () => {
+      productionExec.clearCoDevelopedByEnvVars();
+      process.env.CODEX_MANAGED_BY_NPM = '1';
+      const result = productionExec.getCoDevelopedBy();
+      expect(result).toBe('Codex <noreply@openai.com>');
+    });
+
+    it('should return Codex CoDevelopedBy when CODEX_MANAGED_BY_BUN=1 is set', () => {
+      productionExec.clearCoDevelopedByEnvVars();
+      process.env.CODEX_MANAGED_BY_BUN = '1';
+      const result = productionExec.getCoDevelopedBy();
+      expect(result).toBe('Codex <noreply@openai.com>');
+    });
+
     it('should return Kiro CoDevelopedBy when __CFBundleIdentifier=dev.kiro.desktop is set', () => {
       productionExec.clearCoDevelopedByEnvVars();
       process.env.__CFBundleIdentifier = 'dev.kiro.desktop';