review_semantics

review_semantics(x, include_filled=False, max_candidates=5, columns=None)

Review semantic suggestions in the console.

Builds a re-runnable review queue from suggestions that already exist. One entry per unfilled semantic slot, plus NuSEDS crosswalk-prefilled code slots that still hold their original prefill, each with its ranked shortlist and the exact :func:accept_suggestion call that decides it – printing that call is the feature: paste it into a script and the decision becomes reproducible, which the spreadsheet workflow this replaces never was.

This never contacts a network or an LLM. It reads the semantic_suggestions attribute (or semantic_suggestions.csv) that :func:suggest_semantics / :func:create_sdp already produced. When those suggestions carry a model’s assessment – ingested from your own harness by :func:~metasalmonpy.ingest_semantic_assessments, or made by the deprecated llm_assess=True – this shows it, an accept under the candidate it chose and any other decision once per slot and role; it never generates one.

Parameters

Name Type Description Default
x A written package path, a dictionary carrying the semantic_suggestions attribute, or the artifact mapping returned by :func:infer_salmon_datapackage_artifacts. required
include_filled bool When True, also queue slots that already hold a final (non-REVIEW:) IRI, and slots that already carry a decision. NuSEDS crosswalk-prefilled code slots with a saved shortlist are shown by default until decided. False
max_candidates Optional[int] Maximum candidates shown per target: per slot, and per role where a code value’s slot holds its constraint, entity and method targets. None shows all. A candidate a model accepted is shown whatever its rank. 5
columns Optional[Iterable[str]] Optional column names restricting the queue. A value matching no column is an error that names the columns that do exist – filtering first and then reporting an empty queue told a user who mistyped a column name that their package was finished. None

Returns

Name Type Description
SemanticReview
Back to top