@dommaker/harness 0.13.3 → 0.16.0

package/CHANGELOG.md

@@ -4,6 +4,41 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## [0.16.0] - 2026-06-10
+
+### Changed
+- **prefer_worktree demoted to guideline**: `prefer_worktree` moved from iron_law to guideline severity — worktree usage is now recommended, not enforced
+- **KnowledgeStore interface extracted**: `FileKnowledgeStore` implements `KnowledgeStore` interface, enabling mock/testing and future alternative implementations
+
+## [0.15.0] - 2026-06-07
+
+### Changed
+- Internal release (constraint tier adjustment prep)
+
+## [0.14.0] - 2026-06-04
+
+### Added
+- **ConsumptionMode + KnowledgeOrigin types** (AS-021 P1): `rule | context | signal | reference` 消费模式，`system | agent | human | external` 知识来源
+- **Per-mode lifecycle** (AS-021 P2): rule/context/signal 三条独立生命周期路径
+- **queryByMode + consume()** (AS-021 P3): 按 consumptionMode 查询 + 消费时 recordReference
+- **External content sanitization** (AS-021 P4): `ingestExternal()` 剥离 prompt injection 模式 + 长度限制
+- **Migration script + CLI** (AS-021 P5): `harness knowledge migrate` 旧条目自动标记 consumptionMode
+- **6-dimension quality audit engine**: `harness knowledge audit [--fix] [--dry-run]`，健康分 + 自动修复
+- **KR4 snapshot mechanism**: 每日 index.json 快照 + 30 天存活率统计
+- **GAP-11 promotion content quality gate**: draft→verified 要求 content ≥ 50 字符
+- **Semantic dedup + test ID interception**: KnowledgeIngest 去重增强
+- **Execution success rate tracking**: Path C 自动晋升依据
+- **Human/auto contributor classification**: 晋升来源区分
+- **D6 flywheel stats**: `harness knowledge stats` 展示飞轮指标
+- **hooks → Agent Event Protocol API** (B9-016): 通用 hook 管线暴露为 API
+
+### Fixed
+- **飞轮质量审计 5 项根因修复**: 噪音治理 + 资源优化
+- **B12 噪音治理**: 低质量条目过滤 + 资源优化
+- **E3 findFile 碰撞修复**: 文件查找哈希碰撞
+- **`no_delete_without_context` 增强**: 零引用 ≠ 无价值
+- **undefined tags/applicablePhases guard**: matchesFilter 空值保护
+
 ## [0.13.0] - 2026-05-26
 
 ### Breaking

package/bin/harness-knowledge-check.js

@@ -14,7 +14,6 @@ const path = require('path');
 const os = require('os');
 const STATE_FILE = '/tmp/claude-knowledge-capture-state.json';
 const LOG_FILE = '/tmp/claude-knowledge-hooks.log';
-const EVENTS_FILE = path.join(os.homedir(), 'events', 'studio.jsonl');
 const UNIQUE_DIR_THRESHOLD = 10;
 
 function log(level, message, data) {
@@ -79,30 +78,46 @@ try {
 
     console.log(JSON.stringify({ systemMessage: message }));
   }
-  // Emit session summary event → events-daemon → knowledge extraction pipeline
+  // B9-016: POST agent events to Studio API
   try {
+    const events = state.events || [];
+    const sessionId = state.sessionId || ('cc-' + Date.now());
     const now = Date.now();
-    const durationMs = state.startTime ? now - state.startTime : 0;
-    const durationMin = Math.round(durationMs / 60000);
-    const event = {
-      type: 'session:summary',
-      sessionType: 'development',
-      tool: state.tool || 'unknown',        // claude | codex | opencode | etc
-      timestamp: new Date().toISOString(),
-      durationMs,
-      durationMin,
-      deepAnalysis: state.planned || state.explored || state.readDirs.length >= UNIQUE_DIR_THRESHOLD,
-      knowledgeCaptured: !!state.captured,
-      readDirsCount: state.readDirs.length,
-      planned: state.planned || false,
-      explored: state.explored || false,
-      sensitiveOpsCount: (state.sensitiveOps || []).filter(op => !op.verified).length,
-      turnCount: state.turnCount || 0,
-    };
-    const dir = path.dirname(EVENTS_FILE);
-    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-    fs.appendFileSync(EVENTS_FILE, JSON.stringify(event) + '\n', 'utf-8');
-    log('info', 'session-summary-emitted', event);
+
+    // Append session:end event
+    events.push({
+      sessionId,
+      agentId: 'claude-code',
+      timestamp: now,
+      type: 'session:end',
+      payload: {
+        success: true,
+        durationMs: state.startTime ? now - state.startTime : 0,
+      },
+    });
+
+    // Read Studio API URL from env or default
+    const studioUrl = process.env.STUDIO_API_URL || 'http://127.0.0.1:13101';
+    const token = process.env.STUDIO_API_TOKEN || '';
+
+    if (events.length > 0 && token) {
+      const { execSync } = require('child_process');
+      const body = JSON.stringify(events);
+      try {
+        execSync(
+          `curl -s -X POST "${studioUrl}/api/v1/events/agent-events" ` +
+          `-H "Content-Type: application/json" ` +
+          `-H "Authorization: Bearer ${token}" ` +
+          `-d '${body.replace(/'/g, "'\\''")}'`,
+          { timeout: 10000, stdio: 'pipe' }
+        );
+        log('info', 'agent-events-posted', { count: events.length, sessionId });
+      } catch (e) {
+        log('warn', 'agent-events-post-failed', { error: (e.message || String(e)).slice(0, 200) });
+      }
+    } else if (events.length > 0 && !token) {
+      log('info', 'agent-events-skipped-no-token', { count: events.length });
+    }
   } catch {}
 
   // Auto-ingest: scan memory files with ingest:true → call local-rag API

package/bin/harness-knowledge-track.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * PostToolUse hook — track deep analysis signals
+ * PostToolUse hook — track deep analysis signals + collect AgentEvents
  *
  * Updates state file with:
  *   - planned: EnterPlanMode was called
@@ -8,8 +8,9 @@
  *   - readDirs: Set of unique directories Read was called on
  *   - captured: Write to .harness/knowledge-docs/ or .harness/knowledge/
  *   - turnCount: session turn counter
+ *   - events: AgentEvent[] (B9-016) — buffered for batch POST on session:end
  *
- * Usage: PostToolUse hook with matcher "EnterPlanMode|Agent|Read|Write|Write"
+ * Usage: PostToolUse hook with matcher "EnterPlanMode|Agent|Read|Write|Edit|Bash"
  */
 
 const fs = require('fs');
@@ -47,7 +48,9 @@ function loadState() {
       return JSON.parse(fs.readFileSync(STATE_FILE, 'utf-8'));
     }
   } catch {}
-  return { planned: false, explored: false, readDirs: [], captured: false };
+  // B9-016: generate sessionId for this Claude Code session
+  const sessionId = 'cc-' + Date.now() + '-' + Math.random().toString(36).slice(2, 8);
+  return { planned: false, explored: false, readDirs: [], captured: false, sessionId, events: [], startTime: Date.now() };
 }
 
 function updateState(state, event) {
@@ -75,13 +78,36 @@ function updateState(state, event) {
     }
   }
 
-  if (toolName === 'Write') {
+  if (toolName === 'Write' || toolName === 'Edit') {
     const input = event.tool_input || {};
     const filePath = input.file_path || '';
     if (filePath.includes('.harness/knowledge-docs/') || filePath.includes('.harness/knowledge/')) {
       state.captured = true;
       log('info', 'captured', { file: filePath });
     }
+    // B9-016: collect file:change event
+    if (filePath && !filePath.includes('.harness/')) {
+      state.events.push({
+        sessionId: state.sessionId,
+        agentId: 'claude-code',
+        timestamp: Date.now(),
+        type: 'file:change',
+        payload: { path: filePath, action: toolName === 'Write' ? 'create' : 'modify' },
+      });
+    }
+  }
+
+  if (toolName === 'Bash') {
+    const input = event.tool_input || {};
+    const command = input.command || '';
+    // B9-016: collect tool:call event
+    state.events.push({
+      sessionId: state.sessionId,
+      agentId: 'claude-code',
+      timestamp: Date.now(),
+      type: 'tool:call',
+      payload: { tool: 'Bash', command: command.slice(0, 200) },
+    });
   }
 }
 

package/bin/harness.js

@@ -39,6 +39,9 @@ const {
   knowledgeUpsert,
   knowledgeSyncStatus,
   knowledgeSyncRag,
+  knowledgeAudit,
+  knowledgeSnapshot,
+  knowledgeMigrate,
   failureList,
   failureStats,
   failureClear,
@@ -351,7 +354,7 @@ program
 // ========================================
 program
   .command('knowledge [subcommand] [arg]')
-  .description('知识库管理（list/search/import/decay/stats）')
+  .description('知识库管理（list/search/import/decay/stats/audit）')
   .alias('kb')
   .option('-p, --project-path <path>', '项目路径')
   .option('--type <types>', '按类型过滤（逗号分隔）')
@@ -365,6 +368,10 @@ program
   .option('--content <content>', '知识内容 Markdown（用于 upsert）')
   .option('--file <path>', '从文件读取内容（用于 upsert）')
   .option('--source <source>', '知识来源 (analyst/cli/design)', 'cli')
+  .option('--fix', '自动修复（用于 audit）', false)
+  .option('--dry-run', '只输出报告不修改（用于 audit）', false)
+  .option('--threshold <n>', '短内容阈值（字符数，用于 audit）', '50')
+  .option('--dir <path>', '知识库目录（覆盖默认路径）')
   .option('--json', 'JSON 格式输出', false)
   .action(async (subcommand, arg, options) => {
     const opts = { projectPath: options.projectPath, json: options.json };
@@ -408,6 +415,22 @@ program
           source: options.source || 'cli',
         });
         break;
+      case 'audit':
+      case 'a':
+        await knowledgeAudit({
+          ...opts,
+          fix: options.fix,
+          dryRun: options.dryRun,
+          threshold: options.threshold,
+          dir: options.dir,
+        });
+        break;
+      case 'snapshot':
+        knowledgeSnapshot({ ...opts, dir: options.dir });
+        break;
+      case 'migrate':
+        knowledgeMigrate({ ...opts, dir: options.dir });
+        break;
       default:
         // 无子命令时显示帮助
         if (!subcommand) {

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

@@ -16,7 +16,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/dist/cli/commands/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAC1G,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1N,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAC1G,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC/Q,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/cli/commands/index.js

@@ -3,7 +3,7 @@
  * CLI 命令导出
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getConstraintsMeta = exports.constraints = exports.updateUserModel = exports.analyzeSessions = exports.release = exports.postevalPlan = exports.failureClear = exports.failureStats = exports.failureList = exports.knowledgeSyncRag = exports.knowledgeSyncStatus = exports.knowledgeUpsert = exports.knowledgeStats = exports.knowledgeDecay = exports.knowledgeImport = exports.knowledgeSearch = exports.knowledgeList = exports.syncDocs = exports.executeCommand = exports.reviewStatus = exports.review = exports.validateSchema = exports.contract = exports.auditDetails = exports.security = exports.performance = exports.listAcceptanceCriteria = exports.acceptance = exports.listSpecTypes = exports.specValidate = exports.flow = exports.status = exports.report = exports.init = exports.checkCoverage = exports.runPassesGate = exports.DEFAULT_CHECKPOINTS = exports.createExampleCheckpoint = exports.validate = exports.listLaws = exports.check = void 0;
+exports.getConstraintsMeta = exports.constraints = exports.updateUserModel = exports.analyzeSessions = exports.release = exports.postevalPlan = exports.failureClear = exports.failureStats = exports.failureList = exports.knowledgeMigrate = exports.knowledgeSnapshot = exports.knowledgeAudit = exports.knowledgeSyncRag = exports.knowledgeSyncStatus = exports.knowledgeUpsert = exports.knowledgeStats = exports.knowledgeDecay = exports.knowledgeImport = exports.knowledgeSearch = exports.knowledgeList = exports.syncDocs = exports.executeCommand = exports.reviewStatus = exports.review = exports.validateSchema = exports.contract = exports.auditDetails = exports.security = exports.performance = exports.listAcceptanceCriteria = exports.acceptance = exports.listSpecTypes = exports.specValidate = exports.flow = exports.status = exports.report = exports.init = exports.checkCoverage = exports.runPassesGate = exports.DEFAULT_CHECKPOINTS = exports.createExampleCheckpoint = exports.validate = exports.listLaws = exports.check = void 0;
 var check_1 = require("./check");
 Object.defineProperty(exports, "check", { enumerable: true, get: function () { return check_1.check; } });
 Object.defineProperty(exports, "listLaws", { enumerable: true, get: function () { return check_1.listLaws; } });
@@ -52,6 +52,9 @@ Object.defineProperty(exports, "knowledgeStats", { enumerable: true, get: functi
 Object.defineProperty(exports, "knowledgeUpsert", { enumerable: true, get: function () { return knowledge_1.knowledgeUpsert; } });
 Object.defineProperty(exports, "knowledgeSyncStatus", { enumerable: true, get: function () { return knowledge_1.knowledgeSyncStatus; } });
 Object.defineProperty(exports, "knowledgeSyncRag", { enumerable: true, get: function () { return knowledge_1.knowledgeSyncRag; } });
+Object.defineProperty(exports, "knowledgeAudit", { enumerable: true, get: function () { return knowledge_1.knowledgeAudit; } });
+Object.defineProperty(exports, "knowledgeSnapshot", { enumerable: true, get: function () { return knowledge_1.knowledgeSnapshot; } });
+Object.defineProperty(exports, "knowledgeMigrate", { enumerable: true, get: function () { return knowledge_1.knowledgeMigrate; } });
 var failure_1 = require("./failure");
 Object.defineProperty(exports, "failureList", { enumerable: true, get: function () { return failure_1.failureList; } });
 Object.defineProperty(exports, "failureStats", { enumerable: true, get: function () { return failure_1.failureStats; } });

package/dist/cli/commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,iCAA6D;AAApD,8FAAA,KAAK,OAAA;AAAE,iGAAA,QAAQ,OAAA;AACxB,uCAA0G;AAAjG,oGAAA,QAAQ,OAAA;AAAE,mHAAA,uBAAuB,OAAA;AAAE,+GAAA,mBAAmB,OAAA;AAC/D,6CAAqF;AAA5E,4GAAA,aAAa,OAAA;AAAE,4GAAA,aAAa,OAAA;AACrC,+BAAgD;AAAvC,4FAAA,IAAI,OAAA;AACb,mCAAsD;AAA7C,gGAAA,MAAM,OAAA;AACf,mCAAsD;AAA7C,gGAAA,MAAM,OAAA;AACf,+BAAgD;AAAvC,4FAAA,IAAI,OAAA;AACb,+BAA+E;AAAtE,oGAAA,YAAY,OAAA;AAAE,qGAAA,aAAa,OAAA;AACpC,2CAA0F;AAAjF,wGAAA,UAAU,OAAA;AAAE,oHAAA,sBAAsB,OAAA;AAC3C,6CAAqE;AAA5D,0GAAA,WAAW,OAAA;AACpB,uCAA0E;AAAjE,oGAAA,QAAQ,OAAA;AAAE,wGAAA,YAAY,OAAA;AAC/B,uCAA4E;AAAnE,oGAAA,QAAQ,OAAA;AAAE,0GAAA,cAAc,OAAA;AACjC,mCAAoE;AAA3D,gGAAA,MAAM,OAAA;AAAE,sGAAA,YAAY,OAAA;AAC7B,qCAAqE;AAA5D,yGAAA,cAAc,OAAA;AACvB,yCAA6D;AAApD,qGAAA,QAAQ,OAAA;AACjB,yCAA0N;AAAjN,0GAAA,aAAa,OAAA;AAAE,4GAAA,eAAe,OAAA;AAAE,4GAAA,eAAe,OAAA;AAAE,2GAAA,cAAc,OAAA;AAAE,2GAAA,cAAc,OAAA;AAAE,4GAAA,eAAe,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAChJ,qCAAyF;AAAhF,sGAAA,WAAW,OAAA;AAAE,uGAAA,YAAY,OAAA;AAAE,uGAAA,YAAY,OAAA;AAChD,iDAAyE;AAAhE,6GAAA,YAAY,OAAA;AACrB,qCAAyD;AAAhD,kGAAA,OAAO,OAAA;AAChB,uDAAkF;AAAzE,mHAAA,eAAe,OAAA;AACxB,yDAAmF;AAA1E,oHAAA,eAAe,OAAA;AACxB,6CAAsF;AAA7E,0GAAA,WAAW,OAAA;AAAE,iHAAA,kBAAkB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,iCAA6D;AAApD,8FAAA,KAAK,OAAA;AAAE,iGAAA,QAAQ,OAAA;AACxB,uCAA0G;AAAjG,oGAAA,QAAQ,OAAA;AAAE,mHAAA,uBAAuB,OAAA;AAAE,+GAAA,mBAAmB,OAAA;AAC/D,6CAAqF;AAA5E,4GAAA,aAAa,OAAA;AAAE,4GAAA,aAAa,OAAA;AACrC,+BAAgD;AAAvC,4FAAA,IAAI,OAAA;AACb,mCAAsD;AAA7C,gGAAA,MAAM,OAAA;AACf,mCAAsD;AAA7C,gGAAA,MAAM,OAAA;AACf,+BAAgD;AAAvC,4FAAA,IAAI,OAAA;AACb,+BAA+E;AAAtE,oGAAA,YAAY,OAAA;AAAE,qGAAA,aAAa,OAAA;AACpC,2CAA0F;AAAjF,wGAAA,UAAU,OAAA;AAAE,oHAAA,sBAAsB,OAAA;AAC3C,6CAAqE;AAA5D,0GAAA,WAAW,OAAA;AACpB,uCAA0E;AAAjE,oGAAA,QAAQ,OAAA;AAAE,wGAAA,YAAY,OAAA;AAC/B,uCAA4E;AAAnE,oGAAA,QAAQ,OAAA;AAAE,0GAAA,cAAc,OAAA;AACjC,mCAAoE;AAA3D,gGAAA,MAAM,OAAA;AAAE,sGAAA,YAAY,OAAA;AAC7B,qCAAqE;AAA5D,yGAAA,cAAc,OAAA;AACvB,yCAA6D;AAApD,qGAAA,QAAQ,OAAA;AACjB,yCAA+Q;AAAtQ,0GAAA,aAAa,OAAA;AAAE,4GAAA,eAAe,OAAA;AAAE,4GAAA,eAAe,OAAA;AAAE,2GAAA,cAAc,OAAA;AAAE,2GAAA,cAAc,OAAA;AAAE,4GAAA,eAAe,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAAE,2GAAA,cAAc,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AACrM,qCAAyF;AAAhF,sGAAA,WAAW,OAAA;AAAE,uGAAA,YAAY,OAAA;AAAE,uGAAA,YAAY,OAAA;AAChD,iDAAyE;AAAhE,6GAAA,YAAY,OAAA;AACrB,qCAAyD;AAAhD,kGAAA,OAAO,OAAA;AAChB,uDAAkF;AAAzE,mHAAA,eAAe,OAAA;AACxB,yDAAmF;AAA1E,oHAAA,eAAe,OAAA;AACxB,6CAAsF;AAA7E,0GAAA,WAAW,OAAA;AAAE,iHAAA,kBAAkB,OAAA"}

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

@@ -61,4 +61,25 @@ export declare function knowledgeSyncRag(options: KnowledgeOptions): Promise<voi
  * 知识同步状态：检测所有 tracked scope 的新鲜度
  */
 export declare function knowledgeSyncStatus(options: KnowledgeOptions): Promise<void>;
+/**
+ * 知识库质量审计
+ */
+export declare function knowledgeAudit(options: KnowledgeOptions & {
+    fix?: boolean;
+    dryRun?: boolean;
+    threshold?: number;
+    dir?: string;
+}): Promise<void>;
+/**
+ * 知识库快照（KR4 存活率追踪）
+ */
+export declare function knowledgeSnapshot(options: KnowledgeOptions & {
+    dir?: string;
+}): void;
+/**
+ * 知识库迁移 — 为现有条目添加 AS-021 新字段
+ */
+export declare function knowledgeMigrate(options: KnowledgeOptions & {
+    dir?: string;
+}): void;
 //# sourceMappingURL=knowledge.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/knowledge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,MAAM,WAAW,gBAAgB;IAC/B,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,IAAI,CAAC,CAsChB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,gBAAgB,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,gBAAgB,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAChE,OAAO,CAAC,IAAI,CAAC,CA+Cf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB7E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC7E;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDpF;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0B/E;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2ClF"}
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/knowledge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,MAAM,WAAW,gBAAgB;IAC/B,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,IAAI,CAAC,CAsChB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,gBAAgB,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,gBAAgB,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAChE,OAAO,CAAC,IAAI,CAAC,CA+Cf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB7E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6D7E;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDpF;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0B/E;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2ClF;AAQD;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG;IAC/D,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,IAAI,CAAC,CAoFhB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAUpF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA4BnF"}

package/dist/cli/commands/knowledge.js

@@ -49,17 +49,24 @@ exports.knowledgeStats = knowledgeStats;
 exports.knowledgeUpsert = knowledgeUpsert;
 exports.knowledgeSyncRag = knowledgeSyncRag;
 exports.knowledgeSyncStatus = knowledgeSyncStatus;
+exports.knowledgeAudit = knowledgeAudit;
+exports.knowledgeSnapshot = knowledgeSnapshot;
+exports.knowledgeMigrate = knowledgeMigrate;
 const chalk_1 = __importDefault(require("chalk"));
 const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
 const store_1 = require("../../knowledge/store");
 const query_1 = require("../../knowledge/query");
 const lifecycle_1 = require("../../knowledge/lifecycle");
 const import_1 = require("../../knowledge/import");
+const audit_1 = require("../../knowledge/audit");
+const migration_1 = require("../../knowledge/migration");
 /**
  * 知识库列表
  */
 async function knowledgeList(options) {
-    const store = new store_1.KnowledgeStore({ baseDir: getKnowledgeDir(options.projectPath) });
+    const store = new store_1.FileKnowledgeStore({ baseDir: getKnowledgeDir(options.projectPath) });
     const filter = { excludeArchived: false };
     if (options.type) {
         filter.types = options.type.split(',');
@@ -96,7 +103,7 @@ async function knowledgeList(options) {
  * 知识库搜索
  */
 async function knowledgeSearch(query, options) {
-    const store = new store_1.KnowledgeStore({ baseDir: getKnowledgeDir(options.projectPath) });
+    const store = new store_1.FileKnowledgeStore({ baseDir: getKnowledgeDir(options.projectPath) });
     const queryEngine = new query_1.KnowledgeQuery(store);
     const budget = {
         phase: 'cli',
@@ -130,7 +137,7 @@ async function knowledgeSearch(query, options) {
  */
 async function knowledgeImport(options) {
     const projectPath = options.projectPath || process.cwd();
-    const store = new store_1.KnowledgeStore({ baseDir: getKnowledgeDir(options.projectPath) });
+    const store = new store_1.FileKnowledgeStore({ baseDir: getKnowledgeDir(options.projectPath) });
     const sources = options.sources
         ? options.sources.split(',')
         : ['code', 'git', 'docs'];
@@ -171,7 +178,7 @@ async function knowledgeImport(options) {
  * 知识库衰减周期
  */
 async function knowledgeDecay(options) {
-    const store = new store_1.KnowledgeStore({ baseDir: getKnowledgeDir(options.projectPath) });
+    const store = new store_1.FileKnowledgeStore({ baseDir: getKnowledgeDir(options.projectPath) });
     const lifecycle = new lifecycle_1.KnowledgeLifecycle(store);
     if (!options.json) {
         console.log(chalk_1.default.blue('🔄 运行衰减周期...'));
@@ -195,8 +202,9 @@ async function knowledgeDecay(options) {
  * 知识库统计
  */
 async function knowledgeStats(options) {
-    const store = new store_1.KnowledgeStore({ baseDir: getKnowledgeDir(options.projectPath) });
+    const store = new store_1.FileKnowledgeStore({ baseDir: getKnowledgeDir(options.projectPath) });
     const entries = store.list({ excludeArchived: false });
+    const active = entries.filter(e => e.maturity !== 'archived');
     const byType = {};
     const byMaturity = {};
     const byLayer = {};
@@ -205,12 +213,29 @@ async function knowledgeStats(options) {
         byMaturity[entry.maturity] = (byMaturity[entry.maturity] || 0) + 1;
         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_1.default.blue(`📊 知识库统计\n`));
-    console.log(chalk_1.default.bold(`  总计: ${entries.length} 条\n`));
+    console.log(chalk_1.default.bold(`  总计: ${entries.length} 条 (活跃: ${active.length})\n`));
     console.log(chalk_1.default.bold('  按类型:'));
     for (const [type, count] of Object.entries(byType)) {
         console.log(`    ${type}: ${count}`);
@@ -224,6 +249,10 @@ async function knowledgeStats(options) {
     for (const [layer, count] of Object.entries(byLayer)) {
         console.log(`    ${layer}: ${count}`);
     }
+    console.log(chalk_1.default.bold('\n  飞轮指标:'));
+    console.log(`    引用覆盖: ${refCoverage}%`);
+    console.log(`    平均引用: ${avgRefs}`);
+    console.log(`    消费命中率: ${consumptionHitRate}%`);
 }
 /**
  * 设计时知识沉淀：写入 KnowledgeStore + 同步 Prisma Document（Studio UI 可见）
@@ -353,7 +382,129 @@ async function knowledgeSyncStatus(options) {
     }
 }
 function getKnowledgeDir(projectPath) {
-    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');
+}
+/**
+ * 知识库质量审计
+ */
+async function knowledgeAudit(options) {
+    const audit = new audit_1.KnowledgeAudit({
+        baseDir: options.dir || getKnowledgeDir(options.projectPath),
+        shortContentThreshold: options.threshold ? parseInt(options.threshold, 10) : undefined,
+    });
+    const isDryRun = options.dryRun && !options.fix;
+    if (!options.json && !isDryRun) {
+        console.log(chalk_1.default.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_1.default.bold(`  总条目: ${report.totalEntries}`));
+    console.log(chalk_1.default.bold(`  健康分: ${report.healthScore.before}/100`));
+    if (report.autoFixed > 0) {
+        console.log(chalk_1.default.green(`  自动修复: ${report.autoFixed} 条`));
+        console.log(chalk_1.default.bold(`  修复后: ${report.healthScore.after}/100`));
+    }
+    console.log();
+    // Dimension scores
+    const dimLabels = {
+        structure: 'D1 结构完整性',
+        content: 'D2 内容质量',
+        dedup: 'D3 去重有效性',
+        maturity: 'D4 成熟度健康',
+        freshness: 'D5 新鲜度',
+        flywheel: 'D6 飞轮验证',
+    };
+    console.log(chalk_1.default.bold('  维度评分:'));
+    for (const [key, dim] of Object.entries(report.dimensions)) {
+        const label = dimLabels[key] || key;
+        const scoreColor = dim.score >= 80 ? chalk_1.default.green : dim.score >= 60 ? chalk_1.default.yellow : chalk_1.default.red;
+        console.log(`    ${label}: ${scoreColor(`${dim.score}/100`)} (${dim.issues} 问题)`);
+    }
+    console.log();
+    // Issues by rule
+    const ruleLabels = {
+        '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_1.default.red(`${label}: ${count}`)}`);
+    }
+    // Detail (first 20)
+    if (report.issues.length > 0) {
+        console.log(chalk_1.default.bold(`\n  问题详情 (前 20 条):\n`));
+        for (const issue of report.issues.slice(0, 20)) {
+            const severityColor = issue.severity === 'critical' ? chalk_1.default.red
+                : issue.severity === 'high' ? chalk_1.default.yellow
+                    : chalk_1.default.gray;
+            console.log(`  ${severityColor(`[${issue.severity}]`)} ${issue.entryId}: ${issue.title}`);
+            console.log(`    ${chalk_1.default.gray(issue.detail)} → ${issue.action}`);
+        }
+        if (report.issues.length > 20) {
+            console.log(chalk_1.default.gray(`\n  ... 还有 ${report.issues.length - 20} 条`));
+        }
+    }
+    if (!options.fix && report.issues.length > 0) {
+        console.log(chalk_1.default.yellow(`\n  使用 --fix 自动修复`));
+    }
+}
+/**
+ * 知识库快照（KR4 存活率追踪）
+ */
+function knowledgeSnapshot(options) {
+    const store = new store_1.FileKnowledgeStore({ baseDir: options.dir || getKnowledgeDir(options.projectPath) });
+    const snapPath = store.snapshot();
+    if (options.json) {
+        console.log(JSON.stringify({ snapshotPath: snapPath }));
+        return;
+    }
+    console.log(chalk_1.default.green(`✅ 快照已保存: ${snapPath}`));
+}
+/**
+ * 知识库迁移 — 为现有条目添加 AS-021 新字段
+ */
+function knowledgeMigrate(options) {
+    const baseDir = options.dir || getKnowledgeDir(options.projectPath);
+    if (options.json) {
+        const result = (0, migration_1.migrateKnowledgeEntries)(baseDir);
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log(chalk_1.default.blue('🔄 迁移知识条目（添加 consumptionMode/origin 字段）\n'));
+    const result = (0, migration_1.migrateKnowledgeEntries)(baseDir);
+    console.log(chalk_1.default.green(`  总计: ${result.total} 条`));
+    console.log(chalk_1.default.green(`  已迁移: ${result.migrated} 条`));
+    console.log(chalk_1.default.gray(`  已跳过: ${result.skipped} 条`));
+    if (result.errors.length > 0) {
+        console.log(chalk_1.default.red(`\n  错误: ${result.errors.length} 条`));
+        for (const err of result.errors.slice(0, 5)) {
+            console.log(chalk_1.default.red(`    ${err}`));
+        }
+    }
+    if (result.migrated === 0 && result.errors.length === 0) {
+        console.log(chalk_1.default.green('\n✅ 所有条目已是最新，无需迁移'));
+    }
+    else if (result.migrated > 0) {
+        console.log(chalk_1.default.green(`\n✅ 迁移完成`));
+    }
 }
 //# sourceMappingURL=knowledge.js.map