ResearchWorkspace (provisional scientific evidence ledger)

A mutable, run-scoped workspace for retrieved resources, proposed claims, evidence spans, disputes, and references to accepted graft knowledge. The workspace never grants acceptance to proposed claims; acceptance remains an explicit graft review and commit.

Active bindings

retrieved_resources: Read-only named-list snapshot of typed resources keyed by resource id.
proposed_claims: Read-only named-list snapshot of provisional claim records keyed by claim id.
evidence_spans: Read-only named-list snapshot of provisional evidence-span records.
claim_supports: Read-only named-list snapshot of explicit claim-by-evidence-span support assessments.
disputes: Read-only named-list snapshot of provisional dispute records.
artifact_selection: Read-only exact artifact input and provenance.
citation_audit: Read-only pair-level projection of the authoritative claim-support assessments, when available.
max_sources: Maximum number of unique retrieved resources admitted. Accepted Graft knowledge records inserted by tempest_artifact_knowledge() are bounded separately and do not count.

Methods

Public methods

ResearchWorkspace$new()
ResearchWorkspace$set_max_sources()
ResearchWorkspace$upsert_retrieved_resource()
ResearchWorkspace$get_retrieved_resource()
ResearchWorkspace$get_retrieved_source()
ResearchWorkspace$list_retrieved_resources()
ResearchWorkspace$list_retrieved_sources()
ResearchWorkspace$add_proposed_claim()
ResearchWorkspace$add_proposed_claims()
ResearchWorkspace$add_extracted_claim_batch()
ResearchWorkspace$verify_proposed_claims_batch()
ResearchWorkspace$get_claim_support()
ResearchWorkspace$list_claim_supports()
ResearchWorkspace$get_proposed_claim()
ResearchWorkspace$list_proposed_claims()
ResearchWorkspace$proposed_claims_for_resource()
ResearchWorkspace$add_evidence_span()
ResearchWorkspace$get_evidence_span()
ResearchWorkspace$list_evidence_spans()
ResearchWorkspace$link_evidence_to_proposed_claim()
ResearchWorkspace$get_evidence_for_proposed_claim()
ResearchWorkspace$add_dispute()
ResearchWorkspace$list_disputes()
ResearchWorkspace$bind_artifact_selection()
ResearchWorkspace$validate_integrity()
ResearchWorkspace$to_tibbles()
ResearchWorkspace$clone()

`ResearchWorkspace$new()`

Create a new provisional research workspace.

Usage

ResearchWorkspace$new(max_sources = Inf, artifact_selection = list())

Arguments

max_sources: Maximum number of unique sources. New sources are refused once the limit is reached.
artifact_selection: Exact artifact input retained by the workspace.

`ResearchWorkspace$set_max_sources()`

Set the maximum number of unique sources.

Usage

ResearchWorkspace$set_max_sources(max_sources)

Arguments

max_sources: A positive whole number or Inf.

`ResearchWorkspace$upsert_retrieved_resource()`

Insert or update a retrieved typed evidence resource.

Usage

ResearchWorkspace$upsert_retrieved_resource(resource)

Arguments

resource: A resource created by tempest_resource().

`ResearchWorkspace$get_retrieved_resource()`

Get a retrieved typed evidence resource by id.

Usage

ResearchWorkspace$get_retrieved_resource(resource_id)

Arguments

resource_id: Resource id.

`ResearchWorkspace$get_retrieved_source()`

Get one retrieved resource as a built-in source view.

Usage

ResearchWorkspace$get_retrieved_source(resource_id)

Arguments

resource_id: Resource id.

`ResearchWorkspace$list_retrieved_resources()`

List all retrieved evidence as typed resources.

Usage

ResearchWorkspace$list_retrieved_resources()

`ResearchWorkspace$list_retrieved_sources()`

List retrieved resources as built-in source views.

Usage

ResearchWorkspace$list_retrieved_sources()

`ResearchWorkspace$add_proposed_claim()`

Add a proposed claim record to the workspace.

Usage

ResearchWorkspace$add_proposed_claim(claim)

Arguments

claim: A tempest_claim S7 record.

`ResearchWorkspace$add_proposed_claims()`

Atomically add proposed claim records to the workspace.

Usage

ResearchWorkspace$add_proposed_claims(claims, commit = NULL)

Arguments

claims: A list of tempest_claim S7 records.
commit: Optional zero-argument callback committed with the batch.

`ResearchWorkspace$add_extracted_claim_batch()`

Atomically add extracted evidence spans and claims.

Usage

ResearchWorkspace$add_extracted_claim_batch(
  claims,
  evidence_spans = list(),
  commit = NULL
)

Arguments

claims: A list of tempest_claim S7 records.
evidence_spans: A list of tempest_evidence_span S7 records.
commit: Optional zero-argument callback committed with the batch.

`ResearchWorkspace$verify_proposed_claims_batch()`

Atomically replace exact claim-by-span support assessments.

Usage

ResearchWorkspace$verify_proposed_claims_batch(
  claim_supports,
  verified_at,
  min_support_score = 0.7,
  verifier = NA_character_,
  .verification_owner_token = NULL,
  commit = NULL
)

Arguments

claim_supports: An unnamed complete list of tempest_claim_support records.
verified_at: Exact canonical verification-batch timestamp bound into every corresponding verification-stage record.
min_support_score: Bound support threshold used to derive claim summaries.
verifier: Bounded verifier-model identifier or NA.
.verification_owner_token: Internal process-local session capability. Standalone workspaces require NULL.
commit: Optional zero-argument callback committed with the batch.

`ResearchWorkspace$get_claim_support()`

Get a claim-support assessment by id.

Usage

ResearchWorkspace$get_claim_support(claim_support_id)

Arguments

claim_support_id: Exact derived support identifier.

`ResearchWorkspace$list_claim_supports()`

List claim-support assessments in deterministic id order.

Usage

ResearchWorkspace$list_claim_supports()

`ResearchWorkspace$get_proposed_claim()`

Get a proposed claim by id.

Usage

ResearchWorkspace$get_proposed_claim(claim_id)

Arguments

claim_id: The claim id.

`ResearchWorkspace$list_proposed_claims()`

List all proposed claims.

Usage

ResearchWorkspace$list_proposed_claims()

`ResearchWorkspace$proposed_claims_for_resource()`

Proposed claims that cite a retrieved resource.

Usage

ResearchWorkspace$proposed_claims_for_resource(resource_id)

Arguments

resource_id: Resource id.

`ResearchWorkspace$add_evidence_span()`

Add an evidence span.

Usage

ResearchWorkspace$add_evidence_span(span)

Arguments

span: A tempest_evidence_span S7 record.

`ResearchWorkspace$get_evidence_span()`

Get an evidence span by id.

Usage

ResearchWorkspace$get_evidence_span(span_id)

Arguments

span_id: Evidence span id.

`ResearchWorkspace$list_evidence_spans()`

List all evidence spans in deterministic id order.

Usage

ResearchWorkspace$list_evidence_spans()

`ResearchWorkspace$link_evidence_to_proposed_claim()`

Link an evidence span to a claim.

Usage

ResearchWorkspace$link_evidence_to_proposed_claim(claim_id, span_id)

Arguments

claim_id: Claim id.
span_id: Evidence span id.

`ResearchWorkspace$get_evidence_for_proposed_claim()`

Evidence spans linked to a claim.

Usage

ResearchWorkspace$get_evidence_for_proposed_claim(claim_id)

Arguments

claim_id: Claim id.

`ResearchWorkspace$add_dispute()`

Add a dispute.

Usage

ResearchWorkspace$add_dispute(dispute)

Arguments

dispute: A tempest_dispute S7 record.

`ResearchWorkspace$list_disputes()`

List all disputes.

Usage

ResearchWorkspace$list_disputes()

`ResearchWorkspace$bind_artifact_selection()`

Pin an exact artifact selection after admitting its resources.

Usage

ResearchWorkspace$bind_artifact_selection(selection)

Arguments

selection: A validated artifact selection.

`ResearchWorkspace$validate_integrity()`

Validate all authoritative workspace cross-record links.

Usage

ResearchWorkspace$validate_integrity()

`ResearchWorkspace$to_tibbles()`

Convert sources, claims, and disputes to tibbles.

Usage

ResearchWorkspace$to_tibbles()

`ResearchWorkspace$clone()`

The objects of this class are cloneable with this method.

Usage

ResearchWorkspace$clone(deep = FALSE)

Arguments

deep: Whether to make a deep clone.