@nodii/dev 0.6.7 → 0.6.8

package/dist/doctor.js

@@ -4,6 +4,7 @@ import { join } from "node:path";
 import { devRequest, encode, isOAuthConfig, query, setAuthProvider } from "./core.js";
 import { OAuthAuthProvider, decodeClaims, loadRefreshToken } from "./oauth.js";
 import { inferGitContext, repoName } from "./lanes.js";
+import { figmaFileKey, notRegisteredHint } from "./figma.js";
 
 /**
  * What a lane's commands need, in Dev's route policy (staffRuleFor in Dev's
@@ -21,8 +22,8 @@ export const LANE_PERMISSIONS = [
   { key: "devops.agents.read", for: "whoami, reading this agent" },
   { key: "devops.agents.write", for: "agent register|heartbeat" },
   { key: "devops.machines.manage", for: "machine show (this agent's machine and coordinator)" },
-  { key: "devops.decisions.read", for: "figma check" },
-  { key: "devops.decisions.write", for: "figma lock|log-write|submit|apply|published|abandon|withdraw" },
+  { key: "devops.decisions.read", for: "figma check, doctor --figma-file" },
+  { key: "devops.decisions.write", for: "figma lock|file add|log-write|submit|apply|published|abandon|withdraw" },
   { key: "devops.decisions.lock", for: "figma release" },
   { key: "devops.rulebook.read", for: "rulebook show" },
 ];
@@ -225,6 +226,26 @@ export async function doctorCommand(deps = {}) {
     }
   }
 
+  // 8. Given a Figma file (the brief's target), whether Dev has it registered,
+  // so a lock can't fail later with DESIGN_FILE_NOT_FOUND (MW1-38.9).
+  const figmaInput = deps.figmaFile ?? env.NODII_DEV_FIGMA_FILE;
+  if (figmaInput) {
+    const fileKey = figmaFileKey(figmaInput);
+    if (!signedIn) checks.push(cannot("figma_file", "needs a sign-in", { fileKey }));
+    else {
+      try {
+        const file = (await request("GET", `/api/v1/design/files/${encode(fileKey)}`)).data;
+        checks.push(ok("figma_file", `${fileKey} is registered: ${file.name} (${file.kind}${file.module ? `, ${file.module}` : ""})`,
+          { fileKey, registered: true }));
+      } catch (error) {
+        if (error?.code === "DESIGN_FILE_NOT_FOUND")
+          checks.push(missing("figma_file", `${fileKey} is NOT registered: run figma file add; figma lock fails with DESIGN_FILE_NOT_FOUND`,
+            `${prefix}${notRegisteredHint(fileKey).replace(/^.*?: run /, "")}`, { fileKey, registered: false }));
+        else checks.push(cannot("figma_file", `getDesignFile failed (${devReason(error)})`, { fileKey }));
+      }
+    }
+  }
+
   const ready = checks.every((x) => x.status === "ok");
   const width = Math.max(...checks.map((x) => x.key.length));
   const human = (p) => [

package/dist/figma.js

@@ -0,0 +1,15 @@
+import { CliError } from "./core.js";
+
+/** A Figma file key, or the key inside a figma.com file link (a branch link's branch key). */
+export function figmaFileKey(value) {
+  // A flag given without a value parses as `true`: that is a missing key.
+  const text = typeof value === "string" ? value : "";
+  const link = text.match(/figma\.com\/(?:design|file|board|proto|slides)\/([A-Za-z0-9]+)(?:\/branch\/([A-Za-z0-9]+))?/);
+  const key = link ? (link[2] ?? link[1]) : text;
+  if (!key) throw new CliError("USAGE", "a Figma file key is required", 2);
+  return key;
+}
+
+/** What to run when Dev has no row for a Figma file (DESIGN_FILE_NOT_FOUND). */
+export const notRegisteredHint = (key) =>
+  `${key} is NOT registered in Dev: run nodii-dev figma file add ${key} --name NAME --kind design-system|surfaces|prototype [--module M]`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodii/dev",
-  "version": "0.6.7",
+  "version": "0.6.8",
   "description": "Agent CLI for Nodii Dev, reached through the platform edge",
   "type": "module",
   "bin": {