research_library.py

"""Curated Collection metadata rendered by the NEURAL LAB dashboard."""

from __future__ import annotations

from dataclasses import dataclass
from html import escape


@dataclass(frozen=True)
class ResearchCollection:
    title: str
    focus: str
    count: int
    first_party: str
    url: str


COLLECTIONS: dict[str, ResearchCollection] = {
    "Transformer Foundations": ResearchCollection(
        title="KRAZYKITTY // TRANSFORMER FOUNDATIONS",
        focus="Attention, bidirectional representation, autoregressive scaling, and compact open baselines.",
        count=7,
        first_party="KittyLM Research",
        url="https://huggingface.co/collections/KrazyKitty/krazykitty-transformer-foundations-6acbaca0f392f5a1fc1e9650",
    ),
    "Model Training": ResearchCollection(
        title="KRAZYKITTY // MODEL TRAINING",
        focus="Compute allocation, parameter-efficient adaptation, quantised finetuning, and preference optimisation.",
        count=7,
        first_party="KittyLM Research",
        url="https://huggingface.co/collections/KrazyKitty/krazykitty-model-training-6acbacafe431a8f2d5adcb5f",
    ),
    "Data Provenance & Evaluation": ResearchCollection(
        title="KRAZYKITTY // DATA PROVENANCE & EVALUATION",
        focus="Corpus construction, source governance, filtering research, benchmark documentation, and contamination-aware evaluation.",
        count=8,
        first_party="KRAZYKITTY // DATA LAB",
        url="https://huggingface.co/collections/KrazyKitty/krazykitty-data-provenance-and-evaluation-6acbacbf0fdd3575a61550e6",
    ),
    "Agent Systems": ResearchCollection(
        title="NEKO//AGENT — AGENT SYSTEMS",
        focus="Reasoning with actions, learned tool use, reflection, agent-computer interfaces, and executable evaluation.",
        count=8,
        first_party="NEKO//AGENT Research",
        url="https://huggingface.co/collections/KrazyKitty/neko-agent-agent-systems-6acbacd0a0d63e6bb904c0e2",
    ),
}


def collection_choices() -> list[str]:
    return list(COLLECTIONS)


def render_collection(name: str) -> str:
    collection = COLLECTIONS.get(name, COLLECTIONS["Transformer Foundations"])
    return f"""
    <article class="collection-detail" aria-live="polite">
      <span class="detail-eyebrow">VERIFIED PUBLIC COLLECTION</span>
      <h3>{escape(collection.title)}</h3>
      <p>{escape(collection.focus)}</p>
      <dl class="collection-facts">
        <div><dt>Curated entries</dt><dd>{collection.count}</dd></div>
        <div><dt>KrazyKitty node</dt><dd>{escape(collection.first_party)}</dd></div>
      </dl>
      <p class="scope-note">Inclusion supports research and does not replace each resource's licence, access, or usage review.</p>
      <a class="project-link" href="{escape(collection.url)}" target="_blank" rel="noreferrer">Open Collection <span aria-hidden="true">↗</span></a>
    </article>
    """