jkaindl/kuro-gamification
1
0
Fork 0
Code Issues Pull requests Projects Releases 7 Packages Wiki Activity Actions
7 releases 7 tags
  • 1.0.0 8ba5960654

    1.0.0 Stable

    jkaindl released this 2026-07-25 08:26:43 +00:00 | 22 commits to main since this release

    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 LOST → K 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.
    Downloads