@dommaker/harness 0.13.3 → 0.16.0

package/dist/knowledge/types.d.ts

@@ -7,8 +7,12 @@
  * - MaturityLevel: how trusted (lifecycle)
  */
 export type KnowledgeType = 'model' | 'decision' | 'guideline' | 'pitfall' | 'process' | 'architecture';
-export type MaturityLevel = 'draft' | 'verified' | 'proven' | 'archived';
+export type MaturityLevel = 'draft' | 'verified' | 'proven' | 'archived' | 'active' | 'deprecated';
 export type StorageLayer = 'personal' | 'team' | 'tech' | 'domain' | 'project' | 'system';
+/** How agent consumes this knowledge — drives injection strategy and lifecycle */
+export type ConsumptionMode = 'rule' | 'reference' | 'context' | 'signal';
+/** Where this knowledge came from — affects initial trust and maturity */
+export type KnowledgeOrigin = 'human' | 'agent' | 'external' | 'system';
 export interface KnowledgeEntry {
     id: string;
     type: KnowledgeType;
@@ -24,7 +28,16 @@ export interface KnowledgeEntry {
     applicablePhases: string[];
     sourceReferences: SourceRef[];
     referencedBy: string[];
+    executionResults: ExecutionResult[];
     decayAt?: string;
+    /** How agent consumes this knowledge (default: 'reference') */
+    consumptionMode: ConsumptionMode;
+    /** Where this knowledge came from (default: 'agent') */
+    origin: KnowledgeOrigin;
+    /** Path/URL to full content for on-demand retrieval */
+    fullContentPath?: string;
+    /** Skill ID if this knowledge was refined into a Skill */
+    skillId?: string;
 }
 export interface SourceRef {
     workflow?: string;
@@ -32,6 +45,12 @@ export interface SourceRef {
     commit?: string;
     timestamp: string;
 }
+export interface ExecutionResult {
+    contributor: string;
+    success: boolean;
+    timestamp: string;
+    source?: 'human' | 'auto';
+}
 export interface KnowledgeReference {
     id: string;
     title: string;
@@ -56,6 +75,8 @@ export interface QueryFilter {
     tags?: string[];
     applicablePhases?: string[];
     excludeArchived?: boolean;
+    consumptionModes?: ConsumptionMode[];
+    origins?: KnowledgeOrigin[];
 }
 export type LintIssueType = 'orphan' | 'contradiction' | 'outdated' | 'duplicate' | 'index_inconsistent';
 export interface LintIssue {
@@ -71,6 +92,9 @@ export interface IngestOptions {
     maturity?: MaturityLevel;
     tags?: string[];
     projects?: string[];
+    consumptionMode?: ConsumptionMode;
+    origin?: KnowledgeOrigin;
+    fullContentPath?: string;
 }
 export interface MaturityChange {
     entryId: string;
@@ -82,8 +106,24 @@ export interface DecayConfig {
     provenDecayMonths: number;
     verifiedDecayMonths: number;
     draftDecayMonths: number;
+    /** Sources whose entries skip draft→verified promotion (start at verified) */
+    autoPromoteSources: string[];
 }
 export declare const DEFAULT_DECAY_CONFIG: DecayConfig;
+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;
+}
 export interface ReferenceRecord {
     decisionId: string;
     entryIds: string[];
@@ -99,5 +139,7 @@ export interface IndexEntry {
     applicablePhases: string[];
     lastReferenced: string;
     created: string;
+    consumptionMode: ConsumptionMode;
+    origin: KnowledgeOrigin;
 }
 //# sourceMappingURL=types.d.ts.map

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

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

package/dist/knowledge/types.js

@@ -13,5 +13,6 @@ exports.DEFAULT_DECAY_CONFIG = {
     provenDecayMonths: 12,
     verifiedDecayMonths: 6,
     draftDecayMonths: 3,
+    autoPromoteSources: [],
 };
 //# sourceMappingURL=types.js.map

package/dist/knowledge/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/knowledge/types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAyGU,QAAA,oBAAoB,GAAgB;IAC/C,iBAAiB,EAAE,EAAE;IACrB,mBAAmB,EAAE,CAAC;IACtB,gBAAgB,EAAE,CAAC;CACpB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/knowledge/types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAsIU,QAAA,oBAAoB,GAAgB;IAC/C,iBAAiB,EAAE,EAAE;IACrB,mBAAmB,EAAE,CAAC;IACtB,gBAAgB,EAAE,CAAC;IACnB,kBAAkB,EAAE,EAAE;CACvB,CAAC"}

package/dist/monitoring/knowledge-evolver.d.ts

@@ -8,7 +8,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';
 export type ProposalAction = 'promote' | 'demote' | 'archive' | 'merge' | 'freeze';
 export interface EvolutionProposal {
     id: string;

package/dist/monitoring/knowledge-evolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge-evolver.d.ts","sourceRoot":"","sources":["../../src/monitoring/knowledge-evolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIpD,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEnF,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,cAAc,CAAC;IACvB,eAAe,EAAE,aAAa,CAAC;IAC/B,cAAc,EAAE,aAAa,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAChC,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,CAAC;IAC5D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;CACzC;AAID,MAAM,WAAW,sBAAsB;IACrC,iBAAiB;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAwBD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,KAAK,CAAC,CAAiB;gBAEnB,MAAM,CAAC,EAAE,sBAAsB,EAAE,KAAK,CAAC,EAAE,cAAc;IAKnE;;OAEG;IACH,iBAAiB,CACf,OAAO,EAAE,cAAc,EAAE,EACzB,SAAS,GAAE,kBAAkB,EAAO,GACnC,iBAAiB,EAAE;IAwCtB;;OAEG;IACH,OAAO,CAAC,YAAY;IA4BpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAsBnB,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,iBAAiB,GAAG;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAmB1E;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO;IA0B/C;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,iBAAiB,EAAE,GAAG,eAAe;CA8BlE"}
+{"version":3,"file":"knowledge-evolver.d.ts","sourceRoot":"","sources":["../../src/monitoring/knowledge-evolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIzD,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEnF,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,cAAc,CAAC;IACvB,eAAe,EAAE,aAAa,CAAC;IAC/B,cAAc,EAAE,aAAa,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAChC,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,CAAC;IAC5D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;CACzC;AAID,MAAM,WAAW,sBAAsB;IACrC,iBAAiB;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAwBD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,KAAK,CAAC,CAAiB;gBAEnB,MAAM,CAAC,EAAE,sBAAsB,EAAE,KAAK,CAAC,EAAE,cAAc;IAKnE;;OAEG;IACH,iBAAiB,CACf,OAAO,EAAE,cAAc,EAAE,EACzB,SAAS,GAAE,kBAAkB,EAAO,GACnC,iBAAiB,EAAE;IAwCtB;;OAEG;IACH,OAAO,CAAC,YAAY;IA4BpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAsBnB,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,iBAAiB,GAAG;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAmB1E;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO;IA0B/C;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,iBAAiB,EAAE,GAAG,eAAe;CA8BlE"}

package/dist/types/constraint.d.ts

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

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.13.3",
+  "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

@@ -0,0 +1,167 @@
+/**
+ * knowledge 命令测试 — knowledgeAudit
+ */
+
+import { knowledgeAudit, knowledgeStats } from '../knowledge';
+
+// Mock chalk
+jest.mock('chalk', () => ({
+  blue: jest.fn((str: string) => str),
+  bold: jest.fn((str: string) => str),
+  green: jest.fn((str: string) => str),
+  yellow: jest.fn((str: string) => str),
+  red: jest.fn((str: string) => str),
+  gray: jest.fn((str: string) => str),
+}));
+
+// Mock KnowledgeAudit
+const mockRun = jest.fn();
+jest.mock('../../../knowledge/audit', () => ({
+  KnowledgeAudit: jest.fn().mockImplementation(() => ({
+    run: mockRun,
+  })),
+}));
+
+const MOCK_REPORT = {
+  timestamp: '2026-06-02T00:00:00.000Z',
+  totalEntries: 100,
+  issues: [
+    {
+      rule: 'short-content',
+      entryId: 'GUI-001',
+      title: 'Short Entry',
+      severity: 'medium',
+      action: 'flag',
+      detail: 'content 30 chars',
+    },
+  ],
+  summary: {
+    'frontmatter-missing': 0,
+    'test-data-pollution': 0,
+    'daily-audit-noise': 0,
+    'zero-content-proven': 0,
+    'short-content': 1,
+    'maturity-inflation': 0,
+    'title-duplicate': 0,
+    'source-refs-bloat': 0,
+    'promotion-blocked': 0,
+    'orphan-draft': 0,
+    'stale-entry': 0,
+  },
+  dimensions: {
+    structure: { score: 100, issues: 0, details: {} },
+    content: { score: 95, issues: 1, details: {} },
+    dedup: { score: 100, issues: 0, details: {} },
+    maturity: { score: 100, issues: 0, details: {} },
+    freshness: { score: 100, issues: 0, details: {} },
+    flywheel: { score: 50, issues: 0, details: {} },
+  },
+  autoFixed: 0,
+  healthScore: { before: 95, after: 95 },
+};
+
+describe('getKnowledgeDir', () => {
+  const os = require('os');
+  const path = require('path');
+  const storeModule = require('../../../knowledge/store');
+  let storeCtorSpy: jest.SpyInstance;
+
+  beforeEach(() => {
+    delete process.env.KNOWLEDGE_BASE_DIR;
+    storeCtorSpy = jest.spyOn(storeModule, 'FileKnowledgeStore').mockImplementation(() => ({
+      list: jest.fn().mockReturnValue([]),
+    }));
+  });
+
+  afterEach(() => {
+    storeCtorSpy.mockRestore();
+    delete process.env.KNOWLEDGE_BASE_DIR;
+  });
+
+  it('should use KNOWLEDGE_BASE_DIR env var when set', async () => {
+    process.env.KNOWLEDGE_BASE_DIR = '/custom/knowledge';
+    await knowledgeStats({ json: true });
+    expect(storeCtorSpy).toHaveBeenCalledWith(expect.objectContaining({
+      baseDir: '/custom/knowledge',
+    }));
+  });
+
+  it('should default to ~/.studio/knowledge when no env var', async () => {
+    const expected = path.join(os.homedir(), '.studio', 'knowledge');
+    await knowledgeStats({ json: true });
+    expect(storeCtorSpy).toHaveBeenCalledWith(expect.objectContaining({
+      baseDir: expected,
+    }));
+  });
+
+  it('should use projectPath when provided', async () => {
+    await knowledgeStats({ projectPath: '/my/project', json: true });
+    expect(storeCtorSpy).toHaveBeenCalledWith(expect.objectContaining({
+      baseDir: '/my/project/.harness/knowledge',
+    }));
+  });
+});
+
+describe('knowledgeAudit CLI', () => {
+  let consoleSpy: jest.SpyInstance;
+
+  beforeEach(() => {
+    jest.clearAllMocks();
+    consoleSpy = jest.spyOn(console, 'log').mockImplementation();
+    mockRun.mockReturnValue(MOCK_REPORT);
+  });
+
+  afterEach(() => {
+    consoleSpy.mockRestore();
+  });
+
+  it('should output JSON when --json is set', async () => {
+    await knowledgeAudit({ json: true });
+    expect(consoleSpy).toHaveBeenCalledWith(JSON.stringify(MOCK_REPORT, null, 2));
+  });
+
+  it('should call audit.run with autoFix=true when --fix is set', async () => {
+    await knowledgeAudit({ fix: true });
+    expect(mockRun).toHaveBeenCalledWith({ autoFix: true });
+  });
+
+  it('should call audit.run with autoFix falsy when --dry-run is set', async () => {
+    await knowledgeAudit({ dryRun: true });
+    expect(mockRun).toHaveBeenCalledWith({ autoFix: undefined });
+  });
+
+  it('should call audit.run with autoFix falsy by default', async () => {
+    await knowledgeAudit({});
+    expect(mockRun).toHaveBeenCalledWith({ autoFix: undefined });
+  });
+
+  it('should display total entries and health score', async () => {
+    await knowledgeAudit({});
+    const output = consoleSpy.mock.calls.map((c: any[]) => c[0]).join('\n');
+    expect(output).toContain('总条目: 100');
+    expect(output).toContain('95/100');
+  });
+
+  it('should display dimension scores', async () => {
+    await knowledgeAudit({});
+    const output = consoleSpy.mock.calls.map((c: any[]) => c[0]).join('\n');
+    expect(output).toContain('D1 结构完整性');
+    expect(output).toContain('D6 飞轮验证');
+  });
+
+  it('should display autoFixed count when > 0', async () => {
+    mockRun.mockReturnValue({ ...MOCK_REPORT, autoFixed: 5, healthScore: { before: 90, after: 95 } });
+    await knowledgeAudit({ fix: true });
+    const output = consoleSpy.mock.calls.map((c: any[]) => c[0]).join('\n');
+    expect(output).toContain('自动修复: 5');
+    expect(output).toContain('修复后: 95/100');
+  });
+
+  it('should pass custom dir to KnowledgeAudit', async () => {
+    const { KnowledgeAudit } = require('../../../knowledge/audit');
+    await knowledgeAudit({ dir: '/custom/path' });
+    expect(KnowledgeAudit).toHaveBeenCalledWith(expect.objectContaining({
+      baseDir: '/custom/path',
+    }));
+  });
+});

package/src/cli/commands/index.ts

@@ -17,7 +17,7 @@ export { contract, validateSchema, type ContractOptions } from './contract';
 export { review, reviewStatus, type ReviewOptions } from './review';
 export { executeCommand, type CommandCheckOptions } from './command';
 export { syncDocs, type SyncDocsOptions } from './sync-docs';
-export { knowledgeList, knowledgeSearch, knowledgeImport, knowledgeDecay, knowledgeStats, knowledgeUpsert, knowledgeSyncStatus, knowledgeSyncRag, type KnowledgeOptions, type KnowledgeUpsertOptions } from './knowledge';
+export { knowledgeList, knowledgeSearch, knowledgeImport, knowledgeDecay, knowledgeStats, knowledgeUpsert, knowledgeSyncStatus, knowledgeSyncRag, knowledgeAudit, knowledgeSnapshot, knowledgeMigrate, type KnowledgeOptions, type KnowledgeUpsertOptions } from './knowledge';
 export { failureList, failureStats, failureClear, type FailureOptions } from './failure';
 export { postevalPlan, type PostEvalPlanOptions } from './posteval-plan';
 export { release, type ReleaseOptions } from './release';

package/src/cli/commands/knowledge.ts

@@ -6,10 +6,14 @@
 
 import chalk from 'chalk';
 import * as fs from 'fs';
-import { KnowledgeStore } from '../../knowledge/store';
+import * as os from 'os';
+import * as path from 'path';
+import { FileKnowledgeStore as KnowledgeStore } from '../../knowledge/store';
 import { KnowledgeQuery } from '../../knowledge/query';
 import { KnowledgeLifecycle } from '../../knowledge/lifecycle';
 import { ColdStartImporter } from '../../knowledge/import';
+import { KnowledgeAudit } from '../../knowledge/audit';
+import { migrateKnowledgeEntries } from '../../knowledge/migration';
 import type { KnowledgeType, MaturityLevel, QueryFilter } from '../../knowledge/types';
 
 export interface KnowledgeOptions {
@@ -201,6 +205,7 @@ export async function knowledgeDecay(options: KnowledgeOptions): Promise<void> {
 export async function knowledgeStats(options: KnowledgeOptions): Promise<void> {
   const store = new KnowledgeStore({ baseDir: getKnowledgeDir(options.projectPath) });
   const entries = store.list({ excludeArchived: false });
+  const active = entries.filter(e => e.maturity !== 'archived');
 
   const byType: Record<string, number> = {};
   const byMaturity: Record<string, number> = {};
@@ -212,13 +217,31 @@ export async function knowledgeStats(options: KnowledgeOptions): Promise<void> {
     byLayer[entry.layer] = (byLayer[entry.layer] || 0) + 1;
   }
 
+  // D6 flywheel metrics
+  const withRefs = active.filter(e => e.referencedBy.length > 0).length;
+  const refCoverage = active.length > 0 ? Math.round(withRefs / active.length * 100) : 0;
+  const avgRefs = active.length > 0
+    ? Math.round(active.reduce((sum, e) => sum + e.referencedBy.length, 0) / active.length * 10) / 10
+    : 0;
+  let consumptionHitRate = 0;
+  try {
+    const statsPath = path.join(store.getBaseDir(), '.consumption-stats.json');
+    if (fs.existsSync(statsPath)) {
+      const stats = JSON.parse(fs.readFileSync(statsPath, 'utf-8'));
+      const dailyEvents = stats.dailyEvents || 0;
+      consumptionHitRate = active.length > 0 ? Math.min(Math.round(dailyEvents / active.length * 100), 100) : 0;
+    }
+  } catch { /* best-effort */ }
+
+  const flywheel = { refCoverage, avgRefs, consumptionHitRate };
+
   if (options.json) {
-    console.log(JSON.stringify({ total: entries.length, byType, byMaturity, byLayer }, null, 2));
+    console.log(JSON.stringify({ total: entries.length, byType, byMaturity, byLayer, flywheel }, null, 2));
     return;
   }
 
   console.log(chalk.blue(`📊 知识库统计\n`));
-  console.log(chalk.bold(`  总计: ${entries.length} 条\n`));
+  console.log(chalk.bold(`  总计: ${entries.length} 条 (活跃: ${active.length})\n`));
 
   console.log(chalk.bold('  按类型:'));
   for (const [type, count] of Object.entries(byType)) {
@@ -235,6 +258,11 @@ export async function knowledgeStats(options: KnowledgeOptions): Promise<void> {
   for (const [layer, count] of Object.entries(byLayer)) {
     console.log(`    ${layer}: ${count}`);
   }
+
+  console.log(chalk.bold('\n  飞轮指标:'));
+  console.log(`    引用覆盖: ${refCoverage}%`);
+  console.log(`    平均引用: ${avgRefs}`);
+  console.log(`    消费命中率: ${consumptionHitRate}%`);
 }
 
 export interface KnowledgeUpsertOptions {
@@ -386,6 +414,149 @@ export async function knowledgeSyncStatus(options: KnowledgeOptions): Promise<vo
 }
 
 function getKnowledgeDir(projectPath?: string): string {
-  const base = projectPath || process.cwd();
-  return `${base}/.harness/knowledge`;
+  if (projectPath) return `${projectPath}/.harness/knowledge`;
+  if (process.env.KNOWLEDGE_BASE_DIR) return process.env.KNOWLEDGE_BASE_DIR;
+  return path.join(os.homedir(), '.studio', 'knowledge');
+}
+
+/**
+ * 知识库质量审计
+ */
+export async function knowledgeAudit(options: KnowledgeOptions & {
+  fix?: boolean;
+  dryRun?: boolean;
+  threshold?: number;
+  dir?: string;
+}): Promise<void> {
+  const audit = new KnowledgeAudit({
+    baseDir: options.dir || getKnowledgeDir(options.projectPath),
+    shortContentThreshold: options.threshold ? parseInt(options.threshold as any, 10) : undefined,
+  });
+
+  const isDryRun = options.dryRun && !options.fix;
+
+  if (!options.json && !isDryRun) {
+    console.log(chalk.blue('🔍 知识库质量审计...\n'));
+  }
+
+  const report = audit.run({ autoFix: options.fix && !isDryRun });
+
+  if (options.json) {
+    console.log(JSON.stringify(report, null, 2));
+    return;
+  }
+
+  // Summary
+  console.log(chalk.bold(`  总条目: ${report.totalEntries}`));
+  console.log(chalk.bold(`  健康分: ${report.healthScore.before}/100`));
+  if (report.autoFixed > 0) {
+    console.log(chalk.green(`  自动修复: ${report.autoFixed} 条`));
+    console.log(chalk.bold(`  修复后: ${report.healthScore.after}/100`));
+  }
+  console.log();
+
+  // Dimension scores
+  const dimLabels: Record<string, string> = {
+    structure: 'D1 结构完整性',
+    content: 'D2 内容质量',
+    dedup: 'D3 去重有效性',
+    maturity: 'D4 成熟度健康',
+    freshness: 'D5 新鲜度',
+    flywheel: 'D6 飞轮验证',
+  };
+  console.log(chalk.bold('  维度评分:'));
+  for (const [key, dim] of Object.entries(report.dimensions)) {
+    const label = dimLabels[key] || key;
+    const scoreColor = dim.score >= 80 ? chalk.green : dim.score >= 60 ? chalk.yellow : chalk.red;
+    console.log(`    ${label}: ${scoreColor(`${dim.score}/100`)} (${dim.issues} 问题)`);
+  }
+  console.log();
+
+  // Issues by rule
+  const ruleLabels: Record<string, string> = {
+    'frontmatter-missing': 'frontmatter 缺失',
+    'test-data-pollution': '测试数据污染',
+    'daily-audit-noise': '每日审计噪音',
+    'zero-content-proven': '零内容 proven',
+    'short-content': '短内容',
+    'maturity-inflation': '成熟度虚高',
+    'title-duplicate': '标题重复',
+    'source-refs-bloat': 'sourceReferences 膨胀',
+    'promotion-blocked': 'promotion 受阻',
+    'orphan-draft': '孤儿 draft',
+    'stale-entry': '过期条目',
+  };
+
+  for (const [rule, count] of Object.entries(report.summary)) {
+    if (count === 0) continue;
+    const label = ruleLabels[rule] || rule;
+    console.log(`  ${chalk.red(`${label}: ${count}`)}`);
+  }
+
+  // Detail (first 20)
+  if (report.issues.length > 0) {
+    console.log(chalk.bold(`\n  问题详情 (前 20 条):\n`));
+    for (const issue of report.issues.slice(0, 20)) {
+      const severityColor = issue.severity === 'critical' ? chalk.red
+        : issue.severity === 'high' ? chalk.yellow
+        : chalk.gray;
+      console.log(`  ${severityColor(`[${issue.severity}]`)} ${issue.entryId}: ${issue.title}`);
+      console.log(`    ${chalk.gray(issue.detail)} → ${issue.action}`);
+    }
+    if (report.issues.length > 20) {
+      console.log(chalk.gray(`\n  ... 还有 ${report.issues.length - 20} 条`));
+    }
+  }
+
+  if (!options.fix && report.issues.length > 0) {
+    console.log(chalk.yellow(`\n  使用 --fix 自动修复`));
+  }
+}
+
+/**
+ * 知识库快照（KR4 存活率追踪）
+ */
+export function knowledgeSnapshot(options: KnowledgeOptions & { dir?: string }): void {
+  const store = new KnowledgeStore({ baseDir: options.dir || getKnowledgeDir(options.projectPath) });
+  const snapPath = store.snapshot();
+
+  if (options.json) {
+    console.log(JSON.stringify({ snapshotPath: snapPath }));
+    return;
+  }
+
+  console.log(chalk.green(`✅ 快照已保存: ${snapPath}`));
+}
+
+/**
+ * 知识库迁移 — 为现有条目添加 AS-021 新字段
+ */
+export function knowledgeMigrate(options: KnowledgeOptions & { dir?: string }): void {
+  const baseDir = options.dir || getKnowledgeDir(options.projectPath);
+
+  if (options.json) {
+    const result = migrateKnowledgeEntries(baseDir);
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+
+  console.log(chalk.blue('🔄 迁移知识条目（添加 consumptionMode/origin 字段）\n'));
+  const result = migrateKnowledgeEntries(baseDir);
+
+  console.log(chalk.green(`  总计: ${result.total} 条`));
+  console.log(chalk.green(`  已迁移: ${result.migrated} 条`));
+  console.log(chalk.gray(`  已跳过: ${result.skipped} 条`));
+
+  if (result.errors.length > 0) {
+    console.log(chalk.red(`\n  错误: ${result.errors.length} 条`));
+    for (const err of result.errors.slice(0, 5)) {
+      console.log(chalk.red(`    ${err}`));
+    }
+  }
+
+  if (result.migrated === 0 && result.errors.length === 0) {
+    console.log(chalk.green('\n✅ 所有条目已是最新，无需迁移'));
+  } else if (result.migrated > 0) {
+    console.log(chalk.green(`\n✅ 迁移完成`));
+  }
 }