lobstah 0.7.4 → 0.7.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -291,8 +291,8 @@ with a nudge.
291
291
 
292
292
  ## Telemetry 📊
293
293
 
294
- lobstah shares an anonymous daily count of its work, **on by default**. Once
295
- per UTC day the daemon sends `catches: {today, total}` for the UTC day and
294
+ lobstah shares anonymous daily usage statistics, **on by default**. Once
295
+ per UTC day the daemon sends schema 2, with `catches.today` and `catches.total` for the UTC day and
296
296
  all-time, plus up to 100 `traps: [{name, today, harness, model, config}]` entries with automatically
297
297
  generated names and recorded provenance. Custom names (`--name`) and older
298
298
  names with unknown provenance stay local; their catches remain in the totals.
@@ -303,11 +303,22 @@ unrecognised model ids become `other`. No arbitrary config is sent.
303
303
  The payload also includes the lobstah
304
304
  version, OS family, CPU architecture, the UTC date, and a random install id
305
305
  made on your machine. It never sends repository names or paths, code, briefs,
306
- session ids, PR URLs, hostnames, or usernames. Hooks never send
306
+ session ids, PR URLs, hostnames, or usernames. It also sends small count ranges
307
+ for boats and local/wharf grounds, fixed choices for hosted/self-hosted use
308
+ and boat access, and daily catches with/without a live helm and on local/wharf
309
+ grounds. Older unobserved catches stay unknown. Helm presence distinguishes
310
+ none, one and several; an unreadable wharf stays unknown. Boat count is at
311
+ least one locally, or the largest visible account roster; it is unknown when
312
+ the boat cannot read a configured wharf. Telemetry reads cached observations
313
+ only, on its own clock and a fresh connection without wharf credentials or
314
+ cookies. Signing in never links the install id to an account. No account or
315
+ boat identifiers, wharf addresses, grounds names, tokens or times finer than
316
+ the UTC date are sent. Self-hosted wharves receive no telemetry. Hooks never send
307
317
  anything, and nothing is sent until a one-time notice has been shown in your
308
318
  terminal. The counts feed a project-wide `🦞 N` badge. Per-install rows are
309
319
  deleted after 90 days, as are per-trap and worker/config rows; retained daily
310
- totals have only counts, including harness/model aggregates, no names or config.
320
+ totals have only counts, including harness/model aggregates and usage-bucket
321
+ histograms, no names or config.
311
322
 
312
323
  - `lobstah telemetry show` prints the exact JSON that would be sent.
313
324
  - `lobstah telemetry status` shows whether it is on and why.
@@ -319,12 +330,19 @@ No release sends anything yet: the endpoint is not set. Everything about it,
319
330
  including who receives it and how long it is kept, is in
320
331
  [PRIVACY.md](PRIVACY.md).
321
332
 
333
+ ## What a wharf holds
334
+
335
+ Local files are the default. An optional wharf holds your account, boats,
336
+ dispatches, messages and files for coordination across machines. Deleting
337
+ the account removes its work and files; a minimal hashed deletion receipt
338
+ remains for safe retries. This operational storage is separate from anonymous
339
+ telemetry; wharf sign-in never links an account to the telemetry install id.
340
+
322
341
  ## Non-goals
323
342
 
324
343
  No webhooks or inbound listeners, no merge decisions in core, no tracker
325
- vocabulary in core, no hosted service (the one exception is the small
326
- anonymous telemetry endpoint in [`services/telemetry`](services/telemetry),
327
- which you can turn off).
344
+ vocabulary in core. The optional wharf leaves local files as the default;
345
+ the separate anonymous telemetry service can be turned off.
328
346
 
329
347
  ## License
330
348