sigrank 0.0.181 → 0.0.183

package/tools/optimize-efficiency.mjs

@@ -3,12 +3,15 @@
  */
 
 import { cascade, parsePillars } from "../analytics/cascade.mjs";
-import { ANNOTATIONS } from "./_schemas.mjs";
+import { ANNOTATIONS, CLASS_ENUM } from "./_schemas.mjs";
 import { MAX_INPUT, withParseWarnings } from "./_helpers.mjs";
+import { LEADERBOARD_METRIC } from "../lib/constants.mjs";
 import {
   _improvementSuggestion,
   _competitiveLayer,
   _competitiveSummary,
+  FALLBACK_CLASS,
+  bandOf,
 } from "./_framing.mjs";
 
 export const TOOL_DEF = {
@@ -43,7 +46,7 @@ export const TOOL_DEF = {
           yield_: { type: "number" },
           leverage: { type: "number" },
           velocity: { type: "number" },
-          class: { type: "string", enum: ["Burner", "Builder", "10xer"] },
+          class: { type: "string", enum: CLASS_ENUM },
         },
       },
       suggestions: {
@@ -92,7 +95,7 @@ export async function handleOptimizeEfficiency(args, ctx) {
     };
   }
 
-  const klass = metrics.class || "Burner";
+  const klass = metrics.class || FALLBACK_CLASS;
   const l = metrics.leverage || 0;
   const v = metrics.velocity || 0;
   const y = metrics.yield_ || 0;
@@ -114,7 +117,14 @@ export async function handleOptimizeEfficiency(args, ctx) {
       power_user_practice: "Power users maximize output per session — they ask AI to generate, transform, and produce, not just explain.",
     });
   }
-  if (l >= 5 && v >= 1 && klass !== "10xer") {
+  // Top-band tiers (apex/high) already have leverage + velocity — the
+  // "extend session" suggestion is for mid/early/entry operators whose
+  // leverage and velocity are both solid but not yet at the top. The legacy
+  // `klass !== "10xer"` guard never matched because the classifier emits the
+  // 8-tier dev10x names, not "10xer" — so this branch fired for EVERY
+  // operator including top-tier ones. Now keyed off the canonical bands.
+  const TOP_BANDS = new Set(["apex", "high"]);
+  if (l >= 5 && v >= 1 && !TOP_BANDS.has(bandOf(klass))) {
     suggestions.push({
       action: "Extend session length to compound cached context further",
       why: "Your leverage (" + l.toFixed(1) + "×) and velocity (" + v.toFixed(2) + ") are solid. Longer sessions with consistent context will push your yield higher.",
@@ -132,7 +142,7 @@ export async function handleOptimizeEfficiency(args, ctx) {
   const summary = `Your Υ Yield is ${y.toLocaleString()} (${klass}). ${_improvementSuggestion(klass, metrics)}`;
 
   // Competitive layer per SHARED_DESIGN_DECISIONS.md §3/§4/§5
-  const board = await ctx.fetchJson("/api/v1/leaderboard?metric=yield_");
+  const board = await ctx.fetchJson(`/api/v1/leaderboard?metric=${LEADERBOARD_METRIC}`);
   const competitive = _competitiveLayer(metrics, board);
   const competitiveSummary = _competitiveSummary(metrics, board);
 

package/tools/rank-paste.mjs

@@ -10,7 +10,7 @@ import { MAX_INPUT, withParseWarnings } from "./_helpers.mjs";
 export const TOOL_DEF = {
   name: "rank_paste",
   description:
-    'Computes the SigRank yield cascade from a paste of token counts. Parses the input, runs the full cascade math locally (no network calls), and returns: Υ Yield (the headline efficiency metric, Υ = Cache Reads × Output / Input²), SNR (signal-to-noise ratio), Leverage ratio (Cr/I = cache reads divided by input), Velocity (O/I = output divided by input), 10xDEV score, operator class tier (Burner / Builder / 10xer), and a deterministic prose "card" summarizing the result in plain English. Accepts two input formats: (1) JSON object {"input":N,"output":N,"cacheCreate":N,"cacheRead":N} or (2) four whitespace-separated numbers in order: input output cacheCreate cacheRead. Returns an error if the input is malformed or has negative values. Use this for a quick one-off ranking without submitting to the board. Do NOT use this to submit your score — use submit_paste instead, which both ranks and publishes. Do NOT use this if you want to rank all four time windows at once — use rank_windows for that. After calling this, use submit_paste to publish the result if you want to appear on the leaderboard.',
+    'Computes the SigRank yield cascade from a paste of token counts. Parses the input, runs the full cascade math locally (no network calls), and returns: yield (Υ, the headline efficiency metric, Υ = Cache Reads × Output / Input²), snr (signal-to-noise ratio), leverage (Cr/I = cache reads divided by input), velocity (O/I = output divided by input), dev10x (10xDEV score), class (operator experience stage — 24 stages = 8 tiers × 3 sub-stages I/II/III, e.g. ARCH+ I, REFINER II, IGNITER III, or UNCLASSED for empty input), mode (detected working mode), and a deterministic prose "card" summarizing the result in plain English. Accepts two input formats: (1) JSON object {"input":N,"output":N,"cacheCreate":N,"cacheRead":N} or (2) four whitespace-separated numbers in order: input output cacheCreate cacheRead. Returns an error if the input is malformed or has negative values. Use this for a quick one-off ranking without submitting to the board. Do NOT use this to submit your score — use submit_paste instead, which both ranks and publishes. Do NOT use this if you want to rank all four time windows at once — use rank_windows for that. After calling this, use submit_paste to publish the result if you want to appear on the leaderboard.',
   annotations: {
     title: "Rank a paste",
     ...ANNOTATIONS.readOnlyHint,

package/tools/self-improve.mjs

@@ -159,7 +159,7 @@ export async function handleSelfImprove(args, ctx) {
     diagnosis.push({
       metric: "cache_leverage",
       severity: "critical",
-      finding: `Cache leverage is ${leverage}× — TRANSMITTER-class operators hit 200×+.`,
+      finding: `Cache leverage is ${leverage}× — top-tier operators hit 200×+.`,
       recommendation:
         "Increase context reuse: load prior session context, use longer threads.",
     });

package/tools/submit-paste.mjs

@@ -10,6 +10,7 @@ import {
   uploadStamp,
   withParseWarnings,
 } from "./_helpers.mjs";
+import { TERMS_VERSION, PRIVACY_VERSION, isRankedAck } from "../lib/constants.mjs";
 
 export const TOOL_DEF = {
   name: "submit_paste",
@@ -73,8 +74,14 @@ export async function handleSubmitPaste(args, ctx) {
     };
   }
 
-  // Submit the RAW paste so the server re-parses + re-scores authoritatively — the
-  // MCP's local cascade is only a preview; the board stays the single source of truth.
+  // Privacy: send ONLY the 4 parsed token numbers (canonical "input output
+  // cacheCreate cacheRead" form), never the raw user text. parsePillars above
+  // already validated the input — we reconstruct from the parsed pillars so
+  // no conversation content or prose can leak to the server. The server's
+  // ingestMeta() re-parses these 4 numbers authoritatively (Strategy 3:
+  // four bare numbers). This makes every submit path — signed and paste —
+  // send only token counts.
+  const canonicalPaste = `${pillars.input} ${pillars.output} ${pillars.cacheCreate} ${pillars.cacheRead}`;
   const stamp = uploadStamp({
     codename,
     pillars: c.pillars,
@@ -88,10 +95,10 @@ export async function handleSubmitPaste(args, ctx) {
     },
     body: JSON.stringify({
       codename,
-      raw_paste: String(args?.text || ""),
+      raw_paste: canonicalPaste,
       consent_acknowledged: true,
-      terms_version: "2026-07-21",
-      privacy_version: "2026-07-21",
+      terms_version: TERMS_VERSION,
+      privacy_version: PRIVACY_VERSION,
       ...stamp,
     }),
   });
@@ -104,11 +111,7 @@ export async function handleSubmitPaste(args, ctx) {
       detail: `HTTP ${res.status} (non-JSON response)`,
     };
   }
-  const ranked = !!(
-    res.ok &&
-    ack.verification_tier === "verified" &&
-    ack.persisted === true
-  );
+  const ranked = isRankedAck(res, ack);
   return {
     ...c,
     card,

package/tools/tokenpull-submit.mjs

@@ -12,6 +12,7 @@ import {
   uploadStamp,
   WINDOW_TYPE,
 } from "./_helpers.mjs";
+import { TERMS_VERSION, PRIVACY_VERSION, isRankedAck } from "../lib/constants.mjs";
 
 export const TOOL_DEF = {
   name: "tokenpull_submit",
@@ -131,8 +132,8 @@ export async function handleTokenpullSubmit(args, ctx) {
           window_type: windowType,
           telemetry: { platform: { primary: "multi" } },
           consent_acknowledged: true,
-          terms_version: "2026-07-21",
-          privacy_version: "2026-07-21",
+          terms_version: TERMS_VERSION,
+          privacy_version: PRIVACY_VERSION,
           ...stamp,
         }),
       });
@@ -142,7 +143,11 @@ export async function handleTokenpullSubmit(args, ctx) {
       } catch {
         ack = { status: "parse_error", httpStatus: res.status };
       }
-      const ranked = ack?.ranked ?? ack?.accepted ?? false;
+      // Fix 4: was `ack?.ranked ?? ack?.accepted ?? false` — a looser predicate
+      // than the single-platform branch below, which would mark a non-persisted
+      // 202 as ranked. Now both branches use the shared isRankedAck() so every
+      // submit path agrees on what "ranked" means.
+      const ranked = isRankedAck(res, ack);
       out.push({
         window: wk,
         pillars: sum,
@@ -198,8 +203,8 @@ export async function handleTokenpullSubmit(args, ctx) {
         window_type: windowType,
         telemetry: { platform: { primary: pulled.platform } },
         consent_acknowledged: true,
-        terms_version: "2026-07-21",
-        privacy_version: "2026-07-21",
+        terms_version: TERMS_VERSION,
+        privacy_version: PRIVACY_VERSION,
         ...stamp,
       }),
     });
@@ -211,11 +216,7 @@ export async function handleTokenpullSubmit(args, ctx) {
     }
     // ranked = actually on the board (verified + persisted), not just received — parity
     // with submit_verified (submit/index.mjs). An unenrolled/revoked device gets 202 but is NEVER ranked.
-    const ranked = !!(
-      res.ok &&
-      ack.verification_tier === "verified" &&
-      ack.persisted === true
-    );
+    const ranked = isRankedAck(res, ack);
     out.push({
       window: w.window,
       pillars: w.pillars,

package/tools/tokscale-breakdown.mjs

@@ -4,6 +4,7 @@
 
 import { execFileAsync } from "./_helpers.mjs";
 import { ANNOTATIONS } from "./_schemas.mjs";
+import { TOKSCALE_CLIENT_MAP } from "../lib/constants.mjs";
 
 export const TOOL_DEF = {
   name: "tokscale_breakdown",
@@ -36,48 +37,7 @@ export const TOOL_DEF = {
   },
 };
 
-const TOKSCALE_CLIENT_MAP = {
-  claude: "claude",
-  codex: "codex",
-  "devin-cli": "devin",
-  "devin-desktop": "devin",
-  gemini: "gemini",
-  amp: "amp",
-  kimi: "kimi",
-  qwen: "qwen",
-  goose: "goose",
-  kilo: "kilo",
-  kilocode: "kilo",
-  hermes: "hermes",
-  droid: "droid",
-  codebuff: "codebuff",
-  copilot: "copilot",
-  opencode: "opencode",
-  openclaw: "openclaw",
-  pi: "pi",
-  cursor: "other",
-  roocode: "other",
-  mux: "other",
-  crush: "other",
-  antigravity: "other",
-  "antigravity-cli": "other",
-  zed: "other",
-  kiro: "other",
-  trae: "other",
-  warp: "other",
-  cline: "other",
-  gjc: "other",
-  grok: "other",
-  jcode: "other",
-  commandcode: "other",
-  micode: "other",
-  junie: "other",
-  zcode: "other",
-  opencodereview: "other",
-  codebuddy: "other",
-  workbuddy: "other",
-  synthetic: null,
-};
+// TOKSCALE_CLIENT_MAP is imported from lib/constants.mjs (single source of truth).
 
 /**
  * Run `tokscale models --json` and return a model-level breakdown per platform.