@arimakouyou/spec-workflow-mcp 2.2.7

package/dist/core/implementation-log-migrator.js

@@ -0,0 +1,258 @@
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { appendFileSync, existsSync } from 'fs';
+/**
+ * Migrates implementation logs from JSON format to individual markdown files
+ * This utility class handles the automatic migration when the MCP server starts
+ */
+export class ImplementationLogMigrator {
+    migrationLogPath;
+    constructor(userDataDir) {
+        this.migrationLogPath = join(userDataDir, 'migration.log');
+    }
+    /**
+     * Log migration events
+     */
+    log(message) {
+        const timestamp = new Date().toISOString();
+        const logMessage = `[${timestamp}] ${message}\n`;
+        appendFileSync(this.migrationLogPath, logMessage, 'utf-8');
+    }
+    /**
+     * Sanitize taskId for use in filenames (e.g., "1.2" → "1-2")
+     */
+    sanitizeTaskId(taskId) {
+        return taskId.replace(/[/.]/g, '-');
+    }
+    /**
+     * Generate markdown filename for a log entry
+     */
+    generateFileName(entry) {
+        const sanitizedTaskId = this.sanitizeTaskId(entry.taskId);
+        const dateObj = new Date(entry.timestamp);
+        const timestamp = dateObj.toISOString().replace(/[:.]/g, '').split('T')[0] +
+            dateObj.toISOString().split('T')[1].replace(/[:.Z]/g, '').substring(0, 6);
+        const idPrefix = entry.id.substring(0, 8);
+        return `task-${sanitizedTaskId}_${timestamp}_${idPrefix}.md`;
+    }
+    /**
+     * Convert an implementation log entry to markdown format
+     */
+    entryToMarkdown(entry) {
+        let markdown = `# Implementation Log: Task ${entry.taskId}\n\n`;
+        markdown += `**Summary:** ${entry.summary}\n\n`;
+        markdown += `**Timestamp:** ${entry.timestamp}\n`;
+        markdown += `**Log ID:** ${entry.id}\n\n`;
+        markdown += `---\n\n`;
+        // Statistics
+        markdown += `## Statistics\n\n`;
+        markdown += `- **Lines Added:** +${entry.statistics.linesAdded}\n`;
+        markdown += `- **Lines Removed:** -${entry.statistics.linesRemoved}\n`;
+        markdown += `- **Files Changed:** ${entry.statistics.filesChanged}\n`;
+        markdown += `- **Net Change:** ${entry.statistics.linesAdded - entry.statistics.linesRemoved}\n\n`;
+        // Files
+        markdown += `## Files Modified\n`;
+        if (entry.filesModified.length > 0) {
+            entry.filesModified.forEach(file => {
+                markdown += `- ${file}\n`;
+            });
+        }
+        else {
+            markdown += `_No files modified_\n`;
+        }
+        markdown += `\n`;
+        markdown += `## Files Created\n`;
+        if (entry.filesCreated.length > 0) {
+            entry.filesCreated.forEach(file => {
+                markdown += `- ${file}\n`;
+            });
+        }
+        else {
+            markdown += `_No files created_\n`;
+        }
+        markdown += `\n`;
+        // Artifacts
+        markdown += `---\n\n## Artifacts\n\n`;
+        if (!entry.artifacts || Object.keys(entry.artifacts).every(key => !entry.artifacts[key]?.length)) {
+            markdown += `_No artifacts recorded_\n`;
+            return markdown;
+        }
+        // API Endpoints
+        if (entry.artifacts.apiEndpoints && entry.artifacts.apiEndpoints.length > 0) {
+            markdown += `### API Endpoints\n\n`;
+            entry.artifacts.apiEndpoints.forEach(api => {
+                markdown += `#### ${api.method} ${api.path}\n`;
+                markdown += `- **Purpose:** ${api.purpose}\n`;
+                markdown += `- **Location:** ${api.location}\n`;
+                if (api.requestFormat)
+                    markdown += `- **Request Format:** ${api.requestFormat}\n`;
+                if (api.responseFormat)
+                    markdown += `- **Response Format:** ${api.responseFormat}\n`;
+                markdown += `\n`;
+            });
+        }
+        // Components
+        if (entry.artifacts.components && entry.artifacts.components.length > 0) {
+            markdown += `### Components\n\n`;
+            entry.artifacts.components.forEach(comp => {
+                markdown += `#### ${comp.name}\n`;
+                markdown += `- **Type:** ${comp.type}\n`;
+                markdown += `- **Purpose:** ${comp.purpose}\n`;
+                markdown += `- **Location:** ${comp.location}\n`;
+                if (comp.props)
+                    markdown += `- **Props:** ${comp.props}\n`;
+                if (comp.exports && comp.exports.length > 0)
+                    markdown += `- **Exports:** ${comp.exports.join(', ')}\n`;
+                markdown += `\n`;
+            });
+        }
+        // Functions
+        if (entry.artifacts.functions && entry.artifacts.functions.length > 0) {
+            markdown += `### Functions\n\n`;
+            entry.artifacts.functions.forEach(func => {
+                markdown += `#### ${func.name}\n`;
+                markdown += `- **Purpose:** ${func.purpose}\n`;
+                markdown += `- **Location:** ${func.location}\n`;
+                if (func.signature)
+                    markdown += `- **Signature:** ${func.signature}\n`;
+                markdown += `- **Exported:** ${func.isExported ? 'Yes' : 'No'}\n`;
+                markdown += `\n`;
+            });
+        }
+        // Classes
+        if (entry.artifacts.classes && entry.artifacts.classes.length > 0) {
+            markdown += `### Classes\n\n`;
+            entry.artifacts.classes.forEach(cls => {
+                markdown += `#### ${cls.name}\n`;
+                markdown += `- **Purpose:** ${cls.purpose}\n`;
+                markdown += `- **Location:** ${cls.location}\n`;
+                if (cls.methods && cls.methods.length > 0)
+                    markdown += `- **Methods:** ${cls.methods.join(', ')}\n`;
+                markdown += `- **Exported:** ${cls.isExported ? 'Yes' : 'No'}\n`;
+                markdown += `\n`;
+            });
+        }
+        // Integrations
+        if (entry.artifacts.integrations && entry.artifacts.integrations.length > 0) {
+            markdown += `### Integrations\n\n`;
+            entry.artifacts.integrations.forEach(intg => {
+                markdown += `#### Integration\n`;
+                markdown += `- **Description:** ${intg.description}\n`;
+                markdown += `- **Frontend Component:** ${intg.frontendComponent}\n`;
+                markdown += `- **Backend Endpoint:** ${intg.backendEndpoint}\n`;
+                markdown += `- **Data Flow:** ${intg.dataFlow}\n`;
+                markdown += `\n`;
+            });
+        }
+        return markdown;
+    }
+    /**
+     * Migrate a single JSON file to markdown files
+     */
+    async migrateJsonFile(jsonPath, outputDir) {
+        try {
+            // Read the JSON file
+            const content = await fs.readFile(jsonPath, 'utf-8');
+            const log = JSON.parse(content);
+            // Ensure output directory exists
+            await fs.mkdir(outputDir, { recursive: true });
+            // Convert each entry to a markdown file
+            let count = 0;
+            for (const entry of log.entries) {
+                const fileName = this.generateFileName(entry);
+                const filePath = join(outputDir, fileName);
+                const markdown = this.entryToMarkdown(entry);
+                await fs.writeFile(filePath, markdown, 'utf-8');
+                count++;
+            }
+            this.log(`✓ Migrated ${count} entries from ${jsonPath} to ${outputDir}`);
+            return { success: true, count };
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            this.log(`✗ Failed to migrate ${jsonPath}: ${errorMsg}`);
+            return { success: false, count: 0, error: errorMsg };
+        }
+    }
+    /**
+     * Scan all specs and migrate their implementation logs
+     */
+    async migrateAllSpecs(specsDir) {
+        this.log('='.repeat(80));
+        this.log('Starting implementation logs migration from JSON to Markdown format');
+        this.log(`Specs directory: ${specsDir}`);
+        this.log('='.repeat(80));
+        const result = {
+            totalSpecs: 0,
+            migratedSpecs: 0,
+            totalEntries: 0,
+            errors: []
+        };
+        try {
+            // Check if specs directory exists
+            if (!existsSync(specsDir)) {
+                this.log('Specs directory does not exist. Skipping migration.');
+                return result;
+            }
+            // List all spec directories
+            const entries = await fs.readdir(specsDir, { withFileTypes: true });
+            const specDirs = entries.filter(e => e.isDirectory());
+            result.totalSpecs = specDirs.length;
+            // Process each spec
+            for (const specDir of specDirs) {
+                const specPath = join(specsDir, specDir.name);
+                const jsonPath = join(specPath, 'implementation-log.json');
+                const outputDir = join(specPath, 'Implementation Logs');
+                // Check if JSON file exists
+                if (!existsSync(jsonPath)) {
+                    this.log(`⊘ Spec "${specDir.name}": No implementation-log.json found. Skipping.`);
+                    continue;
+                }
+                // Migrate this spec's JSON file
+                const migrationResult = await this.migrateJsonFile(jsonPath, outputDir);
+                if (migrationResult.success) {
+                    result.migratedSpecs++;
+                    result.totalEntries += migrationResult.count;
+                    // Delete the JSON file after successful migration
+                    try {
+                        await fs.unlink(jsonPath);
+                        this.log(`→ Deleted original JSON file: ${jsonPath}`);
+                    }
+                    catch (error) {
+                        this.log(`⚠ Warning: Could not delete ${jsonPath}: ${error.message}`);
+                    }
+                }
+                else {
+                    result.errors.push({
+                        spec: specDir.name,
+                        error: migrationResult.error || 'Unknown error'
+                    });
+                }
+            }
+            // Summary
+            this.log('='.repeat(80));
+            this.log(`Migration Summary:`);
+            this.log(`  Total specs found: ${result.totalSpecs}`);
+            this.log(`  Successfully migrated: ${result.migratedSpecs}`);
+            this.log(`  Total entries migrated: ${result.totalEntries}`);
+            this.log(`  Errors: ${result.errors.length}`);
+            if (result.errors.length > 0) {
+                this.log('Errors encountered:');
+                result.errors.forEach(err => {
+                    this.log(`  - ${err.spec}: ${err.error}`);
+                });
+            }
+            this.log('='.repeat(80));
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            this.log(`Fatal error during migration: ${errorMsg}`);
+            result.errors.push({
+                spec: 'migration-process',
+                error: errorMsg
+            });
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=implementation-log-migrator.js.map

package/dist/core/implementation-log-migrator.js.map

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

package/dist/core/mdx-validator.d.ts

@@ -0,0 +1,14 @@
+export interface MdxValidationIssue {
+    line: number;
+    column: number;
+    ruleId: 'mdx-compile-error';
+    message: string;
+    severity: 'error';
+}
+export interface MdxValidationResult {
+    valid: boolean;
+    issues: MdxValidationIssue[];
+}
+export declare function validateMarkdownForMdx(content: string): Promise<MdxValidationResult>;
+export declare function formatMdxValidationIssues(issues: MdxValidationIssue[]): string[];
+//# sourceMappingURL=mdx-validator.d.ts.map

package/dist/core/mdx-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdx-validator.d.ts","sourceRoot":"","sources":["../../src/core/mdx-validator.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAYD,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAmB1F;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,EAAE,CAEhF"}

package/dist/core/mdx-validator.js

@@ -0,0 +1,34 @@
+import { compile } from '@mdx-js/mdx';
+function getIssueLocation(error) {
+    const line = error?.line ?? error?.position?.start?.line ?? 1;
+    const column = error?.column ?? error?.position?.start?.column ?? 1;
+    return { line, column };
+}
+function getIssueMessage(error) {
+    return error?.reason ?? error?.message ?? 'Unknown MDX compile error';
+}
+export async function validateMarkdownForMdx(content) {
+    try {
+        await compile(content, { format: 'mdx' });
+        return { valid: true, issues: [] };
+    }
+    catch (error) {
+        const { line, column } = getIssueLocation(error);
+        return {
+            valid: false,
+            issues: [
+                {
+                    line,
+                    column,
+                    ruleId: 'mdx-compile-error',
+                    message: getIssueMessage(error),
+                    severity: 'error',
+                },
+            ],
+        };
+    }
+}
+export function formatMdxValidationIssues(issues) {
+    return issues.map((issue) => `Line ${issue.line}:${issue.column} [${issue.ruleId}] ${issue.message}`);
+}
+//# sourceMappingURL=mdx-validator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mdx-validator.js","sourceRoot":"","sources":["../../src/core/mdx-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAetC,SAAS,gBAAgB,CAAC,KAAU;IAClC,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,IAAI,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,KAAK,EAAE,MAAM,IAAI,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC;IACpE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,eAAe,CAAC,KAAU;IACjC,OAAO,KAAK,EAAE,MAAM,IAAI,KAAK,EAAE,OAAO,IAAI,2BAA2B,CAAC;AACxE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,OAAe;IAC1D,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACjD,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE;gBACN;oBACE,IAAI;oBACJ,MAAM;oBACN,MAAM,EAAE,mBAAmB;oBAC3B,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC;oBAC/B,QAAQ,EAAE,OAAO;iBAClB;aACF;SACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAA4B;IACpE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;AACxG,CAAC"}

package/dist/core/parser.d.ts

@@ -0,0 +1,11 @@
+import { SpecData, SteeringStatus } from '../types.js';
+export declare class SpecParser {
+    private projectPath;
+    constructor(projectPath: string);
+    getAllSpecs(): Promise<SpecData[]>;
+    getSpec(name: string): Promise<SpecData | null>;
+    getProjectSteeringStatus(): Promise<SteeringStatus>;
+    private getPhaseStatus;
+    private fileExists;
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/core/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/core/parser.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAe,MAAM,aAAa,CAAC;AAGpE,qBAAa,UAAU;IACT,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,MAAM;IAEjC,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAuBlC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IA+C/C,wBAAwB,IAAI,OAAO,CAAC,cAAc,CAAC;YA+B3C,cAAc;YAoBd,UAAU;CAQzB"}

package/dist/core/parser.js

@@ -0,0 +1,128 @@
+import { readdir, readFile, stat } from 'fs/promises';
+import { join } from 'path';
+import { PathUtils } from './path-utils.js';
+import { parseTaskProgress } from './task-parser.js';
+export class SpecParser {
+    projectPath;
+    constructor(projectPath) {
+        this.projectPath = projectPath;
+    }
+    async getAllSpecs() {
+        const specs = [];
+        const specsPath = PathUtils.getSpecPath(this.projectPath, '');
+        try {
+            const entries = await readdir(specsPath, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory()) {
+                    const spec = await this.getSpec(entry.name);
+                    if (spec) {
+                        specs.push(spec);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            // Directory doesn't exist yet
+            return [];
+        }
+        return specs;
+    }
+    async getSpec(name) {
+        const specPath = PathUtils.getSpecPath(this.projectPath, name);
+        try {
+            const stats = await stat(specPath);
+            if (!stats.isDirectory()) {
+                return null;
+            }
+            // Read all phase files
+            const requirements = await this.getPhaseStatus(specPath, 'requirements.md');
+            const design = await this.getPhaseStatus(specPath, 'design.md');
+            const testDesign = await this.getPhaseStatus(specPath, 'test-design.md');
+            const tasks = await this.getPhaseStatus(specPath, 'tasks.md');
+            // Parse task progress using unified parser
+            let taskProgress = undefined;
+            if (tasks.exists) {
+                try {
+                    const tasksContent = await readFile(join(specPath, 'tasks.md'), 'utf-8');
+                    taskProgress = parseTaskProgress(tasksContent);
+                }
+                catch {
+                    // Error reading tasks file
+                }
+            }
+            return {
+                name,
+                createdAt: stats.birthtime.toISOString(),
+                lastModified: stats.mtime.toISOString(),
+                phases: {
+                    requirements,
+                    design,
+                    testDesign,
+                    tasks,
+                    implementation: {
+                        exists: taskProgress ? taskProgress.completed > 0 : false
+                    }
+                },
+                taskProgress
+            };
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    async getProjectSteeringStatus() {
+        const steeringPath = PathUtils.getSteeringPath(this.projectPath);
+        try {
+            const stats = await stat(steeringPath);
+            const productExists = await this.fileExists(join(steeringPath, 'product.md'));
+            const techExists = await this.fileExists(join(steeringPath, 'tech.md'));
+            const structureExists = await this.fileExists(join(steeringPath, 'structure.md'));
+            return {
+                exists: stats.isDirectory(),
+                documents: {
+                    product: productExists,
+                    tech: techExists,
+                    structure: structureExists
+                },
+                lastModified: stats.mtime.toISOString()
+            };
+        }
+        catch (error) {
+            return {
+                exists: false,
+                documents: {
+                    product: false,
+                    tech: false,
+                    structure: false
+                }
+            };
+        }
+    }
+    async getPhaseStatus(basePath, filename) {
+        const filePath = join(basePath, filename);
+        try {
+            const stats = await stat(filePath);
+            const content = await readFile(filePath, 'utf-8');
+            return {
+                exists: true,
+                lastModified: stats.mtime.toISOString(),
+                content
+            };
+        }
+        catch (error) {
+            return {
+                exists: false
+            };
+        }
+    }
+    async fileExists(filePath) {
+        try {
+            await stat(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/core/parser.js.map

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

package/dist/core/path-utils.d.ts

@@ -0,0 +1,68 @@
+export declare class PathUtils {
+    /** macOS and Windows are case-insensitive filesystems */
+    private static readonly IS_CASE_INSENSITIVE;
+    /** Cached path configuration (undefined = not checked, null = invalid/missing) */
+    private static pathConfig;
+    /**
+     * Get cached path configuration from environment variables.
+     * Caches result to prevent race conditions from env var changes mid-operation.
+     */
+    private static getPathConfig;
+    /** Check if path is absolute (Unix or Windows style) */
+    private static isAbsolutePath;
+    /** Reset cached config (for testing) */
+    static resetPathConfig(): void;
+    /**
+     * Normalize path for cross-platform comparison using built-in path.posix.
+     * Converts backslashes to forward slashes, removes trailing slashes.
+     */
+    private static normalizeForComparison;
+    /**
+     * Check if a path matches a prefix with proper boundary checking.
+     * - Prevents partial matches like "/Users/dev" matching "/Users/developer"
+     * - Handles case-insensitivity on macOS/Windows
+     * - Normalizes path separators for cross-platform support
+     */
+    private static pathMatchesPrefix;
+    /**
+     * Translate a host path to container path if running in Docker with path mapping configured.
+     *
+     * Environment variables:
+     * - SPEC_WORKFLOW_HOST_PATH_PREFIX: Path prefix on the host (e.g., /Users/username)
+     * - SPEC_WORKFLOW_CONTAINER_PATH_PREFIX: Corresponding path in container (e.g., /projects)
+     *
+     * Example: If host prefix is "/Users/dev" and container prefix is "/projects",
+     * then "/Users/dev/myapp" becomes "/projects/myapp"
+     */
+    static translatePath(hostPath: string): string;
+    /**
+     * Reverse translation: container path back to host path (for display/registry)
+     */
+    static reverseTranslatePath(containerPath: string): string;
+    /**
+     * Validate that a resolved absolute path is within at least one of the given base directories.
+     * Throws if the path escapes all bases.
+     */
+    static validatePathWithinBases(resolvedPath: string, basePaths: string[]): void;
+    /**
+     * Safely join paths ensuring no directory traversal
+     */
+    static safeJoin(basePath: string, ...paths: string[]): string;
+    static getWorkflowRoot(projectPath: string): string;
+    static getSpecPath(projectPath: string, specName: string): string;
+    static getArchiveSpecPath(projectPath: string, specName: string): string;
+    static getArchiveSpecsPath(projectPath: string): string;
+    static getSteeringPath(projectPath: string): string;
+    static getTemplatesPath(projectPath: string): string;
+    static getAgentsPath(projectPath: string): string;
+    static getCommandsPath(projectPath: string): string;
+    static getApprovalsPath(projectPath: string): string;
+    static getSpecApprovalPath(projectPath: string, specName: string): string;
+    static toPlatformPath(path: string): string;
+    static toUnixPath(path: string): string;
+    static getRelativePath(projectPath: string, fullPath: string): string;
+}
+export declare function validateProjectPath(projectPath: string): Promise<string>;
+export declare function ensureDirectoryExists(dirPath: string): Promise<void>;
+export declare function ensureWorkflowDirectory(projectPath: string): Promise<string>;
+//# sourceMappingURL=path-utils.d.ts.map

package/dist/core/path-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../../src/core/path-utils.ts"],"names":[],"mappings":"AAIA,qBAAa,SAAS;IACpB,yDAAyD;IACzD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CACqB;IAEhE,kFAAkF;IAClF,OAAO,CAAC,MAAM,CAAC,UAAU,CAAqE;IAE9F;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IA+B5B,wDAAwD;IACxD,OAAO,CAAC,MAAM,CAAC,cAAc;IAI7B,wCAAwC;IACxC,MAAM,CAAC,eAAe,IAAI,IAAI;IAI9B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAWrC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAmBhC;;;;;;;;;OASG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IA2B9C;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IA2B1D;;;OAGG;IACH,MAAM,CAAC,uBAAuB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAW/E;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;IAyB7D,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAInD,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIjE,MAAM,CAAC,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIxE,MAAM,CAAC,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAIvD,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAKnD,MAAM,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAIpD,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAIjD,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAInD,MAAM,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAIpD,MAAM,CAAC,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAMzE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI3C,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKvC,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;CAUtE;AAED,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4D9E;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM1E;AAED,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBlF"}