Document period field on DocumentInsight rollups

[tommoor]

Summary

Updates the DocumentInsight response schema to document the new period field added in outline/outline#12113.

Recent activity is returned as daily rollups, while older activity is aggregated into weekly rollups. The new period enum (day | week) on each rollup tells consumers which bucket a row represents. The date for weekly rollups represents the first day (Monday) of the week.

Also tweaks the /documents.insights endpoint description to reflect that returned rollups may now be daily or weekly.

Survey of other recent merges

Checked the other PRs merged in outline/outline since 2026-05-17 for relevance to the public API surface; none required spec updates:

• #12371 (getJWTToken → getSessionToken) — internal rename
• #12369 (remove obsolete lodash-es resolution) — deps only
• #12366 (initialize text selection state) — client-side hook
• #12335 (Comments sidebar in image lightbox) — frontend only
• #12364 (Allow connecting additional auth providers on custom domain) — internal OAuth state, no schema change
• #12361 (Refactor Markdown importer) — touches imports.create and collections.import, neither of which is currently documented in this spec

Test plan

• yarn validate passes (Spectral + operation IDs)
• Pre-commit hook regenerated spec3.json from spec3.yml

---

Generated by Claude Code