skalpel 4.0.12 → 4.0.13

package/bootstrap.mjs

@@ -368,7 +368,9 @@ function recordProfile(profile, sessions) {
   if (headline) {
     recordInsight({
       kind: "profile",
-      display: `learned ${headline.hours ?? 0}h across ${headline.sessions ?? sessions} sessions; ${headline.rework_pct ?? 0}% was rework`,
+      // RED LINE 1: hours/rework_pct are the server's LLM-derived ESTIMATES, not a stopwatch and not
+      // locally reproducible — label them as estimates and point to the `skalpel autopsy` receipt.
+      display: `estimated ~${headline.hours ?? 0}h active with AI across ${headline.sessions ?? sessions} sessions; est. ~${headline.rework_pct ?? 0}% rework (run 'skalpel autopsy' for the exact receipt)`,
     });
   } else {
     recordInsight({ kind: "profile", display: `standing profile built from ${sessions} sessions` });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skalpel",
-  "version": "4.0.12",
+  "version": "4.0.13",
   "description": "Behavioral graph for AI-assisted coding — learns how you work and steers Claude Code + Codex in real time.",
   "type": "module",
   "bin": {

package/reveal.mjs

@@ -31,13 +31,25 @@ export function graphReadyNote() {
   const trap = m.report && (m.report.discriminative || [])[0] && m.report.discriminative[0].seq;
   const n = m.n_sessions || h.sessions || 0;
 
+  // PROVENANCE / HONESTY (RED LINE 1): both `hours` and `rework_pct` come from the hosted graph
+  // server's profile, which is built from an LLM judge's per-intent classification (intent_class +
+  // resolution) over the ingested transcripts. `hours` = summed, banded human read/dwell time on
+  // non-`other` intents (NOT raw session wall-clock); `rework_pct` = share of that time whose
+  // LLM-judged resolution is a "waste" class. Neither is a stopwatch measurement and neither
+  // re-derives locally the way `skalpel autopsy` does — so they must be surfaced as ESTIMATES, never
+  // as measured fact. The reproducible receipt is `skalpel autopsy`.
   const facts = [];
   if (h.hours)
-    facts.push(`they've spent about ${h.hours} hours working with AI across these sessions`);
+    facts.push(
+      `skalpel ESTIMATES they've spent about ${h.hours} hours of active time working with AI across ` +
+        `these sessions (inferred from their history — an estimate, not an exact clock)`,
+    );
   if (h.rework_pct)
     facts.push(
-      `roughly ${h.rework_pct}% of that time went into REWORK — going back to redo, re-explain, or ` +
-        `re-fix things they'd already worked on (that's the time skalpel is built to give back)`,
+      `and it estimates roughly ${h.rework_pct}% of that went into REWORK-type patterns — going back ` +
+        `to redo, re-explain, or re-fix things they'd already worked on (this % is skalpel's ESTIMATE ` +
+        `from reading their sessions, NOT a stopwatch figure — it's the kind of loop skalpel is built ` +
+        `to help with)`,
     );
   if (trap)
     facts.push(
@@ -54,8 +66,12 @@ export function graphReadyNote() {
     `"🔬 skalpel · your graph's ready — here's what I noticed about how you work:" — then, in 2-3 ` +
     `friendly plain-English sentences, tell them what it found` +
     (facts.length ? `: ${facts.join("; ")}` : "") +
-    `. Close by reassuring them this is exactly the loop skalpel now quietly watches for and steers them ` +
-    `out of, live, while they code — they don't have to track it themselves. Then continue with whatever ` +
-    `they actually asked. Keep the whole thing short and human.]`
+    `. HONESTY RULE: present every number as skalpel's ESTIMATE inferred from their history — hedge ` +
+    `naturally ("about", "roughly", "skalpel estimates") and NEVER state a figure as an exact ` +
+    `measurement. If they want the exact, locally-verified receipt that re-derives from the coding ` +
+    `logs already on their own machine, tell them they can run \`skalpel autopsy\` anytime. Close by ` +
+    `reassuring them this is exactly the loop skalpel now quietly watches for and steers them out of, ` +
+    `live, while they code — they don't have to track it themselves. Then continue with whatever they ` +
+    `actually asked. Keep the whole thing short and human.]`
   );
 }

package/skalpel-setup.mjs

@@ -698,12 +698,15 @@ async function revealInsights(report) {
   console.log("");
   await line(`   ${B}Here's what I learned about how you work:${X}\n`, 480);
 
+  // RED LINE 1: h.hours / h.rework_pct are the hosted graph server's ESTIMATES, built from an LLM
+  // judge's per-intent classification — not a stopwatch, and not locally reproducible. Surface them
+  // as estimates and point to `skalpel autopsy` (the zero-network receipt that re-derives from disk).
   const rw = h.rework_pct || 0;
   await line(
-    `   ${R}▸${X} You've spent ${B}${h.hours}h${X} with AI across ${h.sessions} sessions — and about ${B}${R}${rw}%${X} of it went to ${B}rework${X}:`,
+    `   ${R}▸${X} skalpel estimates about ${B}${h.hours}h${X} of active time with AI across ${h.sessions} sessions — and that about ${B}${R}${rw}%${X} of it went to ${B}rework${X}:`,
   );
   await line(
-    `     ${D}circling back, re-explaining, re-fixing the same thing. That's the time skalpel goes after.${X}\n`,
+    `     ${D}circling back, re-explaining, re-fixing the same thing — the loop skalpel goes after.${X}\n`,
     520,
   );
 
@@ -738,6 +741,13 @@ async function revealInsights(report) {
   }
 
   console.log("");
+  // RED LINE 1: everything above (hours, rework %, archetype waste-hours, time-sink %, escape %) is
+  // the hosted graph's ESTIMATE from an LLM read of your sessions — not a stopwatch. State that once,
+  // plainly, and point to the zero-network receipt that re-derives from the logs on THIS machine.
+  await line(
+    `   ${D}These are skalpel's estimates from your recent sessions — run ${X}${B}skalpel autopsy${X}${D} for the exact receipt that re-derives from the logs on this machine.${X}`,
+    260,
+  );
   await line(
     `   ${G}skalpel now watches for these every session and steers you off them in real time.${X}`,
     260,