Bound CNPJ generator retries after check-digit failures

[coderabbitai]

Summary

Bound retries when CNPJ check-digit generation raises CnpjDV::DomainError.

CnpjGen::CnpjGenerator#with_check_digits currently retries by recursively re-entering #generate. If generated bases continue to be rejected, this can exhaust the Ruby call stack with SystemStackError rather than producing a deterministic failure.

Required changes

• Refactor the retry flow in packages/cnpj-gen/src/cnpj-gen/cnpj_generator.rb into a private helper that tracks the number of attempts.
• Preserve the original per-call options argument and keyword overrides for every retry.
• Define a finite retry limit and raise a deterministic terminal error once it is reached.
• Add focused tests for successful retry, retry-limit exhaustion, and preservation of the original call arguments/options.

Rationale

This prevents unbounded recursion while retaining the existing behavior of regenerating a CNPJ when check-digit calculation rejects a generated base.

Affected area

• packages/cnpj-gen/src/cnpj-gen/cnpj_generator.rb
• Associated generator specs under packages/cnpj-gen/tests/

Acceptance criteria

• A repeated CnpjDV::DomainError cannot cause unbounded recursion or SystemStackError.
• Retries are limited to a documented/configured finite number of attempts.
• Successful retries retain the original option resolution behavior.
• Exhausting the limit raises a predictable, test-covered error.

Backlinks

• Pull request: [cnpj-gen] Create package to generate valid CNPJ #17
• Review discussion: [cnpj-gen] Create package to generate valid CNPJ #17 (comment)
• Requested by: @juliolmuller

[coderabbitai]

🔗 Related PRs

#15 - [cnpj dv] Create package to calculate CNPJ check digits [merged]
#16 - [cnpj fmt] Create package to format CNPJ [merged]
#17 - [cnpj-gen] Create package to generate valid CNPJ [open]
#18 - Standardize CNPJ-DV and CNPJ-Fmt Error Hierarchies [open]

---

📝 Issue Planner

_{Check the box below or use the @coderabbitai plan command to generate an implementation plan and prompts that you can use with your favorite coding assistant.}

• Create Plan

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!