vibeglish 0.1.0

package/CLAUDE.md

@@ -0,0 +1,22 @@
+# VibeGlish
+
+一个 Claude Code Hook 驱动的英语学习工具。
+
+## 架构
+- `src/hooks/capture.sh` — UserPromptSubmit hook，写入 ~/.vibeglish/raw/
+- `src/cli/index.mjs` — CLI 入口，子命令：init/review/report/serve/export
+- `src/review/engine.mjs` — 通过 claude CLI 批量纠正引擎
+- `src/dashboard/index.html` — 单文件 Web Dashboard
+- `src/achievements.mjs` — 成就系统计算逻辑
+
+## 约束
+- capture.sh 必须 < 50ms 完成，不做网络请求
+- Dashboard 是单个 HTML 文件，不用框架，不用构建工具
+- 所有数据存储在 ~/.vibeglish/，不用数据库
+- CLI 用 Node.js ESM，最低支持 Node 18
+- AI 纠正通过 `claude -p` CLI 调用，使用用户的订阅额度
+
+## 测试
+- `npm test` 运行全部测试
+- hook 测试用 `echo '{"prompt":"test"}' | bash src/hooks/capture.sh`
+- API 测试用 mock，不实际调用

package/README.md

@@ -0,0 +1,82 @@
+# VibeGlish
+
+> 把你每天跟 Claude Code 说的"蹩脚英语"变成最好的学习素材
+
+VibeGlish 是一个 Claude Code Hook 驱动的**被动式英语学习系统**。它静默记录你发给 Claude Code 的每条 prompt，定期批量调用 AI 进行语法纠正与分析，通过本地 Web Dashboard 呈现你的英语成长轨迹。
+
+## 2 分钟上手
+
+```bash
+# 1. 安装
+npx vibeglish init
+
+# 2. 重启 Claude Code（使 hook 生效）
+
+# 3. 正常使用 Claude Code 写代码...
+#    你的 prompt 会被静默采集
+
+# 4. 触发 AI 纠正（通过 claude CLI，使用你的订阅额度）
+vibeglish review
+
+# 5. 查看结果
+vibeglish serve      # 打开 Web Dashboard
+vibeglish report     # 终端查看周报
+```
+
+## 特性
+
+- **零打扰** — 采集阶段完全静默，不中断编码心流
+- **后置学习** — 攒够素材后统一复习，非实时打断纠错
+- **游戏化** — 成就系统 + 数据可视化让复习不枯燥
+- **开发者友好** — 所有数据本地存储，CLI 优先，一切可 hack
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `vibeglish init` | 初始化 + 安装 Hook |
+| `vibeglish status` | 显示采集/复习统计 |
+| `vibeglish review` | 触发 AI 纠正 |
+| `vibeglish report` | 终端打印周报 |
+| `vibeglish serve` | 启动 Web Dashboard |
+| `vibeglish export` | 导出数据 (JSON/CSV) |
+| `vibeglish hook-test` | 测试 Hook 是否正常 |
+| `vibeglish uninstall` | 移除 Hook（保留数据） |
+
+## Review 选项
+
+```bash
+vibeglish review                          # 纠正所有未处理的日期
+vibeglish review --date 2026-04-03        # 纠正指定日期
+vibeglish review --from 2026-03-25 --to 2026-04-03  # 日期范围
+vibeglish review --force                  # 强制重新纠正
+```
+
+## 前置依赖
+
+- Node.js >= 18
+- [jq](https://jqlang.github.io/jq/) (`brew install jq`)
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI 已登录（review 使用你的订阅额度）
+
+## 数据安全
+
+- 所有数据仅存储在本地 `~/.vibeglish/`
+- AI 纠正通过 `claude` CLI 调用，使用你已有的 Claude 订阅
+- 明显的 secret 模式 (API key 等) 会被自动脱敏
+
+## 配置
+
+配置文件位于 `~/.vibeglish/config.json`：
+
+```json
+{
+  "min_word_count": 4,
+  "max_code_ratio": 0.7,
+  "batch_size": 20,
+  "dashboard_port": 6188
+}
+```
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "vibeglish",
+  "version": "0.1.0",
+  "description": "Learn English naturally while vibe coding with Claude Code",
+  "type": "module",
+  "bin": {
+    "vibeglish": "src/cli/index.mjs"
+  },
+  "scripts": {
+    "test": "node --test test/**/*.test.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {},
+  "keywords": [
+    "claude-code",
+    "english-learning",
+    "hook",
+    "developer-tools"
+  ],
+  "license": "MIT"
+}

package/src/achievements.mjs

@@ -0,0 +1,240 @@
+import { readJSON, writeJSON } from './utils.mjs';
+import { ACHIEVEMENTS_PATH } from './constants.mjs';
+
+const ACHIEVEMENTS = [
+  {
+    id: 'first_blood',
+    name: 'First Blood',
+    icon: '\u{1FA78}',
+    description: '完成第一次 review',
+    check(data) {
+      const reviewed = data.filter(d => d.stats.total_reviewed > 0);
+      return {
+        unlocked: reviewed.length > 0,
+        progress: Math.min(reviewed.length, 1),
+        target: 1,
+      };
+    },
+  },
+  {
+    id: 'century_club',
+    name: 'Century Club',
+    icon: '\u{1F4AF}',
+    description: '累计 review 100 条 prompt',
+    check(data) {
+      const total = data.reduce((sum, d) => sum + d.stats.total_reviewed, 0);
+      return { unlocked: total >= 100, progress: total, target: 100 };
+    },
+  },
+  {
+    id: 'thousand_words',
+    name: 'Thousand Words',
+    icon: '\u{1F4DA}',
+    description: '累计 review 1000 条 prompt',
+    check(data) {
+      const total = data.reduce((sum, d) => sum + d.stats.total_reviewed, 0);
+      return { unlocked: total >= 1000, progress: total, target: 1000 };
+    },
+  },
+  {
+    id: 'streak_7',
+    name: 'Streak Master x7',
+    icon: '\u{1F525}',
+    description: '连续 7 天有记录',
+    check(data) {
+      return { ...checkStreak(data, 7), target: 7 };
+    },
+  },
+  {
+    id: 'streak_30',
+    name: 'Streak Master x30',
+    icon: '\u{1F525}',
+    description: '连续 30 天有记录',
+    check(data) {
+      return { ...checkStreak(data, 30), target: 30 };
+    },
+  },
+  {
+    id: 'clean_coder',
+    name: 'Clean Coder',
+    icon: '\u2728',
+    description: '单日 clean prompt 占比 > 50%',
+    check(data) {
+      for (const day of data) {
+        if (day.entries.length === 0) continue;
+        const clean = day.entries.filter(e => e.is_clean).length;
+        if (clean / day.entries.length > 0.5) {
+          return { unlocked: true, progress: 1, target: 1 };
+        }
+      }
+      const best = data.reduce((max, day) => {
+        if (day.entries.length === 0) return max;
+        return Math.max(max, day.entries.filter(e => e.is_clean).length / day.entries.length);
+      }, 0);
+      return { unlocked: false, progress: Math.round(best * 100), target: 50 };
+    },
+  },
+  {
+    id: 'perfect_day',
+    name: 'Perfect Day',
+    icon: '\u{1F48E}',
+    description: '单日全部 prompt score >= 90',
+    check(data) {
+      for (const day of data) {
+        if (day.entries.length === 0) continue;
+        const allHigh = day.entries.every(e => (e.score || 0) >= 90);
+        if (allHigh) return { unlocked: true, progress: 1, target: 1 };
+      }
+      return { unlocked: false, progress: 0, target: 1 };
+    },
+  },
+  {
+    id: 'article_apprentice',
+    name: 'Article Apprentice',
+    icon: '\u{1F393}',
+    description: '连续 3 天无冠词错误',
+    check(data) {
+      const sorted = [...data].sort((a, b) => a.date.localeCompare(b.date));
+      let streak = 0;
+      let maxStreak = 0;
+      for (const day of sorted) {
+        const hasArticleError = day.entries.some(e =>
+          (e.issues || []).some(i =>
+            i.type === 'grammar' && /article|冠词|a\/the/i.test(i.rule || '')
+          )
+        );
+        streak = hasArticleError ? 0 : streak + 1;
+        maxStreak = Math.max(maxStreak, streak);
+      }
+      return { unlocked: maxStreak >= 3, progress: maxStreak, target: 3 };
+    },
+  },
+  {
+    id: 'polyglot',
+    name: 'Polyglot',
+    icon: '\u{1F30D}',
+    description: '在 5 个不同 project 中留下记录',
+    check(data) {
+      const projects = new Set();
+      for (const day of data) {
+        for (const e of day.entries) {
+          if (e.project) projects.add(e.project);
+        }
+      }
+      return { unlocked: projects.size >= 5, progress: projects.size, target: 5 };
+    },
+  },
+  {
+    id: 'night_owl',
+    name: 'Night Owl',
+    icon: '\u{1F989}',
+    description: '凌晨 0-5 点仍在 coding 并留下 prompt',
+    check(data) {
+      for (const day of data) {
+        for (const e of day.entries) {
+          if (!e.ts) continue;
+          const hour = new Date(e.ts).getHours();
+          if (hour >= 0 && hour < 5) {
+            return { unlocked: true, progress: 1, target: 1 };
+          }
+        }
+      }
+      return { unlocked: false, progress: 0, target: 1 };
+    },
+  },
+  {
+    id: 'grammar_guru',
+    name: 'Grammar Guru',
+    icon: '\u{1F4D0}',
+    description: '连续 7 天 grammar 类错误 <= 2 次/天',
+    check(data) {
+      const sorted = [...data].sort((a, b) => a.date.localeCompare(b.date));
+      let streak = 0;
+      let maxStreak = 0;
+      for (const day of sorted) {
+        const grammarCount = day.entries.reduce((sum, e) =>
+          sum + (e.issues || []).filter(i => i.type === 'grammar').length, 0);
+        streak = grammarCount <= 2 ? streak + 1 : 0;
+        maxStreak = Math.max(maxStreak, streak);
+      }
+      return { unlocked: maxStreak >= 7, progress: maxStreak, target: 7 };
+    },
+  },
+  {
+    id: 'speed_learner',
+    name: 'Speed Learner',
+    icon: '\u26A1',
+    description: '某错误类型周频次从 >10 降至 <3',
+    check(data) {
+      const sorted = [...data].sort((a, b) => a.date.localeCompare(b.date));
+      if (sorted.length < 14) return { unlocked: false, progress: 0, target: 1 };
+
+      const types = ['grammar', 'vocabulary', 'spelling', 'punctuation', 'style', 'word_order'];
+      for (const type of types) {
+        // Compare first 7 days vs last 7 days
+        const firstWeek = sorted.slice(0, 7);
+        const lastWeek = sorted.slice(-7);
+        const countIssues = (days) => days.reduce((sum, d) =>
+          sum + d.entries.reduce((s, e) =>
+            s + (e.issues || []).filter(i => i.type === type).length, 0), 0);
+        const firstCount = countIssues(firstWeek);
+        const lastCount = countIssues(lastWeek);
+        if (firstCount > 10 && lastCount < 3) {
+          return { unlocked: true, progress: 1, target: 1 };
+        }
+      }
+      return { unlocked: false, progress: 0, target: 1 };
+    },
+  },
+];
+
+function checkStreak(data, target) {
+  const dates = new Set(data.map(d => d.date));
+  const sorted = [...dates].sort();
+  if (sorted.length === 0) return { unlocked: false, progress: 0 };
+
+  let maxStreak = 1;
+  let streak = 1;
+  for (let i = 1; i < sorted.length; i++) {
+    const prev = new Date(sorted[i - 1]);
+    const curr = new Date(sorted[i]);
+    const diff = (curr - prev) / (1000 * 60 * 60 * 24);
+    streak = diff === 1 ? streak + 1 : 1;
+    maxStreak = Math.max(maxStreak, streak);
+  }
+
+  return { unlocked: maxStreak >= target, progress: maxStreak };
+}
+
+export function checkAchievements(reviewedData) {
+  const saved = readJSON(ACHIEVEMENTS_PATH) || {};
+
+  const results = ACHIEVEMENTS.map(ach => {
+    const { unlocked, progress, target } = ach.check(reviewedData);
+    const existing = saved[ach.id];
+
+    if (unlocked && !existing?.unlockedAt) {
+      saved[ach.id] = { unlockedAt: new Date().toISOString() };
+    }
+
+    return {
+      id: ach.id,
+      name: ach.name,
+      icon: ach.icon,
+      description: ach.description,
+      unlocked,
+      progress,
+      target,
+      unlockedAt: saved[ach.id]?.unlockedAt || null,
+    };
+  });
+
+  writeJSON(ACHIEVEMENTS_PATH, saved);
+  return results;
+}
+
+export function getAchievementDefinitions() {
+  return ACHIEVEMENTS.map(a => ({
+    id: a.id, name: a.name, icon: a.icon, description: a.description,
+  }));
+}

package/src/cli/commands/export.mjs

@@ -0,0 +1,71 @@
+import { join } from 'node:path';
+import { writeFileSync } from 'node:fs';
+import { REVIEWED_DIR } from '../../constants.mjs';
+import { readJSON, listFiles } from '../../utils.mjs';
+
+export default async function exportCmd(args) {
+  const formatIdx = args.indexOf('--format');
+  const format = formatIdx !== -1 && args[formatIdx + 1] ? args[formatIdx + 1] : 'json';
+  const outputIdx = args.indexOf('--output');
+  const outputFile = outputIdx !== -1 ? args[outputIdx + 1] : null;
+
+  const files = listFiles(REVIEWED_DIR, '.json');
+  if (files.length === 0) {
+    console.log('No reviewed data to export. Run "vibeglish review" first.');
+    return;
+  }
+
+  const allData = [];
+  for (const f of files) {
+    const data = readJSON(join(REVIEWED_DIR, f));
+    if (data) allData.push(data);
+  }
+
+  let output;
+  if (format === 'csv') {
+    output = toCSV(allData);
+  } else {
+    output = JSON.stringify(allData, null, 2);
+  }
+
+  if (outputFile) {
+    writeFileSync(outputFile, output);
+    console.log(`Exported ${allData.length} day(s) to ${outputFile}`);
+  } else {
+    process.stdout.write(output + '\n');
+  }
+}
+
+function toCSV(allData) {
+  const headers = ['date', 'id', 'time', 'project', 'original', 'corrected', 'score', 'is_clean', 'issue_types', 'issues_detail'];
+  const rows = [headers.join(',')];
+
+  for (const day of allData) {
+    for (const entry of day.entries || []) {
+      const issueTypes = (entry.issues || []).map(i => i.type).join(';');
+      const issuesDetail = (entry.issues || []).map(i => `${i.original}->${i.corrected}`).join(';');
+      rows.push([
+        day.date,
+        entry.id || '',
+        entry.ts || '',
+        entry.project || '',
+        csvEscape(entry.original || ''),
+        csvEscape(entry.corrected || ''),
+        entry.score ?? '',
+        entry.is_clean ?? '',
+        csvEscape(issueTypes),
+        csvEscape(issuesDetail),
+      ].join(','));
+    }
+  }
+
+  return rows.join('\n');
+}
+
+function csvEscape(str) {
+  if (!str) return '';
+  if (str.includes(',') || str.includes('"') || str.includes('\n')) {
+    return '"' + str.replace(/"/g, '""') + '"';
+  }
+  return str;
+}

package/src/cli/commands/hook-test.mjs

@@ -0,0 +1,60 @@
+import { execSync } from 'node:child_process';
+import { join } from 'node:path';
+import { readFileSync, existsSync } from 'node:fs';
+import { HOOKS_DIR, RAW_DIR } from '../../constants.mjs';
+import { formatDate } from '../../utils.mjs';
+
+export default async function hookTest() {
+  const captureScript = join(HOOKS_DIR, 'capture.sh');
+  if (!existsSync(captureScript)) {
+    console.error('capture.sh not found. Run "vibeglish init" first.');
+    process.exit(1);
+  }
+
+  const today = formatDate();
+  const targetFile = join(RAW_DIR, `${today}.jsonl`);
+
+  // Count existing lines
+  let beforeCount = 0;
+  try {
+    beforeCount = readFileSync(targetFile, 'utf-8').trim().split('\n').filter(Boolean).length;
+  } catch { /* file doesn't exist yet */ }
+
+  // Send test prompt
+  const testPayload = JSON.stringify({
+    session_id: 'vibeglish-test',
+    prompt: 'This is a test prompt to verify the hook is working correctly',
+    cwd: '/tmp/vibeglish-test-project',
+  });
+
+  try {
+    execSync(`echo '${testPayload.replace(/'/g, "'\\''")}' | bash "${captureScript}"`, {
+      timeout: 5000,
+      stdio: 'pipe',
+    });
+  } catch (err) {
+    console.error('Hook script failed:', err.message);
+    process.exit(1);
+  }
+
+  // Check if line was added
+  let afterCount = 0;
+  try {
+    afterCount = readFileSync(targetFile, 'utf-8').trim().split('\n').filter(Boolean).length;
+  } catch {
+    console.error(`Failed: ${targetFile} was not created`);
+    process.exit(1);
+  }
+
+  if (afterCount > beforeCount) {
+    console.log('Hook test PASSED!');
+    console.log(`  New entry written to: ${targetFile}`);
+    // Show the last line
+    const lines = readFileSync(targetFile, 'utf-8').trim().split('\n');
+    console.log(`  Entry: ${lines[lines.length - 1]}`);
+  } else {
+    console.error('Hook test FAILED: No new entry was written.');
+    console.error('  Check ~/.vibeglish/error.log for details.');
+    process.exit(1);
+  }
+}

package/src/cli/commands/init.mjs

@@ -0,0 +1,155 @@
+import { existsSync, readFileSync, writeFileSync, copyFileSync, chmodSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import {
+  VIBEGLISH_DIR, RAW_DIR, REVIEWED_DIR, HOOKS_DIR, DASHBOARD_DIR,
+  CONFIG_PATH, CLAUDE_SETTINGS_PATH, DEFAULT_CONFIG,
+} from '../../constants.mjs';
+import { ensureDir, readJSON, writeJSON } from '../../utils.mjs';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const SRC_ROOT = join(__dirname, '../..');
+
+const HOOK_COMMAND = `${HOOKS_DIR}/capture.sh`;
+
+export default async function init(args) {
+  const isUpgrade = args.includes('--upgrade');
+
+  console.log(isUpgrade ? 'Upgrading VibeGlish...' : 'Initializing VibeGlish...');
+
+  // 1. Create directory structure
+  for (const dir of [RAW_DIR, REVIEWED_DIR, HOOKS_DIR, DASHBOARD_DIR]) {
+    ensureDir(dir);
+  }
+  chmodSync(VIBEGLISH_DIR, 0o700);
+
+  // 2. Copy capture.sh
+  const captureSrc = join(SRC_ROOT, 'hooks/capture.sh');
+  const captureDst = join(HOOKS_DIR, 'capture.sh');
+  copyFileSync(captureSrc, captureDst);
+  chmodSync(captureDst, 0o755);
+  console.log('  [ok] capture.sh installed');
+
+  // 3. Copy dashboard
+  const dashSrc = join(SRC_ROOT, 'dashboard/index.html');
+  const dashDst = join(DASHBOARD_DIR, 'index.html');
+  if (existsSync(dashSrc)) {
+    copyFileSync(dashSrc, dashDst);
+    console.log('  [ok] Dashboard installed');
+  }
+
+  // 4. Write default config (don't overwrite existing unless upgrade)
+  if (!existsSync(CONFIG_PATH) || isUpgrade) {
+    const existing = readJSON(CONFIG_PATH) || {};
+    writeJSON(CONFIG_PATH, { ...DEFAULT_CONFIG, ...existing });
+    console.log('  [ok] config.json written');
+  } else {
+    console.log('  [--] config.json already exists, skipping');
+  }
+
+  // 5. Install Claude Code hook
+  installHook();
+
+  // 6. Check jq
+  try {
+    const { execSync } = await import('node:child_process');
+    execSync('which jq', { stdio: 'ignore' });
+  } catch {
+    console.log('\n  [!!] jq is not installed. capture.sh requires jq.');
+    console.log('       Install it: brew install jq (macOS) or apt install jq (Linux)');
+  }
+
+  console.log(`
+Done! VibeGlish is ready.
+
+  Next steps:
+  1. Restart Claude Code (or start a new session) for the hook to take effect
+  2. Start coding — your prompts will be captured automatically
+  3. Run "vibeglish review" to get AI corrections
+  4. Run "vibeglish serve" to open the Dashboard
+
+  Data stored in: ${VIBEGLISH_DIR}
+`);
+}
+
+function installHook() {
+  const claudeDir = dirname(CLAUDE_SETTINGS_PATH);
+  ensureDir(claudeDir);
+
+  const vibeglishHook = {
+    type: 'command',
+    command: HOOK_COMMAND,
+  };
+
+  const vibeglishEntry = {
+    matcher: '',
+    hooks: [vibeglishHook],
+  };
+
+  if (!existsSync(CLAUDE_SETTINGS_PATH)) {
+    // No settings file — create one
+    writeJSON(CLAUDE_SETTINGS_PATH, {
+      hooks: {
+        UserPromptSubmit: [vibeglishEntry],
+      },
+    });
+    console.log('  [ok] Claude Code hook installed (new settings.json)');
+    return;
+  }
+
+  const settings = readJSON(CLAUDE_SETTINGS_PATH);
+  if (!settings) {
+    console.log('  [!!] Could not parse ~/.claude/settings.json — please install hook manually');
+    printManualHook();
+    return;
+  }
+
+  if (!settings.hooks) {
+    settings.hooks = {};
+  }
+
+  if (!settings.hooks.UserPromptSubmit) {
+    settings.hooks.UserPromptSubmit = [vibeglishEntry];
+    writeJSON(CLAUDE_SETTINGS_PATH, settings);
+    console.log('  [ok] Claude Code hook installed');
+    return;
+  }
+
+  // Check if vibeglish hook already exists
+  const existing = settings.hooks.UserPromptSubmit;
+  const alreadyInstalled = existing.some(entry =>
+    entry.hooks?.some(h => h.command?.includes('vibeglish') || h.command?.includes('capture.sh'))
+  );
+
+  if (alreadyInstalled) {
+    console.log('  [--] Hook already installed, skipping');
+    return;
+  }
+
+  // UserPromptSubmit exists but no vibeglish hook — append
+  existing.push(vibeglishEntry);
+  writeJSON(CLAUDE_SETTINGS_PATH, settings);
+  console.log('  [ok] Claude Code hook appended to existing UserPromptSubmit');
+}
+
+function printManualHook() {
+  console.log(`
+  Add this to your ~/.claude/settings.json:
+
+  {
+    "hooks": {
+      "UserPromptSubmit": [
+        {
+          "matcher": "",
+          "hooks": [
+            {
+              "type": "command",
+              "command": "${HOOK_COMMAND}"
+            }
+          ]
+        }
+      ]
+    }
+  }
+`);
+}