xtep-workspace 1.10.10

package/dist/services/SessionService.js

@@ -0,0 +1,297 @@
+// src/services/SessionService.ts
+import { XtepError } from "../types/errors.js";
+/**
+ * 会话服务
+ * 管理 Claude Code 会话与工作区的绑定关系
+ */
+export class SessionService {
+    sessionStorage;
+    json;
+    md;
+    fs;
+    installationService = null;
+    constructor(sessionStorage, json, md, fs) {
+        this.sessionStorage = sessionStorage;
+        this.json = json;
+        this.md = md;
+        this.fs = fs;
+    }
+    /**
+     * 设置 InstallationService 依赖（延迟注入避免循环依赖）
+     */
+    setInstallationService(service) {
+        this.installationService = service;
+    }
+    /**
+     * 绑定会话到工作区
+     */
+    async bind(params) {
+        const { sessionId, workspaceId, nodeId } = params;
+        // 验证工作区存在并获取位置信息
+        const location = await this.json.getWorkspaceLocation(workspaceId);
+        if (!location) {
+            throw new XtepError("WORKSPACE_NOT_FOUND", `工作区 "${workspaceId}" 不存在`);
+        }
+        const { projectRoot, dirName } = location;
+        // 验证项目目录存在
+        const workspacePath = this.fs.getWorkspacePath(projectRoot, dirName);
+        if (!(await this.fs.exists(workspacePath))) {
+            throw new XtepError("WORKSPACE_NOT_FOUND", `工作区 "${workspaceId}" 的项目目录不存在`);
+        }
+        // 如果指定了节点，验证节点存在并同步到 graph.currentFocus
+        if (nodeId) {
+            const graph = await this.json.readGraph(projectRoot, dirName);
+            if (!graph.nodes[nodeId]) {
+                throw new XtepError("NODE_NOT_FOUND", `节点 "${nodeId}" 不存在`);
+            }
+            // 同步聚焦节点到 graph.currentFocus，确保单一数据源
+            if (graph.currentFocus !== nodeId) {
+                graph.currentFocus = nodeId;
+                await this.json.writeGraph(projectRoot, dirName, graph);
+            }
+        }
+        // 获取工作区名称
+        const config = await this.json.readWorkspaceConfig(projectRoot, dirName);
+        // 执行绑定
+        const binding = await this.sessionStorage.bind(sessionId, workspaceId, nodeId);
+        return {
+            success: true,
+            message: `已绑定到工作区「${config.name}」`,
+            binding
+        };
+    }
+    /**
+     * 解除会话绑定
+     */
+    async unbind(params) {
+        const { sessionId } = params;
+        // 获取当前绑定信息（用于消息提示）
+        const currentBinding = await this.sessionStorage.getBinding(sessionId);
+        // 执行解绑
+        const success = await this.sessionStorage.unbind(sessionId);
+        if (!success) {
+            return {
+                success: true,
+                message: "当前会话未绑定任何工作区"
+            };
+        }
+        // 尝试获取工作区名称（可能已删除）
+        let workspaceName = "未知";
+        if (currentBinding) {
+            try {
+                const location = await this.json.getWorkspaceLocation(currentBinding.workspaceId);
+                if (location) {
+                    const config = await this.json.readWorkspaceConfig(location.projectRoot, location.dirName);
+                    workspaceName = config.name;
+                }
+            }
+            catch {
+                // 忽略错误
+            }
+        }
+        return {
+            success: true,
+            message: `已解除工作区「${workspaceName}」绑定，Hook 将不再注入上下文`
+        };
+    }
+    /**
+     * 查询会话状态
+     */
+    async status(params) {
+        const { sessionId } = params;
+        // 获取当前绑定
+        const binding = await this.sessionStorage.getBinding(sessionId);
+        if (!binding) {
+            // 未绑定，返回可用工作区列表
+            const index = await this.json.readIndex();
+            const availableWorkspaces = index.workspaces
+                .filter(ws => ws.status === "active")
+                .map(ws => ({
+                id: ws.id,
+                name: ws.name,
+                status: ws.status
+            }));
+            return {
+                bound: false,
+                availableWorkspaces
+            };
+        }
+        // 已绑定，获取详细信息
+        const location = await this.json.getWorkspaceLocation(binding.workspaceId);
+        if (!location) {
+            // 工作区已删除，自动清理绑定
+            await this.sessionStorage.unbind(sessionId);
+            const index = await this.json.readIndex();
+            return {
+                bound: false,
+                availableWorkspaces: index.workspaces
+                    .filter(ws => ws.status === "active")
+                    .map(ws => ({
+                    id: ws.id,
+                    name: ws.name,
+                    status: ws.status
+                }))
+            };
+        }
+        const { projectRoot, dirName } = location;
+        // 获取工作区信息
+        const config = await this.json.readWorkspaceConfig(projectRoot, dirName);
+        const workspaceMdData = await this.md.readWorkspaceMd(projectRoot, dirName);
+        const graph = await this.json.readGraph(projectRoot, dirName);
+        // 从根节点读取 goal（requirement 字段）- goal 已统一到根节点
+        const rootNodeId = config.rootNodeId || "root";
+        const rootNodeMeta = graph.nodes[rootNodeId];
+        const rootNodeDirName = rootNodeMeta?.dirName || rootNodeId;
+        const rootNodeInfo = await this.md.readNodeInfo(projectRoot, dirName, rootNodeDirName);
+        const goal = rootNodeInfo.requirement || "";
+        const result = {
+            bound: true,
+            workspace: {
+                id: binding.workspaceId,
+                name: config.name,
+                goal, // 从根节点 requirement 读取
+            },
+            rules: workspaceMdData.rules
+        };
+        // 获取聚焦节点信息（优先使用 graph.currentFocus 作为权威来源）
+        const focusNodeId = graph.currentFocus || binding.focusedNodeId;
+        if (focusNodeId && graph.nodes[focusNodeId]) {
+            const nodeDirName = graph.nodes[focusNodeId].dirName || focusNodeId;
+            const nodeInfo = await this.md.readNodeInfo(projectRoot, dirName, nodeDirName);
+            result.focusedNode = {
+                id: focusNodeId,
+                title: nodeInfo.title,
+                status: graph.nodes[focusNodeId].status,
+                requirement: nodeInfo.requirement
+            };
+        }
+        // 检查安装警告
+        const warnings = await this.checkInstallationWarnings();
+        if (warnings.length > 0) {
+            result.installationWarnings = warnings;
+        }
+        return result;
+    }
+    /**
+     * 检查安装版本警告
+     * 使用组件级版本检查，每个组件独立比较版本
+     */
+    async checkInstallationWarnings() {
+        if (!this.installationService) {
+            return [];
+        }
+        const warnings = [];
+        try {
+            const meta = await this.installationService.read();
+            const currentVersion = this.installationService.getPackageVersion();
+            // 组件名称映射（用于生成友好的警告消息）
+            const componentNames = {
+                hooks: "Hook",
+                mcp: "MCP",
+                agents: "Dispatch Agents",
+                skills: "Skills",
+            };
+            // 检查各平台的组件版本
+            for (const platform of ["claudeCode", "cursor", "codex"]) {
+                const platformInfo = meta.global.platforms[platform];
+                if (!platformInfo?.enabled)
+                    continue;
+                // 遍历每个组件检查版本
+                for (const [componentKey, componentInfo] of Object.entries(platformInfo.components)) {
+                    // 类型断言：componentInfo 可能是 ComponentInfo
+                    const info = componentInfo;
+                    if (!info?.installed || !info.version)
+                        continue;
+                    // 版本不匹配时生成警告
+                    if (info.version !== currentVersion) {
+                        const friendlyName = componentNames[componentKey] || componentKey;
+                        warnings.push({
+                            platform,
+                            component: componentKey,
+                            installedVersion: info.version,
+                            currentVersion,
+                            message: `${platform} ${friendlyName} 版本过旧 (${info.version} → ${currentVersion})，建议更新`,
+                        });
+                    }
+                }
+            }
+        }
+        catch {
+            // 检查失败时静默，不影响主功能
+        }
+        return warnings;
+    }
+    /**
+     * 更新聚焦节点
+     */
+    async updateFocus(sessionId, nodeId) {
+        return this.sessionStorage.updateFocus(sessionId, nodeId);
+    }
+    /**
+     * 清理过期会话绑定
+     */
+    async cleanup(maxAgeMs) {
+        return this.sessionStorage.cleanup(maxAgeMs);
+    }
+    /**
+     * 清理指定工作区的所有会话绑定
+     */
+    async cleanupByWorkspace(workspaceId) {
+        return this.sessionStorage.cleanupByWorkspace(workspaceId);
+    }
+    /**
+     * 获取待处理的手动变更提醒（供 Hook 脚本调用）
+     */
+    async getPendingChanges(params) {
+        const { sessionId, workspaceId: explicitWorkspaceId } = params;
+        // 确定工作区 ID：优先使用显式传入的，否则从 session 绑定获取
+        let workspaceId = explicitWorkspaceId;
+        if (!workspaceId) {
+            const binding = await this.sessionStorage.getBinding(sessionId);
+            if (!binding) {
+                // 未绑定且未提供工作区 ID，返回空结果
+                return {
+                    hasChanges: false,
+                    reminderText: ""
+                };
+            }
+            workspaceId = binding.workspaceId;
+        }
+        // 获取工作区位置信息
+        const location = await this.json.getWorkspaceLocation(workspaceId);
+        if (!location) {
+            // 工作区不存在，返回空结果
+            return {
+                hasChanges: false,
+                reminderText: ""
+            };
+        }
+        const { projectRoot, dirName } = location;
+        // 读取工作区配置
+        try {
+            const config = await this.json.readWorkspaceConfig(projectRoot, dirName);
+            const manualChanges = config.pendingManualChanges || [];
+            if (manualChanges.length === 0) {
+                return {
+                    hasChanges: false,
+                    reminderText: ""
+                };
+            }
+            // 导入 formatter 并格式化提醒文本
+            const { formatManualChangeReminder } = await import("../utils/manualChangeFormatter.js");
+            const reminderText = formatManualChangeReminder(manualChanges);
+            return {
+                hasChanges: true,
+                reminderText
+            };
+        }
+        catch {
+            // 读取失败时返回空结果
+            return {
+                hasChanges: false,
+                reminderText: ""
+            };
+        }
+    }
+}
+//# sourceMappingURL=SessionService.js.map

package/dist/services/SessionService.js.map

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

package/dist/services/StateService.d.ts

@@ -0,0 +1,97 @@
+import type { FileSystemAdapter } from "../storage/FileSystemAdapter.js";
+import type { JsonStorage } from "../storage/JsonStorage.js";
+import type { MarkdownStorage } from "../storage/MarkdownStorage.js";
+import type { NodeTransitionParams, NodeTransitionResult } from "../types/node.js";
+/**
+ * 待确认 Token 信息
+ */
+export interface PendingConfirmation {
+    token: string;
+    workspaceId: string;
+    nodeId: string;
+    actionType: string;
+    createdAt: number;
+    expiresAt: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * 状态服务
+ * 处理节点状态转换
+ */
+export declare class StateService {
+    private json;
+    private md;
+    private fs;
+    /**
+     * Token 存储（内存中）
+     * key: token, value: PendingConfirmation
+     */
+    private pendingConfirmations;
+    /**
+     * Token 有效期（毫秒）
+     */
+    private readonly TOKEN_VALIDITY_MS;
+    /**
+     * 引导服务
+     */
+    private guidanceService;
+    constructor(json: JsonStorage, md: MarkdownStorage, fs: FileSystemAdapter);
+    /**
+     * 根据 workspaceId 获取 projectRoot 和 wsDirName
+     */
+    private resolveProjectRoot;
+    /**
+     * 执行状态转换
+     */
+    transition(params: NodeTransitionParams): Promise<NodeTransitionResult>;
+    /**
+     * 检查是否是第一个非信息收集的执行节点启动
+     */
+    private isFirstNonInfoCollectionExecution;
+    /**
+     * 生成工作流提示
+     */
+    private generateHint;
+    /**
+     * 验证状态转换合法性
+     */
+    private validateTransition;
+    /**
+     * 生成状态转换错误的修复建议
+     */
+    private getTransitionSuggestion;
+    /**
+     * 构建日志事件描述
+     */
+    private buildLogEvent;
+    /**
+     * 检查根节点是否有已完成的信息收集节点
+     */
+    private checkInfoCollectionNode;
+    /**
+     * 归档信息收集节点的 conclusion 到工作区
+     * 解析 ## 规则 和 ## 文档 部分
+     */
+    private archiveInfoCollection;
+    /**
+     * 创建待确认 Token
+     * @param workspaceId 工作区 ID
+     * @param nodeId 节点 ID
+     * @param actionType 动作类型（如 "check_docs"）
+     * @param metadata 附加元数据
+     * @returns PendingConfirmation 对象
+     */
+    createPendingConfirmation(workspaceId: string, nodeId: string, actionType: string, metadata?: Record<string, unknown>): PendingConfirmation;
+    /**
+     * 验证 Token
+     * @param token 待验证的 token
+     * @returns 如果 token 有效，返回 PendingConfirmation 对象；否则返回 null
+     */
+    validateConfirmation(token: string): PendingConfirmation | null;
+    /**
+     * 清理过期 Token
+     * 遍历所有 token，删除已过期的
+     */
+    clearExpiredTokens(): void;
+}
+//# sourceMappingURL=StateService.d.ts.map

package/dist/services/StateService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateService.d.ts","sourceRoot":"","sources":["../../src/services/StateService.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAGV,oBAAoB,EACpB,oBAAoB,EAQrB,MAAM,kBAAkB,CAAC;AAkB1B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AA6BD;;;GAGG;AACH,qBAAa,YAAY;IAkBrB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,EAAE;IAnBZ;;;OAGG;IACH,OAAO,CAAC,oBAAoB,CAA+C;IAE3E;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkB;IAEpD;;OAEG;IACH,OAAO,CAAC,eAAe,CAAkB;gBAG/B,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,eAAe,EACnB,EAAE,EAAE,iBAAiB;IAK/B;;OAEG;YACW,kBAAkB;IAehC;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAwd7E;;OAEG;IACH,OAAO,CAAC,iCAAiC;IAwBzC;;OAEG;IACH,OAAO,CAAC,YAAY;IAyFpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAiE/B;;OAEG;IACH,OAAO,CAAC,aAAa;IA+BrB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAmC/B;;;OAGG;YACW,qBAAqB;IA8EnC;;;;;;;OAOG;IACH,yBAAyB,CACvB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,mBAAmB;IAuBtB;;;;OAIG;IACH,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAmB/D;;;OAGG;IACH,kBAAkB,IAAI,IAAI;CAe3B"}