@nodii/dev 0.6.6 → 0.6.7

package/README.md

@@ -144,8 +144,21 @@ nodii-dev figma submit CHANGE_SET --file SUBMISSION.json
 nodii-dev figma apply CHANGE_SET --figma-version VERSION
 nodii-dev figma published CHANGE_SET --figma-version VERSION
 nodii-dev figma abandon CHANGE_SET
+nodii-dev figma withdraw CHANGE_SET    # take back a submit before anything is decided
 nodii-dev figma release FILE_KEY
 
+```
+
+`figma withdraw` moves a change set you hold from `in_review` back to
+`editing`, as long as no item has been decided (Dev's
+`withdrawDesignChangeSet`). Dev refuses when the change set doesn't exist
+(`CHANGE_SET_NOT_FOUND`), isn't in review (`CHANGE_SET_NOT_IN_REVIEW`), you
+aren't its holder or an operator (`WITHDRAW_NOT_ALLOWED`), or an item is
+already decided (`CHANGE_SET_HAS_DECISIONS`: ask the reviewer to request
+changes instead). The CLI prints each refusal in plain words and keeps the
+code.
+
+```bash
 nodii-dev hook claude-figma-pre       # reads Claude Code hook JSON on stdin
 nodii-dev hook claude-figma-post      # reads Claude Code hook JSON on stdin
 nodii-dev hook print-settings         # prints managed-settings JSON; writes nothing

package/dist/cli.js

@@ -68,6 +68,7 @@ Usage: nodii-dev <command> [options] [--json]
   design guideline propose ENTRY --file FILE.md [--summary TEXT] [--dry-run]
   design changeset list [--entry KEY] [--state STATE] | show ID
   figma lock|check|log-write|submit|apply|published|abandon|release
+  figma withdraw CHANGE_SET             # holder takes back a submit: in_review -> editing
   hook claude-figma-pre|claude-figma-post|print-settings
   setup [--yes|--check]                 # dry-run by default
   harness install|update [--include-drafts[=false]] [--adopt PATH,...] [--dry-run]
@@ -268,6 +269,25 @@ export function transitionBody(f) {
   return { to, ...(note ? { note } : {}) };
 }
 
+// Dev's refusals of withdrawDesignChangeSet, said in terms of what to do next.
+const WITHDRAW_REFUSALS = {
+  CHANGE_SET_NOT_FOUND: (id) => `No change set ${id} in Dev.`,
+  CHANGE_SET_NOT_IN_REVIEW: (id) => `${id} is not in review; only a submitted (in_review) change set can be withdrawn.`,
+  WITHDRAW_NOT_ALLOWED: (id) => `You don't hold ${id}; only its holder (or an operator) can withdraw it.`,
+  CHANGE_SET_HAS_DECISIONS: (id) => `${id} already has a decided item, so it can't be withdrawn; ask the reviewer to request changes instead.`,
+};
+
+export async function figmaWithdraw(id, { request = devRequest } = {}) {
+  if (!id) throw new CliError("USAGE", "figma withdraw CHANGE_SET", 2);
+  try {
+    return await request("POST", `/api/v1/design/change-sets/${encode(id)}/withdraw`, {});
+  } catch (error) {
+    const say = WITHDRAW_REFUSALS[error?.code];
+    if (!say) throw error;
+    throw new CliError(error.code, say(id), error.exitCode ?? 1, error.details);
+  }
+}
+
 export async function main(argv = process.argv.slice(2)) {
   if (argv.length === 1 && ["--version", "-v"].includes(argv[0]))
     return console.log(VERSION);
@@ -574,6 +594,8 @@ export async function main(argv = process.argv.slice(2)) {
         json,
       );
     }
+    if (action === "withdraw")
+      return emit(await figmaWithdraw(rest[0]), json, `Withdrew ${rest[0]}; it is back in editing.`);
     if (action === "release")
       return emit(
         await devRequest(

package/dist/core.js

@@ -4,7 +4,7 @@ import { chmod, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import { homedir, platform } from "node:os";
 import { dirname, join } from "node:path";
 
-export const VERSION = "0.6.6";
+export const VERSION = "0.6.7";
 export const configPath = () =>
   process.env.NODII_DEV_CONFIG_PATH ??
   join(homedir(), ".config/nodii-dev/config.json");