@wspc/cli 0.0.11 → 0.0.13

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { Command as Command59 } from "commander";
+import { Command as Command62 } from "commander";
 
 // src/generated/cli/invite/accept.ts
 import { Command } from "commander";
@@ -1078,6 +1078,15 @@ var recurrenceRuleList = (options) => (options.client ?? client).get({
   url: "/todo/recurrence-rules",
   ...options
 });
+var recurrenceRuleCreate = (options) => (options?.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/todo/recurrence-rules",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options?.headers
+  }
+});
 var todoList = (options) => (options.client ?? client).get({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/todo/items",
@@ -1111,6 +1120,20 @@ var todoCommentUpdate = (options) => (options.client ?? client).patch({
     ...options.headers
   }
 });
+var recurrenceRuleDelete = (options) => (options.client ?? client).delete({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/todo/recurrence-rules/{id}",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+var recurrenceRuleGet = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/todo/recurrence-rules/{id}",
+  ...options
+});
 var todoDelete = (options) => (options.client ?? client).delete({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/todo/items/{id}",
@@ -1230,9 +1253,9 @@ var ConfigStore = class {
 };
 
 // src/version.ts
-var VERSION = "0.0.11";
-var SPEC_SHA = "5ae5d422";
-var SPEC_FETCHED_AT = "2026-06-09T04:35:08.355Z";
+var VERSION = "0.0.13";
+var SPEC_SHA = "7842b7a9";
+var SPEC_FETCHED_AT = "2026-06-09T08:10:52.164Z";
 var API_BASE = "https://api.wspc.ai";
 
 // src/index.ts
@@ -1599,9 +1622,24 @@ function render(ctx, data) {
   const specific = SPECIFIC_RENDERERS[ctx.kind];
   if (specific) {
     specific(target, ctx.display);
-    return;
+  } else {
+    renderGeneric(target, ctx.display);
+  }
+  renderPaginationFooter(data);
+}
+function renderPaginationFooter(data) {
+  if (data === null || typeof data !== "object") return;
+  const d = data;
+  if (typeof d.next_cursor === "string" && d.next_cursor.length > 0) {
+    process.stdout.write(dim(`  \u2026 more results \u2014 re-run with --cursor ${d.next_cursor}`) + "\n");
+  }
+  const id = typeof d.id === "string" ? d.id : "<id>";
+  if (typeof d.children_next_cursor === "string" && d.children_next_cursor.length > 0) {
+    process.stdout.write(dim(`  \u2026 more children \u2014 wspc todo ls --parent ${id}`) + "\n");
+  }
+  if (typeof d.comments_next_cursor === "string" && d.comments_next_cursor.length > 0) {
+    process.stdout.write(dim(`  \u2026 more comments \u2014 wspc todo comment ls ${id}`) + "\n");
   }
-  renderGeneric(target, ctx.display);
 }
 function drillDataPath(data, dataPath) {
   if (!dataPath) return data;
@@ -1874,7 +1912,7 @@ var inviteAcceptCommand = new Command("accept").description("Accept an invite an
 
 // src/generated/cli/keys/create.ts
 import { Command as Command2 } from "commander";
-var keyCreateCommand = new Command2("create").description("Create a new API key (full value returned once)").option("--label <value>", "label").action(async (opts) => {
+var keyCreateCommand = new Command2("create").description("Create a new API key (full value returned once)").option("--label <value>", "Human-readable label for the new key (1\u201360 chars after trimming). Pick something that identifies where the key will live \u2014 agent name, machine, or environment \u2014 so you can recognise it later in `wspc keys list`.").action(async (opts) => {
   const client2 = await loadSdkClient();
   const result = await keyCreate({
     client: client2._rawClient,
@@ -1913,7 +1951,7 @@ var keyListCommand = new Command3("ls").description("List active API keys").acti
 
 // src/generated/cli/org/invite.ts
 import { Command as Command4 } from "commander";
-var orgInviteCreateCommand = new Command4("invite").description("Invite an email to join the caller's organization").option("--email <value>", "email").action(async (opts) => {
+var orgInviteCreateCommand = new Command4("invite").description("Invite an email to join the caller's organization").option("--email <value>", "Email address to invite into the caller's organization.").action(async (opts) => {
   const client2 = await loadSdkClient();
   const result = await orgInviteCreate({
     client: client2._rawClient,
@@ -1970,7 +2008,7 @@ var orgGetCommand = new Command6("show").description("Get the authenticated user
 
 // src/generated/cli/org/rename.ts
 import { Command as Command7 } from "commander";
-var orgUpdateCommand = new Command7("rename").description("Update the authenticated user's organization").option("--name <value>", "name").action(async (opts) => {
+var orgUpdateCommand = new Command7("rename").description("Update the authenticated user's organization").option("--name <value>", "The new name for the organization. Cannot be empty or purely whitespace.").action(async (opts) => {
   const client2 = await loadSdkClient();
   const result = await orgUpdate({
     client: client2._rawClient,
@@ -2048,7 +2086,7 @@ var invitesListCommand = new Command10("invites").description("List invites addr
 
 // src/generated/cli/org/members.ts
 import { Command as Command11 } from "commander";
-var orgMembersListCommand = new Command11("members").description("List members of the authenticated user's organization").option("--cursor <value>", "cursor").option("--limit <value>", "limit").action(async (opts) => {
+var orgMembersListCommand = new Command11("members").description("List members of the authenticated user's organization").option("--cursor <value>", "Opaque pagination cursor. Pass the `next_cursor` returned by the previous page to fetch the next slice. Omit on the first call.").option("--limit <value>", "Maximum members to return. Clamped to [1, 100]. Defaults to 50.").action(async (opts) => {
   const client2 = await loadSdkClient();
   const result = await orgMembersList({
     client: client2._rawClient,
@@ -2112,7 +2150,7 @@ var keyRevokeCommand = new Command13("rm").description("Soft-revoke an API key")
 
 // src/generated/cli/keys/edit.ts
 import { Command as Command14 } from "commander";
-var keyUpdateCommand = new Command14("edit").description("Update an active API key's label").argument("<id>", "id").option("--label <value>", "label").action(async (id, opts) => {
+var keyUpdateCommand = new Command14("edit").description("Update an active API key's label").argument("<id>", "id").option("--label <value>", "Human-readable label for the key (1\u201360 chars after trimming).").action(async (id, opts) => {
   const client2 = await loadSdkClient();
   const result = await keyUpdate({
     client: client2._rawClient,
@@ -2242,7 +2280,7 @@ function parseAttendee(input) {
 }
 
 // src/generated/cli/event/add.ts
-var eventCreateCommand = new Command16("add").description("Schedule a calendar event").argument("<title>", "title").option("--description <value>", "description").option("--start <value>", "start").option("--end <value>", "end").option("-l, --location <value>", "location").option("-u, --url <value>", "url").option("--status <value>", "status").option("--attendee <value>", "attendee", (val, memo) => {
+var eventCreateCommand = new Command16("add").description("Schedule a calendar event").argument("<title>", "title").option("--description <value>", "Free-form notes about the event (agenda, dial-in instructions, etc.). Markdown formatted (CommonMark + GFM tables, strikethrough, task lists); stored verbatim. Invitation emails include the raw source \u2014 most email clients display it as plain text.").option("--start <value>", "Accepts ISO 8601 datetime with offset (e.g. `2026-06-01T12:30:00+08:00`) for timed events, or ISO date-only (e.g. `2026-06-01`) for all-day. The `wspc` CLI additionally accepts natural-language phrases (`tomorrow 12:30pm`, `next Monday 9am`) and resolves them to ISO before sending; the server itself only accepts ISO. All-day uses RFC 5545 exclusive end: a one-day event on 6/1 is `start=2026-06-01, end=2026-06-02`; both endpoints must be the same type.").option("--end <value>", "Accepts ISO 8601 datetime with offset (e.g. `2026-06-01T12:30:00+08:00`) for timed events, or ISO date-only (e.g. `2026-06-01`) for all-day. The `wspc` CLI additionally accepts natural-language phrases (`tomorrow 12:30pm`, `next Monday 9am`) and resolves them to ISO before sending; the server itself only accepts ISO. All-day uses RFC 5545 exclusive end: a one-day event on 6/1 is `start=2026-06-01, end=2026-06-02`; both endpoints must be the same type.").option("-l, --location <value>", "Free-text location \u2014 physical address, room, or short note. Separate from `url` (meeting link).").option("-u, --url <value>", "Optional meeting link (Zoom / Meet / etc.). Kept separate from `location` so calendar clients can render it as a join action.").option("--status <value>", "Lifecycle status. `confirmed`: the event will happen (default). `tentative`: organizer has not finalized; still visible in lists. `cancelled`: the event was called off but the record is kept so attendees can be notified and history audited; distinct from soft-delete (DELETE `/calendar/events/{id}`) which hides the event from default list responses.").option("--attendee <value>", "Up to 50 unique attendees (deduped case-insensitively by email). If non-empty, each attendee receives an invitation email with an `.ics` REQUEST attachment as a side effect of creation.", (val, memo) => {
   memo.push(val);
   return memo;
 }, []).option("--all-day", "all_day").option("--tz <zone>", "IANA timezone for relative time parsing").action(async (title, opts) => {
@@ -2292,7 +2330,7 @@ var eventCreateCommand = new Command16("add").description("Schedule a calendar e
 
 // src/generated/cli/event/ls.ts
 import { Command as Command17 } from "commander";
-var eventListCommand = new Command17("ls").description("List calendar events").option("--q <value>", "q").option("--from <value>", "from").option("--to <value>", "to").option("--end-from <value>", "end_from").option("--end-to <value>", "end_to").option("--cursor <value>", "cursor").option("--limit <value>", "limit").option("--include-deleted <value>", "include_deleted").option("--include-past <value>", "include_past").option("--tz <zone>", "IANA timezone for relative time parsing").action(async (opts) => {
+var eventListCommand = new Command17("ls").description("List calendar events").option("--q <value>", "Optional full-text search across title, description, and location (case-insensitive substring).").option("--from <value>", "Inclusive lower bound on the event `start` (ISO datetime with offset, or ISO date-only). When ANY of `start_from`/`start_to`/`end_from`/`end_to` is provided, the implicit past filter is disabled.").option("--to <value>", "Inclusive upper bound on the event `start`.").option("--end-from <value>", "Inclusive lower bound on the event `end`.").option("--end-to <value>", "Inclusive upper bound on the event `end`.").option("--cursor <value>", "Opaque pagination cursor returned in `next_cursor` of a previous response.").option("--limit <value>", "Maximum number of events to return. Clamped to `[1, 200]`. Default is server-defined.").option("--include-deleted <value>", "When `true`, include soft-deleted events. Default `false`.").option("--include-past <value>", "When omitted or `false`, events whose `end` is before now are hidden. Pass `true` to include them. Ignored when any of `start_from`/`start_to`/`end_from`/`end_to` is provided \u2014 explicit time bounds always win.").option("--tz <zone>", "IANA timezone for relative time parsing").action(async (opts) => {
   const zone = resolveTimezone(opts.tz);
   let fromValue;
   if (opts.from !== void 0) {
@@ -2330,7 +2368,7 @@ var eventListCommand = new Command17("ls").description("List calendar events").o
 
 // src/generated/cli/event/rm.ts
 import { Command as Command18 } from "commander";
-var eventDeleteCommand = new Command18("rm").description("Soft-delete a calendar event").argument("<id>", "id").option("--expected-version <value>", "expected_version").action(async (id, opts) => {
+var eventDeleteCommand = new Command18("rm").description("Soft-delete a calendar event").argument("<id>", "id").option("--expected-version <value>", "Optional optimistic lock. Omit to let the server use the current version; pass only to fail with 409 `VERSION_CONFLICT` if someone else has mutated the event since you last read.").action(async (id, opts) => {
   const client2 = await loadSdkClient();
   const result = await eventDelete({
     client: client2._rawClient,
@@ -2354,7 +2392,7 @@ var eventDeleteCommand = new Command18("rm").description("Soft-delete a calendar
 
 // src/generated/cli/event/show.ts
 import { Command as Command19 } from "commander";
-var eventGetCommand = new Command19("show").description("Get a calendar event by id").argument("<id>", "id").option("--include-deleted <value>", "include_deleted").action(async (id, opts) => {
+var eventGetCommand = new Command19("show").description("Get a calendar event by id").argument("<id>", "id").option("--include-deleted <value>", "When `true`, return the row even if soft-deleted. Default `false` (returns 404).").action(async (id, opts) => {
   const client2 = await loadSdkClient();
   const result = await eventGet({
     client: client2._rawClient,
@@ -2378,7 +2416,7 @@ var eventGetCommand = new Command19("show").description("Get a calendar event by
 
 // src/generated/cli/event/set.ts
 import { Command as Command20 } from "commander";
-var eventUpdateCommand = new Command20("set").description("Update a calendar event").argument("<id>", "id").option("--expected-version <value>", "expected_version").option("--title <value>", "title").option("--description <value>", "description").option("--start <value>", "start").option("--end <value>", "end").option("-l, --location <value>", "location").option("-u, --url <value>", "url").option("--status <value>", "status").option("--attendee <value>", "attendee", (val, memo) => {
+var eventUpdateCommand = new Command20("set").description("Update a calendar event").argument("<id>", "id").option("--expected-version <value>", "Optional optimistic lock. Omit to let the server use the current version; pass only to fail the call if someone else has mutated the event since you last read. On mismatch the server returns 409 `VERSION_CONFLICT` with `extra.expected_version` and `extra.actual_version`.").option("--title <value>", "New event title. Omit to leave unchanged.").option("--description <value>", "New description. Markdown formatted (CommonMark + GFM tables, strikethrough, task lists). Pass an empty string to clear; omit to leave unchanged.").option("--start <value>", "Accepts ISO 8601 datetime with offset (e.g. `2026-06-01T12:30:00+08:00`) for timed events, or ISO date-only (e.g. `2026-06-01`) for all-day. The `wspc` CLI additionally accepts natural-language phrases (`tomorrow 12:30pm`, `next Monday 9am`) and resolves them to ISO before sending; the server itself only accepts ISO. All-day uses RFC 5545 exclusive end: a one-day event on 6/1 is `start=2026-06-01, end=2026-06-02`; both endpoints must be the same type.").option("--end <value>", "Accepts ISO 8601 datetime with offset (e.g. `2026-06-01T12:30:00+08:00`) for timed events, or ISO date-only (e.g. `2026-06-01`) for all-day. The `wspc` CLI additionally accepts natural-language phrases (`tomorrow 12:30pm`, `next Monday 9am`) and resolves them to ISO before sending; the server itself only accepts ISO. All-day uses RFC 5545 exclusive end: a one-day event on 6/1 is `start=2026-06-01, end=2026-06-02`; both endpoints must be the same type.").option("-l, --location <value>", "New location. Pass an empty string to clear; omit to leave unchanged.").option("-u, --url <value>", "New meeting link. Pass an empty string to clear; omit to leave unchanged.").option("--status <value>", "Lifecycle status. `confirmed`: the event will happen (default). `tentative`: organizer has not finalized; still visible in lists. `cancelled`: the event was called off but the record is kept so attendees can be notified and history audited; distinct from soft-delete (DELETE `/calendar/events/{id}`) which hides the event from default list responses.").option("--attendee <value>", "If provided, REPLACES the attendee list (after case-insensitive email dedupe, up to 50). Added attendees receive a fresh invitation, kept attendees receive an update email, removed attendees receive a cancellation.", (val, memo) => {
   memo.push(val);
   return memo;
 }, []).option("--all-day", "all_day").option("--tz <zone>", "IANA timezone for relative time parsing").action(async (id, opts) => {
@@ -2474,7 +2512,7 @@ var emailAliasCreateCommand = new Command22("add").description("Create a receivi
 
 // src/generated/cli/alias/ls.ts
 import { Command as Command23 } from "commander";
-var emailAliasListCommand = new Command23("ls").description("List the caller's aliases").option("--include-deleted <value>", "include_deleted").action(async (opts) => {
+var emailAliasListCommand = new Command23("ls").description("List the caller's aliases").option("--include-deleted <value>", "When `true`, include soft-deleted aliases (with `deleted_at` set) alongside active ones. Defaults to `false`.").action(async (opts) => {
   const client2 = await loadSdkClient();
   const result = await emailAliasList({
     client: client2._rawClient,
@@ -2599,7 +2637,7 @@ var emailDomainGetCommand = new Command28("show").description("Get one cached cu
 
 // src/generated/cli/email/show.ts
 import { Command as Command29 } from "commander";
-var emailGetCommand = new Command29("show").description("Get an inbound email by id").argument("<id>", "id").option("--include-html <value>", "include_html").option("--include-deleted <value>", "include_deleted").action(async (id, opts) => {
+var emailGetCommand = new Command29("show").description("Get an inbound email by id").argument("<id>", "id").option("--include-html <value>", "When `true`, fetch the HTML body from R2 and include it as `html_body` in the response. Costs an extra R2 read; omit if you only need text.").option("--include-deleted <value>", "When `true`, allow fetching a soft-deleted email. Defaults to `false` (returns 404 for soft-deleted rows).").action(async (id, opts) => {
   const client2 = await loadSdkClient();
   const result = await emailGet({
     client: client2._rawClient,
@@ -2624,7 +2662,7 @@ var emailGetCommand = new Command29("show").description("Get an inbound email by
 
 // src/generated/cli/email/ls.ts
 import { Command as Command30 } from "commander";
-var emailListCommand = new Command30("ls").description("List inbound emails").option("--limit <value>", "limit").option("--alias-email <value>", "alias_email").option("--unread-only <value>", "unread_only").option("--since <value>", "since").option("--cursor <value>", "cursor").option("--include-deleted <value>", "include_deleted").action(async (opts) => {
+var emailListCommand = new Command30("ls").description("List inbound emails").option("--limit <value>", "Max items to return (clamped to 1-100). Defaults to 20 server-side.").option("--alias-email <value>", "If set, only return emails received on this full alias email address.").option("--unread-only <value>", "When `true`, only return emails with `is_read=false`.").option("--since <value>", "Unix epoch milliseconds \u2014 only return emails with `received_at >= since`. Useful for incremental sync.").option("--cursor <value>", "Opaque pagination cursor returned in `next_cursor` of a previous response.").option("--include-deleted <value>", "When `true`, also return soft-deleted emails. Defaults to `false`.").action(async (opts) => {
   const client2 = await loadSdkClient();
   const result = await emailList({
     client: client2._rawClient,
@@ -2738,7 +2776,7 @@ var pushConfigDeleteCommand = new Command34("rm").description("Remove a push tra
 
 // src/generated/cli/push/config/set.ts
 import { Command as Command35 } from "commander";
-var pushConfigSetCommand = new Command35("set").description("Register or update a push transport").option("--transport <value>", "transport").option("--target-bot-username <value>", "target_bot_username").action(async (opts) => {
+var pushConfigSetCommand = new Command35("set").description("Register or update a push transport").option("--transport <value>", "Transport discriminator. `telegram` is the only supported value today \u2014 push delivers via a Telegram bot DM. Future transports (web push, iOS/Android, generic webhook) will be added as additional discriminator values.").option("--target-bot-username <value>", "Telegram bot username (with leading `@`, 5\u201332 alphanumeric/underscore characters). This is the bot the user has already started a chat with \u2014 wspc DMs notifications to it via the Telegram Bot API.").action(async (opts) => {
   const client2 = await loadSdkClient();
   const result = await pushConfigSet({
     client: client2._rawClient,
@@ -2780,7 +2818,7 @@ var pushConfigGetCommand = new Command36("show").description("List the caller's
 
 // src/generated/cli/push/test.ts
 import { Command as Command37 } from "commander";
-var pushTestCommand = new Command37("test").description("Send a test push notification").option("--transport <value>", "transport").action(async (opts) => {
+var pushTestCommand = new Command37("test").description("Send a test push notification").option("--transport <value>", "Which transport to send the test message through. Must match a transport the caller has already registered via `POST /push/config`; today only `telegram` is supported.").action(async (opts) => {
   const client2 = await loadSdkClient();
   const result = await pushTest({
     client: client2._rawClient,
@@ -2828,7 +2866,7 @@ var todoCommentCreateCommand = new Command38("add").description("Add a comment t
 
 // src/generated/cli/todo/comment/ls.ts
 import { Command as Command39 } from "commander";
-var todoCommentListCommand = new Command39("ls").description("List comments on a todo").argument("<id>", "id").option("--order <value>", "order").option("--include-deleted <value>", "include_deleted").option("--limit <value>", "limit").option("--cursor <value>", "cursor").action(async (id, opts) => {
+var todoCommentListCommand = new Command39("ls").description("List comments on a todo").argument("<id>", "id").option("--order <value>", "order").option("--include-deleted <value>", "include_deleted").option("--limit <value>", "Max comments to return. Clamped to [1, 200]. Default 50 server-side.").option("--cursor <value>", "Opaque pagination cursor returned in `next_cursor` of a previous response.").action(async (id, opts) => {
   const client2 = await loadSdkClient();
   const result = await todoCommentList({
     client: client2._rawClient,
@@ -2877,7 +2915,7 @@ var projectCreateCommand = new Command40("add").description("Create a project").
 
 // src/generated/cli/todo/project/ls.ts
 import { Command as Command41 } from "commander";
-var projectListCommand = new Command41("ls").description("List projects").option("--include-deleted <value>", "include_deleted").action(async (opts) => {
+var projectListCommand = new Command41("ls").description("List projects").option("--include-deleted <value>", "Set to `true` to include soft-deleted projects in the response.").action(async (opts) => {
   const client2 = await loadSdkClient();
   const result = await projectList({
     client: client2._rawClient,
@@ -2896,9 +2934,36 @@ var projectListCommand = new Command41("ls").description("List projects").option
   render({ kind: "project_list", display: { "shape": "list", "columns": ["id", "name", "default_todo_type_id"], "format": { "id": "id-short", "name": "truncate", "default_todo_type_id": "id-short" }, "emptyMessage": "no projects" } }, result.data);
 });
 
-// src/generated/cli/todo/rule/ls.ts
+// src/generated/cli/todo/rule/add.ts
 import { Command as Command42 } from "commander";
-var recurrenceRuleListCommand = new Command42("ls").description("List recurring todo rules").option("--project-id <value>", "project_id").option("--user-id <value>", "user_id").action(async (opts) => {
+var recurrenceRuleCreateCommand = new Command42("add").description("Create a recurring todo rule").argument("<title>", "title").option("--rrule <value>", "rrule").option("--dtstart <value>", "dtstart").option("--description <value>", "description").option("--parent-id <value>", "parent_id").option("-p, --project <value>", "Project for the recurrence rule, its template todo, and all materialized instances. Must be an active project in the caller's organization.").option("-t, --type <value>", "type_id").action(async (title, opts) => {
+  const client2 = await loadSdkClient();
+  const result = await recurrenceRuleCreate({
+    client: client2._rawClient,
+    body: {
+      title,
+      rrule: opts.rrule,
+      dtstart: opts.dtstart,
+      description: opts.description,
+      parent_id: opts.parentId,
+      project_id: opts.project,
+      type_id: opts.type
+    }
+  });
+  if (result.error || !result.response?.ok) {
+    process.stderr.write(
+      `HTTP ${result.response?.status ?? "?"}: ${JSON.stringify(result.error ?? "unknown error", null, 2)}
+`
+    );
+    process.exitCode = 1;
+    return;
+  }
+  render({ kind: "recurrence_rule_create", display: void 0 }, result.data);
+});
+
+// src/generated/cli/todo/rule/ls.ts
+import { Command as Command43 } from "commander";
+var recurrenceRuleListCommand = new Command43("ls").description("List recurring todo rules").option("--project-id <value>", "Project id filter. Required. Unknown, cross-organization, or soft-deleted project ids return NOT_FOUND.").option("--user-id <value>", "user_id").action(async (opts) => {
   const client2 = await loadSdkClient();
   const result = await recurrenceRuleList({
     client: client2._rawClient,
@@ -2915,12 +2980,26 @@ var recurrenceRuleListCommand = new Command42("ls").description("List recurring
     process.exitCode = 1;
     return;
   }
-  render({ kind: "recurrence_rule_list", display: { "shape": "list", "columns": ["id", "rrule", "dtstart"], "format": { "id": "id-short", "rrule": "truncate" }, "emptyMessage": "no recurrence rules" } }, result.data);
+  render({ kind: "recurrence_rule_list", display: { "shape": "list", "columns": ["id", "rrule", "dtstart", "type_id"], "format": { "id": "id-short", "rrule": "truncate", "type_id": "id-short" }, "emptyMessage": "no recurrence rules" } }, result.data);
 });
 
 // src/generated/cli/todo/add.ts
-import { Command as Command43 } from "commander";
-var todoCreateCommand = new Command43("add").description("Create a todo").argument("<title>", "title").option("-p, --project <value>", "project_id").option("--description <value>", "description").option("--parent-id <value>", "parent_id").option("--status <value>", "status").option("--due-at <value>", "due_at").option("--type-id <value>", "type_id").option("--custom-fields <value>", "custom_fields").action(async (title, opts) => {
+import { Command as Command44 } from "commander";
+
+// src/handwritten/utils/parse-json-field.ts
+function parseJsonField(raw, flag) {
+  if (raw === void 0) return void 0;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    process.stderr.write(`Invalid JSON for --${flag}: ${raw}
+`);
+    process.exit(1);
+  }
+}
+
+// src/generated/cli/todo/add.ts
+var todoCreateCommand = new Command44("add").description("Create a todo").argument("<title>", "title").option("-p, --project <value>", "Project id to assign this todo to. It must be an active project in the caller's organization.").option("--description <value>", "Free-form details about the todo. Fully supports GFM Markdown (tables, strikethrough, task lists). Stored verbatim; client applications are responsible for rendering. Optional. Passing `null` is strictly rejected.").option("--parent-id <value>", "Parent todo ID (`tod_<ULID>`) to attach this todo as a child under another todo. Omit or pass `null` to create a root-level todo. Nesting is limited to one level; attempting to set a child todo as a parent will trigger `PARENT_IS_CHILD`. To make a subtask appear on every occurrence of a recurring rule, set this to that rule's template todo id (the template id returned when the rule is created); the server re-materializes future occurrences so each carries the subtask.").option("--status <value>", "Initial status of the todo. Omit to default to `open`. Allowed values: `open`, `in_progress`, `done`, `cancelled`.").option("--due-at <value>", 'Optional calendar due date in ISO date-only format (`YYYY-MM-DD`). Stored without timezone offsets to represent the same local calendar day globally. Pass `""` or omit the field to skip setting a due date. Passing `null` is strictly rejected.').option("--type-id <value>", "Type id this todo belongs to. Omit to use the project's default type. When project_id is also supplied, the type must belong to the same project. New server-generated type ids use typ_<ULID>; legacy ids remain accepted.").option("--custom-fields <value>", "Custom field values keyed by the field's immutable `key` (not the human `label`). Each value must match the declared field type: string fields require string values, and string_array fields require string arrays. Providing a key that is not declared on the resolved todo type is strictly rejected with `UNDECLARED_FIELD`. Missing required fields that lack a default value are rejected with `FIELD_REQUIRED`. Defaults declared on the type are auto-applied at create time.").action(async (title, opts) => {
   const client2 = await loadSdkClient();
   const result = await todoCreate({
     client: client2._rawClient,
@@ -2932,7 +3011,7 @@ var todoCreateCommand = new Command43("add").description("Create a todo").argume
       status: opts.status,
       due_at: opts.dueAt,
       type_id: opts.typeId,
-      custom_fields: opts.customFields
+      custom_fields: parseJsonField(opts.customFields, "custom-fields")
     }
   });
   if (result.error || !result.response?.ok) {
@@ -2947,8 +3026,8 @@ var todoCreateCommand = new Command43("add").description("Create a todo").argume
 });
 
 // src/generated/cli/todo/ls.ts
-import { Command as Command44 } from "commander";
-var todoListCommand = new Command44("ls").description("List todos with filters").option("-p, --project <value>", "project_id").option("--user-id <value>", "user_id").option("--parent-id <value>", "parent_id").option("-s, --status <value>", "status").option("--include-deleted <value>", "include_deleted").option("--include-templates <value>", "include_templates").option("--due-after <value>", "due_after").option("--due-before <value>", "due_before").option("--type-id <value>", "type_id").option("--sort-by <value>", "sort_by").option("--order <value>", "order").option("--include-orphan-fields <value>", "include_orphan_fields").option("--limit <value>", "limit").option("--cursor <value>", "cursor").action(async (opts) => {
+import { Command as Command45 } from "commander";
+var todoListCommand = new Command45("ls").description("List todos with filters").option("-p, --project <value>", "Filter by project. Required. Unknown, cross-organization, or soft-deleted project ids return NOT_FOUND.").option("--user-id <value>", "user_id").option("--parent-id <value>", "parent_id").option("-s, --status <value>", "status").option("--include-deleted <value>", "include_deleted").option("--include-templates <value>", "include_templates").option("--due-after <value>", "due_after").option("--due-before <value>", "due_before").option("--type-id <value>", "type_id").option("--sort-by <value>", "sort_by").option("--order <value>", "order").option("--include-orphan-fields <value>", "include_orphan_fields").option("--limit <value>", "Max todos to return. Clamped to [1, 200]. Default 50 server-side.").option("--cursor <value>", "Opaque pagination cursor returned in `next_cursor` of a previous response.").action(async (opts) => {
   const client2 = await loadSdkClient();
   const result = await todoList({
     client: client2._rawClient,
@@ -2981,8 +3060,8 @@ var todoListCommand = new Command44("ls").description("List todos with filters")
 });
 
 // src/generated/cli/todo/type/ls.ts
-import { Command as Command45 } from "commander";
-var todoTypeListCommand = new Command45("ls").description("List todo types").option("--project-id <value>", "project_id").option("--user-id <value>", "user_id").option("--include-deleted <value>", "include_deleted").action(async (opts) => {
+import { Command as Command46 } from "commander";
+var todoTypeListCommand = new Command46("ls").description("List todo types").option("--project-id <value>", "Project id filter. Required. Unknown, cross-organization, or soft-deleted project ids return NOT_FOUND.").option("--user-id <value>", "user_id").option("--include-deleted <value>", "include_deleted").action(async (opts) => {
   const client2 = await loadSdkClient();
   const result = await todoTypeList({
     client: client2._rawClient,
@@ -3004,8 +3083,8 @@ var todoTypeListCommand = new Command45("ls").description("List todo types").opt
 });
 
 // src/generated/cli/todo/comment/rm.ts
-import { Command as Command46 } from "commander";
-var todoCommentDeleteCommand = new Command46("rm").description("Soft-delete a comment").argument("<id>", "id").action(async (id, opts) => {
+import { Command as Command47 } from "commander";
+var todoCommentDeleteCommand = new Command47("rm").description("Soft-delete a comment").argument("<id>", "id").action(async (id, opts) => {
   const client2 = await loadSdkClient();
   const result = await todoCommentDelete({
     client: client2._rawClient,
@@ -3025,8 +3104,8 @@ var todoCommentDeleteCommand = new Command46("rm").description("Soft-delete a co
 });
 
 // src/generated/cli/todo/comment/edit.ts
-import { Command as Command47 } from "commander";
-var todoCommentUpdateCommand = new Command47("edit").description("Edit a comment").argument("<id>", "id").argument("<content>", "content").action(async (id, content, opts) => {
+import { Command as Command48 } from "commander";
+var todoCommentUpdateCommand = new Command48("edit").description("Edit a comment").argument("<id>", "id").argument("<content>", "content").action(async (id, content, opts) => {
   const client2 = await loadSdkClient();
   const result = await todoCommentUpdate({
     client: client2._rawClient,
@@ -3048,9 +3127,54 @@ var todoCommentUpdateCommand = new Command47("edit").description("Edit a comment
   render({ kind: "todo_comment_update", display: { "shape": "object", "format": { "id": "id-short", "todo_id": "id-short", "user_id": "id-short", "created_at": "relative-time", "updated_at": "relative-time", "deleted_at": "relative-time" } } }, result.data);
 });
 
+// src/generated/cli/todo/rule/rm.ts
+import { Command as Command49 } from "commander";
+var recurrenceRuleDeleteCommand = new Command49("rm").description("Delete a recurring todo rule").argument("<id>", "id").option("--expected-version <value>", "expected_version").action(async (id, opts) => {
+  const client2 = await loadSdkClient();
+  const result = await recurrenceRuleDelete({
+    client: client2._rawClient,
+    path: {
+      id
+    },
+    body: {
+      expected_version: opts.expectedVersion
+    }
+  });
+  if (result.error || !result.response?.ok) {
+    process.stderr.write(
+      `HTTP ${result.response?.status ?? "?"}: ${JSON.stringify(result.error ?? "unknown error", null, 2)}
+`
+    );
+    process.exitCode = 1;
+    return;
+  }
+  render({ kind: "recurrence_rule_delete", display: void 0 }, result.data);
+});
+
+// src/generated/cli/todo/rule/show.ts
+import { Command as Command50 } from "commander";
+var recurrenceRuleGetCommand = new Command50("show").description("Get a recurring todo rule").argument("<id>", "id").action(async (id, opts) => {
+  const client2 = await loadSdkClient();
+  const result = await recurrenceRuleGet({
+    client: client2._rawClient,
+    path: {
+      id
+    }
+  });
+  if (result.error || !result.response?.ok) {
+    process.stderr.write(
+      `HTTP ${result.response?.status ?? "?"}: ${JSON.stringify(result.error ?? "unknown error", null, 2)}
+`
+    );
+    process.exitCode = 1;
+    return;
+  }
+  render({ kind: "recurrence_rule_get", display: { "shape": "object", "format": { "id": "id-short", "type_id": "id-short" } } }, result.data);
+});
+
 // src/generated/cli/todo/rm.ts
-import { Command as Command48 } from "commander";
-var todoDeleteCommand = new Command48("rm").description("Soft-delete a todo").argument("<id>", "id").option("--expected-version <value>", "expected_version").option("--cascade <value>", "cascade").action(async (id, opts) => {
+import { Command as Command51 } from "commander";
+var todoDeleteCommand = new Command51("rm").description("Soft-delete a todo").argument("<id>", "id").option("--expected-version <value>", "expected_version").option("--cascade <value>", "cascade").action(async (id, opts) => {
   const client2 = await loadSdkClient();
   const result = await todoDelete({
     client: client2._rawClient,
@@ -3074,8 +3198,8 @@ var todoDeleteCommand = new Command48("rm").description("Soft-delete a todo").ar
 });
 
 // src/generated/cli/todo/show.ts
-import { Command as Command49 } from "commander";
-var todoGetCommand = new Command49("show").description("Get a todo by id").argument("<id>", "id").option("--include-deleted <value>", "include_deleted").option("--include-orphan-fields <value>", "include_orphan_fields").action(async (id, opts) => {
+import { Command as Command52 } from "commander";
+var todoGetCommand = new Command52("show").description("Get a todo by id").argument("<id>", "id").option("--include-deleted <value>", "include_deleted").option("--include-orphan-fields <value>", "include_orphan_fields").action(async (id, opts) => {
   const client2 = await loadSdkClient();
   const result = await todoGet({
     client: client2._rawClient,
@@ -3100,8 +3224,8 @@ var todoGetCommand = new Command49("show").description("Get a todo by id").argum
 });
 
 // src/generated/cli/todo/update.ts
-import { Command as Command50 } from "commander";
-var todoUpdateCommand = new Command50("update").description("Update a todo").argument("<id>", "id").option("--expected-version <value>", "expected_version").option("--title <value>", "title").option("--description <value>", "description").option("--parent-id <value>", "parent_id").option("--status <value>", "status").option("--due-at <value>", "due_at").option("--type-id <value>", "type_id").option("--custom-fields <value>", "custom_fields").option("--user-id <value>", "user_id").action(async (id, opts) => {
+import { Command as Command53 } from "commander";
+var todoUpdateCommand = new Command53("update").description("Update a todo").argument("<id>", "id").option("--expected-version <value>", "expected_version").option("--title <value>", "New title. Omit to leave the existing title unchanged. Must be non-empty when supplied.").option("--description <value>", 'New description. Markdown formatted (CommonMark + GFM tables, strikethrough, task lists). Pass empty string `""` explicitly to clear an existing description, or omit to leave unchanged. Passing `null` is strictly rejected.').option("--parent-id <value>", "Re-parent the todo. Pass a valid parent ID to attach under another todo, pass `null` to move it back to the root level, or omit to leave unchanged. Nesting is limited to one level; attempting to set a child todo as a parent will trigger `PARENT_IS_CHILD`.").option("--status <value>", "New status of the todo. Allowed transitions: `open` \u2794 `in_progress` \u2794 `done`. `cancelled` represents a terminal state. Transitioning to `done` automatically emits a `captureTodoCompleted` analytics event. Omit to leave the existing status unchanged.").option("--due-at <value>", 'Update calendar due date in ISO date-only format (`YYYY-MM-DD`). Pass `""` explicitly to clear an existing due date, or omit to leave it unchanged. Passing `null` is strictly rejected.').option("--type-id <value>", "Re-assign this todo to a different active type. The new type must belong to the todo's same project; otherwise the request fails with TYPE_PROJECT_MISMATCH. New server-generated type ids use typ_<ULID>; legacy ids remain accepted.").option("--custom-fields <value>", "PATCH semantics: only the keys present in this map change. Pass `null` for a key (e.g. `custom_fields: { priority: null }`) to explicitly delete that custom field value. Array values are replaced wholesale with no element-level diff. Providing a key that is not declared on the effective todo type is rejected with `UNDECLARED_FIELD`.").option("--user-id <value>", "Reassign the owner (assignee) user ID of this todo. Target user must belong to the same organization.").action(async (id, opts) => {
   const client2 = await loadSdkClient();
   const result = await todoUpdate({
     client: client2._rawClient,
@@ -3116,7 +3240,7 @@ var todoUpdateCommand = new Command50("update").description("Update a todo").arg
       status: opts.status,
       due_at: opts.dueAt,
       type_id: opts.typeId,
-      custom_fields: opts.customFields,
+      custom_fields: parseJsonField(opts.customFields, "custom-fields"),
       user_id: opts.userId
     }
   });
@@ -3191,7 +3315,10 @@ function registerGeneratedCommands(root) {
   root_todo_project.addCommand(projectCreateCommand);
   root_todo_project.addCommand(projectListCommand);
   const root_todo_rule = root_todo.command("rule").description("rule commands");
+  root_todo_rule.addCommand(recurrenceRuleCreateCommand);
   root_todo_rule.addCommand(recurrenceRuleListCommand);
+  root_todo_rule.addCommand(recurrenceRuleDeleteCommand);
+  root_todo_rule.addCommand(recurrenceRuleGetCommand);
   root_todo.addCommand(todoCreateCommand);
   root_todo.addCommand(todoListCommand);
   const root_todo_type = root_todo.command("type").description("type commands");
@@ -3202,7 +3329,7 @@ function registerGeneratedCommands(root) {
 }
 
 // src/handwritten/commands/login.ts
-import { Command as Command51 } from "commander";
+import { Command as Command54 } from "commander";
 
 // src/handwritten/auth/device-flow.ts
 var DEFAULT_SLEEP = (ms) => new Promise((r) => setTimeout(r, ms));
@@ -3381,7 +3508,7 @@ async function runLogin(opts) {
 }
 
 // src/handwritten/commands/login.ts
-var loginCommand = new Command51("login").description("Log in via OAuth device flow (default) or API key").option("--api-key <key>", "Log in with a wspc API key (escape hatch)").option("--json", "Emit machine-readable events to stdout").action(async (opts) => {
+var loginCommand = new Command54("login").description("Log in via OAuth device flow (default) or API key").option("--api-key <key>", "Log in with a wspc API key (escape hatch)").option("--json", "Emit machine-readable events to stdout").action(async (opts) => {
   const store = new ConfigStore();
   const output = opts.json ? { write: () => {
   }, writeJson: (e) => process.stdout.write(JSON.stringify(e) + "\n") } : {
@@ -3398,7 +3525,7 @@ var loginCommand = new Command51("login").description("Log in via OAuth device f
 });
 
 // src/handwritten/commands/logout.ts
-import { Command as Command52 } from "commander";
+import { Command as Command55 } from "commander";
 
 // src/handwritten/auth/logout.ts
 async function runLogout(opts) {
@@ -3426,7 +3553,7 @@ async function runLogout(opts) {
 }
 
 // src/handwritten/commands/logout.ts
-var logoutCommand = new Command52("logout").description("Log out an account (default: the active account in the current env)").argument("[email]", "Email of the account to log out").option("--all", "Log out every account in the current env").action(async (email, opts) => {
+var logoutCommand = new Command55("logout").description("Log out an account (default: the active account in the current env)").argument("[email]", "Email of the account to log out").option("--all", "Log out every account in the current env").action(async (email, opts) => {
   const res = await runLogout({ store: new ConfigStore(), email, all: opts.all });
   if (res.removed.length === 0) {
     process.stdout.write("nothing to log out\n");
@@ -3439,7 +3566,7 @@ var logoutCommand = new Command52("logout").description("Log out an account (def
 });
 
 // src/handwritten/commands/whoami.ts
-import { Command as Command53 } from "commander";
+import { Command as Command56 } from "commander";
 var ENV_DISPLAY = {
   shape: "object",
   fields: ["name", "api_base", "account", "actor", "agent_label"]
@@ -3471,7 +3598,7 @@ async function backfillActiveEmail(store, envName, email, userId) {
     await store.write(cfg);
   }
 }
-var whoamiCommand = new Command53("whoami").description("Show the active env, signed-in account, and organization").action(async () => {
+var whoamiCommand = new Command56("whoami").description("Show the active env, signed-in account, and organization").action(async () => {
   const store = new ConfigStore();
   const config = await store.read();
   let resolved;
@@ -3524,8 +3651,8 @@ function printLoggedOut() {
 }
 
 // src/handwritten/commands/config.ts
-import { Command as Command54 } from "commander";
-var configCommand = new Command54("config").description("Manage wspc local config");
+import { Command as Command57 } from "commander";
+var configCommand = new Command57("config").description("Manage wspc local config");
 registerRenderer("config_show", (data) => {
   const d = data;
   if (d.envs.length === 0) {
@@ -3596,7 +3723,7 @@ configCommand.command("use <env>").description("Switch current_env").action(asyn
 });
 
 // src/handwritten/commands/account.ts
-import { Command as Command55 } from "commander";
+import { Command as Command58 } from "commander";
 async function listAccounts(store) {
   const c = await store.read();
   const envName = c.current_env;
@@ -3637,7 +3764,7 @@ registerRenderer("account_ls", (data) => {
   ]);
   process.stdout.write(table(headers, body));
 });
-var accountCommand = new Command55("account").description("Manage logged-in accounts");
+var accountCommand = new Command58("account").description("Manage logged-in accounts");
 accountCommand.command("ls").description("List accounts in the current env (active marked with \u2713)").action(async () => {
   const accounts = await listAccounts(new ConfigStore());
   render({ kind: "account_ls" }, { accounts });
@@ -3649,7 +3776,7 @@ accountCommand.command("switch <email>").description("Set the active account for
 });
 
 // src/handwritten/commands/todo-done.ts
-import { Command as Command56 } from "commander";
+import { Command as Command59 } from "commander";
 var TODO_UPDATE_DISPLAY = {
   shape: "object",
   format: {
@@ -3667,7 +3794,7 @@ var TODO_UPDATE_DISPLAY = {
     deleted_at: "relative-time"
   }
 };
-var todoDoneCommand = new Command56("done").description("Mark a todo done (sugar for `update <id> --status done`)").argument("<id>", "Todo id").action(async (id) => {
+var todoDoneCommand = new Command59("done").description("Mark a todo done (sugar for `update <id> --status done`)").argument("<id>", "Todo id").action(async (id) => {
   const client2 = await loadSdkClient();
   const result = await todoUpdate({
     client: client2._rawClient,
@@ -3686,7 +3813,7 @@ var todoDoneCommand = new Command56("done").description("Mark a todo done (sugar
 });
 
 // src/handwritten/commands/email/send.ts
-import { Command as Command57 } from "commander";
+import { Command as Command60 } from "commander";
 import { readFile, stat } from "fs/promises";
 import { basename } from "path";
 
@@ -3744,7 +3871,7 @@ async function resolveAttachment(input) {
     `--attach ${input}: neither a readable file nor a valid <prefix>_<ulid>:<idx> reference.`
   );
 }
-var sendCommand = new Command57("send").description("Send an outbound email").requiredOption("--from <alias-email>", "alias email to send from").option("--to <addr...>", "recipient address (repeatable)", []).option("--subject <text>", "subject").option("--text <body>", "plain-text body").option("--text-file <path>", "read text body from file").option("--reply <id>", "inbound email id to reply to").option("--attach <path-or-ref...>", "attachment (file path or eml_xxx:idx)", []).requiredOption("--idempotency-key <key>", "idempotency key").action(async (opts) => {
+var sendCommand = new Command60("send").description("Send an outbound email").requiredOption("--from <alias-email>", "alias email to send from").option("--to <addr...>", "recipient address (repeatable)", []).option("--subject <text>", "subject").option("--text <body>", "plain-text body").option("--text-file <path>", "read text body from file").option("--reply <id>", "inbound email id to reply to").option("--attach <path-or-ref...>", "attachment (file path or eml_xxx:idx)", []).requiredOption("--idempotency-key <key>", "idempotency key").action(async (opts) => {
   const isReply = Boolean(opts.reply);
   const to = opts.to;
   const attachInputs = opts.attach;
@@ -3831,7 +3958,7 @@ var sendCommand = new Command57("send").description("Send an outbound email").re
 });
 
 // src/handwritten/commands/email/attachment.ts
-import { Command as Command58 } from "commander";
+import { Command as Command61 } from "commander";
 import { createWriteStream } from "fs";
 import { Readable } from "stream";
 import { pipeline } from "stream/promises";
@@ -3848,7 +3975,7 @@ function parseContentDispositionFilename(header) {
 }
 
 // src/handwritten/commands/email/attachment.ts
-var attachmentCommand = new Command58("attachment").description("Download an inbound email attachment by index").argument("<email-id>").argument("<idx>").option("--output <path>", "output file path").option("--include-deleted", "allow downloads from soft-deleted parent emails").action(async (emailId, idxArg, opts) => {
+var attachmentCommand = new Command61("attachment").description("Download an inbound email attachment by index").argument("<email-id>").argument("<idx>").option("--output <path>", "output file path").option("--include-deleted", "allow downloads from soft-deleted parent emails").action(async (emailId, idxArg, opts) => {
   const idx = Number(idxArg);
   if (!Number.isInteger(idx) || idx < 0) {
     process.stderr.write(`<idx> must be a non-negative integer (got "${idxArg}")
@@ -3881,7 +4008,7 @@ var attachmentCommand = new Command58("attachment").description("Download an inb
 
 // src/cli.ts
 function buildProgram() {
-  const program = new Command59().name("wspc").description("Official CLI for wspc.ai").version(`wspc ${VERSION} (spec ${SPEC_SHA}, fetched ${SPEC_FETCHED_AT})`).option("--json", "Output raw JSON (machine-readable)").option("--account <email>", "Run as a specific account (overrides the active account)").hook("preAction", (_thisCommand, actionCommand) => {
+  const program = new Command62().name("wspc").description("Official CLI for wspc.ai").version(`wspc ${VERSION} (spec ${SPEC_SHA}, fetched ${SPEC_FETCHED_AT})`).option("--json", "Output raw JSON (machine-readable)").option("--account <email>", "Run as a specific account (overrides the active account)").hook("preAction", (_thisCommand, actionCommand) => {
     const globals = actionCommand.optsWithGlobals();
     if (globals.json) process.env.WSPC_OUTPUT = "json";
     if (globals.account) process.env.WSPC_ACCOUNT = String(globals.account);