@nodii/dev 0.6.33 → 0.6.35

package/README.md

@@ -131,12 +131,14 @@ nodii-dev decisions create|lock|supersede|amend
 
 nodii-dev lane gather [KEY] [--delta] [--objective TEXT] [--done-check TEXT]
                         [--paths A,B] [--components K,L]
+nodii-dev lane gather show [KEY] [--gather ID]
 nodii-dev lane freeze add KEY --section SECTION --file ITEM.json --reason TEXT
 nodii-dev lane freeze drop KEY --section SECTION --item ID --reason TEXT
 nodii-dev lane freeze swap KEY --section SECTION [--item ID] --file VALUE.json --reason TEXT
 nodii-dev lane freeze show KEY
 nodii-dev lane freeze history KEY
 nodii-dev rules find "QUESTION" [--limit N]
+nodii-dev rules show CLAUSE_ID
 nodii-dev gather tune cases|runs
 nodii-dev gather tune replay CASE_ID
 nodii-dev gather tune start --cases all|ID,ID --corpus-ref REF [--trigger T] [--settings JSON]
@@ -404,7 +406,13 @@ changes, production-secret/test-auth bypasses, cleanup of Docker resources the
 run did not create, and deploy/apply commands without an exact grant. Allowed
 calls produce no output. Codex receives runtime-native `Bash` and `apply_patch`
 matchers, JSON denials, and `additionalContext` nudges. A compact session start
-prints the current lane Freeze again.
+prints the current lane Freeze again, with how to fetch its full Clause map.
+
+The Freeze pins only the ⚑ (counter-instinct) clauses, in full. Every other
+Gather clause stays in the Clause map, which the Freeze references by Gather
+id, listing one-line gists in rank order up to the 1,500-token cap ("+N more
+in Clause map"). `lane gather show` prints the whole Clause map and
+`rules show <ID>` prints one clause in full.
 
 Hard blocks apply only after Dev proves the current agent, branch and worktree
 belong to an active lane. Interactive or otherwise unproven sessions receive
@@ -807,6 +815,23 @@ The launched process uses the already-provisioned lowercase identity (for
 example `~/.config/nodii-dev/agents/lane-ah-12.json`), never the coordinator's
 Dev identity.
 
+A lane's Figma scope is held by published key only (MW8-20): `--figma
+FILE_KEY` for a whole file, or `--figma FILE_KEY=COMPONENT_SET_KEY[,KEY]` for
+its component sets. A node id is refused. `--route /app/...` (repeatable)
+derives the scope from the DS catalog (`https://design.nodii.co/registry.json`,
+or `NODII_DEV_DS_REGISTRY_URL`): the route's Surfaces (page, dialogs, tabs),
+each one's published `componentSetKey`, and its file. A route with no Surface
+is `FIGMA_ROUTE_UNMAPPED` (a DS catalog fix), and a Surface whose key is not
+published yet is `FIGMA_KEY_UNPUBLISHED`. The scope becomes the Freeze's Figma
+boundaries. Gather sends the DS components those Surfaces are built from, so
+their guidelines and U-docs apply, and pins one `figma-guidelines` lookup.
+An explicit set key must be a published Surface in that file
+(`FIGMA_KEY_UNKNOWN`). `figma lock`, `figma scope add|set` and the Figma
+pre-write hook refuse a file, page, section or set outside the scope with
+`FIGMA_OUTSIDE_LANE_SCOPE` (the hook exits 2). A lane that declared no Figma
+scope is not bounded; a Freeze with `figma: []` means "no Figma" and refuses
+every Figma lock and write.
+
 Objective, scope and rule changes are durable `lane amend` records, never chat
 messages. Every CLI call from a launched worktree checks the current watched
 run's acknowledgement version. A pending change is printed and blocks the

package/dist/cli.js

@@ -20,7 +20,7 @@ import {
   refuseFromLane,
   revokeOAuth,
 } from "./oauth.js";
-import { heartbeatCurrentLane, postHook, postHookFailure, preHook, sessionStartContext, settingsSnippet, workflowSuggestion } from "./hooks.js";
+import { FIGMA_HOOK_DENIALS, heartbeatCurrentLane, postHook, postHookFailure, preHook, sessionStartContext, settingsSnippet, workflowSuggestion } from "./hooks.js";
 import { setupCommand } from "./setup.js";
 import { harnessCommand } from "./harness.js";
 import { hookRuntime, recordHookFire, safetyContext, safetyPostHook, safetyPreHook } from "./safety.js";
@@ -53,6 +53,7 @@ import {
 } from "./figma.js";
 export { figmaLock, submitMode } from "./figma.js";
 import { tuneCommand } from "./tune.js";
+import { TUNING_MODELS, measurePickerLatency } from "./gather.js";
 import { docsCommand, rulebookCommand, rulesCommand } from "./upload.js";
 import { changeSetCommand, guidelineCommand } from "./guidelines.js";
 import { designCheck, designCheckText, designRoles, designRolesText } from "./design.js";
@@ -155,6 +156,7 @@ Usage: nodii-dev <command> [options] [--json]
   rules core                            # the generated core (M05-33); refused over the cap
   rules report [--section S] [--lane KEY]   # delivery totals per document; rules served per lane
   rules find "QUESTION" [--limit N]         # answer an ad-hoc rules question from the indexed sections
+  rules show CLAUSE_ID                  # one clause in full, from the current document version
   rules cap TOKENS                      # operator: set the core token cap (default 3000)
   gather tune cases|runs                # Gather tuning (AH-11): frozen cases; runs with per-picker scores
   gather tune replay <case-id>          # blind replay + trigger shortlist, for the lane-agent picker
@@ -165,16 +167,20 @@ Usage: nodii-dev <command> [options] [--json]
   gather tune trial <run-id> --case ID --picker P --iteration N [--documents A,B]
                                         # one trial; lane-agent passes its own --documents pick
   gather tune finalize <run-id>         # Dev scores the full 5-picker x 5-repeat matrix
+  gather picker-latency [--picker gemma-12b|gemma-e4b|gemma-26b]
+                                        # cold (model unloaded first) and warm pick latency, for the tuning record
 
   coordinator start --machine NAME       # register this machine's one watched coordinator; refuses a live second
   lane launch <key> --done-check TEXT --kind KIND --side SIDE
               --issue KEY --repo NAME=/SOURCE --branch NAME=BRANCH [--repo ... --branch ...]
               --machine NAME --runtime claude|codex --profile PATH --model MODEL --subagents N
               [--base NAME=REF] [--worktree NAME=PATH] [--owned-path NAME=PATH]
-              [--figma FILE[=COMPONENT_SET[,SET]]] [--notes TEXT]
+              [--route /app/... ...] [--figma FILE_KEY[=COMPONENT_SET_KEY[,KEY]]] [--notes TEXT]
               [--narrowing-note TEXT --narrowing-remainder DESTINATION]
                                         # authoritative preflight, one worktree per repo, watched launch
                                         # uses the provisioned agents/lane-<key>.json Dev identity
+                                        # Figma scope by published key: --route derives it from the
+                                        # DS catalog (route -> Surfaces -> componentSetKey -> file)
   lane amend <key> --objective|--scope|--rules TEXT --reason TEXT
   lane gather [<key>] [--delta] [--objective TEXT] [--done-check TEXT] [--components a,b] [--paths a,b]
                                         # infers a launched worktree; explicit contract inputs support manual lane start
@@ -182,6 +188,7 @@ Usage: nodii-dev <command> [options] [--json]
                                         # the lane agent picks instead of local Gemma: alone it prints the
                                         # recorded trigger shortlist; with --shortlist/--documents it records
                                         # the pick (picker: agent) and the Clause map
+  lane gather show [<key>] [--gather ID]  # the lane's Clause map (the Freeze references it, not its clauses)
   run [--kind build|test_run|subagent|deploy] [--name TEXT] -- <command> [args...]
                                         # watched command: registers with NODII_DEV_RUN_ID,
                                         # heartbeats, and records exit code + redacted log tail
@@ -584,6 +591,14 @@ export async function main(argv = process.argv.slice(2)) {
   if (command === "docs") return emitCommand(await docsCommand(action, rest, f));
   if (command === "rulebook" && ["list", "show", "diff"].includes(action)) return emitCommand(await rulebookCommand(action, rest, f));
   if (command === "rules") return emitCommand(await rulesCommand(action, rest, f));
+  if (command === "gather" && action === "picker-latency") {
+    const name = f.picker ?? "gemma-12b";
+    const model = Object.hasOwn(TUNING_MODELS, name) ? TUNING_MODELS[name] : null;
+    if (!model) throw new CliError("USAGE", `gather picker-latency [--picker ${Object.keys(TUNING_MODELS).join("|")}]`, 2);
+    const result = await measurePickerLatency({ model });
+    const line = (label, x) => `${label} ${x.wallMs} ms (Ollama total ${x.totalMs ?? "?"} ms, model load ${x.loadMs ?? "?"} ms)`;
+    return emit(result, json, (r) => `${r.model}\n${line("cold", r.cold)}\n${line("warm", r.warm)}`);
+  }
   if (command === "gather" && action === "tune") {
     const result = await tuneCommand(rest[0], rest.slice(1), f);
     emit(result.payload, json, result.human);
@@ -918,7 +933,7 @@ export async function main(argv = process.argv.slice(2)) {
       } catch (error) {
         // A known policy denial still blocks. Hook/runtime failures fail open
         // and stay silent so a broken environment cannot stop the session.
-        if (!["FIGMA_FILE_KEY_MISSING", "FIGMA_LOCK_DENIED"].includes(error?.code)) return;
+        if (!FIGMA_HOOK_DENIALS.includes(error?.code)) return;
         if (payload && hookRuntime(payload) === "codex") {
           console.log(JSON.stringify({ hookSpecificOutput: { hookEventName: "PreToolUse", permissionDecision: "deny", permissionDecisionReason: `Blocked Figma write: ${error?.message ?? String(error)}` } }));
           return;

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