vibeview.kinds

Kind registry — the four-rule partial-support contract.

Rule 1

Supported kinds are declared explicitly in a single constant.

Rule 2

Unknown kinds are classified as “skipped, unsupported”; kinds the writer emits but the viewer doesn’t render yet are an explicit subset (DEFERRED_KINDS) surfaced as “skipped, not yet rendered”.

Rule 3

Vendor-namespace sections (x_<vendor>.*) get the vendor name extracted.

Rule 4

Implemented in qvf.py (sha256 verify-before-use guard).

Module Attributes

DESCRIPTIVE_KINDS

Supported kinds that describe the archive rather than hold computed data: the qvf reference writers and vibe-sketch emit them, the vibe-qc writer does not (tests/test_kind_drift.py).

Functions

classify_section(kind)

Return (status, detail) for a section kind.

vibeview.kinds.DESCRIPTIVE_KINDS: frozenset[str] = frozenset({'preview', 'reaction.scheme'})

Supported kinds that describe the archive rather than hold computed data: the qvf reference writers and vibe-sketch emit them, the vibe-qc writer does not (tests/test_kind_drift.py).

vibeview.kinds.classify_section(kind)

Return (status, detail) for a section kind.

status is "rendered" or "skipped"; a section that fails to read is reported as "error" by the caller, which knows about the archive, not by this kind-only lookup. detail is None for a kind with its own panel, "via structure" for RENDERED_VIA_STRUCTURE, and the human-readable reason for a skipped kind.

── Rule 2 + 3: unknown kinds and vendor namespaces.

Parameters:

kind (str)

Return type:

tuple[str, str | None]