mcp-spec-cli 1.0.9

package/dist/features/shared/taskGuidanceTemplate.js

@@ -0,0 +1,145 @@
+/**
+ * Task guidance template extractor
+ * Reads task completion guidance text templates from OpenAPI specification
+ */
+import { openApiLoader, OpenApiLoader } from './openApiLoader.js';
+export class TaskGuidanceExtractor {
+    static _template;
+    static get template() {
+        if (!this._template) {
+            // Lazy loading to ensure OpenAPI spec is loaded
+            openApiLoader.loadSpec();
+            this._template = openApiLoader.getTaskGuidanceTemplate();
+        }
+        return this._template;
+    }
+    /**
+     * Build task guidance text
+     * Read templates from OpenAPI spec and assemble them
+     */
+    static buildGuidanceText(nextTaskContent, firstSubtask, taskNumber, isFirstTask = false) {
+        const template = this.template;
+        if (!template) {
+            throw new Error('Failed to load task guidance template from OpenAPI specification');
+        }
+        const parts = [];
+        // Add separator line
+        parts.push(template.separator);
+        parts.push('');
+        // Add task header
+        parts.push(template.header);
+        parts.push(nextTaskContent);
+        parts.push('');
+        // Add model instructions
+        parts.push(template.instructions.prefix);
+        const taskFocusText = OpenApiLoader.replaceVariables(template.instructions.taskFocus, { firstSubtask });
+        parts.push(taskFocusText);
+        parts.push('');
+        parts.push(template.instructions.progressTracking);
+        parts.push(template.instructions.workflow);
+        parts.push('');
+        // Add model prompt based on scenario
+        let prompt;
+        if (isFirstTask) {
+            // Replace firstSubtask placeholder in firstTask prompt
+            prompt = OpenApiLoader.replaceVariables(template.prompts.firstTask, { firstSubtask });
+        }
+        else if (taskNumber) {
+            // Determine if it's a new task or continuation
+            if (taskNumber.includes('.')) {
+                // Subtask, use continuation prompt
+                prompt = OpenApiLoader.replaceVariables(template.prompts.continueTask, { taskNumber, firstSubtask });
+            }
+            else {
+                // Main task, use new task prompt
+                prompt = OpenApiLoader.replaceVariables(template.prompts.nextTask, { taskNumber, firstSubtask });
+            }
+        }
+        else {
+            // Batch completion scenario, no specific task number
+            prompt = OpenApiLoader.replaceVariables(template.prompts.batchContinue, { firstSubtask });
+        }
+        parts.push(prompt);
+        return parts.join('\n');
+    }
+    /**
+     * Extract the first uncompleted task with its context
+     */
+    static extractFirstSubtask(taskContent) {
+        const taskLines = taskContent.split('\n');
+        let firstSubtaskFound = false;
+        let firstSubtaskLines = [];
+        let currentIndent = '';
+        for (let i = 0; i < taskLines.length; i++) {
+            const line = taskLines[i];
+            // 忽略空行（但在收集过程中保留）
+            if (!line.trim()) {
+                if (firstSubtaskFound) {
+                    firstSubtaskLines.push(line);
+                }
+                continue;
+            }
+            // 寻找第一个包含 [ ] 的行（未完成任务）
+            if (line.includes('[ ]') && !firstSubtaskFound) {
+                // 提取任务号验证这是一个子任务（包含点号）
+                const taskMatch = line.match(/(\d+(?:\.\d+)+)\./);
+                if (taskMatch) {
+                    firstSubtaskFound = true;
+                    firstSubtaskLines.push(line);
+                    currentIndent = line.match(/^(\s*)/)?.[1] || '';
+                    continue;
+                }
+            }
+            // 如果已经找到第一个子任务，继续收集其详细内容
+            if (firstSubtaskFound) {
+                const lineIndent = line.match(/^(\s*)/)?.[1] || '';
+                // 如果遇到同级或更高级的任务，停止收集
+                if (line.includes('[ ]') && lineIndent.length <= currentIndent.length) {
+                    break;
+                }
+                // 如果是更深层次的缩进内容，继续收集
+                if (lineIndent.length > currentIndent.length || line.trim().startsWith('-') || line.trim().startsWith('*')) {
+                    firstSubtaskLines.push(line);
+                }
+                else {
+                    // 遇到非缩进内容，停止收集
+                    break;
+                }
+            }
+        }
+        // 如果找到了第一个子任务，返回其完整内容
+        if (firstSubtaskLines.length > 0) {
+            return firstSubtaskLines.join('\n').trim();
+        }
+        // 如果没有找到子任务，尝试找第一个未完成的任务
+        for (const line of taskLines) {
+            if (!line.trim())
+                continue;
+            if (line.includes('[ ]')) {
+                const taskMatch = line.match(/(\d+(?:\.\d+)*)\.\s*(.+)/);
+                if (taskMatch) {
+                    const taskNumber = taskMatch[1];
+                    const taskDesc = taskMatch[2].replace(/\*\*|\*/g, '').trim();
+                    return `${taskNumber}. ${taskDesc}`;
+                }
+                return line.replace(/[-[\]\s]/g, '').replace(/\*\*|\*/g, '').trim();
+            }
+        }
+        return 'Next task';
+    }
+    /**
+     * Get completion message
+     */
+    static getCompletionMessage(type, taskNumber) {
+        const template = this.template;
+        if (!template) {
+            throw new Error('Failed to load task guidance template from OpenAPI specification');
+        }
+        const message = template.completionMessages[type];
+        if (taskNumber && message.includes('${taskNumber}')) {
+            return OpenApiLoader.replaceVariables(message, { taskNumber });
+        }
+        return message;
+    }
+}
+//# sourceMappingURL=taskGuidanceTemplate.js.map

package/dist/features/shared/taskGuidanceTemplate.js.map

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

package/dist/features/shared/taskParser.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Parse tasks from tasks.md file
+ */
+export interface Task {
+    number: string;
+    description: string;
+    checked: boolean;
+    subtasks?: Task[];
+    isVirtual?: boolean;
+}
+export declare function parseTasksFile(path: string): Task[];
+export declare function parseTasksFromContent(content: string): Task[];
+export declare function getFirstUncompletedTask(tasks: Task[]): Task | null;
+export declare function formatTaskForDisplay(task: Task): string;
+export declare function formatTaskForFullDisplay(task: Task, content: string): string;
+export declare function formatTaskListOverview(path: string): string;
+//# sourceMappingURL=taskParser.d.ts.map

package/dist/features/shared/taskParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskParser.d.ts","sourceRoot":"","sources":["../../../src/features/shared/taskParser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,CAmBnD;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,CAqH7D;AAuBD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,GAAG,IAAI,CAyBlE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAYvD;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAyD5E;AAGD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgB3D"}

package/dist/features/shared/taskParser.js

@@ -0,0 +1,259 @@
+/**
+ * Parse tasks from tasks.md file
+ */
+import { readFileSync } from 'fs';
+import { join } from 'path';
+export function parseTasksFile(path) {
+    try {
+        const tasksPath = join(path, 'tasks.md');
+        const content = readFileSync(tasksPath, 'utf-8');
+        // Remove template marker blocks
+        const cleanContent = content
+            .replace(/<!--\s*SPEC-MARKER[\s\S]*?-->/g, '') // Compatible with old format
+            .replace(/<template-tasks>[\s\S]*?<\/template-tasks>/g, '') // Match actual task template markers
+            .trim();
+        if (!cleanContent) {
+            return [];
+        }
+        return parseTasksFromContent(cleanContent);
+    }
+    catch {
+        return [];
+    }
+}
+export function parseTasksFromContent(content) {
+    const lines = content.split('\n');
+    const allTasks = [];
+    // Phase 1: Collect all tasks with checkboxes
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Find checkbox pattern
+        const checkboxMatch = line.match(/\[([xX ])\]/);
+        if (!checkboxMatch)
+            continue;
+        // Extract task number (flexible matching)
+        const numberMatch = line.match(/(\d+(?:\.\d+)*)/);
+        if (!numberMatch)
+            continue;
+        const taskNumber = numberMatch[1];
+        const isChecked = checkboxMatch[1].toLowerCase() === 'x';
+        // Extract description (remove task number and checkbox)
+        let description = line
+            .replace(/\[([xX ])\]/, '') // Remove checkbox
+            .replace(/(\d+(?:\.\d+)*)\s*[.:\-)]?/, '') // Remove task number
+            .replace(/^[\s\-*]+/, '') // Remove leading symbols
+            .trim();
+        // If description is empty, try to get from next line
+        if (!description && i + 1 < lines.length) {
+            const nextLine = lines[i + 1].trim();
+            if (nextLine && !nextLine.match(/\[([xX ])\]/) && !nextLine.match(/^#/)) {
+                description = nextLine;
+                i++; // Skip next line
+            }
+        }
+        if (!description)
+            continue;
+        allTasks.push({
+            number: taskNumber,
+            description: description,
+            checked: isChecked
+        });
+    }
+    // Phase 2: Build hierarchy structure
+    const taskMap = new Map();
+    const rootTasks = [];
+    // Infer main tasks from task numbers
+    for (const task of allTasks) {
+        if (!task.number.includes('.')) {
+            // Top-level task
+            taskMap.set(task.number, task);
+            rootTasks.push(task);
+        }
+    }
+    // Process subtasks
+    for (const task of allTasks) {
+        if (task.number.includes('.')) {
+            const parts = task.number.split('.');
+            const parentNumber = parts[0];
+            // If main task doesn't exist, create virtual parent task
+            if (!taskMap.has(parentNumber)) {
+                // Try to find better title from document
+                const betterTitle = findMainTaskTitle(lines, parentNumber);
+                const virtualParent = {
+                    number: parentNumber,
+                    description: betterTitle || `Task Group ${parentNumber}`,
+                    checked: false,
+                    subtasks: [],
+                    isVirtual: true // 标记为虚拟任务
+                };
+                taskMap.set(parentNumber, virtualParent);
+                rootTasks.push(virtualParent);
+            }
+            // Add subtask to main task
+            const parent = taskMap.get(parentNumber);
+            if (!parent.subtasks) {
+                parent.subtasks = [];
+            }
+            parent.subtasks.push(task);
+        }
+    }
+    // Update main task completion status (only when all subtasks are completed)
+    for (const task of rootTasks) {
+        if (task.subtasks && task.subtasks.length > 0) {
+            task.checked = task.subtasks.every(st => st.checked);
+        }
+    }
+    // Sort by task number
+    rootTasks.sort((a, b) => {
+        const numA = parseInt(a.number);
+        const numB = parseInt(b.number);
+        return numA - numB;
+    });
+    // Sort subtasks
+    for (const task of rootTasks) {
+        if (task.subtasks) {
+            task.subtasks.sort((a, b) => {
+                const partsA = a.number.split('.').map(n => parseInt(n));
+                const partsB = b.number.split('.').map(n => parseInt(n));
+                for (let i = 0; i < Math.max(partsA.length, partsB.length); i++) {
+                    const diff = (partsA[i] || 0) - (partsB[i] || 0);
+                    if (diff !== 0)
+                        return diff;
+                }
+                return 0;
+            });
+        }
+    }
+    return rootTasks;
+}
+// Find main task title (from headers or other places)
+function findMainTaskTitle(lines, taskNumber) {
+    // Look for lines like "### 1. Title" or "## 1. Title"
+    for (const line of lines) {
+        const headerMatch = line.match(/^#+\s*(\d+)\.\s*(.+)$/);
+        if (headerMatch && headerMatch[1] === taskNumber) {
+            return headerMatch[2].trim();
+        }
+    }
+    // Also support other formats like "1. **Title**"
+    for (const line of lines) {
+        const boldMatch = line.match(/^(\d+)\.\s*\*\*(.+?)\*\*$/);
+        if (boldMatch && boldMatch[1] === taskNumber) {
+            return boldMatch[2].trim();
+        }
+    }
+    return null;
+}
+export function getFirstUncompletedTask(tasks) {
+    for (const task of tasks) {
+        // 如果任务有子任务，优先检查子任务
+        if (task.subtasks && task.subtasks.length > 0) {
+            // 检查是否有未完成的子任务
+            const firstUncompletedSubtask = task.subtasks.find(subtask => !subtask.checked);
+            if (firstUncompletedSubtask) {
+                // 无论是虚拟主任务还是真实主任务，都返回第一个未完成的子任务
+                return firstUncompletedSubtask;
+            }
+            // 如果所有子任务都完成了，但主任务未完成，返回主任务
+            if (!task.checked) {
+                return task;
+            }
+        }
+        else {
+            // 没有子任务的情况，直接检查主任务
+            if (!task.checked) {
+                return task;
+            }
+        }
+    }
+    return null;
+}
+export function formatTaskForDisplay(task) {
+    let display = `📋 Task ${task.number}: ${task.description}`;
+    if (task.subtasks && task.subtasks.length > 0) {
+        display += '\n\nSubtasks:';
+        for (const subtask of task.subtasks) {
+            const status = subtask.checked ? '✓' : '☐';
+            display += `\n  ${status} ${subtask.number}. ${subtask.description}`;
+        }
+    }
+    return display;
+}
+export function formatTaskForFullDisplay(task, content) {
+    const lines = content.split('\n');
+    const taskLines = [];
+    let capturing = false;
+    let indent = '';
+    for (const line of lines) {
+        // Find task start (supports two formats: `1. - [ ] task` or `- [ ] 1. task`)
+        const taskPattern1 = new RegExp(`^(\\s*)${task.number}\\.\\s*-\\s*\\[[ x]\\]\\s*`);
+        const taskPattern2 = new RegExp(`^(\\s*)-\\s*\\[[ x]\\]\\s*${task.number}\\.\\s*`);
+        if (line.match(taskPattern1) || line.match(taskPattern2)) {
+            capturing = true;
+            taskLines.push(line);
+            indent = line.match(/^(\s*)/)?.[1] || '';
+            continue;
+        }
+        // If capturing task content
+        if (capturing) {
+            // Check if reached next task at same or higher level
+            const nextTaskPattern = /^(\s*)-\s*\[[ x]\]\s*\d+(\.\d+)*\.\s*/;
+            const nextMatch = line.match(nextTaskPattern);
+            if (nextMatch) {
+                const nextIndent = nextMatch[1] || '';
+                if (nextIndent.length <= indent.length) {
+                    break; // Found same or higher level task, stop capturing
+                }
+            }
+            // Continue capturing content belonging to current task
+            if (line.trim() === '') {
+                taskLines.push(line);
+            }
+            else if (line.startsWith(indent + '  ') || line.startsWith(indent + '\t')) {
+                // Deeper indented content belongs to current task
+                taskLines.push(line);
+            }
+            else if (line.match(/^#+\s/)) {
+                // Found header, stop capturing
+                break;
+            }
+            else if (line.match(/^\d+\.\s*-\s*\[[ x]\]/)) {
+                // Found other top-level task, stop
+                break;
+            }
+            else {
+                // Other cases continue capturing (might be continuation of task description)
+                const isTaskLine = line.match(/^(\s*)-\s*\[[ x]\]/) || line.match(/^(\s*)\d+(\.\d+)*\.\s*-\s*\[[ x]\]/);
+                if (isTaskLine) {
+                    break; // Found other task, stop
+                }
+                else if (line.match(/^\s/) && !line.match(/^\s{8,}/)) {
+                    // If indented but not too deep, might still be current task content
+                    taskLines.push(line);
+                }
+                else {
+                    break; // Otherwise stop
+                }
+            }
+        }
+    }
+    return taskLines.join('\n').trimEnd();
+}
+// Format task list overview for display
+export function formatTaskListOverview(path) {
+    try {
+        const tasks = parseTasksFile(path);
+        if (tasks.length === 0) {
+            return 'No tasks found.';
+        }
+        const taskItems = tasks.map(task => {
+            const status = task.checked ? '[x]' : '[ ]';
+            return `- ${status} ${task.number}. ${task.description}`;
+        });
+        return taskItems.join('\n');
+    }
+    catch {
+        return 'Error loading tasks list.';
+    }
+}
+//# sourceMappingURL=taskParser.js.map

package/dist/features/shared/taskParser.js.map

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

package/dist/features/shared/typeGuards.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 类型守卫和类型验证工具
+ */
+/**
+ * 检查值是否为对象（非 null）
+ */
+export declare function isObject(value: unknown): value is Record<string, unknown>;
+/**
+ * 检查值是否为字符串
+ */
+export declare function isString(value: unknown): value is string;
+/**
+ * 检查值是否为数字
+ */
+export declare function isNumber(value: unknown): value is number;
+/**
+ * 检查值是否为布尔值
+ */
+export declare function isBoolean(value: unknown): value is boolean;
+/**
+ * 检查值是否为数组
+ */
+export declare function isArray(value: unknown): value is unknown[];
+/**
+ * 安全地获取对象属性
+ */
+export declare function getProperty<T>(obj: unknown, key: string, validator?: (value: unknown) => value is T): T | undefined;
+/**
+ * 检查对象是否具有特定属性
+ */
+export declare function hasProperty(obj: unknown, key: string): obj is Record<string, unknown>;
+/**
+ * 验证对象具有必需的属性
+ */
+export declare function hasRequiredProperties(obj: unknown, properties: string[]): obj is Record<string, unknown>;
+/**
+ * 类型断言辅助函数
+ */
+export declare function assertType<T>(value: unknown, validator: (value: unknown) => value is T, errorMessage: string): T;
+/**
+ * 安全的 JSON 解析
+ */
+export declare function safeJsonParse(json: string): unknown;
+/**
+ * 将 unknown 类型转换为 Record<string, unknown>
+ * 如果不是对象，返回空对象
+ */
+export declare function toRecord(value: unknown): Record<string, unknown>;
+/**
+ * 将 unknown 类型转换为数组
+ * 如果不是数组，返回空数组
+ */
+export declare function toArray(value: unknown): unknown[];
+//# sourceMappingURL=typeGuards.d.ts.map

package/dist/features/shared/typeGuards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeGuards.d.ts","sourceRoot":"","sources":["../../../src/features/shared/typeGuards.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,EAAE,CAE1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GACzC,CAAC,GAAG,SAAS,CAYf;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,MAAM,GACV,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEhC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,MAAM,EAAE,GACnB,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMhC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,EACzC,YAAY,EAAE,MAAM,GACnB,CAAC,CAKH;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMnD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEhE;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,CAEjD"}

package/dist/features/shared/typeGuards.js

@@ -0,0 +1,96 @@
+/**
+ * 类型守卫和类型验证工具
+ */
+/**
+ * 检查值是否为对象（非 null）
+ */
+export function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * 检查值是否为字符串
+ */
+export function isString(value) {
+    return typeof value === 'string';
+}
+/**
+ * 检查值是否为数字
+ */
+export function isNumber(value) {
+    return typeof value === 'number';
+}
+/**
+ * 检查值是否为布尔值
+ */
+export function isBoolean(value) {
+    return typeof value === 'boolean';
+}
+/**
+ * 检查值是否为数组
+ */
+export function isArray(value) {
+    return Array.isArray(value);
+}
+/**
+ * 安全地获取对象属性
+ */
+export function getProperty(obj, key, validator) {
+    if (!isObject(obj)) {
+        return undefined;
+    }
+    const value = obj[key];
+    if (validator) {
+        return validator(value) ? value : undefined;
+    }
+    return value;
+}
+/**
+ * 检查对象是否具有特定属性
+ */
+export function hasProperty(obj, key) {
+    return isObject(obj) && key in obj;
+}
+/**
+ * 验证对象具有必需的属性
+ */
+export function hasRequiredProperties(obj, properties) {
+    if (!isObject(obj)) {
+        return false;
+    }
+    return properties.every(prop => prop in obj);
+}
+/**
+ * 类型断言辅助函数
+ */
+export function assertType(value, validator, errorMessage) {
+    if (!validator(value)) {
+        throw new TypeError(errorMessage);
+    }
+    return value;
+}
+/**
+ * 安全的 JSON 解析
+ */
+export function safeJsonParse(json) {
+    try {
+        return JSON.parse(json);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * 将 unknown 类型转换为 Record<string, unknown>
+ * 如果不是对象，返回空对象
+ */
+export function toRecord(value) {
+    return isObject(value) ? value : {};
+}
+/**
+ * 将 unknown 类型转换为数组
+ * 如果不是数组，返回空数组
+ */
+export function toArray(value) {
+    return isArray(value) ? value : [];
+}
+//# sourceMappingURL=typeGuards.js.map

package/dist/features/shared/typeGuards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeGuards.js","sourceRoot":"","sources":["../../../src/features/shared/typeGuards.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,GAAY,EACZ,GAAW,EACX,SAA0C;IAE1C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IAEvB,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9C,CAAC;IAED,OAAO,KAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,GAAY,EACZ,GAAW;IAEX,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,GAAY,EACZ,UAAoB;IAEpB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,KAAc,EACd,SAAyC,EACzC,YAAoB;IAEpB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,SAAS,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACrC,CAAC"}

package/dist/features/skip/skipStage.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Skip current stage
+ */
+import { WorkflowResult } from '../shared/mcpTypes.js';
+export interface SkipOptions {
+    path: string;
+}
+export declare function skipStage(options: SkipOptions): Promise<WorkflowResult>;
+//# sourceMappingURL=skipStage.d.ts.map

package/dist/features/skip/skipStage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skipStage.d.ts","sourceRoot":"","sources":["../../../src/features/skip/skipStage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIvD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAsD7E"}