osrforge.tracing.stage

The tracing stage's entry point and its two provider roles.

The tracing stage reads each printed map with two model services, each for the job it measured best at: a reading provider (Claude) reads each map page whole and judges the items the decision provider is unsure of, and a decision provider (Clef) answers the bulk questions about each cell, edge, and key. Every other stage stays on its ModelProvider. The stage itself arrives with the chunk that builds it.

TracingProviders dataclass

TracingProviders(reading: ReadingProvider, decisions: DecisionProvider)

The two providers the tracing stage takes.

Attributes:

Name	Type	Description
reading	ReadingProvider	The provider that reads each page whole and judges uncertain items. Claude fills it.
decisions	DecisionProvider	The provider that answers one question about one cell, edge, or key. Clef fills it.

reading instance-attribute

reading: ReadingProvider

decisions instance-attribute

decisions: DecisionProvider

trace

trace(workdir: Workdir, providers: TracingProviders) -> None

Run the tracing stage over a workdir's map pages.

Parameters:

Name	Type	Description	Default
workdir	Workdir	The workdir, with the survey, content, and map-reading caches complete.	required
providers	TracingProviders	The reading and decision providers.	required