@lbruton/spec-workflow-mcp 2.2.4

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

@@ -0,0 +1,25 @@
+export declare const SPEC_WORKFLOW_SHARED_ROOT_ENV = "SPEC_WORKFLOW_SHARED_ROOT";
+/**
+ * Resolves the git workspace root directory.
+ * For repositories and worktrees, this returns the top-level checked-out directory.
+ *
+ * @param projectPath - Any path inside the workspace
+ * @returns Workspace root path, or original path when git is unavailable
+ */
+export declare function resolveGitWorkspaceRoot(projectPath: string): string;
+/**
+ * Resolves the git root directory for storing shared specs.
+ * In worktrees, this returns the main repository path so all worktrees share specs.
+ *
+ * @param projectPath - The current project/worktree path
+ * @returns The resolved path (main repo for worktrees, or original path)
+ */
+export declare function resolveGitRoot(projectPath: string): string;
+/**
+ * Checks if the current directory is a git worktree (not the main repo).
+ *
+ * @param projectPath - The path to check
+ * @returns true if in a worktree, false if main repo or not a git repo
+ */
+export declare function isGitWorktree(projectPath: string): boolean;
+//# sourceMappingURL=git-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-utils.d.ts","sourceRoot":"","sources":["../../src/core/git-utils.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,6BAA6B,8BAA8B,CAAC;AAOzE;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAWnE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAoC1D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAU1D"}

package/dist/core/git-utils.js

@@ -0,0 +1,87 @@
+import { execSync } from 'child_process';
+import { resolve } from 'path';
+export const SPEC_WORKFLOW_SHARED_ROOT_ENV = 'SPEC_WORKFLOW_SHARED_ROOT';
+const GIT_EXEC_OPTIONS = {
+    encoding: 'utf-8',
+    stdio: ['pipe', 'pipe', 'pipe'],
+    timeout: 5000
+};
+/**
+ * Resolves the git workspace root directory.
+ * For repositories and worktrees, this returns the top-level checked-out directory.
+ *
+ * @param projectPath - Any path inside the workspace
+ * @returns Workspace root path, or original path when git is unavailable
+ */
+export function resolveGitWorkspaceRoot(projectPath) {
+    try {
+        const workspaceRoot = execSync('git rev-parse --show-toplevel', {
+            cwd: projectPath,
+            ...GIT_EXEC_OPTIONS
+        }).trim();
+        return workspaceRoot || projectPath;
+    }
+    catch {
+        return projectPath;
+    }
+}
+/**
+ * Resolves the git root directory for storing shared specs.
+ * In worktrees, this returns the main repository path so all worktrees share specs.
+ *
+ * @param projectPath - The current project/worktree path
+ * @returns The resolved path (main repo for worktrees, or original path)
+ */
+export function resolveGitRoot(projectPath) {
+    // Check for explicit override first
+    const explicitRoot = process.env[SPEC_WORKFLOW_SHARED_ROOT_ENV]?.trim();
+    if (explicitRoot) {
+        return explicitRoot;
+    }
+    try {
+        // Get the git common directory (main repo's .git folder)
+        const gitCommonDir = execSync('git rev-parse --git-common-dir', {
+            cwd: projectPath,
+            ...GIT_EXEC_OPTIONS
+        }).trim();
+        // In main repo, returns ".git" - no change needed
+        if (gitCommonDir === '.git') {
+            return projectPath;
+        }
+        // In worktree or subdirectory, returns path like "/main/.git", "/main/.git/worktrees/name",
+        // or relative path like "../../.git" when run from a subdirectory.
+        // Extract the main repo path (parent of .git) and resolve to absolute path.
+        const gitIndex = gitCommonDir.lastIndexOf('.git');
+        if (gitIndex > 0) {
+            const mainRepoPath = gitCommonDir.substring(0, gitIndex - 1);
+            // If path is already absolute (Unix or Windows style), return as-is
+            // Otherwise, resolve relative to projectPath
+            const isAbsolute = mainRepoPath.startsWith('/') || /^[A-Za-z]:[\\/]/.test(mainRepoPath);
+            return isAbsolute ? mainRepoPath : resolve(projectPath, mainRepoPath);
+        }
+        return projectPath;
+    }
+    catch {
+        // Not a git repo or git unavailable - use original path
+        return projectPath;
+    }
+}
+/**
+ * Checks if the current directory is a git worktree (not the main repo).
+ *
+ * @param projectPath - The path to check
+ * @returns true if in a worktree, false if main repo or not a git repo
+ */
+export function isGitWorktree(projectPath) {
+    try {
+        const gitCommonDir = execSync('git rev-parse --git-common-dir', {
+            cwd: projectPath,
+            ...GIT_EXEC_OPTIONS
+        }).trim();
+        return gitCommonDir !== '.git';
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=git-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-utils.js","sourceRoot":"","sources":["../../src/core/git-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAqC,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,CAAC,MAAM,6BAA6B,GAAG,2BAA2B,CAAC;AACzE,MAAM,gBAAgB,GAAsC;IAC1D,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAC/B,OAAO,EAAE,IAAI;CACd,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACzD,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,QAAQ,CAAC,+BAA+B,EAAE;YAC9D,GAAG,EAAE,WAAW;YAChB,GAAG,gBAAgB;SACpB,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,OAAO,aAAa,IAAI,WAAW,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,WAAW,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,WAAmB;IAChD,oCAAoC;IACpC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,EAAE,IAAI,EAAE,CAAC;IACxE,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,CAAC;QACH,yDAAyD;QACzD,MAAM,YAAY,GAAG,QAAQ,CAAC,gCAAgC,EAAE;YAC9D,GAAG,EAAE,WAAW;YAChB,GAAG,gBAAgB;SACpB,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,kDAAkD;QAClD,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;YAC5B,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,4FAA4F;QAC5F,mEAAmE;QACnE,4EAA4E;QAC5E,MAAM,QAAQ,GAAG,YAAY,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,MAAM,YAAY,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;YAC7D,oEAAoE;YACpE,6CAA6C;YAC7C,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACxF,OAAO,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QACxE,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,wDAAwD;QACxD,OAAO,WAAW,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,QAAQ,CAAC,gCAAgC,EAAE;YAC9D,GAAG,EAAE,WAAW;YAChB,GAAG,gBAAgB;SACpB,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,YAAY,KAAK,MAAM,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/core/global-dir.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Environment variable name for overriding the global directory location.
+ * When set, all global state files will be stored in this location instead of ~/.spec-workflow-mcp
+ *
+ * This is useful for sandboxed environments (e.g., Codex CLI with sandbox_mode=workspace-write)
+ * where $HOME is read-only.
+ *
+ * @example
+ * // Set to an absolute path
+ * SPEC_WORKFLOW_HOME=/workspace/.spec-workflow-mcp npx spec-workflow-mcp /workspace
+ *
+ * // Set to a relative path (resolved against current working directory)
+ * SPEC_WORKFLOW_HOME=./.spec-workflow-mcp npx spec-workflow-mcp /workspace
+ */
+export declare const SPEC_WORKFLOW_HOME_ENV = "SPEC_WORKFLOW_HOME";
+/**
+ * Get the global directory path for storing spec-workflow-mcp state files.
+ *
+ * Resolution order:
+ * 1. SPEC_WORKFLOW_HOME environment variable (if set)
+ *    - Absolute paths are used as-is
+ *    - Relative paths are resolved against process.cwd()
+ * 2. Default: ~/.spec-workflow-mcp
+ *
+ * Files stored in this directory:
+ * - activeProjects.json - Project registry
+ * - activeSession.json - Dashboard session info
+ * - settings.json - Global settings
+ * - job-execution-history.json - Job execution history
+ * - migration.log - Implementation log migration tracking
+ *
+ * @returns The absolute path to the global directory
+ */
+export declare function getGlobalDir(): string;
+/**
+ * Get a helpful error message for permission errors when accessing the global directory.
+ * Suggests using SPEC_WORKFLOW_HOME environment variable.
+ *
+ * @param operation - The operation that failed (e.g., "create directory", "write file")
+ * @param path - The path that couldn't be accessed
+ * @returns A formatted error message with suggestions
+ */
+export declare function getPermissionErrorHelp(operation: string, path: string): string;
+//# sourceMappingURL=global-dir.d.ts.map

package/dist/core/global-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-dir.d.ts","sourceRoot":"","sources":["../../src/core/global-dir.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAI3D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAWrC;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAkB9E"}

package/dist/core/global-dir.js

@@ -0,0 +1,74 @@
+import { homedir } from 'os';
+import { join, isAbsolute } from 'path';
+/**
+ * Environment variable name for overriding the global directory location.
+ * When set, all global state files will be stored in this location instead of ~/.spec-workflow-mcp
+ *
+ * This is useful for sandboxed environments (e.g., Codex CLI with sandbox_mode=workspace-write)
+ * where $HOME is read-only.
+ *
+ * @example
+ * // Set to an absolute path
+ * SPEC_WORKFLOW_HOME=/workspace/.spec-workflow-mcp npx spec-workflow-mcp /workspace
+ *
+ * // Set to a relative path (resolved against current working directory)
+ * SPEC_WORKFLOW_HOME=./.spec-workflow-mcp npx spec-workflow-mcp /workspace
+ */
+export const SPEC_WORKFLOW_HOME_ENV = 'SPEC_WORKFLOW_HOME';
+const DEFAULT_DIR_NAME = '.spec-workflow-mcp';
+/**
+ * Get the global directory path for storing spec-workflow-mcp state files.
+ *
+ * Resolution order:
+ * 1. SPEC_WORKFLOW_HOME environment variable (if set)
+ *    - Absolute paths are used as-is
+ *    - Relative paths are resolved against process.cwd()
+ * 2. Default: ~/.spec-workflow-mcp
+ *
+ * Files stored in this directory:
+ * - activeProjects.json - Project registry
+ * - activeSession.json - Dashboard session info
+ * - settings.json - Global settings
+ * - job-execution-history.json - Job execution history
+ * - migration.log - Implementation log migration tracking
+ *
+ * @returns The absolute path to the global directory
+ */
+export function getGlobalDir() {
+    const envPath = process.env[SPEC_WORKFLOW_HOME_ENV];
+    if (envPath) {
+        // If an environment variable is set, use it
+        // Handle both absolute and relative paths
+        return isAbsolute(envPath) ? envPath : join(process.cwd(), envPath);
+    }
+    // Default to ~/.spec-workflow-mcp
+    return join(homedir(), DEFAULT_DIR_NAME);
+}
+/**
+ * Get a helpful error message for permission errors when accessing the global directory.
+ * Suggests using SPEC_WORKFLOW_HOME environment variable.
+ *
+ * @param operation - The operation that failed (e.g., "create directory", "write file")
+ * @param path - The path that couldn't be accessed
+ * @returns A formatted error message with suggestions
+ */
+export function getPermissionErrorHelp(operation, path) {
+    return `
+Failed to ${operation}: ${path}
+
+This error typically occurs in sandboxed environments where $HOME is read-only.
+
+To fix this, set the SPEC_WORKFLOW_HOME environment variable to a writable location:
+
+  SPEC_WORKFLOW_HOME=/path/to/writable/dir npx spec-workflow-mcp [project-path]
+
+For example, to store state files in your workspace:
+
+  SPEC_WORKFLOW_HOME=/workspace/.spec-workflow-mcp npx spec-workflow-mcp /workspace
+
+Or use a relative path:
+
+  SPEC_WORKFLOW_HOME=./.spec-workflow-mcp npx spec-workflow-mcp .
+`.trim();
+}
+//# sourceMappingURL=global-dir.js.map

package/dist/core/global-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-dir.js","sourceRoot":"","sources":["../../src/core/global-dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAExC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAE3D,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAE9C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IAEpD,IAAI,OAAO,EAAE,CAAC;QACZ,4CAA4C;QAC5C,0CAA0C;QAC1C,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED,kCAAkC;IAClC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,gBAAgB,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAiB,EAAE,IAAY;IACpE,OAAO;YACG,SAAS,KAAK,IAAI;;;;;;;;;;;;;;;CAe7B,CAAC,IAAI,EAAE,CAAC;AACT,CAAC"}

package/dist/core/implementation-log-migrator.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Migrates implementation logs from JSON format to individual markdown files
+ * This utility class handles the automatic migration when the MCP server starts
+ */
+export declare class ImplementationLogMigrator {
+    private migrationLogPath;
+    constructor(userDataDir: string);
+    /**
+     * Log migration events
+     */
+    private log;
+    /**
+     * Sanitize taskId for use in filenames (e.g., "1.2" → "1-2")
+     */
+    private sanitizeTaskId;
+    /**
+     * Generate markdown filename for a log entry
+     */
+    private generateFileName;
+    /**
+     * Convert an implementation log entry to markdown format
+     */
+    private entryToMarkdown;
+    /**
+     * Migrate a single JSON file to markdown files
+     */
+    private migrateJsonFile;
+    /**
+     * Scan all specs and migrate their implementation logs
+     */
+    migrateAllSpecs(specsDir: string): Promise<{
+        totalSpecs: number;
+        migratedSpecs: number;
+        totalEntries: number;
+        errors: Array<{
+            spec: string;
+            error: string;
+        }>;
+    }>;
+}
+//# sourceMappingURL=implementation-log-migrator.d.ts.map

package/dist/core/implementation-log-migrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"implementation-log-migrator.d.ts","sourceRoot":"","sources":["../../src/core/implementation-log-migrator.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,gBAAgB,CAAS;gBAErB,WAAW,EAAE,MAAM;IAI/B;;OAEG;IACH,OAAO,CAAC,GAAG;IAMX;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAgHvB;;OAEG;YACW,eAAe;IA6B7B;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAC/C,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAChD,CAAC;CAuFH"}

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;IA6C/C,wBAAwB,IAAI,OAAO,CAAC,cAAc,CAAC;YA+B3C,cAAc;YAoBd,UAAU;CAQzB"}