Reckonable Residence Calculator

KotlinGradleImmigrationCLI GitHub

White doves soaring over houses

Overview

A personal tool built to estimate eligibility for Irish citizenship by naturalisation. It takes IRP stamp periods and travel history as input and works out how many reckonable residence days you have accumulated — accounting for absences and the 70-day annual excuse allowance.

What It Does

  • Tracks IRP (Irish Residence Permit) validity periods from a YAML config file.
  • Reads international travel history (departure/return dates, destinations) from a CSV file.
  • Breaks down absences year-by-year and applies the 70-day excuse allowance per year.
  • Computes progress toward the five-year / 1,826-day residence requirement.
  • Generates a Markdown report with an estimated earliest application date, both with and without excuses applied.

Usage

Configure irp_info.yaml with your IRP details and travels.csv with your travel history, then run via Gradle. Requires Java 17+.

Disclaimer: This tool is unofficial and has no affiliation with the Irish Department of Justice or any government immigration service. Always verify with official sources or a qualified solicitor.