build_tools.syllable_walk_web.services.walk_generator

Walk generation service for the web application.

Generates syllable walks using the existing SyllableWalker.

Functions

generate_walks(walker, *[, profile, steps, count, ...])

Generate walks using the SyllableWalker.

Module Contents

build_tools.syllable_walk_web.services.walk_generator.generate_walks(walker, *, profile=None, steps=5, count=2, max_flips=2, temperature=0.7, frequency_weight=0.0, neighbor_limit=10, min_length=2, max_length=5, seed=None)[source]

Generate walks using the SyllableWalker.

If profile is given, uses walk_from_profile. Otherwise uses explicit parameters via walk.

Parameters:

  • walker (Any) – Initialised SyllableWalker instance.

  • profile (str | None) – Named profile (clerical/dialect/goblin/ritual) or None.

  • steps (int) – Number of walk steps (name length = steps + 1).

  • count (int) – Number of walks to generate.

  • max_flips (int) – Maximum feature flips per step.

  • temperature (float) – Exploration temperature (0.1–5.0).

  • frequency_weight (float) – Frequency bias (-2.0 to 2.0).

  • neighbor_limit (int | None) – Max neighbors to consider per step; None disables cap.

  • min_length (int | None) – Minimum syllable length filter; None disables bound.

  • max_length (int | None) – Maximum syllable length filter; None disables bound.

  • seed (int | None) – Optional seed for determinism.

Returns:

formatted (str), syllables (list[str]), steps (list[dict]).

Return type:

List of walk result dicts, each with keys

Raises:

ValueError – If requested constraints are invalid.