@e0ipso/ai-task-manager 1.0.1

package/dist/utils.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Helper Functions for File Operations
+ *
+ * This file contains utility functions for file system operations,
+ * path manipulation, and other common tasks used by the CLI
+ */
+import { Assistant, TemplateFormat } from './types';
+/**
+ * Create a directory recursively if it doesn't exist
+ * @param dirPath - The directory path to create
+ * @throws FileSystemError if directory creation fails
+ */
+export declare function ensureDir(dirPath: string): Promise<void>;
+/**
+ * Check if a directory exists
+ * @param dirPath - The directory path to check
+ * @returns Promise<boolean> - True if directory exists, false otherwise
+ */
+export declare function directoryExists(dirPath: string): Promise<boolean>;
+/**
+ * Check if a file exists
+ * @param filePath - The file path to check
+ * @returns Promise<boolean> - True if file exists, false otherwise
+ */
+export declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * Check if a file or directory exists (generic)
+ * @param filepath - The path to check
+ * @returns Promise<boolean> - True if path exists, false otherwise
+ */
+export declare function exists(filepath: string): Promise<boolean>;
+/**
+ * Copy a file or directory from source to destination
+ * @param src - Source path (file or directory)
+ * @param dest - Destination path
+ * @param options - Copy options
+ * @throws FileSystemError if copy operation fails
+ */
+export declare function copyTemplate(src: string, dest: string, options?: {
+    overwrite?: boolean;
+}): Promise<void>;
+/**
+ * Write JSON data to a file with proper formatting
+ * @param filePath - The file path to write to
+ * @param data - The data to write as JSON
+ * @throws FileSystemError if write operation fails
+ */
+export declare function writeJsonFile(filePath: string, data: unknown): Promise<void>;
+/**
+ * Read and parse a JSON file
+ * @param filePath - The file path to read from
+ * @returns The parsed JSON data
+ * @throws FileSystemError if read operation fails
+ */
+export declare function readJsonFile<T = unknown>(filePath: string): Promise<T>;
+/**
+ * Parse comma-separated assistant values into an array
+ * @param value - Comma-separated string of assistant names
+ * @returns Array of assistant names
+ * @throws Error if invalid assistant names are provided
+ */
+export declare function parseAssistants(value: string): Assistant[];
+/**
+ * Validate that all assistants are supported
+ * @param assistants - Array of assistants to validate
+ * @throws Error if any assistant is invalid or array is empty
+ */
+export declare function validateAssistants(assistants: Assistant[]): void;
+/**
+ * Get the absolute path for a given path, resolving it relative to the current working directory
+ * @param inputPath - The input path (can be relative or absolute)
+ * @returns The absolute path
+ */
+export declare function getAbsolutePath(inputPath: string): string;
+/**
+ * Get the relative path from one path to another
+ * @param from - The source path
+ * @param to - The target path
+ * @returns The relative path
+ */
+export declare function getRelativePath(from: string, to: string): string;
+/**
+ * Join multiple path segments into a single path
+ * @param segments - Path segments to join
+ * @returns The joined path
+ */
+export declare function joinPath(...segments: string[]): string;
+/**
+ * Get the directory name from a file path
+ * @param filePath - The file path
+ * @returns The directory name
+ */
+export declare function getDirName(filePath: string): string;
+/**
+ * Get the base name (filename) from a file path
+ * @param filePath - The file path
+ * @param ext - Optional extension to remove
+ * @returns The base name
+ */
+export declare function getBaseName(filePath: string, ext?: string): string;
+/**
+ * Get the file extension from a file path
+ * @param filePath - The file path
+ * @returns The file extension (including the dot)
+ */
+export declare function getExtension(filePath: string): string;
+/**
+ * Get the template format for a specific assistant
+ * @param assistant - The assistant type
+ * @returns The template format to use ('md' for Claude, 'toml' for Gemini)
+ */
+export declare function getTemplateFormat(assistant: Assistant): TemplateFormat;
+/**
+ * Get the absolute path to a template file
+ * @param templateFile - The template filename
+ * @returns The absolute path to the template
+ */
+export declare function getTemplatePath(templateFile: string): string;
+/**
+ * Get list of directories that will be created for given assistants
+ * @param assistants - Array of assistants
+ * @param baseDir - Base directory to resolve paths against (defaults to current directory)
+ * @returns Array of directory paths to create
+ */
+export declare function getCreatedDirectories(assistants: Assistant[], baseDir?: string): string[];
+/**
+ * Ensure a directory path ends with a path separator
+ * @param dirPath - The directory path
+ * @returns The directory path with trailing separator
+ */
+export declare function ensureTrailingSlash(dirPath: string): string;
+/**
+ * Create a safe filename by removing or replacing invalid characters
+ * @param filename - The input filename
+ * @returns A safe filename for the current platform
+ */
+export declare function sanitizeFilename(filename: string): string;
+/**
+ * Get the home directory path
+ * @returns The user's home directory path
+ */
+export declare function getHomeDirectory(): string;
+/**
+ * Remove a file or directory recursively
+ * @param targetPath - The path to remove
+ * @throws FileSystemError if removal fails
+ */
+export declare function remove(targetPath: string): Promise<void>;
+/**
+ * Move a file or directory from source to destination
+ * @param src - Source path
+ * @param dest - Destination path
+ * @throws FileSystemError if move operation fails
+ */
+export declare function move(src: string, dest: string): Promise<void>;
+/**
+ * Resolve path segments relative to a base directory with cross-platform compatibility
+ * @param baseDir - The base directory (defaults to '.' if not provided, null, or undefined)
+ * @param segments - Additional path segments to resolve
+ * @returns The resolved absolute path
+ */
+export declare function resolvePath(baseDir: string | undefined, ...segments: string[]): string;
+/**
+ * Interface for parsed markdown frontmatter
+ */
+export interface MarkdownFrontmatter {
+    [key: string]: unknown;
+}
+/**
+ * Parse YAML frontmatter from markdown content
+ * @param content - The markdown content with frontmatter
+ * @returns Object containing frontmatter and body content
+ */
+export declare function parseFrontmatter(content: string): {
+    frontmatter: MarkdownFrontmatter;
+    body: string;
+};
+/**
+ * Escape a string for TOML format
+ * @param str - The string to escape
+ * @returns The escaped string suitable for TOML
+ */
+export declare function escapeTomlString(str: string): string;
+/**
+ * Convert markdown template content to TOML format for Gemini
+ * @param mdContent - The markdown template content
+ * @returns The converted TOML content
+ */
+export declare function convertMdToToml(mdContent: string): string;
+/**
+ * Read a markdown template file and optionally convert to TOML
+ * @param templatePath - Path to the markdown template
+ * @param targetFormat - Target format ('md' or 'toml')
+ * @returns The template content in the requested format
+ */
+export declare function readAndProcessTemplate(templatePath: string, targetFormat: TemplateFormat): Promise<string>;
+/**
+ * Write processed template content to destination
+ * @param content - The template content to write
+ * @param destPath - Destination file path
+ */
+export declare function writeProcessedTemplate(content: string, destPath: string): Promise<void>;
+/**
+ * Get the names of all markdown template files in a given subdirectory of templates.
+ * @param templateSubdir - The subdirectory within templates (e.g., 'commands/tasks')
+ * @returns An array of template names (filenames without .md extension)
+ * @throws FileSystemError if the directory cannot be read
+ */
+export declare function getMarkdownTemplateNames(templateSubdir: string): Promise<string[]>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

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