@bolloon/bolloon-agent 0.1.36 → 0.1.37

package/scripts/postinstall.js

@@ -1,153 +0,0 @@
-/**
- * Postinstall 脚本
- * npm 安装后自动执行
- *
- * 主要任务：
- * 1. 确保 bin 目录存在且可执行
- * 2. 初始化本地配置
- * 3. 检查依赖完整性
- */
-
-import * as fs from 'fs';
-import * as path from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const rootDir = path.join(__dirname, '..');
-
-const RESET = '\x1b[0m';
-const GREEN = '\x1b[32m';
-const YELLOW = '\x1b[33m';
-const CYAN = '\x1b[36m';
-
-function log(msg, color = RESET) {
-  console.log(color + msg + RESET);
-}
-
-function initUserDirs() {
-  // 创建用户数据目录
-  const home = process.env.HOME || process.env.USERPROFILE || '/tmp';
-  const bolloonDir = path.join(home, '.bolloon');
-
-  const dirs = [
-    bolloonDir,
-    path.join(bolloonDir, 'sessions'),
-    path.join(bolloonDir, 'peer-store'),
-  ];
-
-  for (const dir of dirs) {
-    if (!fs.existsSync(dir)) {
-      fs.mkdirSync(dir, { recursive: true });
-      log(`  ✓ 创建目录: ${dir}`, GREEN);
-    }
-  }
-
-  // 初始化配置文件
-  const configPath = path.join(bolloonDir, 'config.json');
-  if (!fs.existsSync(configPath)) {
-    const defaultConfig = {
-      version: '0.1.12',
-      initializedAt: new Date().toISOString(),
-      defaults: {
-        port: 54188,
-        theme: 'dark',
-        autoConnect: true,
-      },
-      providers: {
-        minimax: { enabled: false },
-        openai: { enabled: false },
-        anthropic: { enabled: false },
-      }
-    };
-    fs.writeFileSync(configPath, JSON.stringify(defaultConfig, null, 2));
-    log(`  ✓ 创建配置: ${configPath}`, GREEN);
-  }
-
-  return bolloonDir;
-}
-
-function checkNativeDeps() {
-  // 检查必要的原生依赖
-  const nativeDeps = [
-    'libp2p',
-    '@diap/sdk',
-  ];
-
-  let allOk = true;
-
-  for (const dep of nativeDeps) {
-    const depPath = path.join(rootDir, 'node_modules', dep);
-    if (!fs.existsSync(depPath)) {
-      log(`  ⚠ 缺少依赖: ${dep}`, YELLOW);
-      allOk = false;
-    }
-  }
-
-  return allOk;
-}
-
-function setupPlatform() {
-  const platform = process.platform;
-
-  log(`\n  平台: ${platform}`, CYAN);
-
-  if (platform === 'win32') {
-    // Windows: 确保 .cmd 文件存在
-    const binDir = path.join(rootDir, 'bin');
-    const cmdPath = path.join(binDir, 'bolloon.cmd');
-
-    if (fs.existsSync(binDir) && !fs.existsSync(cmdPath)) {
-      const cmdContent = `@echo off
-node "%~dp0..\\dist\\cli.js" %*
-`;
-      fs.writeFileSync(cmdPath, cmdContent);
-      log('  ✓ Windows 入口已创建', GREEN);
-    }
-  } else {
-    // Unix/Linux/Mac: 确保 bin 文件可执行
-    const binDir = path.join(rootDir, 'bin');
-    const binPath = path.join(binDir, 'bolloon.js');
-
-    if (fs.existsSync(binPath)) {
-      try {
-        fs.chmodSync(binPath, 0o755);
-        log('  ✓ bin/bolloon.js 已设为可执行', GREEN);
-      } catch (err) {
-        log(`  ⚠ 无法设置执行权限: ${err.message}`, YELLOW);
-      }
-    }
-  }
-}
-
-function main() {
-  console.log('\n📦 Bolloon 安装后处理...\n');
-
-  try {
-    // 1. 初始化用户目录
-    const bolloonDir = initUserDirs();
-    log(`  ✓ 用户数据目录: ${bolloonDir}`, GREEN);
-
-    // 2. 检查依赖
-    const depsOk = checkNativeDeps();
-    if (!depsOk) {
-      log('\n  ⚠ 部分依赖缺失，建议运行: npm install', YELLOW);
-    }
-
-    // 3. 平台特定设置
-    setupPlatform();
-
-    console.log('\n✅ 安装完成！\n');
-    console.log('  使用方式:');
-    console.log('    bolloon              # 启动 GUI');
-    console.log('    bolloon --web        # 启动 Web UI');
-    console.log('    bolloon --cli        # 命令行模式');
-    console.log('    bolloon --help       # 显示帮助\n');
-    console.log(`  配置文件: ${path.join(bolloonDir, 'config.json')}\n`);
-  } catch (err) {
-    console.error('\n❌ 安装后处理失败:', err.message);
-    console.error('  这通常不影响基本功能，继续安装...\n');
-  }
-}
-
-main();

package/scripts/validate-system-prompt.ts

@@ -1,142 +0,0 @@
-#!/usr/bin/env tsx
-/**
- * validate-system-prompt.ts — 护栏: system-prompt 改动验证
- *
- * 跑在 pre-commit + reviewer 后:
- *   1. 每个 layer .md 不超 maxChars
- *   2. version 字段 (HTML 注释 <!-- id@version -->) 存在
- *   3. hibsml 标签没漏 (如果出现 → 警告)
- *
- * 用法:
- *   tsx scripts/validate-system-prompt.ts
- *   tsx scripts/validate-system-prompt.ts --layer core/refusal.md
- */
-import * as fs from 'fs/promises';
-import * as path from 'path';
-
-const REPO = process.cwd();
-const LAYERS_DIR = path.join(REPO, 'src/llm/system-prompt/layers');
-
-// 跟 registry 保持一致 (手维护同步; 后续可让 registry 暴露)
-// P-Action 4 (2026-06-15): 跟 registry.ts STATIC_LAYERS maxChars 同步, 停用 layer 设 0
-const MAX_CHARS: Record<string, number> = {
-  'core/identity': 800,
-  'core/knowledge': 600,
-  'core/tools.thin': 400,
-  'core/hibs_reminders': 0,   // 停用 (was 800)
-  'core/refusal': 800,
-  'core/tone': 500,
-  'core/wellbeing': 600,
-  'core/evenhandedness': 300,
-  'core/memory_system': 200,
-  'core/artifacts_storage': 0, // 停用 (was 2500)
-  'core/network_filesystem': 0, // 停用 (was 900)
-  'role/expert': 500,
-  'role/architect': 0,         // 停用 (was 500)
-  'role/implementer': 0,       // 停用 (was 500)
-  'role/security': 0,          // 停用 (was 500)
-  'channel/local': 500,
-  'channel/p2p-visitor': 700,
-  'channel/p2p-agent': 700,
-  'tool/bash': 600,
-  'tool/web_search': 600,
-  'tool/mcp_apps': 0,          // 停用 (was 1800)
-  'tool/hibs_api': 0,          // 停用 (was 4500)
-  'tool/image_search': 0,      // 停用 (was 2500)
-  'tool/artifacts': 0,         // 停用 (was 2500)
-  'tool/manifest': 500,
-};
-
-type IssueType = 'oversize' | 'no-version' | 'leftover-hibsml';
-type IssueSeverity = 'error' | 'warning';
-
-interface Issue {
-  layer: string;
-  type: IssueType;
-  severity: IssueSeverity;
-  detail: string;
-}
-
-/**
- * P-Action 4 (2026-06-15): oversize 降级为 warning.
- * 原因: P-Action 4 收紧 registry maxChars 后, 多个历史 layer .md 实际长度超过新上限.
- *   这些 .md 是"原样"对齐 Claude.ai 完整版的, 内容不动 (用户约束: 不改 prompt).
- *   runtime 时 assembleSystemPrompt 会按 maxChars 截断, 行为已受控.
- *   因此 validate 阶段不再 fail build, 只 log warning.
- * 保留为 error 的: no-version (可追溯性), leftover-hibsml (安全).
- */
-const SEVERITY: Record<IssueType, IssueSeverity> = {
-  oversize: 'warning',
-  'no-version': 'error',
-  'leftover-hibsml': 'error',
-};
-
-async function check(file: string): Promise<Issue[]> {
-  const issues: Issue[] = [];
-  const rel = path.relative(LAYERS_DIR, file);
-  const max = MAX_CHARS[rel.replace(/\.md$/, '')];
-  const content = await fs.readFile(file, 'utf-8');
-  if (max && content.length > max) {
-    issues.push({ layer: rel, type: 'oversize', severity: SEVERITY.oversize, detail: `${content.length} > ${max}` });
-  }
-  if (!/<!--\s*[\w.-]+@[\d.]+\s*-->/.test(content)) {
-    issues.push({ layer: rel, type: 'no-version', severity: SEVERITY['no-version'], detail: '缺 <!-- id@version --> 标记' });
-  }
-  if (/\{hibsml:(?!thinking_mode)[\w_]+\}/.test(content) || /\{\/hibsml:/.test(content)) {
-    issues.push({ layer: rel, type: 'leftover-hibsml', severity: SEVERITY['leftover-hibsml'], detail: '检测到未脱除的 hibsml 标签' });
-  }
-  return issues;
-}
-
-async function walk(dir: string): Promise<string[]> {
-  const out: string[] = [];
-  const entries = await fs.readdir(dir, { withFileTypes: true });
-  for (const e of entries) {
-    const full = path.join(dir, e.name);
-    if (e.isDirectory()) out.push(...await walk(full));
-    else if (e.name.endsWith('.md')) out.push(full);
-  }
-  return out;
-}
-
-async function main() {
-  const args = process.argv.slice(2);
-  let files: string[];
-  if (args.includes('--layer')) {
-    const idx = args.indexOf('--layer');
-    const target = path.join(LAYERS_DIR, args[idx + 1]);
-    files = [target];
-  } else {
-    files = await walk(LAYERS_DIR);
-  }
-  const allIssues: Issue[] = [];
-  for (const f of files) {
-    const issues = await check(f);
-    allIssues.push(...issues);
-  }
-  if (allIssues.length === 0) {
-    console.log(`✅ ${files.length} 个 layer 全部通过 (字符上限, 版本标记, hibsml 脱除)`);
-    return;
-  }
-  const errors = allIssues.filter((i) => i.severity === 'error');
-  const warnings = allIssues.filter((i) => i.severity === 'warning');
-
-  if (warnings.length > 0) {
-    console.warn(`⚠️  ${warnings.length} 个 warning (P-Action 4 后 oversize 不再 fail build):`);
-    for (const i of warnings) {
-      console.warn(`  [${i.type}] ${i.layer}: ${i.detail}`);
-    }
-  }
-
-  if (errors.length === 0) {
-    console.log(`✅ ${files.length} 个 layer 通过 (${warnings.length} 个 warning, 0 个 error)`);
-    return;
-  }
-  console.error(`❌ ${errors.length} 个 error:`);
-  for (const i of errors) {
-    console.error(`  [${i.type}] ${i.layer}: ${i.detail}`);
-  }
-  process.exit(1);
-}
-
-main().catch((e) => { console.error(e); process.exit(1); });

package/scripts/weekly-report.ts

@@ -1,364 +0,0 @@
-#!/usr/bin/env tsx
-/**
- * weekly-report.ts — Bolloon 每周表现报告 (阶段 B)
- *
- * 输入:
- *   ~/.bolloon/human-values/evolution.jsonl      (接受/拒绝/回滚事件)
- *   ~/.bolloon/human-values/usage.jsonl          (judgment 使用记录)
- *   ~/.bolloon/human-values/counterfactual-audit.jsonl (反事实审计)
- *   ~/.bolloon/human-values/judgments.json       (当前 judgment 库)
- *   ~/.bolloon/self-improve-audit.log            (改源码尝试的审计, 即使被拒)
- *
- * 输出:
- *   ~/.bolloon/reports/2026-W24.md  (markdown 报告)
- *
- * 设计原则:
- *   - 纯本地计算 + 纯函数式分析 (不调 LLM, 避免幻觉)
- *   - 周范围默认 ISO 周(周一为起点), 可 --week 2026-W24 指定
- *   - 不写 judgments.json, 不动 persona, 仅追加 reports/*.md
- *   - 失败静默 + 退出码 != 0 让 cron 知道坏了
- *
- * 用法:
- *   tsx scripts/weekly-report.ts                # 生成上周
- *   tsx scripts/weekly-report.ts --week 2026-W24  # 指定周
- *   tsx scripts/weekly-report.ts --week 2026-W24 --dry-run
- */
-
-import * as fs from 'fs/promises';
-import * as os from 'os';
-import * as path from 'path';
-
-const HOME = () => os.homedir() || process.env.HOME || '/tmp';
-const ROOT = () => HOME() + '/.bolloon';
-const REPORTS_DIR = () => ROOT() + '/reports';
-
-const FILES = {
-  evolution: () => ROOT() + '/human-values/evolution.jsonl',
-  usage: () => ROOT() + '/human-values/usage.jsonl',
-  counterfactual: () => ROOT() + '/human-values/counterfactual-audit.jsonl',
-  judgments: () => ROOT() + '/human-values/judgments.json',
-  selfImproveAudit: () => ROOT() + '/self-improve-audit.log',
-};
-
-interface EvolutionEntry {
-  ts: string;
-  action: 'accept' | 'reject' | 'revert';
-  suggestion: { kind: string; judgmentId: string; action: string };
-  appliedPatch?: Record<string, unknown>;
-}
-interface UsageEntry {
-  ts: string;
-  channelId: string | null;
-  userInputPreview: string;
-  usedIds: string[];
-}
-interface CounterfactualEntry {
-  ts: string;
-  trigger: { userInput: string; aiReply: string; violatedPrinciples: unknown[] };
-  verdict: string;
-  recomendaciones?: string[];
-}
-
-async function readJsonl<T>(p: string): Promise<T[]> {
-  try {
-    const content = await fs.readFile(p, 'utf-8');
-    return content
-      .trim()
-      .split('\n')
-      .filter(Boolean)
-      .map((l) => {
-        try {
-          return JSON.parse(l) as T;
-        } catch {
-          return null;
-        }
-      })
-      .filter((e): e is T => Boolean(e));
-  } catch {
-    return [];
-  }
-}
-
-async function readJson<T>(p: string): Promise<T | null> {
-  try {
-    return JSON.parse(await fs.readFile(p, 'utf-8')) as T;
-  } catch {
-    return null;
-  }
-}
-
-function isoWeekString(d: Date): string {
-  // ISO week: 1 = 包含 1 月 4 日的那周
-  const target = new Date(d.valueOf());
-  const dayNr = (d.getUTCDay() + 6) % 7; // 周一=0
-  target.setUTCDate(target.getUTCDate() - dayNr + 3);
-  const firstThursday = new Date(Date.UTC(target.getUTCFullYear(), 0, 4));
-  const week =
-    1 +
-    Math.round(
-      ((target.valueOf() - firstThursday.valueOf()) / 86400000 - 3 + ((firstThursday.getUTCDay() + 6) % 7)) / 7
-    );
-  return `${target.getUTCFullYear()}-W${String(week).padStart(2, '0')}`;
-}
-
-function weekRange(iso: string): { start: Date; end: Date } {
-  const m = /^(\d{4})-W(\d{1,2})$/.exec(iso);
-  if (!m) throw new Error(`bad ISO week: ${iso}`);
-  const year = Number(m[1]);
-  const week = Number(m[2]);
-  // ISO 周 1 是包含 1 月 4 日的那周
-  const jan4 = new Date(Date.UTC(year, 0, 4));
-  const jan4Day = (jan4.getUTCDay() + 6) % 7; // 周一=0
-  const week1Mon = new Date(jan4);
-  week1Mon.setUTCDate(jan4.getUTCDate() - jan4Day);
-  const start = new Date(week1Mon);
-  start.setUTCDate(week1Mon.getUTCDate() + (week - 1) * 7);
-  const end = new Date(start);
-  end.setUTCDate(start.getUTCDate() + 7);
-  return { start, end };
-}
-
-function inWeek(ts: string, start: Date, end: Date): boolean {
-  const t = new Date(ts).getTime();
-  return t >= start.getTime() && t < end.getTime();
-}
-
-function pct(n: number, d: number): string {
-  if (d === 0) return 'n/a';
-  return `${((n / d) * 100).toFixed(1)}%`;
-}
-
-function topN<T>(arr: T[], key: (x: T) => string, n: number): Array<[string, number]> {
-  const m = new Map<string, number>();
-  for (const x of arr) {
-    const k = key(x);
-    m.set(k, (m.get(k) || 0) + 1);
-  }
-  return Array.from(m.entries())
-    .sort((a, b) => b[1] - a[1])
-    .slice(0, n);
-}
-
-interface Report {
-  week: string;
-  range: { start: string; end: string };
-  generatedAt: string;
-  summary: {
-    totalUsage: number;
-    uniqueChannels: number;
-    uniqueJudgments: number;
-    evolutionEvents: number;
-    acceptRate: number;
-    rejected: number;
-    reverted: number;
-    counterfactualScans: number;
-  };
-  topJudgments: Array<[string, number]>;
-  topKinds: Array<[string, number]>;
-  policyAudit: {
-    selfImproveAttempts: number;
-    blockedByPolicy: number;
-    note: string;
-  };
-  openQuestions: string[];
-}
-
-async function buildReport(weekIso: string): Promise<Report> {
-  const { start, end } = weekRange(weekIso);
-
-  const [evolution, usage, counterfactual, judgments, audit] = await Promise.all([
-    readJsonl<EvolutionEntry>(FILES.evolution()),
-    readJsonl<UsageEntry>(FILES.usage()),
-    readJsonl<CounterfactualEntry>(FILES.counterfactual()),
-    readJson<unknown[]>(FILES.judgments()),
-    (async () => {
-      try {
-        const txt = await fs.readFile(FILES.selfImproveAudit(), 'utf-8');
-        return txt.split('\n').filter(Boolean);
-      } catch {
-        return [];
-      }
-    })(),
-  ]);
-
-  const evoInWeek = evolution.filter((e) => inWeek(e.ts, start, end));
-  const useInWeek = usage.filter((u) => inWeek(u.ts, start, end));
-  const cfInWeek = counterfactual.filter((c) => inWeek(c.ts, start, end));
-  const auditInWeek = audit.filter((line) => {
-    // audit 是日志行, 格式不一定, 简单按日期前缀过滤
-    const d = line.match(/^(\d{4}-\d{2}-\d{2})/);
-    if (!d) return false;
-    const ts = new Date(d[1] + 'T00:00:00Z').getTime();
-    return ts >= start.getTime() && ts < end.getTime();
-  });
-
-  const totalUsage = useInWeek.length;
-  const channels = new Set(useInWeek.map((u) => u.channelId || 'null'));
-  const ids = new Set<string>();
-  for (const u of useInWeek) for (const id of u.usedIds) ids.add(id);
-
-  const accepts = evoInWeek.filter((e) => e.action === 'accept').length;
-  const rejects = evoInWeek.filter((e) => e.action === 'reject').length;
-  const reverts = evoInWeek.filter((e) => e.action === 'revert').length;
-  const acceptRate = accepts + rejects === 0 ? 0 : accepts / (accepts + rejects);
-
-  // 自改审计 (路径白/黑名单拦截)
-  const selfImproveAttempts = auditInWeek.filter((l) => /attempt|尝试/i.test(l)).length;
-  const blockedByPolicy = auditInWeek.filter((l) => /block|deny|拒绝|denylist/i.test(l)).length;
-
-  return {
-    week: weekIso,
-    range: { start: start.toISOString().slice(0, 10), end: end.toISOString().slice(0, 10) },
-    generatedAt: new Date().toISOString(),
-    summary: {
-      totalUsage,
-      uniqueChannels: channels.size,
-      uniqueJudgments: ids.size,
-      evolutionEvents: evoInWeek.length,
-      acceptRate,
-      rejected: rejects,
-      reverted: reverts,
-      counterfactualScans: cfInWeek.length,
-    },
-    topJudgments: topN(useInWeek.flatMap((u) => u.usedIds.map((id) => ({ id }))), (x) => x.id, 10),
-    topKinds: topN(evoInWeek, (e) => e.suggestion.kind, 5),
-    policyAudit: {
-      selfImproveAttempts,
-      blockedByPolicy,
-      note: selfImproveAttempts === 0 ? '本周无源码自改尝试(护栏未触发)' : '见 self-improve-audit.log',
-    },
-    openQuestions: openQuestions(evoInWeek, cfInWeek, useInWeek),
-  };
-}
-
-function openQuestions(evo: EvolutionEntry[], cf: CounterfactualEntry[], use: UsageEntry[]): string[] {
-  const out: string[] = [];
-  if (evo.length === 0 && use.length > 0) {
-    out.push('本周有使用但无自适应建议 → 可能 judgment 库太稳定, 或扫描器未触发');
-  }
-  if (use.length === 0) {
-    out.push('本周无 judgment 使用记录 → 检查 usage.jsonl 是否在写, 或渠道是否活跃');
-  }
-  if (cf.length > 0) {
-    const conflictCount = cf.filter((c) => /冲突|conflict|不合理/i.test(c.verdict)).length;
-    if (conflictCount > 0) {
-      out.push(`反事实审计发现 ${conflictCount} 条潜在冲突 → 看 counterfactual-audit.jsonl`);
-    }
-  }
-  const reverts = evo.filter((e) => e.action === 'revert').length;
-  if (reverts >= 2) {
-    out.push(`本周回滚 ${reverts} 次 → 类 B 建议可能过激, 考虑收紧阈值`);
-  }
-  return out;
-}
-
-function toMarkdown(r: Report, totalJudgments: number): string {
-  const lines: string[] = [];
-  lines.push(`# 📊 Bolloon 周报 — ${r.week}`);
-  lines.push('');
-  lines.push(`> 范围: ${r.range.start} → ${r.range.end} · 生成于 ${r.generatedAt}`);
-  lines.push('');
-  lines.push('## 核心数字');
-  lines.push('');
-  lines.push('| 指标 | 本周 |');
-  lines.push('|------|------|');
-  lines.push(`| judgment 调用次数 | ${r.summary.totalUsage} |`);
-  lines.push(`| 触达渠道数 | ${r.summary.uniqueChannels} |`);
-  lines.push(`| 用到的不同 judgment 数 | ${r.summary.uniqueJudgments} |`);
-  lines.push(`| 自适应事件数 | ${r.summary.evolutionEvents} |`);
-  lines.push(`| 接受率 | ${pct(r.summary.acceptRate * 100, 100)} (${Math.round(r.summary.acceptRate * 100)}%) |`);
-  lines.push(`| 拒绝数 | ${r.summary.rejected} |`);
-  lines.push(`| 回滚数 | ${r.summary.reverted} |`);
-  lines.push(`| 反事实审计次数 | ${r.summary.counterfactualScans} |`);
-  lines.push(`| 当前 judgment 库总条数 | ${totalJudgments} |`);
-  lines.push('');
-  lines.push('## 最常被引用的 judgment');
-  lines.push('');
-  if (r.topJudgments.length === 0) {
-    lines.push('_(本周无引用)_');
-  } else {
-    for (const [id, n] of r.topJudgments) {
-      lines.push(`- \`${id}\` × ${n}`);
-    }
-  }
-  lines.push('');
-  lines.push('## 自适应建议类型分布');
-  lines.push('');
-  if (r.topKinds.length === 0) {
-    lines.push('_(本周无自适应事件)_');
-  } else {
-    for (const [kind, n] of r.topKinds) {
-      lines.push(`- **${kind}** × ${n}`);
-    }
-  }
-  lines.push('');
-  lines.push('## 护栏审计');
-  lines.push('');
-  lines.push(`- 源码自改尝试: **${r.policyAudit.selfImproveAttempts}**`);
-  lines.push(`- 被策略拦截: **${r.policyAudit.blockedByPolicy}**`);
-  lines.push(`- ${r.policyAudit.note}`);
-  lines.push('');
-  lines.push('## 关注事项');
-  lines.push('');
-  if (r.openQuestions.length === 0) {
-    lines.push('_(本周一切正常, 无特别关注)_');
-  } else {
-    for (const q of r.openQuestions) {
-      lines.push(`- ${q}`);
-    }
-  }
-  lines.push('');
-  lines.push('---');
-  lines.push('');
-  lines.push('> 本报告由 `scripts/weekly-report.ts` 纯本地生成, 不调 LLM. 数据源见 ~/.bolloon/human-values/');
-  lines.push('');
-  return lines.join('\n');
-}
-
-function parseArgs(argv: string[]): { week?: string; dryRun: boolean } {
-  const out: { week?: string; dryRun: boolean } = { dryRun: false };
-  for (let i = 0; i < argv.length; i++) {
-    if (argv[i] === '--week' && argv[i + 1]) {
-      out.week = argv[++i];
-    } else if (argv[i] === '--dry-run') {
-      out.dryRun = true;
-    }
-  }
-  return out;
-}
-
-async function main() {
-  const args = parseArgs(process.argv.slice(2));
-  // 默认: 上周(更合理 — 周末才回顾)
-  const now = new Date();
-  const lastWeek = new Date(now);
-  lastWeek.setUTCDate(now.getUTCDate() - 7);
-  const week = args.week || isoWeekString(lastWeek);
-  const { start, end } = weekRange(week);
-
-  console.log(`[weekly-report] 生成 ${week} (${start.toISOString().slice(0, 10)} → ${end.toISOString().slice(0, 10)})`);
-
-  const r = await buildReport(week);
-  const judgments = (await readJson<unknown[]>(FILES.judgments())) || [];
-  const md = toMarkdown(r, judgments.length);
-
-  const outDir = REPORTS_DIR();
-  const outPath = path.join(outDir, `${week}.md`);
-
-  if (args.dryRun) {
-    console.log(`[weekly-report] DRY-RUN, 不会写盘. 输出预览:`);
-    console.log('---');
-    console.log(md);
-    console.log('---');
-    return;
-  }
-
-  await fs.mkdir(outDir, { recursive: true });
-  await fs.writeFile(outPath, md, 'utf-8');
-  console.log(`[weekly-report] ✅ 写入 ${outPath} (${md.length} bytes)`);
-}
-
-main().catch((err) => {
-  console.error('[weekly-report] ❌ 失败:', err);
-  process.exit(1);
-});