@dommaker/harness 1.1.1 → 1.2.0

package/src/dashboard/stats.ts

@@ -1,127 +0,0 @@
-/**
- * Dashboard 统计计算
- *
- * 纯函数，从原始数据计算统计指标
- */
-
-import type { KnowledgeEntry, KnowledgeSubsystem } from '../knowledge/types';
-import type { KnowledgeOverview, KnowledgeFlow } from './types';
-
-/**
- * 计算知识库概览
- */
-export function computeKnowledgeOverview(entries: KnowledgeEntry[]): KnowledgeOverview {
-  const byType = computeByType(entries);
-  const total = entries.length;
-  const proven = entries.filter(e => e.maturity === 'proven').length;
-  const verified = entries.filter(e => e.maturity === 'verified').length;
-  const draft = entries.filter(e => e.maturity === 'draft').length;
-
-  return {
-    byType,
-    total,
-    maturityDistribution: {
-      proven,
-      verified,
-      draft,
-      provenPercent: total > 0 ? Math.round((proven / total) * 100) : 0,
-      verifiedPercent: total > 0 ? Math.round((verified / total) * 100) : 0,
-      draftPercent: total > 0 ? Math.round((draft / total) * 100) : 0,
-    },
-    decayWarning: computeDecayWarning(entries),
-  };
-}
-
-/**
- * 按类型分组统计
- */
-function computeByType(entries: KnowledgeEntry[]): KnowledgeOverview['byType'] {
-  const typeMap = new Map<KnowledgeSubsystem, { total: number; proven: number; verified: number; draft: number }>();
-
-  for (const entry of entries) {
-    const existing = typeMap.get(entry.type) || { total: 0, proven: 0, verified: 0, draft: 0 };
-    existing.total++;
-    if (entry.maturity === 'proven') existing.proven++;
-    else if (entry.maturity === 'verified') existing.verified++;
-    else if (entry.maturity === 'draft') existing.draft++;
-    typeMap.set(entry.type, existing);
-  }
-
-  return [...typeMap.entries()].map(([type, stats]) => ({ type, ...stats }));
-}
-
-/**
- * 计算衰减预警
- */
-function computeDecayWarning(entries: KnowledgeEntry[]): KnowledgeOverview['decayWarning'] {
-  const now = new Date();
-  const sixMonthsAgo = new Date(now);
-  sixMonthsAgo.setMonth(sixMonthsAgo.getMonth() - 6);
-  const threeMonthsAgo = new Date(now);
-  threeMonthsAgo.setMonth(threeMonthsAgo.getMonth() - 3);
-
-  let provenUnused6m = 0;
-  let verifiedUnused3m = 0;
-
-  for (const entry of entries) {
-    const lastRef = entry.lastReferenced ? new Date(entry.lastReferenced) : new Date(entry.created);
-
-    if (entry.maturity === 'proven' && lastRef < sixMonthsAgo) {
-      provenUnused6m++;
-    }
-    if (entry.maturity === 'verified' && lastRef < threeMonthsAgo) {
-      verifiedUnused3m++;
-    }
-  }
-
-  return { provenUnused6m, verifiedUnused3m };
-}
-
-/**
- * 计算知识流转统计
- */
-export function computeKnowledgeFlow(
-  entries: KnowledgeEntry[],
-  referenceCounts: Map<string, number>,
-  topN: number = 5,
-): KnowledgeFlow {
-  // 成熟度转换统计（基于当前状态推断）
-  const transitions = {
-    draftToVerified: entries.filter(e => e.maturity === 'verified' && e.lastReferenced).length,
-    verifiedToProven: entries.filter(e => e.maturity === 'proven').length,
-    provenToVerified: 0, // 需要历史数据
-    verifiedToDraft: 0,  // 需要历史数据
-  };
-
-  // Top N 高频引用
-  const topReferenced = [...referenceCounts.entries()]
-    .map(([id, count]) => {
-      const entry = entries.find(e => e.id === id);
-      return { id, title: entry?.title ?? id, referenceCount: count };
-    })
-    .sort((a, b) => b.referenceCount - a.referenceCount)
-    .slice(0, topN);
-
-  const referenced = entries.filter(e => e.lastReferenced).length;
-
-  return {
-    period: '近 30 天',
-    pipeline: {
-      extracted: 0,   // 需要 ingestion 日志
-      ingested: 0,     // 需要 ingestion 日志
-      referenced,
-      upgraded: transitions.draftToVerified + transitions.verifiedToProven,
-      downgraded: transitions.provenToVerified + transitions.verifiedToDraft,
-    },
-    transitions,
-    topReferenced,
-  };
-}
-
-/**
- * 计算约束拦截率
- */
-export function computeInterceptRate(triggerCount: number, interceptCount: number): number {
-  if (triggerCount === 0) return 0;
-  return Math.round((interceptCount / triggerCount) * 100);
-}

package/src/dashboard/types.ts

@@ -1,130 +0,0 @@
-/**
- * Dashboard 数据类型定义
- *
- * harness 提供数据，studio 负责渲染
- */
-
-import type { KnowledgeSubsystem } from '../knowledge/types';
-
-// ── 约束分层（原 src/constraints/types，约束分层子系统删除后归位 dashboard）──
-
-/** 约束分层 */
-export type ConstraintLayer = 'safety' | 'quality';
-
-/** 退化状态（生命周期机制已删除，保留字段供消费方兼容，恒为 active） */
-export type DeprecationStatus = 'active' | 'scheduled' | 'deprecated' | 'removed';
-
-/** 约束拦截统计（generate/getConstraintHeatmap 的输入） */
-export interface ConstraintStats {
-  constraintId: string;
-  triggerCount: number;
-  passCount: number;
-  interceptCount: number;
-  interceptRate: number;
-  lastTriggered?: string;
-}
-
-// ── 知识库全景 ───────────────────────────────────────────
-
-export interface KnowledgeOverview {
-  byType: Array<{
-    type: KnowledgeSubsystem;
-    total: number;
-    proven: number;
-    verified: number;
-    draft: number;
-  }>;
-  total: number;
-  maturityDistribution: {
-    proven: number;
-    verified: number;
-    draft: number;
-    provenPercent: number;
-    verifiedPercent: number;
-    draftPercent: number;
-  };
-  decayWarning: {
-    provenUnused6m: number;
-    verifiedUnused3m: number;
-  };
-}
-
-// ── 约束执行热力图 ───────────────────────────────────────
-
-export interface ConstraintHeatmap {
-  period: string; // e.g. "近 30 天"
-  constraints: Array<{
-    id: string;
-    layer: ConstraintLayer;
-    trigger: number;
-    pass: number;
-    intercept: number;
-    interceptRate: number;
-    deprecationStatus: DeprecationStatus;
-    permanent?: boolean;
-  }>;
-  neverTriggered: string[];
-  decliningInterceptRate: Array<{
-    id: string;
-    from: number;
-    to: number;
-  }>;
-}
-
-// ── 知识流转路径 ─────────────────────────────────────────
-
-export interface KnowledgeFlow {
-  period: string;
-  pipeline: {
-    extracted: number;
-    ingested: number;
-    referenced: number;
-    upgraded: number;
-    downgraded: number;
-  };
-  transitions: {
-    draftToVerified: number;
-    verifiedToProven: number;
-    provenToVerified: number;
-    verifiedToDraft: number;
-  };
-  topReferenced: Array<{
-    id: string;
-    title: string;
-    referenceCount: number;
-  }>;
-}
-
-// ── 反馈环状态 ───────────────────────────────────────────
-
-export interface FeedbackLoopStatus {
-  local: {
-    active: number;
-    lastFeedback?: string;
-    lastType?: string;
-  };
-  push: {
-    active: number;
-    lastFeedback?: string;
-    lastType?: string;
-  };
-  external: {
-    active: number;
-    lastFeedback?: string;
-    lastType?: string;
-  };
-  feedbackToKnowledge: {
-    total: number;
-    pending: number;
-  };
-}
-
-// ── 汇总 ────────────────────────────────────────────────
-
-export interface HarnessDashboardData {
-  timestamp: string;
-  knowledgeOverview: KnowledgeOverview;
-  constraintHeatmap: ConstraintHeatmap;
-  knowledgeFlow: KnowledgeFlow;
-  feedbackLoop: FeedbackLoopStatus;
-}

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

@@ -1,278 +0,0 @@
-import { KnowledgeDoctor } from '../knowledge-doctor';
-import type { KnowledgeEntry, LintIssue } from '../../knowledge/types';
-
-function makeEntry(overrides: Partial<KnowledgeEntry> = {}): KnowledgeEntry {
-  return {
-    id: 'entry-1',
-    type: 'guideline',
-    title: 'Test Entry',
-    content: 'content',
-    maturity: 'draft',
-    layer: 'team',
-    created: '2025-01-01T00:00:00Z',
-    lastReferenced: new Date().toISOString(),
-    contributors: ['user-1'],
-    projects: ['proj-1'],
-    tags: ['test'],
-    applicablePhases: ['implementation'],
-    sourceReferences: [],
-    referencedBy: ['ref-1'],
-    executionResults: [],
-    consumptionMode: 'reference',
-    origin: 'agent',
-    ...overrides,
-  };
-}
-
-describe('KnowledgeDoctor', () => {
-  describe('基础诊断', () => {
-    it('空知识库返回满分', () => {
-      const doctor = new KnowledgeDoctor();
-      const report = doctor.diagnose([]);
-      expect(report.healthScore).toBe(100);
-      expect(report.totalEntries).toBe(0);
-      expect(report.diagnoses).toHaveLength(0);
-    });
-
-    it('健康条目不产生诊断', () => {
-      const doctor = new KnowledgeDoctor();
-      const entry = makeEntry({ maturity: 'verified', referencedBy: ['r1', 'r2', 'r3'], projects: ['p1'] });
-      const report = doctor.diagnose([entry]);
-      // 可能有 low_reference 诊断，但不会有 orphan/outdated/decay
-      const criticalDiags = report.diagnoses.filter(d => d.type === 'orphan' || d.type === 'outdated' || d.type === 'decay');
-      expect(criticalDiags).toHaveLength(0);
-    });
-  });
-
-  describe('孤儿检测', () => {
-    it('检测无引用、无贡献者、无项目的 draft 条目', () => {
-      const doctor = new KnowledgeDoctor();
-      const orphan = makeEntry({
-        id: 'orphan-1',
-        maturity: 'draft',
-        referencedBy: [],
-        contributors: [],
-        projects: [],
-      });
-      const report = doctor.diagnose([orphan]);
-      const orphanDiags = report.diagnoses.filter(d => d.type === 'orphan');
-      expect(orphanDiags).toHaveLength(1);
-      expect(orphanDiags[0].entryId).toBe('orphan-1');
-      expect(orphanDiags[0].severity).toBe('low');
-    });
-
-    it('archived 条目不检测为孤儿', () => {
-      const doctor = new KnowledgeDoctor();
-      const archived = makeEntry({
-        maturity: 'archived',
-        referencedBy: [],
-        contributors: [],
-        projects: [],
-      });
-      const report = doctor.diagnose([archived]);
-      expect(report.diagnoses.filter(d => d.type === 'orphan')).toHaveLength(0);
-    });
-
-    it('有引用的 draft 条目不检测为孤儿', () => {
-      const doctor = new KnowledgeDoctor();
-      const entry = makeEntry({ maturity: 'draft', referencedBy: ['r1'], contributors: [], projects: [] });
-      const report = doctor.diagnose([entry]);
-      expect(report.diagnoses.filter(d => d.type === 'orphan')).toHaveLength(0);
-    });
-  });
-
-  describe('过时检测', () => {
-    it('检测超过阈值天数未引用的 draft 条目', () => {
-      const doctor = new KnowledgeDoctor({ outdatedDays: 30 });
-      const old = makeEntry({
-        id: 'old-1',
-        maturity: 'draft',
-        lastReferenced: '2020-01-01T00:00:00Z',
-      });
-      const report = doctor.diagnose([old]);
-      const outdated = report.diagnoses.filter(d => d.type === 'outdated');
-      expect(outdated).toHaveLength(1);
-      expect(outdated[0].entryId).toBe('old-1');
-    });
-
-    it('verified/proven 条目不检测为过时', () => {
-      const doctor = new KnowledgeDoctor({ outdatedDays: 1 });
-      const entry = makeEntry({
-        maturity: 'verified',
-        lastReferenced: '2020-01-01T00:00:00Z',
-      });
-      const report = doctor.diagnose([entry]);
-      expect(report.diagnoses.filter(d => d.type === 'outdated')).toHaveLength(0);
-    });
-  });
-
-  describe('衰减检测', () => {
-    it('检测长期未引用的 proven 条目', () => {
-      const doctor = new KnowledgeDoctor({ decayWarningDays: 30 });
-      const entry = makeEntry({
-        id: 'decay-1',
-        maturity: 'proven',
-        lastReferenced: '2020-01-01T00:00:00Z',
-      });
-      const report = doctor.diagnose([entry]);
-      const decay = report.diagnoses.filter(d => d.type === 'decay');
-      expect(decay).toHaveLength(1);
-      expect(decay[0].severity).toBe('high');
-    });
-
-    it('检测长期未引用的 verified 条目（medium severity）', () => {
-      const doctor = new KnowledgeDoctor({ decayWarningDays: 30 });
-      const entry = makeEntry({
-        maturity: 'verified',
-        lastReferenced: '2020-01-01T00:00:00Z',
-      });
-      const report = doctor.diagnose([entry]);
-      const decay = report.diagnoses.filter(d => d.type === 'decay');
-      expect(decay).toHaveLength(1);
-      expect(decay[0].severity).toBe('medium');
-    });
-
-    it('draft 条目不检测衰减', () => {
-      const doctor = new KnowledgeDoctor({ decayWarningDays: 1 });
-      const entry = makeEntry({
-        maturity: 'draft',
-        lastReferenced: '2020-01-01T00:00:00Z',
-      });
-      const report = doctor.diagnose([entry]);
-      expect(report.diagnoses.filter(d => d.type === 'decay')).toHaveLength(0);
-    });
-  });
-
-  describe('低引用检测', () => {
-    it('检测引用次数低于阈值的非 draft 条目', () => {
-      const doctor = new KnowledgeDoctor({ lowReferenceThreshold: 5 });
-      const entry = makeEntry({
-        maturity: 'verified',
-        referencedBy: ['r1'],
-      });
-      const report = doctor.diagnose([entry]);
-      const lowRef = report.diagnoses.filter(d => d.type === 'low_reference');
-      expect(lowRef).toHaveLength(1);
-      expect(lowRef[0].severity).toBe('low');
-    });
-
-    it('archived 和 draft 条目不检测低引用', () => {
-      const doctor = new KnowledgeDoctor({ lowReferenceThreshold: 100 });
-      const archived = makeEntry({ id: 'a1', maturity: 'archived', referencedBy: [] });
-      const draft = makeEntry({ id: 'd1', maturity: 'draft', referencedBy: [] });
-      const report = doctor.diagnose([archived, draft]);
-      expect(report.diagnoses.filter(d => d.type === 'low_reference')).toHaveLength(0);
-    });
-  });
-
-  describe('Lint issues 转换', () => {
-    it('将 LintIssue 转换为诊断', () => {
-      const doctor = new KnowledgeDoctor();
-      const issue: LintIssue = {
-        type: 'orphan',
-        entryId: 'e1',
-        severity: 'medium',
-        description: 'Orphan entry',
-        suggestion: 'Archive it',
-      };
-      const report = doctor.diagnose([], [issue]);
-      expect(report.diagnoses).toHaveLength(1);
-      expect(report.diagnoses[0].type).toBe('orphan');
-      expect(report.diagnoses[0].severity).toBe('medium');
-      expect(report.diagnoses[0].recommendations).toContain('Archive it');
-    });
-
-    it('覆盖所有 LintIssue 类型的根因和影响推断', () => {
-      const doctor = new KnowledgeDoctor();
-      const types: LintIssue['type'][] = ['contradiction', 'outdated', 'duplicate', 'index_inconsistent'];
-      for (const type of types) {
-        const issue: LintIssue = { type, severity: 'low', description: `test ${type}`, suggestion: 'fix' };
-        const report = doctor.diagnose([], [issue]);
-        const diag = report.diagnoses.find(d => d.type === type);
-        expect(diag).toBeDefined();
-        expect(diag!.rootCause).toBeTruthy();
-        expect(diag!.impact).toBeTruthy();
-      }
-    });
-
-    it('未知 LintIssue 类型使用默认根因和影响', () => {
-      const doctor = new KnowledgeDoctor();
-      const issue = { type: 'unknown_type', severity: 'low', description: 'unknown', suggestion: 'fix' } as unknown as LintIssue;
-      const report = doctor.diagnose([], [issue]);
-      expect(report.diagnoses[0].rootCause).toBe('未知原因');
-      expect(report.diagnoses[0].impact).toBe('未知影响');
-    });
-  });
-
-  describe('健康分数', () => {
-    it('无问题时返回 100', () => {
-      const doctor = new KnowledgeDoctor();
-      const entry = makeEntry({ maturity: 'verified', referencedBy: ['r1', 'r2', 'r3'], projects: ['p1', 'p2'] });
-      const report = doctor.diagnose([entry]);
-      expect(report.healthScore).toBe(100);
-    });
-
-    it('有问题时扣分', () => {
-      const doctor = new KnowledgeDoctor({ decayWarningDays: 1, lowReferenceThreshold: 100 });
-      const entry = makeEntry({
-        maturity: 'proven',
-        lastReferenced: '2020-01-01T00:00:00Z',
-        referencedBy: ['r1'],
-        projects: ['p1'],
-      });
-      const report = doctor.diagnose([entry]);
-      expect(report.healthScore).toBeLessThan(100);
-    });
-
-    it('critical 严重度扣 10 分', () => {
-      const doctor = new KnowledgeDoctor();
-      // 直接构造 critical 诊断来测试 calculateHealthScore 的 critical 分支
-      // LintIssue severity 只有 low/medium/high，所以通过 checkDecay 的 high 来测试
-      const entry = makeEntry({ maturity: 'proven', lastReferenced: '2020-01-01T00:00:00Z' });
-      const report = doctor.diagnose([entry]);
-      const decayDiag = report.diagnoses.find(d => d.type === 'decay');
-      expect(decayDiag).toBeDefined();
-      expect(decayDiag!.severity).toBe('high');
-    });
-  });
-
-  describe('报告生成', () => {
-    it('生成 Markdown 报告', () => {
-      const doctor = new KnowledgeDoctor();
-      const report = doctor.diagnose([makeEntry()]);
-      const md = doctor.generateReport(report);
-      expect(md).toContain('# 知识库健康报告');
-      expect(md).toContain('健康分数');
-      expect(md).toContain('## 问题统计');
-    });
-
-    it('有诊断时生成详情', () => {
-      const doctor = new KnowledgeDoctor({ decayWarningDays: 1 });
-      const entry = makeEntry({
-        maturity: 'proven',
-        lastReferenced: '2020-01-01T00:00:00Z',
-      });
-      const report = doctor.diagnose([entry]);
-      const md = doctor.generateReport(report);
-      expect(md).toContain('## 诊断详情');
-      expect(md).toContain('衰减预警');
-    });
-  });
-
-  describe('配置', () => {
-    it('使用默认配置', () => {
-      const doctor = new KnowledgeDoctor();
-      // 默认 lowReferenceThreshold=2
-      const entry = makeEntry({ maturity: 'verified', referencedBy: ['r1'] });
-      const report = doctor.diagnose([entry]);
-      expect(report.diagnoses.filter(d => d.type === 'low_reference')).toHaveLength(1);
-    });
-
-    it('自定义配置覆盖默认值', () => {
-      const doctor = new KnowledgeDoctor({ lowReferenceThreshold: 0 });
-      const entry = makeEntry({ maturity: 'verified', referencedBy: [] });
-      const report = doctor.diagnose([entry]);
-      expect(report.diagnoses.filter(d => d.type === 'low_reference')).toHaveLength(0);
-    });
-  });
-});