Skip to content

The Library on the Mac, and the word of the day (phase 1, GDR-0027) - #67

Open
ChaliceForAuri wants to merge 1 commit into
timbrecorefrom
mac-library
Open

ChaliceForAuri wants to merge 1 commit into
timbrecorefrom
mac-library

Conversation

@ChaliceForAuri

@ChaliceForAuri ChaliceForAuri commented Oct 19, 2026 •

Copy link
Copy Markdown
Owner

Stacked on #66 (TimbreCore). Phase 1 of the product map: the Library as the Mac's surface, and the first surface for the word of the day.

Settings › Library

  • One list for all five kinds, with a kind filter and a search (LibraryQuery, case- and diacritic-insensitive over term, heard, meaning, tags).
  • An add row that adapts to the kind: a word or phrase with an optional meaning, an acronym with its meaning, a spelling with its misspelling, a correction heard → meant.
  • An edit sheet for term, heard, meaning, example and tags; a strength bar on every learnable entry with a history; the provenance line ("Corrected in Mail on 14 Oct · iPhone").
  • Export the whole Library as one JSON file; import merges by the sync rule, and refuses a file from a newer Timbre.
  • The profile: field, role, first language.

The word of the day

  • WordOfTheDay (TimbreKit) builds the card from the day's pick: your meaning; Apple's dictionary on the Mac via DictionaryServices, labelled and never bundled; one example sentence written by the on-device model, greedy, guarded by ExampleGuardrail, kept for the day so the card reads the same each time it's opened.
  • The menu bar shows the word, with a tick once it's been met. A window shows the card, with sources labelled, the "why today" line, the strength bar, and Read Aloud.
  • A morning notification, off until turned on; permission is asked only then. Rescheduled on every Library save with the next morning's word.
  • The card rebuilds whenever the Library saves and when the day changes.

Harness

timbre-eval --examples Fixtures/examples.json --repeat 5: every draft against the guardrail, eight cases across fields, including an acronym and a cased word.

Verified

  • TimbreCore: 86 tests. TimbreKit: 209 tests. swift-format lint --strict clean.
  • xcodebuild of the Mac app: BUILD SUCCEEDED.
  • sync:docs regenerated for the changelog.

Not yet exercised: the app running with the new tab and window (the installed Timbre owns the hotkeys, so a second copy was not launched here). That is first on the list for the joint test.

🤖 Generated with Claude Code

@vercel

vercel Bot commented Oct 19, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated
timbre Ignored Ignored Preview Oct 21, 2026 8:59pm UTC

Request Review

…R-0027)

Settings › Dictionary becomes Settings › Library: one list with a kind
filter and a search, an add row that adapts to the kind, an edit sheet
(term, heard, meaning, example, tags), a strength bar on every learnable
entry, the provenance line, export to a file and import by the sync merge
rule, and the profile (field, role, first language).

The word of the day: a WordOfTheDay coordinator in TimbreKit builds the
card from the pick — the user's meaning, Apple's dictionary on the Mac
(DictionaryServices, labelled, never bundled), and one example sentence
written by the on-device model, greedy and guarded by ExampleGuardrail,
kept for the day so the card reads the same each time. The menu bar shows
the word and whether it was met; a window shows the card and reads it
aloud; a morning notification is off until turned on and asks for
permission only then. The card rebuilds whenever the Library saves and
when the day changes.

Core: LibraryQuery, ExampleGuardrail, NotificationPlan, WordCard,
Library.importDocument and didSave. Kit: ExampleWriter, AppleDictionary,
WordNotifier, WordOfTheDay; timbre-eval --examples with its corpus.

Core: 86 tests. Kit: 209 tests. Lint clean. The Mac app builds.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@ChaliceForAuri ChaliceForAuri changed the title The Library on the Mac, and the word of the day (phase 1, GDR-0025) The Library on the Mac, and the word of the day (phase 1, GDR-0027) Oct 21, 2026

This branch has not been deployed

No deployments
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