Utilities

/**
 * Parse command-line arguments into categorized objects
 * @returns Object with parsed CLI options, answers, and git pass-through parameters
 */
function parseArgs(): {
  cliAnswers: Partial<Answers>;
  cliOptions: CLIOptions;
  passThroughParams: Record<string, string | boolean>;
};

interface CLIOptions {
  /** Disable emoji in commit messages */
  disableEmoji?: boolean;
  /** Preview mode without executing git commit */
  dryRun?: boolean;
  /** Custom format template string */
  format?: string;
  /** Show help screen and exit */
  help?: boolean;
  /** Git hook mode - exit after writing message file */
  hook?: boolean;
  /** Run in non-interactive mode */
  nonInteractive?: boolean;
  /** Show version and exit */
  version?: boolean;
}

/**
 * Populate application state with answers for automated execution
 * @param state - Application state object to modify
 * @param answers - Answer values with automatic defaults
 */
function runNonInteractiveMode(
  state: State, 
  answers: NonInteractiveAnswers
): void;

interface NonInteractiveAnswers {
  /** Commit type - defaults to "chore" if not provided */
  type?: string;
  /** Commit subject - defaults to "automated commit" if not provided */
  subject?: string;
  /** Optional commit scope */
  scope?: string;
  /** Optional extended description */
  body?: string;
  /** Optional breaking changes description */
  breaking?: string;
  /** Optional GitHub issues references */
  issues?: string;
  /** Optional Lerna packages affected */
  lerna?: string;
}

/**
 * Get the root directory of the current git repository
 * @returns Absolute path to the git repository root directory
 * @throws Error if current directory is not in a git repository
 */
function getGitRootDir(): string;

/**
 * Get the .git directory path for the current repository
 * @returns Absolute path to the .git directory
 */
function getGitDir(): string;

/**
 * Lerna utilities for monorepo package management
 */
interface LernaUtils {
  /**
   * Check if the current project is a Lerna monorepo
   * @param state - Application state with root directory
   * @returns True if Lerna configuration is detected
   */
  isLerna(state: State): boolean;

  /**
   * Get all packages in the Lerna monorepo
   * @param state - Application state with root directory
   * @returns Array of package names found in the workspace
   */
  getAllPackages(state: State): string[];

  /**
   * Get packages with uncommitted changes in the Lerna monorepo
   * @param state - Application state with root directory
   * @returns Array of package names with detected changes
   */
  getChangedPackages(state: State): string[];
}

// Import individual functions
const { isLerna, getAllPackages, getChangedPackages } = require("git-cz/lib/util/lerna");

const parseArgs = require('git-cz/lib/parseArgs');

// Parse current process arguments
const { cliAnswers, cliOptions, passThroughParams } = parseArgs();

console.log('CLI Options:', cliOptions);
// { nonInteractive: true, disableEmoji: false, dryRun: true }

console.log('Pre-filled Answers:', cliAnswers);
// { type: 'feat', subject: 'add new feature', scope: 'auth' }

console.log('Git Pass-through:', passThroughParams);
// { amend: true, 'allow-empty': true }

const createState = require('git-cz/lib/createState');
const runNonInteractiveMode = require('git-cz/lib/runNonInteractiveMode');
const formatCommitMessage = require('git-cz/lib/formatCommitMessage');

// Automated commit workflow
const state = createState();

runNonInteractiveMode(state, {
  type: 'fix',
  scope: 'auth',
  subject: 'resolve token refresh issue',
  body: 'Fixed OAuth token refresh timing bug that caused authentication failures',
  issues: '#456'
});

const message = formatCommitMessage(state);
console.log(message);
// fix(auth): 🐛 resolve token refresh issue
//
// Fixed OAuth token refresh timing bug that caused authentication failures
//
// ✅ Closes: #456

const getGitRootDir = require('git-cz/lib/util/getGitRootDir');
const getGitDir = require('git-cz/lib/util/getGitDir');

try {
  const rootDir = getGitRootDir();
  const gitDir = getGitDir();
  
  console.log('Repository root:', rootDir);
  // /Users/developer/projects/my-app
  
  console.log('Git directory:', gitDir);
  // /Users/developer/projects/my-app/.git
  
} catch (error) {
  console.error('Not in a git repository:', error.message);
}

const createState = require('git-cz/lib/createState');
const { isLerna, getAllPackages, getChangedPackages } = require('git-cz/lib/util/lerna');

const state = createState();

if (isLerna(state)) {
  console.log('Lerna monorepo detected');
  
  const allPackages = getAllPackages(state);
  console.log('All packages:', allPackages);
  // ['@myorg/core', '@myorg/utils', '@myorg/cli', '@myorg/docs']
  
  const changedPackages = getChangedPackages(state);
  console.log('Changed packages:', changedPackages);
  // ['@myorg/core', '@myorg/utils']
  
} else {
  console.log('Not a Lerna monorepo');
}

const parseArgs = require('git-cz/lib/parseArgs');
const createState = require('git-cz/lib/createState');
const runNonInteractiveMode = require('git-cz/lib/runNonInteractiveMode');
const runInteractiveQuestions = require('git-cz/lib/runInteractiveQuestions');
const formatCommitMessage = require('git-cz/lib/formatCommitMessage');

async function customGitCz() {
  // Parse command line arguments
  const { cliAnswers, cliOptions, passThroughParams } = parseArgs();
  
  // Create application state
  const state = createState({
    disableEmoji: cliOptions.disableEmoji,
    format: cliOptions.format
  });
  
  // Handle interactive vs non-interactive mode
  if (cliOptions.nonInteractive) {
    runNonInteractiveMode(state, cliAnswers);
  } else {
    await runInteractiveQuestions(state, cliAnswers);
  }
  
  // Generate commit message
  const message = formatCommitMessage(state);
  
  if (cliOptions.dryRun) {
    console.log('Would commit with message:');
    console.log(message);
  } else {
    // Execute git commit with pass-through parameters
    console.log('Committing with message:', message);
  }
}