Skip to content

1.0.0

Choose a tag to compare

@github-actions github-actions released this 25 Jul 08:28
· 62 commits to main since this release
8ba5960

First public release. Neurodivergence-friendly gamification for your notes —
off-by-default for everything that could escalate.

Core engines

  • XP engine: per-checkbox + completion bonuses (50/75/90 %), habit toggles, pomodoro bonus, weekly review/planning bonus, manual adjustments.
  • Streak engine with monthly-regenerated freeze tokens (default 2/month). Streak-bonus tiers at 3/7/14/30 days.
  • 10 levels SIGNAL LOSTK U R O on a linear-quadratic XP curve (200 … 18000).
  • Deterministic loot: 5 tiers (Common/Rare/Epic/Legendary/Mythic), seeded shuffle, 50+ default rewards, custom-pool override.
  • Lore reveal: narrative fragment per level, custom-lore override.
  • Pure-function engines with no Obsidian-API coupling.

Adoptable for others

  • Pack library (📚 Packs hub): install / activate / delete / reset / import loot-, lore- and habit-content packs from one place; activating a pack is a single, progress-safe operation.
  • LLM-assisted pack import: users generate their own loot/lore KuroPack with a documented prompt and their own LLM, then import validated, progress-safe JSON — no form editors. Bundled themes: Gothic / Plain / Cozy.
  • Validated import: PackValidator rejects malformed packs with stable, localized issue codes.
  • Guided onboarding: welcome modal + empty-state guidance; existing users are exempted via a migrate guard.
  • Bilingual: German (default) + English, all user-facing strings via the i18n module.

Surfaces

  • Sidebar status view, kuro-status Markdown code-block processor, 10+ commands in the Command Palette, status-bar item (off-by-default), reduce-animations toggle (a11y).
  • Forward-compatible data store (deep-merge against defaults, schemaVersion-tagged), export/import via clipboard JSON.

Quality & release readiness

  • Submission gate (SubmissionGate): pure manifest.json / LICENSE validation runs in the test suite, so a store-incompatible manifest fails npm test — the biome-only equivalent of the community eslint-plugin-obsidianmd manifest/license rules.
  • 209 unit tests across engines, data store, i18n, pack library and the submission gate.
  • License: AGPL-3.0-or-later for code (LICENSE), CC BY-SA 4.0 for docs (LICENSE-DOCS); dual-licensing documented in LICENSING.md, contributions under CLA.md.
  • TypeScript strict mode, ES2018 target, zero runtime dependencies, esbuild bundling, biome linter, tsc build gate.

Notes

  • The assets/kuro-gamification.css snippet (CRT/phosphor aesthetic) is not bundled in the plugin — install it separately as a Vault CSS snippet.
  • TaskNotes integration is soft (transparent via vault.modify); no hard dependency.