Toolbox and progress¶
The General Audience Toolbox groups local tools that complement the daily check-in while remaining separate in the domain model.
Toolbox structure¶
The published General Audience build can contain:
- tasks and checklists,
- personal milestones,
- badges,
- counter coins for configured change counters.
Inventory, Twelve Steps, AA/SPAA literature prompts and program-specific favorite-text resources are program resources and are excluded from the General Audience bundle. They remain available in the Recovery build when the program context is enabled.
flowchart TD
TB[Toolbox] --> T[Tasks and checklists]
TB --> M[Milestones]
TB --> B[Badge and coin collection]Tasks and checklists¶
Tasks are a local organization tool. A task can contain:
- a compact title and longer details,
- priority and an optional deadline,
- an optional category,
- up to 50 checklist steps with stable IDs and optional completion timestamps,
- open, overdue and completed states.
The overview stays intentionally compact and does not display long notes or checklist contents until the task is opened. Tasks can be filtered by status and category, sorted by deadline, priority or creation date, edited and explicitly deleted. Categories can be created, renamed, disabled and enabled again without deleting existing task references.
Tasks are not automatically interpreted as daily habits. Completing a task or checklist step does not create Life Wheel evidence or correlation data. The Companion may receive a read-only task overview but cannot create, modify or delete tasks.
Personal milestones¶
Milestones are local, freely configurable progress markers. They work without points, leaderboards, monthly challenges or mandatory deadlines.
| Tracker | Meaning |
|---|---|
| Maintain a goal | consecutive known days or weeks with a matching field value |
| Accumulate field values | cumulative numeric or duration values of a field |
| Accumulate events | number of selected events or activities |
| Accumulate event time | summed duration of exercise or self-care events |
| Maintain connection | social contacts with a person or group |
Field-based trackers use the stable logicalId so a safe field version does not artificially interrupt progress. Missing values remain unknown: they do not increase progress, count as failure or become zero.
Badges¶
Reached milestone levels appear as badges in a permanent local collection. Built-in series cover everyday actions and events such as morning and evening routines, meditation, movement, self-care, exercise and social contacts. Custom trackers can add more series.
Badge ranks use a shared visual progression. Counter-oriented sobriety or change milestones use bronze for weeks, silver for months, gold for half-years and the laurel-framed mastery tier for years. The visual reward does not alter the underlying data or score.
Counter coins¶
For every active change counter, the collection can show a coin representing the highest reached time milestone. It can display the associated counter, reached milestone, current start point and current day count.
Counter coins are derived from start and reset history. They do not change the counter and do not replace its complete history.
Their day and calendar-month thresholds can be edited under Settings → Milestones. Existing configurations migrate with the established defaults, and full years continue automatically after year three so long-running counters do not lose their latest annual coin.
System boundaries¶
| System | Purpose | Analytics |
|---|---|---|
| Daily check-in | voluntary self-observation | yes, according to field configuration |
| Tasks | organization | no |
| Milestones and badges | local progress marker | derived, without a separate score |
| Counter coins | visible counter milestone | derived from counter history |