allinkeys

Imported from mattysparkles/allinkeys (AGENTS.md). Install upstream with npx skills add mattysparkles/allinkeys. Copyright stays with the author.

Agent Notes

• Telemetry admin endpoints live in telemetry_service/routes/admin.py and should remain protected by get_current_admin_user.
• When changing the telemetry admin experience, update the documentation in docs/telemetry.md and docs/TELEMETRY.md.

Task Log

• 2026-02-23 20:04:48Z: Started investigation into global telemetry dashboard metrics (total submissions/recent ranges) not updating for live machine frosted-quartz.
• 2026-02-23 20:22:11Z: Diagnosed telemetry ingest stalling after 2026-02-21 (no /v1/machines/*/telemetry since then; seed_events last_seen 2026-02-21) while snapshots/control/checks continue; updated telemetry_service/routes/machines.py to prevent empty snapshot range payloads from overwriting existing range data; attempted pytest tests/test_telemetry.py -q (failed: multiprocessing semaphore permission error); restarted allinkeys-telemetry.service.
• 2026-02-23 21:49:41Z: Investigating duplicate Frosted-Quartz machine entries after running --telemetry-setup (new machine registrations leaving old rows).
• 2026-02-23 21:57:06Z: Added dedupe-aware machine registration: MachineRegisterRequest now accepts machine_id/machine_identity; server reuses existing machine by identity or id and updates metadata; snapshot ingest now updates machine_identity; telemetry setup sends persisted machine_id + stable machine_identity; TelemetryClient registration includes machine_identity. Restarted allinkeys-telemetry.service.
• 2026-02-23 21:59:50Z: Deleted duplicate Frosted-Quartz machine rows (a12f4279-1312-4179-a83c-dcdd8ed1fccd, bc9f791b-107e-44fa-a54e-9bd44945d696) and kept newest 29e3dad7-f86b-49f2-8ee2-b69c41e6a7b5; restarted allinkeys-telemetry.service to clear in-memory registry.
• 2026-02-23 22:02:30Z: Investigating continued lack of recent range submissions/total submissions updates after client update in btc-only mode.
• 2026-02-23 22:15:39Z: Verified telemetry service still has no /v1/machines/*/telemetry ingest since 2026-02-21; seed_events max last_seen remains 2026-02-21T19:06:57Z.
• 2026-02-23 22:17:28Z: Added btc-only pre-run range telemetry emission in core/keygen.py so each file run records a range observation and seed event even when output parsing yields empty ranges; pushed to GitHub.
• 2026-02-23 22:38:28Z: Confirmed snapshots continue for Frosted-Quartz but range_recent remains empty and seed_events still stale, indicating client telemetry batches are still not being sent.
• 2026-01-18 20:10:18Z: Disambiguated range distribution SQL in telemetry_service/app.py, added JWT env keys in .env, dropped git stash, created telemetry.service alias and reloaded systemd, restarted allinkeys-telemetry.service. Tail logs show only 401 responses (no SQL errors); caddyclient not present in repo/requirements.
• 2026-01-18 20:24:23Z: Mounted telemetry_dashboard/dist at / in telemetry_service/app.py so the root UI serves, preserving API routes and static assets.
• 2026-01-18 20:34:06Z: Added /api/machines aliases, a single-machine detail endpoint, and a new machine control page (telemetry_service/templates/machine.html), plus a Control link in the machines dashboard.
• 2026-01-18 20:48:12Z: Logged telemetry control command application results in core/telemetry.py for pause/resume/set_mode/set_range handling.
• 2026-01-18 21:05:22Z: Allowed /v1/dashboard requests through API key middleware in telemetry_service/app.py to unblock dashboard UI.
• 2026-01-18 21:23:55Z: Added public /v1/dashboard API responses (health, recent ranges, contributors, machine series) with optional user scoping and updated telemetry docs.
• 2026-01-30 06:53:48Z: Updated public dashboard endpoints to prefer human-readable machine names in health/recent ranges/top contributors, documented the label changes, and restarted allinkeys-telemetry.service to make the updates live.
• 2026-02-10 19:30:00Z: Expanded dashboard filtering and metrics: added scope/machine_id/range_id/until filters plus new /v1/dashboard/{slug}/ranges/ids and /v1/dashboard/{slug}/metrics/aggregate endpoints, enabled cookie-scoped dashboard access, added BTC address-type counters in dashboard metrics, and refreshed the public telemetry UI with full-width charts, zoom controls, filter UI, and address-checked charts. Linked machine cards to the public telemetry explorer and updated telemetry docs.
• 2026-02-10 22:32:09Z: Committed/pushed telemetry dashboard updates to GitHub and restarted allinkeys-telemetry.service to make the endpoints and UI changes live.
• 2026-02-10 22:50:31Z: Tightened telemetry dashboard chart zoom limits to the 0–100% keyspace range with dynamic y-bounds, added 401 fallback for aggregate metrics, and refreshed the public dashboard observer script.
• 2026-02-10 23:40:30Z: Added SQLite busy timeout/connection timeout in telemetry DB connections to reduce "database is locked" 500s affecting dashboard charts.
• 2026-02-10 23:44:06Z: Moved telemetry DB schema setup behind a one-time init lock to avoid per-request DDL and reduce "database is locked" errors; pushed to GitHub and restarted allinkeys-telemetry.service.
• 2026-02-11 00:22:17Z: Added seed-queue tables/endpoints and queue_seed control handling (client-side queue consumption in keygen), plus telemetry dashboard crosshair selection, scrollbars, and queue UI updates; refreshed telemetry docs.
• 2026-02-11 00:50:12Z: Moved chart Y-scrollbars onto the y-axis, enabled crosshair + click-to-queue on position charts, and added since/until support to aggregate metrics; updated telemetry docs.
• 2026-02-11 02:39:39Z: Added persistent marker dots + counter/clear button for chart clicks, crosshair on metric charts, and y-axis scrollbar positioning tweaks in telemetry dashboard UI.
• 2026-02-11 03:02:37Z: Fixed crosshair alignment, added purple marker overlays across position charts, and added seed queue progress polling via machine metrics; client now tracks seed_queue_depth and logs queued seed consumption.
• 2026-02-11 03:36:20Z: Improved crosshair cursor tracking, unpinned crosshair after clicks, expanded marker overlays across charts, and enhanced queue push error reporting in the telemetry dashboard UI.
• 2026-02-11 05:05:41Z: Fixed seed queue push validation by using get_machine_for_user in queue endpoints to resolve a NameError causing 500s.
• 2026-02-11 05:10:39Z: Pushed the queue validation fix to GitHub and restarted allinkeys-telemetry.service.
• 2026-02-11 05:20:12Z: Bumped Windows release workflow default tag to v0.1.1 and updated changelogs/readme for v0.1.1 release prep.
• 2026-02-11 05:25:46Z: Tagged and pushed v0.1.1 to trigger the Windows release workflow.
• 2026-02-11 06:19:31Z: Routed telemetry payload debug output through logger (DEBUG only) to stop massive stdout dumps during flushes.
• 2026-02-11 08:34:31Z: Addressed CodeQL alerts by hardening redirect sanitization, removing regex-based relative parsing, parameterizing dashboard queries, adding log redaction, and declaring workflow permissions.
• 2026-02-23 23:02:59Z: Started packaging a single copy/paste PowerShell diagnostic script for Windows client telemetry checks (auth token, endpoint, queue DB, and telemetry logs) to avoid multiline quoting failures.
• 2026-02-23 23:03:05Z: Delivered a one-shot PowerShell script flow that writes/runs diag.py, prints telemetry config + queue state, and dumps recent [Telemetry] log lines.
• 2026-02-24 12:22:54Z: Started follow-up Windows diagnostics support after user reported the one-shot script appeared to do nothing; likely stuck in an unclosed PowerShell here-string due indented terminator.
• 2026-02-24 12:22:59Z: Provided a no-here-string fallback PowerShell script generator ($lines array -> diag.py) plus combined output capture to avoid multiline paste/terminator issues.
• 2026-02-24 12:25:30Z: Began remediation for mixed-shell copy/paste failures after user pasted PowerShell commands containing a Linux prompt token; preparing shell-safe diagnostics instructions.
• 2026-02-24 12:26:07Z: Sent corrected PowerShell-only diagnostic runbook that excludes prompt text and avoids mixed-shell/here-string continuation issues.
• 2026-02-24 12:28:15Z: Collected user-provided Windows telemetry logs; observed repeated 2026-02-23 control/snapshot failures (502/read timeout) and started root-cause analysis for missing telemetry ingest.
• 2026-02-24 12:40:00Z: Added backward-compatible telemetry seed event emitter in core/keygen.py to avoid silent drops when record_seed_event lacks range_observation (fallback strips arg); replaced all direct seed event calls with helper. Validated via python -m py_compile core/keygen.py; pytest remains blocked in sandbox by multiprocessing semaphore PermissionError.
• 2026-02-24 12:40:41Z: Committed/pushed telemetry seed emission compatibility fix (409a7ca) to main after validating syntax compile (python -m py_compile core/keygen.py).
• 2026-02-24 12:45:48Z: Started follow-up after user reported no telemetry flush log lines and no dashboard metric changes post-update; re-checking live ingest and client telemetry activation path.
• 2026-02-24 12:49:36Z: Added tools/telemetry_diag.py (single-command local diagnostics without importing heavy runtime modules) and validated syntax (python -m py_compile tools/telemetry_diag.py core/keygen.py) to simplify Windows troubleshooting of telemetry enablement/queue state.
• 2026-02-24 13:00:26Z: Began deeper client-path diagnostics after user confirmed telemetry queue empty/no flush logs despite updated code; extending telemetry diag tooling to enumerate all queue DB variants and optional local test event emission.
• 2026-02-24 13:01:22Z: Extended tools/telemetry_diag.py to enumerate all telemetry_queue*.db files (not just telemetry_queue.db), report per-DB queued counts/mtimes, and optionally emit a test telemetry event via --emit-test for one-command Windows verification.
• 2026-02-24 13:08:40Z: Isolated root cause for missing telemetry event queueing: _ensure_seed_client() in core/telemetry.py assigns _CLIENT without declaring global _CLIENT, causing UnboundLocalError on every seed/range event call (silently swallowed by keygen call sites).
• 2026-02-24 13:09:05Z: Fixed telemetry seed client initialization bug by declaring global _CLIENT in _ensure_seed_client() (core/telemetry.py), which prevents UnboundLocalError and allows seed/range events to queue/flush again.
• 2026-02-24 14:45:36Z: Started release prep for telemetry fix rollout: bumping project version and creating a new GitHub release tag including recent telemetry queue/seed client fixes.
• 2026-02-24 14:46:37Z: Completed release prep for v0.1.2: updated CHANGELOG.md + readme.md release notes and bumped .github/workflows/release-windows.yml dispatch default tag to v0.1.2.
• 2026-02-24 15:15:39Z: Finalized GitHub release cut for telemetry fixes: committed release prep (d4fe310), created/pushed tag v0.1.2, and pushed main so Windows release workflow can publish new assets.