ryugi-artifacts 1.15.0 → 1.15.2

package/dist/cli.cjs

@@ -232,7 +232,7 @@ function serverClient(projectDir) {
 
 // src/cli/comment.ts
 var COMMENT_ACTIONS = ["list", "add", "reply", "resolve"];
-var DOCUMENT = /^document\/[a-z0-9][a-z0-9-]*$/;
+var ARTIFACT = /^(document|artboard)\/[a-z0-9][a-z0-9-]*$/;
 var WRITTEN = { add: "comment-added", reply: "comment-replied", resolve: "comment-resolved" };
 function readStdin() {
   if (process.stdin.isTTY) return "";
@@ -247,8 +247,20 @@ function messageText(options) {
   if (!text2) throw new CliError("The message is empty: pass --text <text> or pipe it on stdin");
   return text2;
 }
-function requestOf(options, action) {
+function coordinate(value, flag) {
+  if (value === void 0) return void 0;
+  const number = Number(value);
+  if (!Number.isFinite(number)) throw new CliError(`${flag} must be a number`);
+  return number;
+}
+function requestOf(options, action, type) {
   if (action === "list") return { op: "list", all: !!options.all };
+  if (action === "add" && type === "artboard") {
+    if (!options.board) throw new CliError("comment add on an artboard needs --board <boardId>");
+    const x = coordinate(options.x, "--x");
+    const y = coordinate(options.y, "--y");
+    return { op: "add", board: options.board, ...x !== void 0 ? { x } : {}, ...y !== void 0 ? { y } : {}, text: messageText(options) };
+  }
   if (action === "add") {
     if (!options.block) throw new CliError("comment add needs --block <blockId>");
     return { op: "add", blockId: options.block, ...options.quote ? { quote: options.quote } : {}, text: messageText(options) };
@@ -259,12 +271,12 @@ function requestOf(options, action) {
 async function comment(options, emit) {
   const action = COMMENT_ACTIONS.find((name) => name === options.action);
   if (!action) throw new CliError("comment needs an action: list, add, reply or resolve");
-  if (!options.artifact || !DOCUMENT.test(options.artifact)) throw new CliError("--artifact must be document/<id>");
-  const request = requestOf(options, action);
+  if (!options.artifact || !ARTIFACT.test(options.artifact)) throw new CliError("--artifact must be document/<id> or artboard/<id>");
+  const [type, id] = options.artifact.split("/");
+  const request = requestOf(options, action, type);
   const server = serverClient(options.projectDir);
   const agent = detectAgent(process.env);
-  const id = options.artifact.slice("document/".length);
-  const { status, json } = await server.call("POST", `/api/agent/document/${id}/comments`, { ...request, ...agent ? { agent } : {} });
+  const { status, json } = await server.call("POST", `/api/agent/${type}/${id}/comments`, { ...request, ...agent ? { agent } : {} });
   if (status === 404 && typeof json.error !== "string") {
     throw new CliError(`The running artifacts server is older than this CLI. Run \`${invocation()} start --project-dir ${server.project}\` to replace it, then run this again.`);
   }
@@ -274,9 +286,23 @@ async function comment(options, emit) {
   return 0;
 }
 var clip = (text2, max) => text2.length > max ? `${text2.slice(0, max)}\u2026` : text2;
+var percent = (value) => `${Math.round(value * 100)}%`;
+function anchorLines(thread) {
+  const anchor = thread.anchor;
+  if ("blockId" in anchor) return [`  on block ${anchor.blockId}${anchor.quote ? ` "${clip(anchor.quote, 120)}"` : ""}`];
+  const file = anchor.board ? thread.files?.[anchor.board] : void 0;
+  const where = anchor.board ? `, board ${anchor.board}${file ? ` (${file})` : ""}` : "";
+  const lines = [`  on page ${anchor.page}${where} at ${anchor.x},${anchor.y}`];
+  anchor.nodes?.forEach((node, index) => {
+    const offset = index === 0 && anchor.offset ? ` at ${percent(anchor.offset.x)}, ${percent(anchor.offset.y)}` : "";
+    lines.push(`  node ${node.board}: ${node.path}${offset}`);
+  });
+  if (thread.stale) lines.push("  the board changed since this comment; the node may have moved");
+  return lines;
+}
 function threadText(thread) {
-  const state = [thread.status, thread.waitingOn ? `waiting on ${thread.waitingOn}` : "", thread.changes?.length ? thread.changes.join(", ") : ""].filter(Boolean).join(" \xB7 ");
-  const lines = [`thread ${thread.id} (${state})`, `  on block ${thread.anchor.blockId}${thread.anchor.quote ? ` "${clip(thread.anchor.quote, 120)}"` : ""}`];
+  const state = [thread.status, thread.waitingOn ? `waiting on ${thread.waitingOn}` : "", thread.changes?.length ? thread.changes.join(", ") : "", thread.stale ? "stale" : ""].filter(Boolean).join(" \xB7 ");
+  const lines = [`thread ${thread.id} (${state})`, ...anchorLines(thread)];
   for (const message of thread.messages) {
     const who = message.name ? `${message.author} (${message.name})` : message.author;
     lines.push(`  ${who}: ${message.deleted ? "[deleted]" : message.text.replace(/\n/g, "\n    ")}`);
@@ -723,11 +749,12 @@ Commands:
   publish   Publish an artifact to the Ryugi cloud (needs a running server):
               --artifact <type>/<id> [--public | --private] [--unpublish]
               --list | --delete <cloud-id> | --login | --logout
-  comment   Read and answer a document's comments (needs a running server):
-              list    --artifact document/<id> [--all]   what changed since you last listed
+  comment   Read and answer comments on a document or artboard (needs a running server):
+              list    --artifact <document|artboard>/<id> [--all]   what changed since you last listed
               add     --artifact document/<id> --block <blockId> [--quote <text>] [--text <text>]
-              reply   --artifact document/<id> --thread <threadId> [--text <text>]
-              resolve --artifact document/<id> --thread <threadId>
+              add     --artifact artboard/<id> --board <boardId> [--x <px> --y <px>] [--text <text>]
+              reply   --artifact <document|artboard>/<id> --thread <threadId> [--text <text>]
+              resolve --artifact <document|artboard>/<id> --thread <threadId>
             Without --text, add and reply read the message from stdin.
   config    Auto-publish changed artifacts as private cloud copies when the agent's turn ends:
               --auto-publish on|off              for every project
@@ -856,7 +883,10 @@ async function main(argv) {
         block: { type: "string" },
         quote: { type: "string" },
         thread: { type: "string" },
-        text: { type: "string" }
+        text: { type: "string" },
+        board: { type: "string" },
+        x: { type: "string" },
+        y: { type: "string" }
       }, 1);
       return await comment({
         projectDir: values["project-dir"] ?? process.cwd(),
@@ -866,7 +896,10 @@ async function main(argv) {
         block: values.block,
         quote: values.quote,
         thread: values.thread,
-        text: values.text
+        text: values.text,
+        board: values.board,
+        x: values.x,
+        y: values.y
       }, emit);
     }
     if (command === "config") {
@@ -878,7 +911,7 @@ async function main(argv) {
       }, emit);
     }
     if (command === "--version" || command === "-v") {
-      console.log("1.15.0");
+      console.log("1.15.2");
       return 0;
     }
     if (command === "--help" || command === "-h") {