persnally 2.5.0 → 2.5.1

package/README.md

@@ -93,14 +93,16 @@ persnallyd import claude|claude-code|chatgpt|git <path>
 persnallyd scope <client> <categories>   # limit what a client can read
 persnallyd profile                       # synthesize the profile
 persnallyd consolidate                   # reflect now: refresh decay, add behavior patterns
+persnallyd voice                         # refresh your "how you write" fingerprint (offline)
 persnallyd show [topics|events|profile]
-persnallyd forget <topic> | --all | --batch <id>
+persnallyd activity                      # context-read engagement over time (retention pulse)
+persnallyd forget <topic> | --all | --batch <id> | --style <dim> <pattern>
 persnallyd config set-key <sk-ant-…>     # key for the background daemon
 ```
 
 ## Status
 
-Early and moving fast — see [ROADMAP.md](./ROADMAP.md). Today: import from Claude, ChatGPT, Claude Code, and git; a decay-weighted interest graph; an evidence-linked profile; a local dashboard; per-client permission scoping; nightly consolidation; and the MCP layer that serves it all. Next: cross-tool context everywhere, then a behavior model that can answer *what would I do here?*
+Early and moving fast — see [ROADMAP.md](./ROADMAP.md). Today: import from Claude, ChatGPT, Claude Code, and git; a decay-weighted interest graph; an evidence-linked profile; a voice & convention layer so connected tools answer the way you write; a local dashboard with full provenance and one-click deletion; per-client permission scoping; nightly consolidation; and the MCP layer that serves it all. Next: cross-tool context everywhere, then a behavior model that can answer *what would I do here?*
 
 ## License
 

package/build/src/cli.js

@@ -471,7 +471,7 @@ async function main() {
                 console.log("No activity yet — run an import or connect a client.");
                 return;
             }
-            const verdict = a.retainedWeek2 === null ? `in progress (day ${a.daysSinceFirst}/14)` : a.retainedWeek2 ? "active ✓" : "inactive ✗";
+            const verdict = a.retainedWeek2 === null ? `in progress (day ${a.daysSinceFirstRead}/14 of reads)` : a.retainedWeek2 ? "active ✓" : "inactive ✗";
             console.log(`Onboarded ${a.daysSinceFirst}d ago · ${a.totalReads} context read(s) total`);
             console.log(`Reads: ${a.reads7d} this week · ${a.reads30d} this month`);
             console.log(`Active: ${a.activeDays7d}/7 days · ${a.activeDays14d}/14 days`);

package/build/src/dashboard.html

@@ -434,7 +434,7 @@ function renderEngage(a) {
     const c = d.reads ? (today ? "var(--text)" : "var(--dim)") : "var(--line-2)";
     return `<i style="height:${h}px;background:${c}" title="${esc(d.date)}: ${d.reads}"></i>`;
   }).join("");
-  const ret = a.retainedWeek2 === null ? `day ${a.daysSinceFirst}/14` : (a.retainedWeek2 ? "active ✓" : "inactive ✗");
+  const ret = a.retainedWeek2 === null ? `day ${a.daysSinceFirstRead}/14` : (a.retainedWeek2 ? "active ✓" : "inactive ✗");
   el.innerHTML = `<span><b>${a.reads7d}</b> this week</span><span>active <b>${a.activeDays14d}</b> of last 14 days</span>` +
     `<span class="spark" title="context reads, last 14 days">${bars}</span><span class="rk">week-2: ${esc(ret)}</span>`;
 }
@@ -707,7 +707,7 @@ function DEMO_DATA() {
       { ts:iso(86400000*2), payload:{ claim:"You consistently choose local-first, auditable tools over cloud convenience.", kind:"preference", confidence:0.86 }, provenance:{ kind:"derived" } },
       { ts:iso(86400000*6), payload:{ claim:"You generate new ideas fastest right when your main bet stalls.", kind:"behavior", confidence:0.71 }, provenance:{ kind:"derived" } },
     ],
-    activity: { firstEventAt: iso(86400000*214), lastReadAt: iso(3600000*2), daysSinceFirst: 214, totalReads: 1247, reads7d: 33, reads30d: 142, activeDays7d: 5, activeDays14d: 12, retainedWeek2: true, daily: [2,0,3,5,1,4,6,2,0,3,7,5,8,4].map((r,i)=>({ date:new Date(now-(13-i)*86400000).toISOString().slice(0,10), reads:r })) },
+    activity: { firstEventAt: iso(86400000*214), firstReadAt: iso(86400000*210), lastReadAt: iso(3600000*2), daysSinceFirst: 214, daysSinceFirstRead: 210, totalReads: 1247, reads7d: 33, reads30d: 142, activeDays7d: 5, activeDays14d: 12, retainedWeek2: true, daily: [2,0,3,5,1,4,6,2,0,3,7,5,8,4].map((r,i)=>({ date:new Date(now-(13-i)*86400000).toISOString().slice(0,10), reads:r })) },
     voice: {
       pack: "Write like this user: terse — short, declarative sentences; leads with imperatives, minimal preamble; states things flatly; no emoji; casual register (lowercases “i”); recurring phrasing: “be 100% sure”, “industry best practices”, “validate whether it's valid or not”.",
       items: [

package/build/src/store.d.ts

@@ -37,8 +37,10 @@ export interface StoredProfile {
 }
 export interface Activity {
     firstEventAt: string | null;
+    firstReadAt: string | null;
     lastReadAt: string | null;
     daysSinceFirst: number;
+    daysSinceFirstRead: number;
     totalReads: number;
     reads7d: number;
     reads30d: number;

package/build/src/store.js

@@ -161,6 +161,11 @@ export class EventStore {
         const reads = this.query({ type: "context.read", limit: 1_000_000 }); // ts DESC
         const firstEventAt = this.db.prepare("SELECT MIN(ts) m FROM events").get().m;
         const firstMs = firstEventAt ? new Date(firstEventAt).getTime() : null;
+        // Retention is anchored to when serving actually began (the first read), not
+        // onboarding — so a gap between setup and the first read can't read as a
+        // false "not retained". For a fresh install the two are minutes apart.
+        const firstReadAt = reads.length ? reads[reads.length - 1].ts : null;
+        const firstReadMs = firstReadAt ? new Date(firstReadAt).getTime() : null;
         const daily = new Map();
         for (let i = 13; i >= 0; i--)
             daily.set(dayKey(now - i * DAY), 0);
@@ -181,19 +186,21 @@ export class EventStore {
                 reads30d++;
             if (daily.has(k))
                 daily.set(k, (daily.get(k) ?? 0) + 1);
-            if (firstMs !== null && t >= firstMs + 7 * DAY && t < firstMs + 14 * DAY)
+            if (firstReadMs !== null && t >= firstReadMs + 7 * DAY && t < firstReadMs + 14 * DAY)
                 week2Read = true;
         }
         return {
             firstEventAt,
+            firstReadAt,
             lastReadAt: reads.length ? reads[0].ts : null,
             daysSinceFirst: firstMs !== null ? Math.max(0, Math.floor((now - firstMs) / DAY)) : 0,
+            daysSinceFirstRead: firstReadMs !== null ? Math.max(0, Math.floor((now - firstReadMs) / DAY)) : 0,
             totalReads: reads.length,
             reads7d,
             reads30d,
             activeDays7d: days7.size,
             activeDays14d: days14.size,
-            retainedWeek2: firstMs !== null && now >= firstMs + 14 * DAY ? week2Read : null,
+            retainedWeek2: firstReadMs !== null && now >= firstReadMs + 14 * DAY ? week2Read : null,
             daily: [...daily.entries()].map(([date, r]) => ({ date, reads: r })),
         };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "persnally",
-  "version": "2.5.0",
+  "version": "2.5.1",
   "license": "FSL-1.1-MIT",
   "description": "Your own context engine — local-first, across every AI. So every AI finally knows you.",
   "type": "module",