tweaklocal 0.1.0 → 0.1.1

package/README.md

@@ -29,6 +29,16 @@ npm i -D tweaklocal @tweaklocal/react
 
 Works with Turbopack, webpack, and Vite — stamping happens in React's dev JSX runtime, not the bundler. Server components included. Production builds are untouched (the prod runtime is a passthrough).
 
+## Telemetry
+
+The daemon sends anonymous usage telemetry: package version, node version, OS platform, whether Tailwind was detected, and per-lane tweak counts. **Never** code, file paths, file names, prompts, or anything identifying. A disclosure prints the first time the daemon runs.
+
+Opt out permanently:
+
+```sh
+export TWEAKLOCAL_TELEMETRY=0   # or DO_NOT_TRACK=1 — both respected
+```
+
 ## Options
 
 - `npx tweaklocal --port 4101` (+ `<TweakLocalOverlay origin="http://localhost:4101" />`)

package/overlay/overlay.js

@@ -36,6 +36,8 @@
   .twk-chip{font-size:10.5px !important;padding:2px 6px !important}
   .twk-tray{position:fixed;right:14px;bottom:14px;display:flex;flex-direction:column;align-items:flex-end;gap:6px;pointer-events:auto}
   .twk-total{background:#064e3b;color:#a7f3d0;border-radius:8px;padding:6px 11px;font-size:13px;box-shadow:0 4px 14px rgba(0,0,0,.3);white-space:nowrap;width:max-content;max-width:720px}
+  .twk-total a{color:#6ee7b7;margin-left:10px;text-decoration:underline;cursor:pointer}
+  .twk-total a:hover{color:#a7f3d0}
   .twk-tweak{background:#111827;color:#e5e7eb;border-radius:8px;padding:7px 11px;font-size:13px;display:flex;gap:8px;align-items:center;box-shadow:0 4px 14px rgba(0,0,0,.3);white-space:nowrap;width:max-content;max-width:720px;overflow:hidden;text-overflow:ellipsis}
   .twk-dot{width:8px;height:8px;border-radius:50%;flex:none}
   .twk-dot.done{background:#10b981}.twk-dot.queued,.twk-dot.running{background:#f59e0b;animation:twk-pulse 1s infinite}.twk-dot.error{background:#ef4444}.twk-dot.reverted{background:#6b7280}
@@ -684,13 +686,19 @@
   root.appendChild(tray);
   const totalBar = el('div', 'twk-total');
   totalBar.style.display = 'none';
+  const totalText = el('span');
+  const reportLink = el('a', null, 'monthly report →');
+  reportLink.href = 'https://tweaklocal.dev/report';
+  reportLink.target = '_blank';
+  reportLink.rel = 'noopener';
+  totalBar.append(totalText, reportLink);
   tray.appendChild(totalBar);
   const tweaks = new Map();
 
   function showTotals(t) {
     if (!t || !t.count) return;
     totalBar.style.display = '';
-    totalBar.textContent = `≈ saved $${t.usd.toFixed(2)} · ${Math.round(t.ms / 1000)}s across ${t.count} tweak${t.count === 1 ? '' : 's'} (vs unscoped agent)`;
+    totalText.textContent = `≈ saved $${t.usd.toFixed(2)} · ${Math.round(t.ms / 1000)}s across ${t.count} tweak${t.count === 1 ? '' : 's'} (vs unscoped agent)`;
   }
 
   function addTweak(t) {

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "tweaklocal",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Tweak your UI live in the browser and write the changes straight to source. Copy and Tailwind edits cost zero tokens; everything else routes to a right-sized model via headless claude.",
   "license": "MIT",
   "type": "module",
   "bin": { "tweaklocal": "bin/tweaklocal.js" },
   "scripts": { "start": "node bin/tweaklocal.js" },
   "files": ["bin", "src", "overlay", "README.md"],
+  "engines": {
+    "node": ">=18"
+  },
   "dependencies": {
     "@babel/parser": "^7.26.0"
   },

package/src/server.js

@@ -73,7 +73,7 @@ export function startServer({ root, port = 4100 }) {
       }
 
       if (req.method === 'GET' && url.pathname === '/api/health') {
-        return json(res, { ok: true, root, totals, tailwind });
+        return json(res, { ok: true, root, totals, tailwind, telemetry: !telemetry.disabled });
       }
 
       if (req.method === 'GET' && url.pathname === '/api/events') {
@@ -99,6 +99,7 @@ export function startServer({ root, port = 4100 }) {
           const id = nextId++;
           const write = applyTextEdit(root, body.loc, body.oldText, body.newText);
           remember(id, write);
+          telemetry.record('copy');
           broadcast({ type: 'tweak', id, kind: 'copy', status: 'done', tokens: 0, label: `copy: "${body.newText.slice(0, 40)}"`, ...recordSavings(0, 50) });
           return json(res, { ok: true, id });
         }
@@ -107,6 +108,7 @@ export function startServer({ root, port = 4100 }) {
           const id = nextId++;
           const write = applyClassEdit(root, body.loc, body.remove || [], body.add || []);
           remember(id, write);
+          telemetry.record('style');
           broadcast({ type: 'tweak', id, kind: 'style', status: 'done', tokens: 0, label: `style: ${(body.add || []).join(' ')}`, ...recordSavings(0, 50) });
           return json(res, { ok: true, id });
         }
@@ -118,6 +120,7 @@ export function startServer({ root, port = 4100 }) {
           const desc = Object.entries(body.styles || {})
             .map(([k, v]) => `${k}: ${v}`)
             .join(', ');
+          telemetry.record('style');
           broadcast({ type: 'tweak', id, kind: 'style', status: 'done', tokens: 0, label: `style: ${desc.slice(0, 50)}`, ...recordSavings(0, 50) });
           return json(res, { ok: true, id });
         }
@@ -131,6 +134,7 @@ export function startServer({ root, port = 4100 }) {
           const target = describeTarget(root, body.loc);
           const write = applyDeleteElement(root, body.loc);
           remember(id, write);
+          telemetry.record('delete');
           broadcast({ type: 'tweak', id, kind: 'delete', status: 'done', tokens: 0, label: `deleted <${target.tagName}>`, ...recordSavings(0, 50) });
           return json(res, { ok: true, id });
         }
@@ -151,6 +155,7 @@ export function startServer({ root, port = 4100 }) {
           const route = classify(body.instruction);
           const abs = path.resolve(root, file);
           remember(id, { abs, before: fs.readFileSync(abs, 'utf8') });
+          telemetry.record('nl');
           broadcast({ type: 'tweak', id, kind: route.kind, status: 'queued', model: route.model, label: body.instruction.slice(0, 60) });
           json(res, { ok: true, id, model: route.model, kind: route.kind });
 
@@ -217,6 +222,8 @@ export function startServer({ root, port = 4100 }) {
   });
   server.listen(port, () => {
     console.log(`[tweaklocal] daemon on http://localhost:${port} (root: ${root})`);
+    console.log('[tweaklocal] docs & updates → https://tweaklocal.dev');
+    if (telemetry.firstRun && !telemetry.disabled) console.log(DISCLOSURE);
   });
   return server;
 }