plexus.rubric_memory.citations module

class plexus.rubric_memory.citations.RubricMemoryCitation(*, id: Annotated[str, MinLen(min_length=1)], kind: Literal['official_rubric', 'corpus_evidence'], excerpt: Annotated[str, MinLen(min_length=1)], source_uri: str | None = None, scope_level: str = 'unknown', source_timestamp: datetime | None = None, authority_level: str = 'unknown', score_version_id: Annotated[str, MinLen(min_length=1)], evidence_classification: str = 'unknown')

Bases: BaseModel

Stable citation handle for official rubric authority or corpus evidence.

Create a new model by parsing and validating input data from keyword arguments.

Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be validated to form a valid model.

self is explicitly positional-only to allow self as a field name.

authority_level: str

evidence_classification: str

excerpt: str

id: str

kind: Literal['official_rubric', 'corpus_evidence']

model_config = {'extra': 'forbid'}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

scope_level: str

score_version_id: str

source_timestamp: datetime | None

source_uri: str | None

class plexus.rubric_memory.citations.RubricMemoryCitationContext(*, markdown_context: str, citation_index: list[RubricMemoryCitation] = <factory>, machine_context: dict[str, ~typing.Any]=<factory>, diagnostics: list[dict[str, ~typing.Any]]=<factory>)

Bases: BaseModel

Human-readable rubric-memory context plus machine-readable citations.

Create a new model by parsing and validating input data from keyword arguments.

Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be validated to form a valid model.

self is explicitly positional-only to allow self as a field name.

citation_ids() → set[str]

citation_index: list[RubricMemoryCitation]

diagnostics: list[dict[str, Any]]

machine_context: dict[str, Any]

markdown_context: str

model_config = {'extra': 'forbid'}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class plexus.rubric_memory.citations.RubricMemoryCitationFormatter(*, max_excerpt_characters: int = 900)

Bases: object

Convert a RubricEvidencePack into deterministic citation context.

__init__(*, max_excerpt_characters: int = 900)

from_pack(pack: RubricEvidencePack) → RubricMemoryCitationContext

from_recent_evidence(*, request: RubricEvidencePackRequest, evidence: Sequence[EvidenceSnippet], metadata: dict[str, Any]) → RubricMemoryCitationContext

Format recency-biased retrieved evidence for optimizer briefings.

from_retrieved_evidence(*, request: RubricEvidencePackRequest, evidence: Sequence[EvidenceSnippet]) → RubricMemoryCitationContext

Format retrieved evidence as LLM input context without synthesis.

class plexus.rubric_memory.citations.RubricMemoryCitationValidation(*, supplied_ids: list[str] = <factory>, valid_ids: list[str] = <factory>, missing_ids: list[str] = <factory>, unused_ids: list[str] = <factory>, omitted_citations: bool = False, warnings: list[str] = <factory>)

Bases: BaseModel

Non-blocking diagnostics for citation use by an LLM consumer.

Create a new model by parsing and validating input data from keyword arguments.

Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be validated to form a valid model.

self is explicitly positional-only to allow self as a field name.

missing_ids: list[str]

model_config = {'extra': 'forbid'}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

omitted_citations: bool

supplied_ids: list[str]

unused_ids: list[str]

valid_ids: list[str]

warnings: list[str]

plexus.rubric_memory.citations.validate_rubric_memory_citations(supplied_ids: Iterable[str] | None, context: RubricMemoryCitationContext | dict[str, Any] | None, *, require_citation: bool = False) → RubricMemoryCitationValidation