NAME

App::karr::Foundation::State - karr-foundation per-repo state -- lock file, JSON state, cooldown backoff

VERSION

version 0.600

DESCRIPTION

App::karr::Foundation::State owns the gitignored per-repo sidecar files that App::karr::Foundation keeps outside the board: the advisory .karr.lock, the JSON .karr.state (board hash, per-task attempt counters, cooldown), and the exponential cooldown backoff applied after a common-error run. It holds a weak back-reference to the owning foundation for shared options (dry_run) and helpers (_say_verbose).

foundation

The owning App::karr::Foundation instance, held weak_ref to avoid a reference cycle. Supplies dry_run (every writing method here is a no-op under it) and _say_verbose, and holds the open lock filehandles this class's lock methods stash and recover between acquire and release.

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/karr/issues.

IRC

Join #langertha on irc.perl.org or message Getty directly.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <getty@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2026 by Torsten Raudssus <torsten@raudssus.de> https://raudssus.de/.

This is free software, licensed under:

The Artistic License 2.0 (GPL Compatible)