@lbruton/spec-workflow-mcp 2.2.4

package/dist/core/task-validator.js

@@ -0,0 +1,236 @@
+/**
+ * Task Validator Module
+ * Validates tasks.md format compliance before approval
+ */
+/**
+ * Validate tasks.md content against required format
+ * @param content The markdown content to validate
+ * @returns ValidationResult with errors, warnings, and summary
+ */
+export function validateTasksMarkdown(content) {
+    const lines = content.split('\n');
+    const errors = [];
+    const warnings = [];
+    let taskCount = 0;
+    let validTaskCount = 0;
+    // Find all checkbox lines and their ranges (including malformed ones with asterisks)
+    const checkboxIndices = [];
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].match(/^\s*[-*]\s*\[/)) {
+            checkboxIndices.push(i);
+        }
+    }
+    // Process each checkbox task
+    for (let idx = 0; idx < checkboxIndices.length; idx++) {
+        const lineIndex = checkboxIndices[idx];
+        const endLine = idx < checkboxIndices.length - 1 ? checkboxIndices[idx + 1] : lines.length;
+        const line = lines[lineIndex];
+        const lineNum = lineIndex + 1; // 1-based for user-friendly messages
+        taskCount++;
+        let taskValid = true;
+        let taskId;
+        // 1. Validate checkbox format: must be "- [ ]", "- [-]", or "- [x]"
+        const checkboxMatch = line.match(/^\s*-\s+\[([ x\-])\]\s+(.+)/);
+        if (!checkboxMatch) {
+            // Check for common malformed patterns
+            const malformedPatterns = [
+                { pattern: /^\s*-\s*\[\]\s/, message: 'Empty checkbox brackets', suggestion: 'Use "- [ ]" with a space inside brackets' },
+                { pattern: /^\s*-\s*\[([^x \-])\]/, message: 'Invalid checkbox character', suggestion: 'Use space for pending, x for completed, - for in-progress' },
+                { pattern: /^\s*-\[\s*[x \-]?\s*\]/, message: 'Missing space after hyphen', suggestion: 'Use "- [ ]" with space between - and [' },
+                { pattern: /^\s*\*\s+\[/, message: 'Wrong bullet character', suggestion: 'Use hyphen (-) instead of asterisk (*)' },
+            ];
+            let foundMalformed = false;
+            for (const { pattern, message, suggestion } of malformedPatterns) {
+                if (line.match(pattern)) {
+                    errors.push({
+                        line: lineNum,
+                        field: 'checkbox',
+                        message,
+                        suggestion,
+                        severity: 'error'
+                    });
+                    foundMalformed = true;
+                    taskValid = false;
+                    break;
+                }
+            }
+            if (!foundMalformed) {
+                errors.push({
+                    line: lineNum,
+                    field: 'checkbox',
+                    message: 'Invalid checkbox format',
+                    suggestion: 'Expected format: "- [ ] 1. Task description"',
+                    severity: 'error'
+                });
+                taskValid = false;
+            }
+            continue;
+        }
+        const statusChar = checkboxMatch[1];
+        const taskText = checkboxMatch[2];
+        // 2. Validate task ID: must have numeric ID like "1.", "1.1", "2.3"
+        const taskIdMatch = taskText.match(/^(\d+(?:\.\d+)*)\s*\.?\s+(.+)/);
+        if (!taskIdMatch) {
+            errors.push({
+                line: lineNum,
+                field: 'taskId',
+                message: 'Missing task ID number',
+                suggestion: 'Add numeric ID like "1." or "1.1" after checkbox',
+                severity: 'error'
+            });
+            taskValid = false;
+        }
+        else {
+            taskId = taskIdMatch[1];
+        }
+        // 3. Validate metadata in following lines
+        let hasRequirements = false;
+        let hasLeverage = false;
+        let hasPrompt = false;
+        let hasFiles = false;
+        let promptHasClosingUnderscore = false;
+        let promptSections = [];
+        for (let lineIdx = lineIndex + 1; lineIdx < endLine; lineIdx++) {
+            const contentLine = lines[lineIdx];
+            const trimmedLine = contentLine.trim();
+            if (!trimmedLine)
+                continue;
+            // Check for _Requirements:_ format
+            if (trimmedLine.includes('Requirements:')) {
+                hasRequirements = true;
+                // Check for proper underscore delimiters
+                if (!trimmedLine.match(/_Requirements:\s*[^_]+_/)) {
+                    if (trimmedLine.match(/Requirements:\s*\S/) && !trimmedLine.includes('_Requirements:')) {
+                        warnings.push({
+                            line: lineIdx + 1,
+                            taskId,
+                            field: 'requirements',
+                            message: 'Requirements field missing underscore delimiters',
+                            suggestion: 'Use "_Requirements: ..._" format for proper parsing',
+                            severity: 'warning'
+                        });
+                    }
+                }
+            }
+            // Check for _Leverage:_ format
+            if (trimmedLine.includes('Leverage:')) {
+                hasLeverage = true;
+                // Check for proper underscore delimiters
+                if (!trimmedLine.match(/_Leverage:\s*[^_]+_/)) {
+                    if (trimmedLine.match(/Leverage:\s*\S/) && !trimmedLine.includes('_Leverage:')) {
+                        warnings.push({
+                            line: lineIdx + 1,
+                            taskId,
+                            field: 'leverage',
+                            message: 'Leverage field missing underscore delimiters',
+                            suggestion: 'Use "_Leverage: ..._" format for proper parsing',
+                            severity: 'warning'
+                        });
+                    }
+                }
+            }
+            // Check for Files: field
+            if (trimmedLine.match(/Files?:/i)) {
+                hasFiles = true;
+            }
+            // Check for _Prompt:_ format
+            if (trimmedLine.includes('_Prompt:')) {
+                hasPrompt = true;
+                // Check for closing underscore
+                if (trimmedLine.match(/_Prompt:\s*.+_$/)) {
+                    promptHasClosingUnderscore = true;
+                }
+                else {
+                    // Check if prompt continues on multiple lines - look for closing underscore
+                    let foundClosing = false;
+                    for (let j = lineIdx; j < endLine; j++) {
+                        if (lines[j].trim().endsWith('_') && !lines[j].trim().match(/^_[A-Z]/)) {
+                            foundClosing = true;
+                            break;
+                        }
+                    }
+                    promptHasClosingUnderscore = foundClosing;
+                }
+                // Extract prompt content and check structure
+                const promptContent = trimmedLine.replace(/_Prompt:\s*/, '').replace(/_$/, '');
+                // Check for required prompt sections: Role, Task, Restrictions, Success
+                const requiredSections = ['Role', 'Task', 'Restrictions', 'Success'];
+                for (const section of requiredSections) {
+                    if (promptContent.toLowerCase().includes(section.toLowerCase() + ':')) {
+                        promptSections.push(section);
+                    }
+                }
+            }
+        }
+        // Validate prompt requirements
+        if (hasPrompt) {
+            if (!promptHasClosingUnderscore) {
+                warnings.push({
+                    line: lineNum,
+                    taskId,
+                    field: 'prompt',
+                    message: 'Prompt field may be missing closing underscore',
+                    suggestion: 'Ensure _Prompt: ..._ ends with underscore',
+                    severity: 'warning'
+                });
+            }
+            // Check for missing prompt sections
+            const requiredSections = ['Role', 'Task', 'Restrictions', 'Success'];
+            const missingSections = requiredSections.filter(s => !promptSections.includes(s));
+            if (missingSections.length > 0) {
+                warnings.push({
+                    line: lineNum,
+                    taskId,
+                    field: 'prompt_structure',
+                    message: `Prompt missing sections: ${missingSections.join(', ')}`,
+                    suggestion: 'Format: Role: ... | Task: ... | Restrictions: ... | Success: ...',
+                    severity: 'warning'
+                });
+            }
+        }
+        // Track if task is valid (only errors affect validity, not warnings)
+        if (taskValid) {
+            validTaskCount++;
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        summary: {
+            totalTasks: taskCount,
+            validTasks: validTaskCount,
+            invalidTasks: taskCount - validTaskCount
+        }
+    };
+}
+/**
+ * Format validation errors for display
+ * @param result The validation result
+ * @returns Formatted string array of errors and warnings
+ */
+export function formatValidationErrors(result) {
+    const messages = [];
+    if (result.errors.length > 0) {
+        messages.push(`Found ${result.errors.length} error(s):`);
+        for (const error of result.errors) {
+            const taskInfo = error.taskId ? ` (Task ${error.taskId})` : '';
+            messages.push(`  Line ${error.line}${taskInfo}: ${error.message}`);
+            if (error.suggestion) {
+                messages.push(`    Suggestion: ${error.suggestion}`);
+            }
+        }
+    }
+    if (result.warnings.length > 0) {
+        messages.push(`Found ${result.warnings.length} warning(s):`);
+        for (const warning of result.warnings) {
+            const taskInfo = warning.taskId ? ` (Task ${warning.taskId})` : '';
+            messages.push(`  Line ${warning.line}${taskInfo}: ${warning.message}`);
+            if (warning.suggestion) {
+                messages.push(`    Suggestion: ${warning.suggestion}`);
+            }
+        }
+    }
+    return messages;
+}
+//# sourceMappingURL=task-validator.js.map

package/dist/core/task-validator.js.map

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

package/dist/core/workspace-initializer.d.ts

@@ -0,0 +1,16 @@
+export declare class WorkspaceInitializer {
+    private projectPath;
+    private version;
+    constructor(projectPath: string, version: string);
+    initializeWorkspace(): Promise<void>;
+    private initializeDirectories;
+    private initializeTemplates;
+    private copyTemplate;
+    private createUserTemplatesReadme;
+    /**
+     * Migrate implementation logs from JSON to Markdown format
+     * Runs on server startup to handle automatic migration for existing specs
+     */
+    private migrateImplementationLogs;
+}
+//# sourceMappingURL=workspace-initializer.d.ts.map

package/dist/core/workspace-initializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-initializer.d.ts","sourceRoot":"","sources":["../../src/core/workspace-initializer.ts"],"names":[],"mappings":"AASA,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;gBAEZ,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAK1C,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;YAc5B,qBAAqB;YAkBrB,mBAAmB;YAiBnB,YAAY;YAkBZ,yBAAyB;IA8EvC;;;OAGG;YACW,yBAAyB;CAgBxC"}

package/dist/core/workspace-initializer.js

@@ -0,0 +1,165 @@
+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'
+        ];
+        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',
+            '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
+   - \`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,69 @@
+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('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,116 @@
+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('uses absolute approval filePath as-is', 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
+        });
+        const approvalId = await approvalStorage.createApproval('Review absolute path', absolutePath, '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('absolute-file-content');
+        expect(body.filePath).toBe(absolutePath);
+    });
+});
+//# sourceMappingURL=multi-server-approvals-content.test.js.map