feat(commands): add support for project spec commands from .cospec directory (#583)

* feat(commands): add support for project spec commands from .cospec directory

* test: update tests to reflect project spec command fallback behavior

Author: mini2s

src/core/webview/webviewMessageHandler.ts

@@ -72,7 +72,7 @@ import { ErrorCodeManager } from "../costrict/error-code"
 import { writeCostrictAccessToken } from "../costrict/codebase-index/utils"
 import { workspaceEventMonitor } from "../costrict/codebase-index/workspace-event-monitor"
 import { fetchZgsmQuotaInfo, fetchZgsmInviteCode } from "../../api/providers/fetchers/zgsm"
-import { ensureProjectWikiSubtasksExists } from "../costrict/wiki/projectWikiHelpers"
+// import { ensureProjectWikiSubtasksExists } from "../costrict/wiki/projectWikiHelpers"
 
 export const webviewMessageHandler = async (
 	provider: ClineProvider,

src/services/command/__tests__/frontmatter-commands.spec.ts

@@ -8,6 +8,7 @@ vi.mock("fs/promises")
 vi.mock("../roo-config", () => ({
 	getGlobalRooDirectory: vi.fn(() => "/mock/global/.roo"),
 	getProjectRooDirectoryForCwd: vi.fn(() => "/mock/project/.roo"),
+	getProjectCostrictSpecDirectoryForCwd: vi.fn(() => "/mock/project/.cospec"),
 }))
 vi.mock("../built-in-commands", () => ({
 	getBuiltInCommands: vi.fn(() => Promise.resolve([])),
@@ -154,29 +155,29 @@ Global setup instructions.`
 			})
 		})
 
-		it("should fall back to global command if project command doesn't exist", async () => {
-			const globalCommandContent = `---
-description: Global setup command
+		it("should fall back to project spec command if project command doesn't exist", async () => {
+			const projectSpecCommandContent = `---
+description: Project spec setup command
 ---
 
-# Global Setup
+# Project Spec Setup
 
-Global setup instructions.`
+Project spec setup instructions.`
 
 			mockFs.stat = vi.fn().mockResolvedValue({ isDirectory: () => true })
 			mockFs.readFile = vi
 				.fn()
 				.mockRejectedValueOnce(new Error("File not found")) // Project command doesn't exist
-				.mockResolvedValueOnce(globalCommandContent) // Global command exists
+				.mockResolvedValueOnce(projectSpecCommandContent) // Project spec command exists
 
 			const result = await getCommand("/test/cwd", "setup")
 
 			expect(result).toEqual({
 				name: "setup",
-				content: "# Global Setup\n\nGlobal setup instructions.",
-				source: "global",
-				filePath: expect.stringContaining(path.join(".roo", "commands", "setup.md")),
-				description: "Global setup command",
+				content: "# Project Spec Setup\n\nProject spec setup instructions.",
+				source: "project",
+				filePath: path.join("/test/cwd/.cospec/openspec/commands/setup.md"),
+				description: "Project spec setup command",
 				argumentHint: undefined,
 			})
 		})

src/services/command/commands.ts

@@ -1,7 +1,11 @@
 import fs from "fs/promises"
 import * as path from "path"
 import matter from "gray-matter"
-import { getGlobalRooDirectory, getProjectRooDirectoryForCwd } from "../roo-config"
+import {
+	getGlobalRooDirectory,
+	getProjectRooDirectoryForCwd,
+	getProjectCostrictSpecDirectoryForCwd,
+} from "../roo-config"
 import { getBuiltInCommands, getBuiltInCommand } from "./built-in-commands"
 
 export interface Command {
@@ -34,6 +38,9 @@ export async function getCommands(cwd: string): Promise<Command[]> {
 	const projectDir = path.join(getProjectRooDirectoryForCwd(cwd), "commands")
 	await scanCommandDirectory(projectDir, "project", commands)
 
+	const projectSpecCommandsDir = path.join(getProjectCostrictSpecDirectoryForCwd(cwd), "openspec", "commands")
+	await scanCommandDirectory(projectSpecCommandsDir, "project", commands)
+
 	return Array.from(commands.values())
 }
 
@@ -43,6 +50,7 @@ export async function getCommands(cwd: string): Promise<Command[]> {
  */
 export async function getCommand(cwd: string, name: string): Promise<Command | undefined> {
 	// Try to find the command directly without scanning all commands
+	const projectSpecCommandsDir = path.join(getProjectCostrictSpecDirectoryForCwd(cwd), "openspec", "commands")
 	const projectDir = path.join(getProjectRooDirectoryForCwd(cwd), "commands")
 	const globalDir = path.join(getGlobalRooDirectory(), "commands")
 
@@ -52,6 +60,12 @@ export async function getCommand(cwd: string, name: string): Promise<Command | u
 		return projectCommand
 	}
 
+	// Check project directory first (highest priority)
+	const projectSpecCommand = await tryLoadCommand(projectSpecCommandsDir, name, "project")
+	if (projectSpecCommand) {
+		return projectSpecCommand
+	}
+
 	// Check global directory if not found in project
 	const globalCommand = await tryLoadCommand(globalDir, name, "global")
 	if (globalCommand) {

src/services/roo-config/__tests__/index.spec.ts

@@ -210,7 +210,11 @@ describe("RooConfigService", () => {
 
 			const result = getRooDirectoriesForCwd(cwd)
 
-			expect(result).toEqual([path.join("/mock/home", ".roo"), path.join(cwd, ".roo")])
+			expect(result).toEqual([
+				path.join("/mock/home", ".roo"),
+				path.join(cwd, ".roo"),
+				path.join(cwd, ".cospec", "openspec"),
+			])
 		})
 	})
 

src/services/roo-config/index.ts

@@ -61,6 +61,10 @@ export function getProjectRooDirectoryForCwd(cwd: string): string {
 	return path.join(cwd, ".roo")
 }
 
+export function getProjectCostrictSpecDirectoryForCwd(cwd: string): string {
+	return path.join(cwd, ".cospec")
+}
+
 /**
  * Checks if a directory exists
  */
@@ -152,6 +156,7 @@ export function getRooDirectoriesForCwd(cwd: string): string[] {
 
 	// Add project-local directory second
 	directories.push(getProjectRooDirectoryForCwd(cwd))
+	directories.push(path.join(getProjectCostrictSpecDirectoryForCwd(cwd), "openspec"))
 
 	return directories
 }