/**
 * Result of increment number validation
 */
export interface IncrementValidationResult {
    /** Whether the increment number is valid */
    isValid: boolean;
    /** Warnings about the increment number */
    warnings: string[];
    /** Suggestions for better numbering */
    suggestions: string[];
    /** Expected sequential number */
    expectedNumber?: string;
    /** Number provided by user */
    providedNumber?: string;
}
/**
 * Parses an increment number from an increment ID.
 *
 * @param incrementId - Full increment ID (e.g., "0157-feature-name")
 * @returns Numeric value or null if invalid format
 *
 * @example
 * ```typescript
 * parseIncrementNumber("0157-feature-name") // => 157
 * parseIncrementNumber("invalid") // => null
 * ```
 */
export declare function parseIncrementNumber(incrementId: string): number | null;
/**
 * Validates an increment number against existing increments.
 *
 * Checks if the requested number is:
 * - Sequential (expected behavior)
 * - A forward jump (skips numbers)
 * - A backfill (fills gap in numbering)
 *
 * @param requestedNumber - Requested increment number (e.g., "0158")
 * @param existingIncrements - Array of existing increment IDs
 * @returns Validation result with warnings and suggestions
 *
 * @example
 * ```typescript
 * const result = validateIncrementNumber("0160", ["0157-feature", "0158-bug"]);
 * // result.warnings: ["Skipping 1 number (0159)"]
 * // result.suggestions: ["Consider using 0159 for better tracking"]
 * ```
 */
export declare function validateIncrementNumber(requestedNumber: string, existingIncrements: string[]): IncrementValidationResult;
/**
 * Logs increment validation results to console.
 *
 * @param result - Validation result from validateIncrementNumber
 */
export declare function logValidationResult(result: IncrementValidationResult): void;
//# sourceMappingURL=increment-validator.d.ts.map