Skip to contents

Creates one investigation in an existing project. Candidates and evidence are independent of the execution graph. This experimental interface records research operations; it does not replace bg_run() or enforce rules on arbitrary R code. See vignette("research-search") for the action contract.

Usage

bg_research_init(
  project,
  question,
  goal,
  actor,
  mode = "record",
  rules = list()
)

Arguments

project

A bg_handle.

question

The research question.

goal

The inferential goal, as a named list.

actor

Named list with id and type (human or agent). Authorship is caller-declared, not authenticated.

mode

record, guide, or enforce.

rules

The research policy: a ruleset (see bg_ruleset()), a reference string such as "lab.review@1", or a list of rules (see bg_rule()). Rulesets are resolved and pinned when the investigation starts. If the resolved vocabulary declares goal kinds, goal$kind must be one of them.

Value

The persisted research state.