cgraphx 1.4.3 → 2.0.1

package/dist/core/directory.js

@@ -0,0 +1,243 @@
+"use strict";
+/**
+ * Directory Management
+ *
+ * Manages the `.cgraphx/` directory structure that holds the shared
+ * `cgraphx.db` (used by the markdown and timeline subsystems) plus per-project
+ * runtime files. Directory naming honors the `CGRAPHX_DIR` env override.
+ */
+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.codeGraphDirName = codeGraphDirName;
+exports.getCodeGraphDir = getCodeGraphDir;
+exports.isInitialized = isInitialized;
+exports.unsafeIndexRootReason = unsafeIndexRootReason;
+exports.createDirectory = createDirectory;
+exports.removeDirectory = removeDirectory;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+/** The default per-project data directory name. */
+const DEFAULT_CGRAPHX_DIR = '.cgraphx';
+let warnedBadDirName = false;
+/**
+ * Resolve the per-project data directory name, honoring the `CGRAPHX_DIR`
+ * environment override (default `.cgraphx`). The override is a single path
+ * segment that lives in the project root.
+ *
+ * Two environments that share one working tree must NOT share one `.cgraphx/`
+ * — most concretely Windows-native and WSL. SQLite file locking across the
+ * WSL2 ↔ Windows filesystem boundary is unreliable, so two processes sharing
+ * one index risks corruption. Setting `CGRAPHX_DIR=.cgraphx-win` on one side
+ * gives each environment its own data dir in the same tree.
+ *
+ * Read live (not captured at load) so it is both process-accurate and testable.
+ * An override that isn't a plain directory name — empty, containing a path
+ * separator, `.`, `..`/traversal, or absolute — is ignored (we keep the
+ * default) rather than risk writing outside the project or into the project
+ * root itself; we warn once to stderr so the misconfiguration is seen.
+ */
+function codeGraphDirName() {
+    const raw = process.env.CGRAPHX_DIR?.trim();
+    if (!raw)
+        return DEFAULT_CGRAPHX_DIR;
+    const invalid = raw === '.' ||
+        raw.includes('..') ||
+        raw.includes('/') ||
+        raw.includes('\\') ||
+        path.isAbsolute(raw);
+    if (invalid) {
+        if (!warnedBadDirName) {
+            warnedBadDirName = true;
+            console.warn(`[cgraphx] Ignoring invalid CGRAPHX_DIR="${raw}" — it must be a plain ` +
+                `directory name (no path separators, no "..", not absolute). Using "${DEFAULT_CGRAPHX_DIR}".`);
+        }
+        return DEFAULT_CGRAPHX_DIR;
+    }
+    return raw;
+}
+/**
+ * Get the .cgraphx directory path for a project
+ */
+function getCodeGraphDir(projectRoot) {
+    return path.join(projectRoot, codeGraphDirName());
+}
+/**
+ * Check if a project has been initialized with cgraphx.
+ * Requires both `.cgraphx/` directory AND `cgraphx.db` to exist.
+ */
+function isInitialized(projectRoot) {
+    const codegraphDir = getCodeGraphDir(projectRoot);
+    if (!fs.existsSync(codegraphDir) || !fs.statSync(codegraphDir).isDirectory()) {
+        return false;
+    }
+    // Must have cgraphx.db, not just .cgraphx folder
+    const dbPath = path.join(codegraphDir, 'cgraphx.db');
+    return fs.existsSync(dbPath);
+}
+/**
+ * Reason a directory is unsafe to use as a project ROOT, or null when it's
+ * fine.
+ *
+ * Indexing/initializing your home directory or a filesystem root drags in
+ * caches, `Library`, every other project, etc. — a multi-GB index and constant
+ * file-watcher churn. The classic trigger: running the installer or
+ * `cgraphx init` from `$HOME`, which would auto-initialize the current
+ * directory. These are never intended project roots, so the installer and
+ * `init` refuse them (overridable with `--force`).
+ *
+ * Pure-ish (reads only `os.homedir()` + realpath) so it's easy to unit-test.
+ * The returned string is a human phrase that slots into "… looks like {reason}".
+ */
+function unsafeIndexRootReason(projectRoot) {
+    const resolve = (p) => {
+        try {
+            return fs.realpathSync(path.resolve(p));
+        }
+        catch {
+            return path.resolve(p);
+        }
+    };
+    const resolved = resolve(projectRoot);
+    // Filesystem root: `/` on POSIX, a drive root like `C:\` on Windows.
+    if (path.parse(resolved).root === resolved) {
+        return 'the filesystem root';
+    }
+    const home = resolve(os.homedir());
+    // Case-insensitive on macOS/Windows (case-preserving but case-insensitive FS).
+    const norm = (p) => process.platform === 'darwin' || process.platform === 'win32' ? p.toLowerCase() : p;
+    const r = norm(resolved);
+    const h = norm(home);
+    if (r === h) {
+        return 'your home directory';
+    }
+    // An ancestor of home (e.g. `/Users`, `/home`) — even broader than home.
+    if (h.startsWith(r + path.sep)) {
+        return 'a parent of your home directory';
+    }
+    return null;
+}
+/**
+ * Contents of `.cgraphx/.gitignore`. A single wildcard ignore keeps every
+ * transient file in the data dir — the database, logs, cache, and anything
+ * future versions add — out of git, without having to enumerate each name. */
+const GITIGNORE_CONTENT = `# cgraphx data files — local to each machine, not for committing.
+# Ignore everything in .cgraphx/ except this file itself, so transient
+# files (the database, logs) never show up in git.
+*
+!.gitignore
+`;
+/** Header line that prefixes every .gitignore older cgraphx versions auto-generated — kept to detect+heal stale pre-wildcard files. */
+const GITIGNORE_MARKER = '# CodeGraph data files';
+/**
+ * Is `content` a stale cgraphx-generated `.gitignore` that should be
+ * regenerated in place? True when it carries our header but predates the
+ * wildcard ignore (it has no bare `*` line). A file WITHOUT our header is
+ * user-authored and is left untouched; one that already has the wildcard is
+ * current. Matching on the header (not a byte-exact list of past defaults)
+ * heals every old variant and is idempotent once upgraded.
+ */
+function isStaleDefaultGitignore(content) {
+    if (!content.trimStart().startsWith(GITIGNORE_MARKER))
+        return false;
+    return !content.split('\n').some((line) => line.trim() === '*');
+}
+/**
+ * Write `.cgraphx/.gitignore` if it's absent, or upgrade a stale
+ * cgraphx-generated default in place; a user-customized file is left alone.
+ * Best-effort — returns `false` only if a needed write failed.
+ */
+function ensureGitignore(gitignorePath) {
+    let existing;
+    try {
+        existing = fs.readFileSync(gitignorePath, 'utf-8');
+    }
+    catch {
+        existing = null; // absent (ENOENT) or unreadable — (re)create below
+    }
+    // Current default or a user-authored file: nothing to do.
+    if (existing !== null && !isStaleDefaultGitignore(existing))
+        return true;
+    try {
+        fs.writeFileSync(gitignorePath, GITIGNORE_CONTENT, 'utf-8');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Create the `.cgraphx` directory structure.
+ * Note: Only throws if `cgraphx.db` already exists, not just if `.cgraphx/`
+ * exists.
+ */
+function createDirectory(projectRoot) {
+    const codegraphDir = getCodeGraphDir(projectRoot);
+    const dbPath = path.join(codegraphDir, 'cgraphx.db');
+    // Only throw if cgraphx is actually initialized (db exists).
+    // .cgraphx/ folder alone is fine.
+    if (fs.existsSync(dbPath)) {
+        throw new Error(`cgraphx already initialized in ${projectRoot}`);
+    }
+    // Create main directory (if it doesn't exist)
+    fs.mkdirSync(codegraphDir, { recursive: true });
+    // Write .gitignore inside .cgraphx (create if absent, upgrade a stale
+    // pre-wildcard default left by an older version).
+    ensureGitignore(path.join(codegraphDir, '.gitignore'));
+}
+/**
+ * Remove the .cgraphx directory
+ */
+function removeDirectory(projectRoot) {
+    const codegraphDir = getCodeGraphDir(projectRoot);
+    if (!fs.existsSync(codegraphDir)) {
+        return;
+    }
+    // Verify .cgraphx is a real directory, not a symlink pointing elsewhere
+    const lstat = fs.lstatSync(codegraphDir);
+    if (lstat.isSymbolicLink()) {
+        // Only remove the symlink itself, never follow it for recursive delete
+        fs.unlinkSync(codegraphDir);
+        return;
+    }
+    if (!lstat.isDirectory()) {
+        // Not a directory - remove the single file
+        fs.unlinkSync(codegraphDir);
+        return;
+    }
+    // Recursively remove directory
+    fs.rmSync(codegraphDir, { recursive: true, force: true });
+}
+//# sourceMappingURL=directory.js.map

package/dist/core/directory.js.map

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

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