@robbeverhelst/do 1.351.0 → 1.352.0

package/dist/do.js

@@ -14420,7 +14420,7 @@ var configError = (message) => new CliError("config", message, EXIT.CONFIG);
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.351.0";
+var VERSION = "1.352.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -14722,8 +14722,8 @@ class DoClient {
   put(path, body) {
     return this.request("PUT", path, { body });
   }
-  delete(path) {
-    return this.request("DELETE", path, {});
+  delete(path, opts = {}) {
+    return this.request("DELETE", path, opts);
   }
   upload(path, form) {
     return this.request("POST", path, { form });
@@ -17650,6 +17650,7 @@ var tenants = pgTable("tenants", {
   name: text("name").notNull(),
   backdrop: text("backdrop"),
   gaardHouseUrl: text("gaard_house_url"),
+  address: text("address"),
   awayFrom: date5("away_from", { mode: "string" }),
   awayUntil: date5("away_until", { mode: "string" }),
   lastTaskNumber: integer2("last_task_number").notNull().default(0),
@@ -18455,6 +18456,7 @@ var contacts = pgTable("contacts", {
   website: text("website"),
   notes: text("notes"),
   tags: text("tags").array().notNull().default([]),
+  knowsAbout: text("knows_about").array().notNull().default([]),
   lastContactedAt: timestamp("last_contacted_at", { withTimezone: true }),
   keepInTouchRuleId: text("keep_in_touch_rule_id").references(() => recurrenceRules.id),
   rhythmDays: integer2("rhythm_days"),
@@ -19475,7 +19477,8 @@ var oauthIdentitySchema = createSelectSchema(oauthIdentities, {
 var spaceSchema = createSelectSchema(tenants, {
   createdAt: exports_coerce.date(),
   updatedAt: exports_coerce.date(),
-  deletedAt: exports_coerce.date().nullable()
+  deletedAt: exports_coerce.date().nullable(),
+  address: string2().nullable().default(null)
 }).omit({
   gaardHouseUrl: true,
   awayFrom: true,
@@ -19484,12 +19487,14 @@ var spaceSchema = createSelectSchema(tenants, {
   lastProjectNumber: true
 });
 var backdropIdSchema = string2().trim().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, "a backdrop id is lowercase words joined by dashes").max(40);
+var spaceAddressSchema = string2().trim().max(200).transform((line) => line || null).nullable();
 var updateSpaceInputSchema = object({
   name: string2().trim().min(1).max(120).optional(),
-  backdrop: backdropIdSchema.nullable().optional()
-}).strict().refine((input) => input.name !== undefined || input.backdrop !== undefined, {
-  message: "nothing to update"
-});
+  backdrop: backdropIdSchema.nullable().optional(),
+  address: spaceAddressSchema.optional()
+}).strict().refine((input) => input.name !== undefined || input.backdrop !== undefined || input.address !== undefined, { message: "nothing to update" });
+var setSpaceAddressInputSchema = object({ address: spaceAddressSchema }).strict();
+var spaceAddressViewSchema = object({ address: string2().nullable() });
 var onboardingResultSchema = object({ onboardingCompleted: boolean2() });
 var authMethodsSchema = object({
   hasPassword: boolean2(),
@@ -21010,6 +21015,12 @@ var animalArrivedInputSchema = object({
 }).strict();
 
 // ../../packages/schema/src/operations/crud.ts
+var DELETE_REASON_QUERY = [
+  {
+    name: "reason",
+    description: `An Agent's one line on why (first line, up to 280 characters); the Trash shows it as "Deleted by <agent>: <reason>". Ignored for a member's key.`
+  }
+];
 function crudOperations(r) {
   const base = `/${r.segment}`;
   const one = `/${r.segment}/{id}`;
@@ -21072,6 +21083,7 @@ function crudOperations(r) {
       tag: r.tag,
       summary: `Delete a ${r.noun}`,
       description: `Delete a ${r.noun}; fires the \`${event}.deleted\` webhook.`,
+      query: DELETE_REASON_QUERY,
       status: 204,
       response: { description: "Deleted." },
       errors: { 404: true },
@@ -25644,7 +25656,8 @@ var contactSchema = createSelectSchema(contacts, {
   userId: string2().nullable().default(null),
   rhythmDays: number2().int().nullable().default(null),
   rhythmSnoozedUntil: string2().nullable().default(null),
-  emailInvalidAt: exports_coerce.date().nullable().default(null)
+  emailInvalidAt: exports_coerce.date().nullable().default(null),
+  knowsAbout: array(string2()).default([])
 });
 var contactImportantDateSchema = object({
   id: ulidSchema,
@@ -25677,6 +25690,18 @@ var contactImportantDateInputSchema = preprocess((v) => {
   eventDate: new Date(Date.UTC(YEARLESS_YEAR, d.eventDate.getUTCMonth(), d.eventDate.getUTCDate()))
 } : d));
 var websiteSchema = string2().trim().url().max(500).refine((v) => /^https?:\/\//i.test(v), "must start with http:// or https://");
+var KNOWS_ABOUT_PHRASE_MAX = 80;
+var KNOWS_ABOUT_MAX = 30;
+var knowsAboutSchema = array(string2().trim().max(KNOWS_ABOUT_PHRASE_MAX)).max(KNOWS_ABOUT_MAX).transform((phrases) => {
+  const seen = new Set;
+  return phrases.filter((phrase) => {
+    const key = phrase.toLowerCase();
+    if (!phrase || seen.has(key))
+      return false;
+    seen.add(key);
+    return true;
+  });
+});
 var createContactInputSchema = createInsertSchema(contacts, {
   id: ulidSchema,
   email: string2().email().nullish(),
@@ -25685,6 +25710,7 @@ var createContactInputSchema = createInsertSchema(contacts, {
   website: websiteSchema.nullish(),
   notes: string2().nullish(),
   tags: array(string2()).optional(),
+  knowsAbout: knowsAboutSchema.optional(),
   lastContactedAt: exports_coerce.date().nullish(),
   rhythmDays: contactPeopleInputShape.rhythmDays,
   rhythmSnoozedUntil: contactPeopleInputShape.rhythmSnoozedUntil
@@ -25702,6 +25728,7 @@ var updateContactInputSchema = createUpdateSchema(contacts, {
   website: websiteSchema.nullish(),
   notes: string2().nullish(),
   tags: array(string2()).optional(),
+  knowsAbout: knowsAboutSchema.optional(),
   lastContactedAt: exports_coerce.date().nullish(),
   rhythmDays: contactPeopleInputShape.rhythmDays,
   rhythmSnoozedUntil: contactPeopleInputShape.rhythmSnoozedUntil
@@ -37004,7 +37031,13 @@ var automationRunSummarySchema = object({
 });
 var automationListItemSchema = automationViewSchema.extend({
   madeBy: object({ userId: string2(), name: string2(), you: boolean2() }).nullable(),
-  lastRun: automationRunSummarySchema.nullable()
+  lastRun: automationRunSummarySchema.nullable(),
+  needs: object({
+    connectionId: string2(),
+    provider: string2(),
+    title: string2(),
+    reconnect: boolean2()
+  }).nullable().default(null)
 });
 var automationRunNowSchema = object({ queued: literal(true) });
 
@@ -39840,6 +39873,7 @@ var shareLinkSchema = createSelectSchema(shareLinks, {
   updatedAt: exports_coerce.date()
 });
 var shareLinkPublicSchema = shareLinkSchema.omit({ tokenHash: true });
+var shareLinkListedSchema = shareLinkPublicSchema.extend({ token: string2().nullable() });
 var createShareLinkInputSchema = createInsertSchema(shareLinks, {
   id: ulidSchema,
   nodeId: ulidSchema,
@@ -40087,6 +40121,32 @@ var shoppingListOperations = defineOperations({
   })
 });
 
+// ../../packages/schema/src/operations/space.ts
+var spaceOperations = defineOperations({
+  address: {
+    method: "get",
+    path: "/space/address",
+    scopes: ["settings:read"],
+    tag: "Space",
+    summary: "Get the Space's address",
+    description: "The household's postal address as `{ address }`: one line, or null when none is set.",
+    status: 200,
+    response: { description: "The Space's address." }
+  },
+  setAddress: {
+    method: "put",
+    path: "/space/address",
+    scopes: ["settings:write"],
+    tag: "Space",
+    summary: "Set the Space's address",
+    description: "Set the household's postal address to one line (trimmed, at most 200 characters); `null` or a blank line clears it. Returns `{ address }`.",
+    body: setSpaceAddressInputSchema,
+    status: 200,
+    response: { description: "The Space's address now." },
+    errors: { 400: true }
+  }
+});
+
 // ../../packages/schema/src/db/tap-tags.ts
 var tapTagKind = pgEnum("tap_tag_kind", ["habit", "routine"]);
 var tapTags = pgTable("tap_tags", {
@@ -40503,6 +40563,7 @@ var taskOperations = defineOperations({
     tag: "Tasks",
     summary: "Delete a task",
     description: "Delete a task; fires the `task.deleted` webhook.",
+    query: DELETE_REASON_QUERY,
     status: 204,
     response: { description: "Deleted." },
     errors: { 404: true },
@@ -46808,6 +46869,22 @@ function renderKraken(data, mode) {
 }
 var commands11 = pairCommands(CONNECTION_COMMAND_SPECS, CONNECTION_HANDLERS);
 
+// ../../packages/domain/src/knows-about.ts
+var same = (a, b) => a.trim().toLowerCase() === b.trim().toLowerCase();
+function knowsAboutHas(list, phrase) {
+  return list.some((p) => same(p, phrase));
+}
+function canAddKnowsAbout(list, draft) {
+  const phrase = draft.trim();
+  return phrase.length > 0 && phrase.length <= KNOWS_ABOUT_PHRASE_MAX && list.length < KNOWS_ABOUT_MAX && !knowsAboutHas(list, phrase);
+}
+function addKnowsAbout(list, draft) {
+  return canAddKnowsAbout(list, draft) ? [...list, draft.trim()] : [...list];
+}
+function removeKnowsAbout(list, phrase) {
+  return list.filter((p) => !same(p, phrase));
+}
+
 // src/commands/contacts.ts
 var FIELD_FLAGS = [
   { name: "name", type: "string", description: "The display name (or pass it as the argument)." },
@@ -46837,6 +46914,21 @@ var FIELD_FLAGS = [
     description: "The circle ids they are in, comma-separated (replaces the membership)."
   },
   { name: "tags", type: "string", description: "Tags, comma-separated (replaces the tags)." },
+  {
+    name: "knows",
+    type: "string",
+    description: "What they know about, the go-to for, comma-separated (replaces the list; none clears it)."
+  },
+  {
+    name: "knows-add",
+    type: "string",
+    description: `One more thing they know about ("the boat's engine"); a repeat is skipped.`
+  },
+  {
+    name: "knows-remove",
+    type: "string",
+    description: "Take one thing off what they know about (ignoring case)."
+  },
   { name: "notes", type: "string", description: "Long-form notes." },
   {
     name: "rhythm",
@@ -46862,10 +46954,10 @@ var CONTACT_COMMAND_SPECS = [
     flags: FIELD_FLAGS,
     scopes: [...contactOperations.update.scopes],
     returns: "ContactView",
-    notes: "Only the flags you pass change. `none` clears a field (--email none, --birthday none). --birthday keeps the contact's other dates; --roles, --circles and --tags replace the list (a role it already has keeps its details)."
+    notes: "Only the flags you pass change. `none` clears a field (--email none, --birthday none). --birthday keeps the contact's other dates; --roles, --circles, --tags and --knows replace the list (a role it already has keeps its details); --knows-add and --knows-remove change one phrase of what they know about."
   }
 ];
-var MERGING_FLAGS = ["birthday", "no-year", "roles"];
+var MERGING_FLAGS = ["birthday", "no-year", "roles", "knows-add", "knows-remove"];
 var NULLABLE = ["email", "phone", "company", "website", "notes"];
 function list2(value) {
   return value.split(",").map((v) => v.trim()).filter((v) => v.length > 0);
@@ -46900,6 +46992,19 @@ function contactBodyFromFlags(flags, base, op, current) {
   const tags = flagString(flags, "tags");
   if (tags !== undefined)
     body.tags = isNone(tags) ? [] : list2(tags);
+  const knows = flagString(flags, "knows");
+  if (knows !== undefined)
+    body.knowsAbout = isNone(knows) ? [] : list2(knows);
+  const knowsAdd = flagString(flags, "knows-add");
+  const knowsRemove = flagString(flags, "knows-remove");
+  if (knowsAdd !== undefined || knowsRemove !== undefined) {
+    let phrases = body.knowsAbout ?? current?.knowsAbout ?? [];
+    if (knowsRemove !== undefined)
+      phrases = removeKnowsAbout(phrases, knowsRemove);
+    if (knowsAdd !== undefined)
+      phrases = addKnowsAbout(phrases, knowsAdd);
+    body.knowsAbout = phrases;
+  }
   const circles = flagString(flags, "circles");
   if (circles !== undefined)
     body.circleIds = isNone(circles) ? [] : list2(circles);
@@ -52347,6 +52452,11 @@ var GLOBAL_FLAGS = [
     type: "boolean",
     description: "Permit a destructive verb (delete/revoke/remove-member). Off by default \u2014 a guardrail for autonomous agents."
   },
+  {
+    name: "reason",
+    type: "string",
+    description: `One line on why, for delete/archive (sent as ?reason=). An agent's shows in the Trash: "Deleted by <agent>: <reason>".`
+  },
   {
     name: "dry-run",
     type: "boolean",
@@ -57504,7 +57614,7 @@ var commands52 = [
       ],
       scopes: [...shareLinkOperations.create.scopes],
       returns: "CreateShareLinkResult",
-      notes: "The signed token is returned once, in the create response."
+      notes: "The signed token isn't shown once: `do link list <node>` gives it again until the link expires or is revoked."
     },
     run: async ({ args, flags, requireClient }) => {
       const node = requireArg(args, 0, "node id");
@@ -57527,7 +57637,7 @@ var commands52 = [
       args: [{ name: "node", required: true, description: "Node ULID." }],
       flags: [],
       scopes: [...shareLinkOperations.listForNode.scopes],
-      returns: "ShareLinkPublic"
+      returns: "ShareLinkListed"
     },
     run: readOperation(shareLinkOperations.listForNode, renderList, { nodeId: "node id" })
   },
@@ -57552,8 +57662,64 @@ var commands52 = [
   }
 ];
 
-// src/commands/tap-tags.ts
+// src/commands/space.ts
 var commands53 = [
+  {
+    spec: {
+      path: ["space", "address"],
+      summary: "Show the Space's postal address (null when none is set).",
+      args: [],
+      flags: [],
+      scopes: [...spaceOperations.address.scopes],
+      returns: "SpaceAddress",
+      notes: `${routeOf(spaceOperations.address)}.`
+    },
+    run: readOperation(spaceOperations.address, renderRecord)
+  },
+  {
+    spec: {
+      path: ["space", "address", "set"],
+      summary: "Set the Space's postal address to one line.",
+      args: [
+        {
+          name: "address",
+          required: true,
+          description: 'One line, e.g. "Main Street 12, Springfield".'
+        }
+      ],
+      flags: [],
+      scopes: [...spaceOperations.setAddress.scopes],
+      returns: "SpaceAddress",
+      notes: `${routeOf(spaceOperations.setAddress)}. Trimmed, at most 200 characters.`
+    },
+    run: async ({ args, requireClient }) => {
+      requireArg(args, 0, "address");
+      const body = parseInput(setSpaceAddressInputSchema, { address: args.join(" ") });
+      return {
+        data: await requireClient().put(pathOf(spaceOperations.setAddress), body),
+        render: renderRecord
+      };
+    }
+  },
+  {
+    spec: {
+      path: ["space", "address", "clear"],
+      summary: "Clear the Space's postal address.",
+      args: [],
+      flags: [],
+      scopes: [...spaceOperations.setAddress.scopes],
+      returns: "SpaceAddress",
+      notes: `${routeOf(spaceOperations.setAddress)} with \`{ "address": null }\`.`
+    },
+    run: async ({ requireClient }) => ({
+      data: await requireClient().put(pathOf(spaceOperations.setAddress), { address: null }),
+      render: renderRecord
+    })
+  }
+];
+
+// src/commands/tap-tags.ts
+var commands54 = [
   {
     spec: {
       path: ["tap-tags", "tap"],
@@ -57581,7 +57747,7 @@ var BY = {
   type: "string",
   description: "The blocking task's ref (DO-147) or ULID."
 };
-var commands54 = [
+var commands55 = [
   defineCommand({
     operation: taskBlockOperations.addBlocker,
     path: ["tasks", "block"],
@@ -57647,7 +57813,7 @@ function renderSeries(data, mode) {
   }).join(`
 `);
 }
-var commands55 = [
+var commands56 = [
   defineCommand({
     operation: taskSeriesOperations.make,
     path: ["tasks", "make-series"],
@@ -57802,7 +57968,7 @@ function repeatFromFlags(flags) {
     out.anchor = "from_completion";
   return out;
 }
-var commands56 = [
+var commands57 = [
   {
     spec: {
       path: ["capture"],
@@ -58260,7 +58426,7 @@ var commands56 = [
 ];
 
 // src/commands/time-blocks.ts
-var commands57 = [
+var commands58 = [
   {
     spec: {
       path: ["time-blocks", "record"],
@@ -58441,7 +58607,7 @@ function renderLandedCounts(data, mode) {
   return out.join(`
 `);
 }
-var commands58 = [
+var commands59 = [
   {
     spec: {
       path: ["today"],
@@ -58813,7 +58979,7 @@ function renderViews(data, mode) {
 function renderView(data, mode) {
   return renderViews([data], mode);
 }
-var commands59 = [
+var commands60 = [
   defineCommand({
     operation: workViewOperations.list,
     path: ["views", "list"],
@@ -58932,7 +59098,7 @@ var commands59 = [
 ];
 
 // src/commands/worktree-links.ts
-var commands60 = [
+var commands61 = [
   {
     spec: {
       path: ["worktree-links", "list"],
@@ -59098,7 +59264,8 @@ var FEATURE_COMMANDS = [
   ...commands57,
   ...commands58,
   ...commands59,
-  ...commands60
+  ...commands60,
+  ...commands61
 ];
 
 // src/registry.ts
@@ -59291,7 +59458,8 @@ async function dispatchEntity(entity, rest, flags, requireClient) {
     }
     if (op === "delete")
       assertDestructiveAllowed(flags, `delete ${entity.name} ${id}`);
-    await client.delete(`${entity.path}/${id}`);
+    const reason = flagString(flags, "reason");
+    await client.delete(`${entity.path}/${id}`, reason ? { query: { reason } } : {});
     return {
       data: op === "archive" ? { ok: true, archived: id, softDelete: true } : { ok: true, deleted: id, softDelete: true },
       render: renderRecord

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robbeverhelst/do",
-  "version": "1.351.0",
+  "version": "1.352.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",
@@ -27,7 +27,7 @@
     "compile": "bun build --compile src/index.ts --outfile do",
     "prepublishOnly": "bun run bundle",
     "typecheck": "tsc --noEmit",
-    "build": "tsc --noEmit",
+    "build": "bun run bundle",
     "test": "bun test",
     "test:coverage": "bun test --coverage"
   },
@@ -39,5 +39,11 @@
     "@types/node": "^25.9.3",
     "ulidx": "^2.4.1",
     "zod": "^4.4.3"
+  },
+  "do": {
+    "tier": "backend",
+    "coverage": {
+      "floor": 90
+    }
   }
 }