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`.

Repository @dracome.social did:plc:66dyrt2bmghwlmdteyizs5l3 namespace authority
Details · record, key tid
Kindrecord
Record keytid
Authoritylibrary.dracome.social
Indexed

Record

record · key tid

Properties

createdAt

requiredstring · datetime

Canonical UTC instant serialized as ISO 8601 with a trailing Z suffix.

Optional 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.

metric

requiredref

The consumption metric this goal targets.

periodEnd

requiredstring · datetime

Canonical UTC instant marking the exclusive end of the goal's period `[periodStart, periodEnd)`, serialized as ISO 8601 with a trailing Z suffix.

Optional 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: 256
  • maxGraphemes: 64

periodStart

requiredstring · datetime

Canonical UTC instant marking the inclusive start of the goal's period, serialized as ISO 8601 with a trailing Z suffix.

targetValue

requiredinteger

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: 1
  • maximum: 3599996400

updatedAt

string · datetime

Canonical UTC instant serialized as ISO 8601 with a trailing Z suffix.

Similar lexicons

semantic match

Lexicons 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 authority

    How an actor came to own a specific book edition, tracked on a `library.acquisition` record.

  • A fitness goal to track progress against

  • A 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