openspec-mcp 0.1.0

package/dist/core/file-watcher.js

@@ -0,0 +1,128 @@
+/**
+ * 文件监控器
+ * 使用 Chokidar 监控 openspec 目录变化
+ */
+import chokidar from 'chokidar';
+import * as path from 'path';
+import { EventEmitter } from 'events';
+export class FileWatcher extends EventEmitter {
+    cwd;
+    watcher = null;
+    constructor(options) {
+        super();
+        this.cwd = options.cwd;
+    }
+    /**
+     * 获取监控目录路径
+     */
+    getWatchPath() {
+        return path.join(this.cwd, 'openspec');
+    }
+    /**
+     * 启动监控
+     */
+    async start() {
+        const watchPath = this.getWatchPath();
+        this.watcher = chokidar.watch(watchPath, {
+            persistent: true,
+            ignoreInitial: true,
+            depth: 10,
+            awaitWriteFinish: {
+                stabilityThreshold: 300,
+                pollInterval: 100,
+            },
+        });
+        this.watcher
+            .on('add', (filePath) => {
+            this.handleChange('add', filePath);
+        })
+            .on('change', (filePath) => {
+            this.handleChange('change', filePath);
+        })
+            .on('unlink', (filePath) => {
+            this.handleChange('unlink', filePath);
+        })
+            .on('addDir', (filePath) => {
+            this.handleChange('addDir', filePath);
+        })
+            .on('unlinkDir', (filePath) => {
+            this.handleChange('unlinkDir', filePath);
+        })
+            .on('error', (error) => {
+            console.error('File watcher error:', error);
+            this.emit('error', error);
+        })
+            .on('ready', () => {
+            console.log(`File watcher ready: ${watchPath}`);
+            this.emit('ready');
+        });
+    }
+    /**
+     * 处理文件变化
+     */
+    handleChange(event, filePath) {
+        // 获取相对路径
+        const relativePath = path.relative(this.cwd, filePath);
+        // 解析文件类型
+        const fileType = this.getFileType(relativePath);
+        console.log(`[${event}] ${relativePath} (${fileType})`);
+        // 发射事件
+        this.emit('change', event, {
+            path: relativePath,
+            absolutePath: filePath,
+            type: fileType,
+            timestamp: new Date().toISOString(),
+        });
+        // 发射特定类型事件
+        this.emit(`change:${fileType}`, event, relativePath);
+    }
+    /**
+     * 获取文件类型
+     */
+    getFileType(relativePath) {
+        if (relativePath.includes('openspec/specs/')) {
+            return 'spec';
+        }
+        if (relativePath.includes('openspec/changes/archive/')) {
+            return 'archive';
+        }
+        if (relativePath.includes('openspec/changes/')) {
+            if (relativePath.endsWith('proposal.md'))
+                return 'proposal';
+            if (relativePath.endsWith('design.md'))
+                return 'design';
+            if (relativePath.endsWith('tasks.md'))
+                return 'tasks';
+            if (relativePath.includes('/specs/'))
+                return 'delta';
+            return 'change';
+        }
+        if (relativePath.includes('openspec/approvals/')) {
+            return 'approval';
+        }
+        if (relativePath.endsWith('AGENTS.md')) {
+            return 'agents';
+        }
+        if (relativePath.endsWith('project.md')) {
+            return 'project';
+        }
+        return 'other';
+    }
+    /**
+     * 停止监控
+     */
+    async stop() {
+        if (this.watcher) {
+            await this.watcher.close();
+            this.watcher = null;
+            console.log('File watcher stopped');
+        }
+    }
+    /**
+     * 是否正在监控
+     */
+    isWatching() {
+        return this.watcher !== null;
+    }
+}
+//# sourceMappingURL=file-watcher.js.map

package/dist/core/file-watcher.js.map

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

package/dist/core/openspec-cli.d.ts

@@ -0,0 +1,94 @@
+/**
+ * OpenSpec CLI 包装器
+ * 通过调用 openspec CLI 命令获取数据
+ */
+import type { Change, ChangeDetail, Spec, SpecDetail, ValidationResult, Task, Progress } from '../types/openspec.js';
+export interface OpenSpecCliOptions {
+    cwd?: string;
+}
+export declare class OpenSpecCli {
+    private cwd;
+    private taskParser;
+    constructor(options?: OpenSpecCliOptions);
+    /**
+     * 获取 openspec 目录路径
+     */
+    private getOpenSpecDir;
+    /**
+     * 检查 openspec 是否已初始化
+     */
+    isInitialized(): Promise<boolean>;
+    /**
+     * 获取 AGENTS.md 内容（使用指南）
+     */
+    getInstructions(): Promise<string>;
+    /**
+     * 获取 project.md 内容（项目上下文）
+     */
+    getProjectContext(): Promise<string>;
+    /**
+     * 列出所有变更
+     */
+    listChanges(options?: {
+        includeArchived?: boolean;
+    }): Promise<Change[]>;
+    /**
+     * 列出已归档的变更
+     */
+    private listArchivedChanges;
+    /**
+     * 解析变更目录
+     */
+    private parseChangeDir;
+    /**
+     * 显示变更详情
+     */
+    showChange(changeId: string, options?: {
+        deltasOnly?: boolean;
+    }): Promise<ChangeDetail | null>;
+    /**
+     * 列出所有规格
+     */
+    listSpecs(): Promise<Spec[]>;
+    /**
+     * 显示规格详情
+     */
+    showSpec(specId: string): Promise<SpecDetail | null>;
+    /**
+     * 验证变更
+     */
+    validateChange(changeId: string, options?: {
+        strict?: boolean;
+    }): Promise<ValidationResult>;
+    /**
+     * 验证规格
+     */
+    validateSpec(specId: string, options?: {
+        strict?: boolean;
+    }): Promise<ValidationResult>;
+    /**
+     * 归档变更
+     */
+    archiveChange(changeId: string, options?: {
+        skipSpecs?: boolean;
+    }): Promise<{
+        success: boolean;
+        archivedPath: string;
+        error?: string;
+    }>;
+    /**
+     * 获取变更的任务列表
+     */
+    getTasks(changeId: string): Promise<{
+        tasks: Task[];
+        progress: Progress;
+    }>;
+    /**
+     * 更新任务状态
+     */
+    updateTaskStatus(changeId: string, taskId: string, status: 'pending' | 'in_progress' | 'done'): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=openspec-cli.d.ts.map

package/dist/core/openspec-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openspec-cli.d.ts","sourceRoot":"","sources":["../../src/core/openspec-cli.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EACZ,IAAI,EACJ,UAAU,EACV,gBAAgB,EAChB,IAAI,EACJ,QAAQ,EACT,MAAM,sBAAsB,CAAC;AAK9B,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,UAAU,CAAa;gBAEnB,OAAO,CAAC,EAAE,kBAAkB;IAKxC;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IASvC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IASxC;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAS1C;;OAEG;IACG,WAAW,CAAC,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgC7E;;OAEG;YACW,mBAAmB;IAuBjC;;OAEG;YACW,cAAc;IAkD5B;;OAEG;IACG,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GACjC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAuF/B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAwClC;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IA4B1D;;OAEG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7B,OAAO,CAAC,gBAAgB,CAAC;IAwB5B;;OAEG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7B,OAAO,CAAC,gBAAgB,CAAC;IAsB5B;;OAEG;IACG,aAAa,CACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAChC,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAiCtE;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC;IAsBhF;;OAEG;IACG,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,MAAM,GACzC,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAWjD"}

package/dist/core/openspec-cli.js

@@ -0,0 +1,436 @@
+/**
+ * OpenSpec CLI 包装器
+ * 通过调用 openspec CLI 命令获取数据
+ */
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { TaskParser } from './task-parser.js';
+const execAsync = promisify(exec);
+export class OpenSpecCli {
+    cwd;
+    taskParser;
+    constructor(options) {
+        this.cwd = options?.cwd || process.cwd();
+        this.taskParser = new TaskParser();
+    }
+    /**
+     * 获取 openspec 目录路径
+     */
+    getOpenSpecDir() {
+        return path.join(this.cwd, 'openspec');
+    }
+    /**
+     * 检查 openspec 是否已初始化
+     */
+    async isInitialized() {
+        try {
+            await fs.access(this.getOpenSpecDir());
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 获取 AGENTS.md 内容（使用指南）
+     */
+    async getInstructions() {
+        const agentsPath = path.join(this.getOpenSpecDir(), 'AGENTS.md');
+        try {
+            return await fs.readFile(agentsPath, 'utf-8');
+        }
+        catch {
+            return 'AGENTS.md not found. Run `openspec init` to initialize.';
+        }
+    }
+    /**
+     * 获取 project.md 内容（项目上下文）
+     */
+    async getProjectContext() {
+        const projectPath = path.join(this.getOpenSpecDir(), 'project.md');
+        try {
+            return await fs.readFile(projectPath, 'utf-8');
+        }
+        catch {
+            return 'project.md not found. Run `openspec init` to initialize.';
+        }
+    }
+    /**
+     * 列出所有变更
+     */
+    async listChanges(options) {
+        const changesDir = path.join(this.getOpenSpecDir(), 'changes');
+        const changes = [];
+        try {
+            const entries = await fs.readdir(changesDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                // 跳过 archive 目录（除非指定包含）
+                if (entry.name === 'archive') {
+                    if (options?.includeArchived) {
+                        const archivedChanges = await this.listArchivedChanges();
+                        changes.push(...archivedChanges);
+                    }
+                    continue;
+                }
+                const changeDir = path.join(changesDir, entry.name);
+                const change = await this.parseChangeDir(entry.name, changeDir, 'active');
+                if (change) {
+                    changes.push(change);
+                }
+            }
+        }
+        catch (error) {
+            // 目录不存在，返回空数组
+        }
+        return changes;
+    }
+    /**
+     * 列出已归档的变更
+     */
+    async listArchivedChanges() {
+        const archiveDir = path.join(this.getOpenSpecDir(), 'changes', 'archive');
+        const changes = [];
+        try {
+            const entries = await fs.readdir(archiveDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const changeDir = path.join(archiveDir, entry.name);
+                const change = await this.parseChangeDir(entry.name, changeDir, 'archived');
+                if (change) {
+                    changes.push(change);
+                }
+            }
+        }
+        catch {
+            // archive 目录不存在
+        }
+        return changes;
+    }
+    /**
+     * 解析变更目录
+     */
+    async parseChangeDir(id, changeDir, status) {
+        try {
+            const proposalPath = path.join(changeDir, 'proposal.md');
+            const tasksPath = path.join(changeDir, 'tasks.md');
+            // 读取 proposal 获取标题
+            let title = id;
+            try {
+                const proposal = await fs.readFile(proposalPath, 'utf-8');
+                const titleMatch = proposal.match(/^#\s+(.+)/m);
+                if (titleMatch) {
+                    title = titleMatch[1].trim();
+                }
+            }
+            catch {
+                // 没有 proposal.md
+            }
+            // 读取 tasks 获取进度
+            let tasksCompleted = 0;
+            let tasksTotal = 0;
+            try {
+                const tasks = await this.taskParser.parseTasks(tasksPath);
+                const progress = this.taskParser.calculateProgress(tasks);
+                tasksCompleted = progress.completed;
+                tasksTotal = progress.total;
+            }
+            catch {
+                // 没有 tasks.md
+            }
+            // 获取文件修改时间
+            const stats = await fs.stat(changeDir);
+            return {
+                id,
+                title,
+                status,
+                tasksCompleted,
+                tasksTotal,
+                createdAt: stats.birthtime.toISOString(),
+                updatedAt: stats.mtime.toISOString(),
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * 显示变更详情
+     */
+    async showChange(changeId, options) {
+        // 先在活跃变更中查找
+        let changeDir = path.join(this.getOpenSpecDir(), 'changes', changeId);
+        try {
+            await fs.access(changeDir);
+        }
+        catch {
+            // 在归档中查找
+            const archiveDir = path.join(this.getOpenSpecDir(), 'changes', 'archive');
+            try {
+                const archives = await fs.readdir(archiveDir);
+                const match = archives.find((a) => a.endsWith(changeId) || a === changeId);
+                if (match) {
+                    changeDir = path.join(archiveDir, match);
+                }
+                else {
+                    return null;
+                }
+            }
+            catch {
+                return null;
+            }
+        }
+        const change = await this.parseChangeDir(changeId, changeDir, changeDir.includes('archive') ? 'archived' : 'active');
+        if (!change)
+            return null;
+        // 读取 proposal
+        let proposal = '';
+        try {
+            proposal = await fs.readFile(path.join(changeDir, 'proposal.md'), 'utf-8');
+        }
+        catch {
+            // 没有 proposal.md
+        }
+        // 读取 design (可选)
+        let design;
+        try {
+            design = await fs.readFile(path.join(changeDir, 'design.md'), 'utf-8');
+        }
+        catch {
+            // 没有 design.md
+        }
+        // 读取 tasks
+        let tasks = [];
+        try {
+            const tasksPath = path.join(changeDir, 'tasks.md');
+            tasks = await this.taskParser.parseTasks(tasksPath);
+        }
+        catch {
+            // 没有 tasks.md
+        }
+        // 读取 deltas (specs 目录下的变更)
+        const deltas = [];
+        const specsDir = path.join(changeDir, 'specs');
+        try {
+            const specDirs = await fs.readdir(specsDir, { withFileTypes: true });
+            for (const specDir of specDirs) {
+                if (!specDir.isDirectory())
+                    continue;
+                const specPath = path.join(specsDir, specDir.name, 'spec.md');
+                try {
+                    const content = await fs.readFile(specPath, 'utf-8');
+                    deltas.push({
+                        specName: specDir.name,
+                        content,
+                    });
+                }
+                catch {
+                    // 没有 spec.md
+                }
+            }
+        }
+        catch {
+            // 没有 specs 目录
+        }
+        return {
+            ...change,
+            proposal,
+            design,
+            tasks,
+            deltas,
+        };
+    }
+    /**
+     * 列出所有规格
+     */
+    async listSpecs() {
+        const specsDir = path.join(this.getOpenSpecDir(), 'specs');
+        const specs = [];
+        try {
+            const entries = await fs.readdir(specsDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const specPath = path.join(specsDir, entry.name, 'spec.md');
+                try {
+                    const content = await fs.readFile(specPath, 'utf-8');
+                    const stats = await fs.stat(specPath);
+                    // 解析标题
+                    const titleMatch = content.match(/^#\s+(.+)/m);
+                    const title = titleMatch ? titleMatch[1].trim() : entry.name;
+                    // 计算需求数量
+                    const requirementsMatch = content.match(/###\s+Requirement:/g);
+                    const requirementsCount = requirementsMatch ? requirementsMatch.length : 0;
+                    specs.push({
+                        id: entry.name,
+                        title,
+                        requirementsCount,
+                        updatedAt: stats.mtime.toISOString(),
+                    });
+                }
+                catch {
+                    // 没有 spec.md
+                }
+            }
+        }
+        catch {
+            // specs 目录不存在
+        }
+        return specs;
+    }
+    /**
+     * 显示规格详情
+     */
+    async showSpec(specId) {
+        const specPath = path.join(this.getOpenSpecDir(), 'specs', specId, 'spec.md');
+        try {
+            const content = await fs.readFile(specPath, 'utf-8');
+            const stats = await fs.stat(specPath);
+            // 解析标题
+            const titleMatch = content.match(/^#\s+(.+)/m);
+            const title = titleMatch ? titleMatch[1].trim() : specId;
+            // 计算需求数量
+            const requirementsMatch = content.match(/###\s+Requirement:/g);
+            const requirementsCount = requirementsMatch ? requirementsMatch.length : 0;
+            return {
+                id: specId,
+                title,
+                requirementsCount,
+                updatedAt: stats.mtime.toISOString(),
+                content,
+                requirements: [], // TODO: 详细解析需求
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * 验证变更
+     */
+    async validateChange(changeId, options) {
+        try {
+            const flags = options?.strict ? '--strict' : '';
+            await execAsync(`openspec validate ${changeId} ${flags}`, { cwd: this.cwd });
+            return { valid: true, errors: [] };
+        }
+        catch (error) {
+            // 解析错误输出
+            const errors = [];
+            const output = error.stderr || error.stdout || '';
+            // 简单解析错误信息
+            const lines = output.split('\n').filter((l) => l.trim());
+            for (const line of lines) {
+                if (line.includes('Error') || line.includes('error')) {
+                    errors.push({ type: 'error', message: line.trim() });
+                }
+                else if (line.includes('Warning') || line.includes('warning')) {
+                    errors.push({ type: 'warning', message: line.trim() });
+                }
+            }
+            return { valid: false, errors };
+        }
+    }
+    /**
+     * 验证规格
+     */
+    async validateSpec(specId, options) {
+        try {
+            const flags = options?.strict ? '--strict' : '';
+            await execAsync(`openspec spec validate ${specId} ${flags}`, { cwd: this.cwd });
+            return { valid: true, errors: [] };
+        }
+        catch (error) {
+            const errors = [];
+            const output = error.stderr || error.stdout || '';
+            const lines = output.split('\n').filter((l) => l.trim());
+            for (const line of lines) {
+                if (line.includes('Error') || line.includes('error')) {
+                    errors.push({ type: 'error', message: line.trim() });
+                }
+                else if (line.includes('Warning') || line.includes('warning')) {
+                    errors.push({ type: 'warning', message: line.trim() });
+                }
+            }
+            return { valid: false, errors };
+        }
+    }
+    /**
+     * 归档变更
+     */
+    async archiveChange(changeId, options) {
+        try {
+            const flags = options?.skipSpecs ? '--skip-specs --yes' : '--yes';
+            const { stdout, stderr } = await execAsync(`openspec archive ${changeId} ${flags}`, { cwd: this.cwd });
+            const date = new Date().toISOString().slice(0, 10);
+            const archivedPath = `openspec/changes/archive/${date}-${changeId}`;
+            // 验证归档目录是否存在
+            const fullPath = path.join(this.cwd, archivedPath);
+            try {
+                await fs.access(fullPath);
+                return { success: true, archivedPath };
+            }
+            catch {
+                // 归档目录不存在，说明归档失败
+                const errorOutput = stderr || stdout || 'Archive command did not create the archive directory';
+                return {
+                    success: false,
+                    archivedPath: '',
+                    error: errorOutput,
+                };
+            }
+        }
+        catch (error) {
+            // 提取 stderr 信息
+            const errorMsg = error.stderr || error.stdout || error.message || 'Archive failed';
+            return {
+                success: false,
+                archivedPath: '',
+                error: errorMsg,
+            };
+        }
+    }
+    /**
+     * 获取变更的任务列表
+     */
+    async getTasks(changeId) {
+        const changeDir = path.join(this.getOpenSpecDir(), 'changes', changeId);
+        const tasksPath = path.join(changeDir, 'tasks.md');
+        try {
+            const tasks = await this.taskParser.parseTasks(tasksPath);
+            const progress = this.taskParser.calculateProgress(tasks);
+            return { tasks, progress };
+        }
+        catch {
+            return {
+                tasks: [],
+                progress: {
+                    total: 0,
+                    completed: 0,
+                    inProgress: 0,
+                    pending: 0,
+                    percentage: 0,
+                },
+            };
+        }
+    }
+    /**
+     * 更新任务状态
+     */
+    async updateTaskStatus(changeId, taskId, status) {
+        const changeDir = path.join(this.getOpenSpecDir(), 'changes', changeId);
+        const tasksPath = path.join(changeDir, 'tasks.md');
+        try {
+            await this.taskParser.updateTaskStatus(tasksPath, taskId, status);
+            return { success: true };
+        }
+        catch (error) {
+            return { success: false, error: error.message };
+        }
+    }
+}
+//# sourceMappingURL=openspec-cli.js.map