@dommaker/harness 0.14.0 → 0.16.0

package/dist/types/constraint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constraint.d.ts","sourceRoot":"","sources":["../../src/types/constraint.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"constraint.d.ts","sourceRoot":"","sources":["../../src/types/constraint.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dommaker/harness",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "通用工程约束框架 - 铁律系统、检查点验证、测试门控、拦截器",
   "keywords": [
     "harness",

package/src/__tests__/checker.test.ts

@@ -1113,19 +1113,19 @@ describe('ConstraintChecker', () => {
       expect(result.satisfied).toBe(false);
     });
 
-    it('must_use_worktree should pass with worktree', async () => {
+    it('prefer_worktree should pass with worktree', async () => {
       const context: ConstraintContext = { operation: 'code_implementation', hasWorktree: true };
       const result = await checker.check(
-        { id: 'must_use_worktree', level: 'iron_law', rule: 'WORKTREE', message: 'test', trigger: 'code_implementation', enforcement: 'test' },
+        { id: 'prefer_worktree', level: 'guideline', rule: 'WORKTREE', message: 'test', trigger: 'code_implementation', enforcement: 'test' },
         context
       );
       expect(result.satisfied).toBe(true);
     });
 
-    it('must_use_worktree should fail without worktree', async () => {
+    it('prefer_worktree should fail without worktree', async () => {
       const context: ConstraintContext = { operation: 'code_implementation', hasWorktree: false };
       const result = await checker.check(
-        { id: 'must_use_worktree', level: 'iron_law', rule: 'WORKTREE', message: 'test', trigger: 'code_implementation', enforcement: 'test' },
+        { id: 'prefer_worktree', level: 'guideline', rule: 'WORKTREE', message: 'test', trigger: 'code_implementation', enforcement: 'test' },
         context
       );
       expect(result.satisfied).toBe(false);

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

@@ -68,7 +68,7 @@ describe('getKnowledgeDir', () => {
 
   beforeEach(() => {
     delete process.env.KNOWLEDGE_BASE_DIR;
-    storeCtorSpy = jest.spyOn(storeModule, 'KnowledgeStore').mockImplementation(() => ({
+    storeCtorSpy = jest.spyOn(storeModule, 'FileKnowledgeStore').mockImplementation(() => ({
       list: jest.fn().mockReturnValue([]),
     }));
   });

package/src/cli/commands/knowledge.ts

@@ -8,7 +8,7 @@ import chalk from 'chalk';
 import * as fs from 'fs';
 import * as os from 'os';
 import * as path from 'path';
-import { KnowledgeStore } from '../../knowledge/store';
+import { FileKnowledgeStore as KnowledgeStore } from '../../knowledge/store';
 import { KnowledgeQuery } from '../../knowledge/query';
 import { KnowledgeLifecycle } from '../../knowledge/lifecycle';
 import { ColdStartImporter } from '../../knowledge/import';

package/src/cli/commands/release.ts

@@ -44,7 +44,26 @@ export async function release(options: ReleaseOptions): Promise<void> {
   console.log(chalk.cyan(`📦 ${pkgName}@${oldVersion}`));
   console.log(chalk.cyan(`   bump: ${bumpType}${dryRun ? ' (dry-run)' : ''}`));
 
-  // ── 2. Check clean working tree ──
+  // ── 2. Check branch (must be on master/main) ──
+  const branchResult = await run('git rev-parse --abbrev-ref HEAD', pkgPath);
+  const currentBranch = branchResult.stdout.trim();
+  if (currentBranch !== 'master' && currentBranch !== 'main') {
+    console.error(chalk.red(`❌ Must be on master or main branch to release. Currently on: ${currentBranch}`));
+    console.error(chalk.gray('   Run: git checkout master && git merge ' + currentBranch));
+    process.exit(1);
+  }
+  console.log(chalk.green(`✅ git: on ${currentBranch}`));
+
+  // ── 2b. Check remote sync ──
+  await run('git fetch origin', pkgPath, 15_000);
+  const behind = await run(`git rev-list --count HEAD..origin/${currentBranch}`, pkgPath);
+  if (behind.stdout.trim() !== '0') {
+    console.error(chalk.red(`❌ Local ${currentBranch} is ${behind.stdout.trim()} commits behind origin/${currentBranch}. Pull first.`));
+    process.exit(1);
+  }
+  console.log(chalk.green('✅ git: synced with remote'));
+
+  // ── 2c. Check clean working tree ──
   const stat = await run('git status --porcelain -uno', pkgPath);
   if (stat.stdout.length > 0) {
     console.error(chalk.red('❌ Uncommitted changes. Commit or stash before releasing.'));
@@ -98,6 +117,18 @@ export async function release(options: ReleaseOptions): Promise<void> {
   // ── 5. Bump version (npm version creates git commit + tag atomically,
   //     including package-lock.json — no desync possible) ──
   console.log(chalk.cyan('🔢 Bumping version...'));
+  const [major, minor, patch] = oldVersion.split('.').map(Number);
+  let expectedNew: string;
+  if (bumpType === 'major') expectedNew = `${major + 1}.0.0`;
+  else if (bumpType === 'minor') expectedNew = `${major}.${minor + 1}.0`;
+  else expectedNew = `${major}.${minor}.${patch + 1}`;
+  const expectedTag = `v${expectedNew}`;
+  const tagExists = await run(`git tag -l "${expectedTag}"`, pkgPath);
+  if (tagExists.stdout.trim() === expectedTag) {
+    console.error(chalk.red(`❌ Tag ${expectedTag} already exists. Version may have been released already.`));
+    process.exit(1);
+  }
+
   const bump = await run(`npm version ${bumpType} -m "release: %s"`, pkgPath);
   if (bump.stderr && !bump.stdout) {
     console.error(chalk.red('❌ npm version failed:'), bump.stderr);
@@ -107,10 +138,9 @@ export async function release(options: ReleaseOptions): Promise<void> {
   const tag = `v${newVersion}`;
   console.log(chalk.green(`✅ version: ${oldVersion} → ${newVersion} (committed + tagged)`));
 
-  // ── 7. Push ──
+  // ── 6. Push ──
   console.log(chalk.cyan('⬆️  Pushing...'));
-  const branch = await run('git rev-parse --abbrev-ref HEAD', pkgPath);
-  const push = await run(`git push origin ${branch.stdout}`, pkgPath, 30_000);
+  const push = await run(`git push origin ${currentBranch}`, pkgPath, 30_000);
   if (push.stderr && push.stderr.includes('error')) {
     console.error(chalk.red('❌ git push failed:'), push.stderr.slice(0, 500));
     process.exit(1);
@@ -118,7 +148,15 @@ export async function release(options: ReleaseOptions): Promise<void> {
   await run(`git push origin ${tag}`, pkgPath, 30_000);
   console.log(chalk.green('✅ git: pushed'));
 
-  // ── 8. npm publish ──
+  // ── 8. Check private flag ──
+  if (pkgJson.private) {
+    console.error(chalk.red('❌ package.json has "private": true. Remove it before publishing.'));
+    console.error(chalk.gray('   The release tool will NOT auto-remove private flag.'));
+    process.exit(1);
+  }
+  console.log(chalk.green('✅ package: not private'));
+
+  // ── 7. npm publish ──
   // Switch to npmjs.org for publishing (npmmirror is read-only mirror)
   const origRegistry = await run('npm config get registry', pkgPath);
   await run('npm config set registry https://registry.npmjs.org/', pkgPath);
@@ -136,7 +174,7 @@ export async function release(options: ReleaseOptions): Promise<void> {
     process.exit(1);
   }
 
-  // ── 9. GitHub Release ──
+  // ── 8. GitHub Release ──
   console.log(chalk.cyan('🐙 Creating GitHub Release...'));
   const gh = await run(`gh release create ${tag} --generate-notes`, pkgPath, 30_000);
   if (gh.stderr && gh.stderr.includes('already exists')) {

package/src/context/__tests__/knowledge-injector.test.ts

@@ -4,7 +4,7 @@
 
 import { KnowledgeInjector } from '../knowledge-injector';
 import { KnowledgeQuery } from '../../knowledge/query';
-import { KnowledgeStore } from '../../knowledge/store';
+import { FileKnowledgeStore as KnowledgeStore } from '../../knowledge/store';
 import * as fs from 'fs';
 import * as path from 'path';
 import * as os from 'os';

package/src/core/constraints/checker.ts

@@ -256,7 +256,7 @@ export class ConstraintChecker {
         // 检查是否有需求文档
         return context.hasRequirement === true;
 
-      case 'must_use_worktree':
+      case 'prefer_worktree':
         // 检查是否在 worktree 中执行
         return context.hasWorktree === true;
 

package/src/core/constraints/definitions.ts

@@ -238,31 +238,6 @@ https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agent
     promptInjection: '开始编写代码前，必须确认：需求来源明确（Spec/Issue/Roadmap/用户指令）、验收标准(AC)已定义、边界情况已明确。不要凭假设或猜测开始实现。',
   },
 
-  /**
-   * 必须在 worktree 中开发
-   * 原因：隔离工作区，安全回滚，并行开发
-   * 来源：Superpowers must_use_worktree
-   */
-  must_use_worktree: {
-    id: 'must_use_worktree',
-    rule: 'CODE CHANGES MUST BE ISOLATED IN A WORKTREE',
-    message: '代码开发必须在隔离的 worktree 中进行',
-    level: 'iron_law',
-    trigger: ['code_implementation'],
-    enforcement: 'check-worktree',
-    description: `所有代码修改必须在隔离的 worktree 中进行，不要在原始仓库目录直接编辑。
-
-【原因】
-- 隔离风险：worktree 中的改动不会影响主工作区
-- 安全回滚：删除 worktree 即可放弃改动
-- 并行开发：多个任务可同时在不同 worktree 中进行
-
-【禁止】
-- 在原始仓库目录直接编辑文件
-- 跳过 worktree 创建直接执行 Agent`,
-    promptInjection: '所有代码修改必须在隔离的 worktree 中进行。不要在原始仓库目录直接编辑文件。worktree 提供了安全回滚和并行开发能力。如果你发现不在 worktree 中，立即停止并要求创建 worktree。',
-  },
-
   /**
    * 禁止模糊完成声明
    * 原因：质量底线，必须有可量化证据
@@ -371,6 +346,37 @@ https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agent
 // ========================================
 
 export const GUIDELINES: Record<string, Constraint> = {
+  /**
+   * 高风险改动优先使用 worktree
+   * 原因：隔离工作区，安全回滚，并行开发
+   * 来源：Superpowers prefer_worktree
+   */
+  prefer_worktree: {
+    id: 'prefer_worktree',
+    rule: 'USE WORKTREE FOR HIGH-RISK CHANGES',
+    message: '高风险改动应在 worktree 中进行',
+    level: 'guideline',
+    trigger: ['code_implementation'],
+    enforcement: 'check-worktree',
+    description: `高风险改动应在隔离的 worktree 中进行。
+
+【何时需要 worktree】
+- 新功能开发（新增模块/API）
+- 跨模块改动（>3 文件）
+- 基础设施变更（CI/CD、依赖）
+
+【何时不需要】
+- 配置文件修改
+- 单文件 bug fix
+- 外科手术式修复（typo、missing import）
+
+【原因】
+- 隔离风险：worktree 中的改动不会影响主工作区
+- 安全回滚：删除 worktree 即可放弃改动
+- 并行开发：多个任务可同时在不同 worktree 中进行`,
+    promptInjection: '高风险改动（新功能、跨模块、基础设施）应在 worktree 中进行。配置修改、单文件 fix 可直接编辑。',
+  },
+
   /**
    * 禁止无调查修复 bug
    * 例外：简单 typo、配置错误

package/src/knowledge/__tests__/audit.test.ts

@@ -14,7 +14,7 @@ import * as fs from 'fs';
 import * as path from 'path';
 import * as os from 'os';
 import { KnowledgeAudit } from '../audit';
-import { KnowledgeStore } from '../store';
+import { FileKnowledgeStore as KnowledgeStore } from '../store';
 import type { KnowledgeEntry } from '../types';
 
 function makeTmpDir(): string {

package/src/knowledge/__tests__/doctor.test.ts

@@ -4,7 +4,7 @@
 
 import * as fs from 'fs';
 import * as path from 'path';
-import { KnowledgeStore } from '../store';
+import { FileKnowledgeStore as KnowledgeStore } from '../store';
 import { KnowledgeLinter, type LintReport } from '../lint';
 import { ReferenceTracker } from '../reference-tracker';
 import { KnowledgeHealthScorer } from '../doctor';

package/src/knowledge/__tests__/import.test.ts

@@ -3,7 +3,7 @@
  */
 
 import { ColdStartImporter } from '../import';
-import { KnowledgeStore } from '../store';
+import { FileKnowledgeStore as KnowledgeStore } from '../store';
 import * as fs from 'fs';
 import * as path from 'path';
 import * as os from 'os';

package/src/knowledge/__tests__/ingest.test.ts

@@ -3,7 +3,7 @@
  */
 
 import { describe, it, expect, beforeAll, afterAll, beforeEach } from '@jest/globals';
-import { KnowledgeStore } from '../store';
+import { FileKnowledgeStore as KnowledgeStore } from '../store';
 import { KnowledgeIngest } from '../ingest';
 import * as fs from 'fs';
 import * as path from 'path';

package/src/knowledge/__tests__/lifecycle-hooks.test.ts

@@ -3,7 +3,7 @@
  */
 
 import { KnowledgeLifecycleHooks } from '../lifecycle-hooks';
-import { KnowledgeStore } from '../store';
+import { FileKnowledgeStore as KnowledgeStore } from '../store';
 import { KnowledgeQuery } from '../query';
 import * as fs from 'fs';
 import * as path from 'path';

package/src/knowledge/__tests__/lifecycle.test.ts

@@ -3,7 +3,7 @@
  */
 
 import { describe, it, expect, beforeAll, afterAll, beforeEach } from '@jest/globals';
-import { KnowledgeStore } from '../store';
+import { FileKnowledgeStore as KnowledgeStore } from '../store';
 import { KnowledgeLifecycle } from '../lifecycle';
 import type { KnowledgeEntry } from '../types';
 import * as fs from 'fs';

package/src/knowledge/__tests__/lint.test.ts

@@ -3,7 +3,7 @@
  */
 
 import { KnowledgeLinter } from '../lint';
-import { KnowledgeStore } from '../store';
+import { FileKnowledgeStore as KnowledgeStore } from '../store';
 import { ReferenceTracker } from '../reference-tracker';
 import * as fs from 'fs';
 import * as path from 'path';

package/src/knowledge/__tests__/query.test.ts

@@ -3,7 +3,7 @@
  */
 
 import { describe, it, expect, beforeAll, afterAll, beforeEach } from '@jest/globals';
-import { KnowledgeStore } from '../store';
+import { FileKnowledgeStore as KnowledgeStore } from '../store';
 import { KnowledgeQuery } from '../query';
 import type { KnowledgeEntry, QueryBudget } from '../types';
 import * as fs from 'fs';

package/src/knowledge/__tests__/reference-tracker.test.ts

@@ -3,7 +3,7 @@
  */
 
 import { describe, it, expect, beforeAll, afterAll, beforeEach } from '@jest/globals';
-import { KnowledgeStore } from '../store';
+import { FileKnowledgeStore as KnowledgeStore } from '../store';
 import { ReferenceTracker } from '../reference-tracker';
 import type { KnowledgeEntry } from '../types';
 import * as fs from 'fs';

package/src/knowledge/__tests__/store.test.ts

@@ -3,7 +3,7 @@
  */
 
 import { describe, it, expect, beforeAll, afterAll, beforeEach } from '@jest/globals';
-import { KnowledgeStore } from '../store';
+import { FileKnowledgeStore as KnowledgeStore } from '../store';
 import type { KnowledgeEntry } from '../types';
 import * as fs from 'fs';
 import * as path from 'path';

package/src/knowledge/audit.ts

@@ -11,7 +11,8 @@
 
 import * as fs from 'fs';
 import * as path from 'path';
-import { KnowledgeStore } from './store';
+import { FileKnowledgeStore } from './store';
+import type { KnowledgeStore } from './store';
 import type { KnowledgeEntry, MaturityLevel } from './types';
 
 // ── Types ─────────────────────────────────────────────────
@@ -300,7 +301,7 @@ export class KnowledgeAudit {
   private promotionBlockDays: number;
 
   constructor(options?: AuditOptions) {
-    this.store = new KnowledgeStore({ baseDir: options?.baseDir });
+    this.store = new FileKnowledgeStore({ baseDir: options?.baseDir });
     this.shortContentThreshold = options?.shortContentThreshold ?? DEFAULT_SHORT_CONTENT_THRESHOLD;
     this.staleDays = options?.staleDays ?? DEFAULT_STALE_DAYS;
     this.promotionBlockDays = options?.promotionBlockDays ?? DEFAULT_PROMOTION_BLOCK_DAYS;

package/src/knowledge/doctor.ts

@@ -5,7 +5,7 @@
  * MonitorAgent 周期性调用，低于 60 分触发 Triage 告警。
  */
 
-import { KnowledgeStore } from './store';
+import type { KnowledgeStore } from './store';
 import { KnowledgeLinter } from './lint';
 import type { LintIssue } from './types';
 

package/src/knowledge/import.ts

@@ -14,7 +14,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import type { KnowledgeEntry, KnowledgeType, MaturityLevel, StorageLayer } from './types';
-import { KnowledgeStore } from './store';
+import type { KnowledgeStore } from './store';
 
 // ── 导入源 ───────────────────────────────────────────────
 

package/src/knowledge/index.ts

@@ -5,7 +5,8 @@
  */
 
 export * from './types';
-export { KnowledgeStore } from './store';
+export type { KnowledgeStore } from './store';
+export { FileKnowledgeStore } from './store';
 export { KnowledgeQuery } from './query';
 export { KnowledgeLifecycle } from './lifecycle';
 export type { ConsumptionEvent } from './lifecycle';

package/src/knowledge/ingest.ts

@@ -12,7 +12,7 @@ import type {
   IngestOptions,
   SourceRef,
 } from './types';
-import { KnowledgeStore } from './store';
+import type { KnowledgeStore } from './store';
 import { KnowledgeAudit } from './audit';
 
 const MAX_SOURCE_REFS = 20;

package/src/knowledge/lifecycle-hooks.ts

@@ -7,7 +7,7 @@
  */
 
 import type { KnowledgeEntry, KnowledgeType } from './types';
-import { KnowledgeStore } from './store';
+import type { KnowledgeStore } from './store';
 import { KnowledgeQuery } from './query';
 import type { ContextSource } from '../context/types';
 

package/src/knowledge/lifecycle.ts

@@ -12,7 +12,7 @@ import type {
   DecayConfig,
 } from './types';
 import { DEFAULT_DECAY_CONFIG } from './types';
-import { KnowledgeStore } from './store';
+import type { KnowledgeStore } from './store';
 
 const MAX_REFERENCED_BY = 20;
 const MIN_CONTENT_FOR_PROVEN = 100;

package/src/knowledge/lint.ts

@@ -10,7 +10,7 @@
  * - 成熟度衰减
  */
 
-import { KnowledgeStore } from './store';
+import type { KnowledgeStore } from './store';
 import { ReferenceTracker } from './reference-tracker';
 import type { KnowledgeEntry, LintIssue, LintIssueType, MaturityLevel } from './types';
 
@@ -79,7 +79,7 @@ export class KnowledgeLinter {
    */
   checkIndexConsistency(entries: KnowledgeEntry[]): LintIssue[] {
     const issues: LintIssue[] = [];
-    const index = this.store['readIndex']();
+    const index = this.store.readIndex();
 
     // 检查索引中的条目是否都有对应文件
     for (const indexEntry of index) {

package/src/knowledge/query.ts

@@ -16,7 +16,7 @@ import type {
   QueryFilter,
   IndexEntry,
 } from './types';
-import { KnowledgeStore } from './store';
+import type { KnowledgeStore } from './store';
 import { KnowledgeLifecycle } from './lifecycle';
 
 // ── Constants ──────────────────────────────────────────────

package/src/knowledge/reference-tracker.ts

@@ -8,7 +8,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import type { ReferenceRecord } from './types';
-import { KnowledgeStore } from './store';
+import type { KnowledgeStore } from './store';
 
 const REFERENCES_FILE = 'references.jsonl';
 

package/src/knowledge/store.ts

@@ -22,7 +22,30 @@ const DEFAULT_CONFIG: StoreConfig = {
   baseDir: DEFAULT_DIR,
 };
 
-export class KnowledgeStore {
+/**
+ * KnowledgeStore interface — abstract contract for knowledge storage.
+ */
+export interface KnowledgeStore {
+  getBaseDir(): string;
+  get(id: string): KnowledgeEntry | undefined;
+  list(filter?: QueryFilter): KnowledgeEntry[];
+  save(entry: KnowledgeEntry): void;
+  delete(id: string): boolean;
+  update(id: string, partial: Partial<KnowledgeEntry>): KnowledgeEntry | undefined;
+  rebuildIndex(): void;
+  readIndex(): IndexEntry[];
+  readEntriesFromDisk(): KnowledgeEntry[];
+  snapshot(): string;
+  getSnapshot(date: string): IndexEntry[] | undefined;
+  getSurvivalRate(daysAgo: number): { rate: number; survived: number; total: number; snapshotDate: string } | undefined;
+}
+
+/**
+ * FileKnowledgeStore — file-based implementation of KnowledgeStore.
+ * Each entry is a markdown file with YAML frontmatter.
+ * An index.json provides fast listing without reading all files.
+ */
+export class FileKnowledgeStore implements KnowledgeStore {
   private baseDir: string;
 
   constructor(config?: Partial<StoreConfig>) {
@@ -269,7 +292,7 @@ export class KnowledgeStore {
    * 保存当日 index.json 快照
    */
   snapshot(): string {
-    const snapDir = path.join(this.baseDir, KnowledgeStore.SNAPSHOTS_DIR);
+    const snapDir = path.join(this.baseDir, FileKnowledgeStore.SNAPSHOTS_DIR);
     if (!fs.existsSync(snapDir)) {
       fs.mkdirSync(snapDir, { recursive: true });
     }
@@ -286,7 +309,7 @@ export class KnowledgeStore {
    * 读取指定日期的快照
    */
   getSnapshot(date: string): IndexEntry[] | undefined {
-    const snapPath = path.join(this.baseDir, KnowledgeStore.SNAPSHOTS_DIR, `index-${date}.json`);
+    const snapPath = path.join(this.baseDir, FileKnowledgeStore.SNAPSHOTS_DIR, `index-${date}.json`);
     if (!fs.existsSync(snapPath)) return undefined;
     try {
       return JSON.parse(fs.readFileSync(snapPath, 'utf-8')) as IndexEntry[];
@@ -323,7 +346,7 @@ export class KnowledgeStore {
 
   // ── Index I/O ────────────────────────────────────────────
 
-  private readIndex(): IndexEntry[] {
+  readIndex(): IndexEntry[] {
     const indexPath = path.join(this.baseDir, INDEX_FILE);
     if (!fs.existsSync(indexPath)) return [];
     try {

package/src/knowledge/types.ts

@@ -146,6 +146,23 @@ export const DEFAULT_DECAY_CONFIG: DecayConfig = {
   autoPromoteSources: [],
 };
 
+// ── Decision ────────────────────────────────────────────────
+
+export interface DecisionRecord {
+  topic: string;
+  category: 'architecture' | 'tooling' | 'process' | 'design';
+  context: string;
+  decision: string;
+  alternatives: string[];
+  rationale: string;
+  consequences: string;
+  participants: string[];
+  sourceType: string;
+  sourceId?: string;
+  revisable: boolean;
+  revisitCondition?: string;
+}
+
 // ── Reference ───────────────────────────────────────────────
 
 export interface ReferenceRecord {

package/src/monitoring/knowledge-evolver.ts

@@ -9,7 +9,7 @@
 
 import type { KnowledgeEntry, MaturityLevel } from '../knowledge/types';
 import type { KnowledgeDiagnosis } from './knowledge-doctor';
-import { KnowledgeStore } from '../knowledge/store';
+import type { KnowledgeStore } from '../knowledge/store';
 
 // ── 进化提案 ─────────────────────────────────────────────
 

package/src/types/constraint.ts

@@ -220,7 +220,7 @@ export interface ConstraintContext {
   /** 是否有需求文档（用于 no_implementation_without_requirement） */
   hasRequirement?: boolean;
 
-  /** 是否在 worktree 中执行（用于 must_use_worktree） */
+  /** 是否在 worktree 中执行（用于 prefer_worktree） */
   hasWorktree?: boolean;
 
   /** worktree 路径（用于 worktree 相关检查） */

package/dist/cli/commands/diagnose.d.ts

@@ -1,16 +0,0 @@
-/**
- * Diagnose CLI 命令
- *
- * 运行诊断分析异常
- */
-/**
- * diagnose 命令
- */
-export declare function diagnoseCommand(subcommand: string, options: {
-    hours?: number;
-    constraintId?: string;
-    anomalyId?: string;
-    format?: 'json' | 'text';
-    save?: boolean;
-}): Promise<void>;
-//# sourceMappingURL=diagnose.d.ts.map

package/dist/cli/commands/diagnose.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"diagnose.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/diagnose.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH;;GAEG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GACA,OAAO,CAAC,IAAI,CAAC,CA6Bf"}