persnally 2.4.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

@@ -47,6 +47,7 @@ Usage:
   persnallyd forget --all           Delete all data
   persnallyd forget --batch <id>    Undo one import batch
   persnallyd status                 Store stats and daemon health
+  persnallyd activity               Context-read engagement over time (retention pulse)
   persnallyd start [--port N]       Start the daemon in the background
   persnallyd stop                   Stop the background daemon
   persnallyd serve [--port N]       Run the daemon in the foreground (127.0.0.1:${DEFAULT_PORT})
@@ -462,6 +463,22 @@ async function main() {
             console.log(`Autostart: ${autostartInstalled() ? "installed" : "not installed"}`);
             return;
         }
+        case "activity": {
+            const store = new EventStore();
+            const a = store.activity();
+            store.close();
+            if (!a.firstEventAt) {
+                console.log("No activity yet — run an import or connect a client.");
+                return;
+            }
+            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`);
+            console.log(`Week-2 retention: ${verdict}`);
+            console.log(`Last 14 days: ${sparkline(a.daily.map((d) => d.reads))}`);
+            return;
+        }
         case "start": {
             const existing = runningPid();
             if (existing)
@@ -527,6 +544,11 @@ async function main() {
             process.exitCode = cmd ? 1 : 0;
     }
 }
+function sparkline(values) {
+    const blocks = "▁▂▃▄▅▆▇█";
+    const max = Math.max(...values, 1);
+    return values.map((v) => (v === 0 ? "·" : blocks[Math.min(blocks.length - 1, Math.floor((v / max) * (blocks.length - 1)))])).join("");
+}
 function summarize(payload) {
     const s = JSON.stringify(payload);
     return s.length > 80 ? s.slice(0, 77) + "..." : s;

package/build/src/daemon.js

@@ -41,6 +41,9 @@ export function startDaemon(store, port = DEFAULT_PORT) {
             if (req.method === "GET" && url.pathname === "/stats") {
                 return json(res, 200, store.stats());
             }
+            if (req.method === "GET" && url.pathname === "/activity") {
+                return json(res, 200, store.activity());
+            }
             if (req.method === "GET" && url.pathname === "/topics") {
                 const client = url.searchParams.get("client");
                 const allowed = client ? allowedCategories(client) : null;

package/build/src/dashboard.html

@@ -153,6 +153,11 @@
   .read .what .l1 b { color: var(--text); } .read .what .l1 .p { color: var(--dim); }
   .read .what .l2 { font-size: 11px; color: var(--faint); margin-top: 2px; }
   .read .when { font-size: 11.5px; color: var(--dim); white-space: nowrap; }
+  .engage { display: flex; align-items: center; gap: 16px; flex-wrap: wrap; font-size: 12.5px; color: var(--dim); margin: 0 0 16px; }
+  .engage b { color: var(--text); font-weight: 600; }
+  .engage .spark { display: inline-flex; align-items: flex-end; gap: 2px; height: 22px; }
+  .engage .spark i { width: 6px; min-height: 2px; border-radius: 1px; display: inline-block; }
+  .engage .rk { color: var(--faint); }
 
   /* ── reflection ── */
   .refl { border-left: 2px solid var(--line-2); padding: 4px 0 4px 16px; margin-bottom: 16px; }
@@ -238,6 +243,7 @@
       <div class="value-num num" id="valueNum">0</div>
       <div class="value-cap" id="valueCap"></div>
     </div>
+    <div class="engage" id="engage"></div>
     <div class="card" id="reads" style="padding:6px 16px"></div>
   </section>
 
@@ -417,6 +423,22 @@ function renderReads(reads, total) {
   }).join("");
 }
 
+/* ── engagement (retention pulse) ── */
+function renderEngage(a) {
+  const el = $("engage");
+  if (!a || !a.firstEventAt || !a.daily) { el.innerHTML = ""; return; }
+  const max = Math.max(...a.daily.map((d) => d.reads), 1);
+  const bars = a.daily.map((d, i) => {
+    const today = i === a.daily.length - 1;
+    const h = d.reads ? Math.max(3, Math.round((d.reads / max) * 22)) : 2;
+    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.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>`;
+}
+
 /* ── reflections ── */
 function renderReflections(assertions) {
   const behav = assertions.filter(a => a.payload && (a.payload.kind==="behavior" || a.payload.kind==="preference"));
@@ -594,16 +616,16 @@ $("vList").onclick = () => switchView("list");
 
 /* ── load ── */
 async function loadAll() {
-  let stats, profile, topics, reads, assertions, voice;
+  let stats, profile, topics, reads, assertions, voice, activity;
   try {
-    [stats, profile, topics, reads, assertions, voice] = await Promise.all([
+    [stats, profile, topics, reads, assertions, voice, activity] = await Promise.all([
       get("/stats"), get("/profile"), get("/topics?limit=40"),
-      get("/events?type=context.read&limit=60"), get("/events?type=signal.assertion&limit=20"), get("/voice"),
+      get("/events?type=context.read&limit=60"), get("/events?type=signal.assertion&limit=20"), get("/voice"), get("/activity"),
     ]);
     if (!stats) throw new Error("no daemon");
   } catch (e) {
     DEMO = true; $("ribbon").classList.add("show");
-    ({ stats, profile, topics, reads, assertions, voice } = DEMO_DATA());
+    ({ stats, profile, topics, reads, assertions, voice, activity } = DEMO_DATA());
   }
   topics = topics||[]; reads = reads||[]; assertions = assertions||[];
   const st = $("status");
@@ -618,6 +640,7 @@ async function loadAll() {
   renderTopicList(topics);
   renderMap(topics);
   renderReads(reads, total);
+  renderEngage(activity);
   renderReflections(assertions);
   saveSnapshot(topics);
 }
@@ -635,9 +658,10 @@ $("reflect").onclick = async () => {
 };
 setInterval(async () => {
   if (DEMO) return;
-  const [reads, stats, voice] = await Promise.all([get("/events?type=context.read&limit=60"), get("/stats"), get("/voice")]);
+  const [reads, stats, voice, activity] = await Promise.all([get("/events?type=context.read&limit=60"), get("/stats"), get("/voice"), get("/activity")]);
   if (reads && stats) renderReads(reads, (stats.byType && stats.byType["context.read"]) || reads.length);
   if (voice) renderVoice(voice); // live: voice signals captured mid-session show up without a reload
+  if (activity) renderEngage(activity);
 }, 25000);
 
 loadAll();
@@ -683,6 +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), 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

@@ -35,6 +35,23 @@ export interface StoredProfile {
     generated_at: string;
     model: string;
 }
+export interface Activity {
+    firstEventAt: string | null;
+    firstReadAt: string | null;
+    lastReadAt: string | null;
+    daysSinceFirst: number;
+    daysSinceFirstRead: number;
+    totalReads: number;
+    reads7d: number;
+    reads30d: number;
+    activeDays7d: number;
+    activeDays14d: number;
+    retainedWeek2: boolean | null;
+    daily: {
+        date: string;
+        reads: number;
+    }[];
+}
 export declare class EventStore {
     private db;
     constructor(path?: string);
@@ -53,6 +70,12 @@ export declare class EventStore {
         first: string | null;
         last: string | null;
     };
+    /**
+     * Engagement over time from context.read events — the retention pulse.
+     * Local/per-install only (this machine); aggregate cohort retention would
+     * require opt-in telemetry. `now` is injectable for deterministic tests.
+     */
+    activity(now?: number): Activity;
     topics(limit?: number): TopicRow[];
     /** Re-derive view_topics from signal.topic events using decayed per-signal weighting. */
     rebuild(now?: number): void;

package/build/src/store.js

@@ -150,6 +150,60 @@ export class EventStore {
         const span = this.db.prepare("SELECT MIN(ts) first, MAX(ts) last FROM events").get();
         return { total, byType: group("type"), bySource: group("source"), ...span };
     }
+    /**
+     * Engagement over time from context.read events — the retention pulse.
+     * Local/per-install only (this machine); aggregate cohort retention would
+     * require opt-in telemetry. `now` is injectable for deterministic tests.
+     */
+    activity(now = Date.now()) {
+        const DAY = 86_400_000;
+        const dayKey = (ms) => new Date(ms).toISOString().slice(0, 10);
+        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);
+        let reads7d = 0, reads30d = 0, week2Read = false;
+        const days7 = new Set(), days14 = new Set();
+        for (const e of reads) {
+            const t = new Date(e.ts).getTime();
+            if (!Number.isFinite(t))
+                continue;
+            const age = now - t, k = dayKey(t);
+            if (age <= 7 * DAY) {
+                reads7d++;
+                days7.add(k);
+            }
+            if (age <= 14 * DAY)
+                days14.add(k);
+            if (age <= 30 * DAY)
+                reads30d++;
+            if (daily.has(k))
+                daily.set(k, (daily.get(k) ?? 0) + 1);
+            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: firstReadMs !== null && now >= firstReadMs + 14 * DAY ? week2Read : null,
+            daily: [...daily.entries()].map(([date, r]) => ({ date, reads: r })),
+        };
+    }
     topics(limit = 50) {
         const rows = this.db
             .prepare("SELECT * FROM view_topics ORDER BY weight DESC LIMIT ?")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "persnally",
-  "version": "2.4.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",