dfbc931c14
Brings ~55 mod-exclusive files to the upstream-based mod/master-resync branch: Activities (migrated to new ActivityManager pattern): - Clock/Time: SetTimeActivity, SetTimezoneOffsetActivity, NtpSyncActivity - Dictionary: DictionaryDefinitionActivity, DictionarySuggestionsActivity, DictionaryWordSelectActivity, LookedUpWordsActivity - Bookmark: EpubReaderBookmarkSelectionActivity - Book management: BookManageMenuActivity, EndOfBookMenuActivity - OPDS: OpdsServerListActivity, OpdsSettingsActivity - Utility: DirectoryPickerActivity, NumericStepperActivity Utilities (unchanged): - BookManager, BookSettings, BookmarkStore, BootNtpSync - Dictionary, LookupHistory, TimeSync, OpdsServerStore Libraries: PlaceholderCover, TableData, ChapterXPathIndexer Scripts: inject_mod_version, generate_book_icon, preview_placeholder_cover Docs: KOReader sync XPath mapping Migration changes: - ActivityWithSubactivity -> Activity base class - Callback constructors -> finish()/setResult() pattern - enterNewActivity() -> startActivityForResult() - Activity::RenderLock&& -> RenderLock&& These files won't compile yet - they reference mod settings and I18n strings that will be added in subsequent phases. Made-with: Cursor
1.8 KiB
1.8 KiB
Created CrossPoint Reader Development Skill
Date: 2026-02-16 Task: Create a Cursor agent skill for CrossPoint Reader firmware development guidance.
Changes Made
Created project-level skill at .cursor/skills/crosspoint-reader-dev/ with 6 files:
| File | Lines | Purpose |
|---|---|---|
SKILL.md |
202 | Core rules: agent identity, hardware constraints, resource protocol, architecture overview, HAL usage, coding standards, error handling, activity lifecycle, UI rules |
architecture.md |
138 | Build system (PlatformIO CLI + VS Code), build flags, environments, generated files, local config, platform detection |
coding-patterns.md |
135 | FreeRTOS tasks, malloc patterns, global font loading, button mapping, UI rendering rules |
debugging-and-testing.md |
148 | Build commands, serial monitoring, crash debugging (OOM, stack overflow, use-after-free, watchdog), testing checklist, CI/CD pipeline |
git-workflow.md |
98 | Repository detection, branch naming, commit messages, when to commit |
cache-management.md |
100 | SD card cache structure, invalidation rules, file format versioning |
Design Decisions
- Progressive disclosure: SKILL.md kept to 202 lines (well under 500 limit) with always-needed info; detailed references in separate files one level deep
- Project-level storage:
.cursor/skills/so it's shared with anyone using the repo - Description includes broad trigger terms: ESP32-C3, PlatformIO, EPUB, e-ink, HAL, activity lifecycle, FreeRTOS, SD card, embedded C++
Follow-up Items
- Consider adding the skill directory to
.gitignoreif this should remain personal, or commit if sharing with collaborators - Update cache file format version numbers if they've changed since the guide was written
- Skill will auto-activate when the agent detects firmware/embedded development context