@agiflowai/aicode-toolkit 0.6.0

package/dist/index.cjs

@@ -0,0 +1,17 @@
+const require_services = require('./services-s1vmufE4.cjs');
+require('./mcp-Dwt8nYQV.cjs');
+
+exports.BANNER_GRADIENT = require_services.BANNER_GRADIENT;
+exports.CodingAgentService = require_services.CodingAgentService;
+exports.NewProjectService = require_services.NewProjectService;
+exports.THEME = require_services.THEME;
+exports.TemplateSelectionService = require_services.TemplateSelectionService;
+exports.TemplatesService = require_services.TemplatesService;
+exports.cloneRepository = require_services.cloneRepository;
+exports.cloneSubdirectory = require_services.cloneSubdirectory;
+exports.displayBanner = require_services.displayBanner;
+exports.displayCompactBanner = require_services.displayCompactBanner;
+exports.fetchGitHubDirectoryContents = require_services.fetchGitHubDirectoryContents;
+exports.findWorkspaceRoot = require_services.findWorkspaceRoot;
+exports.gitInit = require_services.gitInit;
+exports.parseGitHubUrl = require_services.parseGitHubUrl;

package/dist/index.d.cts

@@ -0,0 +1,282 @@
+import { CodingAgentId } from "@agiflowai/coding-agent-bridge";
+import { ProjectType } from "@agiflowai/aicode-utils";
+
+//#region src/constants/theme.d.ts
+/**
+ * Theme color constants for AICode Toolkit
+ * Defines the brand color palette used throughout the CLI
+ */
+declare const THEME: {
+  readonly colors: {
+    readonly primary: {
+      readonly default: "#10b981";
+      readonly dark: "#059669";
+      readonly text: "#ffffff";
+    };
+    readonly secondary: {
+      readonly default: "#0d9488";
+      readonly dark: "#0f766e";
+      readonly light: "#14b8a6";
+      readonly text: "#ffffff";
+    };
+    readonly accent: {
+      readonly default: "#c44569";
+      readonly dark: "#c44569";
+      readonly text: "#2a0b14";
+    };
+    readonly semantic: {
+      readonly info: "#5fb3d4";
+      readonly success: "#5fb368";
+      readonly error: "#d45959";
+      readonly alert: "#d4b359";
+    };
+    readonly cta: {
+      readonly from: "#10b981";
+      readonly to: "#0d9488";
+      readonly text: "#ffffff";
+    };
+    readonly transparent: "rgba(0, 0, 0, 0)";
+    readonly white: "#c4cccf";
+    readonly black: "#424549";
+    readonly background: {
+      readonly dark: {
+        readonly default: "#0f0f0f";
+        readonly shade: "#141414";
+        readonly dark: "#0a0a0a";
+        readonly light: "#1a1a1a";
+      };
+      readonly light: {
+        readonly default: "#fff";
+        readonly shade: "#EAEAEA";
+        readonly dark: "#17202a";
+        readonly light: "#EAEAEA";
+      };
+    };
+  };
+};
+/**
+ * Gradient colors for banner (primary green -> secondary teal)
+ */
+declare const BANNER_GRADIENT: ("#10b981" | "#059669" | "#0d9488" | "#0f766e")[];
+//#endregion
+//#region src/services/CodingAgentService.d.ts
+
+type CodingAgent = CodingAgentId;
+declare class CodingAgentService {
+  private workspaceRoot;
+  constructor(workspaceRoot: string);
+  /**
+   * Detect which coding agent is enabled in the workspace
+   * Checks for Claude Code, Codex, and Gemini CLI installations
+   * @param workspaceRoot - The workspace root directory
+   * @returns Promise resolving to detected agent ID or null
+   */
+  static detectCodingAgent(workspaceRoot: string): Promise<CodingAgent | null>;
+  /**
+   * Get available coding agents with their descriptions
+   */
+  static getAvailableAgents(): Array<{
+    value: CodingAgent;
+    name: string;
+    description: string;
+  }>;
+  /**
+   * Setup MCP configuration for the selected coding agent
+   * @param agent - The coding agent to configure
+   */
+  setupMCP(agent: CodingAgent): Promise<void>;
+}
+//#endregion
+//#region src/services/NewProjectService.d.ts
+declare class NewProjectService {
+  private readonly providedName?;
+  private readonly providedProjectType?;
+  constructor(providedName?: string, providedProjectType?: string);
+  /**
+   * Validate project name against naming rules
+   * @param value - Project name to validate
+   * @returns true if valid, error message string if invalid
+   */
+  validateProjectName(value: string): true | string;
+  /**
+   * Validate project type
+   * @param projectType - Project type to validate
+   * @throws Error if invalid project type
+   */
+  validateProjectType(projectType: string): void;
+  /**
+   * Get the provided name from constructor
+   */
+  getProvidedName(): string | undefined;
+  /**
+   * Get the provided project type from constructor
+   */
+  getProvidedProjectType(): string | undefined;
+  /**
+   * Create project directory atomically
+   * @param projectPath - Full path where project should be created
+   * @param projectName - Name of the project (for error messages)
+   */
+  createProjectDirectory(projectPath: string, projectName: string): Promise<void>;
+  /**
+   * Clone an existing Git repository
+   * @param repoUrl - Repository URL to clone
+   * @param projectPath - Destination path for the cloned repository
+   */
+  cloneExistingRepository(repoUrl: string, projectPath: string): Promise<void>;
+  /**
+   * Initialize a new Git repository
+   * @param projectPath - Path where git repository should be initialized
+   */
+  initializeGitRepository(projectPath: string): Promise<void>;
+  /**
+   * Validate repository URL format
+   * @param value - Repository URL to validate
+   * @returns true if valid, error message string if invalid
+   */
+  validateRepositoryUrl(value: string): true | string;
+}
+//#endregion
+//#region src/services/TemplatesService.d.ts
+/**
+ * TemplatesService
+ *
+ * DESIGN PATTERNS:
+ * - Service pattern for business logic encapsulation
+ * - Single responsibility principle
+ *
+ * CODING STANDARDS:
+ * - Use async/await for asynchronous operations
+ * - Throw descriptive errors for error cases
+ * - Keep methods focused and well-named
+ * - Document complex logic with comments
+ *
+ * AVOID:
+ * - Mixing concerns (keep focused on single domain)
+ * - Direct tool implementation (services should be tool-agnostic)
+ */
+interface TemplateRepoConfig {
+  owner: string;
+  repo: string;
+  branch: string;
+  path: string;
+}
+declare class TemplatesService {
+  /**
+   * Download templates from a GitHub repository with UI feedback
+   * @param templatesPath - Local path where templates should be downloaded
+   * @param repoConfig - Repository configuration (owner, repo, branch, path)
+   */
+  downloadTemplates(templatesPath: string, repoConfig: TemplateRepoConfig): Promise<void>;
+  /**
+   * Initialize templates folder with README
+   * @param templatesPath - Path where templates folder should be created
+   */
+  initializeTemplatesFolder(templatesPath: string): Promise<void>;
+}
+//#endregion
+//#region src/services/TemplateSelectionService.d.ts
+interface TemplateInfo {
+  name: string;
+  path: string;
+  description?: string;
+}
+declare class TemplateSelectionService {
+  private tmpDir;
+  constructor(existingTmpDir?: string);
+  /**
+   * Download templates to OS tmp directory
+   * @param repoConfig - Repository configuration
+   * @returns Path to the tmp directory containing templates
+   */
+  downloadTemplatesToTmp(repoConfig: TemplateRepoConfig): Promise<string>;
+  /**
+   * List available templates in the tmp directory
+   * @returns Array of template information
+   */
+  listTemplates(): Promise<TemplateInfo[]>;
+  /**
+   * Copy selected templates to destination
+   * @param templateNames - Names of templates to copy
+   * @param destinationPath - Destination templates folder path
+   * @param projectType - Project type (monolith allows only single template)
+   * @param selectedMcpServers - Optional array of selected MCP servers to filter files
+   */
+  copyTemplates(templateNames: string[], destinationPath: string, projectType: ProjectType, selectedMcpServers?: string[]): Promise<void>;
+  /**
+   * Copy template files with MCP server filtering
+   * @param sourcePath - Source template path
+   * @param targetPath - Target template path
+   * @param selectedMcpServers - Selected MCP servers
+   */
+  private copyTemplateWithMcpFilter;
+  /**
+   * Read template description from README or scaffold.yaml
+   * @param templatePath - Path to the template directory
+   * @returns Description string or undefined
+   */
+  private readTemplateDescription;
+  /**
+   * Get the tmp directory path
+   */
+  getTmpDir(): string;
+  /**
+   * Clean up tmp directory
+   */
+  cleanup(): Promise<void>;
+}
+//#endregion
+//#region src/utils/banner.d.ts
+/**
+ * Displays the AICode Toolkit banner with gradient effect
+ * Uses gradient-string with theme colors (primary green -> secondary teal)
+ */
+declare function displayBanner(): void;
+/**
+ * Simplified banner for compact display
+ */
+declare function displayCompactBanner(): void;
+//#endregion
+//#region src/utils/git.d.ts
+/**
+ * Execute git init safely using execa to prevent command injection
+ */
+declare function gitInit(projectPath: string): Promise<void>;
+/**
+ * Find the workspace root by searching upwards for .git folder
+ * Returns null if no .git folder is found (indicating a new project setup is needed)
+ */
+declare function findWorkspaceRoot(startPath?: string): Promise<string | null>;
+/**
+ * Parse GitHub URL to detect if it's a subdirectory
+ * Supports formats:
+ * - https://github.com/user/repo
+ * - https://github.com/user/repo/tree/branch/path/to/dir
+ * - https://github.com/user/repo/tree/main/path/to/dir
+ */
+declare function parseGitHubUrl(url: string): {
+  owner?: string;
+  repo?: string;
+  repoUrl: string;
+  branch?: string;
+  subdirectory?: string;
+  isSubdirectory: boolean;
+};
+/**
+ * Clone a subdirectory from a git repository using sparse checkout
+ */
+declare function cloneSubdirectory(repoUrl: string, branch: string, subdirectory: string, targetFolder: string): Promise<void>;
+/**
+ * Clone entire repository
+ */
+declare function cloneRepository(repoUrl: string, targetFolder: string): Promise<void>;
+/**
+ * Fetch directory listing from GitHub API
+ */
+declare function fetchGitHubDirectoryContents(owner: string, repo: string, path: string, branch?: string): Promise<Array<{
+  name: string;
+  type: string;
+  path: string;
+}>>;
+//#endregion
+export { BANNER_GRADIENT, type CodingAgent, CodingAgentService, NewProjectService, THEME, TemplateSelectionService, TemplatesService, cloneRepository, cloneSubdirectory, displayBanner, displayCompactBanner, fetchGitHubDirectoryContents, findWorkspaceRoot, gitInit, parseGitHubUrl };

package/dist/index.d.ts

@@ -0,0 +1,282 @@
+import { ProjectType } from "@agiflowai/aicode-utils";
+import { CodingAgentId } from "@agiflowai/coding-agent-bridge";
+
+//#region src/constants/theme.d.ts
+/**
+ * Theme color constants for AICode Toolkit
+ * Defines the brand color palette used throughout the CLI
+ */
+declare const THEME: {
+  readonly colors: {
+    readonly primary: {
+      readonly default: "#10b981";
+      readonly dark: "#059669";
+      readonly text: "#ffffff";
+    };
+    readonly secondary: {
+      readonly default: "#0d9488";
+      readonly dark: "#0f766e";
+      readonly light: "#14b8a6";
+      readonly text: "#ffffff";
+    };
+    readonly accent: {
+      readonly default: "#c44569";
+      readonly dark: "#c44569";
+      readonly text: "#2a0b14";
+    };
+    readonly semantic: {
+      readonly info: "#5fb3d4";
+      readonly success: "#5fb368";
+      readonly error: "#d45959";
+      readonly alert: "#d4b359";
+    };
+    readonly cta: {
+      readonly from: "#10b981";
+      readonly to: "#0d9488";
+      readonly text: "#ffffff";
+    };
+    readonly transparent: "rgba(0, 0, 0, 0)";
+    readonly white: "#c4cccf";
+    readonly black: "#424549";
+    readonly background: {
+      readonly dark: {
+        readonly default: "#0f0f0f";
+        readonly shade: "#141414";
+        readonly dark: "#0a0a0a";
+        readonly light: "#1a1a1a";
+      };
+      readonly light: {
+        readonly default: "#fff";
+        readonly shade: "#EAEAEA";
+        readonly dark: "#17202a";
+        readonly light: "#EAEAEA";
+      };
+    };
+  };
+};
+/**
+ * Gradient colors for banner (primary green -> secondary teal)
+ */
+declare const BANNER_GRADIENT: ("#10b981" | "#059669" | "#0d9488" | "#0f766e")[];
+//#endregion
+//#region src/services/CodingAgentService.d.ts
+
+type CodingAgent = CodingAgentId;
+declare class CodingAgentService {
+  private workspaceRoot;
+  constructor(workspaceRoot: string);
+  /**
+   * Detect which coding agent is enabled in the workspace
+   * Checks for Claude Code, Codex, and Gemini CLI installations
+   * @param workspaceRoot - The workspace root directory
+   * @returns Promise resolving to detected agent ID or null
+   */
+  static detectCodingAgent(workspaceRoot: string): Promise<CodingAgent | null>;
+  /**
+   * Get available coding agents with their descriptions
+   */
+  static getAvailableAgents(): Array<{
+    value: CodingAgent;
+    name: string;
+    description: string;
+  }>;
+  /**
+   * Setup MCP configuration for the selected coding agent
+   * @param agent - The coding agent to configure
+   */
+  setupMCP(agent: CodingAgent): Promise<void>;
+}
+//#endregion
+//#region src/services/NewProjectService.d.ts
+declare class NewProjectService {
+  private readonly providedName?;
+  private readonly providedProjectType?;
+  constructor(providedName?: string, providedProjectType?: string);
+  /**
+   * Validate project name against naming rules
+   * @param value - Project name to validate
+   * @returns true if valid, error message string if invalid
+   */
+  validateProjectName(value: string): true | string;
+  /**
+   * Validate project type
+   * @param projectType - Project type to validate
+   * @throws Error if invalid project type
+   */
+  validateProjectType(projectType: string): void;
+  /**
+   * Get the provided name from constructor
+   */
+  getProvidedName(): string | undefined;
+  /**
+   * Get the provided project type from constructor
+   */
+  getProvidedProjectType(): string | undefined;
+  /**
+   * Create project directory atomically
+   * @param projectPath - Full path where project should be created
+   * @param projectName - Name of the project (for error messages)
+   */
+  createProjectDirectory(projectPath: string, projectName: string): Promise<void>;
+  /**
+   * Clone an existing Git repository
+   * @param repoUrl - Repository URL to clone
+   * @param projectPath - Destination path for the cloned repository
+   */
+  cloneExistingRepository(repoUrl: string, projectPath: string): Promise<void>;
+  /**
+   * Initialize a new Git repository
+   * @param projectPath - Path where git repository should be initialized
+   */
+  initializeGitRepository(projectPath: string): Promise<void>;
+  /**
+   * Validate repository URL format
+   * @param value - Repository URL to validate
+   * @returns true if valid, error message string if invalid
+   */
+  validateRepositoryUrl(value: string): true | string;
+}
+//#endregion
+//#region src/services/TemplatesService.d.ts
+/**
+ * TemplatesService
+ *
+ * DESIGN PATTERNS:
+ * - Service pattern for business logic encapsulation
+ * - Single responsibility principle
+ *
+ * CODING STANDARDS:
+ * - Use async/await for asynchronous operations
+ * - Throw descriptive errors for error cases
+ * - Keep methods focused and well-named
+ * - Document complex logic with comments
+ *
+ * AVOID:
+ * - Mixing concerns (keep focused on single domain)
+ * - Direct tool implementation (services should be tool-agnostic)
+ */
+interface TemplateRepoConfig {
+  owner: string;
+  repo: string;
+  branch: string;
+  path: string;
+}
+declare class TemplatesService {
+  /**
+   * Download templates from a GitHub repository with UI feedback
+   * @param templatesPath - Local path where templates should be downloaded
+   * @param repoConfig - Repository configuration (owner, repo, branch, path)
+   */
+  downloadTemplates(templatesPath: string, repoConfig: TemplateRepoConfig): Promise<void>;
+  /**
+   * Initialize templates folder with README
+   * @param templatesPath - Path where templates folder should be created
+   */
+  initializeTemplatesFolder(templatesPath: string): Promise<void>;
+}
+//#endregion
+//#region src/services/TemplateSelectionService.d.ts
+interface TemplateInfo {
+  name: string;
+  path: string;
+  description?: string;
+}
+declare class TemplateSelectionService {
+  private tmpDir;
+  constructor(existingTmpDir?: string);
+  /**
+   * Download templates to OS tmp directory
+   * @param repoConfig - Repository configuration
+   * @returns Path to the tmp directory containing templates
+   */
+  downloadTemplatesToTmp(repoConfig: TemplateRepoConfig): Promise<string>;
+  /**
+   * List available templates in the tmp directory
+   * @returns Array of template information
+   */
+  listTemplates(): Promise<TemplateInfo[]>;
+  /**
+   * Copy selected templates to destination
+   * @param templateNames - Names of templates to copy
+   * @param destinationPath - Destination templates folder path
+   * @param projectType - Project type (monolith allows only single template)
+   * @param selectedMcpServers - Optional array of selected MCP servers to filter files
+   */
+  copyTemplates(templateNames: string[], destinationPath: string, projectType: ProjectType, selectedMcpServers?: string[]): Promise<void>;
+  /**
+   * Copy template files with MCP server filtering
+   * @param sourcePath - Source template path
+   * @param targetPath - Target template path
+   * @param selectedMcpServers - Selected MCP servers
+   */
+  private copyTemplateWithMcpFilter;
+  /**
+   * Read template description from README or scaffold.yaml
+   * @param templatePath - Path to the template directory
+   * @returns Description string or undefined
+   */
+  private readTemplateDescription;
+  /**
+   * Get the tmp directory path
+   */
+  getTmpDir(): string;
+  /**
+   * Clean up tmp directory
+   */
+  cleanup(): Promise<void>;
+}
+//#endregion
+//#region src/utils/banner.d.ts
+/**
+ * Displays the AICode Toolkit banner with gradient effect
+ * Uses gradient-string with theme colors (primary green -> secondary teal)
+ */
+declare function displayBanner(): void;
+/**
+ * Simplified banner for compact display
+ */
+declare function displayCompactBanner(): void;
+//#endregion
+//#region src/utils/git.d.ts
+/**
+ * Execute git init safely using execa to prevent command injection
+ */
+declare function gitInit(projectPath: string): Promise<void>;
+/**
+ * Find the workspace root by searching upwards for .git folder
+ * Returns null if no .git folder is found (indicating a new project setup is needed)
+ */
+declare function findWorkspaceRoot(startPath?: string): Promise<string | null>;
+/**
+ * Parse GitHub URL to detect if it's a subdirectory
+ * Supports formats:
+ * - https://github.com/user/repo
+ * - https://github.com/user/repo/tree/branch/path/to/dir
+ * - https://github.com/user/repo/tree/main/path/to/dir
+ */
+declare function parseGitHubUrl(url: string): {
+  owner?: string;
+  repo?: string;
+  repoUrl: string;
+  branch?: string;
+  subdirectory?: string;
+  isSubdirectory: boolean;
+};
+/**
+ * Clone a subdirectory from a git repository using sparse checkout
+ */
+declare function cloneSubdirectory(repoUrl: string, branch: string, subdirectory: string, targetFolder: string): Promise<void>;
+/**
+ * Clone entire repository
+ */
+declare function cloneRepository(repoUrl: string, targetFolder: string): Promise<void>;
+/**
+ * Fetch directory listing from GitHub API
+ */
+declare function fetchGitHubDirectoryContents(owner: string, repo: string, path: string, branch?: string): Promise<Array<{
+  name: string;
+  type: string;
+  path: string;
+}>>;
+//#endregion
+export { BANNER_GRADIENT, type CodingAgent, CodingAgentService, NewProjectService, THEME, TemplateSelectionService, TemplatesService, cloneRepository, cloneSubdirectory, displayBanner, displayCompactBanner, fetchGitHubDirectoryContents, findWorkspaceRoot, gitInit, parseGitHubUrl };

package/dist/index.js

@@ -0,0 +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";
+
+export { BANNER_GRADIENT, CodingAgentService, NewProjectService, THEME, TemplateSelectionService, TemplatesService, cloneRepository, cloneSubdirectory, displayBanner, displayCompactBanner, fetchGitHubDirectoryContents, findWorkspaceRoot, gitInit, parseGitHubUrl };

package/dist/mcp-Bdxvi2Ej.cjs

@@ -0,0 +1,4 @@
+const require_mcp = require('./mcp-Dwt8nYQV.cjs');
+
+exports.MCPServer = require_mcp.MCPServer;
+exports.MCP_CONFIG_FILES = require_mcp.MCP_CONFIG_FILES;

package/dist/mcp-BmhiAfeF.js

@@ -0,0 +1,47 @@
+//#region src/constants/mcp.ts
+/**
+* MCP (Model Context Protocol) Server Constants
+*
+* DESIGN PATTERNS:
+* - Centralized constants for MCP server configuration
+* - Enum pattern for type-safe MCP server selection
+*
+* CODING STANDARDS:
+* - Use UPPER_CASE for constant values
+* - Document each constant with JSDoc comments
+*/
+/**
+* Available MCP servers
+*/
+let MCPServer = /* @__PURE__ */ function(MCPServer$1) {
+	MCPServer$1["ARCHITECT"] = "architect-mcp";
+	MCPServer$1["SCAFFOLD"] = "scaffold-mcp";
+	return MCPServer$1;
+}({});
+/**
+* MCP server configuration files
+* Maps each MCP server to its specific configuration files
+*
+* - architect-mcp: Only needs RULES.yaml and architect.yaml
+* - scaffold-mcp: Needs all other template files (excluding architect files)
+*/
+const MCP_CONFIG_FILES = {
+	[MCPServer.ARCHITECT]: ["RULES.yaml", "architect.yaml"],
+	[MCPServer.SCAFFOLD]: []
+};
+/**
+* MCP server display names and descriptions for user prompts
+*/
+const MCP_SERVER_INFO = {
+	[MCPServer.ARCHITECT]: {
+		name: "Architect MCP",
+		description: "Code review, design patterns, and coding standards enforcement"
+	},
+	[MCPServer.SCAFFOLD]: {
+		name: "Scaffold MCP",
+		description: "Project scaffolding, boilerplates, and feature generation"
+	}
+};
+
+//#endregion
+export { MCPServer, MCP_CONFIG_FILES, MCP_SERVER_INFO };

package/dist/mcp-CZIiB-6Y.js

@@ -0,0 +1,3 @@
+import { MCPServer, MCP_CONFIG_FILES, MCP_SERVER_INFO } from "./mcp-BmhiAfeF.js";
+
+export { MCPServer, MCP_CONFIG_FILES };