@nodii/dev 0.6.34 → 0.6.35

package/dist/freeze.js

@@ -29,9 +29,43 @@ export function shouldReground(argv) {
 
 /**
  * The only Gather → Freeze shape adapter. Gather may add display metadata,
- * but Freeze retains the stable clause identity/tags and full text only for ⚑.
+ * but Freeze pins only the ⚑ clauses, in full (hub-58): every other clause
+ * stays in the Clause map, which the Freeze references.
  */
 export function pinnedClausesFromGather(clauses) {
+  return checkedGatherClauses(clauses)
+    .filter((clause) => clause.counterInstinct)
+    .map((clause) => ({
+      documentCode: clause.documentCode,
+      documentVersion: clause.documentVersion,
+      clauseId: clause.clauseId,
+      ...(clause.breadcrumb || clause.sectionId
+        ? { section: clause.breadcrumb ?? clause.sectionId }
+        : {}),
+      gist: clause.gist,
+      text: clause.text,
+      counterInstinct: true,
+      repos: clause.repos,
+      steps: clause.steps,
+    }));
+}
+
+/**
+ * The Freeze's reference to the Clause map: its Gather id and the non-flagged
+ * clauses' one-line gists in rank order (Dev cuts them at the token cap).
+ */
+export function clauseMapFromGather(gather) {
+  if (typeof gather?.gatherId !== "string" || !gather.gatherId)
+    throw new CliError("GATHER_CLAUSE_MAP_INVALID", "Gather returned no gather id", 1);
+  const clauses = checkedGatherClauses(gather.clauses)
+    .map((clause, index) => ({ clause, index }))
+    .filter(({ clause }) => !clause.counterInstinct)
+    .sort((a, b) => (a.clause.rank ?? Infinity) - (b.clause.rank ?? Infinity) || a.index - b.index)
+    .map(({ clause }) => ({ clauseId: clause.clauseId, gist: clause.gist }));
+  return { gatherId: gather.gatherId, clauses };
+}
+
+function checkedGatherClauses(clauses) {
   if (!Array.isArray(clauses))
     throw new CliError("GATHER_CLAUSE_MAP_INVALID", "Gather returned no clause map", 1);
   return clauses.map((clause) => {
@@ -66,25 +100,13 @@ export function pinnedClausesFromGather(clauses) {
         ].join(", ")}`,
         1,
       );
-    return {
-      documentCode: clause.documentCode,
-      documentVersion: clause.documentVersion,
-      clauseId: clause.clauseId,
-      ...(clause.breadcrumb || clause.sectionId
-        ? { section: clause.breadcrumb ?? clause.sectionId }
-        : {}),
-      gist: clause.gist,
-      ...(clause.counterInstinct ? { text: clause.text } : {}),
-      counterInstinct: clause.counterInstinct,
-      repos: clause.repos,
-      steps: clause.steps,
-    };
+    return clause;
   });
 }
 
 export const GATHER_LOOKUP_IDS = ["figma-guidelines"];
 
-/** Build the six-section stored contract; Delta Gather keeps lane-authored sections. */
+/** Build the stored contract; Delta Gather keeps lane-authored sections. */
 export function freezeFromGather({
   gather,
   boundaries,
@@ -119,6 +141,7 @@ export function freezeFromGather({
     },
     boundaries,
     pinnedClauses: pinnedClausesFromGather(gather.clauses),
+    clauseMap: clauseMapFromGather(gather),
     // Gather owns the lookups it derives (the Figma scope's guidelines): each
     // Gather replaces them, or drops them when the scope no longer yields any.
     // Lookups the lane added itself are kept.

package/dist/hooks.js

@@ -254,9 +254,13 @@ export async function sessionStartContext(payload, { request = devRequest, confi
     },
     { request, config },
   );
+  // A Freeze written before it referenced the Clause map has no pointer to it.
+  const pointer = result.shown && !context.includes("lane gather show")
+    ? `\nFull Clause map: \`nodii-dev lane gather show ${result.lane.key}\`; one clause in full: \`nodii-dev rules show <ID>\`.`
+    : "";
   return result.shown
-    ? context.trimEnd()
-    : "Freeze re-grounding: no active Dev lane with initialized Freeze was available for this worktree; run `nodii-dev lane freeze show <key>` before continuing.";
+    ? `${context.trimEnd()}${pointer}`
+    : "Freeze re-grounding: no active Dev lane with initialized Freeze was available for this worktree; run `nodii-dev lane freeze show <key>` (and `nodii-dev lane gather show <key>` for its Clause map) before continuing.";
 }
 
 export function workflowSuggestion(payload) {

package/dist/lanes.js

@@ -231,6 +231,16 @@ export async function laneCommand(action, args, flags, { request = devRequest, c
     const payload = await request("POST", `/api/v1/lanes/${encode(key)}/start`, via);
     return { payload, human: (p) => `Started ${laneLine(p.data)}` };
   }
+  // The Freeze references the Clause map rather than holding it (hub-58).
+  if (action === "gather" && args[0] === "show") {
+    // A Gather flag here means a Gather was meant: never show silently instead.
+    const gatherFlags = ["picker", "shortlist", "documents", "delta", "objective", "done-check", "paths", "components", "limit", "section-limit-per-document"].filter((flag) => flags[flag] !== undefined);
+    if (gatherFlags.length)
+      throw new CliError("USAGE", `lane gather show takes only [<key>] [--gather ID]; --${gatherFlags.join(", --")} belong to lane gather.`, 2);
+    const key = need(args[1] ?? await currentGatherLane(request, config, gitContext), "lane gather show needs <key>");
+    const payload = await request("GET", `/api/v1/lanes/${encode(key)}/gather${query({ gatherId: flags.gather })}`);
+    return { payload, human: (p) => `Gather ${p.data.gatherId}\n${gatherText(p, p.data.objective ?? "")}` };
+  }
   const ref = need(args[0] ?? (action === "gather" ? await currentGatherLane(request, config, gitContext) : undefined), `lane ${action} needs <key>`);
   const id = ref;
   if (action === "show") {

package/dist/upload.js

@@ -317,6 +317,15 @@ export async function rulesCommand(action, args, flags, { request = devRequest }
     const payload = await request("GET", `/api/v1/rules/find${query({ question, limit })}`);
     return { payload, human: rulesFindText };
   }
+  if (action === "show") {
+    const id = args[0]?.trim();
+    if (!id) throw new CliError("USAGE", "rules show needs a clause id, for example: nodii-dev rules show S04-7", 2);
+    const payload = await request("GET", `/api/v1/rules/clauses/${encode(id)}`);
+    return {
+      payload,
+      human: (p) => p.data.map((c) => `${c.clauseId}${c.counterInstinct ? " ⚑" : ""} · ${c.documentCode}@${c.documentVersion} › ${c.section}\n${c.text}`).join("\n\n"),
+    };
+  }
   if (action === "core") {
     // Dev refuses a core over the cap with CORE_OVER_CAP; that error is the output.
     const payload = await request("GET", "/api/v1/rules/core");
@@ -347,5 +356,5 @@ export async function rulesCommand(action, args, flags, { request = devRequest }
     const payload = await request("PUT", "/api/v1/rules/core/cap", { cap });
     return { payload, human: (p) => `Core cap: ${p.data.previous} -> ${p.data.cap} tokens.` };
   }
-  throw new CliError("USAGE", 'rules find "QUESTION" [--limit N] | rules core | rules report [--section rulebook|services|all] [--lane KEY] | rules cap TOKENS', 2);
+  throw new CliError("USAGE", 'rules find "QUESTION" [--limit N] | rules show CLAUSE_ID | rules core | rules report [--section rulebook|services|all] [--lane KEY] | rules cap TOKENS', 2);
 }

package/package.json

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