NAME
Langertha::Holmgang::Suite - A suite: head, tools, defaults and its cases in load order
VERSION
version 0.001
SYNOPSIS
my $suite = Langertha::Holmgang::Loader->new->load('/srv/suites/example-lamp');
$suite->id; # 'example-lamp'
$suite->topic; # 'sonstiges' without one
$suite->cases; # [ Langertha::Holmgang::Case, … ] in file-name order
$suite->digest; # sha256 over the files and the generated texts
$suite->case('c1'); # one case by id
DESCRIPTION
The head of suite format 2 (suite.yaml) with its cases. Field names are format 2's (ADR 0005); format: 2 is a property of the file, not of the structure. Built by Langertha::Holmgang::Structure through the loader or the DSL.
id
Required. [a-z0-9-], the directory name in format 2.
topic
The axis of every evaluation; sonstiges without one.
version
The suite's version, an integer from 1 up; format 2 requires it.
title
Required. The suite's title, a non-empty text.
description
Optional free text describing the suite, or undef.
license
Optional license text of the suite, or undef.
source
{ title, authors, license, url, location }.
threshold
{ pass_rate, pass_k } (each optional, 0..1) or undef.
repeat
How often a run repeats the suite by default (1..100), or undef.
digest
SHA-256 (hex) over the file names and bytes of suite.yaml and every case file, plus the generated texts — the same value, under the same name, that cai-platform computes as its digest, and the suite.digest of a report.
defaults
system, temperature, max_tokens, max_turns as written.
tools
The tools as written in suite.yaml, in file order.
cases
The Langertha::Holmgang::Case objects in load order.
case
my $case = $suite->case('c1');
The case with this id, or undef.
SUPPORT
Issues
Please report bugs and feature requests at https://github.com/Getty/langertha-holmgang/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 <torsten@raudssus.de>
COPYRIGHT AND LICENSE
This software is copyright (c) 2026 by Torsten Raudssus <torsten@raudssus.de> https://raudssus.de/.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.