@winspan/claude-forge 8.53.2 → 8.54.3

package/src/web/routes/rules.ts

@@ -1,76 +0,0 @@
-/**
- * /api/rules/hit-rate — Rule hit-rate statistics
- *
- * Aggregates routing_events and skill_invocations to show:
- *   - Agent delegation rate
- *   - Skill invocation rate
- *   - Per-skill breakdown
- *   - Per-agent breakdown
- *   - Never-triggered skills
- *
- * H1 refactor: pushed GROUP BY into SQL via storage.aggregateRoutingStats /
- * aggregateSkillInvocationsBySkill — no more 100k-row JS scans.
- */
-
-import type { Application } from 'express';
-import type { RouteContext } from './types.js';
-
-function pct(num: number, denom: number): string {
-  if (denom <= 0) return '0%';
-  return `${(num / denom * 100).toFixed(1)}%`;
-}
-
-export function registerRulesRoutes(app: Application, ctx: RouteContext): void {
-  const { storage, skillRegistry } = ctx;
-
-  app.get('/api/rules/hit-rate', (req, res) => {
-    const days = Math.max(1, parseInt((req.query.days as string) || '7'));
-    const since = Date.now() - days * 24 * 3600 * 1000;
-    const sinceISO = new Date(since).toISOString();
-
-    // SQL-side aggregates (replaces 2 × 100k-row scans + JS reduce)
-    const routing = storage.aggregateRoutingStats({ since_ts: since });
-    const skillsAgg = storage.aggregateSkillInvocationsBySkill({ since });
-
-    const totalPrompts = routing.total;
-    const agentDelegations = routing.obeyed;
-
-    // Skills frequency (sorted by total desc — SQL ORDER BY total DESC)
-    const skillTotal = skillsAgg.reduce((acc, s) => acc + s.total, 0);
-    const skills = skillsAgg.map(s => ({
-      skill_id: s.skill_id,
-      total: s.total,
-      success: s.success,
-      failed: s.failed,
-      rate: pct(s.total, totalPrompts),
-    }));
-
-    // Agents breakdown (already obeyed=1, sorted by count desc in SQL)
-    const agents = routing.by_agent.map(a => ({
-      agent: a.agent,
-      count: a.count,
-      rate: pct(a.count, totalPrompts),
-    }));
-
-    // Never-triggered skills
-    const triggeredSkillIds = new Set(skillsAgg.map(s => s.skill_id));
-    const allSkillIds = skillRegistry
-      ? skillRegistry.getAll().map(s => s.id)
-      : [];
-    const neverTriggered = allSkillIds.filter(id => !triggeredSkillIds.has(id));
-
-    res.json({
-      period: { days, since: sinceISO },
-      summary: {
-        totalPrompts,
-        agentDelegations,
-        agentRate: pct(agentDelegations, totalPrompts),
-        skillInvocations: skillTotal,
-        skillRate: pct(skillTotal, totalPrompts),
-      },
-      skills,
-      agents,
-      neverTriggered,
-    });
-  });
-}

package/src/web/routes/sessions.ts

@@ -1,250 +0,0 @@
-import type { Application } from 'express';
-import type { RouteContext } from './types.js';
-import { truncateField } from './_helpers.js';
-import { getCommand, getFilePath, getUserPrompt } from '../../core/event-fields.js';
-
-/**
- * /api/sessions* — session lists, per-session detail, timeline.
- *
- * Also hosts /api/injections since they are session-adjacent views.
- */
-export function registerSessionsRoutes(app: Application, ctx: RouteContext): void {
-  const { storage } = ctx;
-
-  // Sessions: list with first prompt
-  app.get('/api/sessions', (req, res) => {
-    const limit = parseInt(req.query.limit as string) || 10;
-    const projectPath = req.query.project as string | undefined;
-    const sessions = storage.querySessions({ project_path: projectPath, limit });
-    res.json(sessions);
-  });
-
-  // Injections: query injection history
-  app.get('/api/injections', (req, res) => {
-    const limit = parseInt(req.query.limit as string) || 50;
-    const sessionId = req.query.session as string | undefined;
-    const eventId = req.query.event as string | undefined;
-    const handler = req.query.handler as string | undefined;
-    const injections = storage.queryInjections({
-      session_id: sessionId,
-      event_id: eventId,
-      source_handler: handler,
-      limit,
-    });
-    res.json(injections);
-  });
-
-  // Session Events Search: server-side filtering
-  app.get('/api/sessions/:sessionId/events/search', (req, res) => {
-    const { sessionId } = req.params;
-    const { q, tool_name, hook_type, limit = '100', offset = '0' } = req.query;
-
-    const sessions = storage.querySessions({ limit: 1000 });
-    const session = sessions.find(s => s.session_id === sessionId || s.session_id.startsWith(sessionId));
-
-    if (!session) {
-      res.status(404).json({ error: 'Session not found' });
-      return;
-    }
-
-    const results = storage.searchEvents({
-      session_id: session.session_id,
-      query: q as string | undefined,
-      tool_name: tool_name as string | undefined,
-      hook_type: hook_type as string | undefined,
-      limit: parseInt(limit as string, 10),
-      offset: parseInt(offset as string, 10),
-    });
-
-    res.json({ events: results, total: results.length, session_id: session.session_id });
-  });
-
-  // Session Detail: task-grouped session data
-  app.get('/api/sessions/:sessionId/detail', (req, res) => {
-    const sessionId = req.params.sessionId;
-    const eventLimit = parseInt(req.query.eventLimit as string) || 200;
-    const eventOffset = parseInt(req.query.eventOffset as string) || 0;
-
-    const sessions = storage.querySessions({ limit: 1000 });
-    const session = sessions.find(s => s.session_id === sessionId || s.session_id.startsWith(sessionId));
-    if (!session) {
-      res.status(404).json({ error: 'Session not found' });
-      return;
-    }
-
-    const fullSessionId = session.session_id;
-    const tasks = storage.queryTasks({ session_id: fullSessionId });
-    const totalEvents = storage.countEvents({ session_id: fullSessionId });
-    const allEvents = storage.queryEvents({ session_id: fullSessionId, limit: eventLimit, offset: eventOffset });
-    const allInjections = storage.queryInjections({ session_id: fullSessionId, limit: 200 });
-
-    const buildTaskDetail = (events: typeof allEvents, injections: typeof allInjections) => {
-      const prompts = events
-        .filter(e => e.hook_type === 'UserPromptSubmit' && getUserPrompt(e))
-        .map(e => ({ timestamp: e.timestamp, content: getUserPrompt(e) }));
-
-      const toolUsage: Record<string, number> = {};
-      events.forEach(e => { if (e.tool_name) toolUsage[e.tool_name] = (toolUsage[e.tool_name] || 0) + 1; });
-
-      const filesChanged = [...new Set(
-        events
-          .filter(e => (e.tool_name === 'Edit' || e.tool_name === 'Write') && getFilePath(e))
-          .map(e => getFilePath(e)!),
-      )];
-
-      const commits = events
-        .filter(e => e.tool_name === 'Bash' && getCommand(e)?.includes('git commit'))
-        .map(e => {
-          const cmd = getCommand(e) || '';
-          const match = cmd.match(/git commit.*-m\s+["']([^"']+)["']/);
-          return { timestamp: e.timestamp, message: match ? match[1] : 'commit' };
-        });
-
-      return { prompts, events: events.slice(0, 200), injections, summary: { toolUsage, filesChanged, commits } };
-    };
-
-    if (tasks.length === 0) {
-      const detail = buildTaskDetail(allEvents, allInjections);
-      const virtualTask = {
-        id: 'virtual',
-        session_id: fullSessionId,
-        title: session.first_prompt || '(未分类任务)',
-        start_time: session.start_time,
-        end_time: session.end_time,
-        status: 'completed' as const,
-        event_count: allEvents.length,
-        ...detail,
-      };
-      res.json({ session, tasks: [virtualTask], total_events: totalEvents, event_limit: eventLimit, event_offset: eventOffset });
-      return;
-    }
-
-    const taskDetails = tasks.map(task => {
-      const taskEventIds = new Set(storage.getTaskEventIds(task.id));
-      const events = allEvents.filter(e => taskEventIds.has(e.event_id ?? ''));
-      const injections = allInjections.filter(i => i.event_id && taskEventIds.has(i.event_id));
-      const detail = buildTaskDetail(events, injections);
-      return { ...task, ...detail };
-    });
-
-    res.json({ session, tasks: taskDetails, total_events: totalEvents, event_limit: eventLimit, event_offset: eventOffset });
-  });
-
-  // Session timeline: detailed event timeline for a session
-  app.get('/api/sessions/:id/timeline', (req, res) => {
-    const sessionIdPrefix = req.params.id;
-    const limit = parseInt(req.query.limit as string) || 50;
-    const offset = parseInt(req.query.offset as string) || 0;
-
-    const sessions = storage.querySessions({ limit: 1000 });
-    const session = sessions.find(s => s.session_id.startsWith(sessionIdPrefix));
-
-    if (!session) {
-      res.status(404).json({ error: 'Session not found' });
-      return;
-    }
-
-    const fullSessionId = session.session_id;
-    const events = storage.queryEvents({ session_id: fullSessionId, limit: 2000 });
-    const injections = storage.queryInjections({ session_id: fullSessionId, limit: 200 });
-
-    // Build timeline: merge events and injections, sort by timestamp
-    const timeline: Array<{
-      timestamp: string;
-      type: 'user_input' | 'injection' | 'tool_call' | 'quality_check';
-      data: any;
-    }> = [];
-
-    // User inputs
-    events
-      .filter(e => e.hook_type === 'UserPromptSubmit' && getUserPrompt(e))
-      .forEach(e => {
-        timeline.push({
-          timestamp: e.timestamp,
-          type: 'user_input',
-          data: { content: getUserPrompt(e) },
-        });
-      });
-
-    // Injections (truncate content for preview)
-    injections.forEach(inj => {
-      timeline.push({
-        timestamp: inj.timestamp,
-        type: 'injection',
-        data: {
-          source: inj.source_handler,
-          injection_type: inj.injection_type,
-          content: inj.content.slice(0, 500),
-          length: inj.content.length,
-          truncated: inj.content.length > 500,
-        },
-      });
-    });
-
-    // Tool calls (truncate large fields)
-    events
-      .filter(e => e.tool_name && e.hook_type === 'PreToolUse')
-      .forEach(e => {
-        const toolInput = e.tool_input;
-        const toolOutput = e.tool_output;
-
-        timeline.push({
-          timestamp: e.timestamp,
-          type: 'tool_call',
-          data: {
-            tool: e.tool_name,
-            input: truncateField(toolInput, 200, 5),
-            output: truncateField(toolOutput, 200, 5),
-            success: !toolOutput?.error,
-          },
-        });
-      });
-
-    // Quality checks (from PostToolUse events with quality gate results)
-    events
-      .filter(e => e.hook_type === 'PostToolUse' && (e.tool_output as any)?.quality_check)
-      .forEach(e => {
-        const qc = (e.tool_output as any).quality_check;
-        timeline.push({
-          timestamp: e.timestamp,
-          type: 'quality_check',
-          data: qc,
-        });
-      });
-
-    // Sort by timestamp
-    timeline.sort((a, b) => a.timestamp.localeCompare(b.timestamp));
-
-    // Paginate
-    const total = timeline.length;
-    const paginatedTimeline = timeline.slice(offset, offset + limit);
-
-    // Summary
-    const commits = events
-      .filter(e => e.tool_name === 'Bash' && getCommand(e)?.includes('git commit'))
-      .map(e => {
-        const cmd = getCommand(e) || '';
-        const match = cmd.match(/git commit.*-m\s+["']([^"']+)["']/);
-        return { message: match ? match[1] : 'commit' };
-      });
-
-    const filesChanged = [...new Set(
-      events
-        .filter(e => (e.tool_name === 'Edit' || e.tool_name === 'Write') && getFilePath(e))
-        .map(e => getFilePath(e)!),
-    )];
-
-    res.json({
-      session,
-      timeline: paginatedTimeline,
-      total,
-      offset,
-      limit,
-      hasMore: offset + limit < total,
-      summary: {
-        commits,
-        filesChanged,
-      },
-    });
-  });
-}

package/src/web/routes/skill-stats.ts

@@ -1,92 +0,0 @@
-import type { Application } from 'express';
-import type { RouteContext } from './types.js';
-
-/**
- * /api/skill-stats/* — Skill usage statistics and analytics
- *
- * Provides data for the Skill Statistics dashboard:
- *   - /api/skill-stats/distribution — routing type distribution (agent/skill/none)
- *   - /api/skill-stats/frequency — skill usage frequency
- *   - /api/skill-stats/trend — skill usage rate trend over time
- *
- * H1: All endpoints now use storage-layer SQL aggregation (no JS GROUP BY).
- */
-export function registerSkillStatsRoutes(app: Application, ctx: RouteContext): void {
-  const { storage } = ctx;
-
-  // Routing type distribution (for pie chart)
-  app.get('/api/skill-stats/distribution', (req, res) => {
-    const windowHours = parseInt((req.query.window as string) || '168'); // default 7d
-    const since = Date.now() - windowHours * 3600 * 1000;
-    const agg = storage.aggregateRoutingStats({ since_ts: since });
-
-    // Ensure stable ordering and presence of all three buckets (agent/skill/none)
-    const counts: Record<string, number> = { agent: 0, skill: 0, none: 0 };
-    for (const row of agg.by_type) {
-      counts[row.type] = row.count;
-    }
-    const result = Object.entries(counts).map(([type, count]) => ({ type, count }));
-
-    res.json({ windowHours, distribution: result });
-  });
-
-  // Skill usage frequency (for bar chart)
-  app.get('/api/skill-stats/frequency', (req, res) => {
-    const windowHours = parseInt((req.query.window as string) || '168');
-    const since = Date.now() - windowHours * 3600 * 1000;
-    const agg = storage.aggregateRoutingStats({ since_ts: since });
-
-    const result = agg.by_skill_routed.map(({ skill, count }) => ({ name: skill, count }));
-
-    res.json({ windowHours, frequency: result });
-  });
-
-  // Skill usage rate trend over time (for line chart)
-  app.get('/api/skill-stats/trend', (req, res) => {
-    const windowHours = parseInt((req.query.window as string) || '168');
-    const since = Date.now() - windowHours * 3600 * 1000;
-    const rows = storage.aggregateRoutingTrendByDay({ since_ts: since });
-
-    const result = rows
-      .map(r => ({
-        day: r.day,
-        skillRate: r.total > 0 ? Math.round((r.skill / r.total) * 100) : 0,
-      }))
-      .sort((a, b) => a.day.localeCompare(b.day));
-
-    res.json({ windowHours, trend: result });
-  });
-
-  // Skill invocations from skill_invocations table (real call records)
-  app.get('/api/skill-stats/invocations', (req, res) => {
-    const days = parseInt((req.query.days as string) || '7');
-    const since = Date.now() - days * 24 * 3600 * 1000;
-    const rows = storage.aggregateSkillInvocationsBySkill({ since });
-
-    const total = rows.reduce((sum, r) => sum + r.total, 0);
-    const result = rows.map(r => ({
-      skill_id: r.skill_id,
-      total: r.total,
-      success: r.success,
-      failed: r.failed,
-    }));
-
-    res.json({ days, total, invocations: result });
-  });
-
-  // Routing/Agent call rate stats
-  app.get('/api/routing/stats', (req, res) => {
-    const days = parseInt((req.query.days as string) || '7');
-    const since = Date.now() - days * 24 * 3600 * 1000;
-    const agg = storage.aggregateRoutingStats({ since_ts: since });
-
-    const total = agg.total;
-    const agentCalls = agg.obeyed;
-    const noAgent = total - agentCalls;
-    const agentRate = total > 0 ? Math.round((agentCalls / total) * 1000) / 10 : 0;
-
-    const byAgent = agg.by_agent.map(({ agent, count }) => ({ agent, count }));
-
-    res.json({ days, total, agentCalls, noAgent, agentRate, byAgent });
-  });
-}