Install research rules

Proposes and applies a configure action, which replaces the whole research policy. A ruleset or reference is resolved and pinned: the state stores the resolved rules, the merged vocabulary, the versions of custom predicates in use, and content digests for every source ruleset. The history entry keeps both the requested rules and the resolved policy. Earlier records and goal_version are unchanged.

Usage

bg_use_rules(project, rules, mode = NULL, actor, rationale)

Arguments

project

A writable bg_handle with an investigation.

rules

A ruleset (see bg_ruleset()), a reference string such as "lab.review@1" or "lab.review@1.2.0", or a list of rules.

mode

record, guide, or enforce. NULL keeps the current mode.

actor

Named list with id and type. Only a human may change policy.

rationale

Why the policy changes.

Value

The new research state, invisibly.

See also

bg_rules() to read the active policy.