you-wrapped 0.2.0 → 0.3.1

package/SKILL.md

@@ -85,8 +85,49 @@ Write the portrait as JSON matching the schema in `prompt.md`, then:
 npx you-wrapped --render portrait.json --out ./wrapped
 ```
 
-Produces `wrapped.html` and a redacted `wrapped.share.html`. Tell them to read the share
-copy before posting it — they should verify their own scrub.
+Writes `wrapped.html` **and** the redacted `wrapped.share.html`, then opens the first in
+their browser automatically. Pass `--no-open` to suppress that.
+
+Tell them to read the share copy before posting it — they should verify their own scrub.
+Redaction removes emails, phones, addresses, links, tokens, coordinates, and every name
+harvested from their contacts. It does **not** catch place names or company names you
+wrote into the prose yourself — so keep those out of the portrait text if they'd identify
+someone, or tell the user which ones remain.
+
+## Phase 5 — offer to go deeper (every machine is different)
+
+The standard sweep is a floor, not a ceiling. `signals.json` contains an `unexplored`
+block listing sources that were **detected on this machine but deliberately not read** —
+plus a folder inventory. Use it to make a *specific* offer, never a generic menu.
+
+After delivering the portrait, tell them what else is available and what it would add.
+Name the actual apps found, with a one-line reason each:
+
+> "There's more here if you want it. I found Obsidian (24 MB of notes), WhatsApp,
+>  Signal, a Lightroom catalog, and 175 MB of your past Claude sessions. Your notes
+>  would sharpen the private-voice read; WhatsApp is often where family lives; the
+>  Claude sessions show what you actually ask for help with. Want any of those?"
+
+Also offer, when relevant:
+
+- **Other connectors** they have but you didn't sweep — Linear, GitHub, Notion, Figma,
+  Spotify, Strava, banking exports. Check what's actually available before offering.
+- **Deeper on one source** rather than wider: a single relationship over five years, one
+  project end-to-end, or their sent mail alone.
+- **A specific question** they bring. The best second pass is usually answering something
+  they've wondered about themselves, not more breadth.
+- **Their creative output** — the films, repos, designs, or writing they actually made.
+  Data about a person is not the same as the work they produced.
+
+Rules for going deeper:
+
+- **Read only what they ask for.** Detection is not permission. Never open a newly
+  discovered source without an explicit yes.
+- **Say what each source would and wouldn't tell you** before they decide.
+- **Re-render when you learn something material** — a portrait that ignores a major new
+  source is worse than one that never had it.
+- If a source is encrypted at rest (Granola, Signal, some note apps), say so plainly and
+  point at the connector or export path instead of attempting to break it.
 
 ---
 

package/bin/cli.mjs

@@ -7,6 +7,7 @@ import { analyze } from '../src/analyze.mjs';
 import { SYSTEM, buildUserPrompt } from '../src/prompt.mjs';
 import { render } from '../src/render.mjs';
 import { scrubDeep, coarsenPlaces, harvestNames, labelFor } from '../src/scrub.mjs';
+import { discover } from '../src/discover.mjs';
 import { installSkill, skillInstalled, checkFullDiskAccess, openPrivacyPane, hostApp, nodeOk, resolveInvocation, hasClaudeCLI, insideClaude, launchClaude } from '../src/setup.mjs';
 
 const args = process.argv.slice(2);
@@ -33,6 +34,7 @@ ${c.b}you-wrapped${c.x} — a portrait of your year, from the record your Mac al
   --days N        how far back to read            (default 400)
   --out DIR       where to write                  (default ./you-wrapped-out)
   --no-share      skip the redacted share copy
+  --no-open       don't open the result in your browser
   --yes           skip prompts
   --no-launch     don't hand off to Claude Code when done
 
@@ -77,17 +79,42 @@ if (has('--install-skill')) {
   process.exit(0);
 }
 
-// ── render-only path
+// ── render-only path (this is what the Claude Code skill calls)
 if (has('--render')) {
   const p = JSON.parse(readFileSync(resolve(val('--render')), 'utf8'));
-  // pick up signals.json if it's sitting next to the portrait
-  if (!p.__signals) {
+  mkdirSync(OUT, { recursive: true });
+
+  // Pull signals from alongside the portrait so charts and the stat line are real.
+  let src = p.__signals;
+  if (!src) {
     const sp = join(OUT, 'signals.json');
-    if (existsSync(sp)) { try { p.__signals = JSON.parse(readFileSync(sp, 'utf8')).sources; } catch {} }
+    if (existsSync(sp)) { try { src = JSON.parse(readFileSync(sp, 'utf8')).sources; } catch {} }
   }
-  mkdirSync(OUT, { recursive: true });
-  writeFileSync(join(OUT, 'wrapped.html'), render(p, { stats: {} }));
+  p.__signals = src || {};
+  const sm = p.__signals.messages || {};
+  const line = [
+    sm.sent && `${sm.sent.toLocaleString()} messages you sent`,
+    p.__signals.notes?.count && `${p.__signals.notes.count.toLocaleString()} notes`,
+    p.__signals.browser && `${((p.__signals.browser.desktopQueries || 0) + (p.__signals.browser.mobileQueries || 0)).toLocaleString()} searches`,
+    p.__signals.photos?.geotagged && `${p.__signals.photos.geotagged.toLocaleString()} geotagged frames`,
+  ].filter(Boolean).join(' · ');
+  const stats = { line, footer: line ? `Assembled ${new Date().toISOString().slice(0, 10)} from ${line}.` : '' };
+
+  writeFileSync(join(OUT, 'wrapped.html'), render(p, { stats }));
   log(`${c.g}✓${c.x} ${join(OUT, 'wrapped.html')}`);
+
+  // The share copy is promised everywhere else — produce it here too.
+  if (!has('--no-share')) {
+    const names = harvestNames(null, sm.topPeople, sm.topChats);
+    const shared = { ...scrubDeep(p, names), __signals: p.__signals };
+    writeFileSync(join(OUT, 'wrapped.share.html'), render(shared, { shareMode: true, stats }));
+    log(`${c.g}✓${c.x} ${join(OUT, 'wrapped.share.html')} ${c.d}(redacted)${c.x}`);
+  }
+
+  if (!has('--no-open')) {
+    try { execFileSync('open', [join(OUT, 'wrapped.html')]); log(`${c.d}  opened in your browser${c.x}`); }
+    catch { log(`${c.d}  open it: ${join(OUT, 'wrapped.html')}${c.x}`); }
+  }
   process.exit(0);
 }
 
@@ -150,7 +177,9 @@ photos.ok ? done(`photos — ${photos.count.toLocaleString()} (metadata only, no
 // ── 2. analyze
 step('analyzing');
 const profile = analyze({ messages, notes, browser, photos }, { days: DAYS });
-done('analyzed');
+// what else is on this machine that we did NOT read — the agent offers these
+profile.unexplored = discover();
+done(`analyzed — ${profile.unexplored.apps.length} more sources detected but unread`);
 
 // ── 3. evidence pack (stays local unless you synthesize)
 const m = profile.sources.messages || {};
@@ -228,7 +257,7 @@ if (portrait) {
     const shared = { ...scrubDeep(portrait, names), __signals: profile.sources };
     writeFileSync(join(OUT, 'wrapped.share.html'), render(shared, { shareMode: true, stats: { line: statLine, footer: stats.footer } }));
   }
-  try { execFileSync('open', [join(OUT, 'wrapped.html')]); } catch {}
+  if (!has('--no-open')) { try { execFileSync('open', [join(OUT, 'wrapped.html')]); } catch {} }
 }
 
 // ── done
@@ -241,7 +270,7 @@ ${portrait ? `  ${c.d}wrapped.html${c.x}         your portrait
   ${c.d}wrapped.share.html${c.x}   redacted copy, safe to post` : ''}
 
 ${c.d}${statLine}${c.x}
-`);
+${profile.unexplored.apps.length ? `${c.d}  ${profile.unexplored.apps.length} other sources on this machine were detected but not read.\n  Ask Claude to go deeper and it will offer them.${c.x}\n` : ''}`);
 
 // ── 6. hand off to Claude Code
 // The skill was written to disk above, and a *new* claude process loads skills

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "you-wrapped",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Turn the record your Mac already keeps into a portrait of your year. Runs entirely on your machine.",
   "type": "module",
   "bin": { "you-wrapped": "./bin/cli.mjs" },

package/src/discover.mjs

@@ -0,0 +1,86 @@
+// Everyone's machine is different. This looks for sources the CLI does NOT read,
+// so the agent can offer a specific "want to go deeper?" instead of a generic menu.
+// Existence and size only — nothing here opens or parses a file.
+
+import { existsSync, statSync, readdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+const H = homedir();
+const p = (...x) => join(H, ...x);
+
+const CANDIDATES = [
+  // note & knowledge apps
+  { id: 'obsidian',  label: 'Obsidian vault',        path: p('Library/Application Support/obsidian'), why: 'long-form notes and daily journals' },
+  { id: 'notion',    label: 'Notion (local cache)',  path: p('Library/Application Support/Notion'),   why: 'docs and databases you own' },
+  { id: 'bear',      label: 'Bear notes',            path: p('Library/Group Containers/9K33E3U3T4.net.shinyfrog.bear'), why: 'personal notes' },
+  { id: 'craft',     label: 'Craft',                 path: p('Library/Containers/com.lukilabs.lukiapp'), why: 'documents' },
+  { id: 'devonthink',label: 'DEVONthink',            path: p('Library/Application Support/DEVONthink 3'), why: 'research archive' },
+
+  // meetings & comms
+  { id: 'granola',   label: 'Granola',               path: p('Library/Application Support/Granola'),  why: 'meeting notes — what you say out loud (encrypted locally; use the MCP connector)' },
+  { id: 'slack',     label: 'Slack (desktop)',       path: p('Library/Application Support/Slack'),    why: 'where many people ideate, distinct from where they decide' },
+  { id: 'discord',   label: 'Discord',               path: p('Library/Application Support/discord'),  why: 'community and side-project conversation' },
+  { id: 'whatsapp',  label: 'WhatsApp',              path: p('Library/Group Containers/group.net.whatsapp.WhatsApp.shared'), why: 'often where family and non-US contacts live' },
+  { id: 'signal',    label: 'Signal',                path: p('Library/Application Support/Signal'),   why: 'private conversation' },
+  { id: 'mail',      label: 'Apple Mail',            path: p('Library/Mail'),                          why: 'sent mail is a distinct professional voice' },
+
+  // creative & work output
+  { id: 'lightroom', label: 'Lightroom catalog',     path: p('Pictures/Lightroom Library.lrlibrary'), why: 'what you photograph, and how you edit it' },
+  { id: 'photos',    label: 'Photos library',        path: p('Pictures/Photos Library.photoslibrary'), why: 'faces, places, and who you spend time with' },
+  { id: 'resolve',   label: 'DaVinci Resolve',       path: p('Library/Application Support/Blackmagic Design/DaVinci Resolve'), why: 'projects and timelines you cut' },
+  { id: 'xcode',     label: 'Xcode',                 path: p('Library/Developer/Xcode'),              why: 'what you build' },
+  { id: 'music',     label: 'Music library',         path: p('Music/Music/Music Library.musiclibrary'), why: 'taste and listening rhythm' },
+  { id: 'books',     label: 'Apple Books',           path: p('Library/Containers/com.apple.iBooksX'), why: 'what you read and highlight' },
+
+  // agent & shell history
+  { id: 'claude',    label: 'Past Claude sessions',  path: p('.claude/projects'),                     why: 'what you actually ask for help with' },
+  { id: 'cursor',    label: 'Cursor history',        path: p('Library/Application Support/Cursor'),   why: 'how you work with AI in code' },
+  { id: 'zsh',       label: 'Shell history',         path: p('.zsh_history'),                          why: 'the commands you actually run' },
+];
+
+// Folders worth naming if they're large — where someone's real output lives.
+const FOLDERS = ['Desktop', 'Documents', 'Downloads', 'Movies', 'Music', 'Pictures', 'Developer', 'Projects', 'Code'];
+
+function dirBytes(dir, depth = 0, budget = { n: 0 }) {
+  // Deliberately shallow: this is a size hint, not an audit.
+  if (depth > 2 || budget.n > 4000) return 0;
+  let total = 0;
+  let entries;
+  try { entries = readdirSync(dir, { withFileTypes: true }); } catch { return 0; }
+  for (const e of entries) {
+    if (budget.n++ > 4000) break;
+    if (e.name.startsWith('.')) continue;
+    const full = join(dir, e.name);
+    try {
+      if (e.isDirectory()) total += dirBytes(full, depth + 1, budget);
+      else total += statSync(full).size;
+    } catch {}
+  }
+  return total;
+}
+
+export function discover() {
+  const found = [];
+  for (const c of CANDIDATES) {
+    if (!existsSync(c.path)) continue;
+    let size = 0;
+    try { size = statSync(c.path).isDirectory() ? dirBytes(c.path) : statSync(c.path).size; } catch {}
+    found.push({ id: c.id, label: c.label, why: c.why, approxBytes: size });
+  }
+
+  const folders = [];
+  for (const f of FOLDERS) {
+    const dir = p(f);
+    if (!existsSync(dir)) continue;
+    let count = 0;
+    try { count = readdirSync(dir).filter(x => !x.startsWith('.')).length; } catch {}
+    if (count > 0) folders.push({ name: f, entries: count });
+  }
+
+  return {
+    apps: found.sort((a, b) => b.approxBytes - a.approxBytes),
+    folders: folders.sort((a, b) => b.entries - a.entries),
+    note: 'Detected but NOT read. Offer these to the user; read only what they ask for.',
+  };
+}

package/src/prompt.mjs

@@ -40,6 +40,8 @@ RULES:
   ownership — those are the only two levers that move a capacity-constrained person.
 - If the data is thin in some area, say so. An honest gap beats a confident fabrication.
 - Match their voice. If their messages are short and profane, don't write them a corporate memo.
+- After the portrait, offer to go deeper using the "unexplored" block in the signals —
+  name the specific sources found on THIS machine. Read nothing new without an explicit yes.
 
 OUTPUT: a JSON object matching the schema you are given. No prose outside the JSON.`;
 

package/src/render.mjs

@@ -234,7 +234,7 @@ export function render(p, { shareMode = false, stats = {} } = {}) {
 
   const slides = cards.map((c, i) => {
     const t = THEMES[i % THEMES.length];
-    return `<section class="card ${c.kind}" data-i="${i}"
+    return `<section class="card k-${c.kind}" data-i="${i}"
       style="--bg:${t.bg};--fg:${t.fg};--ac:${t.ac}">
       <div class="inner">${c.html}</div></section>`;
   }).join('\n');
@@ -265,15 +265,18 @@ body{font-family:var(--sans);-webkit-font-smoothing:antialiased;overscroll-behav
 }
 
 .card{position:absolute;inset:0;background:var(--bg);color:var(--fg);
-  display:flex;align-items:center;padding:calc(var(--pad) + 34px) var(--pad) calc(var(--pad) + 26px);
+  overflow-y:auto;overflow-x:hidden;-webkit-overflow-scrolling:touch;
+  overscroll-behavior:contain;scrollbar-width:none;
   opacity:0;pointer-events:none;transform:scale(1.03);
   transition:opacity .42s ease,transform .52s cubic-bezier(.2,.75,.3,1)}
+.card::-webkit-scrollbar{display:none}
 .card.on{opacity:1;pointer-events:auto;transform:none}
 /* paper grain — keeps flat color from looking like a CSS default */
-.card::after{content:"";position:absolute;inset:0;pointer-events:none;opacity:.055;
+.inner::after{content:"";position:absolute;inset:0;pointer-events:none;opacity:.055;z-index:-1;
   background-image:url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='120' height='120'><filter id='n'><feTurbulence type='fractalNoise' baseFrequency='.85' numOctaves='3'/></filter><rect width='120' height='120' filter='url(%23n)'/></svg>")}
-.inner{position:relative;z-index:1;width:100%;max-height:100%;overflow-y:auto;scrollbar-width:none}
-.inner::-webkit-scrollbar{display:none}
+.inner{position:relative;z-index:1;width:100%;min-height:100%;
+  display:flex;flex-direction:column;justify-content:center;
+  padding:calc(var(--pad) + 34px) var(--pad) calc(var(--pad) + 26px)}
 
 .eyebrow{font-family:var(--mono);font-size:11px;letter-spacing:.18em;text-transform:uppercase;
   opacity:.62;margin-bottom:20px}
@@ -289,6 +292,14 @@ blockquote::before{content:"“"}blockquote::after{content:"”"}
 .sub{font-family:var(--mono);font-size:12.5px;line-height:1.7;margin-top:26px;opacity:.72;max-width:32ch}
 .small{font-size:14.5px;line-height:1.55;margin-top:16px;opacity:.72;max-width:38ch}
 .cite{font-family:var(--mono);font-size:11.5px;margin-top:18px;opacity:.6}
+#deck[data-more="1"]::after{content:"";position:absolute;left:0;right:0;bottom:0;height:78px;
+  z-index:6;pointer-events:none;
+  background:linear-gradient(to top,var(--fade) 10%,color-mix(in srgb,var(--fade) 65%,transparent) 55%,transparent)}
+.more{position:absolute;right:20px;bottom:14px;z-index:7;color:var(--fadefg);
+  font-family:var(--mono);font-size:10px;letter-spacing:.14em;text-transform:uppercase;
+  opacity:0;transition:opacity .25s;pointer-events:none;display:flex;align-items:center;gap:6px}
+#deck[data-more="1"] .more{opacity:.75;animation:bob 1.8s ease-in-out infinite}
+@keyframes bob{0%,100%{transform:translateY(0)}50%{transform:translateY(3px)}}
 .hint{position:absolute;left:var(--pad);bottom:calc(var(--pad) + 4px);font-family:var(--mono);font-size:11px;
   letter-spacing:.16em;text-transform:uppercase;opacity:.5;animation:pulse 2.4s ease-in-out infinite}
 @keyframes pulse{0%,100%{opacity:.28}50%{opacity:.72}}
@@ -326,8 +337,8 @@ blockquote::before{content:"“"}blockquote::after{content:"”"}
 #deck.dark #bars i{background:rgba(0,0,0,.22)}
 #deck.dark #bars i.done,#deck.dark #bars i.now{background:rgba(0,0,0,.82)}
 
-.tapzone{position:absolute;top:0;bottom:0;width:34%;z-index:8;cursor:pointer}
-.tapzone.l{left:0}.tapzone.r{right:0;width:66%}
+.tapzone{position:absolute;top:0;bottom:0;width:20%;z-index:8;cursor:pointer}
+.tapzone.l{left:0}.tapzone.r{right:0;width:22%}
 #badge{position:absolute;bottom:10px;left:0;right:0;text-align:center;z-index:9;
   font-family:var(--mono);font-size:10px;letter-spacing:.14em;text-transform:uppercase;
   color:rgba(255,255,255,.4)}
@@ -342,7 +353,7 @@ blockquote::before{content:"“"}blockquote::after{content:"”"}
 .evq::before{content:"“"}.evq::after{content:"”"}
 .evq cite{display:block;font-family:var(--mono);font-size:10px;font-style:normal;font-weight:400;
   letter-spacing:.06em;opacity:.55;margin-top:7px}
-.card.chart-card .inner,.card.data .inner{padding-top:4px}
+.card.k-chart .inner,.card.k-data .inner{padding-top:4px}
 ${CHART_CSS}
 
 /* ── long-read mode ── */
@@ -409,6 +420,7 @@ body.reading #stage,body.reading #badge{display:none}
   <div id="bars">${bars}</div>
   ${slides}
   <div class="hint" id="hint">tap or press → to begin</div>
+  <div class="more" id="more">scroll ↓</div>
   <div class="tapzone l" data-nav="-1" aria-hidden="true"></div>
   <div class="tapzone r" data-nav="1" aria-hidden="true"></div>
 </div></div>
@@ -425,12 +437,26 @@ const LIGHT=new Set(cards.map((c,k)=>{
   const v=parseInt(h.slice(0,2),16)*.299+parseInt(h.slice(2,4),16)*.587+parseInt(h.slice(4,6),16)*.114;
   return v>140?k:-1;
 }).filter(k=>k>=0));
+function measure(){
+  cards.forEach(c=>{ c.dataset.more = c.scrollHeight > c.clientHeight + 4 ? '1' : '0'; });
+}
+function syncMore(){
+  const c=cards[i];
+  const more = c.dataset.more==='1' && c.scrollTop + c.clientHeight < c.scrollHeight - 6;
+  deck.dataset.more = more ? '1' : '0';
+  // fade + cue inherit the active card's colours
+  const cs=getComputedStyle(c);
+  deck.style.setProperty('--fade', cs.backgroundColor);
+  deck.style.setProperty('--fadefg', cs.color);
+}
 function show(k){
   const h=document.getElementById('hint'); if(h) h.style.display = k===0 ? '' : 'none';
   i=Math.max(0,Math.min(N-1,k));
   cards.forEach((c,x)=>c.classList.toggle('on',x===i));
   bars.forEach((b,x)=>{b.classList.toggle('done',x<i);b.classList.toggle('now',x===i)});
   deck.classList.toggle('dark',LIGHT.has(i));
+  cards[i].scrollTop=0;
+  requestAnimationFrame(syncMore);
 }
 document.querySelectorAll('[data-nav]').forEach(z=>
   z.addEventListener('click',()=>show(i+ +z.dataset.nav)));
@@ -451,12 +477,18 @@ addEventListener('keydown',e=>{
   if(e.key==='ArrowRight'||e.key===' ')  {e.preventDefault();show(i+1)}
   if(e.key==='ArrowLeft')                {e.preventDefault();show(i-1)}
 });
-let x0=null;
-deck.addEventListener('touchstart',e=>x0=e.touches[0].clientX,{passive:true});
+let x0=null,y0=null;
+deck.addEventListener('touchstart',e=>{x0=e.touches[0].clientX;y0=e.touches[0].clientY},{passive:true});
 deck.addEventListener('touchend',e=>{
-  if(x0===null)return; const dx=e.changedTouches[0].clientX-x0;
-  if(Math.abs(dx)>44) show(i+(dx<0?1:-1)); x0=null;
+  if(x0===null)return;
+  const dx=e.changedTouches[0].clientX-x0, dy=e.changedTouches[0].clientY-y0;
+  // only treat it as a page flip if the gesture is clearly horizontal
+  if(Math.abs(dx)>44 && Math.abs(dx)>Math.abs(dy)*1.5) show(i+(dx<0?1:-1));
+  x0=y0=null;
 },{passive:true});
-show(0);
+cards.forEach(c=>c.addEventListener('scroll',syncMore,{passive:true}));
+addEventListener('resize',()=>{measure();syncMore()});
+if(document.fonts?.ready) document.fonts.ready.then(()=>{measure();syncMore()});
+measure(); show(0);
 </script></body></html>`;
 }