@dommaker/harness 1.3.0 → 1.5.0

package/src/cli/commands/__tests__/sync-docs.test.ts

@@ -3,9 +3,15 @@
  */
 
 import * as fs from 'fs';
+import { captureIO, type CapturingIO } from '../../command-contract';
 import * as path from 'path';
 import { syncDocs } from '../sync-docs';
 
+let io: CapturingIO;
+beforeEach(() => {
+  io = captureIO();
+});
+
 describe('sync-docs command', () => {
   const tempDir = path.join(process.cwd(), 'temp-test-sync-docs');
 
@@ -21,15 +27,8 @@ describe('sync-docs command', () => {
     }
   });
 
-  let consoleSpy: jest.SpyInstance;
-
   beforeEach(() => {
     jest.clearAllMocks();
-    consoleSpy = jest.spyOn(console, 'log').mockImplementation();
-  });
-
-  afterEach(() => {
-    consoleSpy.mockRestore();
   });
 
   describe('generateModuleTable', () => {
@@ -38,11 +37,11 @@ describe('sync-docs command', () => {
       fs.mkdirSync(testDir, { recursive: true });
 
       // No src dir → no modules → nothing to report
-      const result = await syncDocs({ projectPath: testDir });
+      const result = await syncDocs({ projectPath: testDir }, io);
 
-      expect(result).toBe(true);
+      expect(result).toEqual({ kind: 'ok' });
       // When no modules and no changes, all docs are current
-      expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('所有文档'));
+      expect(io.outText()).toContain('所有文档');
 
       fs.rmSync(testDir, { recursive: true, force: true });
     });
@@ -55,7 +54,7 @@ describe('sync-docs command', () => {
       // Create a source file with JSDoc comment
       fs.writeFileSync(path.join(srcDir, 'mymodule.ts'), '/**\n * My test module\n */\nexport const x = 1;');
 
-      await syncDocs({ projectPath: testDir });
+      await syncDocs({ projectPath: testDir }, io);
 
       const capPath = path.join(testDir, 'CAPABILITIES.md');
       const content = fs.readFileSync(capPath, 'utf-8');
@@ -75,7 +74,7 @@ describe('sync-docs command', () => {
 
       fs.writeFileSync(path.join(srcDir, 'jsdoc-mod.ts'), '/**\n * JSDoc module description\n */\nexport const y = 2;');
 
-      await syncDocs({ projectPath: testDir });
+      await syncDocs({ projectPath: testDir }, io);
 
       const capPath = path.join(testDir, 'CAPABILITIES.md');
       const content = fs.readFileSync(capPath, 'utf-8');
@@ -93,7 +92,7 @@ describe('sync-docs command', () => {
       const filePath = path.join(srcDir, 'line-mod.ts');
       fs.writeFileSync(filePath, '// Line comment module\nexport const z = 3;');
 
-      await syncDocs({ projectPath: testDir });
+      await syncDocs({ projectPath: testDir }, io);
 
       const capPath = path.join(testDir, 'CAPABILITIES.md');
       const content = fs.readFileSync(capPath, 'utf-8');
@@ -109,7 +108,7 @@ describe('sync-docs command', () => {
 
       fs.writeFileSync(path.join(srcDir, 'bare.ts'), 'export const a = 1;');
 
-      await syncDocs({ projectPath: testDir });
+      await syncDocs({ projectPath: testDir }, io);
 
       const capPath = path.join(testDir, 'CAPABILITIES.md');
       const content = fs.readFileSync(capPath, 'utf-8');
@@ -120,16 +119,15 @@ describe('sync-docs command', () => {
     });
   });
 
-
   describe('syncDocs', () => {
     it('无 src/ 目录应该跳过模块扫描', async () => {
       const emptyDir = path.join(tempDir, 'empty');
       fs.mkdirSync(emptyDir, { recursive: true });
 
-      const result = await syncDocs({ projectPath: emptyDir });
-      expect(result).toBe(true);
+      const result = await syncDocs({ projectPath: emptyDir }, io);
+      expect(result).toEqual({ kind: 'ok' });
       // 无 src/ 目录，模块扫描返回空，无差异
-      expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('所有文档都是最新的'));
+      expect(io.outText()).toContain('所有文档都是最新的');
 
       fs.rmSync(emptyDir, { recursive: true, force: true });
     });
@@ -142,8 +140,8 @@ describe('sync-docs command', () => {
       // 创建 CAPABILITIES.md，无表格
       fs.writeFileSync(path.join(testDir, 'CAPABILITIES.md'), '# Capabilities\n\nNo table.');
 
-      const result = await syncDocs({ projectPath: testDir });
-      expect(result).toBe(true);
+      const result = await syncDocs({ projectPath: testDir }, io);
+      expect(result).toEqual({ kind: 'ok' });
 
       fs.rmSync(testDir, { recursive: true, force: true });
     });
@@ -162,9 +160,9 @@ describe('sync-docs command', () => {
         '# Capabilities\n\n| 模块 | 文件 | 说明 |\n|------|------|------|\n| old | src/old.ts | old |'
       );
 
-      const result = await syncDocs({ projectPath: testDir, check: true });
-      expect(result).toBe(false);
-      expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('文档不是最新的'));
+      const result = await syncDocs({ projectPath: testDir, check: true }, io);
+      expect(result).toEqual({ kind: 'fail', reason: expect.stringContaining('文档不是最新') });
+      expect(io.outText()).toContain('文档不是最新的');
 
       fs.rmSync(testDir, { recursive: true, force: true });
     });
@@ -183,15 +181,15 @@ describe('sync-docs command', () => {
       );
 
       // 第一轮：生成 CAPABILITIES.md（描述行以 / 结尾）
-      await syncDocs({ projectPath: testDir });
+      await syncDocs({ projectPath: testDir }, io);
       const cap = fs.readFileSync(path.join(testDir, 'CAPABILITIES.md'), 'utf-8');
       expect(cap).toContain('workspace.ts');
       expect(cap).toMatch(/gitRepo\s*\/\s*\|/);
 
       // 第二轮：生成后立即 --check 必须收敛（修复前此处必 false）
-      consoleSpy.mockClear();
-      const check = await syncDocs({ projectPath: testDir, check: true });
-      expect(check).toBe(true);
+      io = captureIO();
+      const check = await syncDocs({ projectPath: testDir, check: true }, io);
+      expect(check).toEqual({ kind: 'ok' });
 
       fs.rmSync(testDir, { recursive: true, force: true });
     });
@@ -210,8 +208,8 @@ describe('sync-docs command', () => {
       );
 
       // src/ 目录条目覆盖 mymodule.ts → 无 added，check 通过
-      const result = await syncDocs({ projectPath: testDir, check: true });
-      expect(result).toBe(true);
+      const result = await syncDocs({ projectPath: testDir, check: true }, io);
+      expect(result).toEqual({ kind: 'ok' });
 
       fs.rmSync(testDir, { recursive: true, force: true });
     });
@@ -239,9 +237,9 @@ describe('sync-docs command', () => {
 
       // 不创建 CONTEXT.md
 
-      const result = await syncDocs({ projectPath: testDir });
-      expect(result).toBe(false);
-      expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('缺少 CONTEXT.md'));
+      const result = await syncDocs({ projectPath: testDir }, io);
+      expect(result).toEqual({ kind: 'ok' });
+      expect(io.outText()).toContain('缺少 CONTEXT.md');
 
       fs.rmSync(testDir, { recursive: true, force: true });
     });
@@ -269,8 +267,8 @@ describe('sync-docs command', () => {
       // 创建 CONTEXT.md
       fs.writeFileSync(path.join(srcDir, 'CONTEXT.md'), '# src\n\nTest context');
 
-      const result = await syncDocs({ projectPath: testDir });
-      expect(result).toBe(true);
+      const result = await syncDocs({ projectPath: testDir }, io);
+      expect(result).toEqual({ kind: 'ok' });
 
       fs.rmSync(testDir, { recursive: true, force: true });
     });
@@ -281,8 +279,8 @@ describe('sync-docs command', () => {
 
       // 无 .harness/config.yml
 
-      const result = await syncDocs({ projectPath: testDir });
-      expect(result).toBe(true);
+      const result = await syncDocs({ projectPath: testDir }, io);
+      expect(result).toEqual({ kind: 'ok' });
 
       fs.rmSync(testDir, { recursive: true, force: true });
     });
@@ -307,7 +305,7 @@ describe('sync-docs command', () => {
         })
       );
 
-      await syncDocs({ projectPath: testDir });
+      await syncDocs({ projectPath: testDir }, io);
 
       // 验证 CONTEXT.md 被创建
       const contextPath = path.join(srcDir, 'CONTEXT.md');
@@ -326,7 +324,7 @@ describe('sync-docs command', () => {
       // 创建源文件
       fs.writeFileSync(path.join(srcDir, 'module.ts'), 'export const x = 1;');
 
-      await syncDocs({ projectPath: testDir });
+      await syncDocs({ projectPath: testDir }, io);
 
       // 验证 CAPABILITIES.md 被创建
       const capPath = path.join(testDir, 'CAPABILITIES.md');
@@ -346,11 +344,11 @@ describe('sync-docs command', () => {
         '# Capabilities\n\n| 模块 | 文件 | 说明 |\n|------|------|------|\n| old | src/old.ts | old |'
       );
 
-      const result = await syncDocs({ projectPath: testDir, check: true, json: true });
-      expect(result).toBe(false);
+      const result = await syncDocs({ projectPath: testDir, check: true, json: true }, io);
+      expect(result).toEqual({ kind: 'fail', reason: expect.stringContaining('文档不是最新') });
 
       // 验证 console.log 被调用了 JSON
-      const jsonCall = consoleSpy.mock.calls.find(
+      const jsonCall = io.outRecords().map(chunk => [chunk] as string[]).find(
         (call: unknown[]) => typeof call[0] === 'string' && call[0].startsWith('{')
       );
       expect(jsonCall).toBeDefined();
@@ -366,10 +364,10 @@ describe('sync-docs command', () => {
       fs.mkdirSync(testDir, { recursive: true });
       fs.writeFileSync(path.join(testDir, 'CAPABILITIES.md'), '# Capabilities\n\nNo table.');
 
-      const result = await syncDocs({ projectPath: testDir, check: true, json: true });
-      expect(result).toBe(true);
+      const result = await syncDocs({ projectPath: testDir, check: true, json: true }, io);
+      expect(result).toEqual({ kind: 'ok' });
 
-      const jsonCall = consoleSpy.mock.calls.find(
+      const jsonCall = io.outRecords().map(chunk => [chunk] as string[]).find(
         (call: unknown[]) => typeof call[0] === 'string' && call[0].startsWith('{')
       );
       expect(jsonCall).toBeDefined();
@@ -389,7 +387,7 @@ describe('sync-docs command', () => {
       fs.writeFileSync(path.join(srcDir, 'removed.ts'), 'export const removed = 1;');
 
       // 先让 syncDocs 创建初始 CAPABILITIES.md（包含两个文件）
-      await syncDocs({ projectPath: testDir });
+      await syncDocs({ projectPath: testDir }, io);
       let content = fs.readFileSync(path.join(testDir, 'CAPABILITIES.md'), 'utf-8');
       expect(content).toContain('kept.ts');
       expect(content).toContain('removed.ts');
@@ -398,7 +396,7 @@ describe('sync-docs command', () => {
       fs.unlinkSync(path.join(srcDir, 'removed.ts'));
 
       // 重新运行 syncDocs（写入模式）
-      await syncDocs({ projectPath: testDir });
+      await syncDocs({ projectPath: testDir }, io);
       content = fs.readFileSync(path.join(testDir, 'CAPABILITIES.md'), 'utf-8');
       expect(content).toContain('kept.ts');
       expect(content).not.toContain('removed.ts');
@@ -430,14 +428,14 @@ describe('sync-docs command', () => {
         ].join('\n')
       );
 
-      await syncDocs({ projectPath: testDir });
+      await syncDocs({ projectPath: testDir }, io);
       const content = fs.readFileSync(path.join(testDir, 'CAPABILITIES.md'), 'utf-8');
       expect(content).toContain('DistillProposalCard.tsx');
 
       // 修复前：--check 每跑必报「包含已删除的模块」不收敛
-      consoleSpy.mockClear();
-      const check = await syncDocs({ projectPath: testDir, check: true });
-      expect(check).toBe(true);
+      io = captureIO();
+      const check = await syncDocs({ projectPath: testDir, check: true }, io);
+      expect(check).toEqual({ kind: 'ok' });
 
       fs.rmSync(testDir, { recursive: true, force: true });
     });
@@ -454,11 +452,11 @@ describe('sync-docs command', () => {
         '# Capabilities\n\n| 模块 | 文件 | 说明 |\n|------|------|------|\n| util | src/util.ts | util |'
       );
 
-      const check = await syncDocs({ projectPath: testDir, check: true });
-      expect(check).toBe(false);
-      expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('Card.tsx'));
+      const check = await syncDocs({ projectPath: testDir, check: true }, io);
+      expect(check).toEqual({ kind: 'fail', reason: expect.stringContaining('文档不是最新') });
+      expect(io.outText()).toContain('Card.tsx');
 
-      await syncDocs({ projectPath: testDir });
+      await syncDocs({ projectPath: testDir }, io);
       const content = fs.readFileSync(path.join(testDir, 'CAPABILITIES.md'), 'utf-8');
       expect(content).toContain('Card.tsx');
 
@@ -484,14 +482,14 @@ describe('sync-docs command', () => {
         ].join('\n')
       );
 
-      await syncDocs({ projectPath: testDir });
+      await syncDocs({ projectPath: testDir }, io);
       const content = fs.readFileSync(path.join(testDir, 'CAPABILITIES.md'), 'utf-8');
       expect(content).toContain('src/helper.js');
       expect(content).toContain('src/Helper.jsx');
 
-      consoleSpy.mockClear();
-      const check = await syncDocs({ projectPath: testDir, check: true });
-      expect(check).toBe(true);
+      io = captureIO();
+      const check = await syncDocs({ projectPath: testDir, check: true }, io);
+      expect(check).toEqual({ kind: 'ok' });
 
       fs.rmSync(testDir, { recursive: true, force: true });
     });
@@ -518,7 +516,7 @@ describe('sync-docs command', () => {
         ].join('\n'),
       );
 
-      await syncDocs({ projectPath: testDir });
+      await syncDocs({ projectPath: testDir }, io);
       const content = fs.readFileSync(path.join(testDir, 'CAPABILITIES.md'), 'utf-8');
       expect(content).toContain('src/a/routes.ts');
       expect(content).not.toContain('src/ghost/routes.ts');
@@ -551,9 +549,9 @@ describe('sync-docs command', () => {
         '# Capabilities\n\n| 模块 | 文件 | 说明 |\n|------|------|------|\n| 核心 | src/core/ | 核心模块 |'
       );
 
-      const result = await syncDocs({ projectPath: testDir });
+      const result = await syncDocs({ projectPath: testDir }, io);
       // 有未覆盖目录，仍报不同步
-      expect(result).toBe(false);
+      expect(result).toEqual({ kind: 'ok' });
       // 但不自动给 b.ts 加表格行
       const content = fs.readFileSync(path.join(testDir, 'CAPABILITIES.md'), 'utf-8');
       expect(content).not.toContain('b.ts');
@@ -575,10 +573,10 @@ describe('sync-docs command', () => {
         '# Capabilities\n\n| 模块 | 文件 | 说明 |\n|------|------|------|\n| 核心 | src/core/ | 核心模块 |'
       );
 
-      const result = await syncDocs({ projectPath: testDir, check: true });
-      expect(result).toBe(false);
-      expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('未登记以下模块（目录）'));
-      expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('src/newdir/'));
+      const result = await syncDocs({ projectPath: testDir, check: true }, io);
+      expect(result).toEqual({ kind: 'fail', reason: expect.stringContaining('文档不是最新') });
+      expect(io.outText()).toContain('未登记以下模块（目录）');
+      expect(io.outText()).toContain('src/newdir/');
 
       fs.rmSync(testDir, { recursive: true, force: true });
     });
@@ -596,10 +594,10 @@ describe('sync-docs command', () => {
         '# Capabilities\n\n| 模块 | 文件 | 说明 |\n|------|------|------|\n| 核心 | src/core/ | 核心模块 |'
       );
 
-      const result = await syncDocs({ projectPath: testDir, check: true, json: true });
-      expect(result).toBe(false);
+      const result = await syncDocs({ projectPath: testDir, check: true, json: true }, io);
+      expect(result).toEqual({ kind: 'fail', reason: expect.stringContaining('文档不是最新') });
 
-      const jsonCall = consoleSpy.mock.calls.find(
+      const jsonCall = io.outRecords().map(chunk => [chunk] as string[]).find(
         (call: unknown[]) => typeof call[0] === 'string' && call[0].startsWith('{')
       );
       expect(jsonCall).toBeDefined();
@@ -628,7 +626,7 @@ describe('sync-docs command', () => {
         ].join('\n')
       );
 
-      await syncDocs({ projectPath: testDir });
+      await syncDocs({ projectPath: testDir }, io);
       const content = fs.readFileSync(path.join(testDir, 'CAPABILITIES.md'), 'utf-8');
       expect(content).toContain('src/a/kept.ts');
       expect(content).not.toContain('ghost.ts');
@@ -658,8 +656,8 @@ describe('sync-docs command', () => {
         ].join('\n')
       );
 
-      const result = await syncDocs({ projectPath: testDir, compact: true });
-      expect(result).toBe(true);
+      const result = await syncDocs({ projectPath: testDir, compact: true }, io);
+      expect(result).toEqual({ kind: 'ok' });
 
       const content = fs.readFileSync(path.join(testDir, 'CAPABILITIES.md'), 'utf-8');
       // 折叠为目录条目（说明取组内第一行）
@@ -672,7 +670,7 @@ describe('sync-docs command', () => {
       expect(content).toContain('手工说明');
 
       // 幂等：再跑一遍内容不变
-      await syncDocs({ projectPath: testDir, compact: true });
+      await syncDocs({ projectPath: testDir, compact: true }, io);
       const content2 = fs.readFileSync(path.join(testDir, 'CAPABILITIES.md'), 'utf-8');
       expect(content2).toBe(content);
 
@@ -683,8 +681,8 @@ describe('sync-docs command', () => {
       const testDir = path.join(tempDir, 'compact-missing');
       fs.mkdirSync(testDir, { recursive: true });
 
-      const result = await syncDocs({ projectPath: testDir, compact: true });
-      expect(result).toBe(false);
+      const result = await syncDocs({ projectPath: testDir, compact: true }, io);
+      expect(result).toEqual({ kind: 'ok' });
 
       fs.rmSync(testDir, { recursive: true, force: true });
     });

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

@@ -8,8 +8,9 @@
  */
 
 import * as fs from 'fs';
+import { captureIO, lastJsonOutput, type CapturingIO } from '../../command-contract';
 import * as path from 'path';
-import { updateUserModel } from '../update-user-model';
+import { updateUserModel, resolveUserModelPaths } from '../update-user-model';
 import { readTranscriptSessions, type MinedSession } from '../../session-mining';
 
 const TEST_HOME = '/tmp/harness-uum-test-home';
@@ -53,6 +54,7 @@ const mockReadTranscriptSessions = readTranscriptSessions as jest.MockedFunction
 >;
 
 const STATE_FILE = path.join(TEST_HOME, '.claude', 'user-model-state.json');
+const PROFILE_FILE = path.join(TEST_HOME, '.claude', 'projects', '-root-projects', 'memory', 'user_profile.md');
 
 function todayStr(offsetDays = 0): string {
   return new Date(Date.now() - offsetDays * 86_400_000).toISOString().slice(0, 10);
@@ -72,33 +74,63 @@ function mkSession(partial: Partial<MinedSession> = {}): MinedSession {
   };
 }
 
-function lastJsonOutput(consoleSpy: jest.SpyInstance): Record<string, unknown> {
-  const jsonLine = consoleSpy.mock.calls.map(c => c[0]).join('\n');
-  return JSON.parse(jsonLine);
-}
+let io: CapturingIO;
+beforeEach(() => {
+  io = captureIO();
+});
 
 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;
+    delete process.env.HARNESS_UUM_STATE_FILE;
+    delete process.env.HARNESS_UUM_PROFILE_FILE;
+  });
+
+  // 路径解析（harness#116）：默认值保持原行为，env 覆盖生效
+  test('resolveUserModelPaths 默认：homedir 下的原路径（现行为不变）', () => {
+    expect(resolveUserModelPaths({})).toEqual({
+      stateFile: STATE_FILE,
+      profileFile: PROFILE_FILE,
+    });
+  });
+
+  test('resolveUserModelPaths env 覆盖：HARNESS_UUM_STATE_FILE / HARNESS_UUM_PROFILE_FILE', () => {
+    expect(resolveUserModelPaths({
+      HARNESS_UUM_STATE_FILE: '/custom/state.json',
+      HARNESS_UUM_PROFILE_FILE: '/custom/profile.md',
+    })).toEqual({
+      stateFile: '/custom/state.json',
+      profileFile: '/custom/profile.md',
+    });
+  });
+
+  test('env 覆盖端到端：state 落 env 指定路径，不写默认路径', async () => {
+    const customState = path.join(TEST_HOME, 'custom', 'state.json');
+    process.env.HARNESS_UUM_STATE_FILE = customState;
+    mockReadTranscriptSessions.mockReturnValue([mkSession({ id: 'session-a' })]);
+
+    await updateUserModel({}, io);
+
+    expect(fs.existsSync(customState)).toBe(true);
+    expect(fs.existsSync(STATE_FILE)).toBe(false);
+    const state = JSON.parse(fs.readFileSync(customState, 'utf-8'));
+    expect(state.sessionsProcessed).toContain('session-a');
   });
 
   test('无新会话：提示 No new sessions to process', async () => {
     mockReadTranscriptSessions.mockReturnValue([]);
 
-    await updateUserModel({});
+    await updateUserModel({}, io);
 
-    expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('No new sessions to process'));
+    expect(io.outText()).toContain('No new sessions to process');
     expect(fs.existsSync(STATE_FILE)).toBe(false);
   });
 
@@ -108,9 +140,9 @@ describe('update-user-model command', () => {
       mkSession({ id: 'session-b' }),
     ]);
 
-    await updateUserModel({ json: true, dryRun: true });
+    await updateUserModel({ json: true, dryRun: true }, io);
 
-    const output = lastJsonOutput(consoleSpy);
+    const output = lastJsonOutput(io);
     expect(output.newSessions).toBe(2);
     expect(output.changes).toEqual(
       expect.arrayContaining([
@@ -125,23 +157,37 @@ describe('update-user-model command', () => {
   test('--dry-run：只展示变化，不写 state 文件', async () => {
     mockReadTranscriptSessions.mockReturnValue([mkSession({ id: 'session-a' })]);
 
-    await updateUserModel({ dryRun: true });
+    await updateUserModel({ dryRun: true }, io);
 
-    expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('Processed 1 new sessions'));
+    expect(io.outText()).toContain('Processed 1 new sessions');
     expect(fs.existsSync(STATE_FILE)).toBe(false);
   });
 
   test('默认（非 dry-run）：落盘 state 并记录已处理会话', async () => {
     mockReadTranscriptSessions.mockReturnValue([mkSession({ id: 'session-a' })]);
 
-    await updateUserModel({});
+    await updateUserModel({}, io);
 
     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 () => {
+  test('--days 1：since 过滤下推到 seam（自然日窗口，含今天）', async () => {
+    mockReadTranscriptSessions.mockReturnValue([mkSession({ id: 'today' })]);
+
+    await updateUserModel({ json: true, dryRun: true, days: 1 }, io);
+
+    const output = lastJsonOutput(io);
+    expect(output.newSessions).toBe(1);
+    // date >= 今日 ⟺ mtimeMs >= 今日 UTC 零点，过滤在 seam 内 stat 级完成
+    expect(mockReadTranscriptSessions).toHaveBeenCalledWith(
+      process.env.CLAUDE_TRANSCRIPTS_DIR,
+      { excludeIds: [], since: Date.parse(todayStr()) },
+    );
+  });
+
+  test('缺省 --days：处理全部未处理会话（向后兼容）', async () => {
     mockReadTranscriptSessions.mockReturnValue([
       mkSession({ id: 'today' }),
       mkSession({
@@ -154,32 +200,48 @@ describe('update-user-model command', () => {
       }),
     ]);
 
-    await updateUserModel({ json: true, dryRun: true, days: 1 });
+    await updateUserModel({ json: true, dryRun: true }, io);
 
-    const output = lastJsonOutput(consoleSpy);
-    expect(output.newSessions).toBe(1);
+    const output = lastJsonOutput(io);
+    expect(output.newSessions).toBe(2);
+    // 缺省 days：不下推 since（向后兼容全量）
+    expect(mockReadTranscriptSessions).toHaveBeenCalledWith(
+      process.env.CLAUDE_TRANSCRIPTS_DIR,
+      { excludeIds: [] },
+    );
   });
 
-  test('缺省 --days：处理全部未处理会话（向后兼容）', async () => {
+  test('同一 concept 只计一次：occurrences 等于 merged 聚合值（#113 双计 bug）', async () => {
+    mockReadTranscriptSessions.mockReturnValue([mkSession({ id: 'session-a' })]);
+
+    await updateUserModel({}, io);
+
+    const state = JSON.parse(fs.readFileSync(STATE_FILE, 'utf-8'));
+    // userText 整条中文序列恰为一个 concept（count=1）；聚合后只应出现一次，
+    // 双计 bug 下会被 merged 循环 + per-session 循环各加一次变成 2
+    expect(state.patterns['数据库迁移方案需要执行'].occurrences).toBe(1);
+    expect(state.patterns['数据库迁移方案需要执行'].sessions).toEqual(['session-a']);
+  });
+
+  test('correction phrase 的 ×3 加权不受影响（buildMergedConcepts 内）', async () => {
     mockReadTranscriptSessions.mockReturnValue([
-      mkSession({ id: 'today' }),
       mkSession({
-        id: 'three-days-ago',
-        date: todayStr(3),
+        id: 'session-a',
         turns: [
-          { role: 'user', content: '旧会话概念内容测试' },
+          { role: 'user', content: '这种问题反复出现' },
           { role: 'assistant', content: '' },
         ],
       }),
     ]);
 
-    await updateUserModel({ json: true, dryRun: true });
+    await updateUserModel({}, io);
 
-    const output = lastJsonOutput(consoleSpy);
-    expect(output.newSessions).toBe(2);
+    const state = JSON.parse(fs.readFileSync(STATE_FILE, 'utf-8'));
+    // 纠正语句提取的 concept 按 ×3 计入（裁决：权重在 buildMergedConcepts，删循环不影响）
+    expect(state.patterns['这种问题'].occurrences).toBe(3);
   });
 
-  test('sessionsProcessed 去重：已处理会话不重复计入（与 --days 正交）', async () => {
+  test('sessionsProcessed 去重：已处理会话经 excludeIds 下推排除', async () => {
     fs.writeFileSync(
       STATE_FILE,
       JSON.stringify({
@@ -192,14 +254,15 @@ describe('update-user-model command', () => {
       }),
       'utf-8',
     );
-    mockReadTranscriptSessions.mockReturnValue([
-      mkSession({ id: 'session-a' }),
-      mkSession({ id: 'session-b' }),
-    ]);
+    mockReadTranscriptSessions.mockReturnValue([mkSession({ id: 'session-b' })]);
 
-    await updateUserModel({ json: true, dryRun: true, days: 7 });
+    await updateUserModel({ json: true, dryRun: true, days: 7 }, io);
 
-    const output = lastJsonOutput(consoleSpy);
+    const output = lastJsonOutput(io);
     expect(output.newSessions).toBe(1);
+    expect(mockReadTranscriptSessions).toHaveBeenCalledWith(
+      process.env.CLAUDE_TRANSCRIPTS_DIR,
+      { excludeIds: ['session-a'], since: expect.any(Number) },
+    );
   });
 });