@skrupellose/code-helper 0.1.0

package/dist/checks.js

@@ -0,0 +1,351 @@
+import { readdir } from "node:fs/promises";
+import { ENTRY_BLOCK_END, ENTRY_BLOCK_START, FEATURE_KEYS } from "./constants.js";
+import { listTasks } from "./archive.js";
+import { loadConfig } from "./config.js";
+import { portablePath, projectPath, readTextIfExists, writeText } from "./fs-utils.js";
+/**
+ * 运行项目协作规则检查。
+ * 检查只读项目结构，并把结果写入 `.code-helper/checks/latest.json`。
+ */
+export async function runChecks(projectRoot) {
+    const config = await loadConfig(projectRoot);
+    const issues = [];
+    if (!config.features.checks.enabled) {
+        return issues;
+    }
+    issues.push(...(await checkConfig(config)));
+    issues.push(...(await checkEntryDocuments(projectRoot, config)));
+    issues.push(...(await checkRuleDocuments(projectRoot, config)));
+    issues.push(...(await checkPlanDirectories(projectRoot, config)));
+    issues.push(...(await checkChineseWorkbenchDocuments(projectRoot, config)));
+    issues.push(...(await checkTestingPolicy(projectRoot, config)));
+    issues.push(...(await checkArchiveState(projectRoot, config)));
+    await writeText(projectPath(projectRoot, `${config.directories.workspace}/checks/latest.json`), `${JSON.stringify({ checkedAt: new Date().toISOString(), issues }, null, 2)}\n`);
+    return issues;
+}
+/**
+ * 检查计划、结果、状态和测试文档是否遵守中文命名规则。
+ * 生成端已经强制中文命名；检查端负责发现用户手动创建或旧文档残留。
+ */
+async function checkChineseWorkbenchDocuments(projectRoot, config) {
+    const issues = [];
+    if (!config.features.planWorkbench.enabled && !config.features.resultSummary.enabled) {
+        return issues;
+    }
+    issues.push(...(await checkPlanDocumentNames(projectRoot, config, config.directories.planDoc)));
+    issues.push(...(await checkPlanDocumentNames(projectRoot, config, portablePath(config.directories.planDoc, "archive"))));
+    issues.push(...(await checkResultDocumentNames(projectRoot, config, config.directories.resultDoc)));
+    issues.push(...(await checkResultDocumentNames(projectRoot, config, portablePath(config.directories.resultDoc, "archive"))));
+    issues.push(...(await checkStatusDocumentNames(projectRoot, config, config.directories.statusDoc)));
+    issues.push(...(await checkStatusDocumentNames(projectRoot, config, portablePath(config.directories.statusDoc, "archive"))));
+    return issues;
+}
+/**
+ * 检查 plan-doc 下的计划文件名。
+ * 计划文件必须是 `<中文功能名>.md`，archive 目录本身会跳过。
+ */
+async function checkPlanDocumentNames(projectRoot, config, relativeDirectory) {
+    const issues = [];
+    const files = await safeReadDirectory(projectPath(projectRoot, relativeDirectory));
+    if (files === undefined) {
+        return issues;
+    }
+    for (const file of files) {
+        if (file === "archive" || file === ".code-helper-keep" || !file.endsWith(".md")) {
+            continue;
+        }
+        const featureName = file.slice(0, -".md".length);
+        if (!containsChinese(featureName)) {
+            issues.push(createChineseNameIssue(portablePath(relativeDirectory, file), "计划文档必须使用中文功能名，例如 订单管理升级.md。"));
+        }
+    }
+    return issues;
+}
+/**
+ * 检查 result-doc 下的任务目录和结果文件。
+ * 任务目录必须是中文功能名，目录内固定使用 实施记录.md 与 手工测试.md。
+ */
+async function checkResultDocumentNames(projectRoot, config, relativeDirectory) {
+    const issues = [];
+    const entries = await safeReadDirectory(projectPath(projectRoot, relativeDirectory));
+    if (entries === undefined) {
+        return issues;
+    }
+    for (const entry of entries) {
+        if (entry === "archive" || entry === ".code-helper-keep" || entry.startsWith(".")) {
+            continue;
+        }
+        const taskDirectory = portablePath(relativeDirectory, entry);
+        if (!containsChinese(entry)) {
+            issues.push(createChineseNameIssue(taskDirectory, "结果目录必须使用中文功能名，例如 订单管理升级/。"));
+        }
+        const files = await safeReadDirectory(projectPath(projectRoot, taskDirectory));
+        if (files === undefined) {
+            continue;
+        }
+        for (const file of files) {
+            if (file.startsWith(".") || !file.endsWith(".md")) {
+                continue;
+            }
+            if (file !== "实施记录.md" && file !== "手工测试.md") {
+                issues.push(createChineseNameIssue(portablePath(taskDirectory, file), "结果文件必须使用中文命名，固定使用 实施记录.md 或 手工测试.md。"));
+            }
+        }
+    }
+    return issues;
+}
+/**
+ * 检查 status-doc 下的状态文件名。
+ * 状态文件必须是 `<中文功能名>-状态.md`，旧版 `-status.md` 会被识别为不合规。
+ */
+async function checkStatusDocumentNames(projectRoot, config, relativeDirectory) {
+    const issues = [];
+    const files = await safeReadDirectory(projectPath(projectRoot, relativeDirectory));
+    if (files === undefined) {
+        return issues;
+    }
+    for (const file of files) {
+        if (file === "archive" || file === ".code-helper-keep" || !file.endsWith(".md")) {
+            continue;
+        }
+        if (!file.endsWith("-状态.md")) {
+            issues.push(createChineseNameIssue(portablePath(relativeDirectory, file), "状态文档必须使用 <中文功能名>-状态.md。"));
+            continue;
+        }
+        const featureName = file.slice(0, -"-状态.md".length);
+        if (!containsChinese(featureName)) {
+            issues.push(createChineseNameIssue(portablePath(relativeDirectory, file), "状态文档的功能名必须包含中文。"));
+        }
+    }
+    return issues;
+}
+/**
+ * 构造中文命名违规问题。
+ * 集中创建可保持 code、message 和修复建议一致。
+ */
+function createChineseNameIssue(path, suggestion) {
+    return {
+        level: "error",
+        code: "non-chinese-document-name",
+        message: `文档未使用中文命名：${path}`,
+        path,
+        suggestion
+    };
+}
+/**
+ * 判断字符串是否包含中文字符。
+ * 文档命名规则要求任务名至少包含一个中文字符。
+ */
+function containsChinese(value) {
+    return /\p{Script=Han}/u.test(value);
+}
+/**
+ * 检查文档归档目录和任务状态。
+ * archive 中的任务视为已结束；同名任务同时存在 active 与 archive 时提示人工确认。
+ */
+async function checkArchiveState(projectRoot, config) {
+    const issues = [];
+    if (!config.features.documentArchive.enabled) {
+        return issues;
+    }
+    for (const directory of [
+        `${config.directories.planDoc}/archive`,
+        `${config.directories.resultDoc}/archive`,
+        `${config.directories.statusDoc}/archive`
+    ]) {
+        const files = await safeReadDirectory(projectPath(projectRoot, directory));
+        if (files === undefined) {
+            issues.push({
+                level: "error",
+                code: "missing-archive-directory",
+                message: `归档目录不存在：${directory}`,
+                path: directory,
+                suggestion: "运行 `npx @skrupellose/code-helper init` 创建文档归档目录。"
+            });
+        }
+    }
+    for (const task of await listTasks(projectRoot)) {
+        if (task.status === "mixed") {
+            issues.push({
+                level: "warning",
+                code: "mixed-task-archive-state",
+                message: `任务同时存在活动文档和归档文档：${task.featureName}`,
+                suggestion: "确认该任务是否已经结束；如果已结束，运行 `npx @skrupellose/code-helper archive <中文功能名>` 或手动补齐归档。"
+            });
+        }
+    }
+    return issues;
+}
+/**
+ * 检查配置本身是否保持完整。
+ * 这能发现用户手工编辑 config.json 时误删功能项的问题。
+ */
+async function checkConfig(config) {
+    const issues = [];
+    for (const feature of FEATURE_KEYS) {
+        if (config.features[feature] === undefined) {
+            issues.push({
+                level: "error",
+                code: "missing-feature-toggle",
+                message: `配置缺少功能开关：${feature}`,
+                path: ".code-helper/config.json",
+                suggestion: "重新运行 `npx @skrupellose/code-helper init`，让工具补齐默认配置。"
+            });
+        }
+    }
+    return issues;
+}
+/**
+ * 检查入口文档是否存在 code-helper 管理区块。
+ * 入口文档是 agent 发现专题规则的第一站，因此缺失时给 error。
+ */
+async function checkEntryDocuments(projectRoot, config) {
+    const issues = [];
+    const entryFiles = [
+        config.entryFiles.agents ? "AGENTS.md" : undefined,
+        config.entryFiles.claude ? "CLAUDE.md" : undefined
+    ].filter((file) => file !== undefined);
+    for (const entryFile of entryFiles) {
+        const content = await readTextIfExists(projectPath(projectRoot, entryFile));
+        if (content === undefined) {
+            issues.push({
+                level: "error",
+                code: "missing-entry-document",
+                message: `入口文档不存在：${entryFile}`,
+                path: entryFile,
+                suggestion: "运行 `npx @skrupellose/code-helper init` 创建入口文档。"
+            });
+            continue;
+        }
+        if (!content.includes(ENTRY_BLOCK_START) || !content.includes(ENTRY_BLOCK_END)) {
+            issues.push({
+                level: "error",
+                code: "missing-managed-block",
+                message: `入口文档缺少 code-helper 受控区块：${entryFile}`,
+                path: entryFile,
+                suggestion: "运行 `npx @skrupellose/code-helper init` 追加受控索引区块。"
+            });
+        }
+    }
+    return issues;
+}
+/**
+ * 检查专题规则文档结构。
+ * 每份规则都要包含固定四段，这样 agent 可以稳定读取和执行。
+ */
+async function checkRuleDocuments(projectRoot, config) {
+    const issues = [];
+    const rulesDirectory = projectPath(projectRoot, config.directories.userRules);
+    const requiredSections = ["## 功能描述", "## 调用时机", "## 调用入口文件", "## 规则"];
+    let files = [];
+    try {
+        files = await readdir(rulesDirectory);
+    }
+    catch {
+        issues.push({
+            level: "error",
+            code: "missing-user-rules-directory",
+            message: "专题规则目录不存在",
+            path: config.directories.userRules,
+            suggestion: "运行 `npx @skrupellose/code-helper init` 创建专题规则目录和默认规则。"
+        });
+        return issues;
+    }
+    const markdownFiles = files.filter((file) => file.endsWith(".md"));
+    if (markdownFiles.length === 0) {
+        issues.push({
+            level: "error",
+            code: "empty-user-rules-directory",
+            message: "专题规则目录中没有 Markdown 规则文件",
+            path: config.directories.userRules,
+            suggestion: "运行 `npx @skrupellose/code-helper init` 安装默认专题规则。"
+        });
+    }
+    for (const file of markdownFiles) {
+        const relativePath = portablePath(config.directories.userRules, file);
+        const content = await readTextIfExists(projectPath(projectRoot, relativePath));
+        for (const section of requiredSections) {
+            if (!content?.includes(section)) {
+                issues.push({
+                    level: "error",
+                    code: "invalid-rule-document",
+                    message: `专题规则缺少小节 ${section}：${file}`,
+                    path: relativePath,
+                    suggestion: "补齐“功能描述 / 调用时机 / 调用入口文件 / 规则”四个小节。"
+                });
+            }
+        }
+    }
+    return issues;
+}
+/**
+ * 检查计划、结果和状态目录是否存在。
+ * 这些目录是项目计划文档的固定落点。
+ */
+async function checkPlanDirectories(projectRoot, config) {
+    const issues = [];
+    if (!config.features.planWorkbench.enabled && !config.features.resultSummary.enabled) {
+        return issues;
+    }
+    for (const directory of [config.directories.planDoc, config.directories.resultDoc, config.directories.statusDoc]) {
+        const marker = await readTextIfExists(projectPath(projectRoot, `${directory}/.code-helper-keep`));
+        const files = await safeReadDirectory(projectPath(projectRoot, directory));
+        if (marker === undefined && files === undefined) {
+            issues.push({
+                level: "error",
+                code: "missing-workbench-directory",
+                message: `计划文档目录不存在：${directory}`,
+                path: directory,
+                suggestion: "运行 `npx @skrupellose/code-helper init` 创建计划、结果和状态目录。"
+            });
+        }
+    }
+    return issues;
+}
+/**
+ * 检查测试策略是否已经安装。
+ * 如果用户关闭 testingPolicy，则跳过该检查。
+ */
+async function checkTestingPolicy(projectRoot, config) {
+    if (!config.features.testingPolicy.enabled) {
+        return [];
+    }
+    const policyPath = `${config.directories.userRules}/测试策略规范.md`;
+    const content = await readTextIfExists(projectPath(projectRoot, policyPath));
+    if (content === undefined) {
+        return [
+            {
+                level: "error",
+                code: "missing-testing-policy",
+                message: "缺少测试策略规范",
+                path: policyPath,
+                suggestion: "运行 `npx @skrupellose/code-helper init` 安装默认测试策略规范。"
+            }
+        ];
+    }
+    if (!content.includes("页面相关测试全部生成严格手工测试文档")) {
+        return [
+            {
+                level: "warning",
+                code: "testing-policy-weakened",
+                message: "测试策略规范可能缺少页面手工测试约束",
+                path: policyPath,
+                suggestion: "补充页面测试只生成手工测试文档、工具只执行纯逻辑测试的规则。"
+            }
+        ];
+    }
+    return [];
+}
+/**
+ * 安全读取目录。
+ * 不存在时返回 undefined，避免检查流程因单个目录缺失中断。
+ */
+async function safeReadDirectory(path) {
+    try {
+        return await readdir(path);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=checks.js.map

package/dist/checks.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,5 @@
+/**
+ * CLI 主入口。
+ * 支持子命令，也支持无参数时进入交互菜单。
+ */
+export declare function runCli(argv: string[], projectRoot?: string): Promise<number>;