@agiflowai/aicode-toolkit 0.6.0 → 1.0.2

package/dist/index.cjs

@@ -1,4 +1,4 @@
-const require_services = require('./services-s1vmufE4.cjs');
+const require_services = require('./services-C6lqyioO.cjs');
 require('./mcp-Dwt8nYQV.cjs');
 
 exports.BANNER_GRADIENT = require_services.BANNER_GRADIENT;

package/dist/index.d.cts

@@ -67,7 +67,7 @@ declare class CodingAgentService {
   constructor(workspaceRoot: string);
   /**
    * Detect which coding agent is enabled in the workspace
-   * Checks for Claude Code, Codex, and Gemini CLI installations
+   * Checks for Claude Code, Codex, Gemini CLI, GitHub Copilot, and Cursor installations
    * @param workspaceRoot - The workspace root directory
    * @returns Promise resolving to detected agent ID or null
    */
@@ -80,6 +80,20 @@ declare class CodingAgentService {
     name: string;
     description: string;
   }>;
+  /**
+   * Get the coding agent service instance
+   * @param agent - The coding agent to get service for
+   * @returns The service instance or null if not supported
+   */
+  private getCodingAgentService;
+  /**
+   * Update custom instructions/prompts for the coding agent
+   * Appends custom instruction prompt to the agent's configuration
+   * @param agent - The coding agent to update
+   * @param instructionPrompt - The instruction prompt to append
+   * @param customInstructionFile - Optional custom file path to write instructions to (e.g., '.claude/aicode-instructions.md')
+   */
+  updateCustomInstructions(agent: CodingAgent, instructionPrompt: string, customInstructionFile?: string): Promise<void>;
   /**
    * Setup MCP configuration for the selected coding agent
    * @param agent - The coding agent to configure

package/dist/index.d.ts

@@ -67,7 +67,7 @@ declare class CodingAgentService {
   constructor(workspaceRoot: string);
   /**
    * Detect which coding agent is enabled in the workspace
-   * Checks for Claude Code, Codex, and Gemini CLI installations
+   * Checks for Claude Code, Codex, Gemini CLI, GitHub Copilot, and Cursor installations
    * @param workspaceRoot - The workspace root directory
    * @returns Promise resolving to detected agent ID or null
    */
@@ -80,6 +80,20 @@ declare class CodingAgentService {
     name: string;
     description: string;
   }>;
+  /**
+   * Get the coding agent service instance
+   * @param agent - The coding agent to get service for
+   * @returns The service instance or null if not supported
+   */
+  private getCodingAgentService;
+  /**
+   * Update custom instructions/prompts for the coding agent
+   * Appends custom instruction prompt to the agent's configuration
+   * @param agent - The coding agent to update
+   * @param instructionPrompt - The instruction prompt to append
+   * @param customInstructionFile - Optional custom file path to write instructions to (e.g., '.claude/aicode-instructions.md')
+   */
+  updateCustomInstructions(agent: CodingAgent, instructionPrompt: string, customInstructionFile?: string): Promise<void>;
   /**
    * Setup MCP configuration for the selected coding agent
    * @param agent - The coding agent to configure

package/dist/index.js

@@ -1,4 +1,4 @@
 import "./mcp-BmhiAfeF.js";
-import { BANNER_GRADIENT, CodingAgentService, NewProjectService, THEME, TemplateSelectionService, TemplatesService, cloneRepository, cloneSubdirectory, displayBanner, displayCompactBanner, fetchGitHubDirectoryContents, findWorkspaceRoot, gitInit, parseGitHubUrl } from "./services-DNldrNnu.js";
+import { BANNER_GRADIENT, CodingAgentService, NewProjectService, THEME, TemplateSelectionService, TemplatesService, cloneRepository, cloneSubdirectory, displayBanner, displayCompactBanner, fetchGitHubDirectoryContents, findWorkspaceRoot, gitInit, parseGitHubUrl } from "./services-zrdafWTg.js";
 
 export { BANNER_GRADIENT, CodingAgentService, NewProjectService, THEME, TemplateSelectionService, TemplatesService, cloneRepository, cloneSubdirectory, displayBanner, displayCompactBanner, fetchGitHubDirectoryContents, findWorkspaceRoot, gitInit, parseGitHubUrl };

package/dist/{services-s1vmufE4.cjs → services-C6lqyioO.cjs}

@@ -35,6 +35,10 @@ let execa = require("execa");
 execa = __toESM(execa);
 let __agiflowai_coding_agent_bridge = require("@agiflowai/coding-agent-bridge");
 __agiflowai_coding_agent_bridge = __toESM(__agiflowai_coding_agent_bridge);
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = __toESM(node_fs_promises);
+let liquidjs = require("liquidjs");
+liquidjs = __toESM(liquidjs);
 let node_os = require("node:os");
 node_os = __toESM(node_os);
 
@@ -194,11 +198,11 @@ function parseGitHubUrl(url) {
 	if (treeMatch || blobMatch) {
 		const match = treeMatch || blobMatch;
 		return {
-			owner: match[1],
-			repo: match[2],
-			repoUrl: `https://github.com/${match[1]}/${match[2]}.git`,
-			branch: match[3],
-			subdirectory: match[4],
+			owner: match?.[1],
+			repo: match?.[2],
+			repoUrl: `https://github.com/${match?.[1]}/${match?.[2]}.git`,
+			branch: match?.[3],
+			subdirectory: match?.[4],
 			isSubdirectory: true
 		};
 	}
@@ -264,8 +268,8 @@ async function cloneRepository(repoUrl, targetFolder) {
 /**
 * Fetch directory listing from GitHub API
 */
-async function fetchGitHubDirectoryContents(owner, repo, path$3, branch = "main") {
-	const url = `https://api.github.com/repos/${owner}/${repo}/contents/${path$3}?ref=${branch}`;
+async function fetchGitHubDirectoryContents(owner, repo, path$4, branch = "main") {
+	const url = `https://api.github.com/repos/${owner}/${repo}/contents/${path$4}?ref=${branch}`;
 	const response = await fetch(url, { headers: {
 		Accept: "application/vnd.github.v3+json",
 		"User-Agent": "scaffold-mcp"
@@ -289,12 +293,14 @@ var CodingAgentService = class {
 	}
 	/**
 	* Detect which coding agent is enabled in the workspace
-	* Checks for Claude Code, Codex, and Gemini CLI installations
+	* Checks for Claude Code, Codex, Gemini CLI, GitHub Copilot, and Cursor installations
 	* @param workspaceRoot - The workspace root directory
 	* @returns Promise resolving to detected agent ID or null
 	*/
 	static async detectCodingAgent(workspaceRoot) {
 		if (await new __agiflowai_coding_agent_bridge.ClaudeCodeService({ workspaceRoot }).isEnabled()) return __agiflowai_coding_agent_bridge.CLAUDE_CODE;
+		if (await new __agiflowai_coding_agent_bridge.CursorService({ workspaceRoot }).isEnabled()) return __agiflowai_coding_agent_bridge.CURSOR;
+		if (await new __agiflowai_coding_agent_bridge.GitHubCopilotService({ workspaceRoot }).isEnabled()) return __agiflowai_coding_agent_bridge.GITHUB_COPILOT;
 		if (await new __agiflowai_coding_agent_bridge.CodexService({ workspaceRoot }).isEnabled()) return __agiflowai_coding_agent_bridge.CODEX;
 		if (await new __agiflowai_coding_agent_bridge.GeminiCliService({ workspaceRoot }).isEnabled()) return __agiflowai_coding_agent_bridge.GEMINI_CLI;
 		return null;
@@ -309,6 +315,16 @@ var CodingAgentService = class {
 				name: "Claude Code",
 				description: "Anthropic Claude Code CLI agent"
 			},
+			{
+				value: __agiflowai_coding_agent_bridge.CURSOR,
+				name: "Cursor",
+				description: "Cursor AI-first code editor"
+			},
+			{
+				value: __agiflowai_coding_agent_bridge.GITHUB_COPILOT,
+				name: "GitHub Copilot",
+				description: "GitHub Copilot coding agent and CLI"
+			},
 			{
 				value: __agiflowai_coding_agent_bridge.CODEX,
 				name: "Codex",
@@ -327,6 +343,48 @@ var CodingAgentService = class {
 		];
 	}
 	/**
+	* Get the coding agent service instance
+	* @param agent - The coding agent to get service for
+	* @returns The service instance or null if not supported
+	*/
+	getCodingAgentService(agent) {
+		if (agent === __agiflowai_coding_agent_bridge.CLAUDE_CODE) return new __agiflowai_coding_agent_bridge.ClaudeCodeService({ workspaceRoot: this.workspaceRoot });
+		if (agent === __agiflowai_coding_agent_bridge.CURSOR) return new __agiflowai_coding_agent_bridge.CursorService({ workspaceRoot: this.workspaceRoot });
+		if (agent === __agiflowai_coding_agent_bridge.GITHUB_COPILOT) return new __agiflowai_coding_agent_bridge.GitHubCopilotService({ workspaceRoot: this.workspaceRoot });
+		if (agent === __agiflowai_coding_agent_bridge.CODEX) return new __agiflowai_coding_agent_bridge.CodexService({ workspaceRoot: this.workspaceRoot });
+		if (agent === __agiflowai_coding_agent_bridge.GEMINI_CLI) return new __agiflowai_coding_agent_bridge.GeminiCliService({ workspaceRoot: this.workspaceRoot });
+		return null;
+	}
+	/**
+	* Update custom instructions/prompts for the coding agent
+	* Appends custom instruction prompt to the agent's configuration
+	* @param agent - The coding agent to update
+	* @param instructionPrompt - The instruction prompt to append
+	* @param customInstructionFile - Optional custom file path to write instructions to (e.g., '.claude/aicode-instructions.md')
+	*/
+	async updateCustomInstructions(agent, instructionPrompt, customInstructionFile) {
+		if (agent === __agiflowai_coding_agent_bridge.NONE) {
+			__agiflowai_aicode_utils.print.info("Skipping custom instruction update");
+			return;
+		}
+		__agiflowai_aicode_utils.print.info(`\nUpdating custom instructions for ${agent}...`);
+		const service = this.getCodingAgentService(agent);
+		if (!service) {
+			__agiflowai_aicode_utils.print.info(`Custom instruction update for ${agent} is not yet supported.`);
+			__agiflowai_aicode_utils.print.info("Please manually add the instructions to your agent configuration.");
+			__agiflowai_aicode_utils.print.info("\nInstruction prompt to add:");
+			__agiflowai_aicode_utils.print.info(instructionPrompt);
+			return;
+		}
+		await service.updatePrompt({
+			systemPrompt: instructionPrompt,
+			customInstructionFile,
+			marker: true
+		});
+		if (customInstructionFile) __agiflowai_aicode_utils.print.success(`Custom instructions written to ${customInstructionFile} and referenced in CLAUDE.md and AGENTS.md`);
+		else __agiflowai_aicode_utils.print.success(`Custom instructions appended to CLAUDE.md and AGENTS.md`);
+	}
+	/**
 	* Setup MCP configuration for the selected coding agent
 	* @param agent - The coding agent to configure
 	*/
@@ -336,19 +394,22 @@ var CodingAgentService = class {
 			return;
 		}
 		__agiflowai_aicode_utils.print.info(`\nSetting up MCP for ${agent}...`);
-		let service = null;
+		const service = this.getCodingAgentService(agent);
 		let configLocation = "";
 		let restartInstructions = "";
 		if (agent === __agiflowai_coding_agent_bridge.CLAUDE_CODE) {
-			service = new __agiflowai_coding_agent_bridge.ClaudeCodeService({ workspaceRoot: this.workspaceRoot });
 			configLocation = ".mcp.json";
 			restartInstructions = "Restart Claude Code to load the new MCP servers";
+		} else if (agent === __agiflowai_coding_agent_bridge.CURSOR) {
+			configLocation = "~/.cursor/mcp.json (or .cursor/mcp.json for workspace)";
+			restartInstructions = "Restart Cursor to load the new MCP servers";
+		} else if (agent === __agiflowai_coding_agent_bridge.GITHUB_COPILOT) {
+			configLocation = "~/.copilot/config.json (CLI) or GitHub UI (Coding Agent)";
+			restartInstructions = "Restart GitHub Copilot CLI or configure via GitHub repository settings";
 		} else if (agent === __agiflowai_coding_agent_bridge.CODEX) {
-			service = new __agiflowai_coding_agent_bridge.CodexService({ workspaceRoot: this.workspaceRoot });
 			configLocation = "~/.codex/config.toml";
 			restartInstructions = "Restart Codex CLI to load the new MCP servers";
 		} else if (agent === __agiflowai_coding_agent_bridge.GEMINI_CLI) {
-			service = new __agiflowai_coding_agent_bridge.GeminiCliService({ workspaceRoot: this.workspaceRoot });
 			configLocation = "~/.gemini/settings.json";
 			restartInstructions = "Restart Gemini CLI to load the new MCP servers";
 		}
@@ -463,7 +524,6 @@ var NewProjectService = class {
 	async createProjectDirectory(projectPath, projectName) {
 		try {
 			await fs_extra.mkdir(projectPath, { recursive: false });
-			__agiflowai_aicode_utils.print.success(`Created project directory: ${projectPath}`);
 		} catch (error) {
 			if (error.code === "EEXIST") throw new Error(`Directory '${projectName}' already exists. Please choose a different name.`);
 			throw error;
@@ -475,12 +535,10 @@ var NewProjectService = class {
 	* @param projectPath - Destination path for the cloned repository
 	*/
 	async cloneExistingRepository(repoUrl, projectPath) {
-		__agiflowai_aicode_utils.print.info("Cloning repository...");
 		try {
 			const parsed = parseGitHubUrl(repoUrl.trim());
 			if (parsed.isSubdirectory && parsed.branch && parsed.subdirectory) await cloneSubdirectory(parsed.repoUrl, parsed.branch, parsed.subdirectory, projectPath);
 			else await cloneRepository(parsed.repoUrl, projectPath);
-			__agiflowai_aicode_utils.print.success("Repository cloned successfully");
 		} catch (error) {
 			await fs_extra.remove(projectPath);
 			throw new Error(`Failed to clone repository: ${error.message}`);
@@ -491,10 +549,8 @@ var NewProjectService = class {
 	* @param projectPath - Path where git repository should be initialized
 	*/
 	async initializeGitRepository(projectPath) {
-		__agiflowai_aicode_utils.print.info("Initializing Git repository...");
 		try {
 			await gitInit(projectPath);
-			__agiflowai_aicode_utils.print.success("Git repository initialized");
 		} catch (error) {
 			__agiflowai_aicode_utils.messages.warning(`Failed to initialize Git: ${error.message}`);
 		}
@@ -511,6 +567,153 @@ var NewProjectService = class {
 	}
 };
 
+//#endregion
+//#region src/instructions/specs/openspec.md?raw
+var openspec_default = "When working on this project, follow the OpenSpec spec-driven development workflow{% if scaffoldMcp or architectMcp %} integrated with MCP tools{% endif %}.\n\n{% if scaffoldMcp %}\n\n## {% if scaffoldMcp %}1{% else %}1{% endif %}. Create Proposals with scaffold-mcp\n\nWhen implementing new features or changes, use scaffold-mcp MCP tools:\n\n**For new projects/features:**\n1. Use `list-boilerplates` MCP tool to see available templates\n2. Use `use-boilerplate` MCP tool to scaffold new projects{% if projectType == 'monolith' %} (set `monolith: true`){% elsif projectType == 'monorepo' %} (omit `monolith` parameter){% endif %}\n3. Use `list-scaffolding-methods` MCP tool to understand which methods can be used to add features\n4. Create OpenSpec proposal with available scaffolding methods in mind: \"Create an OpenSpec proposal for [feature description]\"\n\n**For adding features to existing code:**\n1. Use `list-scaffolding-methods` MCP tool with projectPath to see available features{% if projectType == 'monolith' %} (`projectPath` = workspace root){% elsif projectType == 'monorepo' %} (`projectPath` = project directory with project.json){% endif %}\n2. Review available methods and plan which ones to use for the feature\n3. Use `use-scaffold-method` MCP tool to generate boilerplate code\n4. Create OpenSpec proposal to capture the specs\n{% if projectType %}\n\n**Path Mapping ({% if projectType == 'monolith' %}Monolith{% else %}Monorepo{% endif %} Project):**\n{% if projectType == 'monolith' %}\n*This is a monolith project:*\n- Single project at workspace root\n- Config file: `toolkit.yaml` at root\n- All code in workspace root (src/, lib/, etc.)\n- When scaffolding: Use `monolith: true` parameter\n- When using scaffold methods: `projectPath` = workspace root\n\nExample: For workspace at `/path/to/project`:\n- Project config: `/path/to/project/toolkit.yaml`\n- Source code: `/path/to/project/src/`\n- OpenSpec: `/path/to/project/openspec/`\n{% else %}\n*This is a monorepo project:*\n- Multiple projects in subdirectories\n- Config file: `project.json` in each project\n- Projects in apps/, packages/, libs/, etc.\n- When scaffolding: Omit `monolith` parameter (defaults to false)\n- When using scaffold methods: `projectPath` = path to specific project\n\nExample: For workspace at `/path/to/workspace`:\n- App config: `/path/to/workspace/apps/my-app/project.json`\n- App source: `/path/to/workspace/apps/my-app/src/`\n- OpenSpec: `/path/to/workspace/openspec/` (workspace-level)\n{% endif %}\n{% endif %}\n\nAI will scaffold: openspec/changes/[feature-name]/ with proposal.md, tasks.md, and spec deltas\n{% endif %}\n{% if architectMcp %}\n\n## {% if scaffoldMcp %}2{% else %}1{% endif %}. Review & Validate with architect-mcp\n\nBefore and after editing files, use architect-mcp MCP tools:\n\n**Before editing:**\n- Use `get-file-design-pattern` MCP tool to understand:\n  - Applicable design patterns from architect.yaml\n  - Coding rules from RULES.yaml (must_do, should_do, must_not_do)\n  - Code examples showing the patterns\n\n**After editing:**\n- Use `review-code-change` MCP tool to check for:\n  - Must not do violations (critical issues)\n  - Must do missing (required patterns not followed)\n  - Should do suggestions (best practices)\n\n**Validate OpenSpec specs:**\n- Use `openspec validate [feature-name]` to check spec formatting\n- Iterate with AI until specs are agreed upon\n{% endif %}\n\n## {% if scaffoldMcp and architectMcp %}3{% elsif scaffoldMcp or architectMcp %}2{% else %}1{% endif %}. Implement{% if architectMcp %} with MCP-Guided Development{% endif %}\n\nDuring implementation:\n1. Ask AI to implement: \"Apply the OpenSpec change [feature-name]\"\n{% if architectMcp %}\n2. **Before each file edit**: Use `get-file-design-pattern` to understand patterns\n3. AI implements tasks from tasks.md following design patterns\n4. **After each file edit**: Use `review-code-change` to verify compliance\n5. Fix any violations before proceeding\n{% else %}\n2. AI implements tasks from tasks.md following the agreed specs\n{% endif %}\n\n## {% if scaffoldMcp and architectMcp %}4{% elsif scaffoldMcp or architectMcp %}3{% else %}2{% endif %}. Archive Completed Changes\n{% if scaffoldMcp or architectMcp %}\n\n## MCP Tools Reference\n{% endif %}\n{% if scaffoldMcp %}\n\n### scaffold-mcp\n- `list-boilerplates` - List available project templates\n- `use-boilerplate` - Create new project from template\n- `list-scaffolding-methods` - List features for existing project\n- `use-scaffold-method` - Add feature to existing project\n{% endif %}\n{% if architectMcp %}\n\n### architect-mcp\n- `get-file-design-pattern` - Get design patterns for file\n- `review-code-change` - Review code for violations\n{% endif %}\n\n## Workflow Summary\n\n{% if scaffoldMcp %}\n1. **Plan**: Use scaffold-mcp to generate boilerplate + OpenSpec proposal for specs\n{% else %}\n1. **Plan**: Create OpenSpec proposal with specs\n{% endif %}\n{% if architectMcp %}\n{% if scaffoldMcp %}2{% else %}2{% endif %}. **Design**: Use architect-mcp to understand patterns before editing\n{% endif %}\n{% if scaffoldMcp and architectMcp %}3{% elsif scaffoldMcp or architectMcp %}{% if architectMcp %}3{% else %}2{% endif %}{% else %}2{% endif %}. **Implement**: Follow specs{% if architectMcp %} and patterns{% endif %}\n{% if architectMcp %}\n{% if scaffoldMcp %}4{% else %}4{% endif %}. **Review**: Use architect-mcp to validate code quality\n{% endif %}\n{% if scaffoldMcp and architectMcp %}5{% elsif scaffoldMcp or architectMcp %}{% if architectMcp %}5{% else %}3{% endif %}{% else %}3{% endif %}. **Archive**: Merge specs into source of truth\n";
+
+//#endregion
+//#region src/specs/openspec.ts
+/**
+* OpenSpec configuration
+*/
+const OPENSPEC_CONFIG = {
+	folderName: "openspec",
+	packageName: "@fission-ai/openspec",
+	name: "OpenSpec",
+	description: "Spec-driven development for AI coding assistants"
+};
+/**
+* Bridge implementation for OpenSpec
+*
+* Provides integration with OpenSpec spec tool through a standardized interface.
+*/
+var OpenSpecBridge = class {
+	/**
+	* Check if OpenSpec is enabled/installed in the workspace
+	*
+	* @param workspaceRoot - Absolute path to the workspace root directory
+	* @returns Promise resolving to true if OpenSpec folder exists, false otherwise
+	*/
+	async isEnabled(workspaceRoot) {
+		try {
+			const openspecPath = node_path.default.join(workspaceRoot, OPENSPEC_CONFIG.folderName);
+			await node_fs_promises.default.access(openspecPath);
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	/**
+	* Initialize OpenSpec in the workspace
+	*
+	* Runs `npx @fission-ai/openspec init` interactively, allowing the user
+	* to configure OpenSpec during setup.
+	*
+	* @param workspaceRoot - Absolute path to the workspace root directory
+	* @throws Error if initialization fails
+	*/
+	async initialize(workspaceRoot) {
+		try {
+			await (0, execa.execa)("npx", [OPENSPEC_CONFIG.packageName, "init"], {
+				cwd: workspaceRoot,
+				stdio: "inherit"
+			});
+		} catch (error) {
+			throw new Error(`Failed to initialize ${OPENSPEC_CONFIG.name}: ${error.message}`);
+		}
+	}
+	/**
+	* Generate agent instruction prompt for OpenSpec with MCP integration
+	*
+	* Creates a comprehensive instruction prompt that guides AI agents to use
+	* spec-driven development workflow with OpenSpec, leveraging enabled MCP servers.
+	*
+	* @param enabledMcps - Configuration of which MCP servers are enabled
+	* @returns Promise resolving to the instruction prompt string
+	*/
+	async updateInstruction(enabledMcps) {
+		return (await new liquidjs.Liquid().parseAndRender(openspec_default, enabledMcps)).trim();
+	}
+};
+
+//#endregion
+//#region src/services/SpecToolService.ts
+/**
+* Available spec tools
+*/
+let SpecTool = /* @__PURE__ */ function(SpecTool$1) {
+	SpecTool$1["OPENSPEC"] = "openspec";
+	return SpecTool$1;
+}({});
+/**
+* Spec tool information
+*/
+const SPEC_TOOL_INFO = { [SpecTool.OPENSPEC]: {
+	name: "OpenSpec",
+	description: "Spec-driven development for AI coding assistants",
+	docUrl: "https://github.com/Fission-AI/OpenSpec"
+} };
+/**
+* Service for managing spec tools (e.g., OpenSpec)
+*
+* This service acts as a facade for spec tool operations, using bridge
+* implementations to interact with specific spec tools.
+*/
+var SpecToolService = class {
+	bridge;
+	constructor(workspaceRoot, specTool = SpecTool.OPENSPEC, codingAgentService) {
+		this.workspaceRoot = workspaceRoot;
+		this.codingAgentService = codingAgentService;
+		this.bridge = this.createBridge(specTool);
+	}
+	/**
+	* Create a bridge instance for the specified spec tool
+	*/
+	createBridge(specTool) {
+		switch (specTool) {
+			case SpecTool.OPENSPEC: return new OpenSpecBridge();
+			default: throw new Error(`Unsupported spec tool: ${specTool}`);
+		}
+	}
+	/**
+	* Detect if a spec tool is installed in the workspace
+	*/
+	async detectSpecTool() {
+		try {
+			return await this.bridge.isEnabled(this.workspaceRoot) ? SpecTool.OPENSPEC : null;
+		} catch (error) {
+			__agiflowai_aicode_utils.print.error(`Error detecting spec tool: ${error.message}`);
+			return null;
+		}
+	}
+	/**
+	* Initialize the spec tool in the workspace
+	*/
+	async initializeSpec() {
+		await this.bridge.initialize(this.workspaceRoot);
+	}
+	/**
+	* Update spec tool agent instructions
+	*
+	* Generates instruction prompt and updates the coding agent's custom instructions
+	*
+	* @param enabledMcps - Configuration of which MCP servers are enabled
+	* @param codingAgent - The coding agent to update instructions for
+	* @param customInstructionFile - Optional custom file to write instructions to (e.g., '.claude/aicode-instructions.md')
+	* @returns Promise resolving to the instruction prompt string
+	*/
+	async updateInstructions(enabledMcps, codingAgent, customInstructionFile) {
+		const prompt = await this.bridge.updateInstruction(enabledMcps);
+		if (this.codingAgentService && codingAgent) await this.codingAgentService.updateCustomInstructions(codingAgent, prompt, customInstructionFile ?? ".claude/aicode-instructions.md");
+		else {
+			__agiflowai_aicode_utils.print.info("\nGenerated OpenSpec instruction prompt:");
+			__agiflowai_aicode_utils.print.info("\nYou can append this to your CLAUDE.md or agent config file:");
+			__agiflowai_aicode_utils.print.info(`\n${prompt}`);
+		}
+		return prompt;
+	}
+};
+
 //#endregion
 //#region src/services/TemplateSelectionService.ts
 var TemplateSelectionService = class {
@@ -524,7 +727,6 @@ var TemplateSelectionService = class {
 	* @returns Path to the tmp directory containing templates
 	*/
 	async downloadTemplatesToTmp(repoConfig) {
-		__agiflowai_aicode_utils.print.info(`Downloading templates from ${repoConfig.owner}/${repoConfig.repo}...`);
 		try {
 			await fs_extra.ensureDir(this.tmpDir);
 			const contents = await fetchGitHubDirectoryContents(repoConfig.owner, repoConfig.repo, repoConfig.path, repoConfig.branch);
@@ -677,10 +879,7 @@ var TemplateSelectionService = class {
 	*/
 	async cleanup() {
 		try {
-			if (await fs_extra.pathExists(this.tmpDir)) {
-				await fs_extra.remove(this.tmpDir);
-				__agiflowai_aicode_utils.print.info("Cleaned up temporary files");
-			}
+			if (await fs_extra.pathExists(this.tmpDir)) await fs_extra.remove(this.tmpDir);
 		} catch (error) {
 			__agiflowai_aicode_utils.print.warning(`Warning: Failed to clean up tmp directory: ${error.message}`);
 		}
@@ -704,19 +903,19 @@ var TemplatesService = class {
 				return;
 			}
 			__agiflowai_aicode_utils.print.info(`Found ${templateDirs.length} template(s)`);
-			let downloaded = 0;
-			let skipped = 0;
+			let _downloaded = 0;
+			let _skipped = 0;
 			for (const template of templateDirs) {
 				const targetFolder = node_path.default.join(templatesPath, template.name);
 				if (await fs_extra.pathExists(targetFolder)) {
 					__agiflowai_aicode_utils.print.info(`Skipping ${template.name} (already exists)`);
-					skipped++;
+					_skipped++;
 					continue;
 				}
 				__agiflowai_aicode_utils.print.info(`Downloading ${template.name}...`);
 				await cloneSubdirectory(`https://github.com/${repoConfig.owner}/${repoConfig.repo}.git`, repoConfig.branch, template.path, targetFolder);
 				__agiflowai_aicode_utils.print.success(`Downloaded ${template.name}`);
-				downloaded++;
+				_downloaded++;
 			}
 			__agiflowai_aicode_utils.print.success("\nAll templates downloaded successfully!");
 		} catch (error) {
@@ -785,6 +984,24 @@ Object.defineProperty(exports, 'NewProjectService', {
     return NewProjectService;
   }
 });
+Object.defineProperty(exports, 'SPEC_TOOL_INFO', {
+  enumerable: true,
+  get: function () {
+    return SPEC_TOOL_INFO;
+  }
+});
+Object.defineProperty(exports, 'SpecTool', {
+  enumerable: true,
+  get: function () {
+    return SpecTool;
+  }
+});
+Object.defineProperty(exports, 'SpecToolService', {
+  enumerable: true,
+  get: function () {
+    return SpecToolService;
+  }
+});
 Object.defineProperty(exports, 'THEME', {
   enumerable: true,
   get: function () {