@dommaker/harness 1.5.0 → 1.7.0

package/src/__tests__/session-startup.test.ts

@@ -1,334 +0,0 @@
-/**
- * SessionStartup 测试
- */
-
-import { describe, it, expect, beforeAll, afterAll } from '@jest/globals';
-import { SessionStartup, createSessionStartup, DEFAULT_CODE_CHECKPOINTS, MINIMAL_CHECKPOINTS } from '../core/session/startup';
-import * as fs from 'fs';
-import * as path from 'path';
-import * as yaml from 'js-yaml';
-
-describe('SessionStartup', () => {
-  const tempDir = path.join(process.cwd(), 'temp-test-session');
-
-  beforeAll(() => {
-    fs.mkdirSync(tempDir, { recursive: true });
-  });
-
-  afterAll(() => {
-    try {
-      fs.rmSync(tempDir, { recursive: true, force: true });
-    } catch {
-      // ignore
-    }
-  });
-
-  describe('run', () => {
-    it('应该运行 pwd 检查点', async () => {
-      const startup = new SessionStartup(tempDir, {
-        required: ['pwd'],
-        optional: [],
-      });
-
-      const result = await startup.run();
-
-      expect(result.success).toBe(true);
-      expect(result.results.length).toBe(1);
-      expect(result.results[0].type).toBe('pwd');
-    });
-
-    it('应该运行 git_status 检查点', async () => {
-      const startup = new SessionStartup(tempDir, {
-        required: ['git_status'],
-        optional: [],
-      });
-
-      const result = await startup.run();
-
-      expect(result.results.length).toBe(1);
-      expect(result.results[0].type).toBe('git_status');
-    });
-
-    it('可选检查点失败不应该影响 success', async () => {
-      const startup = new SessionStartup(tempDir, {
-        required: ['pwd'],
-        optional: ['git_log'],
-      });
-
-      const result = await startup.run();
-
-      expect(result.success).toBe(true);
-      expect(result.results.length).toBe(2);
-    });
-
-    it('必要检查点失败应该影响 success', async () => {
-      const startup = new SessionStartup('/nonexistent/path', {
-        required: ['pwd'],
-        optional: [],
-      });
-
-      const result = await startup.run();
-
-      expect(result.results.length).toBe(1);
-    });
-  });
-
-  describe('检查点数据', () => {
-    it('pwd 应该返回当前目录', async () => {
-      const startup = new SessionStartup(tempDir, {
-        required: ['pwd'],
-        optional: [],
-      });
-
-      const result = await startup.run();
-      const pwdResult = result.results.find(r => r.type === 'pwd');
-
-      expect(pwdResult?.data).toBeDefined();
-    });
-  });
-
-  describe('git_log 检查点', () => {
-    it('应该返回 git log 数据', async () => {
-      const startup = new SessionStartup(tempDir, { required: ['git_log'], optional: [] });
-      const result = await startup.run();
-      expect(result.results[0].type).toBe('git_log');
-      expect(result.results[0].success).toBe(true);
-    });
-  });
-
-  describe('read_task_list 检查点', () => {
-    it('tasks.yml 存在应该解析 YAML', async () => {
-      const tasksPath = path.join(tempDir, 'tasks.yml');
-      const taskData = {
-        tasks: [
-          { id: 't1', name: 'task 1', passes: true },
-          { id: 't2', name: 'task 2', passes: false },
-        ],
-      };
-      fs.writeFileSync(tasksPath, yaml.dump(taskData));
-
-      const startup = new SessionStartup(tempDir, { required: ['read_task_list'], optional: [] });
-      const result = await startup.run();
-      expect(result.results[0].success).toBe(true);
-      expect(result.results[0].data).toBeDefined();
-      expect(result.results[0].data.tasks.length).toBe(2);
-
-      fs.unlinkSync(tasksPath);
-    });
-
-    it('tasks.json 存在应该回退到 JSON', async () => {
-      const tasksPath = path.join(tempDir, 'tasks.json');
-      const taskData = {
-        tasks: [
-          { id: 't1', name: 'task 1', passes: true },
-        ],
-      };
-      fs.writeFileSync(tasksPath, JSON.stringify(taskData));
-
-      const startup = new SessionStartup(tempDir, { required: ['read_task_list'], optional: [] });
-      const result = await startup.run();
-      expect(result.results[0].success).toBe(true);
-      expect(result.results[0].data.tasks.length).toBe(1);
-
-      fs.unlinkSync(tasksPath);
-    });
-
-    it('无任务文件应该返回 null', async () => {
-      const noTasksDir = path.join(tempDir, 'no-tasks');
-      fs.mkdirSync(noTasksDir, { recursive: true });
-
-      const startup = new SessionStartup(noTasksDir, { required: ['read_task_list'], optional: [] });
-      const result = await startup.run();
-      expect(result.results[0].success).toBe(true);
-      expect(result.results[0].data).toBeNull();
-
-      fs.rmSync(noTasksDir, { recursive: true, force: true });
-    });
-  });
-
-  describe('read_progress 检查点', () => {
-    it('progress.yml 存在应该解析', async () => {
-      const harnessDir = path.join(tempDir, '.harness');
-      fs.mkdirSync(harnessDir, { recursive: true });
-      const progressPath = path.join(harnessDir, 'progress.yml');
-      fs.writeFileSync(progressPath, yaml.dump({ step: 3, total: 10 }));
-
-      const startup = new SessionStartup(tempDir, { required: ['read_progress'], optional: [] });
-      const result = await startup.run();
-      expect(result.results[0].success).toBe(true);
-      expect(result.results[0].data).toEqual({ step: 3, total: 10 });
-
-      fs.unlinkSync(progressPath);
-      fs.rmdirSync(harnessDir);
-    });
-
-    it('无 progress.yml 应该返回 null', async () => {
-      const noProgressDir = path.join(tempDir, 'no-progress');
-      fs.mkdirSync(noProgressDir, { recursive: true });
-
-      const startup = new SessionStartup(noProgressDir, { required: ['read_progress'], optional: [] });
-      const result = await startup.run();
-      expect(result.results[0].success).toBe(true);
-      expect(result.results[0].data).toBeNull();
-
-      fs.rmSync(noProgressDir, { recursive: true, force: true });
-    });
-  });
-
-  describe('init_sh 检查点', () => {
-    it('init.sh 存在应该返回 true', async () => {
-      const initPath = path.join(tempDir, 'init.sh');
-      fs.writeFileSync(initPath, '#!/bin/bash\necho "init"');
-
-      const startup = new SessionStartup(tempDir, { required: ['init_sh'], optional: [] });
-      const result = await startup.run();
-      expect(result.results[0].success).toBe(true);
-      expect(result.results[0].data).toBe(true);
-
-      fs.unlinkSync(initPath);
-    });
-
-    it('init.sh 不存在应该返回 false', async () => {
-      const noInitDir = path.join(tempDir, 'no-init');
-      fs.mkdirSync(noInitDir, { recursive: true });
-
-      const startup = new SessionStartup(noInitDir, { required: ['init_sh'], optional: [] });
-      const result = await startup.run();
-      expect(result.results[0].success).toBe(true);
-      expect(result.results[0].data).toBe(false);
-
-      fs.rmSync(noInitDir, { recursive: true, force: true });
-    });
-  });
-
-  describe('basic_verification 检查点', () => {
-    it('应该检测 package.json 和 README.md', async () => {
-      const verDir = path.join(tempDir, 'verification');
-      fs.mkdirSync(verDir, { recursive: true });
-      fs.writeFileSync(path.join(verDir, 'package.json'), '{}');
-      fs.writeFileSync(path.join(verDir, 'README.md'), '# Test');
-
-      const startup = new SessionStartup(verDir, { required: ['basic_verification'], optional: [] });
-      const result = await startup.run();
-      expect(result.results[0].success).toBe(true);
-      expect(result.results[0].data.hasPackageJson).toBe(true);
-      expect(result.results[0].data.hasReadme).toBe(true);
-
-      fs.rmSync(verDir, { recursive: true, force: true });
-    });
-  });
-
-  describe('load_context 检查点', () => {
-    it('应该加载存在的上下文文件', async () => {
-      const ctxDir = path.join(tempDir, 'context-test');
-      fs.mkdirSync(ctxDir, { recursive: true });
-      fs.writeFileSync(path.join(ctxDir, 'AGENTS.md'), '# Agents');
-      fs.writeFileSync(path.join(ctxDir, 'USER.md'), '# User');
-
-      const startup = new SessionStartup(ctxDir, { required: ['load_context'], optional: [], contextFiles: ['AGENTS.md', 'USER.md'] });
-      const result = await startup.run();
-      expect(result.results[0].success).toBe(true);
-      expect(result.results[0].data['AGENTS.md']).toBe('# Agents');
-      expect(result.results[0].data['USER.md']).toBe('# User');
-
-      fs.rmSync(ctxDir, { recursive: true, force: true });
-    });
-  });
-
-  describe('未知检查点类型', () => {
-    it('应该返回失败结果', async () => {
-      const startup = new SessionStartup(tempDir, { required: ['unknown_type' as any], optional: [] });
-      const result = await startup.run();
-      expect(result.success).toBe(false);
-      expect(result.results[0].success).toBe(false);
-      expect(result.results[0].error).toContain('Unknown checkpoint type');
-    });
-  });
-
-  describe('getCurrentTask', () => {
-    it('应该返回第一个未通过的任务', async () => {
-      const tasksPath = path.join(tempDir, 'tasks.yml');
-      const taskData = {
-        tasks: [
-          { id: 't1', name: 'done', passes: true },
-          { id: 't2', name: 'current', passes: false },
-          { id: 't3', name: 'future', passes: false },
-        ],
-      };
-      fs.writeFileSync(tasksPath, yaml.dump(taskData));
-
-      const startup = new SessionStartup(tempDir, { required: [], optional: [] });
-      const current = await startup.getCurrentTask();
-      expect(current).not.toBeNull();
-      expect(current!.task.id).toBe('t2');
-      expect(current!.index).toBe(1);
-
-      fs.unlinkSync(tasksPath);
-    });
-
-    it('所有任务通过应该返回 null', async () => {
-      const tasksPath = path.join(tempDir, 'tasks.yml');
-      const taskData = {
-        tasks: [
-          { id: 't1', name: 'done', passes: true },
-        ],
-      };
-      fs.writeFileSync(tasksPath, yaml.dump(taskData));
-
-      const startup = new SessionStartup(tempDir, { required: [], optional: [] });
-      const current = await startup.getCurrentTask();
-      expect(current).toBeNull();
-
-      fs.unlinkSync(tasksPath);
-    });
-
-    it('无任务文件应该返回 null', async () => {
-      const noTasksDir = path.join(tempDir, 'no-tasks-get');
-      fs.mkdirSync(noTasksDir, { recursive: true });
-
-      const startup = new SessionStartup(noTasksDir, { required: [], optional: [] });
-      const current = await startup.getCurrentTask();
-      expect(current).toBeNull();
-
-      fs.rmSync(noTasksDir, { recursive: true, force: true });
-    });
-  });
-
-  describe('generateReport', () => {
-    it('应该生成报告', () => {
-      const startup = new SessionStartup(tempDir, { required: [], optional: [] });
-      const report = startup.generateReport([
-        { type: 'pwd', success: true, data: '/tmp', duration: 5 },
-        { type: 'git_log', success: false, error: 'not a git repo', duration: 10 },
-      ]);
-
-      expect(report).toContain('Session Startup Report');
-      expect(report).toContain('pwd');
-      expect(report).toContain('git_log');
-      expect(report).toContain('not a git repo');
-    });
-  });
-
-  describe('createSessionStartup 工厂函数', () => {
-    it('应该创建 SessionStartup 实例', () => {
-      const startup = createSessionStartup(tempDir, { required: ['pwd'], optional: [] });
-      expect(startup).toBeInstanceOf(SessionStartup);
-    });
-  });
-
-  describe('常量', () => {
-    it('DEFAULT_CODE_CHECKPOINTS 应该有正确的结构', () => {
-      expect(DEFAULT_CODE_CHECKPOINTS.required).toContain('pwd');
-      expect(DEFAULT_CODE_CHECKPOINTS.required).toContain('git_log');
-      expect(DEFAULT_CODE_CHECKPOINTS.required).toContain('read_task_list');
-      expect(DEFAULT_CODE_CHECKPOINTS.optional).toContain('read_progress');
-      expect(DEFAULT_CODE_CHECKPOINTS.timeout).toBe(30000);
-    });
-
-    it('MINIMAL_CHECKPOINTS 应该有正确的结构', () => {
-      expect(MINIMAL_CHECKPOINTS.required).toContain('pwd');
-      expect(MINIMAL_CHECKPOINTS.required).toContain('read_task_list');
-      expect(MINIMAL_CHECKPOINTS.optional).toEqual([]);
-    });
-  });
-});

package/src/cli/commands/__tests__/analyze-sessions.test.ts

@@ -1,184 +0,0 @@
-/**
- * analyze-sessions 命令测试（O6）
- *
- * Seam：analyzeSessions(options) 公开入口。
- * 隔离面：
- *   - os.homedir → 测试临时目录（memory 规则库落 TEST_HOME）
- *   - readTranscriptSessions → fixture 会话（extractCorrectionMatches/tokenize 等纯函数保持真实）
- *   - CLAUDE_TRANSCRIPTS_DIR → 测试临时目录（决定 transcripts 目录是否存在）
- */
-
-import * as fs from 'fs';
-import { captureIO, lastJsonOutput, type CapturingIO } from '../../command-contract';
-import * as path from 'path';
-import { analyzeSessions } from '../analyze-sessions';
-import { readTranscriptSessions, type MinedSession } from '../../session-mining';
-
-const TEST_HOME = '/tmp/harness-analyze-test-home';
-
-jest.mock('os', () => ({
-  ...jest.requireActual('os'),
-  homedir: () => '/tmp/harness-analyze-test-home',
-}));
-
-jest.mock('../../session-mining', () => ({
-  ...jest.requireActual('../../session-mining'),
-  readTranscriptSessions: jest.fn(),
-}));
-
-jest.mock('chalk', () => {
-  const id = (s: string) => s;
-  const chalkFn = Object.assign(id, {
-    gray: id,
-    blue: id,
-    green: id,
-    yellow: id,
-    cyan: id,
-    bold: id,
-    red: id,
-  });
-  return {
-    __esModule: true,
-    default: chalkFn,
-    gray: id,
-    blue: id,
-    green: id,
-    yellow: id,
-    cyan: id,
-    bold: id,
-    red: id,
-  };
-});
-
-const mockReadTranscriptSessions = readTranscriptSessions as jest.MockedFunction<
-  typeof readTranscriptSessions
->;
-
-const TRANSCRIPTS_DIR = path.join(TEST_HOME, 'transcripts');
-
-function mkSession(partial: Partial<MinedSession> = {}): MinedSession {
-  return {
-    id: 'session-1',
-    date: '2026-08-15',
-    mtimeMs: Date.now(),
-    turns: [
-      { role: 'user', content: '我不是说要用中文吗' },
-      { role: 'assistant', content: '收到，改用中文' },
-    ],
-    toolCalls: [],
-    ...partial,
-  };
-}
-
-let io: CapturingIO;
-beforeEach(() => {
-  io = captureIO();
-});
-
-describe('analyze-sessions command', () => {
-
-  beforeEach(() => {
-    jest.clearAllMocks();
-    fs.rmSync(TEST_HOME, { recursive: true, force: true });
-    fs.mkdirSync(path.join(TEST_HOME, '.claude', 'projects', '-root-projects', 'memory'), { recursive: true });
-    fs.mkdirSync(TRANSCRIPTS_DIR, { recursive: true });
-    process.env.CLAUDE_TRANSCRIPTS_DIR = TRANSCRIPTS_DIR;
-  });
-
-  afterEach(() => {
-    delete process.env.CLAUDE_TRANSCRIPTS_DIR;
-  });
-
-  test('transcripts 目录不存在：提示 No transcripts directory found', async () => {
-    process.env.CLAUDE_TRANSCRIPTS_DIR = path.join(TEST_HOME, 'missing-dir');
-
-    const result = await analyzeSessions({}, io);
-
-    expect(io.outText()).toContain('No transcripts directory found');
-    expect(result).toEqual({ kind: 'skip', reason: expect.stringContaining('会话记录目录不存在') });
-    expect(mockReadTranscriptSessions).not.toHaveBeenCalled();
-  });
-
-  test('窗口内无会话：提示 No sessions found（默认最近 7 天）', async () => {
-    const before = Date.now() - 7 * 86_400_000;
-    mockReadTranscriptSessions.mockReturnValue([]);
-
-    const result = await analyzeSessions({}, io);
-    const after = Date.now() - 7 * 86_400_000;
-
-    expect(io.outText()).toContain('No sessions found in the last 7 days');
-    expect(result).toEqual({ kind: 'skip', reason: '最近 7 天没有会话' });
-    // since 过滤下推到 seam：默认窗口 7 天
-    const filter = mockReadTranscriptSessions.mock.calls[0][1] as { since?: number };
-    expect(filter.since).toBeGreaterThanOrEqual(before);
-    expect(filter.since).toBeLessThanOrEqual(after);
-  });
-
-  test('--days 1：since 过滤下推到 seam（mtimeMs 窗口）', async () => {
-    const before = Date.now() - 86_400_000;
-    mockReadTranscriptSessions.mockReturnValue([mkSession({ id: 'today' })]);
-
-    await analyzeSessions({ days: 1 }, io);
-    const after = Date.now() - 86_400_000;
-
-    expect(io.outText()).toContain('Analyzing 1 sessions (last 1 days)');
-    const filter = mockReadTranscriptSessions.mock.calls[0][1] as { since?: number };
-    expect(filter.since).toBeGreaterThanOrEqual(before);
-    expect(filter.since).toBeLessThanOrEqual(after);
-  });
-
-  test('缺省 --days：窗口为 7 天，两天前会话仍计入', async () => {
-    mockReadTranscriptSessions.mockReturnValue([
-      mkSession({ id: 'today' }),
-      mkSession({ id: 'two-days-ago', mtimeMs: Date.now() - 2 * 86_400_000 }),
-    ]);
-
-    await analyzeSessions({}, io);
-
-    expect(io.outText()).toContain('Analyzing 2 sessions (last 7 days)');
-  });
-
-  test('--json：纠正句跨 3 会话聚合为 correction 候选', async () => {
-    mockReadTranscriptSessions.mockReturnValue([
-      mkSession({ id: 's1' }),
-      mkSession({ id: 's2' }),
-      mkSession({ id: 's3' }),
-    ]);
-
-    await analyzeSessions({ json: true }, io);
-
-    const output = lastJsonOutput(io);
-    expect(output.sessions).toBe(3);
-    expect(output.corrections).toBe(3);
-    expect(output.candidates).toEqual(
-      expect.arrayContaining([
-        expect.objectContaining({
-          source: 'correction',
-          frequency: 3,
-          pattern: '我不是说',
-        }),
-      ]),
-    );
-  });
-
-  test('--json：跨会话重复概念产出 ngram 候选', async () => {
-    const ngramText = { role: 'user', content: '数据库迁移方案的详细讨论' };
-    mockReadTranscriptSessions.mockReturnValue([
-      mkSession({
-        id: 's1',
-        turns: [ngramText, { role: 'assistant', content: '好的' }],
-      }),
-      mkSession({
-        id: 's2',
-        turns: [ngramText, { role: 'assistant', content: '明白' }],
-      }),
-    ]);
-
-    await analyzeSessions({ json: true }, io);
-
-    const output = lastJsonOutput(io);
-    const ngramCandidates = (output.candidates as Array<{ source: string }>)
-      .filter(c => c.source === 'ngram');
-    expect(ngramCandidates.length).toBeGreaterThan(0);
-  });
-});