sigrank 1.0.4 → 1.0.6

package/README.md

@@ -1,17 +1,16 @@
-# SigRank SignalAF MCP
+# Upsilon Measurement Engine — `sigrank` CLI/MCP
 
-> **🏆 SigRank SignalAF is live: [signalaf.com](https://signalaf.com)** — the AI operator
-> evaluation leaderboard. Ranks how efficiently you use AI by token cascade
-> efficiency (Υ = cache_read × output / input²), not how much. Run `npx sigrank`
-> to see your cascade now. _Token counts only. Never your prompts._
+> **Upsilon** is SignalAF's measurement engine. **SigRank** is the public leaderboard
+> and proof surface. The existing `sigrank` package name and `sigrank/0.1-draft`
+> record remain stable for compatibility. _Four token counts only. Never prompts or code._
 
 <div align="center">
 
 <p><img src="./.github/assets/og-card.png" alt="SigRank SignalAF — AI operator evaluation and token cascade efficiency leaderboard" width="800"></p>
 
-**The yield cascade + live leaderboard as MCP tools any agent can call.**
+**Upsilon measures. SigRank proves. MO§ES™ governs. SignalAF is the brand.**
 
-SigRank evaluates the human using the AI — not the AI model itself.
+Upsilon describes observable AI operator token-processing patterns—not AI model quality, cognition, work quality, employee productivity, or business value.
 
 [![npm version](https://img.shields.io/npm/v/sigrank.svg?style=flat-square&color=gold)](https://www.npmjs.com/package/sigrank)
 [![CI](https://github.com/SunrisesIllNeverSee/sigrank-mcp/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/SunrisesIllNeverSee/sigrank-mcp/actions/workflows/ci.yml)
@@ -32,7 +31,7 @@ SigRank evaluates the human using the AI — not the AI model itself.
 
 ## Table of Contents
 
-- [The SigRank SignalAF ecosystem](#the-sigrank-signalaf-ecosystem)
+- [SignalAF product architecture](#signalaf-product-architecture)
 - [Quickstart](#quickstart--3-steps-to-the-board)
 - [Install from GitHub](#install-from-github)
 - [Install via Smithery](#install-via-smithery)
@@ -57,12 +56,16 @@ SigRank evaluates the human using the AI — not the AI model itself.
 
 ---
 
-## The SigRank SignalAF ecosystem
+## SignalAF product architecture
+
+```text
+MO§ES™ governance → Upsilon measurement engine → SigRank public proof
+```
 
 | Repo | What it is | Install |
 |------|-----------|---------|
-| **[sigrank-mcp](https://github.com/SunrisesIllNeverSee/sigrank-mcp)** (this repo) | The instrument — extracts 4 token pillars, computes the cascade, submits to the leaderboard. MCP server + TUI dashboard. | `npx sigrank` |
-| **[sigrank-app](https://github.com/SunrisesIllNeverSee/sigrank-app)** | The leaderboard — signalaf.com. Privacy-preserving operator profiles, class tiers, board rankings. | [signalaf.com](https://signalaf.com) |
+| **[sigrank-mcp](https://github.com/SunrisesIllNeverSee/sigrank-mcp)** (this repo) | Upsilon's compatibility instrument—extracts four token pillars, computes locally, and optionally submits to SigRank. | `npx sigrank` |
+| **[sigrank-app](https://github.com/SunrisesIllNeverSee/sigrank-app)** | Upsilon web implementation plus the SigRank leaderboard/proof surface. | [signalaf.com](https://signalaf.com) |
 | **[bestuser-router-mcp](https://github.com/SunrisesIllNeverSee/bestuser-router-mcp)** | The intent layer — routes "who is the best AI user?" queries to SigRank SignalAF's leaderboard. MCP server for AI assistants. | `npx bestuser-router-mcp` |
 | **[sigarena](https://github.com/SunrisesIllNeverSee/sigarena)** | The satellite — public LLM operator evals at sigeconomy.com. Read-only leaderboard, SEO/AEO surface. | [sigeconomy.com](https://sigeconomy.com) |
 | **[signaf](https://github.com/SunrisesIllNeverSee/signa)** | The coach — reads your session logs, builds a taste profile, measures ASI, coaches you on token efficiency. | `npx @burnmydays/signaf` |
@@ -74,7 +77,7 @@ SigRank evaluates the human using the AI — not the AI model itself.
 | Site | What it is |
 | ---- | ---------- |
 | **[SIGNOMY](https://signomy.xyz)** | Governed AI agent marketplace where ranked agents form teams, fill slots, run missions, and earn revenue under constitutional protocol. Agents are free. Operators pay. |
-| **[MO§ES](https://mos2es.com)** | The governance framework that underpins SigRank SignalAF, SIGNOMY, and all governed agent operations. Structural accountability for agentic systems. |
+| **[MO§ES](https://mos2es.com)** | Constitutional governance and methodology—the law governing Upsilon and other governed systems. |
 
 ## Quickstart — 3 steps to the board
 

package/bin/sigrank.mjs

@@ -30,6 +30,12 @@ function printStandard() {
   const payload = {
     spec: SPEC,
     status: "proposed_open_standard",
+    architecture: {
+      brand: "SignalAF",
+      governance: "MO§ES™",
+      product: "Upsilon",
+      leaderboard: "SigRank",
+    },
     scope: "human operation of generative AI systems",
     telemetry: ["input", "output", "cache_write", "cache_read"],
     metrics: {
@@ -42,7 +48,7 @@ function printStandard() {
     privacy:
       "Core metrics do not require prompt text, response text, source code, or repository contents.",
     reference_math: "@sigrank/cascade",
-    reference_platform: "SignalAF",
+    reference_platform: "Upsilon on SignalAF",
     standard_url: STANDARD_URL,
     schema_url: SCHEMA_URL,
   };
@@ -52,13 +58,13 @@ function printStandard() {
     return;
   }
 
-  process.stdout.write(`SigRank Standard ${SPEC}\n`);
-  process.stdout.write(`The new standard in operator metrics.\n\n`);
+  process.stdout.write(`Upsilon measurement engine · compatibility spec ${SPEC}\n`);
+  process.stdout.write(`Upsilon measures. SigRank is the public proof surface.\n\n`);
   process.stdout.write(`Scope: ${payload.scope}\n`);
   process.stdout.write(`Primitives: input / output / cache_write / cache_read\n`);
   process.stdout.write(`Core metrics: Yield / Leverage / Velocity / SNR / 10xDEV\n`);
   process.stdout.write(`Reference math: @sigrank/cascade\n`);
-  process.stdout.write(`Reference platform: SignalAF\n`);
+  process.stdout.write(`Reference platform: Upsilon on SignalAF\n`);
   process.stdout.write(`Spec: ${STANDARD_URL}\n`);
   process.stdout.write(`Schema: ${SCHEMA_URL}\n`);
 }
@@ -69,9 +75,13 @@ async function exportStandardRecord() {
   const platform = flag("platform", "claude");
   const window = flag("window", "30d");
 
-  const explicit = ["input", "output", "cache-write", "cache-read"].every(
-    (name) => flag(name) !== undefined,
-  );
+  const explicitFlags = ["input", "output", "cache-write", "cache-read"];
+  const hasExplicit = explicitFlags.some((name) => flag(name) !== undefined);
+  const explicit = ["input", "output"].every((name) => flag(name) !== undefined);
+
+  if (hasExplicit && !explicit) {
+    throw new Error("Explicit Standard export requires both --input and --output.");
+  }
 
   let pillars;
   let sourcePlatform = platform;
@@ -80,8 +90,8 @@ async function exportStandardRecord() {
     pillars = {
       input: Number(flag("input")),
       output: Number(flag("output")),
-      cache_write: Number(flag("cache-write")),
-      cache_read: Number(flag("cache-read")),
+      cache_write: flag("cache-write") === undefined ? null : Number(flag("cache-write")),
+      cache_read: flag("cache-read") === undefined ? null : Number(flag("cache-read")),
     };
   } else {
     const pulled = await callTool("tokenpull", { platform });
@@ -97,14 +107,14 @@ async function exportStandardRecord() {
     pillars = {
       input: selected.pillars.input,
       output: selected.pillars.output,
-      cache_write: selected.pillars.cacheCreate,
-      cache_read: selected.pillars.cacheRead,
+      cache_write: selected.pillars.cacheCreate ?? null,
+      cache_read: selected.pillars.cacheRead ?? null,
     };
   }
 
   for (const [key, value] of Object.entries(pillars)) {
-    if (!Number.isFinite(value) || value < 0) {
-      throw new Error(`${key} must be a non-negative finite number.`);
+    if (value !== null && (!Number.isFinite(value) || !Number.isInteger(value) || value < 0)) {
+      throw new Error(`${key} must be a non-negative integer token count or null.`);
     }
   }
 

package/index.mjs

@@ -102,7 +102,7 @@ async function startMcpServer() {
     {
       name: "check-my-efficiency",
       description:
-        "Pull your local token usage, compute your SigRank yield, and compare your efficiency against the leaderboard. Shows your class tier (ARCH+ to IGNITER) and where you rank.",
+        "Use Upsilon to pull local token telemetry and compute Yield, then compare the result against the SigRank public leaderboard. Shows your class tier (ARCH+ to IGNITER) and where you rank.",
       arguments: [],
     },
     {
@@ -189,7 +189,7 @@ async function startMcpServer() {
   const RESOURCES = [
     {
       uri: "sigrank://scoring-formula",
-      name: "SigRank Scoring Formula",
+      name: "Upsilon Measurement Formula",
       description:
         "The yield cascade formula and all derived metrics: Υ (Yield = Cache Reads × Output / Input²), SNR (signal-to-noise), Leverage (Cr/I), Velocity (O/I), 10xDEV score, and class tier thresholds (8-tier experience ladder, see class-tiers.md).",
       mimeType: "text/markdown",
@@ -210,16 +210,16 @@ async function startMcpServer() {
     },
     {
       uri: "sigrank://privacy-model",
-      name: "Privacy Model",
+      name: "Upsilon Privacy Model",
       description:
-        "How SigRank protects user privacy: runs locally, only four token counts (input, output, cacheCreate, cacheRead) leave the machine, ed25519-signed submissions, no prompt content ever transmitted.",
+        "How Upsilon protects user privacy: runs locally, only four token counts (input, output, cacheCreate, cacheRead) leave the machine, ed25519-signed submissions, no prompt content ever transmitted.",
       mimeType: "text/markdown",
     },
     {
       uri: "sigrank://data-policy",
       name: "Data Policy",
       description:
-        "Summary of SigRank data governance: what we collect, what we do not collect, consent requirements, and how to pause, delete, or export your data.",
+        "Summary of Upsilon measurement-data governance: what is collected, what is not collected, consent requirements, and how to pause, delete, or export data.",
       mimeType: "text/markdown",
     },
   ];

package/manifest.json

@@ -2,7 +2,7 @@
   "$schema": "https://raw.githubusercontent.com/anthropics/mcpb/main/schemas/mcpb-manifest-v0.4.schema.json",
   "manifest_version": "0.4",
   "name": "sigrank",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Ranks AI coding operators by token cascade efficiency (Yield = cache_read \u00d7 output / input\u00b2). 25 tools including SigRank Standard record, yield calculation, local token usage pulls, signed submission, and tokscale-powered analytics (market share, developer profiles, model trends, cost analysis, device profiles, MCP usage, competitive intelligence). Privacy-first: runs locally, only four token counts leave the machine.",
   "author": {
     "name": "SunrisesIllNeverSee",

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "sigrank",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "author": "SunrisesIllNeverSee (https://github.com/SunrisesIllNeverSee)",
-  "description": "SigRank MCP server — AI operator evaluation and token cascade efficiency tools. The yield cascade + live leaderboard as MCP tools any agent can call.",
+  "description": "Upsilon measurement engine distributed through the sigrank CLI/MCP compatibility package, with SigRank public leaderboard tools.",
   "mcpName": "io.github.SunrisesIllNeverSee/sigrank-mcp",
   "type": "module",
   "license": "MIT",
@@ -24,7 +24,7 @@
   },
   "scripts": {
     "start": "node index.mjs",
-    "test": "node test.mjs && node __tests__/sign.test.mjs && node --test __tests__/cascade.test.mjs __tests__/badges.test.mjs __tests__/tui-input.test.mjs __tests__/standard-record.test.mjs __tests__/standard-cli.test.mjs",
+    "test": "node test.mjs && node __tests__/sign.test.mjs && node --test __tests__/cascade.test.mjs __tests__/badges.test.mjs __tests__/tui-input.test.mjs __tests__/standard-record.test.mjs __tests__/standard-cli.test.mjs __tests__/product-architecture.test.mjs",
     "test:packaged": "node scripts/packed-artifact-smoke.mjs",
     "sync:platforms": "node scripts/sync-platforms.mjs",
     "sync:spine": "node scripts/sync-spine.mjs",

package/resources/data-policy.md

@@ -1,17 +1,17 @@
-# SigRank Data Policy
+# Upsilon Measurement and SigRank Publication Data Policy
 
-SigRank is a public AI-operator leaderboard. This policy summarizes what data we collect, how we use it, and how you can delete it.
+Upsilon is the measurement engine; SigRank is the public AI-operator leaderboard and proof surface. This policy summarizes what data is collected, how it is used, and how you can delete it.
 
 ## What we collect
 
-- **Token telemetry** from your local agent: token counts, content lengths, model identifiers, and platform/source tags. We use these to compute your score on the leaderboard.
+- **Token telemetry** from your local instrument: token counts, model identifiers, and platform/source tags. Upsilon uses these to compute measurements; publication to SigRank is a separate action.
 - **Account identifiers** when you sign in (email from your OAuth provider) so we can link your operator profile to your login.
 - **Optional profile fields** you choose to add: display name, handle, bio, location, links, avatar.
 
 ## What we never collect
 
 We do **not** collect or receive the content of your prompts or AI conversations
-at the SigRank service. Local-log adapters extract only numeric usage metadata.
+at the Upsilon service. Local-log adapters extract only numeric usage metadata.
 If you explicitly run the optional local API proxy, it forwards provider-bound
 requests and responses in memory but does not persist their content; only usage
 metadata is written locally or submitted to SigRank.

package/resources/privacy-model.md

@@ -1,4 +1,4 @@
-# SigRank Privacy Model
+# Upsilon Privacy Model
 
 ## What leaves your machine
 
@@ -10,8 +10,8 @@
 
 That's the entire payload — no prompts, no code, no file contents, no conversation text. The MCP parses your input locally and sends only the four token counts to the server, which re-parses and re-scores them authoritatively.
 
-The optional `sigrank proxy` is a local transport path to Anthropic/OpenAI, not a
-submission path to SigRank. When explicitly enabled, it necessarily receives and
+The optional `sigrank proxy` is a local Upsilon transport path to Anthropic/OpenAI, not a
+submission path to the SigRank leaderboard. When explicitly enabled, it necessarily receives and
 forwards provider-bound API keys, prompts, tool calls, and responses in memory.
 It does not persist that content or send it to the SigRank service; it appends
 only provider-reported token counts, model/backend metadata, and timestamps to
@@ -22,12 +22,12 @@ only provider-reported token counts, model/backend metadata, and timestamps to
 
 ## How it works
 
-1. **Local-first:** All token pulling happens on your machine. SigRank reads session logs from ~/.claude, ~/.codex, ~/.local/share/amp, etc. The optional proxy also runs only on loopback and only when manually started.
+1. **Local-first:** All token pulling happens on your machine. Upsilon reads usage metadata from session logs in ~/.claude, ~/.codex, ~/.local/share/amp, etc. The optional proxy also runs only on loopback and only when manually started.
 2. **Token-only persistence:** Local-log adapters extract integer counts from log metadata without reading conversation content. The optional proxy forwards request/response bytes transiently but persists only usage metadata. On the paste path, the MCP parses the paste locally and sends only the four extracted numbers — the raw paste text stays on your machine.
 3. **Signed submission:** Ranked submissions (`submit_verified`, `watch_tokenpull` with `submit:true`) are ed25519-signed with a device-bound key generated locally at enrollment. The board verifies the signature without seeing your data. Paste submissions (`submit_paste`, `tokenpull_submit`) are unsigned and go through the web-paste endpoint with a codename only — but still send only the four token counts, not the raw paste.
 4. **Read tools need no auth:** No API keys, no OAuth, no account needed to read the leaderboard or operator profiles. **Enrollment requires a connect code** from signalaf.com → Settings → New key (the code binds your device's public key to your operator server-side); a codename alone is not enough for the signed/ranked path.
 
-## What the SigRank service can NOT see
+## What the Upsilon service can NOT see
 
 - Your prompts or messages
 - Your code or file contents
@@ -35,7 +35,7 @@ only provider-reported token counts, model/backend metadata, and timestamps to
 - Which AI platform you use (beyond token counts)
 - Your identity (only your chosen codename)
 
-The local proxy process is different from the SigRank service: if you opt in, it
+The local proxy process is different from the Upsilon service: if you opt in, it
 handles your provider traffic in memory solely to forward it to Anthropic or
 OpenAI. That content is never stored in the proxy JSONL file.
 

package/resources/scoring-formula.md

@@ -1,4 +1,6 @@
-# SigRank Scoring Formula
+# Upsilon Measurement Formulas
+
+Upsilon is the measurement engine. SigRank is the public leaderboard and proof surface. The installed package and resource URI retain the `sigrank` name for compatibility.
 
 ## Yield (Υ) — the headline metric
 
@@ -6,19 +8,19 @@
 Υ = Cache Reads × Output / Input²
 ```
 
-Yield rewards operators who maximize output while minimizing input — and who build cache to amortize that input across sessions. A high yield means you're getting more done with less, efficiently.
+Yield describes the compound relationship between context reuse and output relative to fresh input. It does not, by itself, prove work quality or productivity.
 
 ## Derived Metrics
 
 | Metric | Formula | Meaning |
 |--------|---------|---------|
-| **SNR** | Output / (Input + CacheCreate) | Signal-to-noise: how much of your token spend is productive output vs. overhead |
-| **Leverage** | Cache Reads / Input | How well you reuse cached context — higher = better cache utilization |
-| **Velocity** | Output / Input | Raw output efficiency — how much output you generate per token of input |
-| **10xDEV** | Composite score | Weighted blend of yield, leverage, and velocity for cross-platform comparison |
+| **SNR** | Output / (Input + Output) | Output share of the direct input/output exchange |
+| **Leverage** | Cache Reads / Input | Cache-read context relative to fresh input |
+| **Velocity** | Output / Input | Output tokens relative to fresh input |
+| **10xDEV** | log₁₀(Cache Reads / Input) | Log-scale Leverage under the reference null policy |
 
 ## Class Tiers
 
-Class tiers are based on **total tokens accumulated**, not yield ranges. The 8-tier experience ladder (descending: ARCH+, ARCH, POWER, BASE, SEEKER, REFINER, BEARER, IGNITER) measures operator progression. TRANSMITTER is a separate peak badge (K.00), not a ladder tier. See `class-tiers.md` for the full ladder and thresholds.
+Class is a SignalAF/SigRank reference qualification layer, not a portable Upsilon metric and not the same thing as archetype or rank. TRANSMITTER is a separate peak badge (K.00), not a ladder tier. See `class-tiers.md` for the current product policy.
 
 The formula is deterministic and computed locally. No network calls needed for scoring.

package/tools/standard-record.mjs

@@ -2,13 +2,20 @@ import { cascade } from "../analytics/cascade.mjs";
 import { ANNOTATIONS } from "./_schemas.mjs";
 
 export const SIGRANK_STANDARD_VERSION = "sigrank/0.1-draft";
+export const PRODUCT_ARCHITECTURE = Object.freeze({
+  brand: "SignalAF",
+  governance: "MO§ES™",
+  product: "Upsilon",
+  leaderboard: "SigRank",
+  wire_spec: SIGRANK_STANDARD_VERSION,
+});
 
 export const TOOL_DEF = {
   name: "get_sigrank_standard_record",
   description:
-    "Build a SigRank Standard v0.1-draft portable operator record from four token pillars. Computes the canonical cascade locally through @sigrank/cascade and returns versioned telemetry plus the normative core metrics: Yield, Leverage, Velocity, SNR, and 10xDEV. No data is submitted or persisted. The core record contains token telemetry only and does not require prompt text, code, or response content.",
+    "Build Upsilon's portable sigrank/0.1-draft compatibility record from available token telemetry. Input and output are required; unavailable cache telemetry remains null. Computes the canonical cascade locally through @sigrank/cascade and returns Yield, Leverage, Velocity, SNR, and 10xDEV. Upsilon is the measurement product; SigRank is the public leaderboard. No data is submitted or persisted.",
   annotations: {
-    title: "Export SigRank standard record",
+    title: "Export Upsilon measurement record",
     ...ANNOTATIONS.readOnlyHint,
     ...ANNOTATIONS.destructiveHint,
     ...ANNOTATIONS.idempotentHint,
@@ -17,26 +24,29 @@ export const TOOL_DEF = {
   inputSchema: {
     type: "object",
     additionalProperties: false,
-    required: ["input", "output", "cache_write", "cache_read"],
+    required: ["input", "output"],
     properties: {
-      input: { type: "number", minimum: 0, description: "Fresh input tokens." },
-      output: { type: "number", minimum: 0, description: "Output tokens." },
-      cache_write: { type: "number", minimum: 0, description: "Cache-write / cache-creation tokens." },
-      cache_read: { type: "number", minimum: 0, description: "Cache-read tokens." },
+      input: { type: "integer", minimum: 0, description: "Fresh input tokens." },
+      output: { type: "integer", minimum: 0, description: "Output tokens." },
+      cache_write: { type: ["integer", "null"], minimum: 0, description: "Cache-write / cache-creation tokens, or null when unavailable." },
+      cache_read: { type: ["integer", "null"], minimum: 0, description: "Cache-read tokens, or null when unavailable." },
       provider: { type: "string", description: "Optional provider identifier." },
       model: { type: "string", description: "Optional model identifier." },
       tool: { type: "string", description: "Optional tool/client identifier." },
-      timestamp: { type: "string", description: "Optional ISO-8601 timestamp. Defaults to the current time." }
+      timestamp: { type: "string", format: "date-time", description: "Optional ISO-8601 timestamp. Defaults to the current time." }
     }
   },
   outputSchema: {
     type: "object",
-    required: ["spec", "timestamp", "source", "telemetry", "metrics"],
+    additionalProperties: false,
+    required: ["spec", "timestamp", "source", "telemetry", "metrics", "warnings"],
     properties: {
-      spec: { type: "string", description: "SigRank specification version." },
-      timestamp: { type: "string", description: "ISO-8601 record timestamp." },
+      spec: { const: SIGRANK_STANDARD_VERSION, description: "SigRank specification version." },
+      timestamp: { type: "string", format: "date-time", description: "ISO-8601 record timestamp." },
       source: {
         type: "object",
+        additionalProperties: false,
+        required: ["provider", "model", "tool"],
         properties: {
           provider: { type: "string" },
           model: { type: "string" },
@@ -45,15 +55,19 @@ export const TOOL_DEF = {
       },
       telemetry: {
         type: "object",
+        additionalProperties: false,
+        required: ["input", "output", "cache_write", "cache_read"],
         properties: {
-          input: { type: "number" },
-          output: { type: "number" },
-          cache_write: { type: "number" },
-          cache_read: { type: "number" }
+          input: { type: "integer", minimum: 0 },
+          output: { type: "integer", minimum: 0 },
+          cache_write: { type: ["integer", "null"], minimum: 0 },
+          cache_read: { type: ["integer", "null"], minimum: 0 }
         }
       },
       metrics: {
         type: "object",
+        additionalProperties: false,
+        required: ["yield", "leverage", "velocity", "snr", "dev10x"],
         properties: {
           yield: { type: ["number", "null"] },
           leverage: { type: ["number", "null"] },
@@ -67,24 +81,48 @@ export const TOOL_DEF = {
   }
 };
 
-export async function handleGetSigRankStandardRecord(args) {
-  const input = Number(args?.input);
-  const output = Number(args?.output);
-  const cacheWrite = Number(args?.cache_write);
-  const cacheRead = Number(args?.cache_read);
+const ISO_DATE_TIME =
+  /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/;
 
-  if (![input, output, cacheWrite, cacheRead].every(Number.isFinite)) {
-    throw new Error("get_sigrank_standard_record requires four finite numeric token pillars.");
+function tokenCount(value, name, required) {
+  if (value === null || value === undefined) {
+    if (required) throw new Error(`${name} is required.`);
+    return null;
   }
-  if ([input, output, cacheWrite, cacheRead].some((v) => v < 0)) {
-    throw new Error("get_sigrank_standard_record requires non-negative token pillars.");
+  if (typeof value !== "number" || !Number.isFinite(value) || !Number.isInteger(value)) {
+    throw new Error(`${name} must be a non-negative integer token count.`);
+  }
+  if (value < 0) throw new Error(`${name} must be a non-negative integer token count.`);
+  return value;
+}
+
+function recordTimestamp(value) {
+  if (value === undefined) return new Date().toISOString();
+  if (typeof value !== "string" || !ISO_DATE_TIME.test(value) || !Number.isFinite(Date.parse(value))) {
+    throw new Error("timestamp must be a valid ISO-8601 date-time.");
   }
+  return value;
+}
+
+export async function handleGetSigRankStandardRecord(args) {
+  const input = tokenCount(args?.input, "input", true);
+  const output = tokenCount(args?.output, "output", true);
+  const cacheWrite = tokenCount(args?.cache_write, "cache_write", false);
+  const cacheRead = tokenCount(args?.cache_read, "cache_read", false);
 
-  const c = cascade({ input, output, cacheCreate: cacheWrite, cacheRead });
+  const c = cascade({
+    input,
+    output,
+    cacheCreate: cacheWrite ?? 0,
+    cacheRead: cacheRead ?? 0,
+  });
+  const warnings = [...(c.warnings || [])];
+  if (cacheWrite === null) warnings.push("cache_write is unavailable; 10xDEV is undefined.");
+  if (cacheRead === null) warnings.push("cache_read is unavailable; Yield, Leverage, and 10xDEV are undefined.");
 
   return {
     spec: SIGRANK_STANDARD_VERSION,
-    timestamp: args?.timestamp || new Date().toISOString(),
+    timestamp: recordTimestamp(args?.timestamp),
     source: {
       provider: args?.provider || "unknown",
       model: args?.model || "unknown",
@@ -97,12 +135,12 @@ export async function handleGetSigRankStandardRecord(args) {
       cache_read: cacheRead,
     },
     metrics: {
-      yield: c.yield,
-      leverage: c.leverage,
+      yield: cacheRead === null ? null : c.yield,
+      leverage: cacheRead === null ? null : c.leverage,
       velocity: c.velocity,
       snr: c.snr,
-      dev10x: c.dev10x,
+      dev10x: cacheWrite === null || cacheRead === null ? null : c.dev10x,
     },
-    warnings: c.warnings || [],
+    warnings,
   };
 }