@warnyin/sdlc 0.5.0 → 0.5.1

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.5.1 (2026-08-25)
+
+- **Fix (cost)**: `costUsd()` never charged cache-write tokens, the highest-rate of
+  the four classes the usage parser collects. Every cost `/sdlc:observe` and the
+  session summary have printed was therefore low. A model priced without a
+  `cacheWrite` rate now charges nothing for that class rather than inferring one from
+  `input` — the module's rule is never to guess a price, and a guess reports as
+  confidently as a known rate. Existing journalled costs are left alone: backfilling
+  would rewrite history from a rate that was not in force at the time.
+
 ## 0.5.0 (2026-08-25)
 
 - **`--auto` on every pipeline stage.** `/sdlc:auto` already ran the whole pipeline,

package/lib/usage.mjs

@@ -1,46 +1,49 @@
-// Transcript-usage parser: Claude Code transcripts are JSONL; assistant
-// entries carry `message.usage` and `message.model`. We sum per model and
-// price via the optional table in sdlc/config.yaml. Never guess: when a
-// price is unknown, cost stays null (reported as n/a).
-
-export function parseTranscriptUsage(jsonlText) {
-  const byModel = new Map();
-  for (const line of (jsonlText ?? '').split('\n')) {
-    if (!line.trim()) continue;
-    let entry;
-    try { entry = JSON.parse(line); } catch { continue; }
-    const msg = entry?.message;
-    const usage = msg?.usage;
-    if (!usage || typeof usage !== 'object') continue;
-    const model = msg.model ?? 'unknown';
-    const acc = byModel.get(model) ?? { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
-    acc.input += usage.input_tokens ?? 0;
-    acc.output += usage.output_tokens ?? 0;
-    acc.cacheRead += usage.cache_read_input_tokens ?? 0;
-    acc.cacheWrite += usage.cache_creation_input_tokens ?? 0;
-    byModel.set(model, acc);
-  }
-  const models = Object.fromEntries(byModel);
-  const totals = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
-  for (const m of byModel.values()) {
-    totals.input += m.input; totals.output += m.output;
-    totals.cacheRead += m.cacheRead; totals.cacheWrite += m.cacheWrite;
-  }
-  return { models, totals };
-}
-
-// prices: { "<model>": { input, output, cacheRead } } in USD per 1M tokens.
-export function costUsd(usage, prices) {
-  if (!prices) return null;
-  let usd = 0;
-  let priced = false;
-  for (const [model, u] of Object.entries(usage.models)) {
-    const p = prices[model];
-    if (!p) continue;
-    priced = true;
-    usd += (u.input * (p.input ?? 0)
-      + u.output * (p.output ?? 0)
-      + u.cacheRead * (p.cacheRead ?? 0)) / 1_000_000;
-  }
-  return priced ? Number(usd.toFixed(4)) : null;
-}
+// Transcript-usage parser: Claude Code transcripts are JSONL; assistant
+// entries carry `message.usage` and `message.model`. We sum per model and
+// price via the optional table in sdlc/config.yaml. Never guess: when a
+// price is unknown, cost stays null (reported as n/a).
+
+export function parseTranscriptUsage(jsonlText) {
+  const byModel = new Map();
+  for (const line of (jsonlText ?? '').split('\n')) {
+    if (!line.trim()) continue;
+    let entry;
+    try { entry = JSON.parse(line); } catch { continue; }
+    const msg = entry?.message;
+    const usage = msg?.usage;
+    if (!usage || typeof usage !== 'object') continue;
+    const model = msg.model ?? 'unknown';
+    const acc = byModel.get(model) ?? { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
+    acc.input += usage.input_tokens ?? 0;
+    acc.output += usage.output_tokens ?? 0;
+    acc.cacheRead += usage.cache_read_input_tokens ?? 0;
+    acc.cacheWrite += usage.cache_creation_input_tokens ?? 0;
+    byModel.set(model, acc);
+  }
+  const models = Object.fromEntries(byModel);
+  const totals = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
+  for (const m of byModel.values()) {
+    totals.input += m.input; totals.output += m.output;
+    totals.cacheRead += m.cacheRead; totals.cacheWrite += m.cacheWrite;
+  }
+  return { models, totals };
+}
+
+// prices: { "<model>": { input, output, cacheRead, cacheWrite } } in USD per 1M
+// tokens. A class the table omits is charged nothing — never inferred from another
+// rate, since a guessed price reports as confidently as a known one.
+export function costUsd(usage, prices) {
+  if (!prices) return null;
+  let usd = 0;
+  let priced = false;
+  for (const [model, u] of Object.entries(usage.models)) {
+    const p = prices[model];
+    if (!p) continue;
+    priced = true;
+    usd += (u.input * (p.input ?? 0)
+      + u.output * (p.output ?? 0)
+      + u.cacheRead * (p.cacheRead ?? 0)
+      + u.cacheWrite * (p.cacheWrite ?? 0)) / 1_000_000;
+  }
+  return priced ? Number(usd.toFixed(4)) : null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warnyin/sdlc",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Spec-driven, AI-driven SDLC framework — token-lean specs, contract-first changes, autonomous pipeline with managed hooks. Operationalizes the Day-1 'New SDLC with Vibe Coding' work process.",
   "type": "module",
   "bin": {