Build session facts from an explicit qlcal calendar — ledgr_facts_sessions

Materializes an inclusive civil-date schedule from an explicit qlcal calendar object, then delegates normalization and local-time validation to ledgr_facts_sessions(). The qlcal object is never retained.

Usage

ledgr_facts_sessions_qlcal(
  calendar,
  from,
  to,
  venue_id,
  timezone,
  session_open,
  session_close,
  knowledge = c("assume_effective", "evidenced"),
  knowledge_time = NULL,
  overrides = NULL,
  provenance = NULL
)

Arguments

calendar: An explicit calendar object returned by qlcal::getCalendar().
from, to: Inclusive civil Date bounds.
venue_id: A non-empty venue identifier.
timezone: An IANA timezone for the declared session hours.
session_open, session_close: Local HH:MM:SS times used on business days.
knowledge: Either "evidenced" or "assume_effective".
knowledge_time: An optional full UTC instant applied to generated rows. It is required with evidenced knowledge.
overrides: Optional complete replacement rows with session_date, status, session_open, and session_close.
provenance: Optional named list recorded in hashed family metadata and row provenance. Evidenced schedules require a non-empty source member.

Value

A ledgr_facts_sessions fact-family object whose materialized rows no longer depend on qlcal.

Errors

Missing qlcal raises ledgr_missing_package. Invalid calendar objects or overrides raise ledgr_session_adapter_invalid.