On This Day Bar

Use this skill when the user wants to work on the native menu bar app, not the web app. If the repo contains apps/on-this-day-bar, use that workspace by default.

Quick Start

1. Run bash scripts/run_on_this_day_bar.sh doctor.
2. Run bash scripts/run_on_this_day_bar.sh inspect before editing.
3. Use bash scripts/run_on_this_day_bar.sh generate after changing project.yml.
4. Use bash scripts/run_on_this_day_bar.sh test after feed parsing, cache, date selection, or menu bar UI changes.
5. Use bash scripts/run_on_this_day_bar.sh run when you need the built app relaunched from the local .build-debug product.
6. Keep the app compact, source-grounded, and cache-aware.

Workflow

Product Boundary

• On This Day Bar owns:
  • the native MenuBarExtra app
  • cached fallback per date
  • settings for category and story depth
  • copyable daily briefs and article handoff
• Do not expand it into the web app; use on-this-day for the browser surface and helper flow.

Work The App First

• Read references/project-map.md before editing.
• If the task changes project settings or app metadata, inspect apps/on-this-day-bar/project.yml and apps/on-this-day-bar/OnThisDayBarApp/Info.plist first.
• Prefer the local runner before typing xcodegen or xcodebuild manually.
• Run build or test after feed service, cache behavior, date navigation, or menu bar presentation changes.
• Keep any fallback messaging honest when cached data is being shown.

Safety And Reliability

• Use the official Wikimedia feed.
• Do not invent historical facts or source links.
• Preserve explicit stale-data messaging when the cache is used.

Resources

• scripts/run_on_this_day_bar.sh: local doctor, inspect, generate, open, build, test, and run helper for the On This Day Bar workspace
• references/project-map.md: native app target map, main files, and build notes
• ../../apps/on-this-day-bar/: the matching native menu bar app codebase
• scripts/fetch_on_this_day.py: deterministic helper for official Wikimedia feed snapshots