@dommaker/harness 0.16.0 → 0.16.2

package/dist/cli/commands/spec-baseline-check.js

@@ -0,0 +1,366 @@
+"use strict";
+/**
+ * harness spec-baseline-check 命令
+ *
+ * 验证 spec 文件的前置条件（Baseline / 前置条件）是否满足。
+ * 纯代码操作，零 LLM 调用。
+ */
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractBaselineSection = extractBaselineSection;
+exports.specBaselineCheck = specBaselineCheck;
+const chalk_1 = __importDefault(require("chalk"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// ============================================
+// 解析器
+// ============================================
+/**
+ * 从 spec 内容中提取 Baseline/前置条件 section
+ */
+function extractBaselineSection(content) {
+    const lines = content.split('\n');
+    const prerequisites = [];
+    // 查找 ## Baseline 或 ## 前置条件 section
+    let inSection = false;
+    let sectionLevel = 0;
+    for (const line of lines) {
+        const headerMatch = line.match(/^(#{1,6})\s+(.+)/);
+        if (headerMatch) {
+            const level = headerMatch[1].length;
+            const title = headerMatch[2].trim();
+            // 检查是否是目标 section
+            if (/^(Baseline|前置条件|Prerequisites|Prereqs)$/i.test(title)) {
+                inSection = true;
+                sectionLevel = level;
+                continue;
+            }
+            // 同级或更高级的标题结束 section
+            if (inSection && level <= sectionLevel) {
+                inSection = false;
+                continue;
+            }
+        }
+        // 在 section 中提取列表项
+        if (inSection) {
+            const listMatch = line.match(/^\s*[-*+]\s+(.+)/);
+            if (listMatch) {
+                prerequisites.push(listMatch[1].trim());
+            }
+            // 也支持编号列表
+            const numberedMatch = line.match(/^\s*\d+\.\s+(.+)/);
+            if (numberedMatch) {
+                prerequisites.push(numberedMatch[1].trim());
+            }
+        }
+    }
+    return prerequisites;
+}
+// ============================================
+// 验证器
+// ============================================
+/**
+ * 检查文件/目录是否存在
+ */
+function checkFileExists(pattern, projectPath) {
+    // 提取路径引用（反引号中的路径、引号中的路径、或直接的路径模式）
+    const pathPatterns = [
+        /`([^`]+\.[a-z]+)`/g, // `src/foo.ts`
+        /["']([^"']+\.[a-z]+)["']/g, // "src/foo.ts"
+        /`([^`]+\/)`/g, // `src/foo/`
+        /(\S+\/\S+\.[a-z]+)/g, // src/foo.ts
+    ];
+    const paths = [];
+    for (const p of pathPatterns) {
+        p.lastIndex = 0;
+        let m;
+        while ((m = p.exec(pattern)) !== null) {
+            paths.push(m[1]);
+        }
+    }
+    if (paths.length === 0) {
+        return { exists: false, evidence: '无法从描述中提取路径' };
+    }
+    const found = [];
+    const missing = [];
+    for (const p of paths) {
+        const fullPath = path.resolve(projectPath, p);
+        if (fs.existsSync(fullPath)) {
+            found.push(p);
+        }
+        else {
+            missing.push(p);
+        }
+    }
+    if (missing.length === 0 && found.length > 0) {
+        return { exists: true, evidence: `文件存在: ${found.join(', ')}` };
+    }
+    if (found.length > 0) {
+        return { exists: false, evidence: `部分存在: ${found.join(', ')}; 缺失: ${missing.join(', ')}` };
+    }
+    return { exists: false, evidence: `文件不存在: ${missing.join(', ')}` };
+}
+/**
+ * 检查代码中是否存在特定模式
+ */
+function checkCodePattern(pattern, projectPath) {
+    // 从描述中提取关键词
+    const keywords = [];
+    // 提取反引号中的代码
+    const codePatterns = pattern.match(/`([^`]+)`/g);
+    if (codePatterns) {
+        for (const cp of codePatterns) {
+            const inner = cp.slice(1, -1);
+            if (inner.length >= 2) {
+                keywords.push(inner);
+            }
+        }
+    }
+    // 提取 "implemented" / "exists" / "已实现" 等关键词后的内容
+    const implMatch = pattern.match(/(?:implemented|exists|已实现|已完成|已存在)[\s:：]+(.+)/i);
+    if (implMatch) {
+        keywords.push(implMatch[1].trim());
+    }
+    if (keywords.length === 0) {
+        return { exists: false, evidence: '无法从描述中提取搜索关键词' };
+    }
+    const found = [];
+    const notFound = [];
+    for (const kw of keywords) {
+        let count = 0;
+        function walkDir(dir) {
+            let entries;
+            try {
+                entries = fs.readdirSync(dir, { withFileTypes: true });
+            }
+            catch {
+                return;
+            }
+            for (const entry of entries) {
+                if (entry.name.startsWith('.') || entry.name === 'node_modules' || entry.name === 'dist')
+                    continue;
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    walkDir(fullPath);
+                }
+                else if (entry.isFile() && (fullPath.endsWith('.ts') || fullPath.endsWith('.js'))) {
+                    try {
+                        const content = fs.readFileSync(fullPath, 'utf-8');
+                        if (content.includes(kw))
+                            count++;
+                    }
+                    catch { /* skip */ }
+                }
+            }
+        }
+        walkDir(projectPath);
+        if (count > 0) {
+            found.push(`${kw} (${count} files)`);
+        }
+        else {
+            notFound.push(kw);
+        }
+    }
+    if (notFound.length === 0 && found.length > 0) {
+        return { exists: true, evidence: `代码中找到: ${found.join(', ')}` };
+    }
+    if (found.length > 0) {
+        return { exists: false, evidence: `找到: ${found.join(', ')}; 未找到: ${notFound.join(', ')}` };
+    }
+    return { exists: false, evidence: `代码中未找到: ${notFound.join(', ')}` };
+}
+/**
+ * 检查包依赖是否安装
+ */
+function checkDependency(pattern, projectPath) {
+    // 提取包名
+    const pkgPatterns = [
+        /`(@?[\w-]+\/[\w-]+)`/g, // `@scope/pkg` or `pkg-name`
+        /`([\w-]+)`/g, // `pkg`
+        /install(?:ed)?\s+(\S+)/gi, // installed pkg-name
+    ];
+    const packages = [];
+    for (const p of pkgPatterns) {
+        p.lastIndex = 0;
+        let m;
+        while ((m = p.exec(pattern)) !== null) {
+            const pkg = m[1];
+            if (pkg.length >= 2 && !pkg.includes('/') && !pkg.includes('.')) {
+                packages.push(pkg);
+            }
+        }
+    }
+    if (packages.length === 0) {
+        return { exists: false, evidence: '无法从描述中提取包名' };
+    }
+    const found = [];
+    const missing = [];
+    const pkgJsonPath = path.join(projectPath, 'package.json');
+    let deps = {};
+    try {
+        const pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf-8'));
+        deps = { ...pkgJson.dependencies, ...pkgJson.devDependencies };
+    }
+    catch {
+        return { exists: false, evidence: '无法读取 package.json' };
+    }
+    for (const pkg of packages) {
+        if (deps[pkg] || deps[`@types/${pkg}`]) {
+            found.push(pkg);
+        }
+        else {
+            // 检查 node_modules
+            const nmPath = path.join(projectPath, 'node_modules', pkg);
+            if (fs.existsSync(nmPath)) {
+                found.push(pkg);
+            }
+            else {
+                missing.push(pkg);
+            }
+        }
+    }
+    if (missing.length === 0 && found.length > 0) {
+        return { exists: true, evidence: `依赖已安装: ${found.join(', ')}` };
+    }
+    if (found.length > 0) {
+        return { exists: false, evidence: `已安装: ${found.join(', ')}; 缺失: ${missing.join(', ')}` };
+    }
+    return { exists: false, evidence: `依赖缺失: ${missing.join(', ')}` };
+}
+/**
+ * 综合验证一条前置条件
+ */
+function verifyPrerequisite(prereq, projectPath) {
+    const lower = prereq.toLowerCase();
+    // 路径/文件存在性检查
+    if (lower.includes('文件') || lower.includes('file') || lower.includes('目录') || lower.includes('directory')
+        || /`[^`]+\.[a-z]+`/.test(prereq) || /\//.test(prereq)) {
+        const { exists, evidence } = checkFileExists(prereq, projectPath);
+        if (exists || evidence.includes('文件不存在')) {
+            return { prerequisite: prereq, satisfied: exists, evidence };
+        }
+    }
+    // 依赖检查
+    if (lower.includes('依赖') || lower.includes('install') || lower.includes('package') || lower.includes('npm')) {
+        const { exists, evidence } = checkDependency(prereq, projectPath);
+        return { prerequisite: prereq, satisfied: exists, evidence };
+    }
+    // 代码模式检查
+    if (lower.includes('实现') || lower.includes('implement') || lower.includes('exist')
+        || lower.includes('已') || lower.includes('必须')
+        || /`[^`]+`/.test(prereq)) {
+        const { exists, evidence } = checkCodePattern(prereq, projectPath);
+        return { prerequisite: prereq, satisfied: exists, evidence };
+    }
+    // 默认：无法自动验证
+    return {
+        prerequisite: prereq,
+        satisfied: true,
+        evidence: '无法自动验证（需人工确认）',
+    };
+}
+// ============================================
+// 输出格式化
+// ============================================
+function formatTable(results) {
+    if (results.length === 0)
+        return chalk_1.default.yellow('未找到 Baseline / 前置条件 section');
+    const lines = [];
+    lines.push(chalk_1.default.blue(`前置条件检查 (${results.length} 条)\n`));
+    const satisfied = results.filter(r => r.satisfied).length;
+    const failed = results.filter(r => !r.satisfied);
+    lines.push(chalk_1.default.bold(`  满足: ${satisfied}/${results.length}`));
+    if (failed.length > 0) {
+        lines.push(chalk_1.default.red(`  未满足: ${failed.length}\n`));
+    }
+    else {
+        lines.push(chalk_1.default.green('  全部满足\n'));
+    }
+    for (const r of results) {
+        const icon = r.satisfied ? chalk_1.default.green('✓') : chalk_1.default.red('✗');
+        lines.push(`  ${icon} ${r.prerequisite}`);
+        if (!r.satisfied) {
+            lines.push(`    ${chalk_1.default.yellow(r.evidence)}`);
+        }
+    }
+    return lines.join('\n');
+}
+// ============================================
+// 主入口
+// ============================================
+/**
+ * spec-baseline-check CLI 命令
+ */
+async function specBaselineCheck(specPath, options = {}) {
+    // 验证文件存在
+    const resolvedPath = path.resolve(specPath);
+    if (!fs.existsSync(resolvedPath)) {
+        console.error(chalk_1.default.red(`文件不存在: ${resolvedPath}`));
+        process.exitCode = 1;
+        return;
+    }
+    const projectPath = options.projectPath || path.dirname(resolvedPath);
+    // 读取 spec
+    const content = fs.readFileSync(resolvedPath, 'utf-8');
+    // 提取前置条件
+    const prerequisites = extractBaselineSection(content);
+    if (prerequisites.length === 0) {
+        if (options.json) {
+            console.log(JSON.stringify({ prerequisites: [], message: '未找到 Baseline / 前置条件 section' }, null, 2));
+        }
+        else {
+            console.log(chalk_1.default.yellow('未找到 ## Baseline 或 ## 前置条件 section'));
+        }
+        return;
+    }
+    // 验证每条前置条件
+    const results = prerequisites.map(p => verifyPrerequisite(p, projectPath));
+    // 输出
+    if (options.json) {
+        console.log(JSON.stringify(results, null, 2));
+    }
+    else {
+        console.log(formatTable(results));
+    }
+    // 有未满足的前置条件时 exit 1
+    const failed = results.filter(r => !r.satisfied);
+    if (failed.length > 0) {
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=spec-baseline-check.js.map

package/dist/cli/commands/spec-baseline-check.js.map

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

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

@@ -13,6 +13,8 @@ export interface SyncDocsOptions {
     changelog?: boolean;
     /** 输出 JSON 格式（供 LLM 消费） */
     json?: boolean;
+    /** 同步 AGENTS.md（agent 导读），在默认章节之外追加 */
+    agents?: boolean;
 }
 /**
  * 同步文档

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

@@ -1 +1 @@
-{"version":3,"file":"sync-docs.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/sync-docs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,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;CAChB;AAeD;;GAEG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CA2NzE"}
+{"version":3,"file":"sync-docs.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/sync-docs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,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,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAeD;;GAEG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAoQzE"}