@compr/opscontext-mcp 2.5.0 → 2.5.1

package/dist/cli.js

@@ -602,7 +602,8 @@ import { activate, deactivate, getActivationStatus, gateCheck, } from "./activat
 import { syncTierA, syncTierB, loadCommunityStore, communityRulesToChunks, mergeWithDedup, STORE_PATH as COMMUNITY_STORE_PATH, } from "./community-sync.js";
 import { readAuditLog, verifyChain, filterByRange, toCsv, } from "./audit.js";
 import { loadRepoPolicy, parsePolicy, formatPolicySummary, formatValidationErrors, repoPolicyPath, } from "./policy.js";
-import { collectRuns, metricsFor, transcriptRoot, emptyTally, addTally, totalTokens, } from "./transcript-collector.js";
+import { collectRuns, metricsFor, transcriptRoot, emptyTally, addTally, totalTokens, pricingStatus, pricingFor, } from "./transcript-collector.js";
+import { DEFAULT_PRICING, DEFAULT_PRICING_ASOF } from "./default-pricing.js";
 import { runTranscriptHeuristics, DEFAULT_COST_THRESHOLDS, } from "./detector.js";
 import { getStagedFiles, runSecretScan, runDocCoverage, runCommitMessageRequired, runRuleParity, formatSecretViolations, formatDocCoverageViolations, formatSecretViolationsJson, formatDocCoverageViolationsJson, formatCommitMessageViolations, formatCommitMessageViolationsJson, formatRuleParityViolations, formatRuleParityViolationsJson, } from "./hooks.js";
 import { safeAppend } from "./audit.js";
@@ -2289,20 +2290,27 @@ function loadCostThresholds(cwd) {
     const res = loadRepoPolicy(cwd);
     if (res && res.ok && res.policy.agent_cost) {
         const a = res.policy.agent_cost;
+        // [DEFAULT-RATES-SHIP-WITH-THE-PACKAGE] — an agent_cost block that omits
+        // `pricing` must not silently price nothing.
+        const hasOwnRates = a.pricing.length > 0;
         return {
             t: {
                 billing_mode: a.billing_mode,
-                pricing: a.pricing,
+                pricing: hasOwnRates ? a.pricing : DEFAULT_PRICING,
                 min_cache_efficiency: a.min_cache_efficiency,
                 max_tool_calls_per_agent: a.max_tool_calls_per_agent,
                 max_cost_per_agent_usd: a.max_cost_per_agent_usd,
                 min_fanout_for_canary: a.min_fanout_for_canary,
                 max_failed_share: a.max_failed_share,
             },
-            source: ".contextengine/policy.json",
+            source: ".contextengine/policy.json" +
+                (hasOwnRates ? "" : ` (rates: built-in, as of ${DEFAULT_PRICING_ASOF})`),
         };
     }
-    return { t: DEFAULT_COST_THRESHOLDS, source: "built-in defaults (no agent_cost in policy.json)" };
+    return {
+        t: DEFAULT_COST_THRESHOLDS,
+        source: `built-in defaults, rates as of ${DEFAULT_PRICING_ASOF} (no agent_cost in policy.json)`,
+    };
 }
 async function cliCost(argv) {
     const flag = (name) => {
@@ -2355,7 +2363,17 @@ async function cliCost(argv) {
     let vol = emptyTally();
     let agents = 0, toolCalls = 0, failed = 0, capacity = 0, reported = 0;
     let cost = 0, withoutCache = 0, unpriced = 0;
+    // Which models carried tokens but matched no rate — named in the output so
+    // the fix is actionable instead of "something was unpriced".
+    const unpricedModels = new Set();
     for (const { run, m } of scored) {
+        for (const a of run.agents) {
+            for (const [model, tally] of a.tokensByModel) {
+                if (totalTokens(tally) > 0 && !pricingFor(model, t.pricing)) {
+                    unpricedModels.add(model ?? "(no model recorded)");
+                }
+            }
+        }
         vol = addTally(vol, run.totals);
         agents += m.agents;
         toolCalls += m.toolCalls;
@@ -2383,12 +2401,6 @@ async function cliCost(argv) {
     console.log("");
     // ── 2. VALUED COST ──────────────────────────────────────────────────────
     const notional = t.billing_mode === "subscription";
-    console.log(`VALUED COST (API list prices)${notional ? " — NOTIONAL, NOT BILLED" : ""}`);
-    if (notional) {
-        console.log("  This machine runs Claude Code on a subscription: no dollar below is");
-        console.log("  debited. Use these figures to compare approaches, not as spend.");
-    }
-    const costRow = (label, n) => console.log(`  ${label.padEnd(16)} ${("$" + n.toFixed(2)).padStart(8)}  ${cost ? ((100 * n) / cost).toFixed(1).padStart(5) : "  0.0"}%`);
     let ci = 0, ccw = 0, ccr = 0, co = 0;
     for (const { m } of scored) {
         ci += m.cost.input;
@@ -2396,16 +2408,42 @@ async function cliCost(argv) {
         ccr += m.cost.cacheRead;
         co += m.cost.output;
     }
-    costRow("cache read", ccr);
-    costRow("cache write", ccw);
-    costRow("input (fresh)", ci);
-    costRow("output", co);
-    console.log(`  ${"total".padEnd(16)} ${("$" + cost.toFixed(2)).padStart(8)}`);
-    console.log(`  ${"without cache".padEnd(16)} ${("$" + withoutCache.toFixed(2)).padStart(8)}  ` +
-        `caching saved $${(withoutCache - cost).toFixed(2)} (${withoutCache ? (100 * (1 - cost / withoutCache)).toFixed(0) : "0"}%)`);
-    if (unpriced > 0)
-        console.log(`  ⚠ ${fmtTok(unpriced)} tokens UNPRICED (no matching model in policy) — not counted above`);
-    console.log("");
+    const agg = {
+        input: ci, cacheWrite: ccw, cacheRead: ccr, output: co,
+        total: cost, withoutCache, unpricedTokens: unpriced,
+    };
+    const status = pricingStatus(agg);
+    console.log(`VALUED COST (API list prices)${notional && status !== "unpriced" ? " — NOTIONAL, NOT BILLED" : ""}`);
+    // [NEVER-RENDER-AN-UNKNOWN-AS-A-NUMBER] — with nothing priced there is no
+    // cost to show. Printing a $0.00 table here reads as "this run was free"
+    // and "caching saved 0%", both false.
+    if (status === "unpriced") {
+        console.log(`  UNPRICED — no rate matched any model in this data, so no cost can be`);
+        console.log(`  stated. ${fmtTok(unpriced)} tokens were moved. This is an unknown, not $0.`);
+        console.log("");
+        console.log(`  Models seen without a rate: ${[...unpricedModels].sort().join(", ") || "(unknown)"}`);
+        console.log(`  Add them to .contextengine/policy.json → agent_cost.pricing.`);
+        console.log("");
+    }
+    else {
+        if (notional) {
+            console.log("  This machine runs Claude Code on a subscription: no dollar below is");
+            console.log("  debited. Use these figures to compare approaches, not as spend.");
+        }
+        const costRow = (label, n) => console.log(`  ${label.padEnd(16)} ${("$" + n.toFixed(2)).padStart(8)}  ${cost ? ((100 * n) / cost).toFixed(1).padStart(5) : "  0.0"}%`);
+        costRow("cache read", ccr);
+        costRow("cache write", ccw);
+        costRow("input (fresh)", ci);
+        costRow("output", co);
+        console.log(`  ${"total".padEnd(16)} ${("$" + cost.toFixed(2)).padStart(8)}`);
+        console.log(`  ${"without cache".padEnd(16)} ${("$" + withoutCache.toFixed(2)).padStart(8)}  ` +
+            `caching saved $${(withoutCache - cost).toFixed(2)} (${withoutCache ? (100 * (1 - cost / withoutCache)).toFixed(0) : "0"}%)`);
+        if (status === "partial") {
+            console.log(`  ⚠ ${fmtTok(unpriced)} tokens UNPRICED and NOT in the figures above` +
+                ` (${[...unpricedModels].sort().join(", ") || "unknown model"}) — the total is a floor, not the cost`);
+        }
+        console.log("");
+    }
     // ── 3. INTENSITY (the capacity proxy) ───────────────────────────────────
     console.log(`INTENSITY (capacity proxy${notional ? " — the scarce resource here" : ""})`);
     console.log(`  subagents        ${String(agents).padStart(8)}`);

package/dist/default-pricing.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Built-in model rates, in dollars per million tokens.
+ *
+ * 🔒 LOCKED [DEFAULT-RATES-SHIP-WITH-THE-PACKAGE] — 2026-08-20
+ * ⛔ NEVER ship an empty default pricing table again.
+ * WHY: `[PRICING-LIVES-IN-POLICY]` was read as "ship no rates at all", so
+ *    2.5.0 shipped `pricing: []` as the default. Every user without an
+ *    `agent_cost` block in their own policy.json got a VALUED COST panel
+ *    reading `total $0.00` and `caching saved $0.00 (0%)` over 1.08 BILLION
+ *    real tokens — a confident, wrong-looking verdict on the headline feature
+ *    of the release. The LOCK's intent was "rates must be correctable without
+ *    a release", not "the product ships priced at nothing".
+ * FIX: ship rates here, as DATA in their own module, never inline in the
+ *    collector / detector / CLI. `.contextengine/policy.json` →
+ *    `agent_cost.pricing` still wins outright when present, and this file
+ *    compiles to plain readable JS in `dist/`, so a rate can be corrected in
+ *    place without waiting for a release.
+ *
+ * Rates are Anthropic API list prices. Cache read is 0.1x input, cache write
+ * 5m is 1.25x input, cache write 1h is 2x input.
+ */
+import type { ModelPricing } from "./transcript-collector.js";
+/**
+ * When these rates were last checked against published pricing. Surfaced in
+ * `contextengine cost` output: a rate table with no date is a rate table
+ * nobody knows to distrust.
+ */
+export declare const DEFAULT_PRICING_ASOF = "2026-08-20";
+/**
+ * Longest-prefix matched, so dated ids (`claude-haiku-4-5-20251001`) resolve
+ * to their family. Deliberately NO `*` catch-all: a model absent from this
+ * table must report as UNPRICED, never be valued at a guessed rate
+ * (`[ABSENCE-IS-NOT-A-VERDICT]`).
+ */
+export declare const DEFAULT_PRICING: ModelPricing[];
+//# sourceMappingURL=default-pricing.d.ts.map

package/dist/default-pricing.js

@@ -0,0 +1,57 @@
+/**
+ * Built-in model rates, in dollars per million tokens.
+ *
+ * 🔒 LOCKED [DEFAULT-RATES-SHIP-WITH-THE-PACKAGE] — 2026-08-20
+ * ⛔ NEVER ship an empty default pricing table again.
+ * WHY: `[PRICING-LIVES-IN-POLICY]` was read as "ship no rates at all", so
+ *    2.5.0 shipped `pricing: []` as the default. Every user without an
+ *    `agent_cost` block in their own policy.json got a VALUED COST panel
+ *    reading `total $0.00` and `caching saved $0.00 (0%)` over 1.08 BILLION
+ *    real tokens — a confident, wrong-looking verdict on the headline feature
+ *    of the release. The LOCK's intent was "rates must be correctable without
+ *    a release", not "the product ships priced at nothing".
+ * FIX: ship rates here, as DATA in their own module, never inline in the
+ *    collector / detector / CLI. `.contextengine/policy.json` →
+ *    `agent_cost.pricing` still wins outright when present, and this file
+ *    compiles to plain readable JS in `dist/`, so a rate can be corrected in
+ *    place without waiting for a release.
+ *
+ * Rates are Anthropic API list prices. Cache read is 0.1x input, cache write
+ * 5m is 1.25x input, cache write 1h is 2x input.
+ */
+/**
+ * When these rates were last checked against published pricing. Surfaced in
+ * `contextengine cost` output: a rate table with no date is a rate table
+ * nobody knows to distrust.
+ */
+export const DEFAULT_PRICING_ASOF = "2026-08-20";
+function rate(model, input, output) {
+    return {
+        model,
+        input_per_mtok: input,
+        output_per_mtok: output,
+        cache_read_per_mtok: Number((input * 0.1).toFixed(4)),
+        cache_write_5m_per_mtok: Number((input * 1.25).toFixed(4)),
+        cache_write_1h_per_mtok: Number((input * 2).toFixed(4)),
+    };
+}
+/**
+ * Longest-prefix matched, so dated ids (`claude-haiku-4-5-20251001`) resolve
+ * to their family. Deliberately NO `*` catch-all: a model absent from this
+ * table must report as UNPRICED, never be valued at a guessed rate
+ * (`[ABSENCE-IS-NOT-A-VERDICT]`).
+ */
+export const DEFAULT_PRICING = [
+    rate("claude-opus-5", 5, 25),
+    rate("claude-opus-4-8", 5, 25),
+    rate("claude-opus-4-7", 5, 25),
+    rate("claude-opus-4-6", 5, 25),
+    rate("claude-opus-4-5", 5, 25),
+    rate("claude-fable-5", 10, 50),
+    rate("claude-mythos-5", 10, 50),
+    rate("claude-sonnet-5", 3, 15),
+    rate("claude-sonnet-4-6", 3, 15),
+    rate("claude-sonnet-4-5", 3, 15),
+    rate("claude-haiku-4-5", 1, 5),
+];
+//# sourceMappingURL=default-pricing.js.map

package/dist/detector.js

@@ -334,9 +334,11 @@ export const _internal = {
     detectDrift, detectNoInsight, detectSilentFailure, detectStaleDocSignal,
 };
 import { metricsFor } from "./transcript-collector.js";
+import { DEFAULT_PRICING } from "./default-pricing.js";
 export const DEFAULT_COST_THRESHOLDS = {
     billing_mode: "subscription",
-    pricing: [],
+    // [DEFAULT-RATES-SHIP-WITH-THE-PACKAGE] — never [] again.
+    pricing: DEFAULT_PRICING,
     min_cache_efficiency: 3,
     max_tool_calls_per_agent: 2,
     max_cost_per_agent_usd: 3,

package/dist/transcript-collector.d.ts

@@ -130,6 +130,24 @@ export declare function pricingFor(model: string | null, table: ModelPricing[]):
  *    AND intensity — never one alone.
  */
 export declare function costOf(t: TokenTally, p: ModelPricing | null): CostBreakdown;
+/**
+ * Whether a cost figure can be presented as money at all.
+ *
+ * 🔒 LOCKED [NEVER-RENDER-AN-UNKNOWN-AS-A-NUMBER] — 2026-08-20
+ * ⛔ NEVER print a $0.00 cost row, total, or "caching saved" figure while
+ *    `unpricedTokens > 0`.
+ * WHY: 2.5.0 rendered a full VALUED COST table of $0.00 over 1.08 billion
+ *    unpriced tokens, including "caching saved $0.00 (0%)" — which reads as
+ *    "your caching achieves nothing" when the true reuse was 8x. The token
+ *    accounting was right; the PRESENTATION layer turned "I have no rates"
+ *    into a number. That is Session 21's rule at the display layer: any
+ *    plausible-looking value returned from a branch meaning "I could not
+ *    determine this" is the bug, however reasonable it looks.
+ * FIX: branch on this before formatting. `unpriced` must render the word
+ *    UNPRICED, never a currency amount.
+ */
+export type PricingStatus = "priced" | "partial" | "unpriced";
+export declare function pricingStatus(c: CostBreakdown): PricingStatus;
 export declare function emptyTally(): TokenTally;
 export declare function addTally(a: TokenTally, b: TokenTally): TokenTally;
 export declare function totalTokens(t: TokenTally): number;

package/dist/transcript-collector.js

@@ -84,6 +84,11 @@ export function costOf(t, p) {
         t.output * p.output_per_mtok) / M;
     return { input, cacheWrite, cacheRead, output, total: input + cacheWrite + cacheRead + output, withoutCache, unpricedTokens: 0 };
 }
+export function pricingStatus(c) {
+    if (c.unpricedTokens === 0)
+        return "priced";
+    return c.total === 0 ? "unpriced" : "partial";
+}
 export function emptyTally() {
     return { input: 0, cacheWrite5m: 0, cacheWrite1h: 0, cacheRead: 0, output: 0 };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compr/opscontext-mcp",
-  "version": "2.5.0",
+  "version": "2.5.1",
   "description": "OpsContext for AI Agents — read-only fleet visibility (PM2/nginx/Docker/git/cron) + tamper-evident audit log + policy-as-code hooks. The ops + compliance layer Claude Code can't grow natively.",
   "type": "module",
   "main": "dist/index.js",