@dommaker/harness 0.18.0 → 0.19.0

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

@@ -0,0 +1,178 @@
+/**
+ * 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 * 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,
+  };
+}
+
+function lastJsonOutput(consoleSpy: jest.SpyInstance): Record<string, unknown> {
+  const jsonLine = consoleSpy.mock.calls.map(c => c[0]).join('\n');
+  return JSON.parse(jsonLine);
+}
+
+describe('analyze-sessions command', () => {
+  let consoleSpy: jest.SpyInstance;
+
+  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;
+    consoleSpy = jest.spyOn(console, 'log').mockImplementation();
+  });
+
+  afterEach(() => {
+    consoleSpy.mockRestore();
+    delete process.env.CLAUDE_TRANSCRIPTS_DIR;
+  });
+
+  test('transcripts 目录不存在：提示 No transcripts directory found', async () => {
+    process.env.CLAUDE_TRANSCRIPTS_DIR = path.join(TEST_HOME, 'missing-dir');
+
+    await analyzeSessions({});
+
+    expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('No transcripts directory found'));
+    expect(mockReadTranscriptSessions).not.toHaveBeenCalled();
+  });
+
+  test('窗口内无会话：提示 No sessions found（默认最近 7 天）', async () => {
+    mockReadTranscriptSessions.mockReturnValue([
+      mkSession({ id: 'old', mtimeMs: Date.now() - 30 * 86_400_000 }),
+    ]);
+
+    await analyzeSessions({});
+
+    expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('No sessions found in the last 7 days'));
+  });
+
+  test('--days 1：只统计最近 1 天（mtimeMs 窗口过滤）', async () => {
+    mockReadTranscriptSessions.mockReturnValue([
+      mkSession({ id: 'today' }),
+      mkSession({ id: 'two-days-ago', mtimeMs: Date.now() - 2 * 86_400_000 }),
+    ]);
+
+    await analyzeSessions({ days: 1 });
+
+    expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('Analyzing 1 sessions (last 1 days)'));
+  });
+
+  test('缺省 --days：窗口为 7 天，两天前会话仍计入', async () => {
+    mockReadTranscriptSessions.mockReturnValue([
+      mkSession({ id: 'today' }),
+      mkSession({ id: 'two-days-ago', mtimeMs: Date.now() - 2 * 86_400_000 }),
+    ]);
+
+    await analyzeSessions({});
+
+    expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('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 });
+
+    const output = lastJsonOutput(consoleSpy);
+    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 });
+
+    const output = lastJsonOutput(consoleSpy);
+    const ngramCandidates = (output.candidates as Array<{ source: string }>)
+      .filter(c => c.source === 'ngram');
+    expect(ngramCandidates.length).toBeGreaterThan(0);
+  });
+});

package/src/cli/commands/__tests__/release.test.ts

@@ -0,0 +1,162 @@
+/**
+ * release 命令测试（O6）
+ *
+ * Seam：release(options) 公开入口。
+ * 隔离面：
+ *   - child_process.execSync → 按命令分发的 fixture（git/npm/tsc 全部 mock，绝不真执行）
+ *   - fs.existsSync / readFileSync → fixture 包（package.json + dist 关键文件）
+ *   - process.exit → 抛异常断言化（exit code 可断言，且阻断后续真实副作用）
+ *
+ * 测试止于 dry-run 与「发布前闸门」（分支/同步/干净树/tag 冲突），
+ * 不覆盖真实 npm version/publish 路径——禁止真发版。
+ */
+
+import * as fs from 'fs';
+import { execSync } from 'child_process';
+import { release } from '../release';
+
+jest.mock('child_process', () => ({
+  ...jest.requireActual('child_process'),
+  execSync: jest.fn(),
+}));
+
+jest.mock('fs', () => ({
+  ...jest.requireActual('fs'),
+  existsSync: jest.fn(),
+  readFileSync: 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 mockExecSync = execSync as jest.MockedFunction<typeof execSync>;
+const mockFs = fs as jest.Mocked<typeof fs>;
+
+const PKG_JSON = JSON.stringify({ name: '@dommaker/harness', version: '0.18.0' });
+
+describe('release command', () => {
+  let consoleSpy: jest.SpyInstance;
+  let errorSpy: jest.SpyInstance;
+  let exitSpy: jest.SpyInstance;
+  let pkgExists: boolean;
+  let tagListResult: string;
+
+  beforeEach(() => {
+    jest.clearAllMocks();
+    pkgExists = true;
+    tagListResult = '';
+    consoleSpy = jest.spyOn(console, 'log').mockImplementation();
+    errorSpy = jest.spyOn(console, 'error').mockImplementation();
+    exitSpy = jest.spyOn(process, 'exit').mockImplementation((code?: string | number | null) => {
+      throw new Error(`__exit_${code}__`);
+    });
+
+    mockFs.existsSync.mockImplementation((p) => {
+      if (String(p).endsWith('package.json')) return pkgExists;
+      return true; // dist 关键文件视为存在
+    });
+    mockFs.readFileSync.mockReturnValue(PKG_JSON);
+
+    mockExecSync.mockImplementation((cmd: string) => {
+      const c = String(cmd);
+      if (c.startsWith('git rev-parse --abbrev-ref')) return 'master';
+      if (c.startsWith('git rev-list --count')) return '0';
+      if (c.startsWith('git status --porcelain')) return '';
+      if (c.startsWith('git tag -l')) return tagListResult;
+      if (c.startsWith('npx tsc')) return 'build ok';
+      return '';
+    });
+  });
+
+  afterEach(() => {
+    consoleSpy.mockRestore();
+    errorSpy.mockRestore();
+    exitSpy.mockRestore();
+  });
+
+  test('非包目录：exit 1 并提示 Not a package', async () => {
+    pkgExists = false;
+
+    await expect(release({})).rejects.toThrow('__exit_1__');
+    expect(errorSpy).toHaveBeenCalledWith(expect.stringContaining('Not a package'));
+  });
+
+  test('非 master/main 分支：exit 1 并提示', async () => {
+    mockExecSync.mockImplementation((cmd: string) =>
+      String(cmd).startsWith('git rev-parse --abbrev-ref') ? 'feat/x' : '');
+
+    await expect(release({})).rejects.toThrow('__exit_1__');
+    expect(errorSpy).toHaveBeenCalledWith(expect.stringContaining('Must be on master or main branch'));
+  });
+
+  test('落后于远程：exit 1 并提示 behind', async () => {
+    mockExecSync.mockImplementation((cmd: string) => {
+      const c = String(cmd);
+      if (c.startsWith('git rev-parse --abbrev-ref')) return 'master';
+      if (c.startsWith('git rev-list --count')) return '3';
+      return '';
+    });
+
+    await expect(release({})).rejects.toThrow('__exit_1__');
+    expect(errorSpy).toHaveBeenCalledWith(expect.stringContaining('behind origin'));
+  });
+
+  test('工作树不干净：exit 1 并提示 Uncommitted changes', async () => {
+    mockExecSync.mockImplementation((cmd: string) => {
+      const c = String(cmd);
+      if (c.startsWith('git rev-parse --abbrev-ref')) return 'master';
+      if (c.startsWith('git rev-list --count')) return '0';
+      if (c.startsWith('git status --porcelain')) return ' M package.json';
+      return '';
+    });
+
+    await expect(release({})).rejects.toThrow('__exit_1__');
+    expect(errorSpy).toHaveBeenCalledWith(expect.stringContaining('Uncommitted changes'));
+  });
+
+  test('dry-run patch：计算目标版本 0.18.1，exit 0', async () => {
+    await expect(release({ bumpType: 'patch', dryRun: 'true' })).rejects.toThrow('__exit_0__');
+    expect(consoleSpy).toHaveBeenCalledWith(
+      expect.stringContaining('Dry-run complete. Would publish: @dommaker/harness@0.18.1'),
+    );
+  });
+
+  test('dry-run minor：计算目标版本 0.19.0', async () => {
+    await expect(release({ bumpType: 'minor', dryRun: 'true' })).rejects.toThrow('__exit_0__');
+    expect(consoleSpy).toHaveBeenCalledWith(
+      expect.stringContaining('Dry-run complete. Would publish: @dommaker/harness@0.19.0'),
+    );
+  });
+
+  test('目标 tag 已存在：发布前闸门 exit 1（不触 npm version）', async () => {
+    tagListResult = 'v0.18.1';
+
+    await expect(release({ bumpType: 'patch' })).rejects.toThrow('__exit_1__');
+    expect(errorSpy).toHaveBeenCalledWith(expect.stringContaining('already exists'));
+    // 闸门阻断：npm version / npm publish 从未执行
+    const commands = mockExecSync.mock.calls.map(c => String(c[0]));
+    expect(commands.some(c => c.startsWith('npm version'))).toBe(false);
+    expect(commands.some(c => c.startsWith('npm publish'))).toBe(false);
+  });
+});

package/src/cli/commands/__tests__/update-user-model.test.ts

@@ -0,0 +1,205 @@
+/**
+ * update-user-model 命令测试（O1：--days flag + --json/--dry-run 兼容）
+ *
+ * Seam：updateUserModel(options) 公开入口。
+ * 隔离面：
+ *   - os.homedir → 测试临时目录（state/profile 落 TEST_HOME，不触碰真实 ~/.claude）
+ *   - readTranscriptSessions → fixture 会话（extractCorrectionMatches 等纯函数保持真实）
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import { updateUserModel } from '../update-user-model';
+import { readTranscriptSessions, type MinedSession } from '../../session-mining';
+
+const TEST_HOME = '/tmp/harness-uum-test-home';
+
+jest.mock('os', () => ({
+  ...jest.requireActual('os'),
+  homedir: () => '/tmp/harness-uum-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 STATE_FILE = path.join(TEST_HOME, '.claude', 'user-model-state.json');
+
+function todayStr(offsetDays = 0): string {
+  return new Date(Date.now() - offsetDays * 86_400_000).toISOString().slice(0, 10);
+}
+
+function mkSession(partial: Partial<MinedSession> = {}): MinedSession {
+  return {
+    id: 'session-1',
+    date: todayStr(),
+    mtimeMs: Date.now(),
+    turns: [
+      { role: 'user', content: '数据库迁移方案需要执行' },
+      { role: 'assistant', content: '好的' },
+    ],
+    toolCalls: ['Read'],
+    ...partial,
+  };
+}
+
+function lastJsonOutput(consoleSpy: jest.SpyInstance): Record<string, unknown> {
+  const jsonLine = consoleSpy.mock.calls.map(c => c[0]).join('\n');
+  return JSON.parse(jsonLine);
+}
+
+describe('update-user-model command', () => {
+  let consoleSpy: jest.SpyInstance;
+
+  beforeEach(() => {
+    jest.clearAllMocks();
+    fs.rmSync(TEST_HOME, { recursive: true, force: true });
+    fs.mkdirSync(path.join(TEST_HOME, '.claude', 'projects', '-root-projects', 'memory'), { recursive: true });
+    process.env.CLAUDE_TRANSCRIPTS_DIR = path.join(TEST_HOME, 'transcripts');
+    consoleSpy = jest.spyOn(console, 'log').mockImplementation();
+  });
+
+  afterEach(() => {
+    consoleSpy.mockRestore();
+    delete process.env.CLAUDE_TRANSCRIPTS_DIR;
+  });
+
+  test('无新会话：提示 No new sessions to process', async () => {
+    mockReadTranscriptSessions.mockReturnValue([]);
+
+    await updateUserModel({});
+
+    expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('No new sessions to process'));
+    expect(fs.existsSync(STATE_FILE)).toBe(false);
+  });
+
+  test('--json：输出 newSessions 与 new_pattern 变化', async () => {
+    mockReadTranscriptSessions.mockReturnValue([
+      mkSession({ id: 'session-a' }),
+      mkSession({ id: 'session-b' }),
+    ]);
+
+    await updateUserModel({ json: true, dryRun: true });
+
+    const output = lastJsonOutput(consoleSpy);
+    expect(output.newSessions).toBe(2);
+    expect(output.changes).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({
+          type: 'new_pattern',
+          key: '数据库迁移方案需要执行',
+        }),
+      ]),
+    );
+  });
+
+  test('--dry-run：只展示变化，不写 state 文件', async () => {
+    mockReadTranscriptSessions.mockReturnValue([mkSession({ id: 'session-a' })]);
+
+    await updateUserModel({ dryRun: true });
+
+    expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('Processed 1 new sessions'));
+    expect(fs.existsSync(STATE_FILE)).toBe(false);
+  });
+
+  test('默认（非 dry-run）：落盘 state 并记录已处理会话', async () => {
+    mockReadTranscriptSessions.mockReturnValue([mkSession({ id: 'session-a' })]);
+
+    await updateUserModel({});
+
+    expect(fs.existsSync(STATE_FILE)).toBe(true);
+    const state = JSON.parse(fs.readFileSync(STATE_FILE, 'utf-8'));
+    expect(state.sessionsProcessed).toContain('session-a');
+  });
+
+  test('--days 1：只处理最近 1 天的会话', async () => {
+    mockReadTranscriptSessions.mockReturnValue([
+      mkSession({ id: 'today' }),
+      mkSession({
+        id: 'three-days-ago',
+        date: todayStr(3),
+        turns: [
+          { role: 'user', content: '旧会话概念内容测试' },
+          { role: 'assistant', content: '' },
+        ],
+      }),
+    ]);
+
+    await updateUserModel({ json: true, dryRun: true, days: 1 });
+
+    const output = lastJsonOutput(consoleSpy);
+    expect(output.newSessions).toBe(1);
+  });
+
+  test('缺省 --days：处理全部未处理会话（向后兼容）', async () => {
+    mockReadTranscriptSessions.mockReturnValue([
+      mkSession({ id: 'today' }),
+      mkSession({
+        id: 'three-days-ago',
+        date: todayStr(3),
+        turns: [
+          { role: 'user', content: '旧会话概念内容测试' },
+          { role: 'assistant', content: '' },
+        ],
+      }),
+    ]);
+
+    await updateUserModel({ json: true, dryRun: true });
+
+    const output = lastJsonOutput(consoleSpy);
+    expect(output.newSessions).toBe(2);
+  });
+
+  test('sessionsProcessed 去重：已处理会话不重复计入（与 --days 正交）', async () => {
+    fs.writeFileSync(
+      STATE_FILE,
+      JSON.stringify({
+        lastUpdated: '',
+        sessionsProcessed: ['session-a'],
+        patterns: {},
+        lensWeights: {},
+        principleWeights: {},
+        evolutionLog: [],
+      }),
+      'utf-8',
+    );
+    mockReadTranscriptSessions.mockReturnValue([
+      mkSession({ id: 'session-a' }),
+      mkSession({ id: 'session-b' }),
+    ]);
+
+    await updateUserModel({ json: true, dryRun: true, days: 7 });
+
+    const output = lastJsonOutput(consoleSpy);
+    expect(output.newSessions).toBe(1);
+  });
+});

package/src/cli/commands/update-user-model.ts

@@ -28,6 +28,7 @@ import {
 } from '../session-mining';
 
 export interface UpdateUserModelOptions {
+  days?: number;    // 只处理最近 N 天（自然日，含今天）的会话；缺省不过滤（向后兼容）
   json?: boolean;
   dryRun?: boolean;  // don't update state, just show what would change
 }
@@ -58,7 +59,7 @@ export async function updateUserModel(options: UpdateUserModelOptions): Promise<
   const state = loadState();
 
   // 2. Scan new data
-  const newSessions = findNewSessions(transcriptDir, state.sessionsProcessed);
+  const newSessions = findNewSessions(transcriptDir, state.sessionsProcessed, options.days);
   if (newSessions.length === 0) {
     console.log(chalk.gray('No new sessions to process'));
     return;
@@ -137,10 +138,19 @@ interface SimpleSession {
   toolCalls: string[];     // tool names used
 }
 
-function findNewSessions(dir: string, processed: string[]): SimpleSession[] {
-  const sessions = readTranscriptSessions(dir)
-    .filter(s => !processed.includes(s.id))
-    .sort((a, b) => a.date.localeCompare(b.date));
+function findNewSessions(dir: string, processed: string[], days?: number): SimpleSession[] {
+  let sessions = readTranscriptSessions(dir)
+    .filter(s => !processed.includes(s.id));
+
+  // 「最近 N 天」：自然日窗口（含今天）。days<=0 视为不过滤，与缺省一致。
+  if (days !== undefined && days > 0) {
+    const cutoff = new Date(Date.now() - (days - 1) * 86_400_000)
+      .toISOString()
+      .slice(0, 10);
+    sessions = sessions.filter(s => s.date >= cutoff);
+  }
+
+  sessions.sort((a, b) => a.date.localeCompare(b.date));
 
   return sessions.map(s => ({
     id: s.id,

package/src/core/CONTEXT.md

@@ -4,7 +4,7 @@
 约束引擎核心：check/prompt 二元约束系统（ADR-0001）、生效集合并（effective-constraints）、检查点验证器(CSO/passes-gate)、会话管理、Spec 验证器、项目配置加载。
 
 ## 核心导出
-- `constraints/` — 约束定义(IRON_LAWS/GUIDELINES/PROMPTS；TIPS 已退役为空表) + 检查引擎(ConstraintChecker) + 拦截器(ConstraintInterceptor) + 缓存(CheckCache) + 注入渲染(injection-renderer)/漂移校验(injection-drift)/使用统计(usage-report)
+- `constraints/` — 约束定义(IRON_LAWS/GUIDELINES/PROMPTS；TIPS 已退役为空表) + 检查引擎(ConstraintChecker) + 拦截器(ConstraintInterceptor) + 缓存(CheckCache：TTL 缓存 + 计数采样，H6/G5 起公开导出) + 注入渲染(injection-renderer) + Agent prompt 渲染(agent-prompt-renderer：trigger 参数化分组渲染，role 路由留 studio，H6/G6)/漂移校验(injection-drift)/使用统计(usage-report)
 - `effective-constraints.ts` — `getEffectiveConstraints(projectRoot)`：全仓唯一生效集来源（内置 → preset → config.yml 禁用（内置与 custom 同效）→ custom 追加（禁用/已退役的不追加）→ scenes 过滤）；`lintEffectiveConfig` 配置诊断
 - `validators/` — checkpoints、passes-gate、CSO 验证器
 - `session/` — 会话管理