Skip to content

Say that points arrive per source - #42

Merged
kkdev92 merged 1 commit into
mainfrom
docs/points-come-per-source
Aug 21, 2026
Merged

Say that points arrive per source#42
kkdev92 merged 1 commit into
mainfrom
docs/points-come-per-source

Conversation

@kkdev92

@kkdev92 kkdev92 commented Aug 21, 2026

Copy link
Copy Markdown
Owner

A person with two devices gets the same measurement from both, so ListAsync returns it twice
and summing the points inflates the total. Nothing in the response indicates it: every point is
genuine, and the count is only wrong once the set is treated as one person's day.

Filtering by Platform does not separate them either — a phone's built-in tracking and a wrist
device from the same vendor report the same one. Device.DisplayName is the field that does.

docs/data-points.md gains a section that says this, points at the roll-up operations for a
figure, and records what Reconcile gives up in exchange for merging: a ReconciledDataPoint
carries no dataSource, so it answers what the value is and not which device produced it. It
also names the point DataPointName rather than Name.

Documentation only — no change under src/.

Not included

Three things were considered and left out:

  • The roll-up range caps. Already on the Range property of both roll-up requests, which is
    where you are looking when you set one. Repeating them here would be a second copy to keep.
  • The roll-up response array name. RollUpDataPointsResponse exposes RollupDataPoints and
    nothing else, so a typed caller cannot reach for the wrong one.
  • Per-type page density. The general rule under Following the cursor can return fewer records
    than exist
    already covers it, and covers it better than a list of types would.

Every claim in the new section was checked against the generated models rather than written from
recollection.

🤖 Generated with Claude Code

A person with two devices gets the same measurement from both, so `list`
returns it twice and summing the points inflates the total. Nothing in the
response indicates it: every point is genuine, and the count is only wrong
once the set is treated as one person's day.

Filtering by platform does not separate them either — a phone's built-in
tracking and a wrist device from the same vendor report the same one. The
documentation now says which field does, and points at the roll-up operations
for a figure.

It also records what `Reconcile` gives up in exchange for merging: a
`ReconciledDataPoint` carries no `dataSource`, so it answers what the value is
and not which device produced it.

Co-authored-by: kkdev92 <kkdev92@users.noreply.github.com>
Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
@kkdev92
kkdev92 merged commit 89f2ee3 into main Aug 21, 2026
10 checks passed
@kkdev92
kkdev92 deleted the docs/points-come-per-source branch August 21, 2026 07:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant