@winspan/claude-forge 8.41.0 → 8.50.6

package/tests/unit/web/routes-tasks.test.ts

@@ -0,0 +1,351 @@
+/**
+ * Unit tests for /api/tasks routes (list + detail + filter + pagination).
+ *
+ * Tests updated after implement phase to assert the new
+ * `{ items, total, has_more }` response shape (was: bare Task[]).
+ * Former [CHAR] tests are now regular tests asserting the new contract.
+ */
+
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import express, { type Application } from 'express';
+import request from 'supertest';
+import { SQLiteStorage } from '../../../src/core/storage/sqlite.js';
+import { registerTasksRoutes } from '../../../src/web/routes/tasks.js';
+
+const SESSION   = 'sess-task-1';
+const PROJECT_A = '/home/user/project-alpha';
+const PROJECT_B = '/home/user/project-beta';
+
+// Stable UUIDs used as event IDs (must pass Zod uuid validation)
+const EV_PROMPT = '776a8705-cdf6-42e3-a746-8e2cb8a2a90c';
+const EV_TOOL   = '2ace53f4-3a5d-4028-9354-438044cd33bd';
+const EV_AGENT  = 'dc56940c-3161-4071-bf44-7dd8e5f5fb9b';
+const INJ_ID    = 'd4ef23b3-fd39-494d-a0c4-88ddc1f4a809';
+const SI_ID     = 'bc082fc2-11c2-4396-b22c-c0ff49901c04';
+
+function ts(offsetMs = 0): string {
+  return new Date(Date.UTC(2026, 0, 1) + offsetMs).toISOString();
+}
+
+/** Write a session so the JOIN in queryTasksFiltered can find project_path */
+function seedSession(storage: SQLiteStorage, sessionId: string, projectPath: string, t = ts()) {
+  storage.getDatabase().prepare(
+    `INSERT OR IGNORE INTO sessions (session_id, project_path, start_time) VALUES (?, ?, ?)`
+  ).run(sessionId, projectPath, t);
+}
+
+describe('Tasks Routes', () => {
+  let app: Application;
+  let storage: SQLiteStorage;
+
+  beforeEach(() => {
+    storage = new SQLiteStorage(':memory:');
+    app = express();
+    app.use(express.json());
+    registerTasksRoutes(app, { storage });
+  });
+
+  afterEach(() => {
+    storage.close();
+  });
+
+  // ─────────────────────────────────────────────────────────────────────────
+  // GET /api/tasks — new { items, total, has_more } shape
+  // ─────────────────────────────────────────────────────────────────────────
+
+  describe('GET /api/tasks — paginated response', () => {
+    it('returns empty page when no tasks (A1)', async () => {
+      const res = await request(app).get('/api/tasks');
+      expect(res.status).toBe(200);
+      expect(res.body).toMatchObject({ items: [], total: 0, has_more: false });
+    });
+
+    it('returns items newest-first with total and has_more (A1)', async () => {
+      seedSession(storage, SESSION, PROJECT_A);
+      storage.writeTask({ id: 't1', session_id: SESSION, title: 'first',  start_time: ts() });
+      storage.writeTask({ id: 't2', session_id: SESSION, title: 'second', start_time: ts(1000) });
+      const res = await request(app).get('/api/tasks');
+      expect(res.status).toBe(200);
+      expect(res.body.total).toBe(2);
+      expect(res.body.has_more).toBe(false);
+      expect(res.body.items).toHaveLength(2);
+      expect(res.body.items[0].id).toBe('t2');
+      expect(res.body.items[1].id).toBe('t1');
+    });
+
+    it('items include project_path from joined sessions', async () => {
+      seedSession(storage, SESSION, PROJECT_A);
+      storage.writeTask({ id: 'tp', session_id: SESSION, title: 'with-proj', start_time: ts() });
+      const res = await request(app).get('/api/tasks');
+      expect(res.status).toBe(200);
+      expect(res.body.items[0].project_path).toBe(PROJECT_A);
+    });
+
+    it('honours session filter and returns wrapped response', async () => {
+      seedSession(storage, 'sess-a', PROJECT_A);
+      seedSession(storage, 'sess-b', PROJECT_B);
+      storage.writeTask({ id: 'a', session_id: 'sess-a', title: 'a', start_time: ts() });
+      storage.writeTask({ id: 'b', session_id: 'sess-b', title: 'b', start_time: ts(1000) });
+      const res = await request(app).get('/api/tasks').query({ session: 'sess-a' });
+      expect(res.status).toBe(200);
+      expect(res.body.items).toHaveLength(1);
+      expect(res.body.items[0].id).toBe('a');
+      expect(res.body.total).toBe(1);
+    });
+
+    it('respects limit param and sets has_more', async () => {
+      seedSession(storage, SESSION, PROJECT_A);
+      for (let i = 0; i < 5; i++) {
+        storage.writeTask({ id: `t${i}`, session_id: SESSION, title: `task${i}`, start_time: ts(i * 1000) });
+      }
+      const res = await request(app).get('/api/tasks').query({ limit: 3 });
+      expect(res.status).toBe(200);
+      expect(res.body.items).toHaveLength(3);
+      expect(res.body.total).toBe(5);
+      expect(res.body.has_more).toBe(true);
+    });
+
+    it('clamps limit to 200 (A6)', async () => {
+      seedSession(storage, SESSION, PROJECT_A);
+      storage.writeTask({ id: 'tx', session_id: SESSION, title: 'x', start_time: ts() });
+      const res = await request(app).get('/api/tasks').query({ limit: 201 });
+      expect(res.status).toBe(200);
+      // No error — clamped silently by Zod max(200) → returns valid page
+      expect(res.body).toHaveProperty('items');
+      expect(res.body).toHaveProperty('total');
+    });
+
+    it('task items contain expected fields', async () => {
+      seedSession(storage, SESSION, PROJECT_A);
+      storage.writeTask({ id: 'field-check', session_id: SESSION, title: 'Test task', start_time: ts() });
+      const res = await request(app).get('/api/tasks');
+      expect(res.status).toBe(200);
+      const task = res.body.items[0];
+      expect(task).toHaveProperty('id', 'field-check');
+      expect(task).toHaveProperty('session_id', SESSION);
+      expect(task).toHaveProperty('title', 'Test task');
+      expect(task).toHaveProperty('start_time');
+      expect(task).toHaveProperty('status');
+      expect(task).toHaveProperty('event_count');
+    });
+  });
+
+  // ─────────────────────────────────────────────────────────────────────────
+  // GET /api/tasks — filter params
+  // ─────────────────────────────────────────────────────────────────────────
+
+  describe('GET /api/tasks — filter params', () => {
+    it('filters by single project (A2)', async () => {
+      seedSession(storage, 'sess-a', PROJECT_A);
+      seedSession(storage, 'sess-b', PROJECT_B);
+      storage.writeTask({ id: 'ta', session_id: 'sess-a', title: 'alpha task', start_time: ts() });
+      storage.writeTask({ id: 'tb', session_id: 'sess-b', title: 'beta task',  start_time: ts(1000) });
+
+      const res = await request(app).get('/api/tasks').query({ project: PROJECT_A });
+      expect(res.status).toBe(200);
+      expect(res.body.items).toHaveLength(1);
+      expect(res.body.items[0].id).toBe('ta');
+      expect(res.body.total).toBe(1);
+    });
+
+    it('filters by multiple projects OR (A3)', async () => {
+      seedSession(storage, 'sess-a', PROJECT_A);
+      seedSession(storage, 'sess-b', PROJECT_B);
+      seedSession(storage, 'sess-c', '/other');
+      storage.writeTask({ id: 'ta', session_id: 'sess-a', title: 'a', start_time: ts() });
+      storage.writeTask({ id: 'tb', session_id: 'sess-b', title: 'b', start_time: ts(1000) });
+      storage.writeTask({ id: 'tc', session_id: 'sess-c', title: 'c', start_time: ts(2000) });
+
+      const res = await request(app).get('/api/tasks')
+        .query(`project=${encodeURIComponent(PROJECT_A)}&project=${encodeURIComponent(PROJECT_B)}`);
+      expect(res.status).toBe(200);
+      expect(res.body.items).toHaveLength(2);
+      expect(res.body.total).toBe(2);
+      const ids = res.body.items.map((t: { id: string }) => t.id).sort();
+      expect(ids).toEqual(['ta', 'tb']);
+    });
+
+    it('filters by from/to time range (A4)', async () => {
+      seedSession(storage, SESSION, PROJECT_A);
+      storage.writeTask({ id: 'early', session_id: SESSION, title: 'early', start_time: '2026-01-01T00:00:00.000Z' });
+      storage.writeTask({ id: 'mid',   session_id: SESSION, title: 'mid',   start_time: '2026-01-15T12:00:00.000Z' });
+      storage.writeTask({ id: 'late',  session_id: SESSION, title: 'late',  start_time: '2026-02-01T00:00:00.000Z' });
+
+      const res = await request(app).get('/api/tasks').query({
+        from: '2026-01-01T00:00:00.000Z',
+        to:   '2026-01-31T23:59:59.000Z',
+      });
+      expect(res.status).toBe(200);
+      expect(res.body.total).toBe(2);
+      const ids = res.body.items.map((t: { id: string }) => t.id).sort();
+      expect(ids).toEqual(['early', 'mid']);
+    });
+
+    it('filters by search (title LIKE) (A5)', async () => {
+      seedSession(storage, SESSION, PROJECT_A);
+      storage.writeTask({ id: 't1', session_id: SESSION, title: '重构数据库',  start_time: ts() });
+      storage.writeTask({ id: 't2', session_id: SESSION, title: 'build CI',    start_time: ts(1000) });
+      storage.writeTask({ id: 't3', session_id: SESSION, title: '重构 API',    start_time: ts(2000) });
+
+      const res = await request(app).get('/api/tasks').query({ search: '重构' });
+      expect(res.status).toBe(200);
+      expect(res.body.total).toBe(2);
+      const ids = res.body.items.map((t: { id: string }) => t.id).sort();
+      expect(ids).toEqual(['t1', 't3']);
+    });
+
+    it('returns 400 for invalid query params', async () => {
+      const res = await request(app).get('/api/tasks').query({ limit: 'abc' });
+      expect(res.status).toBe(400);
+      expect(res.body).toHaveProperty('error');
+    });
+  });
+
+  // ─────────────────────────────────────────────────────────────────────────
+  // GET /api/tasks — pagination (A8)
+  // ─────────────────────────────────────────────────────────────────────────
+
+  describe('GET /api/tasks — pagination (A8)', () => {
+    it('offset increments page, total stays constant', async () => {
+      seedSession(storage, SESSION, PROJECT_A);
+      for (let i = 0; i < 6; i++) {
+        storage.writeTask({ id: `pg${i}`, session_id: SESSION, title: `t${i}`, start_time: ts(i * 1000) });
+      }
+
+      const page1 = await request(app).get('/api/tasks').query({ limit: 4, offset: 0 });
+      const page2 = await request(app).get('/api/tasks').query({ limit: 4, offset: 4 });
+
+      expect(page1.body.total).toBe(6);
+      expect(page1.body.items).toHaveLength(4);
+      expect(page1.body.has_more).toBe(true);
+
+      expect(page2.body.total).toBe(6);
+      expect(page2.body.items).toHaveLength(2);
+      expect(page2.body.has_more).toBe(false);
+
+      // No overlap
+      const p1ids = page1.body.items.map((t: { id: string }) => t.id);
+      const p2ids = page2.body.items.map((t: { id: string }) => t.id);
+      expect(p1ids.some((id: string) => p2ids.includes(id))).toBe(false);
+    });
+  });
+
+  // ─────────────────────────────────────────────────────────────────────────
+  // GET /api/tasks/projects
+  // ─────────────────────────────────────────────────────────────────────────
+
+  describe('GET /api/tasks/projects', () => {
+    it('returns empty array when no tasks', async () => {
+      const res = await request(app).get('/api/tasks/projects');
+      expect(res.status).toBe(200);
+      expect(res.body).toEqual([]);
+    });
+
+    it('returns distinct project paths that have tasks', async () => {
+      seedSession(storage, 'sess-a', PROJECT_A);
+      seedSession(storage, 'sess-b', PROJECT_B);
+      seedSession(storage, 'sess-c', '/other/path');
+      storage.writeTask({ id: 'ta', session_id: 'sess-a', title: 'a', start_time: ts() });
+      storage.writeTask({ id: 'tb', session_id: 'sess-b', title: 'b', start_time: ts(1000) });
+      // sess-c has no tasks — should not appear
+
+      const res = await request(app).get('/api/tasks/projects');
+      expect(res.status).toBe(200);
+      expect(res.body).toHaveLength(2);
+      expect(res.body).toContain(PROJECT_A);
+      expect(res.body).toContain(PROJECT_B);
+      expect(res.body).not.toContain('/other/path');
+    });
+
+    it('de-duplicates when multiple sessions share a project', async () => {
+      seedSession(storage, 'sess-1', PROJECT_A);
+      seedSession(storage, 'sess-2', PROJECT_A);
+      storage.writeTask({ id: 't1', session_id: 'sess-1', title: 'a', start_time: ts() });
+      storage.writeTask({ id: 't2', session_id: 'sess-2', title: 'b', start_time: ts(1000) });
+
+      const res = await request(app).get('/api/tasks/projects');
+      expect(res.status).toBe(200);
+      expect(res.body).toHaveLength(1);
+      expect(res.body[0]).toBe(PROJECT_A);
+    });
+  });
+
+  // ─────────────────────────────────────────────────────────────────────────
+  // GET /api/tasks/:taskId — detail route (unchanged by this feature)
+  // ─────────────────────────────────────────────────────────────────────────
+
+  describe('GET /api/tasks/:taskId', () => {
+    it('returns 404 for non-existent task', async () => {
+      const res = await request(app).get('/api/tasks/missing');
+      expect(res.status).toBe(404);
+      expect(res.body.error).toBe('Task not found');
+    });
+
+    it('returns task detail with timeline + injections + skill invocations', async () => {
+      storage.writeTask({ id: 'task-1', session_id: SESSION, title: 'Build', start_time: ts() });
+
+      // Write events bound to this task
+      storage.writeEvent({
+        event_id: EV_PROMPT,
+        session_id: SESSION, project_path: PROJECT_A, timestamp: ts(100),
+        hook_type: 'UserPromptSubmit', user_prompt: 'go build',
+      });
+      storage.writeEvent({
+        event_id: EV_TOOL,
+        session_id: SESSION, project_path: PROJECT_A, timestamp: ts(200),
+        hook_type: 'PreToolUse', tool_name: 'Edit',
+        tool_input: { file_path: '/main.ts' },
+      });
+      storage.linkEventToTask('task-1', EV_PROMPT);
+      storage.linkEventToTask('task-1', EV_TOOL);
+
+      // Injection
+      storage.writeInjection({
+        id: INJ_ID, event_id: EV_TOOL, session_id: SESSION,
+        timestamp: ts(150), source_handler: 'pre-tool',
+        injection_type: 'systemMessage', content: 'reminder',
+      });
+
+      // Skill invocation within task time window
+      storage.writeSkillInvocation({
+        id: SI_ID, route_request_id: null, session_id: SESSION,
+        agent_id: null, skill_id: 'official-tdd',
+        invocation_type: 'dynamic', reason: 'tdd',
+        workflow: null, phase: null, feature_slug: null, artifact_path: null,
+        depth: 0, success: 1, error: null,
+        timestamp: new Date(ts(150)).getTime(),
+      });
+
+      const res = await request(app).get('/api/tasks/task-1');
+      expect(res.status).toBe(200);
+      expect(res.body.task.id).toBe('task-1');
+      expect(res.body.userPrompts).toHaveLength(1);
+      expect(res.body.userPrompts[0].content).toBe('go build');
+      expect(res.body.timeline).toHaveLength(1);
+      expect(res.body.timeline[0].tool_name).toBe('Edit');
+      expect(res.body.injections).toHaveLength(1);
+      expect(res.body.injections[0].source_handler).toBe('pre-tool');
+      expect(res.body.skillInvocations).toHaveLength(1);
+      expect(res.body.skillInvocations[0].skill_id).toBe('official-tdd');
+      expect(res.body.artifacts).toContain('/main.ts');
+    });
+
+    it('marks Agent calls in timeline with agent_detail', async () => {
+      storage.writeTask({ id: 'agent-task', session_id: SESSION, title: 'agent', start_time: ts() });
+      storage.writeEvent({
+        event_id: EV_AGENT,
+        session_id: SESSION, project_path: PROJECT_A, timestamp: ts(100),
+        hook_type: 'PreToolUse', tool_name: 'Task',
+        tool_input: { subagent_type: 'researcher', name: 'r1', prompt: 'go' },
+      });
+      storage.linkEventToTask('agent-task', EV_AGENT);
+
+      const res = await request(app).get('/api/tasks/agent-task');
+      expect(res.status).toBe(200);
+      expect(res.body.timeline).toHaveLength(1);
+      expect(res.body.timeline[0].is_agent_call).toBe(true);
+      expect(res.body.timeline[0].agent_detail.subagent_type).toBe('researcher');
+      expect(res.body.timeline[0].agent_detail.name).toBe('r1');
+    });
+  });
+});

package/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "lib": ["ES2022"],
+    "types": ["node"],
+    "moduleResolution": "nodenext",
+    "resolveJsonModule": true,
+    "allowJs": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "src/tests"]
+}

package/vitest.config.ts

@@ -0,0 +1,21 @@
+import { defineConfig } from 'vitest/config';
+import path from 'path';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['tests/unit/**/*.test.ts'],
+    exclude: ['tests-old/**', 'src-old/**', 'node_modules/**'],
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'json', 'html'],
+      exclude: ['node_modules/', 'dist/', 'tests/', 'tests-old/', 'src-old/']
+    }
+  },
+  resolve: {
+    alias: {
+      '@': path.resolve(__dirname, './src')
+    }
+  }
+});

package/vitest.integration.config.ts

@@ -0,0 +1,16 @@
+import { defineConfig } from 'vitest/config';
+import path from 'path';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['tests/unit/**/*.test.ts', 'tests/integration/**/*.test.ts'],
+    exclude: ['tests-old/**', 'src-old/**', 'node_modules/**'],
+  },
+  resolve: {
+    alias: {
+      '@': path.resolve(__dirname, './src')
+    }
+  }
+});

package/web/CLAUDE.md

@@ -0,0 +1,20 @@
+
+
+<!-- forge:resume-begin:4be8b345-7ddc-4d5f-819a-ebb586eb0ec7 -->
+```forge-resume-body
+## 上次工作续接
+
+⚠️ **IMPORTANT: 在开始新任务前，请先检查以下上下文**
+
+**上次在做**:
+- <task-notification>
+
+**上次活跃**: 刚刚
+
+**会话行为**: 工具调用 4934 次 | Agent 委托 106 次 (Explore, coder, feature-developer) | Skill 调用 9 次
+
+_生成时间: 2026-05-15T04:39:12.196Z_
+```
+
+_生成时间: 2026-05-15T04:39:12.272Z_
+<!-- forge:resume-end:4be8b345-7ddc-4d5f-819a-ebb586eb0ec7 -->

package/web/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Claude Forge 管理后台</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>