Skip to content

feat: gateway and reports for desktop product insights - #34

Merged
yaacovcorcos merged 2 commits into
mainfrom
feat/analytics-insights-20260906
Sep 6, 2026
Merged

feat: gateway and reports for desktop product insights#34
yaacovcorcos merged 2 commits into
mainfrom
feat/analytics-insights-20260906

Conversation

@yaacovcorcos

Copy link
Copy Markdown
Contributor

Summary

Accept the desktop revision-3 allowlisted insight contract, retaining revision-2 compatibility. Add aggregate-only D1 reports and planned PostHog insights for feature visits, repeat days, provider/model usage, readiness and token coverage. Missing counts remain null; reports do not claim total billing or unique people.

Documentation and source-version impact

Updated README and a short Privacy-page description of provider/model categories and reported token counts. Generated contract and corpus come from the coordinated desktop candidate; the measurement definitions live in the coordinated Scient plan PR. Links follow below.

Validation

  • bun run check
  • Synthetic built desktop worker -> gateway -> real SQLite ledger -> mocked PostHog export, including exact numeric properties, deletion and stale replay rejection
  • D1 report fixture checks for population, repeated days and missing usage
  • Human review of the exact Privacy-page preview
  • Live PostHog query execution after deployment/data arrival

Quality Review

Independent read-only review verified D1 missing-count semantics and caught PostHog numeric-property conversion, now explicit. The gateway remains strict; private labels and unexpected numeric properties are rejected. No production data was queried or changed.

Integration Readiness Review

Draft pending human preview and CI. This gateway must be deployed before the coordinated desktop revision-3 release. Planned insights are definitions, not activated dashboards. Prepared with Codex API tooling and independent read-only review.

Deployment impact

No deploy or gate change performed. Existing ingestion/export defaults remain unchanged. This prepares validation and reports; it does not assert that new events are already arriving.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Sep 6, 2026

Copy link
Copy Markdown

Deploying scientfactory-website with  Cloudflare Pages  Cloudflare Pages

Latest commit: 7bea945
Status: ✅  Deploy successful!
Preview URL: https://39df9a1c.scientfactory-website.pages.dev
Branch Preview URL: https://feat-analytics-insights-2026.scientfactory-website.pages.dev

View logs

@yaacovcorcos

Copy link
Copy Markdown
Contributor Author

Coordinated desktop producer: ScientFactory/scient-desktop#259 . Measurement definitions: ScientFactory/Scient#109 . Deploy this compatible gateway before releasing the desktop producer. No deployment or dashboard activation performed.

@yaacovcorcos
yaacovcorcos marked this pull request as ready for review September 6, 2026 19:25
@yaacovcorcos
yaacovcorcos merged commit 4313131 into main Sep 6, 2026
2 checks passed
@yaacovcorcos
yaacovcorcos deleted the feat/analytics-insights-20260906 branch September 6, 2026 19:25
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