@changw98ic/cli 1.0.0

package/dist/utils/observability.js

@@ -0,0 +1,298 @@
+/**
+ * 可观测性工具
+ *
+ * 迁移自 Python observability.py
+ * 提供工具调用日志、 性能计时追踪功能
+ */
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from 'fs';
+import { join } from 'path';
+// ============================================================================
+// File-Based Tool Logger
+// ============================================================================
+/**
+ * 文件工具日志记录器
+ *
+ * 将工具调用日志写入 JSONL 文件， 用于后续分析
+ */
+export class FileToolLogger {
+    logPath;
+    constructor(projectRoot) {
+        const obsDir = join(projectRoot, '.webnovel', 'observability');
+        if (!existsSync(obsDir)) {
+            mkdirSync(obsDir, { recursive: true });
+        }
+        this.logPath = join(obsDir, 'tool_calls.jsonl');
+    }
+    logToolCall(toolName, success, options) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            toolName,
+            success,
+            retryCount: options?.retryCount ?? 0,
+            errorCode: options?.errorCode,
+            errorMessage: options?.errorMessage,
+            chapter: options?.chapter,
+        };
+        try {
+            appendFileSync(this.logPath, JSON.stringify(entry, null, 2) + '\n', 'utf-8');
+        }
+        catch {
+            // Silently ignore logging errors
+        }
+    }
+}
+// ============================================================================
+// Observability Manager
+// ============================================================================
+/**
+ * 可观测性管理器
+ *
+ * 提供统一的工具调用日志和 性能计时功能
+ */
+export class ObservabilityManager {
+    projectRoot;
+    toolLogger;
+    timingLogPath;
+    constructor(projectRoot, toolLogger) {
+        this.projectRoot = projectRoot;
+        this.toolLogger = toolLogger ?? new FileToolLogger(projectRoot);
+        const obsDir = join(projectRoot, '.webnovel', 'observability');
+        if (!existsSync(obsDir)) {
+            mkdirSync(obsDir, { recursive: true });
+        }
+        this.timingLogPath = join(obsDir, 'data_agent_timing.jsonl');
+    }
+    // ==================== Tool Call Logging ====================
+    /**
+     * 安全记录工具调用
+     */
+    safeLogToolCall(toolName, success, options) {
+        try {
+            this.toolLogger.logToolCall(toolName, success, options);
+        }
+        catch (e) {
+            // Silently ignore logging errors
+            console.warn(`工具调用日志记录失败: ${toolName} - ${e}`);
+        }
+    }
+    // ==================== Performance Timing ====================
+    /**
+     * 记录性能计时
+     */
+    appendPerfTiming(params) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            toolName: params.toolName,
+            success: params.success,
+            elapsedMs: params.elapsedMs,
+            chapter: params.chapter,
+            errorCode: params.errorCode,
+            errorMessage: params.errorMessage,
+            meta: params.meta,
+        };
+        try {
+            appendFileSync(this.timingLogPath, JSON.stringify(entry, null, 2) + '\n', 'utf-8');
+        }
+        catch {
+            // Silently ignore logging errors
+        }
+    }
+    /**
+     * 测量异步操作执行时间
+     */
+    async measureAsync(toolName, fn, options) {
+        const startTime = Date.now();
+        let success = false;
+        let errorCode;
+        let errorMessage;
+        try {
+            const result = await fn();
+            success = true;
+            return result;
+        }
+        catch (e) {
+            errorCode = e instanceof Error ? e.name : 'UnknownError';
+            errorMessage = e instanceof Error ? e.message : String(e);
+            throw e;
+        }
+        finally {
+            const elapsedMs = Date.now() - startTime;
+            this.appendPerfTiming({
+                toolName,
+                success,
+                elapsedMs,
+                chapter: options?.chapter,
+                errorCode,
+                errorMessage,
+                meta: options?.meta,
+            });
+        }
+    }
+    /**
+     * 测量同步操作执行时间
+     */
+    measureSync(toolName, fn, options) {
+        const startTime = Date.now();
+        let success = false;
+        let errorCode;
+        let errorMessage;
+        try {
+            const result = fn();
+            success = true;
+            return result;
+        }
+        catch (e) {
+            errorCode = e instanceof Error ? e.name : 'UnknownError';
+            errorMessage = e instanceof Error ? e.message : String(e);
+            throw e;
+        }
+        finally {
+            const elapsedMs = Date.now() - startTime;
+            this.appendPerfTiming({
+                toolName,
+                success,
+                elapsedMs,
+                chapter: options?.chapter,
+                errorCode,
+                errorMessage,
+                meta: options?.meta,
+            });
+        }
+    }
+    // ==================== Statistics ====================
+    /**
+     * 获取性能统计
+     */
+    getPerfStats(options) {
+        if (!existsSync(this.timingLogPath)) {
+            return [];
+        }
+        const content = readFileSync(this.timingLogPath, 'utf-8');
+        const lines = content.trim().split('\n').filter(Boolean);
+        let logs = lines.map(line => {
+            try {
+                return JSON.parse(line);
+            }
+            catch {
+                return null;
+            }
+        }).filter((log) => log !== null);
+        // Filter by tool name
+        if (options?.toolName) {
+            logs = logs.filter(log => log.toolName === options.toolName);
+        }
+        // Filter by date
+        if (options?.since) {
+            const sinceTime = options.since.getTime();
+            logs = logs.filter(log => new Date(log.timestamp).getTime() >= sinceTime);
+        }
+        // Apply limit
+        if (options?.limit && options.limit > 0) {
+            logs = logs.slice(0, options.limit);
+        }
+        return logs;
+    }
+    /**
+     * 获取工具调用统计
+     */
+    getToolCallStats(options) {
+        const toolCallsPath = join(this.projectRoot, '.webnovel', 'observability', 'tool_calls.jsonl');
+        if (!existsSync(toolCallsPath)) {
+            return [];
+        }
+        const content = readFileSync(toolCallsPath, 'utf-8');
+        const lines = content.trim().split('\n').filter(Boolean);
+        let logs = lines.map(line => {
+            try {
+                return JSON.parse(line);
+            }
+            catch {
+                return null;
+            }
+        }).filter((log) => log !== null);
+        // Filter by tool name
+        if (options?.toolName) {
+            logs = logs.filter(log => log.toolName === options.toolName);
+        }
+        // Filter by date
+        if (options?.since) {
+            const sinceTime = options.since.getTime();
+            logs = logs.filter(log => new Date(log.timestamp).getTime() >= sinceTime);
+        }
+        // Apply limit
+        if (options?.limit && options.limit > 0) {
+            logs = logs.slice(0, options.limit);
+        }
+        return logs;
+    }
+    /**
+     * 生成可观测性摘要报告
+     */
+    generateSummary() {
+        const toolCalls = this.getToolCallStats({ limit: 100 });
+        const perfLogs = this.getPerfStats({ limit: 100 });
+        // Calculate tool call stats
+        const successfulCalls = toolCalls.filter(log => log.success).length;
+        const failedCalls = toolCalls.length - successfulCalls;
+        // Calculate performance stats
+        const toolPerf = new Map();
+        for (const log of perfLogs) {
+            const existing = toolPerf.get(log.toolName) ?? { total: 0, count: 0, ms: 0 };
+            existing.total += 1;
+            existing.count++;
+            existing.ms += log.elapsedMs;
+            toolPerf.set(log.toolName, existing);
+        }
+        // Find slowest tools
+        const slowestTools = Array.from(toolPerf.entries())
+            .map(([toolName, data]) => ({
+            toolName,
+            avgMs: Math.round(data.ms / data.count),
+            count: data.count,
+        }))
+            .sort((a, b) => b.avgMs - a.avgMs)
+            .slice(0, 5);
+        // Find recent errors
+        const recentErrors = toolCalls
+            .filter(log => !log.success)
+            .slice(0, 5)
+            .map(log => ({
+            toolName: log.toolName,
+            errorMessage: log.errorMessage ?? 'Unknown error',
+            timestamp: log.timestamp,
+        }));
+        return {
+            totalToolCalls: toolCalls.length,
+            successfulCalls,
+            failedCalls,
+            avgElapsedMs: perfLogs.length > 0
+                ? Math.round(perfLogs.reduce((sum, log) => sum + log.elapsedMs, 0) / perfLogs.length)
+                : null,
+            slowestTools,
+            recentErrors,
+        };
+    }
+}
+// ============================================================================
+// Convenience Functions
+// ============================================================================
+/**
+ * 安全记录工具调用（独立函数）
+ */
+export function safeLogToolCall(projectRoot, toolName, success, options) {
+    const logger = new FileToolLogger(projectRoot);
+    try {
+        logger.logToolCall(toolName, success, options);
+    }
+    catch {
+        // Silently ignore
+    }
+}
+/**
+ * 安全追加性能计时（独立函数）
+ */
+export function safeAppendPerfTiming(projectRoot, params) {
+    const manager = new ObservabilityManager(projectRoot);
+    manager.appendPerfTiming(params);
+}
+//# sourceMappingURL=observability.js.map

package/dist/utils/observability.js.map

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

package/dist/utils/output.d.ts

@@ -0,0 +1,45 @@
+/**
+ * CLI Output Protocol - 与 Python cli_output.py 兼容的 JSON 输出协议
+ */
+export interface SuccessPayload {
+    status: 'success';
+    message: string;
+    data?: unknown;
+    warnings?: string[];
+}
+export interface ErrorDetail {
+    code: string;
+    message: string;
+    suggestion?: string;
+    details?: Record<string, unknown>;
+}
+export interface ErrorPayload {
+    status: 'error';
+    error: ErrorDetail;
+}
+export type OutputPayload = SuccessPayload | ErrorPayload;
+/**
+ * 构建成功响应
+ */
+export declare function buildSuccess(data?: unknown, message?: string, warnings?: string[]): SuccessPayload;
+/**
+ * 构建错误响应
+ */
+export declare function buildError(code: string, message: string, suggestion?: string, details?: Record<string, unknown>): ErrorPayload;
+/**
+ * 打印 JSON 到 stdout
+ */
+export declare function printJson(payload: OutputPayload): void;
+/**
+ * 构建并打印成功响应
+ */
+export declare function printSuccess(data?: unknown, message?: string, warnings?: string[]): void;
+/**
+ * 构建并打印错误响应
+ */
+export declare function printError(code: string, message: string, suggestion?: string, details?: Record<string, unknown>): void;
+/**
+ * 格式化打印（带缩进，用于调试）
+ */
+export declare function printJsonPretty(payload: OutputPayload): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/utils/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,YAAY,CAAC;AAE1D;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,GAAE,MAAa,EACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,GAClB,cAAc,CAYhB;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,YAAY,CAed;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAEtD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,GAAE,MAAa,EACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,GAClB,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAE5D"}

package/dist/utils/output.js

@@ -0,0 +1,60 @@
+/**
+ * 构建成功响应
+ */
+export function buildSuccess(data, message = 'ok', warnings) {
+    const payload = {
+        status: 'success',
+        message,
+    };
+    if (data !== undefined) {
+        payload.data = data;
+    }
+    if (warnings && warnings.length > 0) {
+        payload.warnings = warnings;
+    }
+    return payload;
+}
+/**
+ * 构建错误响应
+ */
+export function buildError(code, message, suggestion, details) {
+    const error = {
+        code,
+        message,
+    };
+    if (suggestion) {
+        error.suggestion = suggestion;
+    }
+    if (details) {
+        error.details = details;
+    }
+    return {
+        status: 'error',
+        error,
+    };
+}
+/**
+ * 打印 JSON 到 stdout
+ */
+export function printJson(payload) {
+    console.log(JSON.stringify(payload, null, 0));
+}
+/**
+ * 构建并打印成功响应
+ */
+export function printSuccess(data, message = 'ok', warnings) {
+    printJson(buildSuccess(data, message, warnings));
+}
+/**
+ * 构建并打印错误响应
+ */
+export function printError(code, message, suggestion, details) {
+    printJson(buildError(code, message, suggestion, details));
+}
+/**
+ * 格式化打印（带缩进，用于调试）
+ */
+export function printJsonPretty(payload) {
+    console.log(JSON.stringify(payload, null, 2));
+}
+//# sourceMappingURL=output.js.map

package/dist/utils/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAwBA;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAc,EACd,UAAkB,IAAI,EACtB,QAAmB;IAEnB,MAAM,OAAO,GAAmB;QAC9B,MAAM,EAAE,SAAS;QACjB,OAAO;KACR,CAAC;IACF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IACtB,CAAC;IACD,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC9B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,OAAe,EACf,UAAmB,EACnB,OAAiC;IAEjC,MAAM,KAAK,GAAgB;QACzB,IAAI;QACJ,OAAO;KACR,CAAC;IACF,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC;IAChC,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;IAC1B,CAAC;IACD,OAAO;QACL,MAAM,EAAE,OAAO;QACf,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAAsB;IAC9C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAc,EACd,UAAkB,IAAI,EACtB,QAAmB;IAEnB,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,OAAe,EACf,UAAmB,EACnB,OAAiC;IAEjC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAsB;IACpD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/dist/utils/path-compat.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Webnovel 数据目录名
+ */
+export declare const WEBNOVEL_DIR = ".webnovel";
+/**
+ * 格式化章节编号（补零到 4 位）
+ * Python: f"{chapter:04d}"
+ */
+export declare function formatChapter(chapter: number): string;
+/**
+ * 生成 Chunk ID
+ * Python: f"ch{chapter_id}_summary" 或 f"ch{chapter_id}_s{scene_index}"
+ */
+export declare function makeChunkId(type: 'summary' | 'scene', chapter: number, sceneIndex?: number): string;
+/**
+ * 解析 Chunk ID 中的章节号
+ */
+export declare function parseChunkChapter(chunkId: string): number | null;
+/**
+ * 获取 state.json 文件路径
+ */
+export declare function getStatePath(projectRoot: string): string;
+/**
+ * 获取 index.db 文件路径
+ */
+export declare function getIndexDbPath(projectRoot: string): string;
+/**
+ * 获取 vectors.db 文件路径
+ */
+export declare function getVectorsDbPath(projectRoot: string): string;
+/**
+ * 检查是否为有效的项目根目录
+ */
+export declare function isProjectRoot(projectRoot: string): boolean;
+/**
+ * 检查是否为显式项目根目录（包含 .webnovel 目录或 state.json）
+ */
+export declare function isExplicitProjectRoot(projectRoot: string): boolean;
+/**
+ * 规范化路径（跨平台）
+ * Python: os.path.normcase + resolve
+ */
+export declare function normalizePath(path: string): string;
+/**
+ * 获取用户 Claude 根目录
+ * Python: _get_user_claude_root()
+ */
+export declare function getUserClaudeRoot(): string;
+/**
+ * 获取全局 registry 路径
+ * Python: _global_registry_path()
+ */
+export declare function getGlobalRegistryPath(): string;
+/**
+ * 生成稳定的路径 key（用于 registry 映射）
+ * Python: _normcase_path_key()
+ */
+export declare function makePathKey(path: string): string;
+/**
+ * 获取当前时间 ISO 格式
+ */
+export declare function nowIso(): string;
+//# sourceMappingURL=path-compat.d.ts.map

package/dist/utils/path-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-compat.d.ts","sourceRoot":"","sources":["../../src/utils/path-compat.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,eAAO,MAAM,YAAY,cAAc,CAAC;AAExC;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAMnG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIhE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAO1D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAOlE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,MAAM,CAE/B"}

package/dist/utils/path-compat.js

@@ -0,0 +1,128 @@
+/**
+ * Path Compatibility - 与 Python 版本兼容的路径处理工具
+ */
+import { existsSync, statSync } from 'fs';
+import { join, resolve, normalize } from 'path';
+import { homedir, platform } from 'os';
+/**
+ * Webnovel 数据目录名
+ */
+export const WEBNOVEL_DIR = '.webnovel';
+/**
+ * 格式化章节编号（补零到 4 位）
+ * Python: f"{chapter:04d}"
+ */
+export function formatChapter(chapter) {
+    return String(chapter).padStart(4, '0');
+}
+/**
+ * 生成 Chunk ID
+ * Python: f"ch{chapter_id}_summary" 或 f"ch{chapter_id}_s{scene_index}"
+ */
+export function makeChunkId(type, chapter, sceneIndex) {
+    const chapterId = formatChapter(chapter);
+    if (type === 'summary') {
+        return `ch${chapterId}_summary`;
+    }
+    return `ch${chapterId}_s${sceneIndex ?? 0}`;
+}
+/**
+ * 解析 Chunk ID 中的章节号
+ */
+export function parseChunkChapter(chunkId) {
+    const match = chunkId.match(/^ch(\d+)_/);
+    if (!match)
+        return null;
+    return parseInt(match[1], 10);
+}
+/**
+ * 获取 state.json 文件路径
+ */
+export function getStatePath(projectRoot) {
+    return join(projectRoot, WEBNOVEL_DIR, 'state.json');
+}
+/**
+ * 获取 index.db 文件路径
+ */
+export function getIndexDbPath(projectRoot) {
+    return join(projectRoot, WEBNOVEL_DIR, 'index.db');
+}
+/**
+ * 获取 vectors.db 文件路径
+ */
+export function getVectorsDbPath(projectRoot) {
+    return join(projectRoot, WEBNOVEL_DIR, 'vectors.db');
+}
+/**
+ * 检查是否为有效的项目根目录
+ */
+export function isProjectRoot(projectRoot) {
+    const statePath = getStatePath(projectRoot);
+    try {
+        return existsSync(statePath) && statSync(statePath).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 检查是否为显式项目根目录（包含 .webnovel 目录或 state.json）
+ */
+export function isExplicitProjectRoot(projectRoot) {
+    const webnovelDir = join(projectRoot, WEBNOVEL_DIR);
+    try {
+        return isProjectRoot(projectRoot) || (existsSync(webnovelDir) && statSync(webnovelDir).isDirectory());
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 规范化路径（跨平台）
+ * Python: os.path.normcase + resolve
+ */
+export function normalizePath(path) {
+    let normalized = normalize(path);
+    // Windows 下统一使用反斜杠
+    if (platform() === 'win32') {
+        normalized = normalized.toLowerCase();
+    }
+    return normalized;
+}
+/**
+ * 获取用户 Claude 根目录
+ * Python: _get_user_claude_root()
+ */
+export function getUserClaudeRoot() {
+    const envHome = process.env.WEBNOVEL_CLAUDE_HOME || process.env.CLAUDE_HOME;
+    if (envHome) {
+        return resolve(normalizePath(envHome));
+    }
+    return join(homedir(), '.claude');
+}
+/**
+ * 获取全局 registry 路径
+ * Python: _global_registry_path()
+ */
+export function getGlobalRegistryPath() {
+    return join(getUserClaudeRoot(), 'webnovel-writer', 'workspaces.json');
+}
+/**
+ * 生成稳定的路径 key（用于 registry 映射）
+ * Python: _normcase_path_key()
+ */
+export function makePathKey(path) {
+    try {
+        return normalizePath(resolve(path));
+    }
+    catch {
+        return normalizePath(path);
+    }
+}
+/**
+ * 获取当前时间 ISO 格式
+ */
+export function nowIso() {
+    return new Date().toISOString().slice(0, 19);
+}
+//# sourceMappingURL=path-compat.js.map

package/dist/utils/path-compat.js.map

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

package/dist/utils/project-locator.d.ts

@@ -0,0 +1,47 @@
+export declare const DEFAULT_PROJECT_DIR_NAMES: readonly ["webnovel-project"];
+export declare const CURRENT_PROJECT_POINTER_REL: string;
+export declare const GLOBAL_REGISTRY_REL: string;
+export declare const ENV_CLAUDE_PROJECT_DIR = "CLAUDE_PROJECT_DIR";
+export declare const ENV_CLAUDE_HOME = "CLAUDE_HOME";
+export declare const ENV_WEBNOVEL_CLAUDE_HOME = "WEBNOVEL_CLAUDE_HOME";
+export declare const ENV_WEBNOVEL_PROJECT_ROOT = "WEBNOVEL_PROJECT_ROOT";
+/**
+ * 查找最近的 Git 根目录
+ */
+export declare function findGitRoot(cwd: string): string | null;
+/**
+ * 解析项目根目录
+ *
+ * 解析优先级：
+ * 1) 显式传入的 project_root
+ * 2) 环境变量 WEBNOVEL_PROJECT_ROOT
+ * 3) workspace 指针文件
+ * 4) 用户级 registry (前缀匹配)
+ * 5) 从 CWD 向上搜索 .webnovel/state.json
+ *
+ * @throws Error 如果无法找到有效的项目根目录
+ */
+export declare function resolveProjectRoot(explicitProjectRoot?: string, options?: {
+    cwd?: string;
+}): string;
+/**
+ * 更新用户级 registry：workspace -> current_project_root 映射
+ */
+export declare function updateGlobalRegistryCurrentProject(options: {
+    workspaceRoot?: string | null;
+    projectRoot: string;
+}): string | null;
+/**
+ * 写入 workspace 级当前项目指针
+ */
+export declare function writeCurrentProjectPointer(projectRoot: string, options?: {
+    workspaceRoot?: string;
+}): string | null;
+/**
+ * 解析 state.json 文件路径
+ */
+export declare function resolveStateFile(explicitStateFile?: string, options?: {
+    explicitProjectRoot?: string;
+    cwd?: string;
+}): string;
+//# sourceMappingURL=project-locator.d.ts.map