wendkeep 0.44.0 → 0.45.0

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to **wendkeep** are documented here. Format based on
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); this project follows
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.45.0] — 2026-07-18
+
+### Fixed
+
+- Observabilidade: o note de sessão deixa de ser reescrito com timestamp novo a cada Stop
+  quando o uso não muda. A preservação de `atualizado_em` (`token-usage.mjs`) comparava
+  `previous` (parseado do note) com `current` (recém-computado) via `JSON.stringify` —
+  sensível à ordem das chaves, que difere entre parse e build, então a comparação **sempre**
+  falhava e o timestamp era re-stampado toda vez. Novo `sameUsageData(a, b)` compara os campos
+  de uso de forma ordem-insensível (ignorando `atualizado_em`). Corrige o churn de reescrita e
+  o teste flaky "same sources produce byte-identical markdown".
+
 ## [0.44.0] — 2026-07-17
 
 ### Changed

package/hooks/token-usage.mjs

@@ -604,6 +604,19 @@ function transcriptIdFromPath(transcriptPath) {
   return basename(String(transcriptPath || '')).replace(/\.jsonl?$/i, '') || 'desconhecido';
 }
 
+// The usage fields that define whether a transcript's entry "changed" — everything except the
+// key (transcript_id) and the timestamp (atualizado_em). Order-insensitive by design: a new
+// field here is the single place to keep preservation correct.
+const USAGE_FIELDS = ['provider', 'pensamento', 'input', 'cache_write', 'cache_read',
+  'output', 'reasoning', 'total', 'custo_usd', 'prompts', 'tool_calls', 'chamadas_llm'];
+
+export function sameUsageData(a, b) {
+  if (!a || !b) return false;
+  const listEqual = (x, y) => (x || []).join('') === (y || []).join('');
+  return USAGE_FIELDS.every((f) => (a[f] ?? null) === (b[f] ?? null))
+    && listEqual(a.modelos, b.modelos) && listEqual(a.tools, b.tools);
+}
+
 function entryFromSummary(summary, transcriptId) {
   return {
     transcript_id: transcriptId,
@@ -931,10 +944,11 @@ export function collectSessionUsage({ sessionContent, transcriptPath }) {
   const transcriptId = transcriptIdFromPath(transcriptPath);
   const previous = existingEntries.find((entry) => entry.transcript_id === transcriptId);
   const current = entryFromSummary(summary, transcriptId);
-  if (previous) {
-    const comparable = (entry) => JSON.stringify({ ...entry, atualizado_em: undefined });
-    if (comparable(previous) === comparable(current)) current.atualizado_em = previous.atualizado_em;
-  }
+  // Preserve the old timestamp when the usage data is unchanged, so an unchanged session note
+  // stays byte-identical (no needless rewrite on every Stop). Compared semantically, NOT via
+  // JSON.stringify: the parsed-from-note entry and the freshly-built one have different key
+  // orders, which made the old stringify compare always mismatch — preservation never fired.
+  if (previous && sameUsageData(previous, current)) current.atualizado_em = previous.atualizado_em;
   let entries = existingEntries.filter((e) => e.transcript_id !== transcriptId);
 
   if (!existingEntries.length) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wendkeep",
-  "version": "0.44.0",
+  "version": "0.45.0",
   "description": "A persistent-memory harness for AI coding agents on your Obsidian vault: turn-by-turn session capture plus a native, zero-dependency spec→change→verify→archive loop (sensor-gated, independent verdict, mutation discrimination). Local-first, agent-agnostic (Claude Code, Codex, Cursor…).",
   "type": "module",
   "bin": {
@@ -46,6 +46,6 @@
     "url": "https://github.com/rogersialves/wendkeep/issues"
   },
   "devDependencies": {
-    "wendkeep": "^0.39.0"
+    "wendkeep": "^0.44.0"
   }
 }