@madmatt112org/spec-workflow-mcp 3.0.0

package/dist/core/deferral-storage.js

@@ -0,0 +1,232 @@
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { randomUUID } from 'crypto';
+import { PathUtils } from './path-utils.js';
+/**
+ * Storage for deferred decisions using markdown files with YAML frontmatter.
+ * Each deferral is stored as a single file in .spec-workflow/deferrals/
+ */
+export class DeferralStorage {
+    deferralsDir;
+    constructor(projectPath) {
+        this.deferralsDir = join(PathUtils.getWorkflowRoot(projectPath), 'deferrals');
+    }
+    async ensureDir() {
+        await fs.mkdir(this.deferralsDir, { recursive: true });
+    }
+    generateId() {
+        return 'd-' + randomUUID().replace(/-/g, '').slice(0, 8);
+    }
+    toMarkdown(deferral) {
+        const frontmatter = [
+            '---',
+            `id: "${deferral.id}"`,
+            `status: "${deferral.status}"`,
+            `title: "${deferral.title.replace(/"/g, '\\"')}"`,
+            `createdAt: "${deferral.createdAt}"`,
+            `updatedAt: "${deferral.updatedAt}"`,
+            `resolvedAt: ${deferral.resolvedAt ? `"${deferral.resolvedAt}"` : 'null'}`,
+            `originSpec: ${deferral.originSpec ? `"${deferral.originSpec}"` : 'null'}`,
+            `originPhase: ${deferral.originPhase ? `"${deferral.originPhase}"` : 'null'}`,
+            `revisitTrigger: "${deferral.revisitTrigger.replace(/"/g, '\\"')}"`,
+            `tags: [${deferral.tags.map(t => `"${t}"`).join(', ')}]`,
+            `resolution: ${deferral.resolution ? `"${deferral.resolution.replace(/"/g, '\\"')}"` : 'null'}`,
+            `resolvedInSpec: ${deferral.resolvedInSpec ? `"${deferral.resolvedInSpec}"` : 'null'}`,
+            `supersededBy: ${deferral.supersededBy ? `"${deferral.supersededBy}"` : 'null'}`,
+            `supersedes: ${deferral.supersedes ? `"${deferral.supersedes}"` : 'null'}`,
+            '---',
+        ].join('\n');
+        return `${frontmatter}
+
+## Context
+${deferral.body.context}
+
+## Decision Deferred
+${deferral.body.decision}
+
+## Revisit Criteria
+${deferral.body.revisitCriteria}
+`;
+    }
+    parseMarkdown(content) {
+        const fmMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+        if (!fmMatch)
+            return null;
+        const fm = fmMatch[1];
+        const body = fmMatch[2];
+        const getString = (key) => {
+            const match = fm.match(new RegExp(`^${key}:\\s*(?:"((?:[^"\\\\]|\\\\.)*)"|null)\\s*$`, 'm'));
+            if (!match)
+                return null;
+            return match[1] !== undefined ? match[1].replace(/\\"/g, '"') : null;
+        };
+        const getArray = (key) => {
+            const match = fm.match(new RegExp(`^${key}:\\s*\\[(.*)\\]\\s*$`, 'm'));
+            if (!match || !match[1].trim())
+                return [];
+            return match[1].split(',').map(s => s.trim().replace(/^"|"$/g, ''));
+        };
+        const getSection = (heading) => {
+            const regex = new RegExp(`## ${heading}\\n([\\s\\S]*?)(?=\\n## |$)`);
+            const match = body.match(regex);
+            return match ? match[1].trim() : '';
+        };
+        const id = getString('id');
+        const status = getString('status');
+        const title = getString('title');
+        if (!id || !status || !title)
+            return null;
+        return {
+            id,
+            status,
+            title,
+            createdAt: getString('createdAt') || '',
+            updatedAt: getString('updatedAt') || '',
+            resolvedAt: getString('resolvedAt'),
+            originSpec: getString('originSpec'),
+            originPhase: getString('originPhase'),
+            revisitTrigger: getString('revisitTrigger') || '',
+            tags: getArray('tags'),
+            resolution: getString('resolution'),
+            resolvedInSpec: getString('resolvedInSpec'),
+            supersededBy: getString('supersededBy'),
+            supersedes: getString('supersedes'),
+            body: {
+                context: getSection('Context'),
+                decision: getSection('Decision Deferred'),
+                revisitCriteria: getSection('Revisit Criteria'),
+            },
+        };
+    }
+    async create(deferral, supersedes) {
+        await this.ensureDir();
+        // Generate unique ID with collision check
+        let id;
+        let attempts = 0;
+        do {
+            id = this.generateId();
+            attempts++;
+            if (attempts > 10)
+                throw new Error('Failed to generate unique deferral ID after 10 attempts');
+        } while (await this.exists(id));
+        const now = new Date().toISOString();
+        const newDeferral = {
+            ...deferral,
+            id,
+            status: 'deferred',
+            createdAt: now,
+            updatedAt: now,
+            resolvedAt: null,
+            resolution: null,
+            resolvedInSpec: null,
+            supersededBy: null,
+            supersedes: supersedes || null,
+        };
+        // If superseding, mark old deferral
+        if (supersedes) {
+            const old = await this.get(supersedes);
+            if (!old)
+                throw new Error(`Cannot supersede: deferral ${supersedes} not found`);
+            if (old.status !== 'deferred')
+                throw new Error(`Cannot supersede: deferral ${supersedes} is already ${old.status}`);
+            old.status = 'superseded';
+            old.supersededBy = id;
+            old.updatedAt = now;
+            await fs.writeFile(join(this.deferralsDir, `${supersedes}.md`), this.toMarkdown(old), 'utf-8');
+        }
+        await fs.writeFile(join(this.deferralsDir, `${id}.md`), this.toMarkdown(newDeferral), 'utf-8');
+        return id;
+    }
+    async get(id) {
+        try {
+            const content = await fs.readFile(join(this.deferralsDir, `${id}.md`), 'utf-8');
+            return this.parseMarkdown(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    async list(filters) {
+        try {
+            const files = await fs.readdir(this.deferralsDir);
+            const deferrals = [];
+            for (const file of files) {
+                if (!file.endsWith('.md'))
+                    continue;
+                const content = await fs.readFile(join(this.deferralsDir, file), 'utf-8');
+                const deferral = this.parseMarkdown(content);
+                if (!deferral)
+                    continue;
+                if (filters?.status && deferral.status !== filters.status)
+                    continue;
+                if (filters?.originSpec && deferral.originSpec !== filters.originSpec)
+                    continue;
+                if (filters?.tag && !deferral.tags.includes(filters.tag))
+                    continue;
+                deferrals.push(deferral);
+            }
+            return deferrals.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+        }
+        catch {
+            return [];
+        }
+    }
+    async resolve(id, resolution, resolvedInSpec) {
+        const deferral = await this.get(id);
+        if (!deferral)
+            throw new Error(`Deferral ${id} not found`);
+        if (deferral.status !== 'deferred')
+            throw new Error(`Cannot resolve: deferral ${id} is already ${deferral.status}`);
+        const now = new Date().toISOString();
+        deferral.status = 'resolved';
+        deferral.resolution = resolution;
+        deferral.resolvedAt = now;
+        deferral.updatedAt = now;
+        deferral.resolvedInSpec = resolvedInSpec || null;
+        await fs.writeFile(join(this.deferralsDir, `${id}.md`), this.toMarkdown(deferral), 'utf-8');
+    }
+    async update(id, updates) {
+        const deferral = await this.get(id);
+        if (!deferral)
+            throw new Error(`Deferral ${id} not found`);
+        if (updates.title !== undefined)
+            deferral.title = updates.title;
+        if (updates.revisitTrigger !== undefined)
+            deferral.revisitTrigger = updates.revisitTrigger;
+        if (updates.tags !== undefined)
+            deferral.tags = updates.tags;
+        if (updates.context !== undefined)
+            deferral.body.context = updates.context;
+        if (updates.decision !== undefined)
+            deferral.body.decision = updates.decision;
+        if (updates.revisitCriteria !== undefined)
+            deferral.body.revisitCriteria = updates.revisitCriteria;
+        deferral.updatedAt = new Date().toISOString();
+        await fs.writeFile(join(this.deferralsDir, `${id}.md`), this.toMarkdown(deferral), 'utf-8');
+    }
+    async delete(id) {
+        const deferral = await this.get(id);
+        if (!deferral)
+            throw new Error(`Deferral ${id} not found`);
+        // Check if any other deferral references this one
+        const all = await this.list();
+        for (const d of all) {
+            if (d.id === id)
+                continue;
+            if (d.supersededBy === id || d.supersedes === id) {
+                throw new Error(`Cannot delete: deferral ${d.id} references ${id}`);
+            }
+        }
+        await fs.unlink(join(this.deferralsDir, `${id}.md`));
+    }
+    async exists(id) {
+        try {
+            await fs.access(join(this.deferralsDir, `${id}.md`));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=deferral-storage.js.map

package/dist/core/deferral-storage.js.map

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

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/hygiene-signals.d.ts

@@ -0,0 +1,8 @@
+export type HygieneSignal = {
+    file: string;
+    line: number;
+    pattern: 'console' | 'todo' | 'fixme' | 'debugger';
+    text: string;
+};
+export declare function computeHygieneSignals(files: string[]): Promise<HygieneSignal[]>;
+//# sourceMappingURL=hygiene-signals.d.ts.map

package/dist/core/hygiene-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hygiene-signals.d.ts","sourceRoot":"","sources":["../../src/core/hygiene-signals.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;IACnD,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAqCF,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAIrF"}

package/dist/core/hygiene-signals.js

@@ -0,0 +1,41 @@
+import { readFile, stat } from 'fs/promises';
+import { partitionPaths } from './path-denylist.js';
+const MAX_FILE_SIZE = 1024 * 1024;
+const MAX_TEXT_LENGTH = 120;
+const PATTERNS = [
+    { pattern: 'console', regex: /console\.(log|warn|error|debug|info|trace)\s*\(/ },
+    { pattern: 'todo', regex: /\bTODO\b/ },
+    { pattern: 'fixme', regex: /\bFIXME\b/ },
+    { pattern: 'debugger', regex: /\bdebugger\b/ },
+];
+async function scanFile(file) {
+    try {
+        const stats = await stat(file);
+        if (stats.size > MAX_FILE_SIZE) {
+            return [];
+        }
+        const content = await readFile(file, 'utf-8');
+        const lines = content.split('\n');
+        const signals = [];
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            for (const { pattern, regex } of PATTERNS) {
+                if (regex.test(line)) {
+                    const trimmed = line.trim();
+                    const text = trimmed.length > MAX_TEXT_LENGTH ? trimmed.slice(0, MAX_TEXT_LENGTH) : trimmed;
+                    signals.push({ file, line: i + 1, pattern, text });
+                }
+            }
+        }
+        return signals;
+    }
+    catch {
+        return [];
+    }
+}
+export async function computeHygieneSignals(files) {
+    const { kept } = partitionPaths(files);
+    const results = await Promise.all(kept.map(scanFile));
+    return results.flat();
+}
+//# sourceMappingURL=hygiene-signals.js.map

package/dist/core/hygiene-signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hygiene-signals.js","sourceRoot":"","sources":["../../src/core/hygiene-signals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AASpD,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,CAAC;AAClC,MAAM,eAAe,GAAG,GAAG,CAAC;AAE5B,MAAM,QAAQ,GAAgE;IAC5E,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,iDAAiD,EAAE;IAChF,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE;IACtC,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE;IACxC,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,EAAE;CAC/C,CAAC;AAEF,KAAK,UAAU,QAAQ,CAAC,IAAY;IAClC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,IAAI,GAAG,aAAa,EAAE,CAAC;YAC/B,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,OAAO,GAAoB,EAAE,CAAC;QACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,KAAK,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC1C,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBACrB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;oBAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;oBAC5F,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAAe;IACzD,MAAM,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtD,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;AACxB,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"}