@robbeverhelst/do 1.298.0 → 1.299.0

package/dist/do.js

@@ -5502,6 +5502,7 @@ var EVIDENCE_SOURCES = [
   "routine_run",
   "do_activity",
   "github",
+  "phone_location",
   "plan_default"
 ];
 var blockEvidence = pgTable("block_evidence", {
@@ -5518,7 +5519,7 @@ var blockEvidence = pgTable("block_evidence", {
 }, (t) => [
   index("block_evidence_block_idx").on(t.blockId, t.at),
   check("block_evidence_weight_range", sql`${t.weight} BETWEEN 1 AND 5`),
-  check("block_evidence_source_check", sql`${t.source} IN ('chat', 'edit_do', 'edit_google', 'google_health', 'wakehook', 'strava', 'habit', 'task', 'routine_run', 'do_activity', 'github', 'plan_default')`)
+  check("block_evidence_source_check", sql`${t.source} IN ('chat', 'edit_do', 'edit_google', 'google_health', 'wakehook', 'strava', 'habit', 'task', 'routine_run', 'do_activity', 'github', 'phone_location', 'plan_default')`)
 ]);
 
 // ../../packages/schema/src/db/food-log.ts
@@ -20713,9 +20714,20 @@ var METRICS = {
   mood: { label: "Mood", unit: "/5", min: 1, max: 5, step: 1 },
   rating: { label: "Day rating", unit: "/10", min: 1, max: 10, step: 1 },
   energy: { label: "Energy", unit: "/10", min: 1, max: 10, step: 1 },
-  bedtime: { label: "Bedtime", unit: "clock", min: 0, max: 720, step: 5 }
+  bedtime: { label: "Bedtime", unit: "clock", min: 0, max: 720, step: 5 },
+  resting_hr: { label: "Resting heart rate", unit: "bpm", min: 25, max: 200, step: 1 },
+  hrv: { label: "HRV", unit: "ms", min: 1, max: 400, step: 1 }
 };
-var metricKeySchema = _enum2(["weight", "sleep", "mood", "rating", "energy", "bedtime"]);
+var metricKeySchema = _enum2([
+  "weight",
+  "sleep",
+  "mood",
+  "rating",
+  "energy",
+  "bedtime",
+  "resting_hr",
+  "hrv"
+]);
 var metricSourceSchema = _enum2([
   "manual",
   "device",
@@ -22143,7 +22155,8 @@ var PLACE_SENSOR_READINGS = Object.keys(SHED_READING_TYPES);
 var ASSET_READING_TYPES = {
   state: "asset.state",
   power: "asset.power",
-  energy: "asset.energy"
+  energy: "asset.energy",
+  presence: "asset.presence"
 };
 var ASSET_SENSOR_READINGS = Object.keys(ASSET_READING_TYPES);
 var sensorReadingValues = [
@@ -22216,6 +22229,27 @@ var assetReadingSchema = object({
   device: string2().nullable(),
   at: exports_coerce.date()
 });
+var unifiLinkInputSchema = object({
+  baseUrl: string2().trim().url().refine((u) => /^https?:\/\//i.test(u), "must start with http:// or https://"),
+  apiKey: string2().trim().min(1).max(500),
+  site: string2().trim().min(1).max(100).default("default")
+}).strict();
+var unifiStatusSchema = object({
+  linked: boolean3(),
+  host: string2().nullable(),
+  site: string2().nullable(),
+  links: number2().int().nonnegative(),
+  lastReadingAt: string2().nullable()
+});
+var unifiDeviceSchema = object({
+  mac: string2(),
+  name: string2(),
+  kind: _enum2(["device", "client"]),
+  model: string2().nullable(),
+  online: boolean3(),
+  firmware: string2().nullable(),
+  link: sensorLinkSchema.nullable()
+});
 
 // ../../packages/schema/src/contracts/house.ts
 var day = string2().regex(/^\d{4}-\d{2}-\d{2}$/, "must be a calendar day (YYYY-MM-DD)");
@@ -23554,10 +23588,17 @@ var JOURNAL_SEARCH_LIMIT = 30;
 var journalSearchQuerySchema = object({
   q: string2().trim().min(2, "search for at least 2 characters").max(100)
 });
+var journalSearchUnderstoodSchema = object({
+  words: array(string2()),
+  from: journalDateSchema.nullable(),
+  to: journalDateSchema.nullable(),
+  feeling: _enum2(["low", "high"]).nullable()
+});
 var journalSearchSchema = object({
   q: string2(),
   timezone: string2().min(1),
-  days: array(journalDayListItemSchema).max(JOURNAL_SEARCH_LIMIT)
+  days: array(journalDayListItemSchema).max(JOURNAL_SEARCH_LIMIT),
+  understood: journalSearchUnderstoodSchema.nullable().default(null)
 });
 var journalLinkInputSchema = object({
   kind: string2().trim().regex(/^[a-z][a-z_]{0,31}$/, "a link kind is a short lowercase word"),
@@ -27727,7 +27768,7 @@ var createSeatingProposalInputSchema = object({
   return new Set(ids).size === ids.length;
 }, { message: "a guest can sit at one table only", path: ["tables"] });
 var seatingProposalsQuerySchema = object({ guestListId: ulidSchema });
-var GUEST_EXPORT_KINDS = ["caterer", "venue", "floor-plan", "church"];
+var GUEST_EXPORT_KINDS = ["caterer", "venue", "floor-plan", "church", "answers"];
 var guestExportKindSchema = _enum2(GUEST_EXPORT_KINDS);
 var thankYouGiftSchema = object({
   momentId: ulidSchema,
@@ -29706,7 +29747,7 @@ function parseCapture2(input, now) {
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.298.0";
+var VERSION = "1.299.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -31002,6 +31043,21 @@ var HEALTH_COMMAND_SPECS = [
     scopes: READ,
     returns: "HealthSummary"
   },
+  {
+    path: ["health", "export"],
+    summary: "Take every health record with you: one FHIR R4 Bundle (JSON) with the documents inline.",
+    args: [],
+    flags: [
+      {
+        name: "no-files",
+        type: "boolean",
+        description: "Leave the documents' bytes out (their DocumentReferences stay)."
+      }
+    ],
+    scopes: ["health:export"],
+    returns: "HealthExportBundle",
+    notes: "Streams GET /api/v1/health/export verbatim: redirect it to a file (`do health export > health.json`). The export shows in your Who looked."
+  },
   {
     path: ["health", "shares"],
     summary: "Your For-the-doctor links: sections, expiry, opens; never the secret.",
@@ -31618,7 +31674,7 @@ var COMMAND_SPECS = [
     flags: [],
     scopes: ["journal:read"],
     returns: "JournalSearch",
-    notes: "GET /api/v1/journal/search?q= \u2014 matches the one-liner, highlights, the summary and entries of your own days (at most 30). journal:read is a sensitive scope."
+    notes: "GET /api/v1/journal/search?q= \u2014 your own days only, best match first (at most 30): the words (and a few that mean the same, English and Dutch) in the one-liner, tags, highlights, summary and entries; a date phrase (in March, last week, 14 October, 2026-02) narrows to its window; a heavy or bright question (rough, tired, a great day) adds the days rated 4 or less / 8 or more. `understood` says how it was read. journal:read is a sensitive scope."
   },
   {
     path: ["journal", "recall"],
@@ -32578,7 +32634,7 @@ var COMMAND_SPECS = [
   },
   {
     path: ["metrics", "list"],
-    summary: "Show weight, sleep, mood, the day rating, energy and bedtime as daily trend lines (no target, no streak).",
+    summary: "Show weight, sleep, mood, the day rating, energy, bedtime, resting heart rate and HRV as daily trend lines (no target, no streak). Resting heart rate and HRV need health:read too.",
     args: [],
     flags: [{ name: "days", type: "string", description: "How far back, 1\u2013730 (default 90)." }],
     scopes: ["habits:read"],
@@ -32586,7 +32642,7 @@ var COMMAND_SPECS = [
   },
   {
     path: ["metrics", "sessions"],
-    summary: "Show workout sessions your connections brought in (Google Fit, Strava), newest first.",
+    summary: "Show workout sessions your connections brought in (Google Fit, Google Health, Strava), newest first.",
     args: [],
     flags: [{ name: "days", type: "string", description: "How far back, 1\u2013365 (default 14)." }],
     scopes: ["habits:read"],
@@ -32594,9 +32650,13 @@ var COMMAND_SPECS = [
   },
   {
     path: ["metrics", "log"],
-    summary: "Log a value: weight (kg), sleep (h), mood (1\u20135), rating (1\u201310), energy (1\u201310) or bedtime (HH:MM).",
+    summary: "Log a value: weight (kg), sleep (h), mood (1\u20135), rating (1\u201310), energy (1\u201310), bedtime (HH:MM), resting_hr (bpm) or hrv (ms; these two need health:write).",
     args: [
-      { name: "key", required: true, description: "weight|sleep|mood|rating|energy|bedtime." },
+      {
+        name: "key",
+        required: true,
+        description: "weight|sleep|mood|rating|energy|bedtime|resting_hr|hrv."
+      },
       {
         name: "value",
         required: true,
@@ -35205,6 +35265,33 @@ var COMMAND_SPECS = [
     returns: "SensorSyncResult",
     notes: "POST /api/v1/sensors/home-assistant/sync. A room's readings feed its card and the room alarm; an asset's show on its page. Returns entities, written, skipped, missing and the error (unauthorized, unavailable, bad_response). 409 before Home Assistant is linked."
   },
+  {
+    path: ["sensors", "unifi"],
+    summary: "Whether the Space has linked UniFi, how many devices are mapped, the newest reading.",
+    args: [],
+    flags: [],
+    scopes: ["places:read"],
+    returns: "UnifiStatus",
+    notes: "GET /api/v1/sensors/unifi. Linking UniFi (address + API key) is a member's, in Settings \u2192 Home; a key never sees the API key."
+  },
+  {
+    path: ["sensors", "unifi-devices"],
+    summary: "Every device and connected client UniFi sees, with the asset each is mapped to.",
+    args: [],
+    flags: [],
+    scopes: ["places:read", "collections:read"],
+    returns: "UnifiDevice[]",
+    notes: "GET /api/v1/sensors/unifi/devices. Map one with `do sensors map <mac> <asset> --reading presence --provider unifi`, or give the asset `external.unifiMac` on its facet. 409 before UniFi is linked."
+  },
+  {
+    path: ["sensors", "unifi-sync"],
+    summary: "Put every mapped device's presence (online/offline, firmware) on its asset now.",
+    args: [],
+    flags: [],
+    scopes: ["places:write"],
+    returns: "SensorSyncResult",
+    notes: "POST /api/v1/sensors/unifi/sync. Assets whose facet names a UniFi MAC are mapped first; readings land as asset.presence on change, else hourly. The worker does the same every five minutes. 409 before UniFi is linked."
+  },
   {
     path: ["sensors", "links"],
     summary: "The mapped entities, or the ones on one Place or asset.",
@@ -35229,7 +35316,12 @@ var COMMAND_SPECS = [
       {
         name: "reading",
         type: "string",
-        description: "A room's temp|humidity|heater|water|door|feeder|light, or an asset's state|power|energy."
+        description: "A room's temp|humidity|heater|water|door|feeder|light, or an asset's state|power|energy|presence."
+      },
+      {
+        name: "provider",
+        type: "string",
+        description: "home_assistant (default) or unifi: a UniFi device by its MAC, onto an asset's presence."
       },
       { name: "label", type: "string", description: "A name for it (Home Assistant's own)." }
     ],
@@ -35687,13 +35779,13 @@ var COMMAND_SPECS = [
   },
   {
     path: ["guest-lists", "export"],
-    summary: "Export for the caterer (CSV) or the venue (CSV) to stdout, or save the floor plan (PDF) to a file.",
+    summary: "Export for the caterer, the venue, the church or the RSVP answers (CSV) to stdout, or save the floor plan (PDF) to a file.",
     args: [{ name: "id", required: true, description: "The guest list's id." }],
     flags: [
       {
         name: "kind",
         type: "string",
-        description: "caterer (meals and diets per table), venue (who sits where) or floor-plan (PDF)."
+        description: "caterer (meals and diets per table), venue (who sits where), church (who comes to the ceremony), answers (every RSVP answer, a row per guest) or floor-plan (PDF)."
       },
       {
         name: "out",
@@ -37217,9 +37309,15 @@ function renderJournalDays(data, mode) {
 }
 function renderJournalSearch(data, mode) {
   const d = data;
-  if ((d.days ?? []).length === 0)
-    return paint(mode, "dim", "(no journal days mention that)");
-  return renderJournalDays({ days: d.days }, mode);
+  const u = d.understood;
+  const read = u && (u.from || u.feeling) ? paint(mode, "dim", `Read as: ${[
+    u.from && u.to ? u.from === u.to ? u.from : `${u.from} \u2013 ${u.to}` : null,
+    ...u.words,
+    u.feeling === "low" ? "heavier days" : u.feeling === "high" ? "brighter days" : null
+  ].filter(Boolean).join(" \xB7 ")}`) : null;
+  const body = (d.days ?? []).length === 0 ? paint(mode, "dim", "(no journal days mention that)") : renderJournalDays({ days: d.days }, mode);
+  return read ? `${read}
+${body}` : body;
 }
 function renderJournalRecall(data, mode) {
   const d = data;
@@ -40673,6 +40771,18 @@ var HANDLERS = {
     data: await requireClient().post("/sensors/home-assistant/sync", {}),
     render: renderRecord
   }),
+  "sensors unifi": async ({ requireClient }) => ({
+    data: await requireClient().get("/sensors/unifi"),
+    render: renderRecord
+  }),
+  "sensors unifi-devices": async ({ requireClient }) => ({
+    data: await requireClient().get("/sensors/unifi/devices"),
+    render: renderList
+  }),
+  "sensors unifi-sync": async ({ requireClient }) => ({
+    data: await requireClient().post("/sensors/unifi/sync", {}),
+    render: renderRecord
+  }),
   "sensors links": async ({ flags, requireClient }) => ({
     data: await requireClient().get("/sensors/links", {
       query: { nodeId: flagString(flags, "node") }
@@ -40684,6 +40794,7 @@ var HANDLERS = {
       externalId: requireArg(args, 0, "entity id"),
       nodeId: requireArg(args, 1, "node id"),
       reading: flagString(flags, "reading"),
+      ...flagString(flags, "provider") ? { provider: flagString(flags, "provider") } : {},
       ...flagString(flags, "label") ? { label: flagString(flags, "label") } : {}
     });
     return { data: await requireClient().post("/sensors/links", body), render: renderRecord };
@@ -40780,6 +40891,12 @@ var HANDLERS = {
     }),
     render: renderRecord
   }),
+  "health export": async ({ flags, requireClient }) => {
+    const raw = await requireClient().getText("/health/export", {
+      query: { files: flagBool(flags, "no-files") ? "false" : undefined }
+    });
+    return { raw, data: undefined, render: () => raw };
+  },
   "health shares": async ({ requireClient }) => ({
     data: await requireClient().getPage("/health/shares"),
     render: renderList

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robbeverhelst/do",
-  "version": "1.298.0",
+  "version": "1.299.0",
   "private": false,
   "description": "do — the agent-drivable CLI over the public /api/v1 surface",
   "homepage": "https://github.com/robbeverhelst/do/tree/main/apps/cli",