toldya 0.2.0 → 0.3.1

package/README.md

@@ -4,6 +4,8 @@
 
 <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">
@@ -53,8 +55,9 @@ and how often since.
 
 ## Share it
 
-`npx toldya --all --card` opens your card in the browser. One click saves it as a PNG.
-It's drawn on your machine; nothing is uploaded.
+`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>
 

package/bin/toldya.mjs

@@ -1,181 +1,184 @@
-#!/usr/bin/env node
-// toldya — stop repeating yourself to your AI.
-//
-// Reads what you typed to Claude Code (from its own history on this machine),
-// finds the corrections you keep repeating, offers each one as a line for the
-// rule file your agent reads, and next time counts whether you still say it.
-import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from 'node:fs';
-import { spawn } from 'node:child_process';
-import { join, resolve } from 'node:path';
-import { homedir, tmpdir } from 'node:os';
-import { createInterface } from 'node:readline/promises';
-import {
-  CLAUDE_ROOT, claudeProjects, projectFor, readClaudeSession,
-  corrections, group, repeats, toRule, alreadyWritten, beforeAfter, isRetry,
-} from '../lib/core.mjs';
-import { cardHtml } from '../lib/card.mjs';
-
-const VERSION = '0.2.0';
-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; };
-
-if (has('--help') || has('-h')) {
-  console.log(`toldya ${VERSION} — stop repeating yourself to your AI
-
-  toldya            this project: what you keep telling Claude Code here
-  toldya --all      every project; rules go to your global ~/.claude/CLAUDE.md
-  --min N           only repeats said at least N times (default 3)
-  --to FILE         write rules to FILE instead (e.g. AGENTS.md)
-  --add 1,3         add repeats by their number, without asking
-  --dry             show the report, change nothing
-  --card            make an image of your top repeats, to share
-  --json            machine-readable report, change nothing
-
-Reads Claude Code's own history on this machine. Sends nothing anywhere.`);
-  process.exit(0);
-}
-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.');
-  process.exit(0);
-}
-
-const all = has('--all');
-const min = Math.max(2, parseInt(opt('--min', '3'), 10) || 3);
-const cwd = process.cwd();
-const projects = claudeProjects();
-const chosen = all ? projects : [projectFor(cwd, projects)].filter(Boolean);
-
-if (!chosen.length) {
-  console.log(projects.length
-    ? `No Claude Code history for this folder (${cwd}).\nRun it inside a project you've used Claude Code in, or try: npx toldya --all`
-    : `No Claude Code history found at ${CLAUDE_ROOT}.`);
-  process.exit(0);
-}
-
-// Everything you typed, stamped with the session it came from.
-const messages = [];
-let sessions = 0;
-for (const p of chosen) {
-  const dir = join(CLAUDE_ROOT, p);
-  for (const f of readdirSync(dir).filter((x) => x.endsWith('.jsonl'))) {
-    const ms = readClaudeSession(join(dir, f));
-    if (ms.length) sessions++;
-    for (const m of ms) messages.push({ ...m, session: `${p}/${f}` });
-  }
-}
-const said = corrections(messages);
-const retries = said.filter((i) => isRetry(i.s)).length;
-const items = said.filter((i) => !isRetry(i.s));
-const found = repeats(group(items), min);
-
-// Where rules go, and what's already written there.
-const target = resolve(opt('--to', all ? join(homedir(), '.claude', 'CLAUDE.md') : join(cwd, 'CLAUDE.md')));
-const ruleFiles = [...new Set(all ? [target] : [target, join(cwd, 'CLAUDE.md'), join(cwd, 'AGENTS.md')])];
-const written = ruleFiles.filter(existsSync).map((f) => readFileSync(f, 'utf8')).join('\n');
-
-// Rules toldya added before, so we can count whether they worked.
-const stateDir = join(homedir(), '.toldya');
-const stateFile = join(stateDir, 'state.json');
-// Rules are remembered per rule file: that's where they live.
-const key = target;
-let state = {};
-try { state = JSON.parse(readFileSync(stateFile, 'utf8')); } catch {}
-const ours = state[key]?.rules || [];
-
-const dates = messages.map((m) => m.ts).filter(Boolean).sort();
-const day = (t) => (t ? new Date(t).toLocaleDateString('en-GB', { day: 'numeric', month: 'short' }) : '?');
-
-if (has('--json')) {
-  console.log(JSON.stringify({
-    sessions, messages: messages.length, corrections: items.length, retries,
-    from: dates[0] || null, to: dates.at(-1) || null,
-    repeats: found.map((r) => ({ phrase: r.phrase, count: r.count, sessions: r.sessions,
-      alreadyWritten: alreadyWritten(r.phrase, written) })),
-    rules: ours.map((r) => ({ ...r, ...beforeAfter(r, items) })),
-  }, null, 2));
-  process.exit(0);
-}
-
-console.log(`\ntoldya · ${sessions} sessions (${day(dates[0])} – ${day(dates.at(-1))}) · ${messages.length} of your messages · ${items.length} corrections\n`);
-
-if (ours.length) {
-  console.log('Rules toldya added earlier:');
-  for (const r of ours) {
-    const { before, after } = beforeAfter(r, items);
-    console.log(`  "${r.text}"  said ${before}× before · ${after}× since (added ${day(r.addedAt)})`);
-  }
-  console.log('');
-}
-
-const fresh = found.filter((r) => !ours.some((o) => o.text === toRule(r.phrase)));
-if (!fresh.length) {
-  console.log(found.length ? 'Nothing new you keep repeating. Nice.' : `No correction said ${min}+ times across sessions yet.`);
-  process.exit(0);
-}
-
-if (has('--card')) {
-  if (!found.length) { console.log(`No correction said ${min}+ times yet, so no card.`); process.exit(0); }
-  const file = join(tmpdir(), 'toldya-card.html');
-  writeFileSync(file, cardHtml({ repeats: found, sessions, from: day(dates[0]), to: day(dates.at(-1)) }));
-  const open = process.platform === 'win32' ? ['cmd', ['/c', 'start', '', file]]
-    : [process.platform === 'darwin' ? 'open' : 'xdg-open', [file]];
-  try { spawn(open[0], open[1], { detached: true, stdio: 'ignore' }).on('error', () => {}).unref(); } catch {}
-  console.log(`Your card: ${file}
-It opens in your browser. Click "Save as PNG". Nothing is uploaded.`);
-  process.exit(0);
-}
-
-console.log('You keep telling your AI:');
-const shown = fresh.slice(0, 10);
-shown.forEach((r, n) => {
-  const note = alreadyWritten(r.phrase, written) ? '   ← already in your rules, still repeated' : '';
-  console.log(`  ${String(n + 1).padStart(2)}. ${String(r.count).padStart(3)}×  ${r.phrase}   (${r.sessions} sessions)${note}`);
-});
-if (retries >= min) console.log(`\nAnd ${retries} times you told it to try or check again: its first go missed.`);
-const spanDays = dates.length ? (new Date(dates.at(-1)) - new Date(dates[0])) / 864e5 : 0;
-if (spanDays < 35) console.log('\nClaude Code keeps about 30 days of history by default, so older repeats are not counted.');
-
-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.');
-  process.exit(0);
-}
-
-// Ask before touching any file (or take the numbers given). Each rule is your own words.
-const add = [];
-if (picks) {
-  for (const n of String(picks).split(',').map((x) => parseInt(x, 10))) {
-    const r = shown[n - 1];
-    if (r && !alreadyWritten(r.phrase, written)) add.push(toRule(r.phrase));
-  }
-} else {
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
-  console.log(`\nAdd them to ${target}? For each: y = add, n = skip, e = edit the wording.\n`);
-  for (const r of shown) {
-    if (alreadyWritten(r.phrase, written)) continue;
-    let text = toRule(r.phrase);
-    const a = (await rl.question(`  ${text}  [y/n/e] `)).trim().toLowerCase();
-    if (a === 'e') text = toRule((await rl.question('    new wording: ')).trim() || r.phrase);
-    if (a === 'y' || a === 'e') add.push(text);
-  }
-  rl.close();
-}
-
-if (!add.length) { console.log('\nNothing added.'); process.exit(0); }
-
-const heading = '## Things I kept repeating';
-let doc = existsSync(target) ? readFileSync(target, 'utf8') : '';
-const block = add.map((t) => `- ${t}`).join('\n');
-if (doc.includes(heading)) doc = doc.replace(heading, `${heading}\n${block}`);
-else doc = `${doc.replace(/\s*$/, '')}${doc ? '\n\n' : ''}${heading}\n${block}\n`;
-mkdirSync(join(target, '..'), { recursive: true });
-writeFileSync(target, doc);
-
-const now = new Date().toISOString();
-state[key] = { rules: [...ours, ...add.map((text) => ({ text, addedAt: now }))] };
-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.`);
+#!/usr/bin/env node
+// toldya — stop repeating yourself to your AI.
+//
+// Reads what you typed to Claude Code (from its own history on this machine),
+// finds the corrections you keep repeating, offers each one as a line for the
+// rule file your agent reads, and next time counts whether you still say it.
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+import { join, resolve } from 'node:path';
+import { homedir, tmpdir } from 'node:os';
+import { createInterface } from 'node:readline/promises';
+import {
+  CLAUDE_ROOT, claudeProjects, projectFor, readClaudeSession,
+  corrections, group, repeats, toRule, alreadyWritten, beforeAfter, isRetry,
+} from '../lib/core.mjs';
+import { cardHtml } from '../lib/card.mjs';
+
+const VERSION = '0.3.1';
+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; };
+
+if (has('--help') || has('-h')) {
+  console.log(`toldya ${VERSION} — stop repeating yourself to your AI
+
+  toldya            this project: what you keep telling Claude Code here
+  toldya --all      every project; rules go to your global ~/.claude/CLAUDE.md
+  --min N           only repeats said at least N times (default 3)
+  --to FILE         write rules to FILE instead (e.g. AGENTS.md)
+  --add 1,3         add repeats by their number, without asking
+  --dry             show the report, change nothing
+  --card            make an image of your top repeats, to share
+  --json            machine-readable report, change nothing
+
+Reads Claude Code's own history on this machine. Sends nothing anywhere.`);
+  process.exit(0);
+}
+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.');
+  process.exit(0);
+}
+
+const all = has('--all');
+const min = Math.max(2, parseInt(opt('--min', '3'), 10) || 3);
+const cwd = process.cwd();
+const projects = claudeProjects();
+const chosen = all ? projects : [projectFor(cwd, projects)].filter(Boolean);
+
+if (!chosen.length) {
+  console.log(projects.length
+    ? `No Claude Code history for this folder (${cwd}).\nRun it inside a project you've used Claude Code in, or try: npx toldya --all`
+    : `No Claude Code history found at ${CLAUDE_ROOT}.`);
+  process.exit(0);
+}
+
+// Everything you typed, stamped with the session it came from.
+const messages = [];
+let sessions = 0;
+for (const p of chosen) {
+  const dir = join(CLAUDE_ROOT, p);
+  for (const f of readdirSync(dir).filter((x) => x.endsWith('.jsonl'))) {
+    const ms = readClaudeSession(join(dir, f));
+    if (ms.length) sessions++;
+    for (const m of ms) messages.push({ ...m, session: `${p}/${f}` });
+  }
+}
+const said = corrections(messages);
+const retries = said.filter((i) => isRetry(i.s)).length;
+const items = said.filter((i) => !isRetry(i.s));
+const found = repeats(group(items), min);
+
+// Where rules go, and what's already written there.
+const target = resolve(opt('--to', all ? join(homedir(), '.claude', 'CLAUDE.md') : join(cwd, 'CLAUDE.md')));
+const ruleFiles = [...new Set(all ? [target] : [target, join(cwd, 'CLAUDE.md'), join(cwd, 'AGENTS.md')])];
+const written = ruleFiles.filter(existsSync).map((f) => readFileSync(f, 'utf8')).join('\n');
+
+// Rules toldya added before, so we can count whether they worked.
+const stateDir = join(homedir(), '.toldya');
+const stateFile = join(stateDir, 'state.json');
+// Rules are remembered per rule file: that's where they live.
+const key = target;
+let state = {};
+try { state = JSON.parse(readFileSync(stateFile, 'utf8')); } catch {}
+const ours = state[key]?.rules || [];
+
+const dates = messages.map((m) => m.ts).filter(Boolean).sort();
+const day = (t) => (t ? new Date(t).toLocaleDateString('en-GB', { day: 'numeric', month: 'short' }) : '?');
+
+if (has('--json')) {
+  console.log(JSON.stringify({
+    sessions, messages: messages.length, corrections: items.length, retries,
+    from: dates[0] || null, to: dates.at(-1) || null,
+    repeats: found.map((r) => ({ phrase: r.phrase, count: r.count, sessions: r.sessions,
+      alreadyWritten: alreadyWritten(r.phrase, written) })),
+    rules: ours.map((r) => ({ ...r, ...beforeAfter(r, items) })),
+  }, null, 2));
+  process.exit(0);
+}
+
+console.log(`\ntoldya · ${sessions} sessions (${day(dates[0])} – ${day(dates.at(-1))}) · ${messages.length} of your messages · ${items.length} corrections\n`);
+
+if (ours.length) {
+  console.log('Rules toldya added earlier:');
+  for (const r of ours) {
+    const { before, after } = beforeAfter(r, items);
+    console.log(`  "${r.text}"  said ${before}× before · ${after}× since (added ${day(r.addedAt)})`);
+  }
+  console.log('');
+}
+
+const fresh = found.filter((r) => !ours.some((o) => o.text === toRule(r.phrase)));
+if (!fresh.length) {
+  console.log(found.length ? 'Nothing new you keep repeating. Nice.' : `No correction said ${min}+ times across sessions yet.`);
+  process.exit(0);
+}
+
+if (has('--card')) {
+  if (!found.length) { console.log(`No correction said ${min}+ times yet, so no card.`); process.exit(0); }
+  const file = join(tmpdir(), 'toldya-card.html');
+  writeFileSync(file, cardHtml({ repeats: found, sessions, from: day(dates[0]), to: day(dates.at(-1)) }));
+  const open = process.platform === 'win32' ? ['cmd', ['/c', 'start', '', file]]
+    : [process.platform === 'darwin' ? 'open' : 'xdg-open', [file]];
+  try { spawn(open[0], open[1], { detached: true, stdio: 'ignore' }).on('error', () => {}).unref(); } catch {}
+  console.log(`Your card: ${file}
+It opens in your browser: save it as a PNG, then post it. Nothing leaves your machine unless you click share.`);
+  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) => {
+  const note = alreadyWritten(r.phrase, written) ? '   ← already in your rules, still repeated' : '';
+  console.log(`  ${String(n + 1).padStart(2)}. ${String(r.count).padStart(3)}×  ${r.phrase}   (${r.sessions} sessions)${note}`);
+});
+if (retries >= min) console.log(`\nAnd ${retries} times you told it to try or check again: its first go missed.`);
+const spanDays = dates.length ? (new Date(dates.at(-1)) - new Date(dates[0])) / 864e5 : 0;
+if (spanDays < 35) console.log('\nClaude Code keeps about 30 days of history by default, so older repeats are not counted.');
+
+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);
+}
+
+// Ask before touching any file (or take the numbers given). Each rule is your own words.
+const add = [];
+if (picks) {
+  for (const n of String(picks).split(',').map((x) => parseInt(x, 10))) {
+    const r = shown[n - 1];
+    if (r && !alreadyWritten(r.phrase, written)) add.push(toRule(r.phrase));
+  }
+} else {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  console.log(`\nAdd them to ${target}? For each: y = add, n = skip, e = edit the wording.\n`);
+  for (const r of shown) {
+    if (alreadyWritten(r.phrase, written)) continue;
+    let text = toRule(r.phrase);
+    const a = (await rl.question(`  ${text}  [y/n/e] `)).trim().toLowerCase();
+    if (a === 'e') text = toRule((await rl.question('    new wording: ')).trim() || r.phrase);
+    if (a === 'y' || a === 'e') add.push(text);
+  }
+  rl.close();
+}
+
+if (!add.length) { console.log('\nNothing added.'); process.exit(0); }
+
+const heading = '## Things I kept repeating';
+let doc = existsSync(target) ? readFileSync(target, 'utf8') : '';
+const block = add.map((t) => `- ${t}`).join('\n');
+if (doc.includes(heading)) doc = doc.replace(heading, `${heading}\n${block}`);
+else doc = `${doc.replace(/\s*$/, '')}${doc ? '\n\n' : ''}${heading}\n${block}\n`;
+mkdirSync(join(target, '..'), { recursive: true });
+writeFileSync(target, doc);
+
+const now = new Date().toISOString();
+state[key] = { rules: [...ours, ...add.map((text) => ({ text, addedAt: now }))] };
+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,5 +1,6 @@
 // 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.
+// 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);
@@ -12,10 +13,17 @@ export function cardHtml({ repeats, sessions, from, to }) {
   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}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><a id="save" download="toldya.png" href="#">Save as PNG</a>
+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();
@@ -37,6 +45,7 @@ function draw(img) {
   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();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toldya",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "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"