Changelog

All notable changes to tilttek/quests will be documented in this file.

Updates should follow the Keep a CHANGELOG principles.

0.1.0-alpha - 2026-11-11

Added

• Names, Scope, StepMeasure and Step: steps that read verbs by pattern and context conditions, counting the activities or totalling their quantities up to a target of 1 to 10^12, a step asking for one activity being a first time.
• Reward, QuestKind, Admission and Quest: quests of 1 to 50 steps, ordered or free, of four genres — personal, community, team, duel —, followed automatically or on acceptance, following another quest, declaring up to 20 rewards, and for a duel the length it lasts once accepted.
• Window, Schedule, Occurrence, Permanent, Dated and ScheduleReader: quests open always, between two dates or from or until one, or at dates a schedule of the application's own computes, each occurrence named by a code.
• QuestReader: quests from plain values — steps, kind, ordered, admission, opens and closes, after, rewards, duel length — read in a timezone, unknown keys refused, schedule readers adding keys of their own.
• Catalog, WritableCatalog, InMemoryCatalog and Chains: the quests of an application by code, from code or a configuration, every chain checked — the quest followed exists, is of the same kind, and no chain loops.
• Contribution, Enrolment and Completion: what an activity brought to a step, a member's acceptance under a team and abandonment, a quest accomplished per occurrence and subject — the member, the team or community:<quest>.
• StepProgress, QuestProgress, Finish and ProgressCalculator: a step done at the contribution that reaches its target, ordered steps counting from the moment the step before was done, the quest accomplished with its last step, and the members whose activity counted.
• Evaluator: the subject a member's activity advances, the time a chained quest is open for it, whether a member's activity counts, and the progress of a member, a team or the community within each member's enrolment.
• QuestCompleted and QuestObserver: a quest accomplished with its rewards and the members they go to, a duel won, a duel expired.
• QuestProjection: a projection of tilttek/activity that brings each activity to the steps that accept it while the quest is open and the member's activity counts, accomplishes quests and opens those that follow, decides duels, takes back a cancelled activity's contributions, and forgets a period before a rebuild without telling again what is accomplished again. QuestProjection::clearReplay() forgets what the last reset kept for its replay.
• Quests and Erasure: acceptance — under a team for a team quest —, abandonment and taking up again, the status and the board of a member, the journal of accomplished quests, and the export and erasure of a member, Erasure telling what erasing a member removed.
• DuelStatus, Duel, DuelStanding and Duels: duels sent under the application's key, accepted, declined or withdrawn, lasting their quest's length or until it closes, offers that run out, the sweep of the duels whose time is up, and how far each side is.
• ContributionStore, EnrolmentStore, CompletionStore and DuelStore, with InMemoryContributionStore, InMemoryEnrolmentStore, InMemoryCompletionStore and InMemoryDuelStore: contributions written once per quest, step and activity, read by quest, members and period; enrolments per quest and member; the journal of accomplished quests; duels by key, those due and those reopened before a rebuild; each with its erasure of a member. The implementations in memory empty themselves with reset(), for a long-running process.
• QuestsException, implemented by InvalidQuest, UnknownQuest, UnknownDuel and QuestRefused.
• The documentation in doc/, one file per topic, indexed by the README.
• CONTRIBUTING.md, SECURITY.md and CODE_OF_CONDUCT.md.