@arimakouyou/spec-workflow-mcp 2.2.7

package/dist/core/workspace-initializer.js

@@ -0,0 +1,168 @@
+import { promises as fs } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { PathUtils } from './path-utils.js';
+import { ImplementationLogMigrator } from './implementation-log-migrator.js';
+import { getGlobalDir } from './global-dir.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+export class WorkspaceInitializer {
+    projectPath;
+    version;
+    constructor(projectPath, version) {
+        this.projectPath = projectPath;
+        this.version = version;
+    }
+    async initializeWorkspace() {
+        // Create all necessary directories
+        await this.initializeDirectories();
+        // Copy template files
+        await this.initializeTemplates();
+        // Create user templates README
+        await this.createUserTemplatesReadme();
+        // Migrate implementation logs from JSON to Markdown format
+        await this.migrateImplementationLogs();
+    }
+    async initializeDirectories() {
+        const workflowRoot = PathUtils.getWorkflowRoot(this.projectPath);
+        const directories = [
+            'approvals',
+            'archive',
+            'specs',
+            'steering',
+            'templates',
+            'user-templates',
+            'user-prompts'
+        ];
+        for (const dir of directories) {
+            const dirPath = join(workflowRoot, dir);
+            await fs.mkdir(dirPath, { recursive: true });
+        }
+    }
+    async initializeTemplates() {
+        const templatesDir = join(PathUtils.getWorkflowRoot(this.projectPath), 'templates');
+        const templates = [
+            'requirements-template',
+            'design-template',
+            'test-design-template',
+            'tasks-template',
+            'product-template',
+            'tech-template',
+            'structure-template'
+        ];
+        for (const template of templates) {
+            await this.copyTemplate(template, templatesDir);
+        }
+    }
+    async copyTemplate(templateName, targetDir) {
+        // Use simple filename without version
+        const targetFileName = `${templateName}.md`;
+        const targetPath = join(targetDir, targetFileName);
+        const sourcePath = join(__dirname, '..', 'markdown', 'templates', `${templateName}.md`);
+        try {
+            const content = await fs.readFile(sourcePath, 'utf-8');
+            // Always overwrite to ensure latest template version is used
+            await fs.writeFile(targetPath, content, 'utf-8');
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(`Failed to copy template ${templateName}: ${errorMessage}`);
+        }
+    }
+    async createUserTemplatesReadme() {
+        const readmePath = join(PathUtils.getWorkflowRoot(this.projectPath), 'user-templates', 'README.md');
+        const readmeContent = `# User Templates
+
+This directory allows you to create custom templates that override the default Spec Workflow templates.
+
+## How to Use Custom Templates
+
+1. **Create your custom template file** in this directory with the exact same name as the default template you want to override:
+   - \`requirements-template.md\` - Override requirements document template
+   - \`design-template.md\` - Override design document template
+   - \`test-design-template.md\` - Override test design document template
+   - \`tasks-template.md\` - Override tasks document template
+   - \`product-template.md\` - Override product steering template
+   - \`tech-template.md\` - Override tech steering template
+   - \`structure-template.md\` - Override structure steering template
+
+2. **Template Loading Priority**:
+   - The system first checks this \`user-templates/\` directory
+   - If a matching template is found here, it will be used
+   - Otherwise, the default template from \`templates/\` will be used
+
+## Example Custom Template
+
+To create a custom requirements template:
+
+1. Create a file named \`requirements-template.md\` in this directory
+2. Add your custom structure, for example:
+
+\`\`\`markdown
+# Requirements Document
+
+## Executive Summary
+[Your custom section]
+
+## Business Requirements
+[Your custom structure]
+
+## Technical Requirements
+[Your custom fields]
+
+## Custom Sections
+[Add any sections specific to your workflow]
+\`\`\`
+
+## Template Variables
+
+Templates can include placeholders that will be replaced when documents are created:
+- \`{{projectName}}\` - The name of your project
+- \`{{featureName}}\` - The name of the feature being specified
+- \`{{date}}\` - The current date
+- \`{{author}}\` - The document author
+
+## Best Practices
+
+1. **Start from defaults**: Copy a default template from \`../templates/\` as a starting point
+2. **Keep structure consistent**: Maintain similar section headers for tool compatibility
+3. **Document changes**: Add comments explaining why sections were added/modified
+4. **Version control**: Track your custom templates in version control
+5. **Test thoroughly**: Ensure custom templates work with the spec workflow tools
+
+## Notes
+
+- Custom templates are project-specific and not included in the package distribution
+- The \`templates/\` directory contains the default templates which are updated with each version
+- Your custom templates in this directory are preserved during updates
+- If a custom template has errors, the system will fall back to the default template
+`;
+        try {
+            // Only create if it doesn't exist to avoid overwriting user's README
+            await fs.access(readmePath);
+        }
+        catch {
+            // File doesn't exist, create it
+            await fs.writeFile(readmePath, readmeContent, 'utf-8');
+        }
+    }
+    /**
+     * Migrate implementation logs from JSON to Markdown format
+     * Runs on server startup to handle automatic migration for existing specs
+     */
+    async migrateImplementationLogs() {
+        try {
+            const userDataDir = getGlobalDir();
+            const specsDir = join(PathUtils.getWorkflowRoot(this.projectPath), 'specs');
+            // Create user data directory if it doesn't exist
+            await fs.mkdir(userDataDir, { recursive: true });
+            const migrator = new ImplementationLogMigrator(userDataDir);
+            await migrator.migrateAllSpecs(specsDir);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(`Implementation log migration failed: ${errorMessage}`);
+            // Don't throw - migration failure shouldn't break server startup
+        }
+    }
+}
+//# sourceMappingURL=workspace-initializer.js.map

package/dist/core/workspace-initializer.js.map

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

package/dist/dashboard/__tests__/approval-storage-path-resolution.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=approval-storage-path-resolution.test.d.ts.map

package/dist/dashboard/__tests__/approval-storage-path-resolution.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-storage-path-resolution.test.d.ts","sourceRoot":"","sources":["../../../src/dashboard/__tests__/approval-storage-path-resolution.test.ts"],"names":[],"mappings":""}

package/dist/dashboard/__tests__/approval-storage-path-resolution.test.js

@@ -0,0 +1,78 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { ApprovalStorage } from '../approval-storage.js';
+describe('ApprovalStorage path resolution', () => {
+    let tempDir;
+    let workflowRootPath;
+    let workspacePath;
+    let storage;
+    beforeEach(async () => {
+        tempDir = join(tmpdir(), `spec-workflow-approvals-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`);
+        workflowRootPath = join(tempDir, 'repo-main');
+        workspacePath = join(tempDir, 'repo-feature-worktree');
+        await fs.mkdir(workflowRootPath, { recursive: true });
+        await fs.mkdir(workspacePath, { recursive: true });
+        storage = new ApprovalStorage(workflowRootPath, {
+            originalPath: workflowRootPath,
+            fileResolutionPath: workspacePath
+        });
+    });
+    afterEach(async () => {
+        await storage.stop();
+        try {
+            await fs.rm(tempDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    });
+    it('prefers workspace file for snapshots when both workspace and workflow files exist', async () => {
+        const relativePath = 'src/feature.ts';
+        const workspaceFile = join(workspacePath, relativePath);
+        const workflowFile = join(workflowRootPath, relativePath);
+        await fs.mkdir(join(workspacePath, 'src'), { recursive: true });
+        await fs.mkdir(join(workflowRootPath, 'src'), { recursive: true });
+        await fs.writeFile(workspaceFile, 'workspace-version', 'utf-8');
+        await fs.writeFile(workflowFile, 'workflow-version', 'utf-8');
+        const approvalId = await storage.createApproval('Review feature', relativePath, 'spec', 'test-spec');
+        const snapshots = await storage.getSnapshots(approvalId);
+        expect(snapshots).toHaveLength(1);
+        expect(snapshots[0].content).toBe('workspace-version');
+    });
+    it('falls back to workflow root when file only exists there', async () => {
+        const relativePath = '.spec-workflow/specs/test-spec/requirements.md';
+        const workflowFile = join(workflowRootPath, relativePath);
+        await fs.mkdir(join(workflowRootPath, '.spec-workflow', 'specs', 'test-spec'), { recursive: true });
+        await fs.writeFile(workflowFile, '# Requirements from shared root', 'utf-8');
+        const approvalId = await storage.createApproval('Review requirements', relativePath, 'spec', 'test-spec');
+        const content = await storage.getCurrentFileContent(approvalId);
+        expect(content).toBe('# Requirements from shared root');
+    });
+    it('rejects absolute file paths in createApproval', async () => {
+        await expect(storage.createApproval('Review', '/etc/passwd', 'spec', 'test-spec')).rejects.toThrow('absolute paths are not allowed');
+    });
+    it('rejects path traversal in createApproval', async () => {
+        await expect(storage.createApproval('Review', '../../../etc/passwd', 'spec', 'test-spec')).rejects.toThrow('path traversal (..) is not allowed');
+    });
+    it('rejects embedded path traversal in createApproval', async () => {
+        await expect(storage.createApproval('Review', 'src/../../etc/passwd', 'spec', 'test-spec')).rejects.toThrow('path traversal (..) is not allowed');
+    });
+    it('writes revisions to workspace file when it exists there', async () => {
+        const relativePath = 'src/revision-target.ts';
+        const workspaceFile = join(workspacePath, relativePath);
+        const workflowFile = join(workflowRootPath, relativePath);
+        await fs.mkdir(join(workspacePath, 'src'), { recursive: true });
+        await fs.mkdir(join(workflowRootPath, 'src'), { recursive: true });
+        await fs.writeFile(workspaceFile, 'workspace-original', 'utf-8');
+        await fs.writeFile(workflowFile, 'workflow-original', 'utf-8');
+        const approvalId = await storage.createApproval('Review revision target', relativePath, 'spec', 'test-spec');
+        await storage.createRevision(approvalId, 'workspace-updated', 'needs update');
+        const workspaceContent = await fs.readFile(workspaceFile, 'utf-8');
+        const workflowContent = await fs.readFile(workflowFile, 'utf-8');
+        expect(workspaceContent).toBe('workspace-updated');
+        expect(workflowContent).toBe('workflow-original');
+    });
+});
+//# sourceMappingURL=approval-storage-path-resolution.test.js.map

package/dist/dashboard/__tests__/approval-storage-path-resolution.test.js.map

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

package/dist/dashboard/__tests__/multi-server-approvals-content.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=multi-server-approvals-content.test.d.ts.map

package/dist/dashboard/__tests__/multi-server-approvals-content.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-server-approvals-content.test.d.ts","sourceRoot":"","sources":["../../../src/dashboard/__tests__/multi-server-approvals-content.test.ts"],"names":[],"mappings":""}

package/dist/dashboard/__tests__/multi-server-approvals-content.test.js

@@ -0,0 +1,115 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { promises as fs } from 'fs';
+import net from 'net';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { MultiProjectDashboardServer } from '../multi-server.js';
+import { ApprovalStorage } from '../approval-storage.js';
+import { ProjectRegistry, generateProjectId } from '../../core/project-registry.js';
+import { SPEC_WORKFLOW_HOME_ENV } from '../../core/global-dir.js';
+async function getFreePort() {
+    return await new Promise((resolvePort, reject) => {
+        const server = net.createServer();
+        server.listen(0, '127.0.0.1', () => {
+            const address = server.address();
+            if (!address || typeof address === 'string') {
+                server.close();
+                reject(new Error('Failed to get free port'));
+                return;
+            }
+            const port = address.port;
+            server.close(() => resolvePort(port));
+        });
+        server.on('error', reject);
+    });
+}
+describe('MultiProjectDashboardServer approvals content resolution', () => {
+    let tempDir;
+    let workspacePath;
+    let workflowRootPath;
+    let server = null;
+    let projectId;
+    let realFetch;
+    const originalEnv = { ...process.env };
+    beforeEach(async () => {
+        tempDir = join(tmpdir(), `specwf-multi-server-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`);
+        workspacePath = join(tempDir, 'worktrees', 'wt-a');
+        workflowRootPath = join(tempDir, 'repo-main');
+        await fs.mkdir(workspacePath, { recursive: true });
+        await fs.mkdir(workflowRootPath, { recursive: true });
+        process.env[SPEC_WORKFLOW_HOME_ENV] = join(tempDir, '.global-state');
+        projectId = generateProjectId(workspacePath);
+        realFetch = globalThis.fetch;
+        const registry = new ProjectRegistry();
+        await registry.registerProject(workspacePath, process.pid, { workflowRootPath });
+        // Prevent network dependency in package version lookup.
+        vi.stubGlobal('fetch', vi.fn(async () => ({
+            ok: false,
+            json: async () => ({})
+        })));
+    });
+    afterEach(async () => {
+        if (server) {
+            await server.stop();
+            server = null;
+        }
+        vi.unstubAllGlobals();
+        process.env = { ...originalEnv };
+        await fs.rm(tempDir, { recursive: true, force: true });
+    });
+    it('prioritizes workspace path before workflow root for relative approval filePath', async () => {
+        const relativePath = 'src/service.ts';
+        await fs.mkdir(join(workspacePath, 'src'), { recursive: true });
+        await fs.mkdir(join(workflowRootPath, 'src'), { recursive: true });
+        await fs.writeFile(join(workspacePath, relativePath), 'workspace-content', 'utf-8');
+        await fs.writeFile(join(workflowRootPath, relativePath), 'workflow-content', 'utf-8');
+        const approvalStorage = new ApprovalStorage(workflowRootPath, {
+            originalPath: workflowRootPath,
+            fileResolutionPath: workspacePath
+        });
+        const approvalId = await approvalStorage.createApproval('Review service', relativePath, 'spec', 'test-spec');
+        const port = await getFreePort();
+        server = new MultiProjectDashboardServer({ autoOpen: false, port });
+        await server.start();
+        const response = await realFetch(`http://127.0.0.1:${port}/api/projects/${projectId}/approvals/${approvalId}/content`);
+        const body = await response.json();
+        expect(response.status).toBe(200);
+        expect(body.content).toBe('workspace-content');
+        expect(body.filePath).toContain(join('worktrees', 'wt-a', 'src', 'service.ts'));
+    });
+    it('falls back to workflow root when relative file only exists there', async () => {
+        const relativePath = '.spec-workflow/specs/test-spec/requirements.md';
+        await fs.mkdir(join(workflowRootPath, '.spec-workflow', 'specs', 'test-spec'), { recursive: true });
+        await fs.writeFile(join(workflowRootPath, relativePath), '# Shared requirements', 'utf-8');
+        const approvalStorage = new ApprovalStorage(workflowRootPath, {
+            originalPath: workflowRootPath,
+            fileResolutionPath: workspacePath
+        });
+        const approvalId = await approvalStorage.createApproval('Review requirements', relativePath, 'spec', 'test-spec');
+        const port = await getFreePort();
+        server = new MultiProjectDashboardServer({ autoOpen: false, port });
+        await server.start();
+        const response = await realFetch(`http://127.0.0.1:${port}/api/projects/${projectId}/approvals/${approvalId}/content`);
+        const body = await response.json();
+        expect(response.status).toBe(200);
+        expect(body.content).toBe('# Shared requirements');
+        expect(body.filePath).toContain(join('repo-main', '.spec-workflow', 'specs', 'test-spec', 'requirements.md'));
+    });
+    it('rejects absolute approval filePath', async () => {
+        const absolutePath = join(tempDir, 'absolute-target.md');
+        await fs.writeFile(absolutePath, 'absolute-file-content', 'utf-8');
+        const approvalStorage = new ApprovalStorage(workflowRootPath, {
+            originalPath: workflowRootPath,
+            fileResolutionPath: workspacePath
+        });
+        await expect(approvalStorage.createApproval('Review absolute path', absolutePath, 'spec', 'test-spec')).rejects.toThrow('absolute paths are not allowed');
+    });
+    it('rejects path traversal in approval filePath', async () => {
+        const approvalStorage = new ApprovalStorage(workflowRootPath, {
+            originalPath: workflowRootPath,
+            fileResolutionPath: workspacePath
+        });
+        await expect(approvalStorage.createApproval('Review traversal', '../../../etc/passwd', 'spec', 'test-spec')).rejects.toThrow('path traversal (..) is not allowed');
+    });
+});
+//# sourceMappingURL=multi-server-approvals-content.test.js.map

package/dist/dashboard/__tests__/multi-server-approvals-content.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-server-approvals-content.test.js","sourceRoot":"","sources":["../../../src/dashboard/__tests__/multi-server-approvals-content.test.ts"],"names":[],"mappings":"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"}

package/dist/dashboard/__tests__/watcher-error-handling.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=watcher-error-handling.test.d.ts.map

package/dist/dashboard/__tests__/watcher-error-handling.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher-error-handling.test.d.ts","sourceRoot":"","sources":["../../../src/dashboard/__tests__/watcher-error-handling.test.ts"],"names":[],"mappings":""}

package/dist/dashboard/__tests__/watcher-error-handling.test.js

@@ -0,0 +1,118 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { SpecWatcher } from '../watcher.js';
+import { SpecParser } from '../parser.js';
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+describe('SpecWatcher Error Handling', () => {
+    let testDir;
+    let watcher;
+    let parser;
+    beforeEach(async () => {
+        // Create a temporary test directory
+        testDir = join(tmpdir(), `spec-workflow-test-${Date.now()}`);
+        await fs.mkdir(testDir, { recursive: true });
+        // Create the workflow directory structure
+        const workflowDir = join(testDir, '.spec-workflow');
+        const specsDir = join(workflowDir, 'specs');
+        const steeringDir = join(workflowDir, 'steering');
+        await fs.mkdir(workflowDir, { recursive: true });
+        await fs.mkdir(specsDir, { recursive: true });
+        await fs.mkdir(steeringDir, { recursive: true });
+        // Create a test spec
+        const testSpecDir = join(specsDir, 'test-spec');
+        await fs.mkdir(testSpecDir, { recursive: true });
+        await fs.writeFile(join(testSpecDir, 'requirements.md'), '# Test Requirements\n\nSome content');
+        // Initialize parser and watcher
+        parser = new SpecParser(testDir);
+        watcher = new SpecWatcher(testDir, parser);
+    });
+    afterEach(async () => {
+        // Stop watcher
+        if (watcher) {
+            await watcher.stop();
+        }
+        // Clean up test directory
+        try {
+            await fs.rm(testDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    });
+    it('should start without crashing', async () => {
+        await expect(watcher.start()).resolves.not.toThrow();
+    });
+    it('should handle file changes without crashing', async () => {
+        await watcher.start();
+        // Set up event listener to track changes
+        const changeEvents = [];
+        watcher.on('change', (event) => {
+            changeEvents.push(event);
+        });
+        // Modify a file
+        const requirementsPath = join(testDir, '.spec-workflow', 'specs', 'test-spec', 'requirements.md');
+        await fs.writeFile(requirementsPath, '# Updated Requirements\n\nUpdated content');
+        // Wait for file system events to propagate
+        await new Promise(resolve => setTimeout(resolve, 300));
+        // Watcher should still be running (not crashed)
+        expect(watcher).toBeDefined();
+    });
+    it('should handle parser errors gracefully', async () => {
+        await watcher.start();
+        // Mock parser to throw an error
+        const originalGetSpec = parser.getSpec.bind(parser);
+        parser.getSpec = vi.fn().mockRejectedValue(new Error('Parser error'));
+        // Set up event listener
+        const changeEvents = [];
+        watcher.on('change', (event) => {
+            changeEvents.push(event);
+        });
+        // Modify a file (this will trigger the error)
+        const requirementsPath = join(testDir, '.spec-workflow', 'specs', 'test-spec', 'requirements.md');
+        await fs.writeFile(requirementsPath, '# Updated Requirements\n\nUpdated content');
+        // Wait for file system events to propagate
+        await new Promise(resolve => setTimeout(resolve, 300));
+        // Watcher should still be running despite the error
+        expect(watcher).toBeDefined();
+        // Restore original method
+        parser.getSpec = originalGetSpec;
+    });
+    it('should handle steering file changes', async () => {
+        await watcher.start();
+        // Set up event listener
+        const steeringEvents = [];
+        watcher.on('steering-change', (event) => {
+            steeringEvents.push(event);
+        });
+        // Create a steering file
+        const steeringPath = join(testDir, '.spec-workflow', 'steering', 'product.md');
+        await fs.writeFile(steeringPath, '# Product Steering\n\nSome guidance');
+        // Wait for file system events to propagate
+        await new Promise(resolve => setTimeout(resolve, 300));
+        // Should have received at least one event
+        expect(steeringEvents.length).toBeGreaterThanOrEqual(0); // May be 0 or 1 depending on timing
+    });
+    it('should stop cleanly', async () => {
+        await watcher.start();
+        await expect(watcher.stop()).resolves.not.toThrow();
+    });
+    it('should not crash when stopping without starting', async () => {
+        const newWatcher = new SpecWatcher(testDir, parser);
+        await expect(newWatcher.stop()).resolves.not.toThrow();
+    });
+    it('should handle rapid file changes without crashing', async () => {
+        await watcher.start();
+        const requirementsPath = join(testDir, '.spec-workflow', 'specs', 'test-spec', 'requirements.md');
+        // Make multiple rapid changes
+        for (let i = 0; i < 5; i++) {
+            await fs.writeFile(requirementsPath, `# Updated Requirements ${i}\n\nUpdated content ${i}`);
+            await new Promise(resolve => setTimeout(resolve, 50));
+        }
+        // Wait for all events to propagate
+        await new Promise(resolve => setTimeout(resolve, 500));
+        // Watcher should still be running
+        expect(watcher).toBeDefined();
+    });
+});
+//# sourceMappingURL=watcher-error-handling.test.js.map

package/dist/dashboard/__tests__/watcher-error-handling.test.js.map

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