Go to file
Krzysztof kuhy Rudnicki 2352c17723
Some checks are pending
file length / file-length (push) Waiting to run
kuhy_credit drift / drift (push) Waiting to run
kuhy_credit tests / python (push) Waiting to run
kuhy_credit tests / web (push) Waiting to run
kuhy_credit tests / flutter (push) Waiting to run
kuhy_credit tests / godot (push) Waiting to run
md-naming / markdown naming convention (push) Waiting to run
palette drift / palette (push) Waiting to run
repo-contract / repo contract (push) Waiting to run
shared gate tests / gate unit tests (push) Waiting to run
kuhy_credit: keep logo size in stretching parents
A ListView child got the full row width; the painter scaled the dark
field across the row and the glyph left the clip, so the logo was
invisible in punchme's settings. Loosen constraints at the root and
scale by the short side. Release 0.3.1.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-21 09:03:27 +01:00
.claude chore: enable dart-flutter plugin 2026-11-19 18:09:13 +01:00
.github/workflows platform_location: LocationManager plugin, no gms 2026-11-20 22:55:02 +01:00
agent_ready agent_ready: AgentReady v2.0 checker + repo_contract web-site gate 2026-10-22 21:18:49 +02:00
app_errors Read GitHub repo from checkout origin 2026-11-19 18:08:26 +01:00
coverage_gaps repo contract + coverage_gaps gates, test_changed, dependency bumps 2026-10-04 16:27:28 +02:00
crdt_sync_dart Clear inherited CI debt in the Python libs 2026-11-16 08:58:01 +01:00
crdt_sync_flutter crdt_sync_flutter 0.9.1: versionCode fallback 2026-11-17 22:59:34 +01:00
crdt-sync get rid of github ci/cd version check of package… 2026-11-19 18:11:07 +01:00
data_transfer_flutter data_transfer_flutter 0.2.3: file_picker 13.4.0 2026-11-17 23:17:04 +01:00
dep_freshness dep_freshness: DEP_FRESHNESS_TTL_SECONDS override 2026-11-09 15:25:39 +01:00
design_system design_system 0.5.1: KLogo, fix asset key 2026-11-21 05:58:11 +01:00
earned_time get rid of github ci/cd version check of package… 2026-11-19 18:11:07 +01:00
feedback_inbox get rid of github ci/cd version check of package… 2026-11-19 18:11:07 +01:00
file_length file_length: exclude dirs only inside the repo 2026-11-21 00:26:49 +01:00
firebase firebase: make the rules template impossible to deploy verbatim 2026-08-22 19:10:10 +02:00
flutter_web_drive flutter_web_drive: headless CDP driver + MCP server for Flutter web apps 2026-10-24 22:37:49 +02:00
flutter-setup flutter-setup: exact-key pub cache only (prefix restore-keys broke pub get after a git-dep bump) 2026-10-10 18:39:29 +02:00
focus_project get rid of github ci/cd version check of package… 2026-11-19 18:11:07 +01:00
freedays get rid of github ci/cd version check of package… 2026-11-19 18:11:07 +01:00
game_recording Release sickdays 0.5.6, game_recording 0.1.1 2026-11-19 20:47:38 +01:00
gatelock get rid of github ci/cd version check of package… 2026-11-19 18:11:07 +01:00
github_device_auth github_device_auth 0.5.1: material_ui 1.11.1 2026-11-17 21:50:09 +01:00
godot_dev_tools godot_dev_tools 0.2.1: reporter off when headless 2026-11-17 22:15:17 +01:00
google_account_token Add google_account_token plugin 2026-11-02 10:32:58 +01:00
guard-lib Split the two shell scripts and the gate's own config 2026-08-22 14:59:27 +02:00
holds get rid of github ci/cd version check of package… 2026-11-19 18:11:07 +01:00
home_paths Gate home-relative paths against the ~ layout 2026-09-12 17:10:20 +02:00
kuhy_credit kuhy_credit: keep logo size in stretching parents 2026-11-21 09:03:27 +01:00
leetcode_coach leetcode_coach: ruff format how_to 2026-11-20 17:18:35 +01:00
md_naming Remove aur-publish and dopamine-ux modules 2026-11-10 14:36:47 +01:00
music_theory get rid of github ci/cd version check of package… 2026-11-19 18:11:07 +01:00
omniroute_offload get rid of github ci/cd version check of package… 2026-11-19 18:11:07 +01:00
platform_location platform_location: keep deniedForever, race fixes 2026-11-20 23:29:59 +01:00
repo_contract repo_contract sweep tests: narrow the no-cover pragma 2026-11-19 13:30:55 +01:00
rtdb_relay rtdb_relay 0.2.1: recover the e2e passphrase 2026-11-18 20:52:20 +01:00
scripts platform_location: LocationManager plugin, no gms 2026-11-20 22:55:02 +01:00
sickdays Release sickdays 0.5.6, game_recording 0.1.1 2026-11-19 20:47:38 +01:00
sql_drills get rid of github ci/cd version check of package… 2026-11-19 18:11:07 +01:00
sync_settings_ui sync_settings_ui 0.8.4: data_transfer_flutter 0.2.3 2026-11-17 23:17:10 +01:00
todo_hooks todo_hooks: session-start, canonical token path 2026-11-02 12:24:29 +01:00
ts_config deps: vitest 5.1.1, eslint-react 5.30.4 2026-11-19 12:38:21 +01:00
ts_core deps: vitest 5.1.1, eslint-react 5.30.4 2026-11-19 12:38:21 +01:00
unified-design-system design-system: add the kuhy tab-icon logo 2026-11-20 11:35:55 +01:00
vmbox vmbox discovery test: Pass on pwrtune decoy 2026-11-09 18:15:27 +01:00
web_ui deps: vitest 5.1.1, eslint-react 5.30.4 2026-11-19 12:38:21 +01:00
.dep-freshness-no-workflow get rid of github ci/cd version check of package… 2026-11-19 18:11:07 +01:00
.gitignore Ignore Firebase CLI debug logs 2026-08-22 16:17:39 +02:00
.pre-commit-config.yaml Remove aur-publish and dopamine-ux modules 2026-11-10 14:36:47 +01:00
.pre-commit-hooks.yaml Add todo_hooks closer, drift sweep, PR import 2026-11-02 12:24:29 +01:00
CLAUDE.md kuhy_credit: LaTeX stack for PDF documents 2026-11-20 22:27:55 +01:00
dependency-freshness.allowlist.yaml deps(npm): pnpm 12.10.1, typescript-eslint 8.71.1, @eslint-react 5.24.10, playwright 1.64.0, eslint-plugin-playwright 2.12.1 2026-10-10 08:48:57 +02:00
DOCS-app-errors.md app_errors: ingest kartka too 2026-11-17 23:23:59 +01:00
LICENSE Root scaffold: README, LICENSE, per-subdirectory CI for utils monorepo 2026-07-10 13:02:20 +02:00
README.md platform_location: LocationManager plugin, no gms 2026-11-20 22:55:02 +01:00

utils

Shared libraries used across kuhyx's other projects. Each subdirectory is a formerly-standalone repo, folded in here with full commit history preserved (see each subdirectory's own git log for its pre-merge history).

crdt_sync_dart/

Dart/Flutter CRDT sync library (pub package name: crdt_sync, not published to pub.dev — consumed via a git dependency). Mirrors crdt-sync (below) module-for-module and test-for-test. Consumed by diet_guard's app, screen-locker's workout_app, wake_alarm's phone_app, and todo (whose notes are stored in the v0.2.0 LogStore).

Consume via:

dependencies:
  crdt_sync:
    git:
      url: https://github.com/kuhyx/utils
      ref: crdt_sync_dart-v0.10.0
      path: crdt_sync_dart

sync_settings_ui/

Shared Flutter "Sync settings" screen (pub package name: sync_settings_ui, not published to pub.dev). Firebase sync (primary) plus an optional local backup slot — no GitHub mirror UI. Pure UI + a FirebaseSyncController service layer over injected closures (keystore/Google-plugin access stays in each consuming app, exactly as before this package existed). Consumed by todo, diet_guard_app, workout_app, wake_alarm/phone_app, and home_inventory's dedicated "Sync settings" route.

Consume via:

dependencies:
  sync_settings_ui:
    git:
      url: https://github.com/kuhyx/utils
      ref: sync_settings_ui-v0.1.0
      path: sync_settings_ui

google_account_token/

Flutter plugin (Android only; other platforms return null): one-tap Google ID token via AccountManager, replacing google_sign_in in the sync apps.

Consume via:

dependencies:
  google_account_token:
    git:
      url: https://github.com/kuhyx/utils
      ref: google_account_token-v0.1.0
      path: google_account_token

platform_location/

Flutter plugin (Android only): location through AOSP LocationManager (androidx LocationManagerCompat), replacing geolocator, whose Android side links non-free play-services-location. Used by umbrella and workout_app.

Consume via:

dependencies:
  platform_location:
    git:
      url: https://github.com/kuhyx/utils
      ref: platform_location-v0.1.0
      path: platform_location

crdt-sync/

Python CRDT sync library (package: crdt_sync, not published to PyPI). Same design as crdt_sync_dart (HLC clocks, per-field LWW, sticky-delete tombstones). Consumed by diet-guard and screen-locker.

Consume via:

crdt-sync @ git+https://github.com/kuhyx/utils@crdt-sync-v0.2.0#subdirectory=crdt-sync

guard-lib/

Bash tamper-resistance primitives (guardctl: chattr + bind-mount + systemd watcher + pacman hooks). Not a package — installed by running guard-lib/install.sh as root, which copies files onto the system (/usr/local/bin, /usr/local/lib/guard-lib, systemd units, pacman hooks). Consumed by steam-backlog-enforcer (expects a guard-lib/install.sh sibling clone) and referenced by screen-locker.

app_errors/

The PC ingest of the shared app error and slow-wait reporting: RTDB and local spool reports in, todoImplementer board tickets out, on a systemd --user timer. The reporters live in crdt_sync_flutter, gatelock and godot_dev_tools/addons/app_errors. See DOCS-app-errors.md.

gatelock/

Python lock-window + HMAC log-integrity backend (package: gatelock, not published to PyPI). Consumed via pip by screen-locker, diet-guard, and wake-alarm:

gatelock @ git+https://github.com/kuhyx/utils@gatelock-v0.1.0#subdirectory=gatelock

music_theory/

Music theory from first principles as typed Python (package: music_theory, not published to PyPI): pitch, tuning, scales, chords, progressions, a numpy synth and a Recipe → WAV composer with a degrade transform. Follows Luke Haas's "Music Theory for Programmers" section by section; python -m music_theory demo all --out DIR renders one WAV per section. Consumed by roadside-assistance for its three world-state music beds.

Consume via:

music_theory @ git+https://github.com/kuhyx/utils@music-theory-v0.1.0#subdirectory=music_theory

game_recording/

Session recorder for a game (package: game_recording, stdlib only, not published to PyPI): records a dev run from outside the game and stamps its telemetry moments onto the video. A game configures it with one Config.

Consume via:

game_recording @ git+https://github.com/kuhyx/utils@game-recording-v0.1.1#subdirectory=game_recording

unified-design-system/

Not a package — the frozen design tokens (colors, spacing, type, radius, shadow policy) and per-stack (Flutter/web/Tkinter) implementation patterns that keep every one of kuhy's repos visually identical, plus annotated component references (components.html, button.html). Read unified-design-system/README.md and DOCS-tokens.md before touching any theme/CSS/style file in any repo. The unified-design-system Claude Code skill is a thin pointer here, not a duplicate.

ts_config/

@kuhyx/ts-config — the one lint / TypeScript bar every kuhyx TypeScript repo extends (pnpm only, like ts_core and web_ui). A strict tsconfig.base.json, ESLint flat-config presets (defineConfig() stacking base / react / vitest / playwright / layer boundaries()), a type-free eslint/fast subset for editor hooks, and Knip / jscpd / Stryker bases. Plain JS, no build step; the git tag is the release. Every plugin is a dependency of the package so consumers list none. A fixture repo with one planted violation per rule family proves each gate bites.

"devDependencies": {
  "@kuhyx/ts-config": "github:kuhyx/utils#ts_config-v0.1.0&path:/ts_config"
}

godot_dev_tools/

Godot addon (addons/dev_tools/): the F12 dev feedback mode of kuhy's games (annotate the frozen frame, save a bundle that feedback_inbox turns into a task). A game mounts it at a pinned tag; the game's own code stays a small host object. Read godot_dev_tools/README.md.

Consume via a shallow fetch of the tag, then mount the addon folder:

git clone --depth 1 --branch godot-dev-tools-v0.1.1 https://github.com/kuhyx/utils
# link or copy godot_dev_tools/addons/dev_tools to res://addons/dev_tools