@lbruton/spec-workflow-mcp 2.2.4

package/README.zh.md

@@ -0,0 +1,314 @@
+# Spec Workflow MCP
+
+[![npm version](https://img.shields.io/npm/v/@pimzino/spec-workflow-mcp)](https://www.npmjs.com/package/@pimzino/spec-workflow-mcp)
+[![VSCode Extension](https://vsmarketplacebadges.dev/version-short/Pimzino.spec-workflow-mcp.svg)](https://marketplace.visualstudio.com/items?itemName=Pimzino.spec-workflow-mcp)
+
+一个 Model Context Protocol (MCP) 服务器，用于结构化的规格驱动开发，配备实时仪表板和 VSCode 扩展。
+
+## ☕ 支持本项目
+
+<a href="https://buymeacoffee.com/Pimzino" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>
+
+## 📺 功能展示
+
+### 🔄 审批系统演示
+<a href="https://www.youtube.com/watch?v=C-uEa3mfxd0" target="_blank">
+  <img src="https://img.youtube.com/vi/C-uEa3mfxd0/maxresdefault.jpg" alt="Approval System Demo" width="600">
+</a>
+
+*了解审批系统的工作方式：创建文档、通过仪表板请求审批、提供反馈并跟踪修订。*
+
+### 📊 仪表板与规格管理
+<a href="https://www.youtube.com/watch?v=g9qfvjLUWf8" target="_blank">
+  <img src="https://img.youtube.com/vi/g9qfvjLUWf8/maxresdefault.jpg" alt="Dashboard Demo" width="600">
+</a>
+
+*探索实时仪表板：查看规格、跟踪进度、浏览文档并监控开发工作流程。*
+
+## ✨ 核心特性
+
+- **结构化开发工作流** - 顺序规格创建（需求 → 设计 → 任务）
+- **实时 Web 仪表板** - 通过实时更新监控规格、任务和进度
+- **VSCode 扩展** - 为 VSCode 用户提供集成侧边栏仪表板
+- **审批工作流** - 完整的审批流程，支持修订
+- **任务进度跟踪** - 可视化进度条和详细状态
+- **实现日志** - 所有任务实现的可搜索日志，包含代码统计
+- **多语言支持** - 支持 11 种语言
+
+## 🌍 支持的语言
+
+🇺🇸 English • 🇯🇵 日本語 • 🇨🇳 中文 • 🇪🇸 Español • 🇧🇷 Português • 🇩🇪 Deutsch • 🇫🇷 Français • 🇷🇺 Русский • 🇮🇹 Italiano • 🇰🇷 한국어 • 🇸🇦 العربية
+
+## 🚀 快速开始
+
+### 步骤 1：添加到您的 AI 工具
+
+添加到您的 MCP 配置（请参阅下方特定客户端设置）：
+
+```json
+{
+  "mcpServers": {
+    "spec-workflow": {
+      "command": "npx",
+      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+    }
+  }
+}
+```
+
+### 步骤 2：选择您的界面
+
+**选项 A：Web 仪表板**（CLI 用户必需）
+启动仪表板（默认运行在端口 5000）：
+```bash
+npx -y @pimzino/spec-workflow-mcp@latest --dashboard
+```
+
+仪表板将可通过以下地址访问：http://localhost:5000
+
+> **注意：** 只需要一个仪表板实例。所有项目都将连接到同一个仪表板。
+
+**选项 B：VSCode 扩展**（推荐给 VSCode 用户）
+
+从 VSCode 市场安装 [Spec Workflow MCP Extension](https://marketplace.visualstudio.com/items?itemName=Pimzino.spec-workflow-mcp)。
+
+## 📝 使用方法
+
+在对话中简单提及 spec-workflow：
+
+- **"创建一个用户认证的规格"** - 创建完整的规格工作流
+- **"列出我的所有规格"** - 显示所有规格及其状态
+- **"执行规格 user-auth 中的任务 1.2"** - 运行特定任务
+
+[查看更多示例 →](docs/PROMPTING-GUIDE.zh.md)
+
+## 🔧 MCP 客户端设置
+
+<details>
+<summary><strong>Augment Code</strong></summary>
+
+在您的 Augment 设置中配置：
+```json
+{
+  "mcpServers": {
+    "spec-workflow": {
+      "command": "npx",
+      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Claude Code CLI</strong></summary>
+
+添加到您的 MCP 配置：
+```bash
+claude mcp add spec-workflow npx @pimzino/spec-workflow-mcp@latest -- /path/to/your/project
+```
+
+**重要说明：**
+- `-y` 标志绕过 npm 提示，使安装更流畅
+- `--` 分隔符确保路径传递给 spec-workflow 脚本，而不是 npx
+- 将 `/path/to/your/project` 替换为您的实际项目目录路径
+
+**Windows 替代方案（如果上述方法不起作用）：**
+```bash
+claude mcp add spec-workflow cmd.exe /c "npx @pimzino/spec-workflow-mcp@latest /path/to/your/project"
+```
+</details>
+
+<details>
+<summary><strong>Claude Desktop</strong></summary>
+
+添加到 `claude_desktop_config.json`：
+```json
+{
+  "mcpServers": {
+    "spec-workflow": {
+      "command": "npx",
+      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+    }
+  }
+}
+```
+
+> **重要：** 在启动 MCP 服务器之前，使用 `--dashboard` 单独运行仪表板。
+
+</details>
+
+<details>
+<summary><strong>Cline/Claude Dev</strong></summary>
+
+添加到您的 MCP 服务器配置：
+```json
+{
+  "mcpServers": {
+    "spec-workflow": {
+      "command": "npx",
+      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Continue IDE Extension</strong></summary>
+
+添加到您的 Continue 配置：
+```json
+{
+  "mcpServers": {
+    "spec-workflow": {
+      "command": "npx",
+      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Cursor IDE</strong></summary>
+
+添加到您的 Cursor 设置（`settings.json`）：
+```json
+{
+  "mcpServers": {
+    "spec-workflow": {
+      "command": "npx",
+      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>OpenCode</strong></summary>
+
+添加到您的 `opencode.json` 配置文件：
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "spec-workflow": {
+      "type": "local",
+      "command": ["npx", "-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"],
+      "enabled": true
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Windsurf</strong></summary>
+
+添加到您的 `~/.codeium/windsurf/mcp_config.json` 配置文件：
+```json
+{
+  "mcpServers": {
+    "spec-workflow": {
+      "command": "npx",
+      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Codex</strong></summary>
+
+添加到您的 `~/.codex/config.toml` 配置文件：
+```toml
+[mcp_servers.spec-workflow]
+command = "npx"
+args = ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+```
+</details>
+
+## 🐳 Docker 部署
+
+在 Docker 容器中运行仪表板以实现隔离部署：
+
+```bash
+# 使用 Docker Compose（推荐）
+cd containers
+docker-compose up --build
+
+# 或使用 Docker CLI
+docker build -f containers/Dockerfile -t spec-workflow-mcp .
+docker run -p 5000:5000 -v "./workspace/.spec-workflow:/workspace/.spec-workflow:rw" spec-workflow-mcp
+```
+
+仪表板将可通过以下地址访问：http://localhost:5000
+
+[查看 Docker 设置指南 →](containers/README.md)
+
+## 🔒 沙盒环境
+
+对于沙盒环境（例如，使用 `sandbox_mode=workspace-write` 的 Codex CLI），其中 `$HOME` 为只读，使用 `SPEC_WORKFLOW_HOME` 环境变量将全局状态文件重定向到可写位置：
+
+```bash
+SPEC_WORKFLOW_HOME=/workspace/.spec-workflow-mcp npx -y @pimzino/spec-workflow-mcp@latest /workspace
+```
+
+[查看配置指南 →](docs/CONFIGURATION.zh.md#environment-variables)
+
+## 📚 文档
+
+- [配置指南](docs/CONFIGURATION.zh.md) - 命令行选项、配置文件
+- [用户指南](docs/USER-GUIDE.zh.md) - 全面的使用示例
+- [工作流程](docs/WORKFLOW.zh.md) - 开发工作流程和最佳实践
+- [界面指南](docs/INTERFACES.zh.md) - 仪表板和 VSCode 扩展详情
+- [提示指南](docs/PROMPTING-GUIDE.zh.md) - 高级提示示例
+- [工具参考](docs/TOOLS-REFERENCE.zh.md) - 完整的工具文档
+- [开发指南](docs/DEVELOPMENT.zh.md) - 贡献和开发设置
+- [故障排除](docs/TROUBLESHOOTING.zh.md) - 常见问题和解决方案
+
+## 📁 项目结构
+
+```
+your-project/
+  .spec-workflow/
+    approvals/
+    archive/
+    specs/
+    steering/
+    templates/
+    user-templates/
+    config.example.toml
+```
+
+## 🛠️ 开发
+
+```bash
+# 安装依赖
+npm install
+
+# 构建项目
+npm run build
+
+# 以开发模式运行
+npm run dev
+```
+
+[查看开发指南 →](docs/DEVELOPMENT.zh.md)
+
+## 📄 许可证
+
+GPL-3.0
+
+## ⭐ Star 历史
+
+<a href="https://www.star-history.com/#Pimzino/spec-workflow-mcp&Date">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=Pimzino/spec-workflow-mcp&type=Date&theme=dark" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Pimzino/spec-workflow-mcp&type=Date" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=Pimzino/spec-workflow-mcp&type=Date" />
+ </picture>
+</a>

package/dist/__tests__/config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.test.d.ts.map

package/dist/__tests__/config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/config.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/config.test.js

@@ -0,0 +1,264 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { loadConfigFromPath, loadConfigFile, mergeConfigs } from '../config.js';
+describe('config', () => {
+    let testDir;
+    beforeEach(async () => {
+        testDir = join(tmpdir(), `spec-workflow-config-test-${Date.now()}`);
+        await fs.mkdir(testDir, { recursive: true });
+    });
+    afterEach(async () => {
+        try {
+            await fs.rm(testDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    });
+    describe('loadConfigFromPath', () => {
+        it('should load basic config successfully', async () => {
+            const configPath = join(testDir, 'config.toml');
+            const configContent = `
+port = 8080
+dashboardOnly = true
+lang = "ja"
+`;
+            await fs.writeFile(configPath, configContent);
+            const result = loadConfigFromPath(configPath);
+            expect(result.error).toBeUndefined();
+            expect(result.config).not.toBeNull();
+            expect(result.config?.port).toBe(8080);
+            expect(result.config?.dashboardOnly).toBe(true);
+            expect(result.config?.lang).toBe('ja');
+        });
+        it('should load network configuration (bindAddress, allowExternalAccess)', async () => {
+            const configPath = join(testDir, 'config.toml');
+            const configContent = `
+port = 5000
+bindAddress = "0.0.0.0"
+allowExternalAccess = true
+`;
+            await fs.writeFile(configPath, configContent);
+            const result = loadConfigFromPath(configPath);
+            expect(result.error).toBeUndefined();
+            expect(result.config).not.toBeNull();
+            expect(result.config?.bindAddress).toBe('0.0.0.0');
+            expect(result.config?.allowExternalAccess).toBe(true);
+        });
+        it('should load security features configuration', async () => {
+            const configPath = join(testDir, 'config.toml');
+            const configContent = `
+port = 5000
+
+[security]
+rateLimitEnabled = true
+rateLimitPerMinute = 100
+auditLogEnabled = false
+`;
+            await fs.writeFile(configPath, configContent);
+            const result = loadConfigFromPath(configPath);
+            expect(result.error).toBeUndefined();
+            expect(result.config).not.toBeNull();
+            expect(result.config?.security?.rateLimitEnabled).toBe(true);
+            expect(result.config?.security?.rateLimitPerMinute).toBe(100);
+            expect(result.config?.security?.auditLogEnabled).toBe(false);
+        });
+        it('should error if config file not found', () => {
+            const result = loadConfigFromPath(join(testDir, 'nonexistent.toml'));
+            expect(result.config).toBeNull();
+            expect(result.error).toContain('not found');
+        });
+        it('should error on invalid port (below 1024)', async () => {
+            const configPath = join(testDir, 'config.toml');
+            await fs.writeFile(configPath, 'port = 80');
+            const result = loadConfigFromPath(configPath);
+            expect(result.config).toBeNull();
+            expect(result.error).toContain('Invalid port');
+        });
+        it('should error on invalid port (above 65535)', async () => {
+            const configPath = join(testDir, 'config.toml');
+            await fs.writeFile(configPath, 'port = 70000');
+            const result = loadConfigFromPath(configPath);
+            expect(result.config).toBeNull();
+            expect(result.error).toContain('Invalid port');
+        });
+        describe('network security validation', () => {
+            it('should allow localhost binding without explicit allowExternalAccess', async () => {
+                const configPath = join(testDir, 'config.toml');
+                const configContent = `
+bindAddress = "127.0.0.1"
+`;
+                await fs.writeFile(configPath, configContent);
+                const result = loadConfigFromPath(configPath);
+                expect(result.error).toBeUndefined();
+                expect(result.config?.bindAddress).toBe('127.0.0.1');
+            });
+            it('should allow "localhost" binding without explicit allowExternalAccess', async () => {
+                const configPath = join(testDir, 'config.toml');
+                const configContent = `
+bindAddress = "localhost"
+`;
+                await fs.writeFile(configPath, configContent);
+                const result = loadConfigFromPath(configPath);
+                expect(result.error).toBeUndefined();
+                expect(result.config?.bindAddress).toBe('localhost');
+            });
+            it('should allow IPv6 localhost "::1" without explicit allowExternalAccess', async () => {
+                const configPath = join(testDir, 'config.toml');
+                const configContent = `
+bindAddress = "::1"
+`;
+                await fs.writeFile(configPath, configContent);
+                const result = loadConfigFromPath(configPath);
+                expect(result.error).toBeUndefined();
+                expect(result.config?.bindAddress).toBe('::1');
+            });
+            it('should allow any 127.x.x.x address without explicit allowExternalAccess', async () => {
+                const configPath = join(testDir, 'config.toml');
+                const configContent = `
+bindAddress = "127.0.0.2"
+`;
+                await fs.writeFile(configPath, configContent);
+                const result = loadConfigFromPath(configPath);
+                expect(result.error).toBeUndefined();
+                expect(result.config?.bindAddress).toBe('127.0.0.2');
+            });
+            it('should error on non-localhost binding without allowExternalAccess', async () => {
+                const configPath = join(testDir, 'config.toml');
+                const configContent = `
+bindAddress = "0.0.0.0"
+`;
+                await fs.writeFile(configPath, configContent);
+                const result = loadConfigFromPath(configPath);
+                expect(result.config).toBeNull();
+                expect(result.error).toContain('non-localhost');
+                expect(result.error).toContain('allowExternalAccess');
+            });
+            it('should error on external IP binding without allowExternalAccess', async () => {
+                const configPath = join(testDir, 'config.toml');
+                const configContent = `
+bindAddress = "192.168.1.100"
+`;
+                await fs.writeFile(configPath, configContent);
+                const result = loadConfigFromPath(configPath);
+                expect(result.config).toBeNull();
+                expect(result.error).toContain('non-localhost');
+            });
+            it('should allow non-localhost binding with explicit allowExternalAccess = true', async () => {
+                const configPath = join(testDir, 'config.toml');
+                const configContent = `
+bindAddress = "0.0.0.0"
+allowExternalAccess = true
+`;
+                await fs.writeFile(configPath, configContent);
+                const result = loadConfigFromPath(configPath);
+                expect(result.error).toBeUndefined();
+                expect(result.config?.bindAddress).toBe('0.0.0.0');
+                expect(result.config?.allowExternalAccess).toBe(true);
+            });
+            it('should error on non-localhost binding with allowExternalAccess = false', async () => {
+                const configPath = join(testDir, 'config.toml');
+                const configContent = `
+bindAddress = "0.0.0.0"
+allowExternalAccess = false
+`;
+                await fs.writeFile(configPath, configContent);
+                const result = loadConfigFromPath(configPath);
+                expect(result.config).toBeNull();
+                expect(result.error).toContain('non-localhost');
+            });
+        });
+        describe('security features validation', () => {
+            it('should error on invalid rateLimitPerMinute (not positive)', async () => {
+                const configPath = join(testDir, 'config.toml');
+                const configContent = `
+[security]
+rateLimitPerMinute = 0
+`;
+                await fs.writeFile(configPath, configContent);
+                const result = loadConfigFromPath(configPath);
+                expect(result.config).toBeNull();
+                expect(result.error).toContain('rateLimitPerMinute');
+            });
+            it('should error on invalid auditLogRetentionDays (not positive)', async () => {
+                const configPath = join(testDir, 'config.toml');
+                const configContent = `
+[security]
+auditLogRetentionDays = -5
+`;
+                await fs.writeFile(configPath, configContent);
+                const result = loadConfigFromPath(configPath);
+                expect(result.config).toBeNull();
+                expect(result.error).toContain('auditLogRetentionDays');
+            });
+        });
+    });
+    describe('loadConfigFile', () => {
+        it('should return null config when no config file exists', async () => {
+            const result = loadConfigFile(testDir);
+            expect(result.config).toBeNull();
+            expect(result.configPath).toBeNull();
+            expect(result.error).toBeUndefined();
+        });
+        it('should load config from .spec-workflow/config.toml', async () => {
+            const configDir = join(testDir, '.spec-workflow');
+            await fs.mkdir(configDir, { recursive: true });
+            await fs.writeFile(join(configDir, 'config.toml'), 'port = 9000');
+            const result = loadConfigFile(testDir);
+            expect(result.error).toBeUndefined();
+            expect(result.config?.port).toBe(9000);
+        });
+        it('should use custom config path when provided', async () => {
+            const customPath = join(testDir, 'custom-config.toml');
+            await fs.writeFile(customPath, 'port = 7777');
+            const result = loadConfigFile(testDir, customPath);
+            expect(result.error).toBeUndefined();
+            expect(result.config?.port).toBe(7777);
+        });
+    });
+    describe('mergeConfigs', () => {
+        it('should return CLI args when file config is null', () => {
+            const cliArgs = { port: 5000 };
+            const merged = mergeConfigs(null, cliArgs);
+            expect(merged.port).toBe(5000);
+        });
+        it('should use file config when CLI args are empty', () => {
+            const fileConfig = {
+                port: 8080,
+                lang: 'en'
+            };
+            const merged = mergeConfigs(fileConfig, {});
+            expect(merged.port).toBe(8080);
+            expect(merged.lang).toBe('en');
+        });
+        it('should override file config with CLI args', () => {
+            const fileConfig = {
+                port: 8080,
+                lang: 'en',
+                bindAddress: '127.0.0.1'
+            };
+            const cliArgs = {
+                port: 5000
+            };
+            const merged = mergeConfigs(fileConfig, cliArgs);
+            expect(merged.port).toBe(5000); // CLI override
+            expect(merged.lang).toBe('en'); // File config preserved
+            expect(merged.bindAddress).toBe('127.0.0.1'); // File config preserved
+        });
+        it('should not override with undefined CLI args', () => {
+            const fileConfig = {
+                port: 8080
+            };
+            const cliArgs = {
+                port: undefined,
+                lang: 'ja'
+            };
+            const merged = mergeConfigs(fileConfig, cliArgs);
+            expect(merged.port).toBe(8080); // Not overridden by undefined
+            expect(merged.lang).toBe('ja');
+        });
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/__tests__/config.test.js.map

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

package/dist/__tests__/index-args.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index-args.test.d.ts.map

package/dist/__tests__/index-args.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-args.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/index-args.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/index-args.test.js

@@ -0,0 +1,43 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+vi.mock('../core/git-utils.js', () => ({
+    resolveGitWorkspaceRoot: vi.fn((path) => `/workspace${path}`),
+    resolveGitRoot: vi.fn((path) => `/shared${path}`)
+}));
+import { parseArguments } from '../index.js';
+import { resolveGitRoot, resolveGitWorkspaceRoot } from '../core/git-utils.js';
+const mockedResolveGitWorkspaceRoot = vi.mocked(resolveGitWorkspaceRoot);
+const mockedResolveGitRoot = vi.mocked(resolveGitRoot);
+describe('index argument parsing (worktree/shared root)', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('uses workspace path as workflow root when --no-shared-worktree-specs is enabled', () => {
+        mockedResolveGitWorkspaceRoot.mockReturnValue('/tmp/specwf-wt-a');
+        mockedResolveGitRoot.mockReturnValue('/repo/main');
+        const parsed = parseArguments(['/tmp/specwf-wt-a', '--no-shared-worktree-specs']);
+        expect(parsed.workspacePath).toBe('/tmp/specwf-wt-a');
+        expect(parsed.workflowRootPath).toBe('/tmp/specwf-wt-a');
+        expect(parsed.noSharedWorktreeSpecs).toBe(true);
+        expect(mockedResolveGitWorkspaceRoot).toHaveBeenCalledWith('/tmp/specwf-wt-a');
+        expect(mockedResolveGitRoot).not.toHaveBeenCalled();
+    });
+    it('uses shared git root by default when no flag is provided', () => {
+        mockedResolveGitWorkspaceRoot.mockReturnValue('/tmp/specwf-wt-b');
+        mockedResolveGitRoot.mockReturnValue('/Users/lucas/dev/projects/spec-workflow-mcp');
+        const parsed = parseArguments(['/tmp/specwf-wt-b']);
+        expect(parsed.workspacePath).toBe('/tmp/specwf-wt-b');
+        expect(parsed.workflowRootPath).toBe('/Users/lucas/dev/projects/spec-workflow-mcp');
+        expect(parsed.noSharedWorktreeSpecs).toBe(false);
+        expect(mockedResolveGitRoot).toHaveBeenCalledWith('/tmp/specwf-wt-b');
+    });
+    it('accepts --no-shared-worktree-specs in dashboard mode without treating it as project path', () => {
+        mockedResolveGitWorkspaceRoot.mockReturnValue('/tmp/specwf-wt-dashboard');
+        const parsed = parseArguments(['--dashboard', '--port', '6001', '--no-shared-worktree-specs']);
+        expect(parsed.isDashboardMode).toBe(true);
+        expect(parsed.port).toBe(6001);
+        expect(parsed.noSharedWorktreeSpecs).toBe(true);
+        expect(parsed.workspacePath).toBe('/tmp/specwf-wt-dashboard');
+        expect(parsed.workflowRootPath).toBe('/tmp/specwf-wt-dashboard');
+    });
+});
+//# sourceMappingURL=index-args.test.js.map

package/dist/__tests__/index-args.test.js.map

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

package/dist/__tests__/index-entrypoint.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index-entrypoint.test.d.ts.map

package/dist/__tests__/index-entrypoint.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-entrypoint.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/index-entrypoint.test.ts"],"names":[],"mappings":""}