TarskiTarski/ docsJoin the waitlist

Workviews, Collectors & modules

Workflow-shaped inspection and acquisition without a workflow engine, using read models, dispatch policy, scenario-driven collection with completion seals, and composable modules.

Tarski gives you workflow-shaped tools without making a workflow engine the source of truth. Tarski has no program counter, hidden call stack, or workflow state store. The durable model stays observation-first, and these layers organize what it derives.

Workviews

A Workview is a package-owned inspection contract. It maps ordinary derived relations into process-shaped roles: instance, phase, waiting reason, obligation, terminal state, at-risk state, child link, and effect link. Workviews are read models. They execute nothing, own no state, and do not change evaluator identity unless the underlying ontology changes.

Workviews report contradictions explicitly. Overlapping phases report ambiguity, terminal-plus-active evidence reports a conflict with provenance, and invalid child or effect links fail closed or surface as diagnostic rows.

tarski workview list
tarski workview inspect

Work Queues

Work Queues are frozen operational dispatch policy for admitted effects. The policy covers capacity, partitions, ordering, leases, rate limits, and saturation behavior, and durable queue-control records hold operator adjustments. A queue decides when admitted work may start. It does not decide whether something may happen. See Effects & reconciliation.

Collectors

A Collector is scenario-driven data acquisition. Rules derive plugin inputs, receipts return as observations, and the derived frontier (what is still missing) decides the next request. The worldview owns progress, and no worker keeps progress in memory.

input:    Google product identity + country + provider parameters
frontier: missing product details, then missing offer page N
drives:   product-detail and offer-page plugin inputs
progress: requested/captured pages and collected offers
seal:     terminal partial page, declared page bound, failure, or reconcile evidence
view:     one Collector Workview instance per request scope
queue:    bounded offer-page dispatch through a Work Queue

Completion seals are same-scope proofs that a collection frontier is complete. A seal is required before non-monotone reads, such as “the cheapest offer”, “no merchant matched”, or a final count, can be trusted. Monotone reads (“any offer below threshold”) may react as soon as evidence appears. This distinction is the CALM boundary described in the Tarski language. V1 accepts a closed set of seal shapes (terminal witnesses, terminal partial pages, declared bounds, refresh epochs), and custom proofs fail closed.

Collector outputs (collected_exports) must structurally join back to the request scope, because a seal cannot govern data whose scope was projected away.

Modules

A module packages reusable behavior above connector plugins: ontology rules, Workviews, Collector metadata, queue references, invariants, fixtures, exports, and explicit drives declarations naming which dependency inputs it may derive into. Modules read only declared dependency exports. The composed app, modules, and plugins still evaluate as one stratified fixed point.

The platform checks composition at load. On shared write surfaces it computes amalgamation agreement per input: amalgamates, guarded (single-driver policy), or disagreement. Only one class rejects at load: an exclusivity-shaped invariant asserted directly over a raw multi-driven union (error E2810), which provably cannot hold. To fix it, declare a single driver or move exclusivity to the owner’s derived resolution relation.

For architecture guidance, the advisory report proposes module splits from the ontology’s own mathematics:

tarski composition architecture

It emits one module-split proposal per non-owned namespace, a coupling score, readiness verdicts (clean, entangled with a work list, blocked with a witness), hotspots, and invariant-coverage gaps. The report is advisory and does not add new rejections.