@pupt/cli 0.0.1 → 2.3.0

package/dist/utils/errors.js

@@ -0,0 +1,275 @@
+import chalk from 'chalk';
+import { logger } from './logger.js';
+export var ErrorCategory;
+(function (ErrorCategory) {
+    ErrorCategory["USER_ERROR"] = "USER_ERROR";
+    ErrorCategory["CONFIG_ERROR"] = "CONFIG_ERROR";
+    ErrorCategory["FILE_SYSTEM_ERROR"] = "FILE_SYSTEM_ERROR";
+    ErrorCategory["NETWORK_ERROR"] = "NETWORK_ERROR";
+    ErrorCategory["EXTERNAL_TOOL_ERROR"] = "EXTERNAL_TOOL_ERROR";
+    ErrorCategory["SYSTEM_ERROR"] = "SYSTEM_ERROR";
+    ErrorCategory["UNKNOWN"] = "UNKNOWN";
+})(ErrorCategory || (ErrorCategory = {}));
+export var ErrorSeverity;
+(function (ErrorSeverity) {
+    ErrorSeverity["WARNING"] = "WARNING";
+    ErrorSeverity["ERROR"] = "ERROR";
+    ErrorSeverity["FATAL"] = "FATAL";
+})(ErrorSeverity || (ErrorSeverity = {}));
+export class PromptToolError extends Error {
+    code;
+    category;
+    severity;
+    suggestions;
+    icon;
+    constructor(message, code, category = ErrorCategory.UNKNOWN, severity = ErrorSeverity.ERROR, suggestions = [], icon = '❌') {
+        super(message);
+        this.code = code;
+        this.category = category;
+        this.severity = severity;
+        this.suggestions = suggestions;
+        this.icon = icon;
+        this.name = 'PromptToolError';
+    }
+}
+export function createError(options) {
+    return new PromptToolError(options.message, options.code, options.category ?? ErrorCategory.UNKNOWN, options.severity ?? ErrorSeverity.ERROR, options.suggestions ?? [], options.icon ?? '❌');
+}
+export function isRecoverableError(error) {
+    if (!(error instanceof PromptToolError)) {
+        return false;
+    }
+    if (error.severity === ErrorSeverity.FATAL) {
+        return false;
+    }
+    const recoverableCategories = [
+        ErrorCategory.USER_ERROR,
+        ErrorCategory.CONFIG_ERROR,
+        ErrorCategory.NETWORK_ERROR,
+        ErrorCategory.EXTERNAL_TOOL_ERROR
+    ];
+    return recoverableCategories.includes(error.category);
+}
+export function getErrorCategory(error) {
+    if (error instanceof PromptToolError) {
+        return error.category;
+    }
+    return ErrorCategory.UNKNOWN;
+}
+export function displayError(error) {
+    if (error instanceof PromptToolError) {
+        let prefix;
+        if (error.severity === ErrorSeverity.FATAL) {
+            prefix = chalk.bgRed.white(' FATAL ERROR: ');
+        }
+        else if (error.severity === ErrorSeverity.WARNING) {
+            prefix = chalk.yellow('Warning:');
+        }
+        else {
+            prefix = chalk.red('Error:');
+        }
+        const displayFn = error.severity === ErrorSeverity.WARNING ? logger.warn.bind(logger) : logger.error.bind(logger);
+        displayFn(`${error.icon} ${prefix} ${error.message}`);
+        if (error.suggestions.length > 0) {
+            displayFn(chalk.yellow('\n💡 Suggestions:'));
+            error.suggestions.forEach(suggestion => {
+                displayFn(chalk.dim(`   • ${suggestion.text}`));
+                if (suggestion.command) {
+                    displayFn(chalk.green(`     ▶️  ${suggestion.command}`));
+                }
+            });
+        }
+    }
+    else {
+        logger.error(chalk.red('Error:'), error.message);
+    }
+    if (process.env.DEBUG === 'true') {
+        logger.error(chalk.dim('\nStack trace:'));
+        logger.error(chalk.dim(error.stack || 'No stack trace available'));
+    }
+}
+// Common error creators
+export const errors = {
+    // File System Errors
+    fileNotFound: (path) => createError({
+        message: `File not found: ${path}`,
+        code: 'FILE_NOT_FOUND',
+        category: ErrorCategory.FILE_SYSTEM_ERROR,
+        suggestions: [
+            { text: 'Check if the file exists', command: `ls -la "${path}"` },
+            { text: 'Verify the path is correct' },
+            { text: 'Use absolute paths to avoid confusion' }
+        ],
+        icon: '📄'
+    }),
+    permissionDenied: (path) => createError({
+        message: `Permission denied: ${path}`,
+        code: 'PERMISSION_DENIED',
+        category: ErrorCategory.FILE_SYSTEM_ERROR,
+        suggestions: [
+            { text: 'Check directory permissions', command: `ls -la "${path}"` },
+            { text: 'Fix permissions', command: `chmod 755 "${path}"` },
+            { text: 'Ensure directory exists', command: `mkdir -p "${path}"` }
+        ],
+        icon: '🔒'
+    }),
+    // User Errors
+    noPromptsFound: (dirs) => createError({
+        message: `No prompts found in: ${dirs.join(', ')}`,
+        code: 'NO_PROMPTS',
+        category: ErrorCategory.USER_ERROR,
+        suggestions: [
+            { text: 'Create a new prompt interactively', command: 'pt add' },
+            { text: `Create a .prompt file in one of the directories` }
+        ],
+        icon: '🔍'
+    }),
+    validationError: (field, format, example) => createError({
+        message: `Invalid ${field}`,
+        code: 'VALIDATION_ERROR',
+        category: ErrorCategory.USER_ERROR,
+        severity: ErrorSeverity.WARNING,
+        suggestions: [
+            { text: `Expected format: ${format}` },
+            { text: `Example: ${example}` }
+        ],
+        icon: '✏️'
+    }),
+    templateError: (template, details) => createError({
+        message: `Template error in "${template}": ${details}`,
+        code: 'TEMPLATE_ERROR',
+        category: ErrorCategory.USER_ERROR,
+        suggestions: [
+            { text: 'Check template syntax' },
+            { text: 'Ensure all helpers are closed properly' },
+            { text: 'Verify variable names are correct' }
+        ],
+        icon: '📝'
+    }),
+    // Configuration Errors
+    configMissing: () => createError({
+        message: 'No configuration found',
+        code: 'NO_CONFIG',
+        category: ErrorCategory.CONFIG_ERROR,
+        suggestions: [
+            { text: 'Initialize configuration', command: 'pt init' }
+        ],
+        icon: '⚙️'
+    }),
+    invalidConfig: (field, expected, actual) => createError({
+        message: `Configuration error: '${field}' must be ${expected} (found: ${typeof actual})`,
+        code: 'INVALID_CONFIG',
+        category: ErrorCategory.CONFIG_ERROR,
+        suggestions: [
+            { text: `Edit .pt-config.json and fix the '${field}' value` },
+            { text: `Expected format: ${expected}` }
+        ],
+        icon: '⚙️'
+    }),
+    featureNotEnabled: (feature, benefits) => createError({
+        message: `${feature} is not enabled`,
+        code: 'FEATURE_DISABLED',
+        category: ErrorCategory.CONFIG_ERROR,
+        severity: ErrorSeverity.WARNING,
+        suggestions: [
+            { text: 'Enable it by running:', command: 'pt init' },
+            { text: `Benefits: ${benefits.join(', ')}` }
+        ],
+        icon: '🎯'
+    }),
+    // External Tool Errors
+    toolNotFound: (tool, suggestions = []) => createError({
+        message: `Tool '${tool}' not found`,
+        code: 'TOOL_NOT_FOUND',
+        category: ErrorCategory.EXTERNAL_TOOL_ERROR,
+        suggestions: [
+            ...suggestions.map(s => ({ text: `Did you mean '${s}'?` })),
+            { text: 'Check if installed', command: `which ${tool}` },
+            { text: 'Install if needed', command: `npm install -g ${tool}` }
+        ],
+        icon: '🔧'
+    }),
+    noEditor: () => createError({
+        message: 'No editor configured',
+        code: 'NO_EDITOR',
+        category: ErrorCategory.EXTERNAL_TOOL_ERROR,
+        suggestions: [
+            { text: 'Set your editor:', command: 'export EDITOR=vim' },
+            { text: 'For VS Code:', command: 'export EDITOR="code --wait"' },
+            { text: 'Add to your shell profile to make permanent' }
+        ],
+        icon: '✏️'
+    }),
+    gitError: (details) => createError({
+        message: `Git error: ${details}`,
+        code: 'GIT_ERROR',
+        category: ErrorCategory.EXTERNAL_TOOL_ERROR,
+        suggestions: [
+            { text: 'Check git status', command: 'git status' },
+            { text: 'View git log', command: 'git log --oneline -5' },
+            { text: 'Ensure you\'re in a git repository' }
+        ],
+        icon: '🔗'
+    }),
+    gitNotInstalled: () => createError({
+        message: 'Git is not installed',
+        code: 'GIT_NOT_INSTALLED',
+        category: ErrorCategory.EXTERNAL_TOOL_ERROR,
+        suggestions: [
+            { text: 'Install git for your platform' },
+            { text: 'macOS:', command: 'brew install git' },
+            { text: 'Ubuntu/Debian:', command: 'sudo apt-get install git' },
+            { text: 'Visit https://git-scm.com/downloads for more options' }
+        ],
+        icon: '🔗'
+    }),
+    // Network Errors
+    networkError: (url, details) => createError({
+        message: `Network error accessing ${url}: ${details}`,
+        code: 'NETWORK_ERROR',
+        category: ErrorCategory.NETWORK_ERROR,
+        suggestions: [
+            { text: 'Check your internet connection' },
+            { text: 'Verify the URL is correct' },
+            { text: 'Try again in a few moments' },
+            { text: 'Check if you need to configure a proxy' }
+        ],
+        icon: '🌐'
+    }),
+    // History Errors  
+    historyNotFound: (index, total) => createError({
+        message: `History entry #${index} not found`,
+        code: 'HISTORY_NOT_FOUND',
+        category: ErrorCategory.USER_ERROR,
+        severity: ErrorSeverity.WARNING,
+        suggestions: [
+            { text: `Available entries: 1-${total}` },
+            { text: 'View all entries', command: 'pt history' }
+        ],
+        icon: '📋'
+    }),
+    // Prompt Errors
+    promptNotFound: (name) => createError({
+        message: `Prompt '${name}' not found`,
+        code: 'PROMPT_NOT_FOUND',
+        category: ErrorCategory.USER_ERROR,
+        suggestions: [
+            { text: 'List available prompts', command: 'pt' },
+            { text: 'Check prompt name or filename' },
+            { text: 'Create a new prompt', command: 'pt add' }
+        ],
+        icon: '🔍'
+    }),
+    commandNotFound: (command, suggestions = [], availableCommands = []) => createError({
+        message: `Unknown command: '${command}'`,
+        code: 'COMMAND_NOT_FOUND',
+        category: ErrorCategory.USER_ERROR,
+        suggestions: [
+            ...suggestions.map(s => ({ text: `Did you mean '${s}'?`, command: `pt ${s}` })),
+            ...(availableCommands.length > 0 ? [{ text: `Available commands: ${availableCommands.join(', ')}` }] : []),
+            { text: 'Show help', command: 'pt help' }
+        ],
+        icon: '❓'
+    })
+};
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/git-info.d.ts

@@ -0,0 +1,10 @@
+interface GitInfo {
+    branch?: string;
+    commit?: string;
+    isDirty?: boolean;
+    gitDir?: string;
+}
+export declare function getGitInfo(): Promise<GitInfo>;
+export declare function formatDuration(startTime: Date, endTime: Date): string;
+export {};
+//# sourceMappingURL=git-info.d.ts.map

package/dist/utils/git-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-info.d.ts","sourceRoot":"","sources":["../../src/utils/git-info.ts"],"names":[],"mappings":"AAKA,UAAU,OAAO;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAyBnD;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,MAAM,CAuBrE"}

package/dist/utils/git-info.js

@@ -0,0 +1,44 @@
+import { exec } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+export async function getGitInfo() {
+    const info = {};
+    try {
+        // Get current branch
+        const branchResult = await execAsync('git rev-parse --abbrev-ref HEAD');
+        info.branch = branchResult.stdout.trim();
+        // Get current commit hash
+        const commitResult = await execAsync('git rev-parse HEAD');
+        info.commit = commitResult.stdout.trim();
+        // Check if working directory is dirty
+        const statusResult = await execAsync('git status --porcelain');
+        info.isDirty = statusResult.stdout.trim().length > 0;
+        // Get the git directory (important for worktrees)
+        const gitDirResult = await execAsync('git rev-parse --absolute-git-dir');
+        info.gitDir = gitDirResult.stdout.trim();
+    }
+    catch {
+        // Not a git repository or git not available
+        // Return partial info - don't throw
+    }
+    return info;
+}
+export function formatDuration(startTime, endTime) {
+    const durationMs = endTime.getTime() - startTime.getTime();
+    const seconds = Math.floor(durationMs / 1000);
+    if (seconds < 60) {
+        return `${seconds}s`;
+    }
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = seconds % 60;
+    if (minutes < 60) {
+        return remainingSeconds > 0 ? `${minutes}m ${remainingSeconds}s` : `${minutes}m`;
+    }
+    const hours = Math.floor(minutes / 60);
+    const remainingMinutes = minutes % 60;
+    if (remainingMinutes > 0) {
+        return `${hours}h ${remainingMinutes}m`;
+    }
+    return `${hours}h`;
+}
+//# sourceMappingURL=git-info.js.map

package/dist/utils/git-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-info.js","sourceRoot":"","sources":["../../src/utils/git-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AASlC,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,IAAI,GAAY,EAAE,CAAC;IAEzB,IAAI,CAAC;QACH,qBAAqB;QACrB,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,iCAAiC,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAEzC,0BAA0B;QAC1B,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,oBAAoB,CAAC,CAAC;QAC3D,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAEzC,sCAAsC;QACtC,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,wBAAwB,CAAC,CAAC;QAC/D,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;QAErD,kDAAkD;QAClD,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,kCAAkC,CAAC,CAAC;QACzE,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,4CAA4C;QAC5C,oCAAoC;IACtC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAe,EAAE,OAAa;IAC3D,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;IAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAE9C,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;QACjB,OAAO,GAAG,OAAO,GAAG,CAAC;IACvB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACzC,MAAM,gBAAgB,GAAG,OAAO,GAAG,EAAE,CAAC;IAEtC,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;QACjB,OAAO,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,gBAAgB,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC;IACnF,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,MAAM,gBAAgB,GAAG,OAAO,GAAG,EAAE,CAAC;IAEtC,IAAI,gBAAgB,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,GAAG,KAAK,KAAK,gBAAgB,GAAG,CAAC;IAC1C,CAAC;IAED,OAAO,GAAG,KAAK,GAAG,CAAC;AACrB,CAAC"}

package/dist/utils/gitignore.d.ts

@@ -0,0 +1,10 @@
+import { SimpleGit } from 'simple-git';
+/**
+ * Check if current directory is a git repository
+ */
+export declare function isGitRepository(git?: SimpleGit): Promise<boolean>;
+/**
+ * Add entry to .gitignore file
+ */
+export declare function addToGitignore(entry: string): Promise<void>;
+//# sourceMappingURL=gitignore.d.ts.map

package/dist/utils/gitignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../../src/utils/gitignore.ts"],"names":[],"mappings":"AAGA,OAAkB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAElD;;GAEG;AACH,wBAAsB,eAAe,CAAC,GAAG,GAAE,SAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,CAMpF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2DjE"}

package/dist/utils/gitignore.js

@@ -0,0 +1,72 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+import simpleGit from 'simple-git';
+/**
+ * Check if current directory is a git repository
+ */
+export async function isGitRepository(git = simpleGit()) {
+    try {
+        return await git.checkIsRepo();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Add entry to .gitignore file
+ */
+export async function addToGitignore(entry) {
+    const gitignorePath = path.join(process.cwd(), '.gitignore');
+    let gitignoreContent = '';
+    let exists = false;
+    try {
+        gitignoreContent = await fs.readFile(gitignorePath, 'utf-8');
+        exists = true;
+    }
+    catch {
+        // File doesn't exist, will create it
+        gitignoreContent = '';
+    }
+    // Check if entry already exists
+    const lines = gitignoreContent.split('\n');
+    const entryExists = lines.some(line => line.trim() === entry);
+    if (entryExists) {
+        return; // Entry already exists, nothing to do
+    }
+    // Check if PUPT section exists
+    const promptToolSectionIndex = lines.findIndex(line => line.trim() === '# PUPT');
+    if (promptToolSectionIndex !== -1) {
+        // Add to existing PUPT section
+        // Find the end of the section (next comment or end of file)
+        let insertIndex = promptToolSectionIndex + 1;
+        while (insertIndex < lines.length &&
+            lines[insertIndex].trim() !== '' &&
+            !lines[insertIndex].trim().startsWith('#')) {
+            insertIndex++;
+        }
+        // Insert the new entry
+        lines.splice(insertIndex, 0, entry);
+    }
+    else {
+        // Add new PUPT section
+        // Ensure there's a newline before the section if file has content
+        if (exists && gitignoreContent.trim() !== '') {
+            if (!gitignoreContent.endsWith('\n')) {
+                lines.push(''); // Add empty line
+            }
+            lines.push(''); // Add separator line
+        }
+        else if (!exists || gitignoreContent === '') {
+            // For new files, remove the initial empty line
+            if (lines.length === 1 && lines[0] === '') {
+                lines.pop();
+            }
+        }
+        lines.push('# PUPT');
+        lines.push(entry);
+    }
+    // Write back to file
+    const newContent = lines.join('\n');
+    await fs.writeFile(gitignorePath, newContent.endsWith('\n') ? newContent : `${newContent}\n`, 'utf-8');
+}
+//# sourceMappingURL=gitignore.js.map

package/dist/utils/gitignore.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Platform-aware logger that ensures consistent line endings
+ * and prevents null characters in output
+ */
+export declare class Logger {
+    private static instance;
+    private readonly lineEnding;
+    private constructor();
+    static getInstance(): Logger;
+    /**
+     * Sanitizes a string for output:
+     * - Removes null characters
+     * - Normalizes line endings to platform-specific format
+     * - Removes trailing newlines to prevent double spacing
+     */
+    private sanitize;
+    /**
+     * Logs a message to stdout with proper line endings
+     */
+    log(...args: unknown[]): void;
+    /**
+     * Logs an error message to stderr with proper line endings
+     */
+    error(...args: unknown[]): void;
+    /**
+     * Logs a message without adding a newline at the end
+     */
+    write(message: string): void;
+    /**
+     * Logs a warning message to stderr
+     */
+    warn(...args: unknown[]): void;
+    /**
+     * Logs a debug message (only in development/test environments)
+     */
+    debug(...args: unknown[]): void;
+}
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,OAAO;IAqBP,MAAM,CAAC,WAAW,IAAI,MAAM;IAO5B;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAOhB;;OAEG;IACH,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAkB7B;;OAEG;IACH,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAkB/B;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAe5B;;OAEG;IACH,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAkB9B;;OAEG;IACH,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAmBhC;AAGD,eAAO,MAAM,MAAM,QAAuB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,143 @@
+import os from 'os';
+/**
+ * Platform-aware logger that ensures consistent line endings
+ * and prevents null characters in output
+ */
+export class Logger {
+    static instance;
+    lineEnding;
+    constructor() {
+        // Use platform-specific line endings
+        this.lineEnding = os.platform() === 'win32' ? '\r\n' : '\n';
+        // Handle EPIPE errors gracefully when output is piped
+        // Increase max listeners to avoid warnings in tests
+        process.stdout.setMaxListeners(process.stdout.getMaxListeners() + 1);
+        process.stderr.setMaxListeners(process.stderr.getMaxListeners() + 1);
+        const handlePipeError = (error) => {
+            if (error.code === 'EPIPE') {
+                // Silently ignore EPIPE errors - this is normal when piping to less/head/etc
+                // Don't exit, just stop writing
+                return;
+            }
+        };
+        process.stdout.on('error', handlePipeError);
+        process.stderr.on('error', handlePipeError);
+    }
+    static getInstance() {
+        if (!Logger.instance) {
+            Logger.instance = new Logger();
+        }
+        return Logger.instance;
+    }
+    /**
+     * Sanitizes a string for output:
+     * - Removes null characters
+     * - Normalizes line endings to platform-specific format
+     * - Removes trailing newlines to prevent double spacing
+     */
+    sanitize(text) {
+        return text
+            .replace(/\0/g, '') // Remove null characters
+            .replace(/\r\n|\r|\n/g, this.lineEnding) // Normalize line endings
+            .replace(/[\r\n]+$/, ''); // Remove trailing newlines
+    }
+    /**
+     * Logs a message to stdout with proper line endings
+     */
+    log(...args) {
+        const message = args.map(arg => typeof arg === 'string' ? arg : String(arg)).join(' ');
+        const sanitized = this.sanitize(message);
+        try {
+            process.stdout.write(sanitized + this.lineEnding);
+        }
+        catch (error) {
+            // Handle EPIPE errors gracefully when output is piped
+            if (error.code === 'EPIPE') {
+                // Silently ignore - this is normal when piping to less/head/etc
+                return;
+            }
+            // Re-throw other errors
+            throw error;
+        }
+    }
+    /**
+     * Logs an error message to stderr with proper line endings
+     */
+    error(...args) {
+        const message = args.map(arg => typeof arg === 'string' ? arg : String(arg)).join(' ');
+        const sanitized = this.sanitize(message);
+        try {
+            process.stderr.write(sanitized + this.lineEnding);
+        }
+        catch (error) {
+            // Handle EPIPE errors gracefully when output is piped
+            if (error.code === 'EPIPE') {
+                // Silently ignore - this is normal when piping to less/head/etc
+                return;
+            }
+            // Re-throw other errors
+            throw error;
+        }
+    }
+    /**
+     * Logs a message without adding a newline at the end
+     */
+    write(message) {
+        const sanitized = this.sanitize(message);
+        try {
+            process.stdout.write(sanitized);
+        }
+        catch (error) {
+            // Handle EPIPE errors gracefully when output is piped
+            if (error.code === 'EPIPE') {
+                // Silently ignore - this is normal when piping to less/head/etc
+                return;
+            }
+            // Re-throw other errors
+            throw error;
+        }
+    }
+    /**
+     * Logs a warning message to stderr
+     */
+    warn(...args) {
+        const message = args.map(arg => typeof arg === 'string' ? arg : String(arg)).join(' ');
+        const sanitized = this.sanitize(message);
+        try {
+            process.stderr.write(sanitized + this.lineEnding);
+        }
+        catch (error) {
+            // Handle EPIPE errors gracefully when output is piped
+            if (error.code === 'EPIPE') {
+                // Silently ignore - this is normal when piping to less/head/etc
+                return;
+            }
+            // Re-throw other errors
+            throw error;
+        }
+    }
+    /**
+     * Logs a debug message (only in development/test environments)
+     */
+    debug(...args) {
+        if (process.env.NODE_ENV === 'development' || process.env.NODE_ENV === 'test' || process.env.DEBUG) {
+            const message = args.map(arg => typeof arg === 'string' ? arg : String(arg)).join(' ');
+            const sanitized = this.sanitize(`[DEBUG] ${message}`);
+            try {
+                process.stderr.write(sanitized + this.lineEnding);
+            }
+            catch (error) {
+                // Handle EPIPE errors gracefully when output is piped
+                if (error.code === 'EPIPE') {
+                    // Exit gracefully when pipe is closed
+                    process.exit(0);
+                }
+                // Re-throw other errors
+                throw error;
+            }
+        }
+    }
+}
+// Export singleton instance
+export const logger = Logger.getInstance();
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/platform.d.ts

@@ -0,0 +1,9 @@
+export declare function getHomePath(): string;
+export declare function getConfigPaths(): string[];
+export declare function getPlatform(): NodeJS.Platform;
+export declare function isWindows(): boolean;
+export declare function isMacOS(): boolean;
+export declare function isLinux(): boolean;
+export declare function normalizeLineEndings(text: string): string;
+export declare function getUsername(): string;
+//# sourceMappingURL=platform.d.ts.map

package/dist/utils/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAyBzC;AAED,wBAAgB,WAAW,IAAI,MAAM,CAAC,QAAQ,CAE7C;AAED,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,WAAW,IAAI,MAAM,CAEpC"}