# Canonical API Surface

> Document Project Beta’s Screen Time implementation and extract reusable patterns for schedule-driven blocking products.

- Skill: `tools-only/canonical-api-surface-5` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/canonical-api-surface-5`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/canonical-api-surface-5/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-29
- Page: https://skillmd.com/skills/tools-only/canonical-api-surface-5

---

# 16 Project Beta Implementation Analysis

## Purpose
Document Project Beta’s Screen Time implementation and extract reusable patterns for schedule-driven blocking products.

## Canonical API Surface
- FamilyControls authorization + picker APIs
- ManagedSettings shield APIs
- DeviceActivity schedule and monitor APIs
- ManagedSettingsUI shield configuration/action APIs

## Implementation Pattern
- `AppBlockingManager` centralizes authorization, selection persistence, schedule registration, and local state reconciliation.
- Onboarding heavily validates schedule constraints and selection prerequisites before completion.
- Monitor extension applies/clears persisted token set at interval boundaries.
- Custom shield theme adjusts copy/styling with schedule context from app-group state.
- Dashboard uses token labels for real app icon rendering.

## Failure Modes
1. Potential race between app-level periodic state checks and extension callback enforcement.
2. Extension lacks explicit user-visible remediation for auth revocation scenarios.
3. Runtime errors mostly logged to console; production telemetry path is limited.

## Validation Checklist
- [ ] Start/stop monitor behavior validated for bedtime-waketime crossover.
- [ ] Selection decode path tested after app restart and extension invocation.
- [ ] Revoke authorization mid-cycle and verify shield behavior + UI handling.
- [ ] Report any schedule registration errors beyond console output.

## Sources
- Template note: Replace `{{PROJECT_BETA_PATH}}` with your local repository root before opening project-observed files.
- `../rundowns/11-project-beta-rundown.md`
- `{{PROJECT_BETA_PATH}}/ProjectBeta/AppBlockingManager.swift`
- `{{PROJECT_BETA_PATH}}/ProjectBetaMonitor/DeviceActivityMonitor.swift`
- `{{PROJECT_BETA_PATH}}/ProjectBetaShield/ShieldConfiguration.swift`
- `{{PROJECT_BETA_PATH}}/ProjectBetaShield/ShieldAction.swift`

## Confidence Notes
- This analysis is `project-observed` and grounded in current repository state as of `2026-02-08`.