vibejourney 0.2.0 → 0.3.0

package/README.md

@@ -70,6 +70,69 @@ When you open VibeJourney, you'll see what your buddy did while you were coding:
 - **Narrative journal** — travel stories based on terrain, weather, and buddy personality
 - **Offline support** — GeoJSON map cached locally after first download
 
+## Cities, Landmarks & Souvenirs
+
+29 cities, 116 landmarks, 58 souvenirs. Your buddy picks the order. You just write code.
+
+### 🌏 Asia (8)
+
+| City | Landmarks | Souvenirs |
+|---|---|---|
+| Beijing | the Great Wall · the Forbidden City · Tiananmen Square · the Temple of Heaven | 🧧 jade bracelet · 🪭 silk fan |
+| Tokyo | Shibuya Crossing · Tokyo Tower · Senso-ji Temple · Mount Fuji in the distance | 🍣 sushi set · 🌸 sakura bookmark |
+| Seoul | Gyeongbokgung Palace · Bukchon Hanok Village · Namsan Tower · street food in Myeongdong | 🍵 ceramic teacup · 🎵 K-pop album |
+| Hong Kong | Victoria Peak · the Star Ferry · Temple Street Night Market · neon signs reflecting in puddles | 🥮 egg tart box · 💎 jade pendant |
+| Bangkok | the Grand Palace · Wat Arun at sunset · floating markets · tuk-tuks weaving through traffic | 🙏 golden Buddha charm · 🌶️ spicy sauce set |
+| Singapore | Marina Bay Sands · Gardens by the Bay · the Merlion · hawker stalls on every corner | 🌺 orchid pin · 🦁 Merlion figurine |
+| Mumbai | the Gateway of India · Marine Drive at night · Dharavi's colorful streets · Bollywood billboards everywhere | ☕ chai spice blend · 🧣 silk scarf |
+| Dubai | the Burj Khalifa · the Palm Jumeirah · the Dubai Mall · desert dunes at sunset | 🌴 golden dates box · 🧴 oud perfume |
+
+### 🌍 Europe (9)
+
+| City | Landmarks | Souvenirs |
+|---|---|---|
+| Istanbul | the Hagia Sophia · the Grand Bazaar · the Bosphorus at dawn · a cup of Turkish tea | 🍬 Turkish delight box · 🧿 evil eye charm |
+| Moscow | Red Square · St. Basil's Cathedral · the Kremlin walls · the Moscow Metro | 🪆 matryoshka doll · 💍 amber ring |
+| Prague | Charles Bridge · Prague Castle · the Astronomical Clock · a quiet beer garden | 🥂 crystal glass · 🎭 marionette puppet |
+| Berlin | the Brandenburg Gate · remnants of the Berlin Wall · Museum Island · currywurst from a street stand | 🧱 Wall fragment · 🥨 pretzel magnet |
+| Amsterdam | canals lined with bicycles · the Rijksmuseum · Anne Frank House · tulips at a flower market | 🌷 tulip bulb set · 🏠 Delft tile |
+| London | Big Ben · Tower Bridge · the British Museum · a red phone booth | 🫖 Earl Grey tea tin · 🚌 red bus model |
+| Paris | the Eiffel Tower · the Louvre · Montmartre at sunset · a fresh croissant | 🗼 tiny Eiffel Tower · 🧁 macaron box |
+| Barcelona | the Sagrada Familia · Park Guell · La Rambla · tapas at a tiny bar | 🎨 Gaudi mosaic tile · 🍷 sangria mix |
+| Rome | the Colosseum · the Trevi Fountain · the Vatican · gelato on the Spanish Steps | 🏛️ Colosseum snow globe · 🫒 truffle oil bottle |
+
+### 🌍 Africa (4)
+
+| City | Landmarks | Souvenirs |
+|---|---|---|
+| Cairo | the Pyramids of Giza · the Sphinx · the Nile at dusk · Khan el-Khalili bazaar | 🏺 miniature pyramid · 📜 papyrus scroll |
+| Nairobi | Nairobi National Park · giraffes walking past the skyline · the Karen Blixen Museum · Kenyan coffee at a local cafe | ☕ Kenyan coffee beans · 📿 Maasai beads |
+| Marrakech | Jemaa el-Fnaa square · the Majorelle Garden · the Medina's winding alleys · mint tea on a rooftop | 🫒 argan oil bottle · 🧶 Berber rug swatch |
+| Cape Town | Table Mountain · the Cape of Good Hope · penguins at Boulders Beach · vineyards stretching to the hills | 🫖 rooibos tea tin · 🐧 penguin figure |
+
+### 🌎 North America (4)
+
+| City | Landmarks | Souvenirs |
+|---|---|---|
+| New York | the Statue of Liberty · Times Square · Central Park · a New York slice | ☕ I♥NY mug · 🪙 subway token |
+| Los Angeles | the Hollywood sign · Santa Monica Pier · Venice Beach · palm trees lining the boulevard | ⭐ Hollywood star badge · 🕶️ sunglasses |
+| San Francisco | the Golden Gate Bridge · Alcatraz Island · cable cars on steep hills · fog rolling over the bay | 🔔 cable car bell · 🍞 sourdough starter |
+| Mexico City | the Zocalo · Frida Kahlo's Blue House · Chapultepec Castle · tacos al pastor from a street cart | 🪨 obsidian mirror · 🍫 hot chocolate mix |
+
+### 🌎 South America (2)
+
+| City | Landmarks | Souvenirs |
+|---|---|---|
+| Buenos Aires | La Boca's colorful houses · Plaza de Mayo · a tango show on the street · steak sizzling at a parrilla | 🧉 mate gourd · 💃 tango music box |
+| Rio | Christ the Redeemer · Sugarloaf Mountain · Copacabana Beach · samba music in the streets | 🪇 samba shaker · 🫐 açaí bowl recipe |
+
+### 🌏 Oceania (2)
+
+| City | Landmarks | Souvenirs |
+|---|---|---|
+| Sydney | the Opera House · Harbour Bridge · Bondi Beach · the Blue Mountains | 🪃 boomerang keychain · 💠 opal stone |
+| Auckland | the Sky Tower · Rangitoto Island · sailing boats in the harbour · a hangi feast | 🟢 pounamu pendant · 🥝 kiwi plush |
+
 ## Commands
 
 ```bash

package/README.zh-CN.md

@@ -70,6 +70,69 @@ buddy 自己选目的地（你不控制它去哪）。它优先去没去过的
 - **叙事日志** — 基于地形、天气和 buddy 性格的旅行故事
 - **离线支持** — 首次下载后地图本地缓存
 
+## 城市、地标与特产
+
+29 座城市，116 个地标，58 件特产。buddy 自己挑顺序，你只管写代码。
+
+### 🌏 亚洲 (8)
+
+| 城市 | 地标 | 特产 |
+|---|---|---|
+| Beijing | the Great Wall · the Forbidden City · Tiananmen Square · the Temple of Heaven | 🧧 jade bracelet · 🪭 silk fan |
+| Tokyo | Shibuya Crossing · Tokyo Tower · Senso-ji Temple · Mount Fuji in the distance | 🍣 sushi set · 🌸 sakura bookmark |
+| Seoul | Gyeongbokgung Palace · Bukchon Hanok Village · Namsan Tower · street food in Myeongdong | 🍵 ceramic teacup · 🎵 K-pop album |
+| Hong Kong | Victoria Peak · the Star Ferry · Temple Street Night Market · neon signs reflecting in puddles | 🥮 egg tart box · 💎 jade pendant |
+| Bangkok | the Grand Palace · Wat Arun at sunset · floating markets · tuk-tuks weaving through traffic | 🙏 golden Buddha charm · 🌶️ spicy sauce set |
+| Singapore | Marina Bay Sands · Gardens by the Bay · the Merlion · hawker stalls on every corner | 🌺 orchid pin · 🦁 Merlion figurine |
+| Mumbai | the Gateway of India · Marine Drive at night · Dharavi's colorful streets · Bollywood billboards everywhere | ☕ chai spice blend · 🧣 silk scarf |
+| Dubai | the Burj Khalifa · the Palm Jumeirah · the Dubai Mall · desert dunes at sunset | 🌴 golden dates box · 🧴 oud perfume |
+
+### 🌍 欧洲 (9)
+
+| 城市 | 地标 | 特产 |
+|---|---|---|
+| Istanbul | the Hagia Sophia · the Grand Bazaar · the Bosphorus at dawn · a cup of Turkish tea | 🍬 Turkish delight box · 🧿 evil eye charm |
+| Moscow | Red Square · St. Basil's Cathedral · the Kremlin walls · the Moscow Metro | 🪆 matryoshka doll · 💍 amber ring |
+| Prague | Charles Bridge · Prague Castle · the Astronomical Clock · a quiet beer garden | 🥂 crystal glass · 🎭 marionette puppet |
+| Berlin | the Brandenburg Gate · remnants of the Berlin Wall · Museum Island · currywurst from a street stand | 🧱 Wall fragment · 🥨 pretzel magnet |
+| Amsterdam | canals lined with bicycles · the Rijksmuseum · Anne Frank House · tulips at a flower market | 🌷 tulip bulb set · 🏠 Delft tile |
+| London | Big Ben · Tower Bridge · the British Museum · a red phone booth | 🫖 Earl Grey tea tin · 🚌 red bus model |
+| Paris | the Eiffel Tower · the Louvre · Montmartre at sunset · a fresh croissant | 🗼 tiny Eiffel Tower · 🧁 macaron box |
+| Barcelona | the Sagrada Familia · Park Guell · La Rambla · tapas at a tiny bar | 🎨 Gaudi mosaic tile · 🍷 sangria mix |
+| Rome | the Colosseum · the Trevi Fountain · the Vatican · gelato on the Spanish Steps | 🏛️ Colosseum snow globe · 🫒 truffle oil bottle |
+
+### 🌍 非洲 (4)
+
+| 城市 | 地标 | 特产 |
+|---|---|---|
+| Cairo | the Pyramids of Giza · the Sphinx · the Nile at dusk · Khan el-Khalili bazaar | 🏺 miniature pyramid · 📜 papyrus scroll |
+| Nairobi | Nairobi National Park · giraffes walking past the skyline · the Karen Blixen Museum · Kenyan coffee at a local cafe | ☕ Kenyan coffee beans · 📿 Maasai beads |
+| Marrakech | Jemaa el-Fnaa square · the Majorelle Garden · the Medina's winding alleys · mint tea on a rooftop | 🫒 argan oil bottle · 🧶 Berber rug swatch |
+| Cape Town | Table Mountain · the Cape of Good Hope · penguins at Boulders Beach · vineyards stretching to the hills | 🫖 rooibos tea tin · 🐧 penguin figure |
+
+### 🌎 北美洲 (4)
+
+| 城市 | 地标 | 特产 |
+|---|---|---|
+| New York | the Statue of Liberty · Times Square · Central Park · a New York slice | ☕ I♥NY mug · 🪙 subway token |
+| Los Angeles | the Hollywood sign · Santa Monica Pier · Venice Beach · palm trees lining the boulevard | ⭐ Hollywood star badge · 🕶️ sunglasses |
+| San Francisco | the Golden Gate Bridge · Alcatraz Island · cable cars on steep hills · fog rolling over the bay | 🔔 cable car bell · 🍞 sourdough starter |
+| Mexico City | the Zocalo · Frida Kahlo's Blue House · Chapultepec Castle · tacos al pastor from a street cart | 🪨 obsidian mirror · 🍫 hot chocolate mix |
+
+### 🌎 南美洲 (2)
+
+| 城市 | 地标 | 特产 |
+|---|---|---|
+| Buenos Aires | La Boca's colorful houses · Plaza de Mayo · a tango show on the street · steak sizzling at a parrilla | 🧉 mate gourd · 💃 tango music box |
+| Rio | Christ the Redeemer · Sugarloaf Mountain · Copacabana Beach · samba music in the streets | 🪇 samba shaker · 🫐 açaí bowl recipe |
+
+### 🌏 大洋洲 (2)
+
+| 城市 | 地标 | 特产 |
+|---|---|---|
+| Sydney | the Opera House · Harbour Bridge · Bondi Beach · the Blue Mountains | 🪃 boomerang keychain · 💠 opal stone |
+| Auckland | the Sky Tower · Rangitoto Island · sailing boats in the harbour · a hangi feast | 🟢 pounamu pendant · 🥝 kiwi plush |
+
 ## 命令
 
 ```bash

package/dist/index.js

@@ -30,6 +30,82 @@ var __export = (target, all) => {
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
+// src/wyhash.ts
+function mum(a, b) {
+  const x = a * b;
+  return { low: x & MASK64, high: x >> 64n & MASK64 };
+}
+function mix(a, b) {
+  const { low, high } = mum(a, b);
+  return (low ^ high) & MASK64;
+}
+function wyr8(p, i) {
+  return BigInt(p[i]) | BigInt(p[i + 1]) << 8n | BigInt(p[i + 2]) << 16n | BigInt(p[i + 3]) << 24n | BigInt(p[i + 4]) << 32n | BigInt(p[i + 5]) << 40n | BigInt(p[i + 6]) << 48n | BigInt(p[i + 7]) << 56n;
+}
+function wyr4(p, i) {
+  return BigInt(p[i]) | BigInt(p[i + 1]) << 8n | BigInt(p[i + 2]) << 16n | BigInt(p[i + 3]) << 24n;
+}
+function wyhash64(input, seedInit = 0n) {
+  const p = utf8.encode(input);
+  const len = p.length;
+  const s0 = (seedInit ^ mix((seedInit ^ SECRET[0]) & MASK64, SECRET[1])) & MASK64;
+  const state = [s0, s0, s0];
+  let a;
+  let b;
+  if (len <= 16) {
+    if (len >= 4) {
+      const end = len - 4;
+      const quarter = len >> 3 << 2;
+      a = (wyr4(p, 0) << 32n | wyr4(p, quarter)) & MASK64;
+      b = (wyr4(p, end) << 32n | wyr4(p, end - quarter)) & MASK64;
+    } else if (len > 0) {
+      a = BigInt(p[0]) << 16n | BigInt(p[len >> 1]) << 8n | BigInt(p[len - 1]);
+      b = 0n;
+    } else {
+      a = 0n;
+      b = 0n;
+    }
+  } else {
+    let i = 0;
+    if (len >= 48) {
+      while (i + 48 < len) {
+        for (let k = 0;k < 3; k++) {
+          const ra = wyr8(p, i + 16 * k);
+          const rb = wyr8(p, i + 16 * k + 8);
+          state[k] = mix((ra ^ SECRET[k + 1]) & MASK64, (rb ^ state[k]) & MASK64);
+        }
+        i += 48;
+      }
+      state[0] = (state[0] ^ state[1] ^ state[2]) & MASK64;
+    }
+    const remaining = len - i;
+    let j = 0;
+    while (j + 16 < remaining) {
+      const off = i + j;
+      state[0] = mix((wyr8(p, off) ^ SECRET[1]) & MASK64, (wyr8(p, off + 8) ^ state[0]) & MASK64);
+      j += 16;
+    }
+    a = wyr8(p, len - 16);
+    b = wyr8(p, len - 8);
+  }
+  a = (a ^ SECRET[1]) & MASK64;
+  b = (b ^ state[0]) & MASK64;
+  const { low, high } = mum(a, b);
+  a = low;
+  b = high;
+  return mix((a ^ SECRET[0] ^ BigInt(len)) & MASK64, (b ^ SECRET[1]) & MASK64);
+}
+var SECRET, MASK64 = 0xffffffffffffffffn, utf8;
+var init_wyhash = __esm(() => {
+  SECRET = [
+    0xa0761d6478bd642fn,
+    0xe7037ed1a0b428dbn,
+    0x8ebc6af09c88c6e3n,
+    0x589965cc75374cc3n
+  ];
+  utf8 = new TextEncoder;
+});
+
 // src/buddy.ts
 import { readFileSync } from "fs";
 import { homedir } from "os";
@@ -45,15 +121,8 @@ function mulberry32(seed) {
   };
 }
 function hashString(s) {
-  if (typeof Bun !== "undefined") {
-    return Number(BigInt(Bun.hash(s)) & 0xffffffffn);
-  }
-  let h = 2166136261;
-  for (let i = 0;i < s.length; i++) {
-    h ^= s.charCodeAt(i);
-    h = Math.imul(h, 16777619);
-  }
-  return h >>> 0;
+  const h = typeof Bun !== "undefined" ? BigInt(Bun.hash(s)) : wyhash64(s);
+  return Number(h & 0xffffffffn);
 }
 function pick(rng, arr) {
   return arr[Math.floor(rng() * arr.length)];
@@ -133,6 +202,7 @@ function getLocalCompanion() {
 }
 var RARITIES, SPECIES, EYES, HATS, STAT_NAMES, RARITY_WEIGHTS, BODIES, HAT_LINES, RARITY_FLOOR, SALT = "friend-2026-401";
 var init_buddy = __esm(() => {
+  init_wyhash();
   RARITIES = ["common", "uncommon", "rare", "epic", "legendary"];
   SPECIES = [
     "duck",
@@ -2629,6 +2699,211 @@ function renderSummary(events, buddyName, foodName, foodEmoji) {
   return out;
 }
 
+// src/onboarding.ts
+init_colors();
+init_buddy();
+import { existsSync as existsSync2 } from "fs";
+import { readdir as readdir2 } from "fs/promises";
+import { homedir as homedir6 } from "os";
+import { join as join6 } from "path";
+var STATE_FILE2 = join6(homedir6(), ".vibejourney", "state.json");
+var CLAUDE_PROJECTS = join6(homedir6(), ".claude", "projects");
+var CLEAR = "\x1B[2J\x1B[H";
+var RULE = C.dim + "─".repeat(52) + C.reset;
+function needsOnboarding() {
+  return !existsSync2(STATE_FILE2);
+}
+async function checkTokenLogs() {
+  if (!existsSync2(CLAUDE_PROJECTS))
+    return false;
+  try {
+    const entries = await readdir2(CLAUDE_PROJECTS, { recursive: true });
+    for (const e of entries) {
+      if (typeof e === "string" && e.endsWith(".jsonl"))
+        return true;
+    }
+    return false;
+  } catch {
+    return false;
+  }
+}
+function waitForEnter() {
+  return new Promise((resolve) => {
+    process.stdin.resume();
+    const handler = () => {
+      process.stdin.removeListener("data", handler);
+      process.stdin.pause();
+      resolve();
+    };
+    process.stdin.on("data", handler);
+  });
+}
+function screenWelcome() {
+  process.stdout.write(CLEAR);
+  const pad = "  ";
+  const out = [];
+  out.push("");
+  out.push(`${pad}${C.bold}\uD83C\uDF0D  VibeJourney${C.reset}`);
+  out.push(`${pad}${C.dim}Your vibe coding is also a journey.${C.reset}`);
+  out.push("");
+  out.push(`${pad}${RULE}`);
+  out.push("");
+  out.push(`${pad}Every line of code you write sends your buddy a little further`);
+  out.push(`${pad}into the world. While you're deep in a 2am debugging session,`);
+  out.push(`${pad}your companion is watching the sunset in Barcelona. When you`);
+  out.push(`${pad}finally ship that feature, they've already reached Tokyo and`);
+  out.push(`${pad}picked up a souvenir for you.`);
+  out.push("");
+  out.push(`${pad}${C.bold}How it works${C.reset}`);
+  out.push("");
+  out.push(`${pad}${C.yellow}You code${C.reset}        →  daily Claude Code tokens become food`);
+  out.push(`${pad}${C.yellow}Buddy explores${C.reset}  →  visits landmarks in the current city`);
+  out.push(`${pad}${C.yellow}Buddy travels${C.reset}   →  walks toward the next city`);
+  out.push(`${pad}${C.yellow}You rest${C.reset}        →  buddy rests with you`);
+  out.push("");
+  out.push(`${pad}${C.dim}29 cities  ·  18 companion species  ·  one quiet journey${C.reset}`);
+  out.push("");
+  out.push(`${pad}${RULE}`);
+  out.push("");
+  out.push(`${pad}${C.dim}Press ${C.reset}${C.bold}Enter${C.reset}${C.dim} to continue...${C.reset}`);
+  process.stdout.write(out.join(`
+`) + `
+`);
+}
+function screenSetup(buddy, hasTokenLogs) {
+  process.stdout.write(CLEAR);
+  const pad = "  ";
+  const out = [];
+  out.push("");
+  out.push(`${pad}${C.bold}Setup check${C.reset}`);
+  out.push("");
+  out.push(`${pad}${RULE}`);
+  out.push("");
+  if (buddy) {
+    out.push(`${pad}${C.green}✓${C.reset}  Claude Code companion found`);
+    out.push(`${pad}   ${C.dim}Your buddy is named ${C.reset}${C.yellow}${buddy.name}${C.reset}${C.dim}.${C.reset}`);
+  } else {
+    out.push(`${pad}${C.yellow}!${C.reset}  ${C.dim}No companion in ${C.reset}${C.yellow}~/.claude.json${C.reset}`);
+    out.push(`${pad}   ${C.dim}Install Claude Code and enable the companion for a${C.reset}`);
+    out.push(`${pad}   ${C.dim}named buddy with personality-driven commentary.${C.reset}`);
+    out.push(`${pad}   ${C.dim}Without it your traveler is nameless but still walks.${C.reset}`);
+  }
+  out.push("");
+  if (hasTokenLogs) {
+    out.push(`${pad}${C.green}✓${C.reset}  Claude Code token logs found`);
+    out.push(`${pad}   ${C.dim}Your buddy already has food to spend.${C.reset}`);
+  } else {
+    out.push(`${pad}${C.yellow}!${C.reset}  ${C.dim}No token logs at ${C.reset}${C.yellow}~/.claude/projects/${C.reset}`);
+    out.push(`${pad}   ${C.dim}Run ${C.reset}${C.bold}claude${C.reset}${C.dim} at least once so vibejourney has${C.reset}`);
+    out.push(`${pad}   ${C.dim}tokens to turn into food. Until then, buddy rests.${C.reset}`);
+  }
+  out.push("");
+  out.push(`${pad}${C.dim}Data lives at ${C.reset}${C.yellow}~/.vibejourney${C.reset}${C.dim}.  Start over with ${C.reset}${C.bold}--reset${C.reset}${C.dim}.${C.reset}`);
+  out.push("");
+  out.push(`${pad}${RULE}`);
+  out.push("");
+  out.push(`${pad}${C.dim}Press ${C.reset}${C.bold}Enter${C.reset}${C.dim} to continue...${C.reset}`);
+  process.stdout.write(out.join(`
+`) + `
+`);
+}
+function wrapText(text, width) {
+  const words = text.split(/\s+/);
+  const lines = [];
+  let line = "";
+  for (const w of words) {
+    const next = line ? `${line} ${w}` : w;
+    if (next.length > width && line) {
+      lines.push(line);
+      line = w;
+    } else {
+      line = next;
+    }
+  }
+  if (line)
+    lines.push(line);
+  return lines;
+}
+function screenBuddy(buddy) {
+  process.stdout.write(CLEAR);
+  const pad = "  ";
+  const out = [];
+  out.push("");
+  if (buddy) {
+    out.push(`${pad}${C.bold}Meet ${C.reset}${C.yellow}${buddy.name}${C.reset}`);
+    out.push("");
+    out.push(`${pad}${RULE}`);
+    out.push("");
+    const sprite = renderSprite(buddy, 0);
+    for (const line of sprite) {
+      out.push(`${pad}   ${C.white}${line}${C.reset}`);
+    }
+    out.push("");
+    const tag = `${buddy.rarity} ${buddy.species}${buddy.shiny ? " · ✨ shiny" : ""}`;
+    out.push(`${pad}${C.dim}${tag}${C.reset}`);
+    if (buddy.personality) {
+      out.push("");
+      for (const line of wrapText(buddy.personality, 56)) {
+        out.push(`${pad}${C.dim}"${line}"${C.reset}`);
+      }
+    }
+  } else {
+    out.push(`${pad}${C.bold}Your traveler awaits${C.reset}`);
+    out.push("");
+    out.push(`${pad}${RULE}`);
+    out.push("");
+    out.push(`${pad}${C.dim}Without a Claude Code companion your buddy will be a${C.reset}`);
+    out.push(`${pad}${C.dim}nameless wanderer. Still exploring, still collecting${C.reset}`);
+    out.push(`${pad}${C.dim}souvenirs, still finding its way — just quietly.${C.reset}`);
+  }
+  out.push("");
+  out.push(`${pad}${RULE}`);
+  out.push("");
+  out.push(`${pad}${C.yellow}The journey begins when you press ${C.reset}${C.bold}Enter${C.reset}${C.yellow}.${C.reset}`);
+  out.push("");
+  process.stdout.write(out.join(`
+`) + `
+`);
+}
+function printCompact(buddy, hasTokenLogs) {
+  const pad = "  ";
+  const out = [];
+  out.push("");
+  out.push(`${pad}${C.bold}\uD83C\uDF0D  VibeJourney${C.reset}  ${C.dim}— Your vibe coding is also a journey.${C.reset}`);
+  out.push("");
+  out.push(`${pad}Your daily Claude Code tokens feed a buddy that explores`);
+  out.push(`${pad}landmarks and walks between 29 cities while you write code.`);
+  out.push("");
+  if (buddy) {
+    out.push(`${pad}${C.green}✓${C.reset} Companion: ${C.yellow}${buddy.name}${C.reset} ${C.dim}(${buddy.rarity} ${buddy.species})${C.reset}`);
+  } else {
+    out.push(`${pad}${C.yellow}!${C.reset} ${C.dim}No Claude Code companion — buddy will be nameless.${C.reset}`);
+  }
+  if (hasTokenLogs) {
+    out.push(`${pad}${C.green}✓${C.reset} Token logs detected.`);
+  } else {
+    out.push(`${pad}${C.yellow}!${C.reset} ${C.dim}No token history yet — run claude first.${C.reset}`);
+  }
+  out.push("");
+  process.stdout.write(out.join(`
+`) + `
+`);
+}
+async function runOnboarding(buddy, hasTokenLogs) {
+  const interactive = Boolean(process.stdout.isTTY && process.stdin.isTTY);
+  if (!interactive) {
+    printCompact(buddy, hasTokenLogs);
+    return;
+  }
+  screenWelcome();
+  await waitForEnter();
+  screenSetup(buddy, hasTokenLogs);
+  await waitForEnter();
+  screenBuddy(buddy);
+  await waitForEnter();
+  process.stdout.write(CLEAR);
+}
+
 // index.ts
 var args = process.argv.slice(2);
 if (args[0] === "--help" || args[0] === "-h") {
@@ -2656,9 +2931,9 @@ if (args[0] === "--help" || args[0] === "-h") {
 }
 if (args[0] === "--reset") {
   const { rm } = await import("fs/promises");
-  const { join: join6 } = await import("path");
-  const { homedir: homedir6 } = await import("os");
-  const dir = join6(homedir6(), ".vibejourney");
+  const { join: join7 } = await import("path");
+  const { homedir: homedir7 } = await import("os");
+  const dir = join7(homedir7(), ".vibejourney");
   process.stdout.write(`
   This will delete all journey data at ${dir}
 `);
@@ -2671,17 +2946,15 @@ if (args[0] === "--reset") {
     process.stdin.once("data", (data) => resolve(data.toString().trim()));
   });
   if (response.toLowerCase() === "yes") {
-    await rm(join6(dir, "state.json"), { force: true });
-    await rm(join6(dir, "journal.jsonl"), { force: true });
-    console.log(`
-  Journey reset. Run again to start fresh!
-`);
+    await rm(join7(dir, "state.json"), { force: true });
+    await rm(join7(dir, "journal.jsonl"), { force: true });
+    process.stdin.pause();
   } else {
     console.log(`
   Reset cancelled.
 `);
+    process.exit(0);
   }
-  process.exit(0);
 }
 if (args[0] === "--collection") {
   const buddy = getLocalCompanion();
@@ -2734,6 +3007,11 @@ if (args[0] === "--stats") {
   process.exit(0);
 }
 async function main() {
+  if (needsOnboarding()) {
+    const buddyForIntro = getLocalCompanion();
+    const hasTokenLogs = await checkTokenLogs();
+    await runOnboarding(buddyForIntro, hasTokenLogs);
+  }
   process.stderr.write(`${C.dim}Loading...${C.reset}
 `);
   const buddy = getLocalCompanion();
@@ -2841,7 +3119,7 @@ async function main() {
     let out = `
 
 `;
-    out += `${pad}${C.bold}\uD83C\uDF0D VibeJourney${C.reset}
+    out += `${pad}${C.bold}\uD83C\uDF0D VibeJourney${C.reset}  ${C.dim}\u2014 Your vibe coding is also a journey.${C.reset}
 `;
     out += `${pad}${C.dim}[j] \uD83D\uDCD6 journal  \xB7  [c] \uD83C\uDF92 collection  \xB7  [s] \uD83D\uDCCA stats  \xB7  [r] \uD83D\uDD04 refresh  \xB7  [q] exit${C.reset}
 `;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vibejourney",
-  "version": "0.2.0",
-  "description": "Travel Frog for coders — your buddy explores the world while you write code",
+  "version": "0.3.0",
+  "description": "Your vibe coding is also a journey — your buddy explores the world while you write code",
   "type": "module",
   "license": "MIT",
   "author": {