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.