@dommaker/harness 0.16.6 → 0.16.8

package/dist/cli/commands/sync-docs/capabilities-syncer.js

@@ -0,0 +1,235 @@
+"use strict";
+/**
+ * CAPABILITIES.md 同步器（工单 22）
+ *
+ * 支持两种格式：
+ * - 文件表格格式：模块/文件/说明三列表格，增删行维护
+ * - 能力清单格式：计数行（CLI Commands (N) 等），FreshnessRunner 校验与刷新
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCapabilitiesFiles = parseCapabilitiesFiles;
+exports.isCapabilityListingFormat = isCapabilityListingFormat;
+exports.checkCapabilityCounts = checkCapabilityCounts;
+exports.updateCapabilityCounts = updateCapabilityCounts;
+exports.updateCapabilitiesFile = updateCapabilitiesFile;
+const fs = __importStar(require("fs/promises"));
+const definitions_1 = require("../../../core/constraints/definitions");
+const capabilities_parser_1 = require("../../../core/constraints/capabilities-parser");
+const runner_1 = require("../../../core/constraints/doc-freshness/runner");
+/**
+ * 解析 CAPABILITIES.md 中的文件路径
+ *
+ * 提取所有表格行中提到的 .ts/.tsx/.js/.jsx 文件名（不含路径前缀）
+ * 用于模糊匹配：只要文档中提到了该文件名就算已记录
+ */
+async function parseCapabilitiesFiles(capabilitiesPath) {
+    // 工单 19-B：解析收敛到 core/constraints/capabilities-parser；
+    // 此处保持原语义——文件条目取 basename，目录条目（以 / 结尾）原样保留
+    const entries = (0, capabilities_parser_1.readCapabilitiesEntries)(capabilitiesPath, { includeDirs: true });
+    const files = [];
+    for (const entry of entries) {
+        const value = entry.endsWith('/') ? entry : entry.split('/').pop();
+        if (!files.includes(value))
+            files.push(value);
+    }
+    return files;
+}
+/**
+ * 检测 CAPABILITIES.md 是否使用能力清单格式（计数行），而非文件表格格式
+ */
+function isCapabilityListingFormat(content) {
+    // 能力清单格式特征：包含 "CLI Commands (N)" / "Iron Laws (N)" 等计数行
+    return /CLI Commands\s*\(\d+\)/.test(content) ||
+        /Iron Laws?\s*\(\d+\)/.test(content) ||
+        /Guidelines?\s*\(\d+\)/.test(content);
+}
+/**
+ * 构建 CAPABILITIES.md 能力清单格式的检查配置
+ */
+function buildCapabilityChecks() {
+    return [
+        {
+            type: 'doc_regex_count',
+            doc: 'CAPABILITIES.md',
+            label: 'CLI Commands',
+            pattern: 'CLI Commands\\s*\\((\\d+)\\)',
+            actual: { kind: 'dir_count', path: 'src/cli/commands', extension: '.ts', exclude: ['index.ts'] },
+        },
+        {
+            type: 'doc_regex_count',
+            doc: 'CAPABILITIES.md',
+            label: 'Quality Gates',
+            pattern: 'Quality Gates?\\s*\\((\\d+)\\)',
+            actual: { kind: 'dir_count', path: 'src/gates', extension: '.ts', exclude: ['index.ts', 'types.ts'] },
+        },
+        {
+            type: 'doc_regex_count',
+            doc: 'CAPABILITIES.md',
+            label: 'Iron Laws',
+            pattern: 'Iron Laws?\\s*\\((\\d+)\\)',
+            actual: { kind: 'const_count', value: Object.keys(definitions_1.IRON_LAWS).length },
+        },
+        {
+            type: 'doc_regex_count',
+            doc: 'CAPABILITIES.md',
+            label: 'Guidelines',
+            pattern: 'Guidelines?\\s*\\((\\d+)\\)',
+            actual: { kind: 'const_count', value: Object.keys(definitions_1.GUIDELINES).length },
+        },
+        {
+            type: 'doc_regex_count',
+            doc: 'CAPABILITIES.md',
+            label: 'Tips',
+            pattern: 'Tips?\\s*\\((\\d+)\\)',
+            actual: { kind: 'const_count', value: Object.keys(definitions_1.TIPS).length },
+        },
+    ];
+}
+/**
+ * 使用 FreshnessRunner 检查能力清单计数是否与代码一致（--check 模式）
+ */
+function checkCapabilityCounts(projectPath) {
+    const runner = new runner_1.FreshnessRunner();
+    const checks = buildCapabilityChecks();
+    const results = runner.runAll({ checks }, projectPath);
+    const mismatches = [];
+    for (const r of results) {
+        if (!r.pass && r.message) {
+            mismatches.push(r.message);
+        }
+    }
+    return { match: mismatches.length === 0, mismatches };
+}
+/**
+ * 更新 CAPABILITIES.md 中的能力清单计数（write 模式）
+ *
+ * 使用 FreshnessRunner 获取实际计数，然后 regex 替换文档计数行。
+ */
+function updateCapabilityCounts(content, projectPath) {
+    const runner = new runner_1.FreshnessRunner();
+    const cliCount = runner.countFromDir('src/cli/commands', '.ts', ['index.ts'], projectPath);
+    const gateCount = runner.countFromDir('src/gates', '.ts', ['index.ts', 'types.ts'], projectPath);
+    const ironCount = Object.keys(definitions_1.IRON_LAWS).length;
+    const guideCount = Object.keys(definitions_1.GUIDELINES).length;
+    const tipsCount = Object.keys(definitions_1.TIPS).length;
+    const replacements = [
+        [/CLI Commands\s*\(\d+\)/, `CLI Commands (${cliCount})`],
+        [/Quality Gates?\s*\(\d+\)/, `Quality Gates (${gateCount})`],
+        [/Iron Laws?\s*\(\d+\)/, `Iron Laws (${ironCount})`],
+        [/Guidelines?\s*\(\d+\)/, `Guidelines (${guideCount})`],
+        [/Tips?\s*\(\d+\)/, `Tips (${tipsCount})`],
+    ];
+    for (const [regex, replacement] of replacements) {
+        if (regex.test(content)) {
+            content = content.replace(regex, replacement);
+        }
+    }
+    return content;
+}
+/**
+ * 更新 CAPABILITIES.md 文件
+ */
+async function updateCapabilitiesFile(capabilitiesPath, currentModules, existingFiles, result) {
+    let content;
+    try {
+        content = await fs.readFile(capabilitiesPath, 'utf-8');
+    }
+    catch {
+        // 文件不存在，创建新的
+        content = generateCapabilitiesContent(currentModules);
+        await fs.writeFile(capabilitiesPath, content, 'utf-8');
+        return;
+    }
+    // 如果有表格行，更新表格
+    if (existingFiles.length > 0) {
+        // 移除已删除文件的行
+        for (const removed of result.removed) {
+            const escapedFile = removed.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            // 第二列存完整路径，basename 只在末尾出现，用 [^|]* 匹配路径前缀
+            const rowRegex = new RegExp(`^\\|[^|]*\\|[^|]*\\b${escapedFile}\\s*\\|.*$`, 'gm');
+            content = content.replace(rowRegex, '');
+        }
+        // 添加新文件的行（在最后一个表格行之后）
+        if (result.added.length > 0) {
+            const getBasenameLocal = (f) => f.split('/').pop();
+            const addedModules = currentModules.filter(m => result.added.includes(getBasenameLocal(m.file)));
+            const tableEndRegex = /(^\|[^|]+\|[^|]+\|[^|]+\|\s*$)/gm;
+            let lastTableRow = '';
+            let match;
+            while ((match = tableEndRegex.exec(content)) !== null) {
+                lastTableRow = match[0];
+            }
+            if (lastTableRow) {
+                const newRows = addedModules.map(m => `| ${m.name} | ${m.file} | ${m.description} |`).join('\n');
+                content = content.replace(lastTableRow, lastTableRow + '\n' + newRows);
+            }
+        }
+        // 清理多余空行
+        content = content.replace(/\n{3,}/g, '\n\n');
+    }
+    else {
+        // 没有表格，追加模块表格
+        content += '\n\n' + generateModuleTable(currentModules);
+    }
+    // 更新最后更新时间
+    const now = new Date().toISOString().split('T')[0];
+    content = content.replace(/最后更新[:：].*/, `最后更新: ${now}`);
+    await fs.writeFile(capabilitiesPath, content, 'utf-8');
+}
+/**
+ * 生成 CAPABILITIES.md 内容
+ */
+function generateCapabilitiesContent(modules) {
+    const now = new Date().toISOString().split('T')[0];
+    return `# CAPABILITIES.md
+
+> 最后更新: ${now}
+
+---
+
+${generateModuleTable(modules)}
+`;
+}
+/**
+ * 生成模块表格
+ */
+function generateModuleTable(modules) {
+    if (modules.length === 0)
+        return '';
+    const rows = modules.map(m => `| ${m.name} | ${m.file} | ${m.description} |`).join('\n');
+    return `| 模块 | 文件 | 说明 |\n|------|------|------|\n${rows}`;
+}
+//# sourceMappingURL=capabilities-syncer.js.map

package/dist/cli/commands/sync-docs/capabilities-syncer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities-syncer.js","sourceRoot":"","sources":["../../../../src/cli/commands/sync-docs/capabilities-syncer.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/sync-docs/context-syncer.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CONTEXT.md 同步器（工单 22）：缺失模板生成 + 既有文件发现 + 过时判定
+ */
+/**
+ * 创建 CONTEXT.md 模板
+ */
+export declare function createContextMd(projectPath: string, dir: string): Promise<void>;
+/**
+ * 自动发现已有 CONTEXT.md 文件的目录（相对于 projectPath）
+ */
+export declare function findExistingContextFiles(projectPath: string, srcDirs: string[]): Promise<string[]>;
+/**
+ * 获取目录下最新 .ts 文件的修改时间
+ * 返回 null 如果目录不存在或没有 .ts 文件
+ */
+export declare function getLatestTsMtime(dirPath: string): Promise<number | null>;
+//# sourceMappingURL=context-syncer.d.ts.map

package/dist/cli/commands/sync-docs/context-syncer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-syncer.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/sync-docs/context-syncer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;GAEG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BrF;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA+BxG;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0B9E"}

package/dist/cli/commands/sync-docs/context-syncer.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * CONTEXT.md 同步器（工单 22）：缺失模板生成 + 既有文件发现 + 过时判定
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createContextMd = createContextMd;
+exports.findExistingContextFiles = findExistingContextFiles;
+exports.getLatestTsMtime = getLatestTsMtime;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+/**
+ * 创建 CONTEXT.md 模板
+ */
+async function createContextMd(projectPath, dir) {
+    const contextPath = path.join(projectPath, dir, 'CONTEXT.md');
+    const dirName = path.basename(dir);
+    const content = `# ${dirName}
+
+> 此文件描述 ${dir} 目录的职责和上下文。
+> 请阅读本目录的源代码，然后填写以下各节。
+> 如果使用 AI 编码助手，将本文件内容作为 prompt 请求它分析并填写。
+
+## 职责
+
+本目录的核心职责是？
+
+## 核心导出
+
+本目录对外暴露的主要模块/函数：
+
+## 依赖关系
+
+本目录依赖哪些其他模块，谁依赖本目录？
+
+## 注意事项
+
+开发时需要注意的约束或约定：
+`;
+    await fs.mkdir(path.join(projectPath, dir), { recursive: true });
+    await fs.writeFile(contextPath, content, 'utf-8');
+}
+/**
+ * 自动发现已有 CONTEXT.md 文件的目录（相对于 projectPath）
+ */
+async function findExistingContextFiles(projectPath, srcDirs) {
+    const dirs = [];
+    async function scan(dir) {
+        let entries;
+        try {
+            entries = await fs.readdir(dir);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry === 'node_modules' || entry === '__tests__' || entry === 'dist')
+                continue;
+            const entryPath = path.join(dir, entry);
+            const stat = await fs.stat(entryPath);
+            if (stat.isDirectory()) {
+                // 检查该目录是否有 CONTEXT.md
+                try {
+                    await fs.access(path.join(entryPath, 'CONTEXT.md'));
+                    dirs.push(path.relative(projectPath, entryPath));
+                }
+                catch {
+                    // 没有，继续递归
+                }
+                await scan(entryPath);
+            }
+        }
+    }
+    for (const srcDir of srcDirs) {
+        await scan(path.join(projectPath, srcDir));
+    }
+    return dirs;
+}
+/**
+ * 获取目录下最新 .ts 文件的修改时间
+ * 返回 null 如果目录不存在或没有 .ts 文件
+ */
+async function getLatestTsMtime(dirPath) {
+    let latest = null;
+    async function scan(dir) {
+        let entries;
+        try {
+            entries = await fs.readdir(dir);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry === 'node_modules' || entry === '__tests__' || entry === 'dist')
+                continue;
+            const entryPath = path.join(dir, entry);
+            const stat = await fs.stat(entryPath);
+            if (stat.isDirectory()) {
+                await scan(entryPath);
+            }
+            else if (entry.endsWith('.ts') && !entry.endsWith('.d.ts')) {
+                if (latest === null || stat.mtimeMs > latest) {
+                    latest = stat.mtimeMs;
+                }
+            }
+        }
+    }
+    await scan(dirPath);
+    return latest;
+}
+//# sourceMappingURL=context-syncer.js.map

package/dist/cli/commands/sync-docs/context-syncer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-syncer.js","sourceRoot":"","sources":["../../../../src/cli/commands/sync-docs/context-syncer.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/{sync-docs.d.ts → sync-docs/index.d.ts}

@@ -1,8 +1,15 @@
 /**
- * harness sync-docs 命令
+ * harness sync-docs 命令（入口编排，工单 22）
  *
  * 自动同步项目文档：CAPABILITIES.md、CONTEXT.md 检查、CHANGELOG 辅助
  * --check 模式输出结构化信息，供 LLM 或 CI 消费
+ *
+ * 实现拆分：
+ * - project-reader.ts       项目信息读取（package.json/config.yml/源码扫描）
+ * - capabilities-syncer.ts  CAPABILITIES.md 两种格式的对比与维护
+ * - context-syncer.ts       CONTEXT.md 模板生成/发现/过时判定
+ * - agents-syncer.ts        AGENTS.md 生成
+ * - preserve-block.ts       PRESERVE 标记块提取与组合
  */
 export interface SyncDocsOptions {
     /** 项目路径 */
@@ -20,4 +27,4 @@ export interface SyncDocsOptions {
  * 同步文档
  */
 export declare function syncDocs(options: SyncDocsOptions): Promise<boolean>;
-//# sourceMappingURL=sync-docs.d.ts.map
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/sync-docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/sync-docs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAqBH,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wBAAwB;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,oDAAoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAiTzE"}