sigrank 1.0.23 → 1.0.25

package/README.md

@@ -330,14 +330,18 @@ Or if installed globally:
 ## Cascade math
 
 ```
-Υ Yield    = (cache_read × output) / input²
-SNR        = output / (input + output)
-Leverage   = cache_read / input
-Velocity   = output / input
-10xDEV     = log₁₀(leverage)
+Υ Yield    = (cache_read × output) / input²       (TTEOP canonical)
+SNR        = output / (input + output)            (display alias for output_fraction)
+Leverage   = cache_read / input                   (TTEOP canonical)
+Velocity   = output / input                       (TTEOP canonical)
+10xDEV     = log₁₀(leverage)                      (display alias for log_leverage)
 ```
 
-Math is in `cascade.mjs`, dependency-free. Mirrors `sigrank-app/lib/ingest/bridge.ts`.
+Canonical metric computation is delegated to [`tteop-spec`](https://www.npmjs.com/package/tteop-spec)
+via [`@sigrank/cascade`](https://www.npmjs.com/package/@sigrank/cascade). SNR
+and 10xDEV are SigRank display aliases for the TTEOP metrics `output_fraction`
+and `log_leverage` respectively. See `TTEOP-IMPLEMENTATION-PROFILE.md` for the
+full authority chain.
 Canon check: `MO§ES (1251211, 11296121, 128196310, 2555179769) → Υ 18436.98`.
 
 ---
@@ -455,7 +459,7 @@ Tests verify (14 groups, 313 assertions):
 | `proxy.mjs`     | Opt-in loopback Anthropic/OpenAI proxy and usage capture                |
 | `cli.mjs`       | CLI commands: board, compare, watch, enroll, submit, help               |
 | `tui.mjs`       | Full tabbed TUI: Dashboard / Trends / Compare / Board / Watch / Connect |
-| `cascade.mjs`   | Pure cascade math (Υ, SNR, leverage, velocity, 10xDEV, class)           |
+| `cascade.mjs`   | Cascade facade — delegates to `@sigrank/cascade` → `tteop-spec` (Υ, SNR, leverage, velocity, 10xDEV, class) |
 | `tokenpull.mjs` | On-device log scanner — Claude, Codex, multi-platform                   |
 | `adapters.mjs`  | Platform adapter registry (16+ platforms)                               |
 | `tools.mjs`     | MCP tool table + dispatcher                                             |

package/analytics/cascade.mjs

@@ -2,8 +2,9 @@
  * cascade.mjs — SigRank yield cascade facade.
  *
  * The canonical cascade math (Υ Yield, SNR, Leverage, Velocity, 10xDEV, and the
- * 24-stage RS05 class taxonomy) now lives in the `@sigrank/cascade` package.
- * This file re-exports the canonical functions and adds local-only helpers that
+ * 24-stage RS05 class taxonomy) lives in the `@sigrank/cascade` package, which
+ * delegates canonical TTEOP metric computation to `tteop-spec`. This file
+ * re-exports the canonical functions and adds local-only helpers that
  * are presentation/MCP-specific and intentionally NOT part of the canonical
  * math package:
  *   - CLASS_TIERS, SIGNAL_CLASSES, UNCLASSED  (display taxonomy)
@@ -11,6 +12,8 @@
  *   - detectMode(), MODE_EXPECTED_YIELD, qualityScore()  (mode/quality layer)
  *   - parsePillars()                           (text → 4 pillars extractor)
  *
+ * Authority chain: sigrank-mcp → @sigrank/cascade → tteop-spec
+ *
  * The cascade() wrapper preserves the object-signature
  * ({ input, output, cacheCreate, cacheRead }) used throughout this repo and
  * re-attaches the `mode` field (detectMode) that the canonical package
@@ -19,7 +22,7 @@
  *
  * Canonical reference: MO§ES Υ 18436.98 from (1251211, 11296121, 128196310, 2555179769).
  *
- * Degenerate-input policy (inherited from the canonical package):
+ * Degenerate-input policy (inherited from tteop-spec via @sigrank/cascade):
  *   - Any pillar that collapses a denominator (i=0, o=0, cw=0, cr=0) returns null for
  *     the affected metrics rather than Infinity/NaN.
  *   - A `warnings[]` array is attached when any metric is null so callers can surface the
@@ -57,10 +60,15 @@ export {
  * The four raw token pillars → the cascade.
  *
  * Object-signature wrapper around the canonical `@sigrank/cascade` cascade()
- * (which takes positional args). Re-attaches the `mode` field via detectMode()
- * so the 20+ call sites in this repo that read `result.mode` keep working.
+ * (which takes positional args). Accepts null for cacheCreate/cacheRead
+ * (unavailable cache) and passes null through to tteop-spec via cascade.
+ * Re-attaches the `mode` field via detectMode() so the 20+ call sites in
+ * this repo that read `result.mode` keep working.
  */
 export function cascade({ input, output, cacheCreate, cacheRead }) {
+  // Pass null through to cascade (→ tteop-spec) for canonical null semantics.
+  // detectMode receives the raw values (Number(null) = 0, which is fine for
+  // mode classification).
   const result = cascadeCanonical(input, output, cacheCreate, cacheRead);
   // Re-attach mode — the canonical package intentionally omits it (mode is a
   // presentation-layer concern, not canonical math).

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.22",
+  "version": "1.0.24",
   "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,6 +1,6 @@
 {
   "name": "sigrank",
-  "version": "1.0.23",
+  "version": "1.0.25",
   "author": "SunrisesIllNeverSee (https://github.com/SunrisesIllNeverSee)",
   "description": "Upsilon measurement engine distributed through the sigrank CLI/MCP compatibility package, with SigRank public leaderboard tools.",
   "mcpName": "io.github.SunrisesIllNeverSee/sigrank-mcp",
@@ -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 __tests__/product-architecture.test.mjs",
+    "test": "node test.mjs && node --test __tests__/sign.test.mjs __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 __tests__/tteop-delegation.test.mjs",
     "test:packaged": "node scripts/packed-artifact-smoke.mjs",
     "sync:platforms": "node scripts/sync-platforms.mjs",
     "sync:spine": "node scripts/sync-spine.mjs",
@@ -85,9 +85,10 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "@sigrank/cascade": "^0.1.1",
+    "@sigrank/cascade": "^0.2.1",
     "ccusage": "^20.0.19",
-    "tokscale": "^4.7.0"
+    "tokscale": "^4.7.0",
+    "tteop-spec": "0.1.5-draft"
   },
   "devDependencies": {
     "@resvg/resvg-js": "^2.6.2",

package/tools/describe-power-user.mjs

@@ -55,7 +55,7 @@ export async function handleDescribePowerUser() {
     metrics_explained: {
       yield_: "Yield (Υ) measures how well you compound signal, not how much you burn. High yield = your cached context is doing work for you.",
       leverage: "Leverage (Cr/I) measures how much you reuse prior work vs starting fresh. High leverage = you're building on cached results, not re-explaining everything.",
-      velocity: "Velocity (O/I) measures how much output you get per token spent. High velocity = you're productive, not just active.",
+      velocity: "Velocity (O/I) measures how much output you get per token spent. High velocity = you're efficient, not just active.",
     },
     // The 8 base tiers + UNCLASSED, in descending cut order (matches
     // analytics/cascade.mjs CLASS_TIERS). Each tier has 3 sub-stages (I/II/III)

package/tools/get-best-operator.mjs

@@ -10,7 +10,7 @@ import { LEADERBOARD_METRIC } from "../lib/constants.mjs";
 export const TOOL_DEF = {
   name: "get_best_operator",
   description:
-    "Returns the top N operators on the SigRank leaderboard with behavioral framing in power-user language. Wraps get_leaderboard and adds plain-language interpretation of each top operator's cascade: what their yield, leverage, and velocity mean in terms of AI power-user behavior (cache reuse, input economy, output productivity). Use this when users ask 'who is the best AI user?' or 'who tops the SigRank leaderboard?' or 'show me the AI user leaderboard'. Do NOT use get_leaderboard if you want the raw array without interpretation — use this for the power-user framing. Intent: BEST_OPERATOR.",
+    "Returns the top N operators on the SigRank leaderboard with behavioral framing in operator-language. Wraps get_leaderboard and adds plain-language interpretation of each top operator's cascade: what their yield, leverage, and velocity mean in terms of AI operator behavior (cache reuse, input economy, output efficiency). Use this when users ask 'who is the best AI user?' or 'who tops the SigRank leaderboard?' or 'show me the AI user leaderboard'. Do NOT use get_leaderboard if you want the raw array without interpretation — use this for the operator-behavior framing. Intent: BEST_OPERATOR.",
   annotations: { title: "Get best operator", ...ANNOTATIONS.readOnlyHint, ...ANNOTATIONS.openWorldHint },
   inputSchema: {
     type: "object",

package/tools/standard-record.mjs

@@ -2,12 +2,16 @@ import { cascade } from "../analytics/cascade.mjs";
 import { ANNOTATIONS } from "./_schemas.mjs";
 
 export const SIGRANK_STANDARD_VERSION = "sigrank/0.1-draft";
+export const TTEOP_PROTOCOL_VERSION = "tteop/0.1-draft";
+export const TTEOP_SPEC_VERSION = "tteop-spec@0.1.5-draft";
 export const PRODUCT_ARCHITECTURE = Object.freeze({
   brand: "SignalAF",
   governance: "MO§ES™",
   product: "Upsilon",
   leaderboard: "SigRank",
   wire_spec: SIGRANK_STANDARD_VERSION,
+  protocol: TTEOP_PROTOCOL_VERSION,
+  protocol_authority: TTEOP_SPEC_VERSION,
 });
 
 export const TOOL_DEF = {
@@ -39,9 +43,20 @@ export const TOOL_DEF = {
   outputSchema: {
     type: "object",
     additionalProperties: false,
-    required: ["spec", "timestamp", "source", "telemetry", "metrics", "warnings"],
+    required: ["spec", "spec_status", "protocol", "timestamp", "source", "telemetry", "metrics", "warnings"],
     properties: {
-      spec: { const: SIGRANK_STANDARD_VERSION, description: "SigRank specification version." },
+      spec: { const: SIGRANK_STANDARD_VERSION, description: "Legacy wire identifier. Resolves to TTEOP tteop/0.1-draft." },
+      spec_status: { const: "legacy_alias", description: "Indicates this spec identifier is a legacy alias, not a current protocol." },
+      protocol: {
+        type: "object",
+        additionalProperties: false,
+        required: ["name", "version", "authority"],
+        properties: {
+          name: { const: "TTEOP", description: "Canonical protocol name." },
+          version: { const: TTEOP_PROTOCOL_VERSION, description: "Current TTEOP protocol version." },
+          authority: { const: TTEOP_SPEC_VERSION, description: "Canonical executable/reference implementation." }
+        }
+      },
       timestamp: { type: "string", format: "date-time", description: "ISO-8601 record timestamp." },
       source: {
         type: "object",
@@ -110,24 +125,24 @@ export async function handleGetSigRankStandardRecord(args) {
   const cacheWrite = tokenCount(args?.cache_write, "cache_write", false);
   const cacheRead = tokenCount(args?.cache_read, "cache_read", false);
 
+  // Pass null through to cascade (→ tteop-spec) so canonical null semantics
+  // apply directly. Passing 0 would produce 0-valued metrics instead of null,
+  // losing the unavailable/zero distinction. No manual null override needed.
   const c = cascade({
     input,
     output,
-    cacheCreate: cacheWrite ?? 0,
-    cacheRead: cacheRead ?? 0,
+    cacheCreate: cacheWrite,
+    cacheRead: cacheRead,
   });
-  // Standard warning order: cache-unavailability warnings precede the
-  // dev10x_undefined warning (the "why" before the "what"). The standalone
-  // conformance runner validates warnings as ordered arrays.
-  const 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.");
-  for (const w of (c.warnings || [])) {
-    if (!warnings.includes(w)) warnings.push(w);
-  }
 
   return {
     spec: SIGRANK_STANDARD_VERSION,
+    spec_status: "legacy_alias",
+    protocol: {
+      name: "TTEOP",
+      version: TTEOP_PROTOCOL_VERSION,
+      authority: TTEOP_SPEC_VERSION,
+    },
     timestamp: recordTimestamp(args?.timestamp),
     source: {
       provider: args?.provider || "unknown",
@@ -141,12 +156,12 @@ export async function handleGetSigRankStandardRecord(args) {
       cache_read: cacheRead,
     },
     metrics: {
-      yield: cacheRead === null ? null : c.yield,
-      leverage: cacheRead === null ? null : c.leverage,
+      yield: c.yield,
+      leverage: c.leverage,
       velocity: c.velocity,
       snr: c.snr,
-      dev10x: cacheWrite === null || cacheRead === null ? null : c.dev10x,
+      dev10x: c.dev10x,
     },
-    warnings,
+    warnings: c.warnings || [],
   };
 }