@wspc/cli 0.1.4 → 0.1.6

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { Command as Command73 } from "commander";
+import { Command as Command74 } from "commander";
 import { realpathSync } from "fs";
 import { fileURLToPath } from "url";
 
@@ -1178,6 +1178,11 @@ var todoCommentUpdate = (options) => (options.client ?? client).patch({
     ...options.headers
   }
 });
+var projectDelete = (options) => (options.client ?? client).delete({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/todo/projects/{id}",
+  ...options
+});
 var recurrenceRuleDelete = (options) => (options.client ?? client).delete({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/todo/recurrence-rules/{id}",
@@ -1464,9 +1469,9 @@ function createConsistencyFetch(opts) {
 }
 
 // src/version.ts
-var VERSION = "0.1.4";
-var SPEC_SHA = "e0bbc1e3";
-var SPEC_FETCHED_AT = "2026-06-22T06:55:37.490Z";
+var VERSION = "0.1.6";
+var SPEC_SHA = "706a2577";
+var SPEC_FETCHED_AT = "2026-06-24T08:28:50.392Z";
 var API_BASE = "https://api.wspc.ai";
 
 // src/index.ts
@@ -3586,9 +3591,30 @@ var todoCommentUpdateCommand = new Command56("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
+// src/generated/cli/todo/project/rm.ts
 import { Command as Command57 } from "commander";
-var recurrenceRuleDeleteCommand = new Command57("rm").description("Delete a recurring todo rule").argument("<id>", "id").option("--expected-version <value>", "expected_version").action(async (id, opts) => {
+var projectDeleteCommand = new Command57("rm").description("Soft-delete a project").argument("<id>", "id").action(async (id, opts) => {
+  const client2 = await loadSdkClient();
+  const result = await projectDelete({
+    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: "project_delete", display: { "shape": "object", "format": { "id": "id-short", "org_id": "id-short", "creator_user_id": "id-short", "default_todo_type_id": "id-short", "name": "truncate", "created_at": "relative-time", "updated_at": "relative-time", "deleted_at": "relative-time" } } }, result.data);
+});
+
+// src/generated/cli/todo/rule/rm.ts
+import { Command as Command58 } from "commander";
+var recurrenceRuleDeleteCommand = new Command58("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,
@@ -3611,8 +3637,8 @@ var recurrenceRuleDeleteCommand = new Command57("rm").description("Delete a recu
 });
 
 // src/generated/cli/todo/rule/show.ts
-import { Command as Command58 } from "commander";
-var recurrenceRuleGetCommand = new Command58("show").description("Get a recurring todo rule").argument("<id>", "id").action(async (id, opts) => {
+import { Command as Command59 } from "commander";
+var recurrenceRuleGetCommand = new Command59("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,
@@ -3632,8 +3658,8 @@ var recurrenceRuleGetCommand = new Command58("show").description("Get a recurrin
 });
 
 // src/generated/cli/todo/rm.ts
-import { Command as Command59 } from "commander";
-var todoDeleteCommand = new Command59("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 Command60 } from "commander";
+var todoDeleteCommand = new Command60("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,
@@ -3657,8 +3683,8 @@ var todoDeleteCommand = new Command59("rm").description("Soft-delete a todo").ar
 });
 
 // src/generated/cli/todo/show.ts
-import { Command as Command60 } from "commander";
-var todoGetCommand = new Command60("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 Command61 } from "commander";
+var todoGetCommand = new Command61("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,
@@ -3683,8 +3709,8 @@ var todoGetCommand = new Command60("show").description("Get a todo by id").argum
 });
 
 // src/generated/cli/todo/update.ts
-import { Command as Command61 } from "commander";
-var todoUpdateCommand = new Command61("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) => {
+import { Command as Command62 } from "commander";
+var todoUpdateCommand = new Command62("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,
@@ -3785,6 +3811,7 @@ function registerGeneratedCommands(root) {
   const root_todo_project = root_todo.command("project").description("project commands");
   root_todo_project.addCommand(projectCreateCommand);
   root_todo_project.addCommand(projectListCommand);
+  root_todo_project.addCommand(projectDeleteCommand);
   const root_todo_rule = root_todo.command("rule").description("rule commands");
   root_todo_rule.addCommand(recurrenceRuleCreateCommand);
   root_todo_rule.addCommand(recurrenceRuleListCommand);
@@ -3800,7 +3827,7 @@ function registerGeneratedCommands(root) {
 }
 
 // src/handwritten/commands/login.ts
-import { Command as Command62 } from "commander";
+import { Command as Command63 } from "commander";
 
 // src/handwritten/auth/device-flow.ts
 var DEFAULT_SLEEP = (ms) => new Promise((r) => setTimeout(r, ms));
@@ -4042,7 +4069,7 @@ function resolveLoginTarget(opts, env) {
 function wantsJson(opts, env) {
   return opts.json === true || env.WSPC_OUTPUT === "json";
 }
-var loginCommand = new Command62("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("--api-base <url>", "Target API base URL (default: production)").option("--env <name>", "Config env name to store credentials under").option("--json", "Emit machine-readable events to stdout").action(async (opts) => {
+var loginCommand = new Command63("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("--api-base <url>", "Target API base URL (default: production)").option("--env <name>", "Config env name to store credentials under").option("--json", "Emit machine-readable events to stdout").action(async (opts) => {
   const store = new ConfigStore();
   const { baseUrl, envName } = resolveLoginTarget(opts, process.env);
   const output = wantsJson(opts, process.env) ? { write: () => {
@@ -4061,7 +4088,7 @@ var loginCommand = new Command62("login").description("Log in via OAuth device f
 });
 
 // src/handwritten/commands/logout.ts
-import { Command as Command63 } from "commander";
+import { Command as Command64 } from "commander";
 
 // src/handwritten/auth/logout.ts
 async function runLogout(opts) {
@@ -4094,7 +4121,7 @@ async function runLogout(opts) {
 }
 
 // src/handwritten/commands/logout.ts
-var logoutCommand = new Command63("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 Command64("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");
@@ -4107,7 +4134,7 @@ var logoutCommand = new Command63("logout").description("Log out an account (def
 });
 
 // src/handwritten/commands/whoami.ts
-import { Command as Command64 } from "commander";
+import { Command as Command65 } from "commander";
 var ENV_DISPLAY = {
   shape: "object",
   fields: ["name", "api_base", "account", "actor", "agent_label"]
@@ -4138,7 +4165,7 @@ async function backfillActiveEmail(store, envName, email, userId) {
     rekeyLegacyAccount(cfg, envName, email, userId);
   });
 }
-var whoamiCommand = new Command64("whoami").description("Show the active env, signed-in account, and organization").action(async () => {
+var whoamiCommand = new Command65("whoami").description("Show the active env, signed-in account, and organization").action(async () => {
   const store = new ConfigStore();
   const config = await store.read();
   let resolved;
@@ -4191,8 +4218,8 @@ function printLoggedOut() {
 }
 
 // src/handwritten/commands/config.ts
-import { Command as Command65 } from "commander";
-var configCommand = new Command65("config").description("Manage wspc local config");
+import { Command as Command66 } from "commander";
+var configCommand = new Command66("config").description("Manage wspc local config");
 registerRenderer("config_show", (data) => {
   const d = data;
   if (d.envs.length === 0) {
@@ -4263,7 +4290,7 @@ configCommand.command("use <env>").description("Switch current_env").action(asyn
 });
 
 // src/handwritten/commands/account.ts
-import { Command as Command66 } from "commander";
+import { Command as Command67 } from "commander";
 async function listAccounts(store) {
   const c = await store.read();
   const envName = c.current_env;
@@ -4304,7 +4331,7 @@ registerRenderer("account_ls", (data) => {
   ]);
   process.stdout.write(table(headers, body));
 });
-var accountCommand = new Command66("account").description("Manage logged-in accounts");
+var accountCommand = new Command67("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 });
@@ -4316,7 +4343,7 @@ accountCommand.command("switch <email>").description("Set the active account for
 });
 
 // src/handwritten/commands/todo-done.ts
-import { Command as Command67 } from "commander";
+import { Command as Command68 } from "commander";
 var TODO_UPDATE_DISPLAY = {
   shape: "object",
   format: {
@@ -4334,7 +4361,7 @@ var TODO_UPDATE_DISPLAY = {
     deleted_at: "relative-time"
   }
 };
-var todoDoneCommand = new Command67("done").description("Mark a todo done (sugar for `update <id> --status done`)").argument("<id>", "Todo id").action(async (id) => {
+var todoDoneCommand = new Command68("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,
@@ -4353,7 +4380,8 @@ var todoDoneCommand = new Command67("done").description("Mark a todo done (sugar
 });
 
 // src/handwritten/commands/email/send.ts
-import { Command as Command68 } from "commander";
+import { Command as Command69 } from "commander";
+import { randomUUID } from "crypto";
 import { readFile, stat } from "fs/promises";
 import { basename } from "path";
 
@@ -4411,7 +4439,7 @@ async function resolveAttachment(input) {
     `--attach ${input}: neither a readable file nor a valid <prefix>_<ulid>:<idx> reference.`
   );
 }
-var sendCommand = new Command68("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 Command69("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)", []).option("--idempotency-key <key>", "idempotency key (auto-generated if omitted)").action(async (opts) => {
   const isReply = Boolean(opts.reply);
   const to = opts.to;
   const attachInputs = opts.attach;
@@ -4469,7 +4497,9 @@ var sendCommand = new Command68("send").description("Send an outbound email").re
   const body = {
     from_alias_email: opts.from,
     text,
-    idempotency_key: opts.idempotencyKey
+    // Server requires an idempotency_key; a fresh random one makes each send a
+    // distinct request, which is the right default for one-shot CLI sends.
+    idempotency_key: opts.idempotencyKey ?? randomUUID()
   };
   if (isReply) {
     body.in_reply_to_email_id = opts.reply;
@@ -4498,7 +4528,7 @@ var sendCommand = new Command68("send").description("Send an outbound email").re
 });
 
 // src/handwritten/commands/email/attachment.ts
-import { Command as Command69 } from "commander";
+import { Command as Command70 } from "commander";
 import { createWriteStream } from "fs";
 import { Readable } from "stream";
 import { pipeline } from "stream/promises";
@@ -4516,7 +4546,7 @@ function parseContentDispositionFilename(header) {
 }
 
 // src/handwritten/commands/email/attachment.ts
-var attachmentCommand = new Command69("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 Command70("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}")
@@ -4548,8 +4578,8 @@ var attachmentCommand = new Command69("attachment").description("Download an inb
 });
 
 // src/handwritten/commands/drive/bind.ts
-import { Command as Command70 } from "commander";
-import { stat as stat2 } from "fs/promises";
+import { Command as Command71 } from "commander";
+import { stat as stat3 } from "fs/promises";
 import { resolve } from "path";
 
 // src/handwritten/commands/drive/api.ts
@@ -4637,8 +4667,8 @@ async function createDriveApi(opts = {}) {
 }
 
 // src/handwritten/commands/drive/state.ts
-import { mkdir, open, readFile as readFile2, rename, rm, writeFile } from "fs/promises";
-import { randomUUID } from "crypto";
+import { mkdir, open, readFile as readFile2, rename, rm, stat as stat2, writeFile } from "fs/promises";
+import { randomUUID as randomUUID2 } from "crypto";
 import { join as join2 } from "path";
 import { DateTime as DateTime4 } from "luxon";
 
@@ -4665,6 +4695,7 @@ function driveConflictTimestamp(clock = systemDriveClock) {
 // src/handwritten/commands/drive/state.ts
 var DRIVE_DIR = ".wspc-drive";
 var STATE_FILE = "state.json";
+var STALE_LOCK_MS = 10 * 60 * 1e3;
 function statePath(root) {
   return join2(root, DRIVE_DIR, STATE_FILE);
 }
@@ -4678,7 +4709,7 @@ async function readDriveState(root) {
 }
 async function writeDriveState(root, state, clock) {
   await mkdir(join2(root, DRIVE_DIR), { recursive: true });
-  const tmp = join2(root, DRIVE_DIR, `state.json.tmp-${process.pid}-${randomUUID()}`);
+  const tmp = join2(root, DRIVE_DIR, `state.json.tmp-${process.pid}-${randomUUID2()}`);
   const snapshot = JSON.stringify(
     {
       ...state,
@@ -4690,7 +4721,7 @@ async function writeDriveState(root, state, clock) {
   const fullPath = statePath(root);
   try {
     await writeFile(tmp, snapshot, { mode: 384 });
-    const fh = await open(tmp, "r");
+    const fh = await open(tmp, "r+");
     try {
       await fh.sync();
     } finally {
@@ -4734,7 +4765,7 @@ async function ensureDriveRealtimeState(root) {
       ...state,
       realtime: {
         ...state.realtime,
-        client_id: `drvcli_${randomUUID().replace(/-/g, "")}`
+        client_id: `drvcli_${randomUUID2().replace(/-/g, "")}`
       }
     };
     await writeDriveState(root, next);
@@ -4750,11 +4781,22 @@ async function writeDriveRealtimeState(root, realtime) {
 async function withDriveLock(root, fn) {
   await mkdir(join2(root, DRIVE_DIR), { recursive: true });
   const lockFile = join2(root, DRIVE_DIR, "sync.lock");
-  const fh = await open(lockFile, "wx").catch((error) => {
-    if (error.code === "EEXIST") {
+  const fh = await open(lockFile, "wx").catch(async (error) => {
+    if (error.code !== "EEXIST") throw error;
+    const lockStat = await stat2(lockFile).catch((statError) => {
+      if (statError.code === "ENOENT") return void 0;
+      throw statError;
+    });
+    if (lockStat && Date.now() - lockStat.mtimeMs <= STALE_LOCK_MS) {
       throw new Error("sync lock already exists");
     }
-    throw error;
+    await rm(lockFile, { force: true });
+    return open(lockFile, "wx").catch((retryError) => {
+      if (retryError.code === "EEXIST") {
+        throw new Error("sync lock already exists");
+      }
+      throw retryError;
+    });
   });
   try {
     return await fn();
@@ -4802,7 +4844,7 @@ function isValidDriveState(value) {
 async function assertExistingDirectory(path) {
   let stats;
   try {
-    stats = await stat2(path);
+    stats = await stat3(path);
   } catch {
     throw new Error(`local folder does not exist: ${path}`);
   }
@@ -4811,7 +4853,7 @@ async function assertExistingDirectory(path) {
   }
 }
 function driveBindCommand() {
-  return new Command70("bind").description("Bind a local folder to an existing Drive library").requiredOption("--library <id>", "existing Drive library id").argument("[path]", "local folder path", ".").action(async (path, opts) => {
+  return new Command71("bind").description("Bind a local folder to an existing Drive library").requiredOption("--library <id>", "existing Drive library id").argument("[path]", "local folder path", ".").action(async (path, opts) => {
     const root = resolve(path);
     await assertExistingDirectory(root);
     const api = await createDriveApi();
@@ -4829,10 +4871,10 @@ function driveBindCommand() {
 }
 
 // src/handwritten/commands/drive/sync.ts
-import { Command as Command71 } from "commander";
+import { Command as Command72 } from "commander";
 import { mkdir as mkdir3, readFile as readFile4, rm as rm3, writeFile as writeFile3 } from "fs/promises";
 import { basename as basename3, dirname as dirname2, join as join5, posix as pathPosix2, resolve as resolve3 } from "path";
-import { createHash as createHash3, randomUUID as randomUUID3 } from "crypto";
+import { createHash as createHash3, randomUUID as randomUUID4 } from "crypto";
 
 // src/handwritten/commands/drive/decision.ts
 function decideDriveAction(entry, local, remote) {
@@ -5213,7 +5255,7 @@ async function hashDriveFile(path) {
 import { createWriteStream as createWriteStream2 } from "fs";
 import { link, mkdir as mkdir2, readFile as readFile3, rename as rename2, rm as rm2, unlink, writeFile as writeFile2 } from "fs/promises";
 import { basename as basename2, dirname, join as join4 } from "path";
-import { createHash as createHash2, randomUUID as randomUUID2 } from "crypto";
+import { createHash as createHash2, randomUUID as randomUUID3 } from "crypto";
 import { Readable as Readable2, Transform } from "stream";
 import { pipeline as pipeline2 } from "stream/promises";
 async function assertLocalStillScanned(localPath, scanned) {
@@ -5228,7 +5270,7 @@ async function assertLocalStillScanned(localPath, scanned) {
 async function writeMergedLocalFile(root, path, bytes, digest, scanned, onLocalMutation) {
   const target = resolveInsideRoot(root, path);
   await mkdir2(dirname(target), { recursive: true });
-  const tmp = join4(dirname(target), `.${basename2(target)}.wspc-merge-${randomUUID2()}.tmp`);
+  const tmp = join4(dirname(target), `.${basename2(target)}.wspc-merge-${randomUUID3()}.tmp`);
   try {
     await writeFile2(tmp, bytes, { flag: "wx" });
     return await installMergedLocalFile(root, path, tmp, scanned, digest, bytes.byteLength, onLocalMutation);
@@ -5280,7 +5322,7 @@ async function installMergedLocalFile(root, path, tmp, scanned, mergedSha256, me
   }
 }
 async function restoreMergedLocalFile(target, backup, backupSha256, backupSizeBytes, mergedSha256, mergedSizeBytes) {
-  const quarantine = join4(dirname(target), `.${basename2(target)}.wspc-merge-restore-${randomUUID2()}.tmp`);
+  const quarantine = join4(dirname(target), `.${basename2(target)}.wspc-merge-restore-${randomUUID3()}.tmp`);
   try {
     await rename2(target, quarantine);
   } catch (error) {
@@ -5310,7 +5352,7 @@ async function restoreMergedLocalFile(target, backup, backupSha256, backupSizeBy
 async function downloadRemote(root, libraryId, path, api, expectedSha256, entry, onLocalMutation) {
   const target = resolveInsideRoot(root, path);
   await mkdir2(dirname(target), { recursive: true });
-  const tmp = join4(dirname(target), `.${basename2(target)}.wspc-download-${randomUUID2()}.tmp`);
+  const tmp = join4(dirname(target), `.${basename2(target)}.wspc-download-${randomUUID3()}.tmp`);
   try {
     const response = await api.downloadFile(libraryId, path);
     if (!response.body) {
@@ -5444,7 +5486,7 @@ async function localFileExists(path) {
   return digest !== void 0;
 }
 function localMutationBackupPath(target) {
-  return join4(dirname(target), `.${basename2(target)}.wspc-backup-${randomUUID2()}.tmp`);
+  return join4(dirname(target), `.${basename2(target)}.wspc-backup-${randomUUID3()}.tmp`);
 }
 function expectedLocalBaseSha256(entry) {
   return entry?.last_local_sha256 ?? entry?.content_sha256;
@@ -5546,7 +5588,7 @@ async function runDriveSyncOnce(root, api, clock = systemDriveClock) {
   });
 }
 function driveSyncCommand(api) {
-  const sync = new Command71("sync").description("Drive sync commands");
+  const sync = new Command72("sync").description("Drive sync commands");
   sync.command("once").description("Run one Drive sync pass").argument("[path]", "local folder path", ".").action(async (path) => {
     const summary = await runDriveSyncOnce(resolve3(path), api);
     render({ kind: "drive_sync_once", display: { shape: "object" } }, summary);
@@ -5858,7 +5900,7 @@ async function writeConflictCopy(root, path, side, versionId, bytes, clock) {
     const target = resolveInsideRoot(root, candidate);
     await mkdir3(dirname2(target), { recursive: true });
     for (; ; ) {
-      const tmp = join5(dirname2(target), `.${basename3(target)}.wspc-conflict-${randomUUID3()}.tmp`);
+      const tmp = join5(dirname2(target), `.${basename3(target)}.wspc-conflict-${randomUUID4()}.tmp`);
       let tmpWritten = false;
       try {
         await writeFile3(tmp, bytes, { flag: "wx" });
@@ -5999,7 +6041,7 @@ function containsVersionConflict(value) {
 }
 
 // src/handwritten/commands/drive/watch.ts
-import { Command as Command72 } from "commander";
+import { Command as Command73 } from "commander";
 import chokidar from "chokidar";
 import { relative as relative2, resolve as resolve4 } from "path";
 
@@ -6213,9 +6255,20 @@ function redactedRealtimeError(error) {
     return "auth failed";
   }
   if (/\bnetwork|fetch|close\b/i.test(text)) {
-    return "network error";
+    return withRealtimeCode("network error", error);
+  }
+  return withRealtimeCode("realtime error", error);
+}
+function withRealtimeCode(label, error) {
+  if (typeof error !== "object" || error === null) return label;
+  const code = error.code;
+  if (typeof code === "string" && /^[A-Z][A-Z0-9_]{1,31}$/.test(code)) {
+    return `${label} (${code})`;
+  }
+  if (typeof code === "number" && Number.isInteger(code)) {
+    return `${label} (${code})`;
   }
-  return "realtime error";
+  return label;
 }
 function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -6438,7 +6491,7 @@ async function runDriveWatch(root, options = {}) {
   }
 }
 function driveWatchCommand(options = {}) {
-  return new Command72("watch").description("Watch a bound Drive folder and sync local changes").argument("[path]", "local folder path", ".").action(async (path) => {
+  return new Command73("watch").description("Watch a bound Drive folder and sync local changes").argument("[path]", "local folder path", ".").action(async (path) => {
     await runDriveWatch(resolve4(path), options);
   });
 }
@@ -6502,7 +6555,7 @@ function waitForStopSignal(onRegistered) {
 function mountDriveCommands(program) {
   let drive = program.commands.find((c) => c.name() === "drive");
   if (!drive) {
-    drive = new Command73("drive").description("Drive commands");
+    drive = new Command74("drive").description("Drive commands");
     program.addCommand(drive);
   }
   if (!drive.commands.some((c) => c.name() === "bind")) {
@@ -6528,7 +6581,7 @@ function isCliEntrypoint(argv = process.argv, metaUrl = import.meta.url) {
   }
 }
 function buildProgram() {
-  const program = new Command73().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 Command74().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);