cgraphx 1.4.3 → 2.0.0

package/dist/core/features/scanner.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * features 索引扫描器。
+ *
+ * 单一职责:把 <project>/docs/features/ 下的每个子目录解析成一个
+ * FeatureEntry。头部元数据(负责人/日期)优先级:spec 文件头部 > plan/index 头部 > 目录名。
+ *
+ * 头部行约定(与 write-spec / write-plan 的产物头部一致):
+ *
+ *   # 规格说明: <需求名称>
+ *   > feature-id: <feature-id>
+ *   > 负责人: 张三
+ *   > 日期: YYYY-MM-DD
+ *
+ * 需求阶段不读头部,由产物存在性派生(deriveStage):有测试报告 → 已验证,
+ * 有 plan → 已规划,有 spec → 已规格,都没有 → null(未规格)。
+ */
+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.FEATURES_DIR = void 0;
+exports.scanFeatures = scanFeatures;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+/** 扫描目录(仓库相对)。 */
+exports.FEATURES_DIR = path.join('docs', 'features');
+/** feature-id 目录名:日期前缀 + 标题(标题可能含 [业务ID-] 段,不强行拆)。 */
+const FEATURE_ID_PATTERN = /^(\d{4}-\d{2}-\d{2})-(.+)$/;
+/** 只读文件头部这么多行找元数据,头部之后没有要解析的东西。 */
+const HEADER_SCAN_LINES = 30;
+/** 从文件头部提取 负责人/日期;读不了或没有都返回 null 字段(容错)。 */
+function readHeaderMeta(file) {
+    const meta = { owner: null, date: null };
+    let text;
+    try {
+        text = fs.readFileSync(file, 'utf-8');
+    }
+    catch {
+        return meta;
+    }
+    const lines = text.split('\n').slice(0, HEADER_SCAN_LINES);
+    for (const line of lines) {
+        const m = /^>\s*(负责人|日期)\s*[:：]\s*(.+?)\s*$/.exec(line);
+        if (!m)
+            continue;
+        const key = m[1];
+        const value = m[2];
+        if (!key || value === undefined || value === '')
+            continue;
+        if (key === '负责人')
+            meta.owner = value;
+        else
+            meta.date = value;
+    }
+    return meta;
+}
+/** plan/ 子目录里是否有 index 文件(*-index.md 或 index.md)。 */
+function hasPlanIndex(featureDir) {
+    try {
+        return fs
+            .readdirSync(path.join(featureDir, 'plan'))
+            .some((n) => n.endsWith('-index.md') || n === 'index.md');
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 在一个 feature 目录里找元数据文件(读 负责人/日期 用):先 *-spec.md(或 spec.md),
+ * 再 plan/*-index.md(或 plan/index.md)。都没有 → null(仅目录名可解析)。
+ */
+function findMetaFile(featureDir) {
+    let entries;
+    try {
+        entries = fs.readdirSync(featureDir);
+    }
+    catch {
+        return null;
+    }
+    const spec = entries
+        .filter((n) => n.endsWith('-spec.md') || n === 'spec.md')
+        .sort()[0];
+    if (spec) {
+        return path.join(featureDir, spec);
+    }
+    try {
+        const planEntries = fs.readdirSync(path.join(featureDir, 'plan'));
+        const index = planEntries
+            .filter((n) => n.endsWith('-index.md') || n === 'index.md')
+            .sort()[0];
+        if (index) {
+            return path.join(featureDir, 'plan', index);
+        }
+    }
+    catch {
+        // 没有 plan 目录,落到目录名解析
+    }
+    return null;
+}
+/**
+ * 从需求目录的产物存在性派生阶段(实时,不落盘):
+ *   有测试报告 → 已验证;否则有 plan → 已规划;否则有 spec → 已规格;都没有 → null(未规格)。
+ *
+ * 优先级 已验证 > 已规划 > 已规格,三个里程碑各自独立探测(允许跨阶,
+ * 如 spec + 测试报告但无 plan → 已验证)。已验证只看测试「报告」(run-api-test
+ * 的 *-测试报告.md / write-unit-test-code 的 *-单元测试报告.md),测试「规格」不算。
+ */
+function deriveStage(featureDir) {
+    let entries;
+    try {
+        entries = fs.readdirSync(featureDir);
+    }
+    catch {
+        return null;
+    }
+    const hasReport = entries.some((n) => n.endsWith('-单元测试报告.md') || n.endsWith('-测试报告.md'));
+    if (hasReport)
+        return '已验证';
+    if (hasPlanIndex(featureDir))
+        return '已规划';
+    const hasSpec = entries.some((n) => n.endsWith('-spec.md') || n === 'spec.md');
+    if (hasSpec)
+        return '已规格';
+    return null;
+}
+/**
+ * 扫描 <projectRoot>/docs/features/,每个子目录解析为一个 FeatureEntry。
+ * 目录不存在或不可读 → 返回空数组(不是错误:项目可能没用 features 流程)。
+ * 结果按日期倒序、标题升序排好。
+ */
+function scanFeatures(projectRoot) {
+    const featuresRoot = path.join(projectRoot, exports.FEATURES_DIR);
+    let dirNames;
+    try {
+        dirNames = fs
+            .readdirSync(featuresRoot, { withFileTypes: true })
+            .filter((e) => e.isDirectory())
+            .map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+    const posixFeaturesDir = exports.FEATURES_DIR.split(path.sep).join('/');
+    const result = [];
+    for (const name of dirNames) {
+        const m = FEATURE_ID_PATTERN.exec(name);
+        const dateFromName = m?.[1] ?? null;
+        const title = m?.[2] ?? name;
+        const featureDir = path.join(featuresRoot, name);
+        const metaFile = findMetaFile(featureDir);
+        const meta = metaFile
+            ? readHeaderMeta(metaFile)
+            : { owner: null, date: null };
+        result.push({
+            featureId: name,
+            date: meta.date ?? dateFromName,
+            title,
+            owner: meta.owner,
+            stage: deriveStage(featureDir),
+            path: `${posixFeaturesDir}/${name}`,
+        });
+    }
+    result.sort((a, b) => (b.date ?? '').localeCompare(a.date ?? '') ||
+        a.title.localeCompare(b.title));
+    return result;
+}
+//# sourceMappingURL=scanner.js.map

package/dist/core/features/scanner.js.map

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

package/dist/core/features/sync.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 本人需求索引生成(本地文件,不进 git)。
+ *
+ * 把 `list --mine` 的结果固化为 `.cgraphx/my-features.md`:查询是实时的,
+ * 这个文件只是随手的快照——每次 `cgraphx features sync` 全量重写,
+ * 永不手维护,所以不会陈旧。放在 .cgraphx/ 下天然是 gitignore 的
+ * 运行时数据(没有 .gitignore 时补一个 `*` 兜底),每人每机一份。
+ */
+/** 生成的索引文件名(位于项目 .cgraphx/ 下)。 */
+export declare const MY_FEATURES_FILENAME = "my-features.md";
+/** 取当前 git 用户名;取不到(非 git 环境 / 未配置)→ null。 */
+export declare function gitUserName(): string | null;
+export interface SyncResult {
+    /** 生成的索引文件绝对路径。 */
+    file: string;
+    /** 收录的需求数。 */
+    count: number;
+    /** 负责人(git 用户名或显式覆盖值)。 */
+    owner: string;
+}
+/**
+ * 重新生成本人需求索引 → <projectRoot>/.cgraphx/my-features.md。
+ * 幂等:每次全量重写。owner 缺省取 git config user.name,也可显式传入(测试用)。
+ */
+export declare function syncMyFeatures(projectRoot: string, owner?: string): SyncResult;
+//# sourceMappingURL=sync.d.ts.map

package/dist/core/features/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/core/features/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,kCAAkC;AAClC,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AAErD,6CAA6C;AAC7C,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAU3C;AA2BD,MAAM,WAAW,UAAU;IACzB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,GACb,UAAU,CAmBZ"}

package/dist/core/features/sync.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * 本人需求索引生成(本地文件,不进 git)。
+ *
+ * 把 `list --mine` 的结果固化为 `.cgraphx/my-features.md`:查询是实时的,
+ * 这个文件只是随手的快照——每次 `cgraphx features sync` 全量重写,
+ * 永不手维护,所以不会陈旧。放在 .cgraphx/ 下天然是 gitignore 的
+ * 运行时数据(没有 .gitignore 时补一个 `*` 兜底),每人每机一份。
+ */
+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.MY_FEATURES_FILENAME = void 0;
+exports.gitUserName = gitUserName;
+exports.syncMyFeatures = syncMyFeatures;
+const node_child_process_1 = require("node:child_process");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const index_1 = require("./index");
+/** 生成的索引文件名(位于项目 .cgraphx/ 下)。 */
+exports.MY_FEATURES_FILENAME = 'my-features.md';
+/** 取当前 git 用户名;取不到(非 git 环境 / 未配置)→ null。 */
+function gitUserName() {
+    try {
+        const name = (0, node_child_process_1.execFileSync)('git', ['config', 'user.name'], {
+            encoding: 'utf-8',
+            timeout: 3000,
+        }).trim();
+        return name === '' ? null : name;
+    }
+    catch {
+        return null;
+    }
+}
+/** Markdown 转义:表格单元里的 `|` 要转义,换行压成空格。 */
+function mdCell(s) {
+    return s.replace(/\|/g, '\\|').replace(/\s*\n\s*/g, ' ');
+}
+function renderMarkdownIndex(owner, rows) {
+    const lines = [
+        '# 我的需求索引(自动生成,勿手改)',
+        '',
+        `> 负责人:${owner} · 共 ${rows.length} 个需求 · 重新生成:\`cgraphx features sync\``,
+        '',
+        '| 日期 | 阶段 | 标题 | 目录 |',
+        '|---|---|---|---|',
+    ];
+    for (const r of rows) {
+        lines.push(`| ${mdCell(r.date ?? '-')} | ${mdCell(r.stage ?? '-')} | ${mdCell(r.title)} | ${mdCell(r.path)}/ |`);
+    }
+    if (rows.length === 0) {
+        lines.push('', '_(还没有以你为负责人的需求目录;write-spec/write-plan 创建时会声明负责人。)_');
+    }
+    return lines.join('\n') + '\n';
+}
+/**
+ * 重新生成本人需求索引 → <projectRoot>/.cgraphx/my-features.md。
+ * 幂等:每次全量重写。owner 缺省取 git config user.name,也可显式传入(测试用)。
+ */
+function syncMyFeatures(projectRoot, owner) {
+    const who = owner ?? gitUserName();
+    if (who === null) {
+        throw new Error('无法从 git config 读取 user.name,无法确定"本人";请配置 git 用户或显式指定。');
+    }
+    const rows = (0, index_1.listFeatures)(projectRoot, { owner: who });
+    const cgraphxDir = path.join(projectRoot, '.cgraphx');
+    fs.mkdirSync(cgraphxDir, { recursive: true });
+    // 兜底:.cgraphx/ 是运行时数据,不该进 git(cgraphx init 也会写这个文件)
+    const gitignore = path.join(cgraphxDir, '.gitignore');
+    if (!fs.existsSync(gitignore)) {
+        fs.writeFileSync(gitignore, '*\n', 'utf-8');
+    }
+    const file = path.join(cgraphxDir, exports.MY_FEATURES_FILENAME);
+    fs.writeFileSync(file, renderMarkdownIndex(who, rows), 'utf-8');
+    return { file, count: rows.length, owner: who };
+}
+//# sourceMappingURL=sync.js.map

package/dist/core/features/sync.js.map

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

package/dist/core/features/types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * features 子系统的类型定义。
+ *
+ * 无 DB、无 schema:索引是 docs/features/ 目录树的纯派生视图,
+ * 每次查询实时扫描文件系统,永不持久化——不会陈旧。
+ */
+/** 需求阶段:由 docs/features/ 产物存在性实时派生,不写入任何文件。 */
+export declare const FEATURE_STAGES: readonly ["已规格", "已规划", "已验证"];
+/** 派生阶段类型(null = 未规格,无任何可识别产物)。 */
+export type FeatureStage = (typeof FEATURE_STAGES)[number];
+/** 一个需求目录的索引条目。 */
+export interface FeatureEntry {
+    /** 目录名,即 feature-id(格式 YYYY-MM-DD-[业务ID-]<标题>)。 */
+    featureId: string;
+    /** 从目录名或文档头部解析的日期;解析不到为 null。 */
+    date: string | null;
+    /** 需求标题(目录名去掉日期前缀)。 */
+    title: string;
+    /** 负责人(文档头部 `> 负责人:` 行);未声明为 null。 */
+    owner: string | null;
+    /** 派生阶段(已规格/已规划/已验证);无可识别产物为 null(未规格)。 */
+    stage: FeatureStage | null;
+    /** 仓库相对 POSIX 路径,如 docs/features/2026-07-26-X。 */
+    path: string;
+}
+/** list 的过滤条件;全部可选,多条件取交集。 */
+export interface FeatureFilter {
+    /** 负责人精确匹配(大小写敏感)。 */
+    owner?: string;
+    /** 标题 / feature-id 子串匹配。 */
+    q?: string;
+    /** 阶段精确匹配(已规格 / 已规划 / 已验证)。 */
+    stage?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/features/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/features/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+CAA+C;AAC/C,eAAO,MAAM,cAAc,gCAAiC,CAAC;AAE7D,mCAAmC;AACnC,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,mBAAmB;AACnB,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,2CAA2C;IAC3C,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/core/features/types.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * features 子系统的类型定义。
+ *
+ * 无 DB、无 schema:索引是 docs/features/ 目录树的纯派生视图,
+ * 每次查询实时扫描文件系统,永不持久化——不会陈旧。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FEATURE_STAGES = void 0;
+/** 需求阶段:由 docs/features/ 产物存在性实时派生,不写入任何文件。 */
+exports.FEATURE_STAGES = ['已规格', '已规划', '已验证'];
+//# sourceMappingURL=types.js.map

package/dist/core/features/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/features/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,+CAA+C;AAClC,QAAA,cAAc,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC"}

package/dist/core/markdown/cli.d.ts

@@ -0,0 +1,16 @@
+/**
+ * CLI wiring for the markdown knowledge base.
+ *
+ * Exposes a single `registerDocsCommands(program)` entry point that the main
+ * CLI (`src/cli/index.ts`) calls once. All docs subcommands live under
+ * `cgraphx docs <subcommand>` and are implemented in this file.
+ */
+import type { Command } from 'commander';
+/**
+ * Attach the `docs` command group to a commander program.
+ *
+ * Called once from `src/cli/index.ts`. Kept as a function (not a top-level
+ * side effect) so the main CLI controls when registration happens.
+ */
+export declare function registerDocsCommands(program: Command): void;
+//# sourceMappingURL=cli.d.ts.map

package/dist/core/markdown/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/core/markdown/cli.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBzC;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8V3D"}