From af853ae669dfab7f7f382ff4fab65f176362e29a Mon Sep 17 00:00:00 2001
From: "prompt.ac/@jeffrey" <mail@aesthetic.computer>
Date: Wed, 30 Sep 2026 17:31:30 -0700
Subject: [PATCH] Track repeated Laklok feature use and report per-account
 activity trends

---
 system/public/aesthetic.computer/bios.mjs     |  4 ++
 .../public/aesthetic.computer/disks/chat.mjs  | 14 ++++-
 .../aesthetic.computer/disks/laklok.mjs       | 11 +++-
 .../lib/account-activity-model.mjs            |  6 +-
 .../lib/account-activity.mjs                  | 23 +++++---
 .../lib/laklok-activity.mjs                   | 22 ++++++++
 system/public/html/index.html                 | 33 +++++++++--
 system/public/network-privacy.html            | 10 +++-
 system/tests/account-activity.test.mjs        | 23 ++++++++
 system/tests/journey-report.test.mjs          | 27 ++++++++-
 system/tests/laklok-activity-browser.test.mjs | 56 +++++++++++++++++++
 toolchain/analytics/VISITS.md                 | 32 +++++++++++
 toolchain/analytics/journey-report.mjs        | 11 ++--
 toolchain/analytics/laklok-feature-report.mjs | 56 +++++++++++++++++++
 toolchain/laklok-sisters/PARITY.md            |  8 +++
 toolchain/mcp/analytics-mcp.mjs               | 15 +++--
 16 files changed, 322 insertions(+), 29 deletions(-)
 create mode 100644 system/public/aesthetic.computer/lib/laklok-activity.mjs
 create mode 100644 system/tests/laklok-activity-browser.test.mjs
 create mode 100644 toolchain/analytics/laklok-feature-report.mjs

diff --git a/system/public/aesthetic.computer/bios.mjs b/system/public/aesthetic.computer/bios.mjs
index 08a837017f..823de07783 100644
--- a/system/public/aesthetic.computer/bios.mjs
+++ b/system/public/aesthetic.computer/bios.mjs
@@ -18428,6 +18428,10 @@ async function boot(parsed, bpm = 60, resolution, debug) {
       return;
     }
 
+    if (type === "account:action") {
+      accountActivity.action(content?.action);
+      return;
+    }
     if (type === "visit:action") {
       window.acVisits?.action(content?.action);
       return;
diff --git a/system/public/aesthetic.computer/disks/chat.mjs b/system/public/aesthetic.computer/disks/chat.mjs
index 817f1f70ab..4580164afa 100644
--- a/system/public/aesthetic.computer/disks/chat.mjs
+++ b/system/public/aesthetic.computer/disks/chat.mjs
@@ -1045,6 +1045,7 @@ async function boot(
             token,
             sub: user.sub,
           });
+          options?.onAction?.("message_edit_requested");
           notice("EDITED");
         }
         return;
@@ -1054,7 +1055,11 @@ async function boot(
       // to start/stop the mini-player without reaching for the button.
       const radioCmd = parseRadioCommand(text);
       if (radioCmd) {
-        applyRadioCommand(radioCmd, send);
+        applyRadioCommand(radioCmd, message => {
+          send(message);
+          if (message.type === "stream:play") options?.onAction?.("radio_play_requested");
+          if (message.type === "stream:pause") options?.onAction?.("radio_pause_requested");
+        });
         notice(radioCmd.toast || "", ["orange", 0]);
         return;
       }
@@ -1103,6 +1108,7 @@ async function boot(
             sub: user.sub,
             font: userSelectedFont, // 🔤 Include selected font
           });
+          options?.onAction?.("message_send_requested");
           notice("SENT");
         }
       }
@@ -3395,7 +3401,11 @@ function act(
                     pen.y >= r8dioPlayerBounds.y && pen.y < r8dioPlayerBounds.y + r8dioPlayerBounds.h;
       if (inBar) {
         beep();
-        toggleR8dioPlayback(send);
+        toggleR8dioPlayback(message => {
+          send(message);
+          if (message.type === "stream:play") options?.onAction?.("radio_play_requested");
+          if (message.type === "stream:pause") options?.onAction?.("radio_pause_requested");
+        });
       }
     }
   }
diff --git a/system/public/aesthetic.computer/disks/laklok.mjs b/system/public/aesthetic.computer/disks/laklok.mjs
index 8f0ab97ffb..e9d22e24bb 100644
--- a/system/public/aesthetic.computer/disks/laklok.mjs
+++ b/system/public/aesthetic.computer/disks/laklok.mjs
@@ -18,6 +18,7 @@
 
 import { Chat } from "../lib/chat.mjs"; // TODO: Eventually expand to `net.Socket`
 import * as chat from "./chat.mjs"; // Import chat everywhere.
+import { laklokAction } from "../lib/laklok-activity.mjs";
 import {
   LAK_THEMES,
   realtimeTick,
@@ -142,7 +143,7 @@ function chatView() {
 function boot({ api, wipe, debug, send, hud, store, colon, params, jump, net, query }) {
   client = new Chat(debug, send);
   client.connect("clock"); // Connect to 'clock' chat. (DB stays `chat-clock`.)
-  chat.boot(api, client.system); // Use default font
+  chat.boot(api, client.system, { onAction: name => laklokAction(api, name) }); // Use default font
 
   // 🚫 chat.boot stamps a prompt.ac/chat QR to the LEFT of the HUD label; clear
   // it so laklok shows only its own laklok.com QR in the top-right (paintCorner).
@@ -393,12 +394,14 @@ function act($) {
   // so a tap on a chip never scrolls the chat underneath.
   if (e.is("touch") && hit(gearBox)) {
     settingsOpen = !settingsOpen;
+    if (settingsOpen) laklokAction($, "settings_opened");
     needsPaint?.();
     return;
   }
 
   // 📬 The envelope is the door to mail.
   if (e.is("touch") && !settingsOpen && hit(mailBox)) {
+    laklokAction($, "mail_open_requested");
     jump("mail");
     return;
   }
@@ -413,19 +416,23 @@ function act($) {
       if (chip) {
         const { type, value } = chip.action;
         if (type === "mode" && value === "vector") {
+          laklokAction($, "mode_switch_requested");
           jump("out:https://laklok.com/html/");
         } else if (type === "theme") {
+          if (lakTheme !== value) laklokAction($, "theme_changed");
           lakTheme = value;
           saveTema(store, value);
           if (value === "realtime") realtimeTick(); // catch up before first paint
           chat.refresh(client.system); // recolor cached message lines
           reportTema(net, value);
         } else if (type === "links") {
+          if (lakLinksOnly !== value) laklokAction($, "filter_changed");
           lakLinksOnly = value;
           store["laklok:links"] = value;
           store.persist("laklok:links");
           chat.refresh(client.system); // relayout the filtered feed
         } else if (type === "lang") {
+          if (lakLang !== value) laklokAction($, "language_changed");
           lakLang = value;
           saveLang(store, value);
         }
@@ -437,7 +444,7 @@ function act($) {
     return;
   }
 
-  chat.act($, chatView(), { allowDelete: true });
+  chat.act($, chatView(), { allowDelete: true, onAction: name => laklokAction($, name) });
 }
 
 function sim($) {
diff --git a/system/public/aesthetic.computer/lib/account-activity-model.mjs b/system/public/aesthetic.computer/lib/account-activity-model.mjs
index f266a60c03..3867114e3d 100644
--- a/system/public/aesthetic.computer/lib/account-activity-model.mjs
+++ b/system/public/aesthetic.computer/lib/account-activity-model.mjs
@@ -1,8 +1,9 @@
 import { VISIT_ACTIONS, visitProperty, visitSurface, visitReferrer, visitGroup } from "./visit-model.mjs";
+import { LAKLOK_ACTIONS, LAKLOK_PIECES, LAKLOK_FEATURE_VERSION } from "./laklok-activity.mjs";
 
 export const ACCOUNT_ACTIVITY_COLLECTION = "account-activity";
 export const SOTCE_ACTIONS = Object.freeze(["sotce_page_viewed", "sotce_page_visible_30s", "sotce_page_touched", "sotce_question_submitted"]);
-export const ACCOUNT_ACTIONS = Object.freeze(["piece_opened", ...VISIT_ACTIONS, ...SOTCE_ACTIONS]);
+export const ACCOUNT_ACTIONS = Object.freeze(["piece_opened", ...VISIT_ACTIONS, ...SOTCE_ACTIONS, ...LAKLOK_ACTIONS]);
 
 export function accountActivityRoute(host, path, action) {
   if (visitSurface(path) === null) return false;
@@ -31,7 +32,10 @@ export function validateAccountActivity(body, origin) {
       !/^[a-z0-9-]{1,64}$/.test(body.piece) || visitSurface(`/${body.piece}`) === null ||
       typeof body.automated !== "boolean") return null;
   if (SOTCE_ACTIONS.includes(body.action) && (property !== "sotce.net" || body.piece !== "sotce")) return null;
+  const laklok = property !== "sotce.net" && LAKLOK_PIECES.includes(body.piece) && body.featureVersion === LAKLOK_FEATURE_VERSION;
+  if (LAKLOK_ACTIONS.includes(body.action) && !laklok) return null;
   return { id: body.id.toLowerCase(), session: body.session.toLowerCase(), sequence: body.sequence, property,
+    ...(laklok ? { featureVersion: LAKLOK_FEATURE_VERSION } : {}),
     tenant: property === "sotce.net" ? "sotce" : "aesthetic", piece: body.piece,
     action: body.action, automated: body.automated,
     referrerHost: typeof body.referrerHost === "string" ? visitReferrer(body.referrerHost) : null };
diff --git a/system/public/aesthetic.computer/lib/account-activity.mjs b/system/public/aesthetic.computer/lib/account-activity.mjs
index 4d89fb9d67..d502ea478c 100644
--- a/system/public/aesthetic.computer/lib/account-activity.mjs
+++ b/system/public/aesthetic.computer/lib/account-activity.mjs
@@ -1,4 +1,5 @@
 import { activityPiece, accountActivityRoute, SOTCE_ACTIONS } from "./account-activity-model.mjs";
+import { LAKLOK_ACTIONS, LAKLOK_PIECES, LAKLOK_FEATURE_VERSION } from "./laklok-activity.mjs";
 import { automatedVisit, visitProperty, visitSurface, visitReferrer, VISIT_ACTIONS } from "./visit-model.mjs";
 
 // Authenticated activity has its own short-lived session and endpoint. It does
@@ -9,7 +10,7 @@ export function startAccountActivity(win = window, doc = document, {
 } = {}) {
   if (win.acAccountActivity) return win.acAccountActivity;
   let piece = null, ready = false, owner = null, session = null, generation = 0, sequence = 0, stopped = false;
-  let sent = new Set(), pending = new Set(), retryAt = 0;
+  let sent = new Set(), pending = new Set(), retryAt = 0, inFlight = 0;
   const allowed = action => !stopped && win === win.top && doc.visibilityState === "visible" &&
     !win.acPACK_MODE && !win.acVisitTrackingDisabled &&
     win.navigator.doNotTrack !== "1" && win.doNotTrack !== "1" && !win.navigator.globalPrivacyControl &&
@@ -24,13 +25,18 @@ export function startAccountActivity(win = window, doc = document, {
   }
   async function record(action) {
     syncOwner();
-    const repeated = SOTCE_ACTIONS.includes(action);
-    if (repeated && (visitProperty(win.location.hostname) !== "sotce.net" || piece !== "sotce")) return;
-    if (!owner || !piece || !ready || !allowed(action) || (!repeated && sent.has(action)) || pending.has(action) || Date.now() < retryAt) return;
+    const laklok = LAKLOK_ACTIONS.includes(action);
+    const sotce = SOTCE_ACTIONS.includes(action);
+    const repeated = laklok || sotce;
+    if (sotce && (visitProperty(win.location.hostname) !== "sotce.net" || piece !== "sotce")) return;
+    if (laklok && !LAKLOK_PIECES.includes(piece)) return;
+    if (!owner || !piece || !ready || !allowed(action) || (!repeated && sent.has(action)) ||
+        (!laklok && pending.has(action)) || inFlight >= 20 || Date.now() < retryAt) return;
     const epoch = generation, subject = owner, activeSession = session, activePiece = piece;
     const order = ++sequence;
     const activePending = pending, activeSent = sent;
     activePending.add(action);
+    inFlight++;
     let timeout;
     const controller = new AbortController();
     try {
@@ -38,15 +44,16 @@ export function startAccountActivity(win = window, doc = document, {
       const token = await Promise.race([Promise.resolve().then(getToken), expired]);
       if (!token || epoch !== generation || subject !== getUser()?.sub || !allowed(action)) return;
       const response = await win.fetch("https://aesthetic.computer/api/account-activity", {
-        method: "POST", credentials: "omit", referrerPolicy: "no-referrer", signal: controller.signal,
+        method: "POST", credentials: "omit", referrerPolicy: "no-referrer", signal: controller.signal, keepalive: true,
         headers: { "Content-Type": "application/json", Authorization: `Bearer ${token}` },
         body: JSON.stringify({ version: 1, id: win.crypto.randomUUID(), session: activeSession,
-          sequence: order, piece: activePiece, action, automated: false, referrerHost: visitReferrer(doc.referrer) }),
+          sequence: order, piece: activePiece, action, automated: false, referrerHost: visitReferrer(doc.referrer),
+          ...(LAKLOK_PIECES.includes(activePiece) ? { featureVersion: LAKLOK_FEATURE_VERSION } : {}) }),
       });
       if (response.ok) activeSent.add(action);
       else retryAt = Date.now() + 30000;
     } catch { retryAt = Date.now() + 30000; }
-    finally { win.clearTimeout(timeout); activePending.delete(action); }
+    finally { inFlight--; win.clearTimeout(timeout); activePending.delete(action); }
   }
   const timer = win.setInterval(() => {
     syncOwner();
@@ -60,7 +67,7 @@ export function startAccountActivity(win = window, doc = document, {
   const api = {
     load(path) { piece = activityPiece(path); ready = false; sent = new Set(); pending = new Set(); generation++; },
     ready() { ready = true; void record("piece_opened"); },
-    action(name) { if (VISIT_ACTIONS.includes(name) || SOTCE_ACTIONS.includes(name)) void record(name); },
+    action(name) { if (VISIT_ACTIONS.includes(name) || SOTCE_ACTIONS.includes(name) || LAKLOK_ACTIONS.includes(name)) void record(name); },
     stop() { stopped = true; generation++; win.clearInterval(timer); if (win.acAccountActivity === api) delete win.acAccountActivity; },
   };
   win.acAccountActivity = api;
diff --git a/system/public/aesthetic.computer/lib/laklok-activity.mjs b/system/public/aesthetic.computer/lib/laklok-activity.mjs
new file mode 100644
index 0000000000..f4680c67d3
--- /dev/null
+++ b/system/public/aesthetic.computer/lib/laklok-activity.mjs
@@ -0,0 +1,22 @@
+// Reviewed feature names only: no messages, links, recipients or preference values.
+export const LAKLOK_FEATURE_VERSION = 1;
+export const LAKLOK_PIECES = ["laklok", "laklok-vector"];
+export const LAKLOK_FEATURES = Object.freeze({
+  laklok_settings_opened: ["raster", "vector"],
+  laklok_theme_changed: ["raster", "vector"],
+  laklok_filter_changed: ["raster", "vector"],
+  laklok_language_changed: ["raster"],
+  laklok_mode_switch_requested: ["raster", "vector"],
+  laklok_mail_open_requested: ["raster"],
+  laklok_radio_play_requested: ["raster"],
+  laklok_radio_pause_requested: ["raster"],
+  laklok_message_send_requested: ["raster", "vector"],
+  laklok_message_edit_requested: ["raster", "vector"],
+  laklok_history_older_requested: ["vector"],
+  laklok_media_open_requested: ["vector"],
+});
+export const LAKLOK_ACTIONS = Object.freeze(Object.keys(LAKLOK_FEATURES));
+export function laklokAction(api, name) {
+  const action = `laklok_${name}`;
+  if (LAKLOK_ACTIONS.includes(action)) api.send?.({ type: "account:action", content: { action } });
+}
diff --git a/system/public/html/index.html b/system/public/html/index.html
index 03379f21b4..d44749a695 100644
--- a/system/public/html/index.html
+++ b/system/public/html/index.html
@@ -407,6 +407,8 @@
   <div id="lightbox"><img alt="" /></div>
 
 <script type="module">
+import { startAccountActivity } from "/aesthetic.computer/lib/account-activity.mjs";
+function laklokEvent(name) { window.acAccountActivity?.action("laklok_" + name); }
 // ── laklok HTML chat client ────────────────────────────────────────────────
 // Connects to the live `chat-clock` instance (Laer Klokken). History via REST,
 // realtime via WebSocket — same wire protocol as the AC piece, no AC runtime.
@@ -428,6 +430,12 @@ const $send = document.getElementById("send");
 const $gate = document.getElementById("gate");
 const $gear = document.getElementById("gear");
 const $settings = document.getElementById("settings");
+$log.addEventListener("click", e => {
+  if (e.isTrusted && e.target.closest("a.embed")) laklokEvent("media_open_requested");
+});
+$log.addEventListener("play", e => {
+  if (e.isTrusted && e.target.matches("video.embed,audio.embed")) laklokEvent("media_open_requested");
+}, true);
 
 // 🎪 Circus marquee — each letter its own color + bounce phase.
 const CIRCUS = ["#ff5050","#ffd246","#78d2ff","#8cf096","#ff96dc","#b496ff"];
@@ -527,6 +535,7 @@ applyLinksFilter(linksOnly);
 $gear.onclick = (e) => {
   e.stopPropagation();
   const open = $settings.classList.toggle("open");
+  if (open) laklokEvent("settings_opened");
   $gear.classList.toggle("open", open);
 };
 document.addEventListener("click", (e) => {
@@ -538,9 +547,15 @@ document.addEventListener("click", (e) => {
 $settings.addEventListener("click", (e) => {
   const chip = e.target.closest(".chip");
   if (!chip) return;
-  if (chip.dataset.mode === "raster") location.href = "https://laklok.com";
-  if (chip.dataset.tema) { applyTheme(chip.dataset.tema); reportTheme(); }
-  if (chip.dataset.links !== undefined) applyLinksFilter(chip.dataset.links === "1");
+  if (chip.dataset.mode === "raster") { laklokEvent("mode_switch_requested"); location.href = "https://laklok.com"; }
+  if (chip.dataset.tema) {
+    if (theme !== chip.dataset.tema) laklokEvent("theme_changed");
+    applyTheme(chip.dataset.tema); reportTheme();
+  }
+  if (chip.dataset.links !== undefined) {
+    if (linksOnly !== (chip.dataset.links === "1")) laklokEvent("filter_changed");
+    applyLinksFilter(chip.dataset.links === "1");
+  }
 });
 
 // ── Handle tinting ──────────────────────────────────────────────────────────
@@ -672,6 +687,7 @@ function ogEmbed(url) {
       listen.className = "listen"; listen.textContent = "▶"; listen.title = "lyt her";
       listen.onclick = (e) => {
         e.preventDefault(); e.stopPropagation(); // play in place, don't open the link
+        laklokEvent("media_open_requested");
         const frame = document.createElement("iframe");
         frame.className = "embed player"; frame.allow = "autoplay";
         frame.src = meta.player.src; frame.title = meta.title || "SoundCloud";
@@ -745,6 +761,7 @@ function attachEmbeds(row, text) {
 const $lightbox = document.getElementById("lightbox");
 const $lightboxImg = $lightbox.querySelector("img");
 function lightbox(src) {
+  laklokEvent("media_open_requested");
   if (!src) return;
   $lightboxImg.src = src;
   $lightbox.classList.add("open");
@@ -1107,7 +1124,7 @@ async function loadHistory(before = null) {
   }
   loadingMore = false;
 }
-$loadmore.onclick = () => { if (!exhausted) loadHistory(oldestCursor); };
+$loadmore.onclick = () => { if (!exhausted) { laklokEvent("history_older_requested"); loadHistory(oldestCursor); } };
 $log.addEventListener("scroll", () => { if ($log.scrollTop < 60 && !exhausted) loadHistory(oldestCursor); });
 
 // ── Presence ──────────────────────────────────────────────────────────────────
@@ -1125,6 +1142,12 @@ function setPresence(online, here) {
 // Signing in at laklok.com (the raster piece) stores the SPA SDK cache under
 // `@@auth0spajs@@…` keys; posting sends the same access token the piece would.
 const auth = { token: null, sub: null, handle: null };
+const accountActivity = startAccountActivity(window, document, {
+  getUser: () => auth.sub ? { sub: auth.sub } : null,
+  getToken: () => { const session = findAcSession(); return session?.sub === auth.sub ? session.token : null; },
+});
+accountActivity.load("aesthetic.computer/disks/laklok-vector");
+accountActivity.ready();
 
 // 📊 Theme census — the same /api/laklok-theme the raster piece reports to:
 // once at sign-in and on every tema chip tap. Anonymous readers aren't counted.
@@ -1296,12 +1319,14 @@ function post(text) {
       type: "chat:edit",
       content: { id: editingId, text, token: auth.token, sub: auth.sub },
     }));
+    laklokEvent("message_edit_requested");
     cancelEdit();
   } else {
     ws.send(JSON.stringify({
       type: "chat:message",
       content: { text, token: auth.token, sub: auth.sub, font: "font_1" },
     }));
+    laklokEvent("message_send_requested");
   }
 }
 // 🗑 Same payload the raster's copy-modal delete sends; the server answers
diff --git a/system/public/network-privacy.html b/system/public/network-privacy.html
index 4940478e94..a8f4f926c6 100644
--- a/system/public/network-privacy.html
+++ b/system/public/network-privacy.html
@@ -36,11 +36,19 @@ not a log of every note or stroke. Sotce also records each displayed-page
 milestone after two visible seconds, thirty seconds of foreground page display,
 newly saved touches and successful question submissions. These are activity
 signals, not proof that someone read a page.</p>
+<p>Laer Klokken's canvas and HTML clients record repeated feature-use events
+for signed-in accounts: opening settings, changing themes and filters,
+switching interfaces, and requesting message sends or edits. Controls specific
+to each interface also record radio, language, mail navigation, older-history
+and media-opening requests. These contain feature names, not messages,
+recipients, media identifiers or link destinations. Requests do not prove
+successful delivery or playback. We use these records to compare feature use
+by account over the retained 35-day window.</p>
 <p>This feed lets our administrators follow account activity and resolve public
 handles. It is not joined to anonymous visit identifiers and does not assign
 earlier anonymous activity to an account. Records expire after 35 days. The
 same privacy controls and private-route exclusions apply, except for the
-successful-submission milestone in Sotce's question form. Chat, form contents,
+successful-submission milestone in Sotce's question form. Chat text, form contents,
 full referring URLs and search parameters are excluded. Account activity is
 not proof that a unique human was present.</p>
 <p>A missing referrer means direct or unavailable: browsers, apps and redirects
diff --git a/system/tests/account-activity.test.mjs b/system/tests/account-activity.test.mjs
index 682cfd7357..431ee939b0 100644
--- a/system/tests/account-activity.test.mjs
+++ b/system/tests/account-activity.test.mjs
@@ -5,6 +5,7 @@ import { createAccountActivityHandler } from "../backend/account-activity-handle
 import { startAccountActivity } from "../public/aesthetic.computer/lib/account-activity.mjs";
 import { visitReferrer } from "../public/aesthetic.computer/lib/visit-model.mjs";
 import { activityPiece, validateAccountActivity, SOTCE_ACTIONS } from "../public/aesthetic.computer/lib/account-activity-model.mjs";
+import { laklokAction } from "../public/aesthetic.computer/lib/laklok-activity.mjs";
 
 const snapshot = () => ({ version: 1, id: randomUUID(), session: randomUUID(), sequence: 1, piece: "notepat", action: "note_played", automated: false, referrerHost: "example.org" });
 test("referral reporting keeps only public site names", () => {
@@ -116,3 +117,25 @@ test("Sotce action sequences stay in their tenant and private editors permit onl
   assert.equal(f.sent.length, count + 1);
   f.api.stop();
 });
+
+test("laklok feature events preserve rapid repeated uses, reject other pieces and carry no content", async () => {
+  const signals = [];
+  laklokAction({ send: value => signals.push(value) }, "settings_opened");
+  laklokAction({ send: value => signals.push(value) }, "arbitrary-message-text");
+  assert.deepEqual(signals, [{ type: "account:action", content: { action: "laklok_settings_opened" } }]);
+  const body = { ...snapshot(), piece: "laklok", action: "laklok_settings_opened", featureVersion: 1 };
+  assert.equal(validateAccountActivity(body, "https://laklok.com").featureVersion, 1);
+  assert.equal(validateAccountActivity({ ...body, piece: "notepat" }, "https://laklok.com"), null);
+  assert.equal(validateAccountActivity({ ...body, featureVersion: undefined }, "https://laklok.com"), null);
+  const f = browserFixture();
+  f.user({ sub: "one" }); f.api.load("aesthetic.computer/disks/laklok"); f.api.ready(); await settle();
+  f.api.action("laklok_settings_opened"); f.api.action("laklok_settings_opened"); f.api.action("laklok_settings_opened"); await settle();
+  const rows = f.sent.map(row => JSON.parse(row.body));
+  assert.equal(rows.filter(row => row.action === "laklok_settings_opened").length, 3);
+  assert.deepEqual(rows.map(row => row.sequence), [1, 2, 3, 4]);
+  assert.ok(rows.every(row => row.featureVersion === 1));
+  f.api.load("aesthetic.computer/disks/notepat"); f.api.ready(); await settle();
+  const count = f.sent.length;
+  f.api.action("laklok_settings_opened"); await settle(); assert.equal(f.sent.length, count);
+  f.api.stop();
+});
diff --git a/system/tests/journey-report.test.mjs b/system/tests/journey-report.test.mjs
index b667aabccc..1e03442d51 100644
--- a/system/tests/journey-report.test.mjs
+++ b/system/tests/journey-report.test.mjs
@@ -6,6 +6,7 @@ import { readFile } from "node:fs/promises";
 import { createHash } from "node:crypto";
 import { Query, Aggregator } from "mingo";
 import * as model from "../public/aesthetic.computer/lib/visit-model.mjs";
+import { laklokFeatureReport } from "../../toolchain/analytics/laklok-feature-report.mjs";
 
 async function report(mode, args, data) {
   let output, closed = false;
@@ -29,7 +30,7 @@ async function report(mode, args, data) {
   await module.link(specifier => {
     const exports = specifier === "node:crypto" ? { createHash }
       : specifier.includes("database.mjs") ? { connect: async () => ({ db }), closePool: async () => { closed = true; } }
-      : model;
+      : specifier.includes("laklok-feature-report") ? { laklokFeatureReport } : model;
     return new vm.SyntheticModule(Object.keys(exports), function () {
       for (const [key, value] of Object.entries(exports)) this.setExport(key, value);
     }, { context });
@@ -39,6 +40,30 @@ async function report(mode, args, data) {
   return output;
 }
 const at = new Date(Date.now() - 1000);
+test("feature usage counts repeated actions, excludes uninstrumented history and limits zero-use claims to supported controls", async () => {
+  const base = { user: "auth0|one", tenant: "aesthetic", property: "laklok.com", at, piece: "laklok-vector", featureVersion: 1 };
+  const data = { "account-activity": [
+    { ...base, action: "piece_opened" },
+    { ...base, action: "laklok_theme_changed" },
+    { ...base, action: "laklok_theme_changed" },
+    { ...base, action: "laklok_filter_changed", at: new Date(+at - 86400000) },
+    { ...base, user: "old-user", featureVersion: undefined, action: "piece_opened" },
+    { ...base, user: "auth0|two", piece: "laklok", action: "piece_opened" },
+  ], "@handles": [{ _id: "auth0|one", handle: "listener" }] };
+  const result = await report("features", { hours: 48, handle: "@listener", limit: 1 }, data);
+  assert.equal(result.accounts.length, 1);
+  const account = result.accounts[0];
+  assert.equal(account.account, "@listener");
+  assert.equal(account.features.laklok_theme_changed, 2);
+  assert.ok(account.notRecorded.includes("laklok_message_send_requested"));
+  assert.ok(!account.notRecorded.includes("laklok_radio_play_requested"), "vector has no radio control");
+  assert.equal(account.daily.length, 2);
+  assert.equal(account.daily.reduce((n, row) => n + row.uses, 0), 3);
+  assert.equal(result.topFeatures[0].count, 2);
+  assert.doesNotMatch(JSON.stringify(result), /auth0\||old-user/);
+  const bounded = await report("features", { hours: 48, limit: 1 }, data);
+  assert.equal(bounded.truncated, true);
+});
 test("private account report counts distinct tenant/accounts, resolves handles and bounds event detail", async () => {
   const data = {
     "account-activity": [
diff --git a/system/tests/laklok-activity-browser.test.mjs b/system/tests/laklok-activity-browser.test.mjs
new file mode 100644
index 0000000000..030f40b980
--- /dev/null
+++ b/system/tests/laklok-activity-browser.test.mjs
@@ -0,0 +1,56 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { readFile } from "node:fs/promises";
+import { chromium } from "playwright";
+
+test("HTML laklok records repeated control use and send requests without exporting text", async () => {
+  const browser = await chromium.launch({ headless: true, channel: process.env.PLAYWRIGHT_CHANNEL });
+  try {
+    const context = await browser.newContext({ userAgent: "Mozilla/5.0 Chrome/135.0.0.0 Safari/537.36" });
+    const events = [];
+    await context.route("**/*", async route => {
+      const req = route.request(), url = new URL(req.url());
+      if (url.pathname === "/api/account-activity") {
+        if (req.method() === "POST") events.push(JSON.parse(req.postData()));
+        return route.fulfill({ status: 204, headers: { "Access-Control-Allow-Origin": "*", "Access-Control-Allow-Headers": "Authorization, Content-Type", "Access-Control-Allow-Methods": "POST, OPTIONS" } });
+      }
+      if (url.pathname.startsWith("/aesthetic.computer/lib/") && /^[a-z-]+\.mjs$/.test(url.pathname.split("/").at(-1))) {
+        return route.fulfill({ contentType: "text/javascript", body: await readFile(new URL(`../public${url.pathname}`, import.meta.url), "utf8") });
+      }
+      if (url.pathname === "/html/") return route.fulfill({ contentType: "text/html", body: await readFile(new URL("../public/html/index.html", import.meta.url), "utf8") });
+      if (url.pathname === "/handle") return route.fulfill({ json: { handle: "fixture" } });
+      if (url.pathname === "/api/chat-messages") return route.fulfill({ json: { messages: [] } });
+      return route.fulfill({ status: 404 });
+    });
+    const page = await context.newPage();
+    await page.addInitScript(() => {
+      // Synthetic auth/automation overrides exist only inside this intercepted fixture.
+      Object.defineProperty(navigator, "webdriver", { get: () => false });
+      localStorage.setItem("@@auth0spajs@@fixture", JSON.stringify({ expiresAt: Date.now() / 1000 + 3600,
+        body: { access_token: "fixture-token", decodedToken: { claims: { sub: "auth0|fixture" } } } }));
+      window.WebSocket = class {
+        readyState = 1;
+        constructor() { setTimeout(() => this.onopen?.(), 0); }
+        send() {} close() {}
+      };
+    });
+    await page.goto("https://laklok.com/html/");
+    await page.waitForFunction(() => !!window.acAccountActivity && !document.getElementById("input").disabled);
+    await page.locator("#gear").click();
+    await page.locator('[data-tema="nat"]').click();
+    await page.locator('[data-links="1"]').click();
+    await page.locator("#gear").click(); await page.locator("#gear").click();
+    await page.locator("#input").fill("THIS_STAYS_PRIVATE");
+    await page.locator("#input").press("Enter");
+    await page.waitForTimeout(150);
+    assert.equal(events.filter(row => row.action === "laklok_settings_opened").length, 2);
+    for (const action of ["laklok_theme_changed", "laklok_filter_changed", "laklok_message_send_requested"])
+      assert.ok(events.some(row => row.action === action), action);
+    assert.ok(events.every(row => row.piece === "laklok-vector" && row.featureVersion === 1));
+    assert.doesNotMatch(JSON.stringify(events), /THIS_STAYS_PRIVATE|fixture-token|auth0\|fixture/);
+    const count = events.length;
+    await page.evaluate(() => { window.acVisitTrackingDisabled = true; });
+    await page.locator("#gear").click(); await page.locator("#gear").click();
+    await page.waitForTimeout(100); assert.equal(events.length, count);
+  } finally { await browser.close(); }
+});
diff --git a/toolchain/analytics/VISITS.md b/toolchain/analytics/VISITS.md
index 1f39e37107..a968d65624 100644
--- a/toolchain/analytics/VISITS.md
+++ b/toolchain/analytics/VISITS.md
@@ -211,6 +211,38 @@ within a session and carry client sequence numbers. They remain best-effort
 browser reports with server-verified identity; the existing `sotce-touches`
 and `sotce-asks` collections are authoritative for saved operation totals.
 
+### Laer Klokken feature use
+
+`/laer-klokken` aliases to `laklok`. Both that canvas piece and the standalone
+HTML sister (`laklok.com/html/`, recorded as `laklok-vector`) now send repeated
+authenticated feature events. `lib/laklok-activity.mjs` is the reviewed catalog
+and identifies which controls exist in each interface. It contains no message,
+recipient, link, chosen theme or language values. Boot restores and repeated
+clicks on the already-selected theme/filter do not count as changes.
+
+The canvas worker uses `account:action`; BIOS passes only the action name to
+the first-party account collector. The HTML client uses its existing Auth0
+session, rechecks token expiry when sending, and posts to the same endpoint.
+The server verifies identity and rejects Laklok events attributed to another
+piece. These detailed counts require sign-in; anonymous visits keep their
+existing broad measurements. Opt-outs, private routes and automation guards
+still apply. Radio/send/edit/media/navigation events are named `*_requested`
+and must not be reported as successful playback, delivery or completed loading.
+
+Use `feature_usage({hours:168})`, optionally with `handle:"@someone"`, for ranked
+features, counts per account and UTC daily opens/action counts. Maximum lookback
+is 840 hours (35 days), with at most 50 account rows. Top-feature totals cover
+all matching accounts even when account detail is truncated. `property` can
+restrict to a reviewed host; omitting it includes Laklok served through AC too.
+
+Reports require `featureVersion:1`, so earlier piece opens do not fabricate
+unused-feature rows. `notRecorded` means zero recorded uses of a control
+supported by that account's observed interface, not proof the control was
+visible or unused. Days without events are unobserved. Counts are best effort:
+offline use, opt-outs, unloads and rate limits can leave gaps. Repeated Laklok
+events are not deduplicated while a prior request is in flight; the client caps
+concurrent sends at 20 and the server's per-account rate limit still applies.
+
 ### Website installation
 
 The shared AC shell covers AC, notepat.com, nopaint.art, laklok.com and mime.ac
diff --git a/toolchain/analytics/journey-report.mjs b/toolchain/analytics/journey-report.mjs
index 840e5a7724..a5aa1c63e3 100644
--- a/toolchain/analytics/journey-report.mjs
+++ b/toolchain/analytics/journey-report.mjs
@@ -3,11 +3,12 @@
 import { createHash } from "node:crypto";
 import { connect, closePool } from "../../system/backend/database.mjs";
 import { visitScopeMatch, visitReferrer, visitProperty, visitSurface, automatedVisit } from "../../system/public/aesthetic.computer/lib/visit-model.mjs";
+import { laklokFeatureReport } from "./laklok-feature-report.mjs";
 
 const mode = process.argv[2];
-const { hours = 24, limit = 100, handle, scope = "studio", property } = JSON.parse(process.argv[3] || "{}");
-if (!["accounts", "referrers"].includes(mode) || !Number.isFinite(hours) || hours <= 0 || hours > 840 ||
-    !Number.isInteger(limit) || limit < 1 || limit > 500 ||
+const { hours = 24, limit = mode === "features" ? 30 : 100, handle, scope = "studio", property } = JSON.parse(process.argv[3] || "{}");
+if (!["accounts", "referrers", "features"].includes(mode) || !Number.isFinite(hours) || hours <= 0 || hours > 840 ||
+    !Number.isInteger(limit) || limit < 1 || limit > (mode === "features" ? 50 : 500) ||
     (handle !== undefined && !/^@?[a-z0-9_-]{1,64}$/i.test(handle))) throw new Error("Invalid report options");
 const scoped = visitScopeMatch(scope), end = new Date(), start = new Date(+end - hours * 3600000);
 if (property !== undefined) {
@@ -17,7 +18,9 @@ if (property !== undefined) {
 }
 const { db } = await connect();
 try {
-  if (mode === "accounts") {
+  if (mode === "features") {
+    console.log(JSON.stringify(await laklokFeatureReport(db, { start, end, scoped, handle, limit })));
+  } else if (mode === "accounts") {
     const query = { at: { $gte: start, $lt: end }, ...scoped };
     if (handle) {
       const handles = await db.collection("@handles").find({ handle: handle.replace(/^@/, "") }, { projection: { _id: 1 } }).limit(10).toArray();
diff --git a/toolchain/analytics/laklok-feature-report.mjs b/toolchain/analytics/laklok-feature-report.mjs
new file mode 100644
index 0000000000..099b1f18c5
--- /dev/null
+++ b/toolchain/analytics/laklok-feature-report.mjs
@@ -0,0 +1,56 @@
+import { createHash } from "node:crypto";
+import { LAKLOK_FEATURES, LAKLOK_ACTIONS, LAKLOK_PIECES, LAKLOK_FEATURE_VERSION } from "../../system/public/aesthetic.computer/lib/laklok-activity.mjs";
+
+export async function laklokFeatureReport(db, { start, end, scoped, handle, limit }) {
+  const query = { ...scoped, at: { $gte: start, $lt: end }, tenant: "aesthetic",
+    piece: { $in: LAKLOK_PIECES }, featureVersion: LAKLOK_FEATURE_VERSION,
+    action: { $in: ["piece_opened", ...LAKLOK_ACTIONS] } };
+  if (handle) {
+    const rows = await db.collection("@handles").find({ handle: handle.replace(/^@/, "") }, { projection: { _id: 1 } }).limit(10).toArray();
+    query.user = { $in: rows.map(row => String(row._id)).filter(id => !id.startsWith("sotce-")) };
+  }
+  const collection = db.collection("account-activity");
+  const aggregate = pipeline => collection.aggregate(pipeline, { maxTimeMS: 10000 }).toArray();
+  const rows = await aggregate([
+    { $match: query },
+    { $group: { _id: "$user", first: { $min: "$at" }, last: { $max: "$at" },
+      pieces: { $addToSet: "$piece" }, opens: { $sum: { $cond: [{ $eq: ["$action", "piece_opened"] }, 1, 0] } } } },
+    { $sort: { last: -1, _id: 1 } }, { $limit: limit + 1 },
+  ]);
+  const selected = rows.slice(0, limit), users = selected.map(row => row._id);
+  const selectedQuery = { ...query, user: { $in: users } };
+  const counts = await aggregate([
+    { $match: { ...selectedQuery, action: { $in: LAKLOK_ACTIONS } } },
+    { $group: { _id: { user: "$user", action: "$action" }, count: { $sum: 1 } } },
+  ]);
+  const daily = await aggregate([
+    { $match: selectedQuery },
+    { $group: { _id: { user: "$user", day: { $dateToString: { format: "%Y-%m-%d", date: "$at", timezone: "+00:00" } } },
+      opens: { $sum: { $cond: [{ $eq: ["$action", "piece_opened"] }, 1, 0] } },
+      uses: { $sum: { $cond: [{ $ne: ["$action", "piece_opened"] }, 1, 0] } } } },
+    { $sort: { "_id.day": 1 } },
+  ]);
+  const topFeatures = await aggregate([
+    { $match: { ...query, action: { $in: LAKLOK_ACTIONS } } },
+    { $group: { _id: { user: "$user", action: "$action" }, count: { $sum: 1 } } },
+    { $group: { _id: "$_id.action", count: { $sum: "$count" }, accounts: { $sum: 1 } } },
+    { $sort: { count: -1, _id: 1 } },
+  ]);
+  const names = new Map((await db.collection("@handles").find({ _id: { $in: users } }, { projection: { handle: 1 } }).toArray()).map(row => [String(row._id), row.handle]));
+  return { product: "laklok", start, end, featureVersion: LAKLOK_FEATURE_VERSION,
+    note: "Recorded feature uses by authenticated account, not unique people. Only the instrumented rollout is included. Requests are not confirmed playback, message delivery or navigation. Zero means no recorded use of a supported feature during this window, not proof of non-use or exposure. Opt-outs, offline use and dropped events leave gaps. Daily buckets are UTC; absent days are unobserved. Top features cover all matching accounts; account detail is bounded.",
+    topFeatures: topFeatures.map(row => ({ action: row._id, count: row.count, accounts: row.accounts })),
+    truncated: rows.length > limit,
+    accounts: selected.map(row => {
+      const interfaces = [...new Set(row.pieces.map(piece => piece === "laklok-vector" ? "vector" : "raster"))];
+      const supported = LAKLOK_ACTIONS.filter(action => LAKLOK_FEATURES[action].some(mode => interfaces.includes(mode)));
+      const features = Object.fromEntries(supported.map(action => [action, 0]));
+      for (const item of counts) if (item._id.user === row._id) features[item._id.action] = item.count;
+      return { account: names.get(row._id) ? `@${names.get(row._id)}` : `account-${createHash("sha256").update(row._id).digest("hex").slice(0, 12)}`,
+        first: row.first, last: row.last, interfaces, opens: row.opens, features,
+        notRecorded: supported.filter(action => !features[action]),
+        daily: daily.filter(item => item._id.user === row._id).map(item => ({ day: item._id.day, opens: item.opens, uses: item.uses })),
+      };
+    }),
+  };
+}
diff --git a/toolchain/laklok-sisters/PARITY.md b/toolchain/laklok-sisters/PARITY.md
index 5d18adeedd..ae14701266 100644
--- a/toolchain/laklok-sisters/PARITY.md
+++ b/toolchain/laklok-sisters/PARITY.md
@@ -46,6 +46,7 @@ same change — an unmirrored constant is future drift.
 | Hearts display | chat.mjs | `.heart` | neither side *sends* `chat:heart` yet |
 | Presence + connection status | chat lib | header counts + dot | |
 | 128-char cap | chat.mjs `chatMaxChars` | `maxlength` | checked |
+| Authenticated feature events | `laklokAction` → BIOS → account-activity | existing Auth0 session → account-activity | shared catalog `lib/laklok-activity.mjs`; settings, theme/filter, mode, send/edit requests; no message contents |
 
 ## Known one-sided features (deliberate, revisit when they matter)
 
@@ -60,3 +61,10 @@ same change — an unmirrored constant is future drift.
 
 The biggest remaining gap is the attach/upload lane and `!tape` rendering on
 the vector side.
+
+Feature analytics follow actual interface capabilities: language, mail and
+radio controls are counted on raster; older-history and image/media openings
+on vector. The report excludes unsupported controls from zero-use lists.
+Other controls (including hearts, attach, delete, font picker and vox) are not
+yet instrumented. Radio and message events count requests, not playback or
+server-confirmed delivery. Both clients use the same opt-outs and 35-day feed.
diff --git a/toolchain/mcp/analytics-mcp.mjs b/toolchain/mcp/analytics-mcp.mjs
index 9796cbcede..f68d3a2a3d 100644
--- a/toolchain/mcp/analytics-mcp.mjs
+++ b/toolchain/mcp/analytics-mcp.mjs
@@ -50,8 +50,8 @@ async function humanFishery(args = {}) {
 }
 
 async function journeyReport(mode, args = {}) {
-  const { hours = 24, limit = 100, scope = "studio", handle, property } = args;
-  if (!Number.isFinite(hours) || hours <= 0 || hours > 840 || !Number.isInteger(limit) || limit < 1 || limit > 500 ||
+  const { hours = 24, limit = mode === "features" ? 30 : 100, scope = "studio", handle, property } = args;
+  if (!Number.isFinite(hours) || hours <= 0 || hours > 840 || !Number.isInteger(limit) || limit < 1 || limit > (mode === "features" ? 50 : 500) ||
       !["studio", "clients", "all"].includes(scope) || (handle !== undefined && !/^@?[a-z0-9_-]{1,64}$/i.test(handle))) throw new Error("Invalid report options");
   if (property !== undefined && !visitScopeMatch(scope).property.$in.includes(visitProperty(property))) throw new Error("Property is outside the selected scope");
   const quoted = "'" + JSON.stringify({ hours, limit, scope, handle, property }).replaceAll("'", "'\\''") + "'";
@@ -256,18 +256,20 @@ async function appDownloads({ days = 7, apps = Object.keys(APPS) } = {}) {
 // 🔌 MCP
 
 const TOOLS = [
-  ...["account_activity", "network_referrers"].map(name => ({
+  ...["account_activity", "network_referrers", "feature_usage"].map(name => ({
     name,
-    description: name === "account_activity"
+    description: name === "feature_usage"
+      ? "Laer Klokken/laklok feature-use counts by authenticated account: ranked controls, per-account counts, UTC daily activity and supported features with no recorded use. Covers canvas and HTML clients from the feature rollout onward. Zero is not proof of non-use. Optional public handle/property filter; up to 35 days, at most 50 accounts. No chat content, page contents or link destinations."
+      : name === "account_activity"
       ? "Follow server-verified authenticated accounts through public AC/Sotce activity: public handle, runtime session alias, piece opens and action milestones. Optional handle filter. Only records from the account-activity rollout onward; no inferred identities or retroactive joins to anonymous fish. Login does not prove human activity. Private SSH-backed read."
       : "Referral sites across the Aesthetic network: first-party visits plus separately labeled historical AC boot referrals. Domain only, no full referrer URLs. Null is direct-or-unavailable. Excludes known automation; visits and boots are separate instruments and must not be summed.",
     annotations: { readOnlyHint: true, destructiveHint: false },
     inputSchema: { type: "object", additionalProperties: false, properties: {
       hours: { type: "number", exclusiveMinimum: 0, maximum: 840, description: "Lookback hours; default 24" },
-      limit: { type: "integer", minimum: 1, maximum: 500, description: "Maximum rows; default 100" },
+      limit: { type: "integer", minimum: 1, maximum: name === "feature_usage" ? 50 : 500, description: name === "feature_usage" ? "Maximum accounts; default 30" : "Maximum rows; default 100" },
       scope: { type: "string", enum: ["studio", "clients", "all"], description: "Default studio" },
       property: { type: "string", description: "Optional reviewed site, e.g. sotce.net; must belong to selected scope" },
-      ...(name === "account_activity" ? { handle: { type: "string", description: "Optional public handle, with or without @" } } : {}),
+      ...(name !== "network_referrers" ? { handle: { type: "string", description: "Optional public handle, with or without @" } } : {}),
     } },
   })),
   {
@@ -340,6 +342,7 @@ const TOOLS = [
 async function callTool(name, args = {}) {
   const result = name === "visits_report" ? await visitsReport(args)
     : name === "account_activity" ? await journeyReport("accounts", args)
+    : name === "feature_usage" ? await journeyReport("features", args)
     : name === "network_referrers" ? await journeyReport("referrers", args)
     : name === "human_fishery" ? await humanFishery(args)
     : name === "direct_downloads" ? await directDownloads(args)
-- 
2.51.2