/ 
App-karr-0.600
/ App::karr::Foundation::Overview

NAME

App::karr::Foundation::Overview - karr-foundation read-only overview -- multi-board status dashboard

VERSION

version 0.600

DESCRIPTION

App::karr::Foundation::Overview renders the read-only cross-board dashboard shown by karr-foundation --status and whenever no board has an agent configured: per repo it prints the task-status counts, the in-progress and blocked task ids, and disabled / lock / cooldown / agent flags. A board that opted out of automated agent runs (karr disable) is shown with a disabled flag and a disabled: line carrying its reason; its agent flag is suppressed, because no agent runs there. A board in cooldown carries the remaining wait and the error that caused it (cooldown 240s (rate limit)), since a parked board is a board doing nothing. A weak back-reference to the owning foundation supplies the board data and state helpers.

Where the local config defines named agents (App::karr::Foundation::Agents) the boards are followed by one Agents block: per agent ok, or failing since X, next attempt at Y with the error that caused it. That block is the whole visible half of availability probing -- an outage nobody can see is an outage nobody fixes. With --verbose each agent also prints its kind and its prose description, which is otherwise carried purely for the coordination agent that routes work.

foundation

The owning App::karr::Foundation instance, held weak_ref to avoid a reference cycle. Supplies the per-repo board data, state helpers, agent registry, and question mailbox this dashboard reads.

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)