Create a consolidated observational event journal — create

Combines filesystem-derived observational events and optional GitHub-derived events into a unified event journal.

Usage

create_journal(filesystem_events, github_events = NULL)

Arguments

filesystem_events: A data frame containing filesystem-derived observational events, typically created with project_record_events().
github_events: Optional data frame containing GitHub-derived file events, typically created with create_github_commit_journal().

Value

A tibble containing a consolidated observational event journal.

Details

The function validates the resulting journal structure and returns a chronologically ordered tibble of observational events.

The function operates on already projected event tables and does not infer semantic workflows, derivations, or activities.

Examples

if (FALSE) { # \dontrun{

data("fscontextdemo_snapshot_02")

snapshot_df <- fscontextdemo_snapshot_02

snapshot_df$git_remote <-
  "https://github.com/dataobservatory-eu/fscontextdemo"

snapshot_df$git_branch <- "main"

filesystem_events <-
  project_record_events(snapshot_df)

github_events <-
  create_github_commit_journal(
    snapshot_df,
    per_page = 5
  )

journal <-
  create_journal(
    filesystem_events = filesystem_events,
    github_events = github_events
  )

head(journal)
} # }