toldya 0.3.0 → 0.3.2

package/README.md

@@ -1,90 +1,100 @@
-<p align="center"><img src="assets/mark.webp" width="220" height="220" alt="A round green figure sits against a wall covered in chalk tally marks, adding one more, looking straight at you."></p>
-
-<h1 align="center">toldya</h1>
-
-<p align="center"><b>Stop repeating yourself to your AI.</b></p>
-
-<p align="center">Part of <a href="https://singhlabs.dev/toldya/">Singh Labs</a>, small tools for people who code with AI.</p>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/toldya"><img src="https://img.shields.io/npm/v/toldya?color=ffd23f&label=npm" alt="npm version"></a>
-  <img src="https://img.shields.io/badge/dependencies-0-98a179" alt="zero dependencies">
-  <img src="https://img.shields.io/badge/network-none-98a179" alt="no network calls">
-  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-ff90e8" alt="MIT"></a>
-</p>
-
-<p align="center"><img src="assets/demo.gif" width="100%" alt="toldya reading Claude Code history, listing the corrections said most often, then adding three of them to CLAUDE.md"></p>
-
-```bash
-npx toldya --all
-```
-
-You keep telling your coding agent the same things. "Keep it simple." "Don't assume."
-"Don't complicate it." toldya reads what you typed to Claude Code, finds what you keep
-repeating, and writes it into the rule file your agent reads, with your yes. Next time,
-it counts whether you still had to say it.
-
-## What it found on the author's own history
-
-A real run. Not a mock-up.
-
-<p align="center"><img src="assets/report.png" width="100%" alt="toldya report: keep it simple 40 times in 36 sessions, dont complex this 29 times, dont assume 15 times, and 71 times it was told to try or check again"></p>
-
-142 sessions. "Keep it simple" 40 times. Rewordings and typos count as one habit: "Don't
-complicate it" and "dont complex this" are the same thing said twice.
-
-## Use it
-
-```bash
-npx toldya                  # this project: offers rules for ./CLAUDE.md
-npx toldya --all            # every project: offers rules for ~/.claude/CLAUDE.md
-npx toldya --dry            # report only, change nothing
-npx toldya --to AGENTS.md   # write rules somewhere else
-npx toldya --add 1,3        # take repeats 1 and 3 without the prompts
-npx toldya --min 5          # only things you said 5+ times
-npx toldya --json           # machine-readable report
-npx toldya --card           # an image of your top repeats, to share
-```
-
-Without `--dry` or `--add`, it asks about each repeat: **y** adds it, **n** skips it,
-**e** lets you reword it first. Rules go under a `## Things I kept repeating` heading.
-Nothing is written without a yes.
-
-Run it again a week later and every rule it added shows how often you said it before,
-and how often since.
-
-## Share it
-
-`npx toldya --all --card` opens your card in the browser. Save it as a PNG, then use the
-**Post on X** or **Share on LinkedIn** button: the post text is written for you. The card is
-drawn on your machine; nothing leaves it unless you click share.
-
-<p align="center"><img src="assets/card.png" width="100%" alt="toldya card: Things I keep telling my AI. keep it simple 41 times, dont complex this 29 times, dont assume 15 times"></p>
-
-## What it reads, and what it doesn't
-
-- Only **your own messages** in Claude Code's history on this machine (`~/.claude/projects`).
-  Not the AI's replies, not tool output, not your files.
-- Long messages are treated as pastes (briefs, logs) and skipped. Questions and "I don't
-  understand" are not corrections, so they're skipped too.
-- A repeat counts only if it shows up in **at least two sessions**.
-- Short "try again" / "check again" messages are counted separately. They mean the first
-  attempt missed, but they aren't rules you can write down.
-- **Sends nothing anywhere.** No account, no telemetry, no network calls.
-
-Claude Code keeps about 30 days of history by default, so on a default install toldya sees
-roughly a month.
-
-## Coming next
-
-- **Team mode:** `npx toldya owner/repo` reads a repo's pull-request review comments (from
-  people or any review bot), finds what reviewers keep writing, and opens one PR into `AGENTS.md`.
-- Codex history (not tested on real files yet, so not claimed).
-
-## Requirements
-
-Node 18+. No dependencies.
-
-## License
-
-MIT © Sevenopt Solutions Private Limited · made by [Singh Labs](https://singhlabs.dev)
+<p align="center"><img src="assets/mark.webp" width="220" height="220" alt="A round green figure sits against a wall covered in chalk tally marks, adding one more, looking straight at you."></p>
+
+<h1 align="center">toldya</h1>
+
+<p align="center"><b>Stop repeating yourself to your AI.</b></p>
+
+<p align="center">Part of <a href="https://singhlabs.dev/toldya/">Singh Labs</a>, small tools for people who code with AI.</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/toldya"><img src="https://img.shields.io/npm/v/toldya?color=ffd23f&label=npm" alt="npm version"></a>
+  <img src="https://img.shields.io/badge/dependencies-0-98a179" alt="zero dependencies">
+  <img src="https://img.shields.io/badge/network-none-98a179" alt="no network calls">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-ff90e8" alt="MIT"></a>
+</p>
+
+<p align="center"><img src="assets/demo.gif" width="100%" alt="toldya reading Claude Code history, listing the corrections said most often, then adding three of them to CLAUDE.md"></p>
+
+```bash
+npx toldya --all
+```
+
+You keep telling your coding agent the same things. "Keep it simple." "Don't assume."
+"Don't complicate it." toldya reads what you typed to Claude Code, finds what you keep
+repeating, and writes it into the rule file your agent reads, with your yes. Next time,
+it counts whether you still had to say it.
+
+## What it found on the author's own history
+
+A real run. Not a mock-up.
+
+<p align="center"><img src="assets/report.png" width="100%" alt="toldya report: keep it simple 40 times in 36 sessions, dont complex this 29 times, dont assume 15 times, and 71 times it was told to try or check again"></p>
+
+142 sessions. "Keep it simple" 40 times. Rewordings and typos count as one habit: "Don't
+complicate it" and "dont complex this" are the same thing said twice.
+
+## Use it
+
+```bash
+npx toldya                  # this project: offers rules for ./CLAUDE.md
+npx toldya --all            # every project: offers rules for ~/.claude/CLAUDE.md
+npx toldya --dry            # report only, change nothing
+npx toldya --to AGENTS.md   # write rules somewhere else
+npx toldya --add 1,3        # take repeats 1 and 3 without the prompts
+npx toldya --min 5          # only things you said 5+ times
+npx toldya --json           # machine-readable report
+npx toldya --card           # an image of your top repeats, to share
+```
+
+Without `--dry` or `--add`, it asks about each repeat: **y** adds it, **n** skips it,
+**e** lets you reword it first. Rules go under a `## Things I kept repeating` heading.
+Nothing is written without a yes.
+
+Run it again a week later and every rule it added shows how often you said it before,
+and how often since.
+
+## In Claude Code, as a plugin
+
+```
+/plugin marketplace add singhlabsdev/toldya
+/plugin install toldya@toldya
+```
+
+Then ask Claude *"what do I keep repeating?"*. It runs toldya, shows you the list, and adds
+only the ones you pick.
+
+## Share it
+
+`npx toldya --all --card` opens your card in the browser. Save it as a PNG, then use the
+**Post on X** or **Share on LinkedIn** button: the post text is written for you. The card is
+drawn on your machine; nothing leaves it unless you click share.
+
+Post yours in [Share your card](https://github.com/singhlabsdev/toldya/discussions/1). What's your top line?
+
+<p align="center"><img src="assets/card.png" width="100%" alt="toldya card: I have told my AI keep it simple 42 times. Also: dont complex this 29, dont assume 15, i dont want later on 13"></p>
+
+## What it reads, and what it doesn't
+
+- Only **your own messages** in Claude Code's history on this machine (`~/.claude/projects`).
+  Not the AI's replies, not tool output, not your files.
+- Long messages are treated as pastes (briefs, logs) and skipped. Questions and "I don't
+  understand" are not corrections, so they're skipped too.
+- A repeat counts only if it shows up in **at least two sessions**.
+- Short "try again" / "check again" messages are counted separately. They mean the first
+  attempt missed, but they aren't rules you can write down.
+- **Sends nothing anywhere.** No account, no telemetry, no network calls.
+
+Claude Code keeps about 30 days of history by default, so on a default install toldya sees
+roughly a month.
+
+## Coming next
+
+- Codex history (not tested on real files yet, so not claimed).
+
+## Requirements
+
+Node 18+. No dependencies.
+
+## License
+
+MIT © Sevenopt Solutions Private Limited · made by [Singh Labs](https://singhlabs.dev)

package/bin/toldya.mjs

@@ -15,7 +15,7 @@ import {
 } from '../lib/core.mjs';
 import { cardHtml } from '../lib/card.mjs';
 
-const VERSION = '0.3.0';
+const VERSION = '0.3.2';
 const argv = process.argv.slice(2);
 const has = (f) => argv.includes(f);
 const opt = (f, d) => { const i = argv.indexOf(f); return i >= 0 && argv[i + 1] ? argv[i + 1] : d; };
@@ -37,7 +37,7 @@ Reads Claude Code's own history on this machine. Sends nothing anywhere.`);
 }
 if (has('--version') || has('-v')) { console.log(VERSION); process.exit(0); }
 if (argv.some((a) => /^[\w.-]+\/[\w.-]+$/.test(a))) {
-  console.log('Team mode (owner/repo) is coming next. For now: run `npx toldya` in your project.');
+  console.log('toldya reads your own Claude Code history, not a repo. Run `npx toldya` in your project.');
   process.exit(0);
 }
 
@@ -127,6 +127,7 @@ It opens in your browser: save it as a PNG, then post it. Nothing leaves your ma
   process.exit(0);
 }
 
+const STAR = '\nFound something? A star helps other people find toldya: github.com/singhlabsdev/toldya';
 console.log('You keep telling your AI:');
 const shown = fresh.slice(0, 10);
 shown.forEach((r, n) => {
@@ -140,6 +141,7 @@ if (spanDays < 35) console.log('\nClaude Code keeps about 30 days of history by
 const picks = opt('--add', null);
 if (has('--dry') || (!picks && !process.stdin.isTTY)) {
   if (!has('--dry')) console.log('\nRun in a terminal to add these as rules, or pick them with --add 1,3.');
+  console.log(STAR);
   process.exit(0);
 }
 
@@ -179,3 +181,4 @@ mkdirSync(stateDir, { recursive: true });
 writeFileSync(stateFile, JSON.stringify(state, null, 2));
 const shortTarget = target.startsWith(cwd) ? target.slice(cwd.length + 1) : target.replace(homedir(), '~');
 console.log(`\nAdded ${add.length} rule${add.length > 1 ? 's' : ''} to ${shortTarget}. Run toldya again in a week to see if they stuck.`);
+console.log(STAR);

package/lib/card.mjs

@@ -1,53 +1,73 @@
-// toldya --card: one image of your top repeats, for when you want to show someone.
-// Writes a local HTML page that draws the card and saves it as a PNG. No network,
-// unless you click a share button: that opens X or LinkedIn with a pre-filled post.
-import { readFileSync } from 'node:fs';
-
-const MARK = new URL('../assets/mark.webp', import.meta.url);
-
-export function cardHtml({ repeats, sessions, from, to }) {
-  let mark = '';
-  try { mark = 'data:image/webp;base64,' + readFileSync(MARK).toString('base64'); } catch {}
-  const data = { rows: repeats.slice(0, 5).map((r) => [r.count, r.phrase]), sessions, from, to, mark };
-  // JSON inside <script>: escape "<" so a phrase like "</script>" can't end the block.
-  const json = JSON.stringify(data).replace(/</g, '\\u003c');
-  return `<!doctype html><meta charset="utf-8"><title>toldya card</title>
-<style>body{margin:0;background:#eee;font:16px system-ui;display:grid;place-items:center;min-height:100vh;gap:16px}
-canvas{max-width:95vw;height:auto;box-shadow:0 2px 12px #0002}.row{display:flex;gap:14px;flex-wrap:wrap;justify-content:center}p{margin:0;color:#555;max-width:60ch;text-align:center}a{font-weight:700;color:#0d0d0d;background:#ffd23f;border:3px solid #0d0d0d;padding:10px 18px;border-radius:30px;text-decoration:none;box-shadow:4px 4px 0 #0d0d0d}</style>
-<canvas id="c" width="1200" height="675"></canvas>
-<div class="row"><a id="save" download="toldya.png" href="#">1. Save as PNG</a><a id="x" target="_blank" rel="noopener" href="#">2. Post on X</a><a id="li" target="_blank" rel="noopener" href="#">2. Share on LinkedIn</a></div>
-<p>Save the picture first, then attach it to your post. The card is drawn on your machine; nothing leaves it unless you click a share button.</p>
-<script>
-const D = ${json}, c = document.getElementById('c'), x = c.getContext('2d'), INK = '#0d0d0d';
-const REPO = 'github.com/singhlabsdev/toldya';
-const first = D.rows[0] || [0, ''];
-const post = 'My AI has heard "' + first[1] + '" ' + first[0] + ' times 😅 Counted from my own Claude Code history with npx toldya';
-document.getElementById('x').href = 'https://x.com/intent/post?text=' + encodeURIComponent(post) + '&url=' + encodeURIComponent('https://' + REPO);
-document.getElementById('li').href = 'https://www.linkedin.com/feed/?shareActive=true&text=' + encodeURIComponent(post + ' https://' + REPO);
-const font = (w, s) => (x.font = w + ' ' + s + 'px system-ui, "Segoe UI", sans-serif');
-const pill = (px, py, w, h, fill) => {
-  x.fillStyle = INK; x.beginPath(); x.roundRect(px + 5, py + 5, w, h, h / 2); x.fill();
-  x.fillStyle = fill; x.beginPath(); x.roundRect(px, py, w, h, h / 2); x.fill();
-  x.lineWidth = 3; x.strokeStyle = INK; x.stroke();
-};
-const fit = (s, max) => { if (x.measureText(s).width <= max) return s;
-  while (s.length > 1 && x.measureText(s + '…').width > max) s = s.slice(0, -1); return s + '…'; };
-function draw(img) {
-  x.fillStyle = '#fff'; x.fillRect(0, 0, 1200, 675);
-  if (img) x.drawImage(img, 30, 150, 330, 330);
-  x.fillStyle = INK; font(800, 46); x.fillText('Things I keep telling my AI', 390, 100);
-  D.rows.forEach(([n, p], i) => {
-    const y = 150 + i * 88;
-    pill(390, y, 118, 58, '#ffd23f');
-    x.fillStyle = INK; font(800, 30); x.textAlign = 'center'; x.fillText(n + '×', 449, y + 40);
-    x.textAlign = 'left'; font(600, 32); x.fillText(fit('“' + p + '”', 640), 532, y + 41);
-  });
-  font(500, 22); x.fillStyle = '#6b6b6b';
-  x.fillText(D.sessions + ' Claude Code sessions · ' + D.from + ' – ' + D.to, 390, 628);
-  pill(990, 596, 180, 50, INK); x.fillStyle = '#fff'; font(700, 24); x.fillText('npx toldya', 1017, 629);
-  x.fillStyle = '#6b6b6b'; font(500, 18); x.textAlign = 'right'; x.fillText(REPO, 1170, 580); x.textAlign = 'left';
-  document.getElementById('save').href = c.toDataURL('image/png');
-}
-if (D.mark) { const i = new Image(); i.onload = () => draw(i); i.onerror = () => draw(); i.src = D.mark; } else draw();
-</script>`;
-}
+// toldya --card: one image of your top repeats, for when you want to show someone.
+// Writes a local HTML page that draws the card and saves it as a PNG. No network,
+// unless you click a share button: that opens X or LinkedIn with a pre-filled post.
+import { readFileSync } from 'node:fs';
+
+const MARK = new URL('../assets/mark.webp', import.meta.url);
+
+export function cardHtml({ repeats, sessions, from, to }) {
+  let mark = '';
+  try { mark = 'data:image/webp;base64,' + readFileSync(MARK).toString('base64'); } catch {}
+  const data = { rows: repeats.slice(0, 5).map((r) => [r.count, r.phrase]), sessions, from, to, mark };
+  // JSON inside <script>: escape "<" so a phrase like "</script>" can't end the block.
+  const json = JSON.stringify(data).replace(/</g, '\\u003c');
+  return `<!doctype html><meta charset="utf-8"><title>toldya card</title>
+<style>body{margin:0;background:#eee;font:16px system-ui;display:grid;place-items:center;min-height:100vh;gap:16px}
+canvas{max-width:95vw;height:auto;box-shadow:0 2px 12px #0002}.row{display:flex;gap:14px;flex-wrap:wrap;justify-content:center}p{margin:0;color:#555;max-width:60ch;text-align:center}a{font-weight:700;color:#0d0d0d;background:#ffd23f;border:3px solid #0d0d0d;padding:10px 18px;border-radius:30px;text-decoration:none;box-shadow:4px 4px 0 #0d0d0d}</style>
+<canvas id="c" width="1200" height="675"></canvas>
+<div class="row"><a id="save" download="toldya.png" href="#">1. Save as PNG</a><a id="x" target="_blank" rel="noopener" href="#">2. Post on X</a><a id="li" target="_blank" rel="noopener" href="#">2. Share on LinkedIn</a></div>
+<p>Save the picture first, then attach it to your post. The card is drawn on your machine; nothing leaves it unless you click a share button. Or add it to <a style="all:revert" href="https://github.com/singhlabsdev/toldya/discussions/1" target="_blank" rel="noopener">Share your card</a> on GitHub.</p>
+<script>
+const D = ${json}, c = document.getElementById('c'), x = c.getContext('2d'), INK = '#0d0d0d';
+const REPO = 'github.com/singhlabsdev/toldya';
+const first = D.rows[0] || [0, ''];
+const post = 'My AI has heard "' + first[1] + '" ' + first[0] + ' times 😅 Counted from my own Claude Code history with npx toldya';
+document.getElementById('x').href = 'https://x.com/intent/post?text=' + encodeURIComponent(post) + '&url=' + encodeURIComponent('https://' + REPO);
+document.getElementById('li').href = 'https://www.linkedin.com/feed/?shareActive=true&text=' + encodeURIComponent(post + ' https://' + REPO);
+const font = (w, s) => (x.font = w + ' ' + s + 'px system-ui, "Segoe UI", sans-serif');
+const pill = (px, py, w, h, fill) => {
+  x.fillStyle = INK; x.beginPath(); x.roundRect(px + 5, py + 5, w, h, h / 2); x.fill();
+  x.fillStyle = fill; x.beginPath(); x.roundRect(px, py, w, h, h / 2); x.fill();
+  x.lineWidth = 3; x.strokeStyle = INK; x.stroke();
+};
+const fit = (s, max) => { if (x.measureText(s).width <= max) return s;
+  while (s.length > 1 && x.measureText(s + '…').width > max) s = s.slice(0, -1); return s + '…'; };
+// Wrap s into at most 2 lines of width max; the second line gets an ellipsis if it overflows.
+const wrap = (s, max) => {
+  const lines = [''];
+  for (const w of s.split(' ')) {
+    const t = lines.at(-1) ? lines.at(-1) + ' ' + w : w;
+    if (x.measureText(t).width <= max || !lines.at(-1)) lines[lines.length - 1] = t;
+    else if (lines.length < 2) lines.push(w);
+    else { lines[1] = fit(lines[1] + ' ' + w, max); break; }
+  }
+  return lines;
+};
+function draw(img) {
+  x.fillStyle = '#fff'; x.fillRect(0, 0, 1200, 675);
+  if (img) x.drawImage(img, 20, 170, 330, 330);
+  // The headline is the top correction itself, in quotes, with its count.
+  x.fillStyle = '#6b6b6b'; font(600, 30); x.fillText('I have told my AI', 390, 92);
+  x.fillStyle = INK; font(800, 66);
+  const lines = wrap('“' + first[1] + '”', 760);
+  lines.forEach((l, i) => x.fillText(l, 390, 170 + i * 76));
+  const cy = 170 + (lines.length - 1) * 76 + 34;
+  pill(390, cy, 250, 72, '#ffd23f');
+  x.fillStyle = INK; font(800, 44); x.textAlign = 'center'; x.fillText(first[0] + ' times', 515, cy + 52); x.textAlign = 'left';
+  // The rest, smaller.
+  const rest = D.rows.slice(1, 4);
+  if (rest.length) { x.fillStyle = '#6b6b6b'; font(600, 24); x.fillText('also:', 390, cy + 128); }
+  rest.forEach(([n, p], i) => {
+    const y = cy + 128 + (i + 1) * 40;
+    x.fillStyle = INK; font(800, 26); x.fillText(n + '×', 390, y);
+    font(500, 26); x.fillText(fit(p, 640), 470, y);
+  });
+  font(500, 22); x.fillStyle = '#6b6b6b';
+  x.fillText(D.sessions + ' Claude Code sessions · ' + D.from + ' – ' + D.to, 390, 628);
+  pill(990, 596, 180, 50, INK); x.fillStyle = '#fff'; font(700, 24); x.fillText('npx toldya', 1017, 629);
+  x.fillStyle = '#6b6b6b'; font(500, 18); x.textAlign = 'right'; x.fillText(REPO, 1170, 580); x.textAlign = 'left';
+  document.getElementById('save').href = c.toDataURL('image/png');
+}
+if (D.mark) { const i = new Image(); i.onload = () => draw(i); i.onerror = () => draw(); i.src = D.mark; } else draw();
+</script>`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toldya",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Stop repeating yourself to your AI. Finds what you keep telling your coding agent, writes it into CLAUDE.md / AGENTS.md, and counts whether it stopped.",
   "bin": {
     "toldya": "bin/toldya.mjs"