cgraphx 1.4.1 → 2.0.0

package/dist/core/errors.d.ts

@@ -0,0 +1,79 @@
+/**
+ * cgraphx Error Classes & Logger
+ *
+ * Custom error types and a swappable logger for cgraphx operations. Only the
+ * generic, non-graph error subclasses live here (FileError, DatabaseError,
+ * ConfigError); graph-specific errors (ParseError, SearchError, VectorError)
+ * were removed with the graph subsystem.
+ *
+ * @module errors
+ */
+/**
+ * Base error class for all cgraphx errors.
+ *
+ * All cgraphx-specific errors extend this class, allowing you to catch all
+ * cgraphx errors with a single catch block.
+ */
+export declare class CodeGraphError extends Error {
+    /** Error code for categorization (e.g., 'FILE_ERROR', 'DATABASE_ERROR') */
+    readonly code: string;
+    /** Additional context about the error */
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, code: string, context?: Record<string, unknown>);
+}
+/**
+ * Error reading or accessing files
+ */
+export declare class FileError extends CodeGraphError {
+    readonly filePath: string;
+    constructor(message: string, filePath: string, cause?: Error);
+}
+/**
+ * Error with database operations
+ */
+export declare class DatabaseError extends CodeGraphError {
+    readonly operation: string;
+    constructor(message: string, operation: string, cause?: Error);
+}
+/**
+ * Error with configuration
+ */
+export declare class ConfigError extends CodeGraphError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Simple logger for cgraphx operations
+ *
+ * By default, logs to console.warn for warnings and console.error for errors.
+ * Can be configured to use custom logging.
+ */
+export interface Logger {
+    debug(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+}
+/**
+ * Default console-based logger
+ */
+export declare const defaultLogger: Logger;
+/**
+ * Silent logger (no output) - useful for tests
+ */
+export declare const silentLogger: Logger;
+/**
+ * Set the global logger
+ */
+export declare function setLogger(logger: Logger): void;
+/**
+ * Get the current logger
+ */
+export declare function getLogger(): Logger;
+/**
+ * Log a warning message
+ */
+export declare function logWarn(message: string, context?: Record<string, unknown>): void;
+/**
+ * Log an error message
+ */
+export declare function logError(message: string, context?: Record<string, unknown>): void;
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE/B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAW7E;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,cAAc;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAQ7D;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAQ9D;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,cAAc;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACjE;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAY3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAI1B,CAAC;AAOF;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAEhF;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAEjF"}

package/dist/core/errors.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * cgraphx Error Classes & Logger
+ *
+ * Custom error types and a swappable logger for cgraphx operations. Only the
+ * generic, non-graph error subclasses live here (FileError, DatabaseError,
+ * ConfigError); graph-specific errors (ParseError, SearchError, VectorError)
+ * were removed with the graph subsystem.
+ *
+ * @module errors
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.silentLogger = exports.defaultLogger = exports.ConfigError = exports.DatabaseError = exports.FileError = exports.CodeGraphError = void 0;
+exports.setLogger = setLogger;
+exports.getLogger = getLogger;
+exports.logWarn = logWarn;
+exports.logError = logError;
+/**
+ * Base error class for all cgraphx errors.
+ *
+ * All cgraphx-specific errors extend this class, allowing you to catch all
+ * cgraphx errors with a single catch block.
+ */
+class CodeGraphError extends Error {
+    /** Error code for categorization (e.g., 'FILE_ERROR', 'DATABASE_ERROR') */
+    code;
+    /** Additional context about the error */
+    context;
+    constructor(message, code, context) {
+        super(message);
+        this.name = 'CodeGraphError';
+        this.code = code;
+        this.context = context;
+        // Maintain proper stack trace for V8
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+exports.CodeGraphError = CodeGraphError;
+/**
+ * Error reading or accessing files
+ */
+class FileError extends CodeGraphError {
+    filePath;
+    constructor(message, filePath, cause) {
+        super(message, 'FILE_ERROR', { filePath, cause: cause?.message });
+        this.name = 'FileError';
+        this.filePath = filePath;
+        if (cause) {
+            this.cause = cause;
+        }
+    }
+}
+exports.FileError = FileError;
+/**
+ * Error with database operations
+ */
+class DatabaseError extends CodeGraphError {
+    operation;
+    constructor(message, operation, cause) {
+        super(message, 'DATABASE_ERROR', { operation, cause: cause?.message });
+        this.name = 'DatabaseError';
+        this.operation = operation;
+        if (cause) {
+            this.cause = cause;
+        }
+    }
+}
+exports.DatabaseError = DatabaseError;
+/**
+ * Error with configuration
+ */
+class ConfigError extends CodeGraphError {
+    constructor(message, details) {
+        super(message, 'CONFIG_ERROR', details);
+        this.name = 'ConfigError';
+    }
+}
+exports.ConfigError = ConfigError;
+/**
+ * Default console-based logger
+ */
+exports.defaultLogger = {
+    debug(message, context) {
+        if (process.env.CGRAPHX_DEBUG) {
+            console.debug(`[cgraphx] ${message}`, context ?? '');
+        }
+    },
+    warn(message, context) {
+        console.warn(`[cgraphx] ${message}`, context ?? '');
+    },
+    error(message, context) {
+        console.error(`[cgraphx] ${message}`, context ?? '');
+    },
+};
+/**
+ * Silent logger (no output) - useful for tests
+ */
+exports.silentLogger = {
+    debug() { },
+    warn() { },
+    error() { },
+};
+/**
+ * Current logger instance (can be replaced)
+ */
+let currentLogger = exports.defaultLogger;
+/**
+ * Set the global logger
+ */
+function setLogger(logger) {
+    currentLogger = logger;
+}
+/**
+ * Get the current logger
+ */
+function getLogger() {
+    return currentLogger;
+}
+/**
+ * Log a warning message
+ */
+function logWarn(message, context) {
+    currentLogger.warn(message, context);
+}
+/**
+ * Log an error message
+ */
+function logError(message, context) {
+    currentLogger.error(message, context);
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

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

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

@@ -0,0 +1,12 @@
+/**
+ * features 子系统的 CLI 接线。
+ *
+ * 导出 `registerFeaturesCommands(program)`,由主 CLI(src/cli/index.ts)
+ * 调用一次。命令面:`cgraphx features [list]` —— 实时扫描 docs/features/,
+ * 按负责人/关键词/阶段定位需求目录。团队里每个人跑 `--mine` 拿自己的清单
+ * (负责人 = git config user.name,在 write-spec/write-plan 创建时声明)。
+ */
+import type { Command } from 'commander';
+/** 把 `features` 命令组挂到 commander 程序上。主 CLI 调用一次。 */
+export declare function registerFeaturesCommands(program: Command): void;
+//# sourceMappingURL=cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/core/features/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgEzC,mDAAmD;AACnD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoF/D"}

package/dist/core/features/cli.js

@@ -0,0 +1,154 @@
+"use strict";
+/**
+ * features 子系统的 CLI 接线。
+ *
+ * 导出 `registerFeaturesCommands(program)`,由主 CLI(src/cli/index.ts)
+ * 调用一次。命令面:`cgraphx features [list]` —— 实时扫描 docs/features/,
+ * 按负责人/关键词/阶段定位需求目录。团队里每个人跑 `--mine` 拿自己的清单
+ * (负责人 = git config user.name,在 write-spec/write-plan 创建时声明)。
+ */
+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.registerFeaturesCommands = registerFeaturesCommands;
+const path = __importStar(require("node:path"));
+const index_1 = require("./index");
+const sync_1 = require("./sync");
+/** 终端显示宽度:CJK / 全角字符按 2 列计,其余 1 列(表格对齐用)。 */
+function displayWidth(s) {
+    let w = 0;
+    for (const ch of s) {
+        const code = ch.codePointAt(0) ?? 0;
+        const wide = (code >= 0x1100 && code <= 0x115f) ||
+            (code >= 0x2e80 && code <= 0xa4cf) ||
+            (code >= 0xac00 && code <= 0xd7a3) ||
+            (code >= 0xf900 && code <= 0xfaff) ||
+            (code >= 0xfe30 && code <= 0xfe6f) ||
+            (code >= 0xff01 && code <= 0xff60) ||
+            (code >= 0xffe0 && code <= 0xffe6) ||
+            (code >= 0x20000 && code <= 0x3fffd);
+        w += wide ? 2 : 1;
+    }
+    return w;
+}
+function padEnd(s, width) {
+    const gap = width - displayWidth(s);
+    return gap > 0 ? s + ' '.repeat(gap) : s;
+}
+/** 对齐表格输出。空字段显示 `-`。 */
+function renderTable(rows) {
+    const cells = rows.map((r) => [
+        r.date ?? '-',
+        r.stage ?? '-',
+        r.owner ?? '-',
+        r.title,
+        r.path,
+    ]);
+    const headers = ['日期', '阶段', '负责人', '标题', '目录'];
+    const widths = headers.map((h, i) => Math.max(displayWidth(h), ...cells.map((c) => displayWidth(c[i] ?? ''))));
+    const lines = [];
+    lines.push(headers.map((h, i) => padEnd(h, (widths[i] ?? 0) + 2)).join('').trimEnd());
+    for (const c of cells) {
+        lines.push(c.map((v, i) => padEnd(v, (widths[i] ?? 0) + 2)).join('').trimEnd());
+    }
+    return lines.join('\n');
+}
+/** 把 `features` 命令组挂到 commander 程序上。主 CLI 调用一次。 */
+function registerFeaturesCommands(program) {
+    const features = program
+        .command('features')
+        .description('需求目录索引 — 实时扫描 docs/features/,按负责人/关键词快速定位需求目录');
+    features
+        .command('list [project-path]', { isDefault: true })
+        .description('列出需求目录(默认全部;--mine 只看自己的)')
+        .option('--mine', '只看当前 git 用户负责的需求(负责人 = git config user.name)')
+        .option('--owner <name>', '按负责人精确过滤')
+        .option('--q <keyword>', '标题 / feature-id 子串过滤')
+        .option('--stage <stage>', '按阶段精确过滤(已规格 / 已规划 / 已验证)')
+        .option('--json', '输出机器可读 JSON')
+        .action((pathArg, options) => {
+        const projectRoot = path.resolve(pathArg || process.cwd());
+        let owner = options.owner;
+        if (options.mine) {
+            if (owner !== undefined) {
+                console.error('--mine 与 --owner 互斥,请只用一个。');
+                process.exit(1);
+            }
+            const name = (0, sync_1.gitUserName)();
+            if (name === null) {
+                console.error('无法从 git config 读取 user.name;请改用 --owner=<你的名字>。');
+                process.exit(1);
+            }
+            owner = name;
+        }
+        const rows = (0, index_1.listFeatures)(projectRoot, {
+            owner,
+            q: options.q,
+            stage: options.stage,
+        });
+        if (options.json) {
+            process.stdout.write(JSON.stringify(rows, null, 2) + '\n');
+            return;
+        }
+        if (rows.length === 0) {
+            if (owner !== undefined) {
+                console.log(`未找到负责人为「${owner}」的需求目录。\n` +
+                    '  cgraphx features list 查看全部,或 --owner=<名字> 换人。');
+            }
+            else {
+                console.log(`${projectRoot} 的 docs/features/ 下没有需求目录。`);
+            }
+            return;
+        }
+        process.stdout.write(renderTable(rows) + '\n');
+        console.log(owner !== undefined
+            ? `\n共 ${rows.length} 个需求(负责人:${owner})`
+            : `\n共 ${rows.length} 个需求`);
+    });
+    features
+        .command('sync [project-path]')
+        .description('重新生成本人需求索引 → .cgraphx/my-features.md(本地文件,不进 git)')
+        .action((pathArg) => {
+        const projectRoot = path.resolve(pathArg || process.cwd());
+        try {
+            const result = (0, sync_1.syncMyFeatures)(projectRoot);
+            console.log(`已生成 ${result.file}(${result.count} 个需求,负责人:${result.owner})`);
+        }
+        catch (err) {
+            console.error(`生成失败:${err instanceof Error ? err.message : String(err)}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=cli.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/core/features/cli.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqEH,4DAoFC;AAvJD,gDAAkC;AAIlC,mCAAuC;AACvC,iCAAqD;AAGrD,6CAA6C;AAC7C,SAAS,YAAY,CAAC,CAAS;IAC7B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,IAAI,GACR,CAAC,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC;YAClC,CAAC,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC;YAClC,CAAC,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC;YAClC,CAAC,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC;YAClC,CAAC,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC;YAClC,CAAC,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC;YAClC,CAAC,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC;YAClC,CAAC,IAAI,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC,CAAC;QACvC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,MAAM,CAAC,CAAS,EAAE,KAAa;IACtC,MAAM,GAAG,GAAG,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IACpC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,wBAAwB;AACxB,SAAS,WAAW,CAAC,IAAoB;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC5B,CAAC,CAAC,IAAI,IAAI,GAAG;QACb,CAAC,CAAC,KAAK,IAAI,GAAG;QACd,CAAC,CAAC,KAAK,IAAI,GAAG;QACd,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,IAAI;KACP,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAClC,IAAI,CAAC,GAAG,CACN,YAAY,CAAC,CAAC,CAAC,EACf,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAC9C,CACF,CAAC;IACF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACtF,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CACR,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CACpE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAUD,mDAAmD;AACnD,SAAgB,wBAAwB,CAAC,OAAgB;IACvD,MAAM,QAAQ,GAAG,OAAO;SACrB,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CACV,+CAA+C,CAChD,CAAC;IAEJ,QAAQ;SACL,OAAO,CAAC,qBAAqB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;SACnD,WAAW,CAAC,2BAA2B,CAAC;SACxC,MAAM,CAAC,QAAQ,EAAE,8CAA8C,CAAC;SAChE,MAAM,CAAC,gBAAgB,EAAE,UAAU,CAAC;SACpC,MAAM,CAAC,eAAe,EAAE,sBAAsB,CAAC;SAC/C,MAAM,CAAC,iBAAiB,EAAE,0BAA0B,CAAC;SACrD,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC;SAC/B,MAAM,CAAC,CAAC,OAA2B,EAAE,OAAoB,EAAE,EAAE;QAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAE3D,IAAI,KAAK,GAAuB,OAAO,CAAC,KAAK,CAAC;QAC9C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;gBAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,MAAM,IAAI,GAAG,IAAA,kBAAW,GAAE,CAAC;YAC3B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,OAAO,CAAC,KAAK,CACX,iDAAiD,CAClD,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;QAED,MAAM,IAAI,GAAG,IAAA,oBAAY,EAAC,WAAW,EAAE;YACrC,KAAK;YACL,CAAC,EAAE,OAAO,CAAC,CAAC;YACZ,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YAC3D,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO,CAAC,GAAG,CACT,WAAW,KAAK,WAAW;oBACzB,iDAAiD,CACpD,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,GAAG,WAAW,4BAA4B,CAAC,CAAC;YAC1D,CAAC;YACD,OAAO;QACT,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CACT,KAAK,KAAK,SAAS;YACjB,CAAC,CAAC,OAAO,IAAI,CAAC,MAAM,YAAY,KAAK,GAAG;YACxC,CAAC,CAAC,OAAO,IAAI,CAAC,MAAM,MAAM,CAC7B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,QAAQ;SACL,OAAO,CAAC,qBAAqB,CAAC;SAC9B,WAAW,CACV,mDAAmD,CACpD;SACA,MAAM,CAAC,CAAC,OAA2B,EAAE,EAAE;QACtC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAA,qBAAc,EAAC,WAAW,CAAC,CAAC;YAC3C,OAAO,CAAC,GAAG,CACT,OAAO,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,YAAY,MAAM,CAAC,KAAK,GAAG,CAC9D,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CACX,QAAQ,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC3D,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * features 子系统公共门面。
+ *
+ * 外部调用方(CLI)必须用它 —— 不得直接伸手进 scanner 内部。
+ * 与其他子系统的差别:无 DB、无 schema,索引是 docs/features/
+ * 目录树的实时派生视图。
+ */
+import type { FeatureEntry, FeatureFilter } from './types';
+export type { FeatureEntry, FeatureFilter } from './types';
+export { scanFeatures, FEATURES_DIR } from './scanner';
+/** 按 owner / q / stage 过滤(多条件取交集;空条件不过滤)。 */
+export declare function filterFeatures(entries: FeatureEntry[], filter: FeatureFilter): FeatureEntry[];
+/** 扫描 + 过滤一步到位。 */
+export declare function listFeatures(projectRoot: string, filter?: FeatureFilter): FeatureEntry[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/features/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE3D,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEvD,6CAA6C;AAC7C,wBAAgB,cAAc,CAC5B,OAAO,EAAE,YAAY,EAAE,EACvB,MAAM,EAAE,aAAa,GACpB,YAAY,EAAE,CAkBhB;AAED,mBAAmB;AACnB,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,aAAkB,GACzB,YAAY,EAAE,CAEhB"}

package/dist/core/features/index.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * features 子系统公共门面。
+ *
+ * 外部调用方(CLI)必须用它 —— 不得直接伸手进 scanner 内部。
+ * 与其他子系统的差别:无 DB、无 schema,索引是 docs/features/
+ * 目录树的实时派生视图。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FEATURES_DIR = exports.scanFeatures = void 0;
+exports.filterFeatures = filterFeatures;
+exports.listFeatures = listFeatures;
+const scanner_1 = require("./scanner");
+var scanner_2 = require("./scanner");
+Object.defineProperty(exports, "scanFeatures", { enumerable: true, get: function () { return scanner_2.scanFeatures; } });
+Object.defineProperty(exports, "FEATURES_DIR", { enumerable: true, get: function () { return scanner_2.FEATURES_DIR; } });
+/** 按 owner / q / stage 过滤(多条件取交集;空条件不过滤)。 */
+function filterFeatures(entries, filter) {
+    return entries.filter((e) => {
+        if (filter.owner !== undefined && (e.owner ?? '') !== filter.owner) {
+            return false;
+        }
+        if (filter.stage !== undefined && (e.stage ?? '') !== filter.stage) {
+            return false;
+        }
+        if (filter.q !== undefined &&
+            filter.q !== '' &&
+            !e.title.includes(filter.q) &&
+            !e.featureId.includes(filter.q)) {
+            return false;
+        }
+        return true;
+    });
+}
+/** 扫描 + 过滤一步到位。 */
+function listFeatures(projectRoot, filter = {}) {
+    return filterFeatures((0, scanner_1.scanFeatures)(projectRoot), filter);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/features/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AASH,wCAqBC;AAGD,oCAKC;AApCD,uCAAyC;AAIzC,qCAAuD;AAA9C,uGAAA,YAAY,OAAA;AAAE,uGAAA,YAAY,OAAA;AAEnC,6CAA6C;AAC7C,SAAgB,cAAc,CAC5B,OAAuB,EACvB,MAAqB;IAErB,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC1B,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;YACnE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;YACnE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IACE,MAAM,CAAC,CAAC,KAAK,SAAS;YACtB,MAAM,CAAC,CAAC,KAAK,EAAE;YACf,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;YAC3B,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAC/B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,mBAAmB;AACnB,SAAgB,YAAY,CAC1B,WAAmB,EACnB,SAAwB,EAAE;IAE1B,OAAO,cAAc,CAAC,IAAA,sBAAY,EAAC,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * features 索引扫描器。
+ *
+ * 单一职责:把 <project>/docs/features/ 下的每个子目录解析成一个
+ * FeatureEntry。头部元数据(负责人/日期)优先级:spec 文件头部 > plan/index 头部 > 目录名。
+ *
+ * 头部行约定(与 write-spec / write-plan 的产物头部一致):
+ *
+ *   # 规格说明: <需求名称>
+ *   > feature-id: <feature-id>
+ *   > 负责人: 张三
+ *   > 日期: YYYY-MM-DD
+ *
+ * 需求阶段不读头部,由产物存在性派生(deriveStage):有测试报告 → 已验证,
+ * 有 plan → 已规划,有 spec → 已规格,都没有 → null(未规格)。
+ */
+import type { FeatureEntry } from './types';
+/** 扫描目录(仓库相对)。 */
+export declare const FEATURES_DIR: string;
+/**
+ * 扫描 <projectRoot>/docs/features/,每个子目录解析为一个 FeatureEntry。
+ * 目录不存在或不可读 → 返回空数组(不是错误:项目可能没用 features 流程)。
+ * 结果按日期倒序、标题升序排好。
+ */
+export declare function scanFeatures(projectRoot: string): FeatureEntry[];
+//# sourceMappingURL=scanner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../src/core/features/scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,SAAS,CAAC;AAE1D,kBAAkB;AAClB,eAAO,MAAM,YAAY,QAAgC,CAAC;AAwG1D;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE,CAsChE"}