@dommaker/harness 1.6.0 → 1.8.0

package/dist/cli/commands/knowledge.js

@@ -2,7 +2,10 @@
 /**
  * harness knowledge 命令
  *
- * 知识库管理：list、search、import、decay、stats
+ * 知识库管理 11 子操作（list/search/import/decay/stats/sync-rag/audit/snapshot/migrate/index/health）。
+ * 本文件只做「取数 + 声明两投影」：json 面正本在 `data`，人读排版在 `human()` 的
+ * display model。上色、label 映射、json/人读分派、退出码、路径解析与 store 构造
+ * 统一在 knowledge-view.ts（harness#133，架构评审候选4）。
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -37,27 +40,32 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.knowledgeListView = knowledgeListView;
 exports.knowledgeList = knowledgeList;
+exports.knowledgeSearchView = knowledgeSearchView;
 exports.knowledgeSearch = knowledgeSearch;
 exports.knowledgeSearchCommand = knowledgeSearchCommand;
+exports.knowledgeImportView = knowledgeImportView;
 exports.knowledgeImport = knowledgeImport;
+exports.knowledgeDecayView = knowledgeDecayView;
 exports.knowledgeDecay = knowledgeDecay;
+exports.knowledgeStatsView = knowledgeStatsView;
 exports.knowledgeStats = knowledgeStats;
+exports.knowledgeSyncRagView = knowledgeSyncRagView;
 exports.knowledgeSyncRag = knowledgeSyncRag;
-exports.knowledgeHealth = knowledgeHealth;
+exports.knowledgeAuditView = knowledgeAuditView;
 exports.knowledgeAudit = knowledgeAudit;
+exports.knowledgeSnapshotView = knowledgeSnapshotView;
 exports.knowledgeSnapshot = knowledgeSnapshot;
+exports.knowledgeMigrateView = knowledgeMigrateView;
 exports.knowledgeMigrate = knowledgeMigrate;
+exports.knowledgeIndexView = knowledgeIndexView;
 exports.knowledgeIndex = knowledgeIndex;
-const chalk_1 = __importDefault(require("chalk"));
+exports.knowledgeHealthView = knowledgeHealthView;
+exports.knowledgeHealth = knowledgeHealth;
 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");
@@ -66,70 +74,98 @@ const flywheel_metrics_1 = require("../../knowledge/flywheel-metrics");
 const migration_1 = require("../../knowledge/migration");
 const index_generator_1 = require("../../knowledge/index-generator");
 const command_contract_1 = require("../command-contract");
-/**
- * 知识库列表
- */
-async function knowledgeList(options, io = command_contract_1.processIO) {
-    const store = new store_1.FileKnowledgeStore({ baseDir: getKnowledgeDir(options.projectPath, io) });
+const numeric_flag_1 = require("../../utils/numeric-flag");
+const knowledge_view_1 = require("./knowledge-view");
+// ========================================
+// list
+// ========================================
+function listFilter(options) {
     const filter = { excludeArchived: false };
-    if (options.type) {
+    if (options.type)
         filter.types = options.type.split(',');
-    }
-    if (options.maturity) {
+    if (options.maturity)
         filter.maturity = options.maturity.split(',');
-    }
-    if (options.tag) {
+    if (options.tag)
         filter.tags = options.tag.split(',');
-    }
-    const entries = store.list(filter);
-    if (options.json) {
-        (0, command_contract_1.log)(io, JSON.stringify({ total: entries.length, entries }, null, 2));
-        return { kind: 'ok' };
-    }
+    return filter;
+}
+function knowledgeListView(options, io) {
+    const entries = (0, knowledge_view_1.openKnowledgeStore)(options, io).list(listFilter(options));
+    const data = { total: entries.length, entries };
+    return { data, human: () => ({ sections: [{ rows: listRows(entries) }] }) };
+}
+function listRows(entries) {
     if (entries.length === 0) {
-        (0, command_contract_1.log)(io, chalk_1.default.yellow('知识库为空'));
-        return { kind: 'ok' };
-    }
-    (0, command_contract_1.log)(io, chalk_1.default.blue(`📚 知识库 (${entries.length} 条)\n`));
-    for (const entry of entries) {
-        const maturityColor = entry.maturity === 'proven' ? chalk_1.default.green
-            : entry.maturity === 'verified' ? chalk_1.default.cyan
-                : entry.maturity === 'archived' ? chalk_1.default.gray
-                    : chalk_1.default.yellow;
-        (0, command_contract_1.log)(io, `  ${maturityColor(`[${entry.maturity}]`)} ${chalk_1.default.bold(entry.title)}`);
-        (0, command_contract_1.log)(io, `    ${chalk_1.default.gray(`id: ${entry.id} | type: ${entry.type} | layer: ${entry.layer}`)}`);
+        return [{ cells: [{ label: '知识库为空', tone: 'warn' }] }];
+    }
+    const rows = [
+        { cells: [
+                { label: '📚 知识库 (', tone: 'heading' },
+                { field: 'total', text: String(entries.length), tone: 'heading' },
+                { label: ' 条)', tone: 'heading' },
+            ] },
+        (0, knowledge_view_1.blankLine)(),
+    ];
+    entries.forEach((entry, i) => {
+        rows.push({ cells: [
+                { field: `entries.${i}.maturity`, text: `  [${entry.maturity}]`, tone: (0, knowledge_view_1.toneForMaturity)(entry.maturity) },
+                { field: `entries.${i}.title`, text: ` ${entry.title}`, tone: 'emph' },
+            ] });
+        rows.push({ cells: [
+                { field: `entries.${i}.id`, text: `    id: ${entry.id}`, tone: 'muted' },
+                { field: `entries.${i}.type`, text: ` | type: ${entry.type}`, tone: 'muted' },
+                { field: `entries.${i}.layer`, text: ` | layer: ${entry.layer}`, tone: 'muted' },
+            ] });
         if (entry.tags.length > 0) {
-            (0, command_contract_1.log)(io, `    ${chalk_1.default.gray(`tags: ${entry.tags.join(', ')}`)}`);
+            rows.push({ cells: [{ field: `entries.${i}.tags`, text: `    tags: ${entry.tags.join(', ')}`, tone: 'muted' }] });
         }
-    }
-    return { kind: 'ok' };
+    });
+    return rows;
 }
-/**
- * 知识库搜索
- */
-async function knowledgeSearch(query, options, io = command_contract_1.processIO) {
-    const store = new store_1.FileKnowledgeStore({ baseDir: getKnowledgeDir(options.projectPath, io) });
-    const queryEngine = new query_1.KnowledgeQuery(store);
-    const matched = queryEngine.search(query, { limit: options.limit || 20 });
-    if (options.json) {
-        (0, command_contract_1.log)(io, JSON.stringify({ query, total: matched.length, entries: matched }, null, 2));
-        return { kind: 'ok' };
-    }
+async function knowledgeList(options, io = command_contract_1.processIO) {
+    return (0, knowledge_view_1.emitKnowledgeView)(io, options, knowledgeListView(options, io));
+}
+// ========================================
+// search
+// ========================================
+function knowledgeSearchView(query, options, io) {
+    const store = (0, knowledge_view_1.openKnowledgeStore)(options, io);
+    const matched = new query_1.KnowledgeQuery(store).search(query, { limit: options.limit ?? 20 });
+    const data = { query, total: matched.length, entries: matched };
+    return { data, human: () => ({ sections: [{ rows: searchRows(query, matched) }] }) };
+}
+function searchRows(query, matched) {
     if (matched.length === 0) {
-        (0, command_contract_1.log)(io, chalk_1.default.yellow(`未找到匹配 "${query}" 的知识条目`));
-        return { kind: 'ok' };
-    }
-    (0, command_contract_1.log)(io, chalk_1.default.blue(`🔍 搜索 "${query}" (${matched.length} 条结果)\n`));
-    for (const entry of matched) {
-        (0, command_contract_1.log)(io, `  ${chalk_1.default.bold(entry.title)} ${chalk_1.default.gray(`[${entry.maturity}]`)}`);
-        const preview = entry.content.slice(0, 100).replace(/\n/g, ' ');
-        (0, command_contract_1.log)(io, `    ${chalk_1.default.gray(preview)}${entry.content.length > 100 ? '...' : ''}`);
-    }
-    return { kind: 'ok' };
+        return [{ cells: [{ label: `未找到匹配 "${query}" 的知识条目`, tone: 'warn' }] }];
+    }
+    const rows = [
+        { cells: [
+                { label: '🔍 搜索 "', tone: 'heading' },
+                { field: 'query', text: query, tone: 'heading' },
+                { label: '" (', tone: 'heading' },
+                { field: 'total', text: String(matched.length), tone: 'heading' },
+                { label: ' 条结果)', tone: 'heading' },
+            ] },
+        (0, knowledge_view_1.blankLine)(),
+    ];
+    matched.forEach((entry, i) => {
+        const preview = entry.content.slice(0, 100).replace(/\n/g, ' ') + (entry.content.length > 100 ? '...' : '');
+        rows.push({ cells: [
+                { field: `entries.${i}.title`, text: `  ${entry.title}`, tone: 'emph' },
+                { field: `entries.${i}.maturity`, text: ` [${entry.maturity}]`, tone: 'muted' },
+            ] });
+        rows.push({ cells: [{ field: `entries.${i}.content`, text: `    ${preview}`, tone: 'muted' }] });
+    });
+    return rows;
+}
+async function knowledgeSearch(query, options, io = command_contract_1.processIO) {
+    return (0, knowledge_view_1.emitKnowledgeView)(io, options, knowledgeSearchView(query, options, io));
 }
 /**
- * knowledge search 子命令入口（候选7）：缺参闸门 + limit 强转编组，
+ * knowledge search 子命令入口（候选7）：缺参闸门 + limit 装配窄化，
  * 自 definitions.ts 的 args 复印块移回命令模块（interface/测试面所在）。
+ * `--limit` 给到的恒是字符串（缺省 '20' 也是），脏输入 fail-loud（harness#154，
+ * 原先 parseInt 出 NaN 被下游 `|| 20` 静默兜成缺省量）。
  */
 async function knowledgeSearchCommand(positionals, options, io = command_contract_1.processIO) {
     const query = positionals[0];
@@ -137,85 +173,109 @@ async function knowledgeSearchCommand(positionals, options, io = command_contrac
         (0, command_contract_1.logError)(io, '请提供搜索关键词');
         return { kind: 'usage-error', reason: 'knowledge search 缺少关键词位置参数' };
     }
+    const limit = (0, numeric_flag_1.parseNumericFlag)(options.limit, 'int');
+    if (!limit.ok) {
+        (0, command_contract_1.logError)(io, (0, numeric_flag_1.numericFlagMessage)('--limit', limit.raw, 'int'));
+        return { kind: 'usage-error', reason: `knowledge search --limit 非法限制: "${limit.raw}"` };
+    }
     return knowledgeSearch(String(query), {
         projectPath: options.projectPath,
         json: options.json,
-        limit: parseInt(String(options.limit), 10),
-    });
+        limit: limit.value,
+    }, io);
 }
-/**
- * 知识库导入（冷启动）
- */
-async function knowledgeImport(options, io = command_contract_1.processIO) {
+// ========================================
+// import（冷启动）
+// ========================================
+async function knowledgeImportView(options, io) {
     const projectPath = options.projectPath || process.cwd();
-    const store = new store_1.FileKnowledgeStore({ baseDir: getKnowledgeDir(options.projectPath, io) });
+    const store = (0, knowledge_view_1.openKnowledgeStore)(options, io);
     const sources = options.sources
         ? options.sources.split(',')
         : ['code', 'git', 'docs'];
-    const importer = new import_1.ColdStartImporter({
-        projectRoot: projectPath,
-        store,
-        sources,
-    });
+    const importer = new import_1.ColdStartImporter({ projectRoot: projectPath, store, sources });
     if (options.reset) {
         importer.resetState();
-        if (!options.json) {
-            (0, command_contract_1.log)(io, chalk_1.default.yellow('🔄 已重置导入状态'));
-        }
-    }
-    if (!options.json) {
-        (0, command_contract_1.log)(io, chalk_1.default.blue(`📥 开始导入知识 (源: ${sources.join(', ')})...`));
+        (0, knowledge_view_1.announce)(io, options.json, '🔄 已重置导入状态', 'warn');
     }
+    (0, knowledge_view_1.announce)(io, options.json, `📥 开始导入知识 (源: ${sources.join(', ')})...`);
     const results = await importer.importAll();
-    const totalImported = results.reduce((sum, r) => sum + r.entries.length, 0);
-    const totalErrors = results.reduce((sum, r) => sum + r.errors.length, 0);
-    if (options.json) {
-        (0, command_contract_1.log)(io, JSON.stringify({ totalImported, totalErrors, results }, null, 2));
-        return { kind: 'ok' };
-    }
-    for (const result of results) {
+    const data = {
+        totalImported: results.reduce((sum, r) => sum + r.entries.length, 0),
+        totalErrors: results.reduce((sum, r) => sum + r.errors.length, 0),
+        results,
+    };
+    return { data, human: () => ({ sections: [{ rows: importRows(data) }] }) };
+}
+function importRows(data) {
+    const rows = [];
+    data.results.forEach((result, i) => {
         if (result.entries.length > 0) {
-            (0, command_contract_1.log)(io, chalk_1.default.green(`  ✅ ${result.source.type}: ${result.entries.length} 条`));
+            rows.push({ cells: [
+                    { field: `results.${i}.source.type`, text: `  ✅ ${result.source.type}: `, tone: 'ok' },
+                    { field: `results.${i}.entries.length`, text: `${result.entries.length} 条`, tone: 'ok' },
+                ] });
         }
-        if (result.errors.length > 0) {
-            for (const err of result.errors) {
-                (0, command_contract_1.log)(io, chalk_1.default.red(`  ❌ ${result.source.type}: ${err.message}`));
-            }
-        }
-    }
-    (0, command_contract_1.log)(io, chalk_1.default.green(`\n✅ 导入完成: ${totalImported} 条，${totalErrors} 个错误`));
-    return { kind: 'ok' };
+        result.errors.forEach((err, j) => {
+            rows.push({ cells: [
+                    { field: `results.${i}.source.type`, text: `  ❌ ${result.source.type}: `, tone: 'error' },
+                    { field: `results.${i}.errors.${j}.message`, text: err.message, tone: 'error' },
+                ] });
+        });
+    });
+    rows.push((0, knowledge_view_1.blankLine)(), { cells: [
+            { label: '✅ 导入完成: ', tone: 'ok' },
+            { field: 'totalImported', text: String(data.totalImported), tone: 'ok' },
+            { label: ' 条，', tone: 'ok' },
+            { field: 'totalErrors', text: String(data.totalErrors), tone: 'ok' },
+            { label: ' 个错误', tone: 'ok' },
+        ] });
+    return rows;
 }
-/**
- * 知识库衰减周期
- */
-async function knowledgeDecay(options, io = command_contract_1.processIO) {
-    const store = new store_1.FileKnowledgeStore({ baseDir: getKnowledgeDir(options.projectPath, io) });
-    const lifecycle = new lifecycle_1.KnowledgeLifecycle(store);
-    if (!options.json) {
-        (0, command_contract_1.log)(io, chalk_1.default.blue('🔄 运行衰减周期...'));
-    }
+async function knowledgeImport(options, io = command_contract_1.processIO) {
+    return (0, knowledge_view_1.emitKnowledgeView)(io, options, await knowledgeImportView(options, io));
+}
+// ========================================
+// decay
+// ========================================
+function knowledgeDecayView(options, io) {
+    const lifecycle = new lifecycle_1.KnowledgeLifecycle((0, knowledge_view_1.openKnowledgeStore)(options, io));
+    (0, knowledge_view_1.announce)(io, options.json, '🔄 运行衰减周期...');
     const changes = lifecycle.runDecayCycle();
-    if (options.json) {
-        (0, command_contract_1.log)(io, JSON.stringify({ changes }, null, 2));
-        return { kind: 'ok' };
-    }
+    const data = { changes };
+    return { data, human: () => ({ sections: [{ rows: decayRows(changes) }] }) };
+}
+function decayRows(changes) {
     if (changes.length === 0) {
-        (0, command_contract_1.log)(io, chalk_1.default.green('✅ 没有需要衰减的知识条目'));
-        return { kind: 'ok' };
-    }
-    (0, command_contract_1.log)(io, chalk_1.default.yellow(`📉 ${changes.length} 条知识发生衰减:\n`));
-    for (const change of changes) {
-        (0, command_contract_1.log)(io, `  ${change.entryId}: ${chalk_1.default.red(change.from)} → ${chalk_1.default.green(change.to)}`);
-        (0, command_contract_1.log)(io, `    ${chalk_1.default.gray(change.reason)}`);
-    }
-    return { kind: 'ok' };
+        return [{ cells: [{ label: '✅ 没有需要衰减的知识条目', tone: 'ok' }] }];
+    }
+    const rows = [
+        { cells: [
+                { label: '📉 ', tone: 'warn' },
+                { field: 'changes.length', text: String(changes.length), tone: 'warn' },
+                { label: ' 条知识发生衰减:', tone: 'warn' },
+            ] },
+        (0, knowledge_view_1.blankLine)(),
+    ];
+    changes.forEach((change, i) => {
+        rows.push({ cells: [
+                { field: `changes.${i}.entryId`, text: `  ${change.entryId}: ` },
+                { field: `changes.${i}.from`, text: change.from, tone: 'error' },
+                { label: ' → ' },
+                { field: `changes.${i}.to`, text: change.to, tone: 'ok' },
+            ] });
+        rows.push({ cells: [{ field: `changes.${i}.reason`, text: `    ${change.reason}`, tone: 'muted' }] });
+    });
+    return rows;
 }
-/**
- * 知识库统计
- */
-async function knowledgeStats(options, io = command_contract_1.processIO) {
-    const store = new store_1.FileKnowledgeStore({ baseDir: getKnowledgeDir(options.projectPath, io) });
+async function knowledgeDecay(options, io = command_contract_1.processIO) {
+    return (0, knowledge_view_1.emitKnowledgeView)(io, options, knowledgeDecayView(options, io));
+}
+// ========================================
+// stats
+// ========================================
+function knowledgeStatsView(options, io) {
+    const store = (0, knowledge_view_1.openKnowledgeStore)(options, io);
     const entries = store.list({ excludeArchived: false });
     const active = entries.filter(e => e.maturity !== 'archived');
     const byType = {};
@@ -237,68 +297,288 @@ async function knowledgeStats(options, io = command_contract_1.processIO) {
     }
     catch { /* best-effort */ }
     const metrics = (0, flywheel_metrics_1.evaluateFlywheel)({ entries: active, dailyConsumptionEvents });
-    const refCoverage = Math.round(metrics.refCoverage * 100);
-    const avgRefs = Math.round(metrics.avgRefs * 10) / 10;
-    const consumptionHitRate = Math.round(metrics.consumptionHitRate * 100);
-    const flywheel = { refCoverage, avgRefs, consumptionHitRate };
-    if (options.json) {
-        (0, command_contract_1.log)(io, JSON.stringify({ total: entries.length, byType, byMaturity, byLayer, flywheel }, null, 2));
-        return { kind: 'ok' };
+    const flywheel = {
+        refCoverage: Math.round(metrics.refCoverage * 100),
+        avgRefs: Math.round(metrics.avgRefs * 10) / 10,
+        consumptionHitRate: Math.round(metrics.consumptionHitRate * 100),
+    };
+    const data = { total: entries.length, byType, byMaturity, byLayer, flywheel };
+    const activeCount = active.length;
+    return {
+        data,
+        human: () => ({
+            sections: [
+                {
+                    rows: [
+                        { cells: [{ label: '📊 知识库统计', tone: 'heading' }] },
+                        (0, knowledge_view_1.blankLine)(),
+                        {
+                            cells: [
+                                { label: '  总计: ', tone: 'emph' },
+                                { field: 'total', text: String(data.total), tone: 'emph' },
+                                { label: ' 条 (活跃: ', tone: 'emph' },
+                                { derived: 'activeCount', text: String(activeCount), tone: 'emph' },
+                                { label: ')', tone: 'emph' },
+                            ],
+                        },
+                        (0, knowledge_view_1.blankLine)(),
+                    ],
+                },
+                { title: '  按类型:', rows: [...countRows('byType', byType), (0, knowledge_view_1.blankLine)()] },
+                {
+                    title: '  按成熟度:',
+                    rows: [...Object.entries(byMaturity).map(([maturity, count]) => ({
+                            cells: [
+                                { field: `byMaturity.${maturity}`, text: `    ${maturity}`, tone: (0, knowledge_view_1.toneForMaturity)(maturity) },
+                                { field: `byMaturity.${maturity}`, text: `: ${count}` },
+                            ],
+                        })), (0, knowledge_view_1.blankLine)()],
+                },
+                { title: '  按层级:', rows: [...countRows('byLayer', byLayer), (0, knowledge_view_1.blankLine)()] },
+                {
+                    title: '  飞轮指标:',
+                    rows: [
+                        { cells: [{ label: '    引用覆盖: ' }, { field: 'flywheel.refCoverage', text: `${flywheel.refCoverage}%` }] },
+                        { cells: [{ label: '    平均引用: ' }, { field: 'flywheel.avgRefs', text: String(flywheel.avgRefs) }] },
+                        { cells: [{ label: '    消费命中率: ' }, { field: 'flywheel.consumptionHitRate', text: `${flywheel.consumptionHitRate}%` }] },
+                    ],
+                },
+            ],
+        }),
+    };
+}
+function countRows(field, counts) {
+    return Object.entries(counts).map(([key, count]) => ({
+        cells: [
+            { label: '    ' },
+            { field: `${field}.${key}`, text: `${key}: ${count}` },
+        ],
+    }));
+}
+async function knowledgeStats(options, io = command_contract_1.processIO) {
+    return (0, knowledge_view_1.emitKnowledgeView)(io, options, knowledgeStatsView(options, io));
+}
+// ========================================
+// sync-rag
+// ========================================
+function knowledgeSyncRagView(options) {
+    const projectPath = options.projectPath || process.cwd();
+    const docsDir = `${projectPath}/.harness/knowledge-docs`;
+    const docsPresent = fs.existsSync(docsDir);
+    const files = docsPresent ? fs.readdirSync(docsDir).filter(f => f.endsWith('.md')) : [];
+    const data = { directory: docsDir, files };
+    return { data, human: () => ({ sections: [{ rows: syncRagRows(docsPresent, docsDir, files) }] }) };
+}
+function syncRagRows(docsPresent, docsDir, files) {
+    if (!docsPresent)
+        return [{ cells: [{ label: 'No .harness/knowledge-docs/ directory', tone: 'warn' }] }];
+    if (files.length === 0)
+        return [{ cells: [{ label: 'No knowledge docs found', tone: 'muted' }] }];
+    return [
+        { cells: [
+                { label: '📄 RAG sync candidates: ', tone: 'heading' },
+                { field: 'files.length', text: String(files.length), tone: 'heading' },
+                { label: ' files in ', tone: 'heading' },
+                { field: 'directory', text: docsDir, tone: 'heading' },
+            ] },
+        (0, knowledge_view_1.blankLine)(),
+        ...files.map((file, i) => ({ cells: [{ field: `files.${i}`, text: `  ${file}`, tone: 'accent' }] })),
+        (0, knowledge_view_1.blankLine)(),
+        { cells: [{ label: 'Run `mcp__local-rag__ingest_file` for each to sync to RAG', tone: 'muted' }] },
+    ];
+}
+async function knowledgeSyncRag(options, io = command_contract_1.processIO) {
+    return (0, knowledge_view_1.emitKnowledgeView)(io, options, knowledgeSyncRagView(options));
+}
+/**
+ * `--threshold` 的装配点窄化（harness#152）：非负整数字符串 → 数值，转不出来即脏输入。
+ * `undefined` = 未传，落引擎缺省（50）；`'0'` 是显式零值，不当「未传」兜掉。
+ * 判定规则正本是 `parseNumericFlag`（harness#154 统一解析器），此处保留 #152 的
+ * 函数面与报错文案（冻结测试钉死），只做委派。
+ */
+function assembleShortContentThreshold(raw) {
+    return (0, numeric_flag_1.parseNumericFlag)(raw, 'int');
+}
+function knowledgeAuditView(options, io) {
+    const audit = new audit_1.KnowledgeAudit((0, knowledge_view_1.openKnowledgeStore)(options, io), {
+        shortContentThreshold: options.threshold,
+    });
+    const isDryRun = options.dryRun && !options.fix;
+    if (!isDryRun)
+        (0, knowledge_view_1.announce)(io, options.json, '🔍 知识库质量审计...\n');
+    const report = audit.run({ autoFix: options.fix && !isDryRun });
+    const showFixHint = !options.fix && report.issues.length > 0;
+    return {
+        data: report,
+        human: () => ({ sections: auditSections(report, showFixHint) }),
+    };
+}
+function auditSections(report, showFixHint) {
+    const sections = [{
+            rows: [
+                { cells: [{ label: '  总条目: ', tone: 'emph' }, { field: 'totalEntries', text: String(report.totalEntries), tone: 'emph' }] },
+                { cells: [{ label: '  健康分: ', tone: 'emph' }, { field: 'healthScore.before', text: `${report.healthScore.before}/100`, tone: 'emph' }] },
+            ],
+        }];
+    if (report.autoFixed > 0) {
+        sections[0].rows.push({ cells: [{ label: '  自动修复: ', tone: 'ok' }, { field: 'autoFixed', text: String(report.autoFixed), tone: 'ok' }] }, { cells: [{ label: '  修复后: ', tone: 'emph' }, { field: 'healthScore.after', text: `${report.healthScore.after}/100`, tone: 'emph' }] });
     }
-    (0, command_contract_1.log)(io, chalk_1.default.blue(`📊 知识库统计\n`));
-    (0, command_contract_1.log)(io, chalk_1.default.bold(`  总计: ${entries.length} 条 (活跃: ${active.length})\n`));
-    (0, command_contract_1.log)(io, chalk_1.default.bold('  按类型:'));
-    for (const [type, count] of Object.entries(byType)) {
-        (0, command_contract_1.log)(io, `    ${type}: ${count}`);
+    sections[0].rows.push((0, knowledge_view_1.blankLine)());
+    const dimensions = [];
+    for (const [key, dim] of Object.entries(report.dimensions)) {
+        dimensions.push({ cells: [
+                { field: `dimensions.${key}`, text: `    ${(0, knowledge_view_1.dimensionLabel)(key)}: ` },
+                { field: `dimensions.${key}.score`, text: `${dim.score}/100`, tone: (0, knowledge_view_1.toneForScore)(dim.score) },
+                { field: `dimensions.${key}.issues`, text: ` (${dim.issues} 问题)` },
+            ] });
+    }
+    dimensions.push((0, knowledge_view_1.blankLine)());
+    sections.push({ title: '  维度评分:', rows: dimensions });
+    // 规则 label 正本在 audit.ts 的规则定义上（#109 编译期闭环经 ruleLabel 转发）
+    const rules = [];
+    for (const [rule, count] of Object.entries(report.summary)) {
+        if (count === 0)
+            continue;
+        rules.push({ cells: [{ field: `summary.${rule}`, text: `  ${(0, knowledge_view_1.ruleLabel)(rule)}: ${count}`, tone: 'error' }] });
     }
-    (0, command_contract_1.log)(io, chalk_1.default.bold('\n  按成熟度:'));
-    for (const [maturity, count] of Object.entries(byMaturity)) {
-        const color = maturity === 'proven' ? chalk_1.default.green : maturity === 'archived' ? chalk_1.default.gray : chalk_1.default.yellow;
-        (0, command_contract_1.log)(io, `    ${color(maturity)}: ${count}`);
+    if (report.issues.length > 0) {
+        rules.push((0, knowledge_view_1.blankLine)()); // 「问题详情」标题前的空行（原排版是 `\n` 前缀）
     }
-    (0, command_contract_1.log)(io, chalk_1.default.bold('\n  按层级:'));
-    for (const [layer, count] of Object.entries(byLayer)) {
-        (0, command_contract_1.log)(io, `    ${layer}: ${count}`);
+    sections.push({ rows: rules });
+    if (report.issues.length > 0) {
+        const issues = [(0, knowledge_view_1.blankLine)()];
+        for (const [i, issue] of report.issues.slice(0, 20).entries()) {
+            issues.push({ cells: [
+                    { field: `issues.${i}.severity`, text: `  [${issue.severity}]`, tone: (0, knowledge_view_1.toneForSeverity)(issue.severity) },
+                    { field: `issues.${i}.entryId`, text: ` ${issue.entryId}: ` },
+                    { field: `issues.${i}.title`, text: issue.title },
+                ] });
+            issues.push({ cells: [
+                    { field: `issues.${i}.detail`, text: `    ${issue.detail}`, tone: 'muted' },
+                    { label: ' → ' },
+                    { field: `issues.${i}.action`, text: issue.action },
+                ] });
+        }
+        if (report.issues.length > 20) {
+            issues.push((0, knowledge_view_1.blankLine)(), { cells: [
+                    { label: '  ... 还有 ', tone: 'muted' },
+                    { field: 'issues.length', text: String(report.issues.length - 20), tone: 'muted' },
+                    { label: ' 条', tone: 'muted' },
+                ] });
+        }
+        sections.push({ title: '  问题详情 (前 20 条):', rows: issues });
     }
-    (0, command_contract_1.log)(io, chalk_1.default.bold('\n  飞轮指标:'));
-    (0, command_contract_1.log)(io, `    引用覆盖: ${refCoverage}%`);
-    (0, command_contract_1.log)(io, `    平均引用: ${avgRefs}`);
-    (0, command_contract_1.log)(io, `    消费命中率: ${consumptionHitRate}%`);
-    return { kind: 'ok' };
+    if (showFixHint) {
+        sections.push({ rows: [(0, knowledge_view_1.blankLine)(), { cells: [{ label: '  使用 --fix 自动修复', tone: 'warn' }] }] });
+    }
+    return sections;
 }
-/**
- * RAG 同步：扫描 .harness/knowledge-docs/ 输出需要 ingest 的文件列表
- */
-async function knowledgeSyncRag(options, io = command_contract_1.processIO) {
-    const projectPath = options.projectPath || process.cwd();
-    const docsDir = `${projectPath}/.harness/knowledge-docs`;
-    if (!fs.existsSync(docsDir)) {
-        (0, command_contract_1.log)(io, chalk_1.default.yellow('No .harness/knowledge-docs/ directory'));
-        return { kind: 'ok' };
+async function knowledgeAudit(options, io = command_contract_1.processIO) {
+    const threshold = assembleShortContentThreshold(options.threshold);
+    if (!threshold.ok) {
+        (0, command_contract_1.logError)(io, `错误：--threshold 需要非负整数阈值（字符数），收到 "${threshold.raw}"；短内容判定未执行`);
+        return { kind: 'usage-error', reason: `knowledge audit --threshold 非法阈值: "${threshold.raw}"` };
     }
-    const files = fs.readdirSync(docsDir).filter(f => f.endsWith('.md'));
-    if (files.length === 0) {
-        (0, command_contract_1.log)(io, chalk_1.default.gray('No knowledge docs found'));
-        return { kind: 'ok' };
+    const result = (0, knowledge_view_1.emitKnowledgeView)(io, options, knowledgeAuditView({ ...options, threshold: threshold.value }, io));
+    // 审计可能改文件，人读路径收尾重建索引；--json 保持不写盘（现状冻结，#133 不动这条策略）
+    if (!options.json) {
+        new index_generator_1.KnowledgeIndexGenerator((0, knowledge_view_1.resolveKnowledgeBaseDir)(options, io)).regenerate();
+        (0, knowledge_view_1.announce)(io, options.json, '  📇 索引已重建', 'muted');
     }
-    if (options.json) {
-        (0, command_contract_1.log)(io, JSON.stringify({ directory: docsDir, files }, null, 2));
-        return { kind: 'ok' };
+    return result;
+}
+// ========================================
+// snapshot（KR4 存活率追踪）
+// ========================================
+function knowledgeSnapshotView(options, io) {
+    const snapshotPath = (0, knowledge_view_1.openKnowledgeStore)(options, io).snapshot();
+    const data = { snapshotPath };
+    return {
+        data,
+        human: () => ({
+            sections: [{
+                    rows: [{
+                            cells: [
+                                { label: '✅ 快照已保存: ', tone: 'ok' },
+                                { field: 'snapshotPath', text: snapshotPath, tone: 'ok' },
+                            ],
+                        }],
+                }],
+        }),
+    };
+}
+function knowledgeSnapshot(options, io = command_contract_1.processIO) {
+    return (0, knowledge_view_1.emitKnowledgeView)(io, options, knowledgeSnapshotView(options, io));
+}
+function knowledgeMigrateView(options, io) {
+    const result = (0, migration_1.migrateKnowledgeEntries)((0, knowledge_view_1.resolveKnowledgeBaseDir)(options, io));
+    return {
+        data: result,
+        human: () => ({ sections: [{ rows: migrateRows(result) }] }),
+    };
+}
+function migrateRows(result) {
+    const rows = [
+        { cells: [{ label: '🔄 迁移知识条目（添加 consumptionMode/origin 字段）', tone: 'heading' }] },
+        (0, knowledge_view_1.blankLine)(),
+        { cells: [{ label: '  总计: ', tone: 'ok' }, { field: 'total', text: String(result.total), tone: 'ok' }, { label: ' 条', tone: 'ok' }] },
+        { cells: [{ label: '  已迁移: ', tone: 'ok' }, { field: 'migrated', text: String(result.migrated), tone: 'ok' }, { label: ' 条', tone: 'ok' }] },
+        { cells: [{ label: '  已跳过: ', tone: 'muted' }, { field: 'skipped', text: String(result.skipped), tone: 'muted' }, { label: ' 条', tone: 'muted' }] },
+    ];
+    if (result.errors.length > 0) {
+        rows.push((0, knowledge_view_1.blankLine)(), { cells: [{ label: '  错误: ', tone: 'error' }, { field: 'errors.length', text: String(result.errors.length), tone: 'error' }, { label: ' 条', tone: 'error' }] });
+        result.errors.slice(0, 5).forEach((err, i) => {
+            rows.push({ cells: [{ label: '    ' }, { field: `errors.${i}`, text: err, tone: 'error' }] });
+        });
+    }
+    // 两种收尾语各自带一个前导空行；migrated=0 且有错误时历史上两句都不打
+    if (result.migrated === 0 && result.errors.length === 0) {
+        rows.push((0, knowledge_view_1.blankLine)(), { cells: [{ label: '✅ 所有条目已是最新，无需迁移', tone: 'ok' }] });
     }
-    (0, command_contract_1.log)(io, chalk_1.default.blue(`📄 RAG sync candidates: ${files.length} files in ${docsDir}\n`));
-    for (const file of files) {
-        (0, command_contract_1.log)(io, chalk_1.default.cyan(`  ${file}`));
+    else if (result.migrated > 0) {
+        rows.push((0, knowledge_view_1.blankLine)(), { cells: [{ label: '✅ 迁移完成', tone: 'ok' }] });
     }
-    (0, command_contract_1.log)(io);
-    (0, command_contract_1.log)(io, chalk_1.default.gray('Run `mcp__local-rag__ingest_file` for each to sync to RAG'));
-    return { kind: 'ok' };
+    return rows;
 }
-/**
- * 飞轮健康检查 — 零 token 检测知识飞轮数据流状态
- */
-async function knowledgeHealth(options, io = command_contract_1.processIO) {
-    const baseDir = options.dir || getKnowledgeDir(options.projectPath, io);
-    const store = new store_1.FileKnowledgeStore({ baseDir });
+function knowledgeMigrate(options, io = command_contract_1.processIO) {
+    return (0, knowledge_view_1.emitKnowledgeView)(io, options, knowledgeMigrateView(options, io));
+}
+// ========================================
+// index（重建 _index.md 供 Agent grep，并同步 index.json）
+// ========================================
+function knowledgeIndexView(options, io) {
+    const baseDir = (0, knowledge_view_1.resolveKnowledgeBaseDir)(options, io);
+    const indexPath = path.join(baseDir, '_index.md');
+    const beforeSize = fs.existsSync(indexPath) ? fs.statSync(indexPath).size : 0;
+    const output = new index_generator_1.KnowledgeIndexGenerator(baseDir).regenerate();
+    // Sync index.json from disk files (removes ghost entries from manual mv/rm)
+    (0, knowledge_view_1.openKnowledgeStore)({ dir: baseDir }, io).rebuildIndex();
+    const afterSize = Buffer.byteLength(output, 'utf-8');
+    const lineCount = output.split('\n').filter(l => !l.startsWith('#')).length;
+    const data = { path: indexPath, entries: lineCount, size: afterSize, previousSize: beforeSize };
+    return {
+        data,
+        human: () => ({ sections: [{ rows: indexRows({ indexPath, afterSize, lineCount, beforeSize }) }] }),
+    };
+}
+function indexRows(shape) {
+    const rows = [
+        { cells: [{ label: '📇 索引已重建', tone: 'heading' }] },
+        { cells: [{ label: '  路径: ', tone: 'muted' }, { field: 'path', text: shape.indexPath, tone: 'muted' }] },
+        { cells: [{ label: '  条目: ', tone: 'ok' }, { field: 'entries', text: String(shape.lineCount), tone: 'ok' }] },
+        { cells: [{ label: '  大小: ', tone: 'ok' }, { field: 'size', text: `${(shape.afterSize / 1024).toFixed(1)} KB`, tone: 'ok' }] },
+    ];
+    if (shape.beforeSize > 0) {
+        rows.push({ cells: [{ label: '  旧大小: ', tone: 'muted' }, { field: 'previousSize', text: `${(shape.beforeSize / 1024).toFixed(1)} KB`, tone: 'muted' }] });
+    }
+    return rows;
+}
+function knowledgeIndex(options, io = command_contract_1.processIO) {
+    return (0, knowledge_view_1.emitKnowledgeView)(io, options, knowledgeIndexView(options, io));
+}
+function knowledgeHealthView(options, io) {
+    const store = (0, knowledge_view_1.openKnowledgeStore)(options, io);
+    const baseDir = store.getBaseDir();
     const entries = store.list({ excludeArchived: true });
     const issues = [];
     // D1: 引用密度检查（低引用 = 可能孤立）
@@ -321,246 +601,100 @@ async function knowledgeHealth(options, io = command_contract_1.processIO) {
         }
     }
     // D3: 消费数据检查
-    let consumptionData = false;
     const statsPath = path.join(baseDir, '.consumption-stats.json');
-    if (fs.existsSync(statsPath)) {
-        consumptionData = true;
-    }
-    else {
+    const consumptionData = fs.existsSync(statsPath);
+    if (!consumptionData) {
         issues.push({ severity: 'info', entry: '-', detail: `消费追踪数据不存在（${statsPath}）` });
     }
     // D4: 飞轮指标（计算唯一实现在 knowledge/flywheel-metrics；人口为本命令的 excludeArchived 切片）
     const metrics = (0, flywheel_metrics_1.evaluateFlywheel)({ entries });
     const refCoverage = Math.round(metrics.refCoverage * 100);
     const avgRefs = Math.round(metrics.avgRefs * 10) / 10;
-    // 健康分计算
     const totalIssues = issues.filter(i => i.severity === 'error').length * 3
         + issues.filter(i => i.severity === 'warn').length * 1;
     const healthScore = Math.max(0, 100 - totalIssues);
-    if (options.json) {
-        (0, command_contract_1.log)(io, JSON.stringify({
-            healthScore,
-            summary: {
-                total: entries.length,
-                lowRefEntries,
-                staleEntries,
-                consumptionData,
-                refCoverage,
-                avgRefs,
-            },
-            issues: issues.slice(0, 50),
-        }, null, 2));
-        return { kind: 'ok' };
-    }
-    (0, command_contract_1.log)(io, chalk_1.default.blue('🏥 飞轮健康检查\n'));
-    (0, command_contract_1.log)(io, chalk_1.default.bold(`  健康分: ${healthScore >= 80 ? chalk_1.default.green(healthScore) : healthScore >= 60 ? chalk_1.default.yellow(healthScore) : chalk_1.default.red(healthScore)}/100`));
-    (0, command_contract_1.log)(io, chalk_1.default.bold(`  活跃条目: ${entries.length}`));
-    (0, command_contract_1.log)(io);
-    (0, command_contract_1.log)(io, chalk_1.default.bold('  数据流状态:'));
-    (0, command_contract_1.log)(io, `    引用密度: ${lowRefEntries === 0 ? chalk_1.default.green('✓') : chalk_1.default.yellow(`⚠ ${lowRefEntries} 个零引用 verified`)}`);
-    (0, command_contract_1.log)(io, `    新鲜度: ${staleEntries === 0 ? chalk_1.default.green('✓') : chalk_1.default.yellow(`⚠ ${staleEntries} 个过期 draft`)}`);
-    (0, command_contract_1.log)(io, `    消费追踪: ${consumptionData ? chalk_1.default.green('✓') : chalk_1.default.gray('○ 未启用')}`);
-    (0, command_contract_1.log)(io);
-    (0, command_contract_1.log)(io, chalk_1.default.bold('  飞轮指标:'));
-    (0, command_contract_1.log)(io, `    引用覆盖: ${refCoverage}%`);
-    (0, command_contract_1.log)(io, `    平均引用: ${avgRefs}`);
-    (0, command_contract_1.log)(io);
-    if (issues.length > 0) {
-        (0, command_contract_1.log)(io, chalk_1.default.bold(`  问题 (前 20):`));
-        for (const issue of issues.slice(0, 20)) {
-            const sevColor = issue.severity === 'error' ? chalk_1.default.red
-                : issue.severity === 'warn' ? chalk_1.default.yellow
-                    : chalk_1.default.gray;
-            (0, command_contract_1.log)(io, `    ${sevColor(`[${issue.severity}]`)} ${issue.entry}: ${issue.detail}`);
-        }
-        if (issues.length > 20) {
-            (0, command_contract_1.log)(io, chalk_1.default.gray(`    ... 还有 ${issues.length - 20} 条`));
-        }
-    }
-    else {
-        (0, command_contract_1.log)(io, chalk_1.default.green('  ✓ 无问题'));
-    }
-    return { kind: 'ok' };
-}
-/** 缺省知识库数据根（相对用户 home） */
-const KNOWLEDGE_DATA_DIR = path.join('.harness', 'knowledge');
-/** 旧缺省数据根（曾寄居 studio home），仍有数据时兼容沿用，免迁移 */
-const LEGACY_KNOWLEDGE_DATA_DIR = path.join('.studio', 'knowledge');
-let legacyKnowledgeDirNotified = false;
-function hasKnowledgeData(dir) {
-    try {
-        return fs.existsSync(dir) && fs.readdirSync(dir).length > 0;
-    }
-    catch {
-        return false;
-    }
-}
-function getKnowledgeDir(projectPath, io) {
-    if (projectPath)
-        return `${projectPath}/.harness/knowledge`;
-    if (process.env.KNOWLEDGE_BASE_DIR)
-        return process.env.KNOWLEDGE_BASE_DIR;
-    const defaultDir = path.join(os.homedir(), KNOWLEDGE_DATA_DIR);
-    const legacyDir = path.join(os.homedir(), LEGACY_KNOWLEDGE_DATA_DIR);
-    if (hasKnowledgeData(legacyDir)) {
-        if (!legacyKnowledgeDirNotified) {
-            legacyKnowledgeDirNotified = true;
-            // stderr：不污染 --json 的 stdout 输出
-            (0, command_contract_1.logError)(io, chalk_1.default.yellow(`⚠ 缺省知识库根已改为 ${defaultDir}；旧目录 ${legacyDir} 仍有数据，本次沿用（免迁移，可用 KNOWLEDGE_BASE_DIR 覆盖）`));
-        }
-        return legacyDir;
-    }
-    return defaultDir;
-}
-/**
- * 知识库质量审计
- */
-async function knowledgeAudit(options, io = command_contract_1.processIO) {
-    const audit = new audit_1.KnowledgeAudit({
-        baseDir: options.dir || getKnowledgeDir(options.projectPath, io),
-        shortContentThreshold: options.threshold ? parseInt(options.threshold, 10) : undefined,
-    });
-    const isDryRun = options.dryRun && !options.fix;
-    if (!options.json && !isDryRun) {
-        (0, command_contract_1.log)(io, chalk_1.default.blue('🔍 知识库质量审计...\n'));
-    }
-    const report = audit.run({ autoFix: options.fix && !isDryRun });
-    if (options.json) {
-        (0, command_contract_1.log)(io, JSON.stringify(report, null, 2));
-        return { kind: 'ok' };
-    }
-    // Summary
-    (0, command_contract_1.log)(io, chalk_1.default.bold(`  总条目: ${report.totalEntries}`));
-    (0, command_contract_1.log)(io, chalk_1.default.bold(`  健康分: ${report.healthScore.before}/100`));
-    if (report.autoFixed > 0) {
-        (0, command_contract_1.log)(io, chalk_1.default.green(`  自动修复: ${report.autoFixed} 条`));
-        (0, command_contract_1.log)(io, chalk_1.default.bold(`  修复后: ${report.healthScore.after}/100`));
-    }
-    (0, command_contract_1.log)(io);
-    // Dimension scores（Record 全键标注 → 编译期闭环，#109）
-    const dimLabels = {
-        structure: 'D1 结构完整性',
-        content: 'D2 内容质量',
-        dedup: 'D3 去重有效性',
-        maturity: 'D4 成熟度健康',
-        freshness: 'D5 新鲜度',
-        flywheel: 'D6 飞轮验证',
-        incremental: 'D7 增量存活',
+    const data = {
+        healthScore,
+        summary: { total: entries.length, lowRefEntries, staleEntries, consumptionData, refCoverage, avgRefs },
+        issues: issues.slice(0, 50),
     };
-    (0, command_contract_1.log)(io, chalk_1.default.bold('  维度评分:'));
-    for (const [key, dim] of Object.entries(report.dimensions)) {
-        const label = dimLabels[key];
-        const scoreColor = dim.score >= 80 ? chalk_1.default.green : dim.score >= 60 ? chalk_1.default.yellow : chalk_1.default.red;
-        (0, command_contract_1.log)(io, `    ${label}: ${scoreColor(`${dim.score}/100`)} (${dim.issues} 问题)`);
-    }
-    (0, command_contract_1.log)(io);
-    // Issues by rule（label 正本在 audit.ts 规则定义，AUDIT_RULE_LABELS 编译期闭环，#109）
-    for (const [rule, count] of Object.entries(report.summary)) {
-        if (count === 0)
-            continue;
-        const label = audit_1.AUDIT_RULE_LABELS[rule];
-        (0, command_contract_1.log)(io, `  ${chalk_1.default.red(`${label}: ${count}`)}`);
-    }
-    // Detail (first 20)
-    if (report.issues.length > 0) {
-        (0, command_contract_1.log)(io, 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;
-            (0, command_contract_1.log)(io, `  ${severityColor(`[${issue.severity}]`)} ${issue.entryId}: ${issue.title}`);
-            (0, command_contract_1.log)(io, `    ${chalk_1.default.gray(issue.detail)} → ${issue.action}`);
-        }
-        if (report.issues.length > 20) {
-            (0, command_contract_1.log)(io, chalk_1.default.gray(`\n  ... 还有 ${report.issues.length - 20} 条`));
-        }
-    }
-    if (!options.fix && report.issues.length > 0) {
-        (0, command_contract_1.log)(io, chalk_1.default.yellow(`\n  使用 --fix 自动修复`));
-    }
-    // Auto-rebuild index after audit (files may have changed)
-    const baseDir = options.dir || getKnowledgeDir(options.projectPath, io);
-    const idxGen = new index_generator_1.KnowledgeIndexGenerator(baseDir);
-    idxGen.regenerate();
-    if (!options.json) {
-        (0, command_contract_1.log)(io, chalk_1.default.gray(`  📇 索引已重建`));
-    }
-    return { kind: 'ok' };
+    return { data, human: () => ({ sections: healthSections(data) }) };
 }
-/**
- * 知识库快照（KR4 存活率追踪）
- */
-function knowledgeSnapshot(options, io = command_contract_1.processIO) {
-    const store = new store_1.FileKnowledgeStore({ baseDir: options.dir || getKnowledgeDir(options.projectPath, io) });
-    const snapPath = store.snapshot();
-    if (options.json) {
-        (0, command_contract_1.log)(io, JSON.stringify({ snapshotPath: snapPath }));
-        return { kind: 'ok' };
-    }
-    (0, command_contract_1.log)(io, chalk_1.default.green(`✅ 快照已保存: ${snapPath}`));
-    return { kind: 'ok' };
+function healthSections(data) {
+    const { healthScore, summary, issues } = data;
+    const scoreTone = (0, knowledge_view_1.toneForScore)(healthScore);
+    return [
+        {
+            rows: [
+                { cells: [{ label: '🏥 飞轮健康检查', tone: 'heading' }] },
+                (0, knowledge_view_1.blankLine)(),
+                { cells: [
+                        { label: '  健康分: ', tone: 'emph' },
+                        { field: 'healthScore', text: String(healthScore), tone: scoreTone },
+                        { label: '/100', tone: 'emph' },
+                    ] },
+                { cells: [
+                        { label: '  活跃条目: ', tone: 'emph' },
+                        { field: 'summary.total', text: String(summary.total), tone: 'emph' },
+                    ] },
+                (0, knowledge_view_1.blankLine)(),
+            ],
+        },
+        {
+            title: '  数据流状态:',
+            rows: [
+                densityRow('    引用密度: ', 'summary.lowRefEntries', summary.lowRefEntries, ' 个零引用 verified'),
+                densityRow('    新鲜度: ', 'summary.staleEntries', summary.staleEntries, ' 个过期 draft'),
+                { cells: [
+                        { label: '    消费追踪: ' },
+                        summary.consumptionData
+                            ? { label: '✓', tone: 'ok' }
+                            : { field: 'summary.consumptionData', text: '○ 未启用', tone: 'muted' },
+                    ] },
+                (0, knowledge_view_1.blankLine)(),
+            ],
+        },
+        {
+            title: '  飞轮指标:',
+            rows: [
+                { cells: [{ label: '    引用覆盖: ' }, { field: 'summary.refCoverage', text: `${summary.refCoverage}%` }] },
+                { cells: [{ label: '    平均引用: ' }, { field: 'summary.avgRefs', text: String(summary.avgRefs) }] },
+                (0, knowledge_view_1.blankLine)(),
+            ],
+        },
+        {
+            title: '  问题 (前 20):',
+            rows: issues.length === 0
+                ? [{ cells: [{ label: '  ✓ 无问题', tone: 'ok' }] }]
+                : [
+                    ...issues.slice(0, 20).map((issue, i) => ({
+                        cells: [
+                            { field: `issues.${i}.severity`, text: `    [${issue.severity}]`, tone: (0, knowledge_view_1.toneForSeverity)(issue.severity) },
+                            { field: `issues.${i}.entry`, text: ` ${issue.entry}: ` },
+                            { field: `issues.${i}.detail`, text: issue.detail },
+                        ],
+                    })),
+                    // 溢出计数取全量数组，而 json 面的 issues 已截 50 条 → 无字段可锚，登记派生量
+                    ...(issues.length > 20
+                        ? [{ cells: [{ derived: 'healthIssuesOverflow', text: `    ... 还有 ${issues.length - 20} 条`, tone: 'muted' }] }]
+                        : []),
+                ],
+        },
+    ];
 }
-/**
- * 知识库迁移 — 为现有条目添加 AS-021 新字段
- */
-function knowledgeMigrate(options, io = command_contract_1.processIO) {
-    const baseDir = options.dir || getKnowledgeDir(options.projectPath, io);
-    if (options.json) {
-        const result = (0, migration_1.migrateKnowledgeEntries)(baseDir);
-        (0, command_contract_1.log)(io, JSON.stringify(result, null, 2));
-        return { kind: 'ok' };
-    }
-    (0, command_contract_1.log)(io, chalk_1.default.blue('🔄 迁移知识条目（添加 consumptionMode/origin 字段）\n'));
-    const result = (0, migration_1.migrateKnowledgeEntries)(baseDir);
-    (0, command_contract_1.log)(io, chalk_1.default.green(`  总计: ${result.total} 条`));
-    (0, command_contract_1.log)(io, chalk_1.default.green(`  已迁移: ${result.migrated} 条`));
-    (0, command_contract_1.log)(io, chalk_1.default.gray(`  已跳过: ${result.skipped} 条`));
-    if (result.errors.length > 0) {
-        (0, command_contract_1.log)(io, chalk_1.default.red(`\n  错误: ${result.errors.length} 条`));
-        for (const err of result.errors.slice(0, 5)) {
-            (0, command_contract_1.log)(io, chalk_1.default.red(`    ${err}`));
-        }
-    }
-    if (result.migrated === 0 && result.errors.length === 0) {
-        (0, command_contract_1.log)(io, chalk_1.default.green('\n✅ 所有条目已是最新，无需迁移'));
-    }
-    else if (result.migrated > 0) {
-        (0, command_contract_1.log)(io, chalk_1.default.green(`\n✅ 迁移完成`));
-    }
-    return { kind: 'ok' };
+function densityRow(prefix, field, count, suffix) {
+    if (count === 0)
+        return { cells: [{ label: prefix }, { label: '✓', tone: 'ok' }] };
+    return {
+        cells: [
+            { label: prefix },
+            { label: '⚠ ', tone: 'warn' },
+            { field, text: String(count), tone: 'warn' },
+            { label: suffix, tone: 'warn' },
+        ],
+    };
 }
-/**
- * 知识库索引重建 — 生成 _index.md 供 Agent grep 使用，同时同步 index.json
- */
-function knowledgeIndex(options, io = command_contract_1.processIO) {
-    const baseDir = options.dir || getKnowledgeDir(options.projectPath, io);
-    const gen = new index_generator_1.KnowledgeIndexGenerator(baseDir);
-    const beforeSize = (() => {
-        const indexPath = path.join(baseDir, '_index.md');
-        return fs.existsSync(indexPath) ? fs.statSync(indexPath).size : 0;
-    })();
-    const output = gen.regenerate();
-    // Sync index.json from disk files (removes ghost entries from manual mv/rm)
-    const store = new store_1.FileKnowledgeStore({ baseDir });
-    store.rebuildIndex();
-    const afterSize = Buffer.byteLength(output, 'utf-8');
-    const lineCount = output.split('\n').filter(l => !l.startsWith('#')).length;
-    if (options.json) {
-        (0, command_contract_1.log)(io, JSON.stringify({
-            path: path.join(baseDir, '_index.md'),
-            entries: lineCount,
-            size: afterSize,
-            previousSize: beforeSize,
-        }));
-        return { kind: 'ok' };
-    }
-    (0, command_contract_1.log)(io, chalk_1.default.blue(`📇 索引已重建`));
-    (0, command_contract_1.log)(io, chalk_1.default.gray(`  路径: ${path.join(baseDir, '_index.md')}`));
-    (0, command_contract_1.log)(io, chalk_1.default.green(`  条目: ${lineCount}`));
-    (0, command_contract_1.log)(io, chalk_1.default.green(`  大小: ${(afterSize / 1024).toFixed(1)} KB`));
-    if (beforeSize > 0) {
-        (0, command_contract_1.log)(io, chalk_1.default.gray(`  旧大小: ${(beforeSize / 1024).toFixed(1)} KB`));
-    }
-    return { kind: 'ok' };
+async function knowledgeHealth(options, io = command_contract_1.processIO) {
+    return (0, knowledge_view_1.emitKnowledgeView)(io, options, knowledgeHealthView(options, io));
 }
 //# sourceMappingURL=knowledge.js.map