Add an accounting period

Add an accounting period

Add creates a new period row in state future. The period does not accept postings until it is opened. You can add multiple periods in advance (e.g. all months for the year) and then open them in sequence as you need them.

Owner: bus period.

Run bus period add --period <YYYY-MM> (or YYYY / YYYYQn). Optional --start-date and --end-date override the dates derived from the period identifier; optional --retained-earnings-account sets the account used for closing and opening balance. The period must not already exist; if it does, the command exits with a clear diagnostic.