@dommaker/harness 0.17.1 → 0.19.0

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

@@ -111,6 +111,8 @@ describe('init command', () => {
     it('应该输出代码片段模式', async () => {
       await init({ preset: 'standard', printSnippets: true });
       expect(consoleSpy).toHaveBeenCalled();
+      // 打印版与落盘版 plan 匹配模式须一致（#35：模板字面量 \. 运行期退化为 .，防两副本 drift）
+      expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining("grep -E 'plans/.*\\.md$|\\.plan\\.md$'"));
     });
   });
 
@@ -132,6 +134,8 @@ describe('init command', () => {
 
       await init({ preset: 'standard', projectPath: PROJECT });
       expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('pre-commit 已存在'));
+      // 手动添加提示的片段同样 scoped 化（#36）
+      expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('npx @dommaker/harness check --staged'));
     });
 
     it('应该创建 pre-commit hook', async () => {
@@ -143,6 +147,23 @@ describe('init command', () => {
       await init({ preset: 'standard', projectPath: PROJECT });
       expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('已创建 .git/hooks/pre-commit'));
     });
+
+    it('落盘 pre-commit 使用 scoped 包名（#36）', async () => {
+      mockFs.mkdir.mockResolvedValue(undefined);
+      mockFs.writeFile.mockResolvedValue(undefined);
+      existingFiles.add(`${PROJECT}/.git`);
+      existingFiles.add(`${PROJECT}/.git/hooks`);
+
+      await init({ preset: 'standard', projectPath: PROJECT });
+      const writeCalls = mockFs.writeFile.mock.calls;
+      const hookCall = writeCalls.find((c: any[]) => String(c[0]).includes('pre-commit'));
+      expect(hookCall).toBeDefined();
+      expect(hookCall![1]).toContain('npx @dommaker/harness check --staged');
+      expect(hookCall![1]).toContain('npx @dommaker/harness posteval-plan');
+      expect(hookCall![1]).not.toMatch(/npx harness /);
+      // plan 匹配模式须为转义点（#35：模板字面量 \. 运行期退化为 .，与打印版防 drift）
+      expect(hookCall![1]).toContain("grep -E 'plans/.*\\.md$|\\.plan\\.md$'");
+    });
   });
 
   describe('GitHub Actions', () => {
@@ -155,6 +176,20 @@ describe('init command', () => {
       await init({ preset: 'standard', projectPath: PROJECT });
       expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('已存在的 CI 配置'));
     });
+
+    it('落盘 harness-check.yml 使用 scoped 包名（#36）', async () => {
+      mockFs.mkdir.mockResolvedValue(undefined);
+      mockFs.writeFile.mockResolvedValue(undefined);
+
+      await init({ preset: 'standard', projectPath: PROJECT });
+      const writeCalls = mockFs.writeFile.mock.calls;
+      const workflowCall = writeCalls.find((c: any[]) => String(c[0]).includes('harness-check.yml'));
+      expect(workflowCall).toBeDefined();
+      expect(workflowCall![1]).toContain('npx @dommaker/harness check');
+      expect(workflowCall![1]).toContain('npx @dommaker/harness validate');
+      expect(workflowCall![1]).toContain('npx @dommaker/harness passes-gate');
+      expect(workflowCall![1]).not.toMatch(/npx harness /);
+    });
   });
 
   describe('CAPABILITIES.md', () => {
@@ -258,6 +293,10 @@ describe('init command', () => {
       expect(workflowCall).toBeDefined();
       expect(workflowCall![1]).toContain('Harness Governance');
       expect(workflowCall![1]).toContain('harness check');
+      // scoped 包名（#36）
+      expect(workflowCall![1]).toContain('npx @dommaker/harness check');
+      expect(workflowCall![1]).toContain('npx @dommaker/harness passes-gate');
+      expect(workflowCall![1]).not.toMatch(/npx harness /);
     });
 
     it('应该跳过治理 CI workflow 当已存在', async () => {
@@ -277,6 +316,7 @@ describe('init command', () => {
       const writeCalls = mockFs.writeFile.mock.calls;
       const workflowCall = writeCalls.find((c: any[]) => String(c[0]).includes('harness-governance.yml'));
       expect(workflowCall![1]).toContain('sync-docs');
+      expect(workflowCall![1]).toContain('npx @dommaker/harness sync-docs --check');
     });
 
     it('minimal 治理不应在 CI 中包含 docs check', async () => {

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__/status-extra.test.ts

@@ -4,7 +4,6 @@
 
 import { status } from '../status';
 import * as fs from 'fs';
-import { TraceCollector } from '../../../monitoring/traces';
 import { TraceAnalyzer } from '../../../monitoring/trace-analyzer';
 
 // Mock fs
@@ -41,7 +40,6 @@ jest.mock('chalk', () => ({
 }));
 
 const mockFs = fs as jest.Mocked<typeof fs>;
-const MockTraceCollector = TraceCollector as jest.MockedClass<typeof TraceCollector>;
 const MockTraceAnalyzer = TraceAnalyzer as jest.MockedClass<typeof TraceAnalyzer>;
 
 describe('status command - 补充覆盖', () => {

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

@@ -4,7 +4,6 @@
 
 import { status } from '../status';
 import * as fs from 'fs';
-import { TraceCollector } from '../../../monitoring/traces';
 import { TraceAnalyzer } from '../../../monitoring/trace-analyzer';
 
 // Mock fs
@@ -41,7 +40,6 @@ jest.mock('chalk', () => ({
 }));
 
 const mockFs = fs as jest.Mocked<typeof fs>;
-const MockTraceCollector = TraceCollector as jest.MockedClass<typeof TraceCollector>;
 const MockTraceAnalyzer = TraceAnalyzer as jest.MockedClass<typeof TraceAnalyzer>;
 
 describe('status command', () => {

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

@@ -406,6 +406,96 @@ describe('sync-docs command', () => {
       fs.rmSync(testDir, { recursive: true, force: true });
     });
 
+    it('.tsx 登记行指向真实文件时不得误判为已删除（#33），--check 收敛', async () => {
+      const testDir = path.join(tempDir, 'tsx-row');
+      const srcDir = path.join(testDir, 'src', 'components');
+      fs.mkdirSync(srcDir, { recursive: true });
+      // 复刻 studio 场景：同目录混合 .ts 与 .tsx
+      fs.writeFileSync(path.join(srcDir, 'statusClasses.ts'), 'export const statuses = {};');
+      fs.writeFileSync(
+        path.join(srcDir, 'DistillProposalCard.tsx'),
+        'export const DistillProposalCard = () => null;'
+      );
+
+      // 手工登记一行 .tsx 模块（表格格式承诺支持 ts|tsx|js|jsx）
+      fs.writeFileSync(
+        path.join(testDir, 'CAPABILITIES.md'),
+        [
+          '# CAPABILITIES.md', '',
+          '> 最后更新: 2026-01-01', '',
+          '| 模块 | 文件 | 说明 |', '|------|------|------|',
+          '| statusClasses | src/components/statusClasses.ts | 状态类 |',
+          '| DistillProposalCard | src/components/DistillProposalCard.tsx | 人审卡 |',
+          '',
+        ].join('\n')
+      );
+
+      await syncDocs({ projectPath: testDir });
+      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);
+
+      fs.rmSync(testDir, { recursive: true, force: true });
+    });
+
+    it('未登记的 .tsx 源文件应进入 added，写入模式生成表格行', async () => {
+      const testDir = path.join(tempDir, 'tsx-added');
+      const srcDir = path.join(testDir, 'src');
+      fs.mkdirSync(srcDir, { recursive: true });
+      fs.writeFileSync(path.join(srcDir, 'util.ts'), 'export const util = 1;');
+      fs.writeFileSync(path.join(srcDir, 'Card.tsx'), 'export const Card = () => null;');
+
+      fs.writeFileSync(
+        path.join(testDir, 'CAPABILITIES.md'),
+        '# 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'));
+
+      await syncDocs({ projectPath: testDir });
+      const content = fs.readFileSync(path.join(testDir, 'CAPABILITIES.md'), 'utf-8');
+      expect(content).toContain('Card.tsx');
+
+      fs.rmSync(testDir, { recursive: true, force: true });
+    });
+
+    it('真实存在的非扫描扩展名登记行（.js/.jsx）也不得误删（存在性过滤兜底）', async () => {
+      const testDir = path.join(tempDir, 'js-row');
+      const srcDir = path.join(testDir, 'src');
+      fs.mkdirSync(srcDir, { recursive: true });
+      fs.writeFileSync(path.join(srcDir, 'helper.js'), 'module.exports = {};');
+      fs.writeFileSync(path.join(srcDir, 'Helper.jsx'), 'export default () => null;');
+
+      fs.writeFileSync(
+        path.join(testDir, 'CAPABILITIES.md'),
+        [
+          '# CAPABILITIES.md', '',
+          '> 最后更新: 2026-01-01', '',
+          '| 模块 | 文件 | 说明 |', '|------|------|------|',
+          '| helper | src/helper.js | 手工登记 |',
+          '| Helper | src/Helper.jsx | 手工登记 |',
+          '',
+        ].join('\n')
+      );
+
+      await syncDocs({ projectPath: testDir });
+      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);
+
+      fs.rmSync(testDir, { recursive: true, force: true });
+    });
+
     it('basename 碰撞的幽灵条目（文件已删但同名文件存在）也应被移除', async () => {
       const testDir = path.join(tempDir, 'ghost-basename-collision');
       const srcA = path.join(testDir, 'src', 'a');

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/constraints-report.ts

@@ -118,9 +118,9 @@ export function renderExportMarkdown(
 export function renderInjectionDriftLines(drift: InjectionDrift): string[] {
   const lines: string[] = [];
   if (drift.notInjected) {
-    lines.push('  CLAUDE.md 无约束注入标记段（未注入，不算漂移）；可运行 npx harness init 注入');
+    lines.push('  CLAUDE.md 无约束注入标记段（未注入，不算漂移）；可运行 npx @dommaker/harness init 注入');
     if (drift.duplicateHeading) {
-      lines.push('  另检测到多个 "## Governance Rules" 标题（历史遗留重复章节），建议手工清理后重跑 npx harness init');
+      lines.push('  另检测到多个 "## Governance Rules" 标题（历史遗留重复章节），建议手工清理后重跑 npx @dommaker/harness init');
     }
     return lines;
   }