@bolloon/bolloon-agent 0.1.35 → 0.1.37

package/src/bootstrap/bootstrap.ts

@@ -1,132 +0,0 @@
-/**
- * Bolloon Bootstrap — 启动入口
- *
- * web server 启动时 (或 CLI 模式) 调一次, 完成 3 件事:
- * 1. 跑类 B 自适应扫描 (暖缓存 + 写 evolution.jsonl 启动事件)
- * 2. 收集项目 Context (Bolloon.md / git / persona / judgments / skills)
- * 3. 挂每天 0:00 定时任务
- *
- * 失败静默: 任意步骤失败 console.warn, 不抛错 (主流程不被阻塞)
- */
-
-import { runAdaptiveScan, logEvolution } from '../pi-ecosystem-judgment/adaptive-scan.js';
-import { collectBolloonContext, type BolloonContext } from './context-collector.js';
-import type { AdaptiveScanResult } from '../pi-ecosystem-judgment/adaptive-scan.js';
-
-export interface BootstrapResult {
-  context: BolloonContext;
-  scanResult: AdaptiveScanResult;
-  durationMs: number;
-  // 失败的部分不影响主流程
-  errors: string[];
-}
-
-/**
- * 入口: web server / CLI 启动时调一次
- */
-export async function bootstrapBolloon(opts: { cwd?: string } = {}): Promise<BootstrapResult> {
-  const start = Date.now();
-  const errors: string[] = [];
-
-  // 1. 类 B 启动扫描
-  let scanResult: AdaptiveScanResult = {
-    scannedAt: new Date().toISOString(),
-    judgmentsTotal: 0,
-    usageEntriesScanned: 0,
-    suggestions: [],
-  };
-  try {
-    scanResult = await runAdaptiveScan();
-    await logEvolution({
-      ts: new Date().toISOString(),
-      action: 'accept',  // 用 accept 表示"系统记录" (跟 reject 区分)
-      suggestion: {
-        key: 'bootstrap-startup',
-        kind: 'unused',  // 占位
-        judgmentId: '__bootstrap__',
-        decision: 'Bolloon 启动扫描',
-        reason: `本次启动扫描了 ${scanResult.judgmentsTotal} 条原则, ${scanResult.usageEntriesScanned} 条使用记录, 生成 ${scanResult.suggestions.length} 条建议`,
-        action: 'review',
-        metrics: { usage7d: 0, usage30d: 0, daysSinceLastUse: 0, totalUsage: 0 },
-        scannedAt: scanResult.scannedAt,
-      },
-    });
-    console.log(`[bootstrap] 类 B 启动扫描完成: ${scanResult.suggestions.length} 条建议`);
-  } catch (err) {
-    errors.push(`scan: ${(err as Error).message}`);
-    console.warn('[bootstrap] 启动扫描失败 (非致命):', err);
-  }
-
-  // 2. 收集项目 Context
-  let context: BolloonContext = {
-    projectRoot: opts.cwd ?? process.cwd(),
-    projectName: 'unknown',
-    bolloonMd: null,
-    git: null,
-    persona: null,
-    judgmentsSummary: { total: 0, active: 0, superseded: 0, rejected: 0, topValues: [] },
-    skills: [],
-    env: { os: 'unknown', nodeVersion: 'unknown', llmProvider: 'unknown' },
-    pending: { goals: [], todos: [] },
-    collectedAt: new Date().toISOString(),
-  };
-  try {
-    context = await collectBolloonContext({ cwd: opts.cwd ?? process.cwd() });
-    console.log(`[bootstrap] context 收集完成: ${context.judgmentsSummary.total} judgments, ${context.skills.length} skills`);
-  } catch (err) {
-    errors.push(`context: ${(err as Error).message}`);
-    console.warn('[bootstrap] context 收集失败 (非致命):', err);
-  }
-
-  // 3. 挂定时任务 (每天 0:00 跑扫描, server 重启时丢失可接受)
-  try {
-    scheduleAdaptiveScanDaily();
-    console.log('[bootstrap] 定时任务已挂: 每天 0:00 跑类 B 扫描');
-  } catch (err) {
-    errors.push(`schedule: ${(err as Error).message}`);
-    console.warn('[bootstrap] 定时任务挂载失败 (非致命):', err);
-  }
-
-  const durationMs = Date.now() - start;
-  console.log(`[bootstrap] 完成 (${durationMs}ms, ${errors.length} 个错误)`);
-
-  return { context, scanResult, durationMs, errors };
-}
-
-// ============================================================
-// 定时任务: 每天 0:00 跑类 B 自适应扫描
-// ============================================================
-
-let scheduled = false;
-
-function scheduleAdaptiveScanDaily(): void {
-  if (scheduled) return;
-  scheduled = true;
-
-  const now = new Date();
-  const next = new Date(now);
-  next.setHours(24, 0, 0, 0);
-  const msUntilMidnight = next.getTime() - now.getTime();
-
-  // 第一次: 等到明天 0:00
-  setTimeout(() => {
-    runAdaptiveScan().then((result) => {
-      console.log(`[bootstrap] 定时扫描完成: ${result.suggestions.length} 条建议`);
-    }).catch((err) => {
-      console.warn('[bootstrap] 定时扫描失败:', err);
-    });
-    // 之后: 每 24h
-    setInterval(() => {
-      runAdaptiveScan().then((result) => {
-        console.log(`[bootstrap] 定时扫描完成: ${result.suggestions.length} 条建议`);
-      }).catch((err) => {
-        console.warn('[bootstrap] 定时扫描失败:', err);
-      });
-    }, 24 * 60 * 60 * 1000);
-  }, msUntilMidnight);
-}
-
-/** 测试辅助: 重置 scheduled 标志 */
-export function _resetScheduleForTest(): void {
-  scheduled = false;
-}

package/src/bootstrap/context-collector.ts

@@ -1,342 +0,0 @@
-/**
- * Bolloon Context Collector — 启动时一次扫描, 收集 5 类项目状态
- *
- * 设计原则:
- * - 每个收集器独立, 失败静默 (返回 null/[] 而非抛错)
- * - 整体 < 200ms (git log + 文件扫描)
- * - 结果可缓存 24h (跟类 B 自适应一致)
- *
- * 收集维度:
- * 1. 项目层: projectRoot, projectName, Bolloon.md 全文
- * 2. git 层: branch, last 5 commits, uncommitted changes count
- * 3. persona 层: ~/.bolloon/persona.json
- * 4. judgments 层: 摘要 (total / active / superseded / top values)
- * 5. skills 层: ~/.bolloon/skills/ + .bolloon/skills/
- * 6. 环境层: OS / node / llm provider
- * 7. pending 层: ~/.bolloon/goals/* + src/ 下的 TODO/FIXME
- */
-
-import * as fs from 'fs/promises';
-import * as os from 'os';
-import * as path from 'path';
-import { execFile } from 'child_process';
-import { promisify } from 'util';
-
-const execFileAsync = promisify(execFile);
-
-export interface BolloonContext {
-  // 1. 项目层
-  projectRoot: string;
-  projectName: string;
-  bolloonMd: string | null;
-  // 2. git 层
-  git: {
-    branch: string;
-    lastCommits: string[];
-    uncommittedChanges: number;
-  } | null;
-  // 3. persona
-  persona: { name: string; description: string; personality: string } | null;
-  // 4. judgments 摘要
-  judgmentsSummary: {
-    total: number;
-    active: number;
-    superseded: number;
-    rejected: number;
-    topValues: Array<{ category: string; value: string; weight: number }>;
-  };
-  // 5. skills
-  skills: Array<{ name: string; description: string }>;
-  // 6. 环境
-  env: { os: string; nodeVersion: string; llmProvider: string };
-  // 7. pending
-  pending: {
-    goals: string[];
-    todos: Array<{ file: string; line: number; text: string }>;
-  };
-  // 采集时间
-  collectedAt: string;
-}
-
-export interface CollectOptions {
-  cwd: string;
-  /** Bolloon.md 全文最大字符数 (默认 2000) */
-  bolloonMdMaxBytes?: number;
-  /** git log 几条 (默认 5) */
-  gitCommitLimit?: number;
-  /** judgments Top N values (默认 10) */
-  topValuesLimit?: number;
-  /** 扫 TODO/FIXME 的根目录, 默认 cwd/src */
-  todoScanDir?: string;
-}
-
-// ============================================================
-// 单个收集器: 全部独立, 失败静默
-// ============================================================
-
-async function safeReadFile(filePath: string, maxBytes: number): Promise<string | null> {
-  try {
-    const content = await fs.readFile(filePath, 'utf-8');
-    if (content.length > maxBytes) {
-      return content.substring(0, maxBytes) + '\n... (truncated)';
-    }
-    return content;
-  } catch {
-    return null;
-  }
-}
-
-async function safeExecFile(cmd: string, args: string[], cwd: string): Promise<string> {
-  try {
-    const { stdout } = await execFileAsync(cmd, args, { cwd, timeout: 5000 });
-    return stdout.trim();
-  } catch {
-    return '';
-  }
-}
-
-async function collectProject(cwd: string, bolloonMdMaxBytes: number) {
-  let projectName = path.basename(cwd);
-  try {
-    const pkgRaw = await fs.readFile(path.join(cwd, 'package.json'), 'utf-8');
-    const pkg = JSON.parse(pkgRaw);
-    if (typeof pkg.name === 'string') projectName = pkg.name;
-  } catch { /* ignore */ }
-  const bolloonMd = await safeReadFile(path.join(cwd, 'Bolloon.md'), bolloonMdMaxBytes);
-  return { projectName, bolloonMd };
-}
-
-async function collectGit(cwd: string, limit: number): Promise<BolloonContext['git']> {
-  const branchOut = await safeExecFile('git', ['rev-parse', '--abbrev-ref', 'HEAD'], cwd);
-  if (!branchOut) return null;
-  const logOut = await safeExecFile('git', ['log', '--oneline', `-n`, String(limit)], cwd);
-  const statusOut = await safeExecFile('git', ['status', '--porcelain'], cwd);
-  return {
-    branch: branchOut,
-    lastCommits: logOut ? logOut.split('\n').filter(Boolean) : [],
-    uncommittedChanges: statusOut ? statusOut.split('\n').filter(Boolean).length : 0,
-  };
-}
-
-async function collectPersona(): Promise<BolloonContext['persona']> {
-  const home = process.env.HOME || os.homedir() || '/tmp';
-  const raw = await safeReadFile(path.join(home, '.bolloon', 'persona.json'), 5000);
-  if (!raw) return null;
-  try {
-    const p = JSON.parse(raw);
-    return {
-      name: String(p.name || 'unknown'),
-      description: String(p.description || ''),
-      personality: String(p.personality || ''),
-    };
-  } catch {
-    return null;
-  }
-}
-
-async function collectJudgmentsSummary(topN: number): Promise<BolloonContext['judgmentsSummary']> {
-  // 用动态 import 避免循环依赖
-  const { loadAllJudgments } = await import('../pi-ecosystem-judgment/human-value-store.js');
-  let all: Awaited<ReturnType<typeof loadAllJudgments>> = [];
-  try {
-    all = await loadAllJudgments();
-  } catch {
-    return { total: 0, active: 0, superseded: 0, rejected: 0, topValues: [] };
-  }
-  const byStatus = { active: 0, superseded: 0, rejected: 0 };
-  for (const j of all) {
-    const s = (j.status ?? 'active') as 'active' | 'superseded' | 'rejected';
-    if (s in byStatus) byStatus[s]++;
-  }
-  // 借用 getRelevantValues 算 top values (已经在 store 里)
-  let topValues: BolloonContext['judgmentsSummary']['topValues'] = [];
-  try {
-    const { getRelevantValues } = await import('../pi-ecosystem-judgment/human-value-store.js');
-    const values = await getRelevantValues('安全 代码 质量 测试 文档 用户');  // 通用 query
-    topValues = values.slice(0, topN).map((v) => ({
-      category: v.category,
-      value: v.value,
-      weight: v.weight,
-    }));
-  } catch { /* ignore */ }
-  return {
-    total: all.length,
-    active: byStatus.active,
-    superseded: byStatus.superseded,
-    rejected: byStatus.rejected,
-    topValues,
-  };
-}
-
-async function collectSkills(): Promise<BolloonContext['skills']> {
-  const home = process.env.HOME || os.homedir() || '/tmp';
-  const userSkillsDir = path.join(home, '.bolloon', 'skills');
-  const projectSkillsDir = path.join(process.cwd(), '.bolloon', 'skills');
-  const out: BolloonContext['skills'] = [];
-  const seen = new Set<string>();
-  for (const dir of [userSkillsDir, projectSkillsDir]) {
-    try {
-      const entries = await fs.readdir(dir, { withFileTypes: true });
-      for (const e of entries) {
-        if (!e.isDirectory() || seen.has(e.name)) continue;
-        seen.add(e.name);
-        // 尝试读 SKILL.md 第一行作为描述
-        let description = '';
-        try {
-          const skillMd = await fs.readFile(path.join(dir, e.name, 'SKILL.md'), 'utf-8');
-          // 抓第一段非空非 frontmatter
-          const lines = skillMd.split('\n');
-          let inFrontmatter = false;
-          for (const line of lines) {
-            if (line.trim() === '---') { inFrontmatter = !inFrontmatter; continue; }
-            if (inFrontmatter) continue;
-            if (line.trim() && !line.startsWith('#')) {
-              description = line.trim().substring(0, 120);
-              break;
-            }
-          }
-        } catch { /* ignore */ }
-        out.push({ name: e.name, description });
-      }
-    } catch { /* dir 不存在正常 */ }
-  }
-  return out;
-}
-
-function collectEnv(): BolloonContext['env'] {
-  let llmProvider = 'unknown';
-  try {
-    const home = process.env.HOME || os.homedir() || '/tmp';
-    const cfg = require(path.join(home, '.bolloon', 'llm-config.json'));
-    if (cfg && typeof cfg === 'object' && 'provider' in cfg) {
-      llmProvider = String(cfg.provider);
-    }
-  } catch { /* ignore */ }
-  return {
-    os: `${os.platform()} ${os.release()}`,
-    nodeVersion: process.version,
-    llmProvider,
-  };
-}
-
-async function collectPending(opts: CollectOptions): Promise<BolloonContext['pending']> {
-  const home = process.env.HOME || os.homedir() || '/tmp';
-  const goalsDir = path.join(home, '.bolloon', 'goals');
-  const goals: string[] = [];
-  try {
-    const entries = await fs.readdir(goalsDir, { withFileTypes: true });
-    for (const e of entries) {
-      if (e.isFile()) goals.push(e.name);
-    }
-  } catch { /* dir 不存在 */ }
-
-  // 扫 TODO/FIXME (限制 20 条避免太长)
-  const todoScanDir = opts.todoScanDir ?? path.join(opts.cwd, 'src');
-  const todos = await scanTodos(todoScanDir, 20);
-
-  return { goals, todos };
-}
-
-async function scanTodos(dir: string, limit: number): Promise<BolloonContext['pending']['todos']> {
-  const out: BolloonContext['pending']['todos'] = [];
-  try {
-    await walkDir(dir, async (filePath) => {
-      if (!/\.(ts|js|tsx|jsx)$/.test(filePath)) return;
-      // 跳过 dist / node_modules
-      if (filePath.includes('/node_modules/') || filePath.includes('/dist/')) return;
-      try {
-        const content = await fs.readFile(filePath, 'utf-8');
-        const lines = content.split('\n');
-        for (let i = 0; i < lines.length; i++) {
-          const line = lines[i];
-          // 匹配 TODO / FIXME / XXX 注释
-          const m = line.match(/(?:\/\/|\/\*|\*|<!--)\s*(TODO|FIXME|XXX|HACK)[:：]?\s*(.+)/);
-          if (m) {
-            out.push({
-              file: path.relative(dir, filePath),
-              line: i + 1,
-              text: m[2].trim().substring(0, 80),
-            });
-            if (out.length >= limit) return;
-          }
-        }
-      } catch { /* ignore */ }
-    });
-  } catch { /* dir 不存在 */ }
-  return out;
-}
-
-async function walkDir(dir: string, cb: (file: string) => Promise<void>): Promise<void> {
-  let entries: import('fs').Dirent[];
-  try {
-    entries = await fs.readdir(dir, { withFileTypes: true });
-  } catch {
-    return;
-  }
-  for (const e of entries) {
-    const full = path.join(dir, e.name);
-    if (e.isDirectory()) {
-      if (e.name === 'node_modules' || e.name === 'dist' || e.name.startsWith('.')) continue;
-      await walkDir(full, cb);
-    } else if (e.isFile()) {
-      await cb(full);
-    }
-  }
-}
-
-// ============================================================
-// 主入口
-// ============================================================
-
-export async function collectBolloonContext(opts: CollectOptions): Promise<BolloonContext> {
-  const {
-    cwd,
-    bolloonMdMaxBytes = 2000,
-    gitCommitLimit = 5,
-    topValuesLimit = 10,
-  } = opts;
-  // 并行收集 (除 judgments 因为要动态 import + 依赖其它)
-  const [project, git, persona, skills, env, pending] = await Promise.all([
-    collectProject(cwd, bolloonMdMaxBytes),
-    collectGit(cwd, gitCommitLimit),
-    collectPersona(),
-    collectSkills(),
-    Promise.resolve(collectEnv()),
-    collectPending(opts),
-  ]);
-  // judgments 单独调 (内部 import)
-  const judgmentsSummary = await collectJudgmentsSummary(topValuesLimit);
-
-  return {
-    projectRoot: cwd,
-    projectName: project.projectName,
-    bolloonMd: project.bolloonMd,
-    git,
-    persona,
-    judgmentsSummary,
-    skills,
-    env,
-    pending,
-    collectedAt: new Date().toISOString(),
-  };
-}
-
-// ============================================================
-// 24h 缓存 (跟类 B 一致)
-// ============================================================
-
-let cached: { at: number; ctx: BolloonContext; cwd: string } | null = null;
-const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
-
-export async function getCachedBolloonContext(opts: CollectOptions, force: boolean = false): Promise<BolloonContext> {
-  if (!force && cached && cached.cwd === opts.cwd && Date.now() - cached.at < CACHE_TTL_MS) {
-    return cached.ctx;
-  }
-  const ctx = await collectBolloonContext(opts);
-  cached = { at: Date.now(), ctx, cwd: opts.cwd };
-  return ctx;
-}
-
-export function clearBolloonContextCache(): void {
-  cached = null;
-}

package/src/bootstrap/lifecycle-hooks.ts

@@ -1,176 +0,0 @@
-/**
- * Lifecycle Hooks — SessionStart / Stop / PreToolUse
- *
- * 失败静默: 任意 hook 挂掉不抛错, 仅 console.warn.
- * 任何调用方都可以放心 await, 不会阻塞主对话.
- */
-
-import * as fs from 'fs/promises';
-import * as os from 'os';
-import * as path from 'path';
-import { getCachedBolloonContext, clearBolloonContextCache } from './context-collector.js';
-import { formatContextForSystemPrompt } from './project-context.js';
-
-// ============================================================
-// SessionStart
-// ============================================================
-
-export interface SessionStartOptions {
-  /** channelId 暂时不传到 context (单 channel 维度, plan 范围) */
-  channelId?: string;
-  /** 工作目录, 默认 process.cwd() */
-  cwd?: string;
-  /** 强制重扫, 跳过 24h 缓存 */
-  force?: boolean;
-  /** system prompt 片段字符上限 */
-  maxChars?: number;
-}
-
-export interface SessionStartResult {
-  /** 拼到 system prompt 头部的 markdown 文本 */
-  systemAddition: string;
-  /** 收集耗时 ms */
-  collectMs: number;
-  /** 是否被截断 */
-  truncated: boolean;
-}
-
-let lastSessionStartAt = 0;
-const MIN_INTERVAL_MS = 5000; // 同一进程 5s 内最多触发一次, 防止循环
-
-export async function onSessionStart(opts: SessionStartOptions = {}): Promise<SessionStartResult> {
-  const start = Date.now();
-  if (start - lastSessionStartAt < MIN_INTERVAL_MS) {
-    // 限流: 返回空 (调用方已经有缓存, 不需要重算)
-    return { systemAddition: '', collectMs: 0, truncated: false };
-  }
-  lastSessionStartAt = start;
-
-  try {
-    const ctx = await getCachedBolloonContext(
-      { cwd: opts.cwd ?? process.cwd() },
-      opts.force ?? false
-    );
-    let systemAddition = formatContextForSystemPrompt(ctx, { maxChars: opts.maxChars });
-    // 在头部加 channel 标识 (供 LLM 知道当前对话归属)
-    if (opts.channelId) {
-      systemAddition = `# 当前 channel: ${opts.channelId}\n\n` + systemAddition;
-    }
-    return {
-      systemAddition,
-      collectMs: Date.now() - start,
-      truncated: systemAddition.length > 0 && systemAddition.includes('截断模式'),
-    };
-  } catch (err) {
-    console.warn('[lifecycle-hooks] onSessionStart failed (silent):', err);
-    return { systemAddition: '', collectMs: Date.now() - start, truncated: false };
-  }
-}
-
-export function clearSessionStartCache(): void {
-  lastSessionStartAt = 0;
-  clearBolloonContextCache();
-}
-
-// ============================================================
-// Stop
-// ============================================================
-
-export interface StopOptions {
-  channelId: string;
-  messages?: number;
-  durationMs: number;
-  /** 注入门使用过的 judgment ids (供审计) */
-  usedJudgmentIds?: string[];
-}
-
-export interface StopResult {
-  persisted: boolean;
-  path: string | null;
-}
-
-const STOP_LOG = (os.homedir() || process.env.HOME || '/tmp') + '/.bolloon/sessions';
-
-/**
- * 把本次 session 摘要写 ~/.bolloon/sessions/<channelId>/last-stop.json
- * 不重复写完整 session 持久化 (已由 createWebServer 内的 saveSession 处理)
- */
-export async function onStop(opts: StopOptions): Promise<StopResult> {
-  try {
-    const dir = path.join(STOP_LOG, sanitizeChannelId(opts.channelId));
-    await fs.mkdir(dir, { recursive: true });
-    const file = path.join(dir, 'last-stop.json');
-    const entry = {
-      ts: new Date().toISOString(),
-      channelId: opts.channelId,
-      messages: opts.messages ?? 0,
-      durationMs: opts.durationMs,
-      usedJudgmentIds: opts.usedJudgmentIds ?? [],
-    };
-    await fs.writeFile(file, JSON.stringify(entry, null, 2), 'utf-8');
-    return { persisted: true, path: file };
-  } catch (err) {
-    console.warn('[lifecycle-hooks] onStop failed (silent):', err);
-    return { persisted: false, path: null };
-  }
-}
-
-function sanitizeChannelId(id: string): string {
-  // 防止路径穿越
-  return id.replace(/[^a-zA-Z0-9_-]/g, '_').slice(0, 64);
-}
-
-// ============================================================
-// PreToolUse (接口预留, 当前仅实现白名单 + 危险命令拦截)
-// ============================================================
-
-export interface PreToolUseOptions {
-  tool: string;
-  args: Record<string, unknown>;
-}
-
-export interface PreToolUseResult {
-  allowed: boolean;
-  reason?: string;
-}
-
-// 黑名单: 高危 shell 命令模式
-const DANGEROUS_PATTERNS: Array<{ re: RegExp; reason: string }> = [
-  { re: /\brm\s+(-[a-z]*f[a-z]*\s+)?-[a-z]*r[a-z]*\s+\//, reason: '禁止递归删除根目录' },
-  { re: /\bgit\s+push\s+.*--force\b/, reason: '禁止 force push' },
-  { re: /\brm\s+-rf\s+~\//, reason: '禁止递归删除 home' },
-  { re: /\bdd\s+if=.*\s+of=\/dev\//, reason: '禁止 dd 覆盖块设备' },
-  { re: /\bcurl\s+.*\|\s*(ba)?sh\b/, reason: '禁止 curl|sh 直执行' },
-  { re: />\s*\/dev\/sd[a-z]/, reason: '禁止写裸设备' },
-];
-
-/**
- * PreToolUse: 当前实现"危险命令拦截" (黑名单)
- * 白名单机制未启用 (默认放行所有非黑名单)
- * PreToolUse hook 接入 pi-sdk.ts 的 ReAct 循环是下个迭代
- */
-export async function onPreToolUse(opts: PreToolUseOptions): Promise<PreToolUseResult> {
-  try {
-    // 仅检查 shell 类工具的命令字符串
-    if (opts.tool === 'shell' || opts.tool === 'shell_exec' || opts.tool === 'bash') {
-      const cmd = String(opts.args.command || opts.args.cmd || '');
-      for (const { re, reason } of DANGEROUS_PATTERNS) {
-        if (re.test(cmd)) {
-          return { allowed: false, reason };
-        }
-      }
-    }
-    return { allowed: true };
-  } catch (err) {
-    console.warn('[lifecycle-hooks] onPreToolUse failed (silent):', err);
-    return { allowed: true };  // 失败放行 (不阻塞)
-  }
-}
-
-// ============================================================
-// 测试辅助: 获取 STOP_LOG 路径 (供测试覆盖路径)
-// ============================================================
-
-export function getStopLogPathForTest(): string {
-  return STOP_LOG;
-}