Function run_deck_create

openkb/deck/creator.py:42–122

Compile a single deck from the KB's wiki via the chosen skill. Args: skill_name: Which deck skill to run. Defaults to the built-in ``openkb-deck-neon``. Pass ``"deck-guizang-editorial"`` etc. to route to a third-party skill installed under ``~/.openkb

(
    *,
    kb_dir: Path,
    deck_name: str,
    intent: str,
    model: str,
    critique: bool,
    skill_name: str = DEFAULT_DECK_SKILL,
)

async def run_deck_create(
    *,
    kb_dir: Path,
    deck_name: str,
    intent: str,
    model: str,
    critique: bool,
    skill_name: str = DEFAULT_DECK_SKILL,
) -> SkillRunResult:
    """Compile a single deck from the KB's wiki via the chosen skill.

    Args:
        skill_name: Which deck skill to run. Defaults to the built-in
            ``openkb-deck-neon``. Pass ``"deck-guizang-editorial"``
            etc. to route to a third-party skill installed under
            ``~/.openkb/skills/``.

    Returns the :class:`SkillRunResult` from the producer skill (carries
    ``output_path`` and ``validation`` populated by ``run_skill`` per
    the skill's frontmatter contract).

    Raises ``RuntimeError`` if the skill is missing, hits the turn cap,
    or doesn't write its declared output path.

    When ``critique=True`` the html-critic skill runs as a second pass
    on the produced file. Missing critic skill is a soft failure (the
    deck still ships, just unpatched).
    """
    # Ensure the conventional deck dir exists. Skills that use
    # output_path_template = "output/decks/{slug}/index.html" need this;
    # skills that pick their own location won't be hindered.
    deck_root = deck_dir(kb_dir, deck_name)
    deck_root.mkdir(parents=True, exist_ok=True)

    try:
        result = await run_skill(
            skill_name=skill_name,
            intent=intent,
            kb_dir=kb_dir,
            model=model,
            slug=deck_name,
            max_turns=MAX_TURNS_WITH_CRITIQUE if critique else MAX_TURNS,
        )
    except SkillNotFoundError as exc:
        raise RuntimeError(
            f"Deck skill {skill_name!r} is not installed. "
            f"Drop a SKILL.md into ~/.openkb/skills/{skill_name}/ (or "
            f"<kb>/skills/{skill_name}/) and re-run."
        ) from exc

    if critique:
        # The producer's output_path tells the critic which file to patch.
        # If the producer didn't template a path, fall back to the
        # conventional location.
        #
        # ``result.output_path`` is already ``.resolve()``-d by run_skill;
        # ``kb_dir`` may still hold an un-resolved form (e.g. ``/tmp/...``
        # on macOS where ``/tmp`` symlinks to ``/private/tmp``). Resolve