@nodii/dev 0.6.13 → 0.6.14

package/README.md

@@ -147,6 +147,7 @@ prints them without creating anything.
 nodii-dev figma file add FILE_KEY --name TEXT --kind design-system|surfaces|prototype [--module M]
 nodii-dev figma lock FILE_KEY --title TEXT [--scope KIND:ID ...]
 nodii-dev figma scope add CHANGE_SET --scope KIND:ID [--scope ...]
+nodii-dev figma scope set CHANGE_SET --scope KIND:ID [--scope ...]
 nodii-dev figma publish-plan FILE_KEY
 nodii-dev figma check FILE_KEY
 nodii-dev figma log-write CHANGE_SET --tool TOOL --nodes NODE[,NODE]
@@ -190,7 +191,14 @@ refuses an overlap with `SCOPE_CONFLICT`; the CLI prints Dev's message, then
 the set holding the overlapping scope. `figma lock` without `--scope` locks the
 whole file, as older CLIs do, and that conflicts with every other set.
 `figma scope add` widens a set you hold, with the same check; nothing is ever
-widened silently.
+widened silently. `figma scope set` narrows a set you hold to exactly the
+scopes you give, and releases the rest for other sets: for example, a set
+migrated as a whole-file lock can keep just its page. It only narrows. Each
+scope must sit inside one the set holds (the whole file holds everything, and
+a page holds its components and creates); anything else is
+`SCOPE_NOT_NARROWER`. Dev refuses with `WRITE_OUT_OF_SCOPE` when a logged
+write or a submitted node would fall outside the narrower scopes, so keep a
+scope that holds them.
 
 Every write must fall inside the set's scopes (MW1-57.7). The post-hook
 logs each write's node ids, in colon form. It also logs the variable,

package/dist/api.js

@@ -102,7 +102,7 @@ export const GROUPS = {
   composite: "Composite", "service-edges": "ServiceEdges", lanes: "Lanes",
   swaps: "Swaps", ideas: "Ideas", terminology: "Terminology", credentials: "Credentials",
   rulebook: "ad-documents", "ad-decisions": "ad-decisions", domains: "ad-domains", standardizations: "standardizations",
-  archive: "archive", harness: "harness",
+  archive: "archive", harness: "harness", utils: "utils",
   // DEC-0020 rule delivery; `rules core|report|cap` are first-class (upload.js).
   rules: "rulebook",
 };

package/dist/cli.js

@@ -40,6 +40,8 @@ import {
   figmaPublishPlanText,
   figmaResubmit,
   figmaScopeAdd,
+  figmaScopeSet,
+  figmaScopeSetText,
   figmaSubmit,
   isChangeSetId,
   scopeText,
@@ -92,6 +94,7 @@ Usage: nodii-dev <command> [options] [--json]
                                         # scopes: component:NODE page:NODE foundations create:PAGE:NAME;
                                         # no --scope locks the whole file (DEC-0032)
   figma scope add CHANGE_SET --scope KIND:ID [--scope ...]   # widen a held set's scopes
+  figma scope set CHANGE_SET --scope KIND:ID [--scope ...]   # narrow to exactly these; the rest frees
   figma publish-plan FILE_KEY           # what to publish, and what to leave unchecked in Figma's dialog
   figma published FILE_KEY|CHANGE_SET --figma-version V   # a file key marks every awaiting set published
   figma check|log-write|submit|apply|abandon|release
@@ -140,7 +143,7 @@ contracts, sagas, outbox-topics, tables, libraries, workers, projects, issues,
 backlogs, builds, changes, deploy-reports, runtime, people, agents, inbox,
 gate, design, runbooks, doctrine, changelog, health-verdicts, approval-kinds,
 notification-registry, skills, open-questions, decisions, drift, requests,
-rulebook, ad-decisions, domains, standardizations, archive, and harness.
+rulebook, ad-decisions, domains, standardizations, archive, harness, and utils.
 
 Run a command with --help or see the package README for all flags.`;
 
@@ -606,7 +609,8 @@ export async function main(argv = process.argv.slice(2)) {
     if (action === "lock")
       return emit(await figmaLock(rest[0], requireFlag(f, "title"), { scopes: scopesFrom(f) }), json, (p) => figmaLockText(p.data));
     if (action === "scope") {
-      if (rest[0] !== "add" || !rest[1] || rest.length > 2) throw new CliError("USAGE", "figma scope add CHANGE_SET --scope KIND:ID [--scope ...]", 2);
+      if (!["add", "set"].includes(rest[0]) || !rest[1] || rest.length > 2) throw new CliError("USAGE", "figma scope add|set CHANGE_SET --scope KIND:ID [--scope ...]", 2);
+      if (rest[0] === "set") return emit(await figmaScopeSet(rest[1], scopesFrom(f)), json, (p) => figmaScopeSetText(rest[1], p.data));
       return emit(await figmaScopeAdd(rest[1], scopesFrom(f)), json, (p) =>
         `${rest[1]} holds ${p.data?.scopes?.length ?? "its"} scope(s)${p.data?.scopes?.length ? `: ${p.data.scopes.map(scopeText).join(", ")}` : ""}`);
     }

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.13";
+export const VERSION = "0.6.14";
 export const configPath = () =>
   process.env.NODII_DEV_CONFIG_PATH ??
   join(homedir(), ".config/nodii-dev/config.json");