@arimakouyou/spec-workflow-mcp 2.2.7

package/dist/core/path-utils.js

@@ -0,0 +1,302 @@
+import { join, normalize, sep, resolve, posix } from 'path';
+import { access, stat, mkdir } from 'fs/promises';
+import { constants } from 'fs';
+export class PathUtils {
+    /** macOS and Windows are case-insensitive filesystems */
+    static IS_CASE_INSENSITIVE = process.platform === 'darwin' || process.platform === 'win32';
+    /** Cached path configuration (undefined = not checked, null = invalid/missing) */
+    static pathConfig;
+    /**
+     * Get cached path configuration from environment variables.
+     * Caches result to prevent race conditions from env var changes mid-operation.
+     */
+    static getPathConfig() {
+        if (this.pathConfig !== undefined) {
+            return this.pathConfig;
+        }
+        const hostPrefix = process.env.SPEC_WORKFLOW_HOST_PATH_PREFIX?.trim();
+        const containerPrefix = process.env.SPEC_WORKFLOW_CONTAINER_PATH_PREFIX?.trim();
+        if (!hostPrefix || !containerPrefix) {
+            this.pathConfig = null;
+            return null;
+        }
+        // Validate absolute paths
+        if (!this.isAbsolutePath(hostPrefix) || !this.isAbsolutePath(containerPrefix)) {
+            console.error('[PathUtils] Path prefixes must be absolute paths');
+            this.pathConfig = null;
+            return null;
+        }
+        // Security: Reject prefixes containing directory traversal
+        if (hostPrefix.includes('..') || containerPrefix.includes('..')) {
+            console.error('[PathUtils] Path prefixes must not contain directory traversal (..)');
+            this.pathConfig = null;
+            return null;
+        }
+        this.pathConfig = { hostPrefix, containerPrefix };
+        return this.pathConfig;
+    }
+    /** Check if path is absolute (Unix or Windows style) */
+    static isAbsolutePath(path) {
+        return path.startsWith('/') || /^[A-Za-z]:[\\/]/.test(path);
+    }
+    /** Reset cached config (for testing) */
+    static resetPathConfig() {
+        this.pathConfig = undefined;
+    }
+    /**
+     * Normalize path for cross-platform comparison using built-in path.posix.
+     * Converts backslashes to forward slashes, removes trailing slashes.
+     */
+    static normalizeForComparison(p) {
+        // Convert to Unix-style, then use built-in posix.normalize
+        const unixStyle = p.replace(/\\/g, '/');
+        // posix.normalize handles /./, /../, and // but keeps trailing slash
+        const normalized = posix.normalize(unixStyle);
+        // Remove trailing slash for consistent comparison (except for root "/")
+        return normalized.endsWith('/') && normalized.length > 1
+            ? normalized.slice(0, -1)
+            : normalized;
+    }
+    /**
+     * 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
+     */
+    static pathMatchesPrefix(path, prefix) {
+        let normalizedPath = this.normalizeForComparison(path);
+        let normalizedPrefix = this.normalizeForComparison(prefix);
+        if (this.IS_CASE_INSENSITIVE) {
+            normalizedPath = normalizedPath.toLowerCase();
+            normalizedPrefix = normalizedPrefix.toLowerCase();
+        }
+        if (normalizedPath === normalizedPrefix)
+            return true;
+        // Special case: root prefix "/" matches any absolute path
+        if (normalizedPrefix === '/') {
+            return normalizedPath.startsWith('/');
+        }
+        return normalizedPath.startsWith(normalizedPrefix + '/');
+    }
+    /**
+     * 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) {
+        const config = this.getPathConfig();
+        if (!config)
+            return hostPath;
+        if (this.pathMatchesPrefix(hostPath, config.hostPrefix)) {
+            const normalizedHostPrefix = this.normalizeForComparison(config.hostPrefix);
+            const normalizedPath = this.normalizeForComparison(hostPath);
+            const normalizedContainerPrefix = this.normalizeForComparison(config.containerPrefix);
+            // Get relative path preserving structure
+            let relativePath = normalizedPath.substring(normalizedHostPrefix.length);
+            // Ensure relative path starts with separator (needed for root prefix case)
+            if (relativePath && !relativePath.startsWith('/')) {
+                relativePath = '/' + relativePath;
+            }
+            const result = normalizedContainerPrefix + relativePath;
+            // Security: Validate no directory traversal in result
+            if (result.includes('/../') || result.endsWith('/..')) {
+                throw new Error('Path translation resulted in directory traversal attempt');
+            }
+            return result;
+        }
+        return hostPath;
+    }
+    /**
+     * Reverse translation: container path back to host path (for display/registry)
+     */
+    static reverseTranslatePath(containerPath) {
+        const config = this.getPathConfig();
+        if (!config)
+            return containerPath;
+        if (this.pathMatchesPrefix(containerPath, config.containerPrefix)) {
+            const normalizedContainerPrefix = this.normalizeForComparison(config.containerPrefix);
+            const normalizedPath = this.normalizeForComparison(containerPath);
+            const normalizedHostPrefix = this.normalizeForComparison(config.hostPrefix);
+            // Get relative path preserving structure
+            let relativePath = normalizedPath.substring(normalizedContainerPrefix.length);
+            // Ensure relative path starts with separator (needed for root prefix case)
+            if (relativePath && !relativePath.startsWith('/')) {
+                relativePath = '/' + relativePath;
+            }
+            const result = normalizedHostPrefix + relativePath;
+            // Security: Validate no directory traversal in result
+            if (result.includes('/../') || result.endsWith('/..')) {
+                throw new Error('Path translation resulted in directory traversal attempt');
+            }
+            return result;
+        }
+        return containerPath;
+    }
+    /**
+     * 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, basePaths) {
+        const normalizedResolved = resolve(resolvedPath);
+        for (const base of basePaths) {
+            const normalizedBase = resolve(base);
+            if (normalizedResolved === normalizedBase || normalizedResolved.startsWith(normalizedBase + sep)) {
+                return;
+            }
+        }
+        throw new Error(`Path traversal detected: path escapes allowed directories`);
+    }
+    /**
+     * Safely join paths ensuring no directory traversal
+     */
+    static safeJoin(basePath, ...paths) {
+        // Validate base path
+        if (!basePath || typeof basePath !== 'string') {
+            throw new Error('Invalid base path');
+        }
+        // Check each path segment for traversal attempts
+        for (const pathSegment of paths) {
+            if (pathSegment && (pathSegment.includes('..') || pathSegment.startsWith('/'))) {
+                throw new Error(`Invalid path segment: ${pathSegment}`);
+            }
+        }
+        const joined = normalize(join(basePath, ...paths));
+        const resolvedBase = resolve(basePath);
+        const resolvedJoined = resolve(joined);
+        // Ensure the joined path is within the base path
+        if (!resolvedJoined.startsWith(resolvedBase)) {
+            throw new Error('Path traversal detected in join operation');
+        }
+        return joined;
+    }
+    static getWorkflowRoot(projectPath) {
+        return this.safeJoin(projectPath, '.spec-workflow');
+    }
+    static getSpecPath(projectPath, specName) {
+        return this.safeJoin(projectPath, '.spec-workflow', 'specs', specName);
+    }
+    static getArchiveSpecPath(projectPath, specName) {
+        return this.safeJoin(projectPath, '.spec-workflow', 'archive', 'specs', specName);
+    }
+    static getArchiveSpecsPath(projectPath) {
+        return this.safeJoin(projectPath, '.spec-workflow', 'archive', 'specs');
+    }
+    static getSteeringPath(projectPath) {
+        return this.safeJoin(projectPath, '.spec-workflow', 'steering');
+    }
+    static getTemplatesPath(projectPath) {
+        return this.safeJoin(projectPath, '.spec-workflow', 'templates');
+    }
+    static getAgentsPath(projectPath) {
+        return this.safeJoin(projectPath, '.spec-workflow', 'agents');
+    }
+    static getCommandsPath(projectPath) {
+        return this.safeJoin(projectPath, '.spec-workflow', 'commands');
+    }
+    static getApprovalsPath(projectPath) {
+        return this.safeJoin(projectPath, '.spec-workflow', 'approvals');
+    }
+    static getSpecApprovalPath(projectPath, specName) {
+        return this.safeJoin(projectPath, '.spec-workflow', 'approvals', specName);
+    }
+    // Ensure paths work across Windows, macOS, Linux
+    static toPlatformPath(path) {
+        return path.split('/').join(sep);
+    }
+    static toUnixPath(path) {
+        return path.split(sep).join('/');
+    }
+    // Get relative path from project root
+    static getRelativePath(projectPath, fullPath) {
+        const normalizedProject = normalize(projectPath);
+        const normalizedFull = normalize(fullPath);
+        if (normalizedFull.startsWith(normalizedProject)) {
+            return normalizedFull.slice(normalizedProject.length + 1);
+        }
+        return normalizedFull;
+    }
+}
+export async function validateProjectPath(projectPath) {
+    try {
+        // Validate input
+        if (!projectPath || typeof projectPath !== 'string') {
+            throw new Error('Invalid project path: path must be a non-empty string');
+        }
+        // Check for dangerous path patterns before resolving
+        if (projectPath.includes('..') || projectPath.includes('~')) {
+            // Normalize the path first to check if it's actually traversing
+            const normalized = normalize(projectPath);
+            const resolved = resolve(normalized);
+            // Get the current working directory for comparison
+            const cwd = process.cwd();
+            // Additional check: ensure the resolved path doesn't contain parent directory references
+            if (normalized.includes('..') && !resolved.startsWith(cwd)) {
+                throw new Error(`Path traversal detected: ${projectPath}`);
+            }
+        }
+        // Resolve to absolute path
+        const absolutePath = resolve(projectPath);
+        // Security check: Ensure the path doesn't escape to system directories
+        const systemPaths = ['/etc', '/usr', '/bin', '/sbin', '/var', '/sys', '/proc'];
+        const windowsSystemPaths = ['C:\\Windows', 'C:\\Program Files', 'C:\\Program Files (x86)'];
+        const allSystemPaths = process.platform === 'win32' ? windowsSystemPaths : systemPaths;
+        for (const sysPath of allSystemPaths) {
+            if (absolutePath.toLowerCase().startsWith(sysPath.toLowerCase())) {
+                throw new Error(`Access to system directory not allowed: ${absolutePath}`);
+            }
+        }
+        // Check if path exists
+        await access(absolutePath, constants.F_OK);
+        // Ensure it's a directory
+        const stats = await stat(absolutePath);
+        if (!stats.isDirectory()) {
+            throw new Error(`Project path is not a directory: ${absolutePath}`);
+        }
+        // Final security check: ensure we can actually access this directory
+        await access(absolutePath, constants.R_OK | constants.W_OK);
+        return absolutePath;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            if (error.code === 'ENOENT') {
+                throw new Error(`Project path does not exist: ${projectPath}`);
+            }
+            else if (error.code === 'EACCES') {
+                throw new Error(`Permission denied accessing project path: ${projectPath}`);
+            }
+            throw error;
+        }
+        throw new Error(`Unknown error validating project path: ${String(error)}`);
+    }
+}
+export async function ensureDirectoryExists(dirPath) {
+    try {
+        await access(dirPath, constants.F_OK);
+    }
+    catch {
+        await mkdir(dirPath, { recursive: true });
+    }
+}
+export async function ensureWorkflowDirectory(projectPath) {
+    const workflowRoot = PathUtils.getWorkflowRoot(projectPath);
+    // Create all necessary subdirectories (approvals created on-demand)
+    const directories = [
+        workflowRoot,
+        PathUtils.getSpecPath(projectPath, ''),
+        PathUtils.getArchiveSpecsPath(projectPath),
+        PathUtils.getSteeringPath(projectPath),
+        PathUtils.getTemplatesPath(projectPath),
+        PathUtils.getAgentsPath(projectPath),
+        PathUtils.getCommandsPath(projectPath)
+    ];
+    for (const dir of directories) {
+        await ensureDirectoryExists(dir);
+    }
+    return workflowRoot;
+}
+//# sourceMappingURL=path-utils.js.map

package/dist/core/path-utils.js.map

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

package/dist/core/project-registry.d.ts

@@ -0,0 +1,94 @@
+export interface ProjectInstance {
+    pid: number;
+    registeredAt: string;
+}
+export interface ProjectRegistryEntry {
+    projectId: string;
+    projectPath: string;
+    workflowRootPath: string;
+    projectName: string;
+    instances: ProjectInstance[];
+}
+export interface RegisterProjectOptions {
+    workflowRootPath?: string;
+    projectName?: string;
+}
+/**
+ * Generate a stable projectId from an absolute path
+ * Uses SHA-1 hash encoded as base64url
+ */
+export declare function generateProjectId(absolutePath: string): string;
+/**
+ * Build display name for a workspace.
+ * - Main repo: "repo"
+ * - Worktree: "repo · worktree"
+ */
+export declare function generateProjectDisplayName(workspacePath: string, workflowRootPath: string): string;
+export declare class ProjectRegistry {
+    private registryPath;
+    private registryDir;
+    private needsInitialization;
+    constructor();
+    /**
+     * Ensure the registry directory exists
+     */
+    private ensureRegistryDir;
+    /**
+     * Read the registry file with atomic operations
+     * Returns a map keyed by projectId
+     */
+    private readRegistry;
+    /**
+     * Write the registry file atomically
+     */
+    private writeRegistry;
+    /**
+     * Check if a process is still running
+     * Note: When running in Docker with path translation, we can't check host PIDs,
+     * so we assume processes are alive if path translation is enabled.
+     */
+    private isProcessAlive;
+    /**
+     * Register a project in the global registry
+     * Self-healing: If a project exists with dead PIDs, cleans them up and adds new PID
+     * Multi-instance: Allows unlimited MCP server instances per project
+     */
+    registerProject(projectPath: string, pid: number, options?: RegisterProjectOptions): Promise<string>;
+    /**
+     * Unregister a project from the global registry by path
+     * If pid is provided, only removes that specific instance
+     * If no pid provided, removes the entire project (backwards compat)
+     */
+    unregisterProject(projectPath: string, pid?: number): Promise<void>;
+    /**
+     * Unregister a project by projectId
+     */
+    unregisterProjectById(projectId: string): Promise<void>;
+    /**
+     * Get all active projects from the registry
+     */
+    getAllProjects(): Promise<ProjectRegistryEntry[]>;
+    /**
+     * Get a specific project by path
+     */
+    getProject(projectPath: string): Promise<ProjectRegistryEntry | null>;
+    /**
+     * Get a specific project by projectId
+     */
+    getProjectById(projectId: string): Promise<ProjectRegistryEntry | null>;
+    /**
+     * Clean up stale instances (where the process is no longer running)
+     * Projects with no live instances are removed entirely
+     * Returns the count of removed instances
+     */
+    cleanupStaleProjects(): Promise<number>;
+    /**
+     * Check if a project is registered by path
+     */
+    isProjectRegistered(projectPath: string): Promise<boolean>;
+    /**
+     * Get the registry file path for watching
+     */
+    getRegistryPath(): string;
+}
+//# sourceMappingURL=project-registry.d.ts.map

package/dist/core/project-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-registry.d.ts","sourceRoot":"","sources":["../../src/core/project-registry.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CASlG;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,mBAAmB,CAAkB;;IAO7C;;OAEG;YACW,iBAAiB;IAkB/B;;;OAGG;YACW,YAAY;IA0D1B;;OAEG;YACW,aAAa;IAY3B;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAkBtB;;;;OAIG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,MAAM,CAAC;IAyC9G;;;;OAIG;IACG,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBzE;;OAEG;IACG,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7D;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAKvD;;OAEG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAO3E;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAK7E;;;;OAIG;IACG,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;IAgC7C;;OAEG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOhE;;OAEG;IACH,eAAe,IAAI,MAAM;CAG1B"}