social.dracome.library.goal
A repeatable consumption-goal record for an actor, targeting a metric over a half-open time period `[periodStart, periodEnd)` (periodStart is inclusive, periodEnd is exclusive). Fulfillment progress against the goal is not stored on this record — it is computed at read time by filtering the actor's `library.state` records that fall within the period, per the metric named in `metric`.
Details · record, key tid
| Kind | record |
|---|---|
| Record key | tid |
| Authority | library.dracome.social |
| Indexed |
Record
record · key tidProperties
Canonical UTC instant serialized as ISO 8601 with a trailing Z suffix.
formatScope
refOptional restriction of this goal to one format category (e.g. only audiobooks). Unset means the goal counts consumption of all formats. Only meaningful when `metric` is `completed_state_count` — never populated alongside a sum metric.
The consumption metric this goal targets.
Canonical UTC instant marking the exclusive end of the goal's period `[periodStart, periodEnd)`, serialized as ISO 8601 with a trailing Z suffix.
periodLabel
stringOptional free-text label for the goal's period (e.g. '2026 Reading Challenge'), for display only. Not used to compute the period boundaries — periodStart/periodEnd remain authoritative.
maxLength: 256maxGraphemes: 64
Canonical UTC instant marking the inclusive start of the goal's period, serialized as ISO 8601 with a trailing Z suffix.
The target value to reach for `metric` within the goal's period. The maximum is 999,999 hours expressed in seconds (999999 * 3600) — the field is not per-metric here, so it is bounded to the widest unit's ceiling; `completed_state_count`/`page_count_sum` goals are additionally capped at 999,999.
minimum: 1maximum: 3599996400
updatedAt
string · datetimeCanonical UTC instant serialized as ISO 8601 with a trailing Z suffix.
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
social.dracome.library.defs
not from the namespace authorityHow an actor came to own a specific book edition, tracked on a `library.acquisition` record.
-
app.fitsky.goal
recordA fitness goal to track progress against
-
social.dracome.library.state
recordA reading-state record for one edition per actor. Duplicate convention: the rkey is a TID minted once at first create and never changes. Several records may exist for one actor and edition (for example from out-of-band writers); consumers SHOULD treat the record with the greatest `updatedAt` (falling back to `createdAt`) as the winner and break ties by the lowest TID, ignoring the others. This is a convention, not an enforced contract: AppViews MUST tolerate a differing winner, and may see a rec