@gaunt-sloth/core 0.0.1

package/dist/utils/binaryOutputUtils.js

@@ -0,0 +1,138 @@
+import { writeFileSync, existsSync } from 'node:fs';
+import { fileSafeLocalDate, getGslothFilePath, toFileSafeString } from '#src/utils/fileUtils.js';
+const MIME_TYPE_EXTENSIONS = {
+    'image/png': 'png',
+    'image/jpeg': 'jpg',
+    'image/gif': 'gif',
+    'image/webp': 'webp',
+    'image/svg+xml': 'svg',
+    'image/heic': 'heic',
+    'application/pdf': 'pdf',
+    'audio/mpeg': 'mp3',
+    'audio/mp4': 'm4a',
+    'audio/wav': 'wav',
+    'video/mp4': 'mp4',
+};
+function getMimeExtension(mimeType) {
+    const normalized = mimeType.trim().toLowerCase();
+    if (MIME_TYPE_EXTENSIONS[normalized]) {
+        return MIME_TYPE_EXTENSIONS[normalized];
+    }
+    const subtype = normalized.split('/')[1]?.split(';')[0]?.trim();
+    if (!subtype) {
+        return 'bin';
+    }
+    if (subtype === 'jpeg') {
+        return 'jpg';
+    }
+    if (subtype.includes('+xml')) {
+        return subtype.split('+')[0];
+    }
+    if (/^[a-z0-9]+$/.test(subtype) && subtype.length <= 4) {
+        return subtype;
+    }
+    return 'bin';
+}
+function getBinaryOutputFilePath(command, extension) {
+    const dateTimeStr = fileSafeLocalDate();
+    const commandStr = toFileSafeString((command ?? 'output').toUpperCase());
+    const normalizedExtension = extension.replace(/^\./, '') || 'bin';
+    const filename = `gth_${dateTimeStr}_${commandStr}.${normalizedExtension}`;
+    const initialPath = getGslothFilePath(filename);
+    if (!existsSync(initialPath)) {
+        return initialPath;
+    }
+    const suffixBase = initialPath.slice(0, -(normalizedExtension.length + 1));
+    for (let suffix = 2; suffix < 1000; suffix++) {
+        const candidate = `${suffixBase}_${suffix}.${normalizedExtension}`;
+        if (!existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return `${suffixBase}_${Date.now()}.${normalizedExtension}`;
+}
+export function extractInlineBinaryBlocks(content) {
+    if (!Array.isArray(content)) {
+        return [];
+    }
+    return content.flatMap((block, index) => {
+        if (block &&
+            typeof block === 'object' &&
+            'type' in block &&
+            block.type === 'inlineData' &&
+            'inlineData' in block &&
+            block.inlineData &&
+            typeof block.inlineData === 'object' &&
+            'mimeType' in block.inlineData &&
+            'data' in block.inlineData &&
+            typeof block.inlineData.mimeType === 'string' &&
+            typeof block.inlineData.data === 'string') {
+            return [
+                {
+                    index,
+                    mimeType: block.inlineData.mimeType,
+                    data: block.inlineData.data,
+                },
+            ];
+        }
+        return [];
+    });
+}
+export function renderAssistantContent(content, binaryPlaceholders = new Map()) {
+    if (content === undefined || content === null) {
+        return '';
+    }
+    if (typeof content === 'string') {
+        return content;
+    }
+    if (!Array.isArray(content)) {
+        return String(content);
+    }
+    return content
+        .map((block, index) => {
+        if (binaryPlaceholders.has(index)) {
+            return binaryPlaceholders.get(index);
+        }
+        if (typeof block === 'string') {
+            return block;
+        }
+        if (block && typeof block === 'object' && 'type' in block && block.type === 'text') {
+            if ('text' in block && typeof block.text === 'string') {
+                return block.text;
+            }
+        }
+        return JSON.stringify(block);
+    })
+        .filter((part) => !!part && part.trim().length > 0)
+        .join('\n');
+}
+export function materializeBinaryOutputs(content, command) {
+    const binaryBlocks = extractInlineBinaryBlocks(content);
+    if (binaryBlocks.length === 0) {
+        return {
+            renderedContent: renderAssistantContent(content),
+            successMessages: [],
+        };
+    }
+    const placeholderMap = new Map();
+    const successMessages = [];
+    for (const binaryBlock of binaryBlocks) {
+        const extension = getMimeExtension(binaryBlock.mimeType);
+        const filePath = getBinaryOutputFilePath(command, extension);
+        try {
+            writeFileSync(filePath, Buffer.from(binaryBlock.data, 'base64'));
+            const placeholder = `[Binary model output saved: ${binaryBlock.mimeType} -> ${filePath}]`;
+            placeholderMap.set(binaryBlock.index, placeholder);
+            successMessages.push(`Wrote model output (${binaryBlock.mimeType}) to ${filePath}`);
+        }
+        catch {
+            const errorPlaceholder = `[Failed to save binary output: ${binaryBlock.mimeType}]`;
+            placeholderMap.set(binaryBlock.index, errorPlaceholder);
+        }
+    }
+    return {
+        renderedContent: renderAssistantContent(content, placeholderMap),
+        successMessages,
+    };
+}
+//# sourceMappingURL=binaryOutputUtils.js.map

package/dist/utils/binaryOutputUtils.js.map

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

package/dist/utils/consoleUtils.d.ts

@@ -0,0 +1,76 @@
+import { StatusLevel, StatusUpdateCallback } from '#src/core/types.js';
+export declare const initSessionLogging: (logFileName: string, enableLogging: boolean) => void;
+/**
+ * Set the console logging level.
+ * Only messages at or above this level will be displayed.
+ * @param level - The minimum level to display
+ */
+export declare const setConsoleLevel: (level: StatusLevel) => void;
+/**
+ * Get the current console logging level.
+ * @returns The current console level
+ */
+export declare const getConsoleLevel: () => StatusLevel;
+/**
+ * Reset console level to default (INFO) for testing purposes
+ */
+export declare const resetConsoleLevel: () => void;
+export declare const flushSessionLog: () => void;
+export declare const stopSessionLogging: () => void;
+export declare function displayError(message: string): void;
+export declare function displayWarning(message: string): void;
+export declare function displaySuccess(message: string): void;
+export declare function displayInfo(message: string): void;
+export declare function display(message: string): void;
+export declare function formatInputPrompt(message: string): string;
+/**
+ * Display a debug message to the console and log it.
+ * This function also integrates with debugUtils to output logs when at debug level.
+ * Note: There is also a dedicated debug() function in debugUtils for more detailed logging.
+ * @param message - The message to display (string, Error, or undefined)
+ */
+export declare function displayDebug(message: string | Error | undefined): void;
+export declare const defaultStatusCallback: StatusUpdateCallback;
+/**
+ * Result of attempting to parse a CLI value as boolean-or-string.
+ * When kind === 'boolean', value is a boolean.
+ * When kind === 'string', value is a non-empty string.
+ * When kind === 'none', no usable value was provided (undefined/null/empty).
+ */
+export type BooleanOrStringParseResult = {
+    kind: 'boolean';
+    value: boolean;
+} | {
+    kind: 'string';
+    value: string;
+} | {
+    kind: 'none';
+};
+/**
+ * Parse a CLI option value into either:
+ * - a boolean (when value looks like a true/false token),
+ * - a non-empty string (otherwise),
+ * - or none (when value is nullish or only whitespace).
+ *
+ * Recognized false-like tokens (case-insensitive): 'false', '0', 'n', 'no'
+ * Recognized true-like tokens (case-insensitive):  'true', '1', 'y', 'yes'
+ *
+ * Examples:
+ *  parseBooleanOrString('n')         => { kind: 'boolean', value: false }
+ *  parseBooleanOrString('0')         => { kind: 'boolean', value: false }
+ *  parseBooleanOrString('true')      => { kind: 'boolean', value: true }
+ *  parseBooleanOrString('1')         => { kind: 'boolean', value: true }
+ *  parseBooleanOrString('review.md') => { kind: 'string',  value: 'review.md' }
+ *  parseBooleanOrString('  ')        => { kind: 'none' }
+ *  parseBooleanOrString(undefined)   => { kind: 'none' }
+ */
+export declare function parseBooleanOrString(value: unknown): BooleanOrStringParseResult;
+/**
+ * Convenience wrapper that returns a union directly instead of the tagged result.
+ *
+ * Returns:
+ * - boolean when the input is a boolean-like token
+ * - string when the input is non-empty and not a boolean-like token
+ * - undefined when the input is nullish or empty/whitespace
+ */
+export declare function coerceBooleanOrString(value: unknown): boolean | string | undefined;

package/dist/utils/consoleUtils.js

@@ -0,0 +1,230 @@
+import { StatusLevel } from '#src/core/types.js';
+import * as su from '#src/utils/systemUtils.js';
+import { closeLogStream, initLogStream, stream, writeToLogStream } from '#src/utils/systemUtils.js';
+import { debugLog } from '#src/utils/debugUtils.js';
+const loggingState = {
+    sessionLogFile: undefined,
+    enableSessionLogging: false,
+};
+const consoleLevelState = {
+    currentLevel: StatusLevel.INFO, // Default to INFO level, not debug
+};
+// ANSI color codes
+const ANSI_COLORS = {
+    red: '\x1b[31m',
+    yellow: '\x1b[33m',
+    green: '\x1b[32m',
+    magenta: '\x1b[35m',
+    dim: '\x1b[2m',
+    reset: '\x1b[0m',
+};
+// Helper functions for ANSI coloring
+function colorText(text, color) {
+    if (!su.getUseColour()) {
+        return text;
+    }
+    return `${ANSI_COLORS[color]}${text}${ANSI_COLORS.reset}`;
+}
+// Stream-based logging function
+const writeToSessionLog = (message) => {
+    if (loggingState.enableSessionLogging) {
+        // Strip ANSI color codes before logging to file
+        const cleanMessage = message.replace(/\x1b\[[0-9;]*m/g, '');
+        writeToLogStream(cleanMessage);
+    }
+};
+// Public functions for session logging management
+export const initSessionLogging = (logFileName, enableLogging) => {
+    loggingState.sessionLogFile = enableLogging ? logFileName : undefined;
+    loggingState.enableSessionLogging = enableLogging;
+    if (enableLogging && logFileName) {
+        initLogStream(logFileName);
+    }
+};
+/**
+ * Set the console logging level.
+ * Only messages at or above this level will be displayed.
+ * @param level - The minimum level to display
+ */
+export const setConsoleLevel = (level) => {
+    consoleLevelState.currentLevel = level;
+};
+/**
+ * Get the current console logging level.
+ * @returns The current console level
+ */
+export const getConsoleLevel = () => {
+    return consoleLevelState.currentLevel;
+};
+/**
+ * Reset console level to default (INFO) for testing purposes
+ */
+export const resetConsoleLevel = () => {
+    consoleLevelState.currentLevel = StatusLevel.INFO;
+};
+/**
+ * Check if a given status level should be displayed based on current console level.
+ * @param level - The status level to check
+ * @returns true if the level should be displayed
+ */
+function shouldDisplayLevel(level) {
+    // Use enum values for comparison (higher values = more verbose)
+    return level >= consoleLevelState.currentLevel;
+}
+export const flushSessionLog = () => {
+    // Streams auto-flush, so this is now a no-op for API compatibility
+    // Could potentially force flush if needed in the future
+};
+export const stopSessionLogging = () => {
+    closeLogStream();
+    loggingState.sessionLogFile = undefined;
+    loggingState.enableSessionLogging = false;
+};
+export function displayError(message) {
+    if (!shouldDisplayLevel(StatusLevel.ERROR))
+        return;
+    const coloredMessage = colorText(message, 'red');
+    writeToSessionLog(message + '\n');
+    su.log(coloredMessage);
+}
+export function displayWarning(message) {
+    if (!shouldDisplayLevel(StatusLevel.WARNING))
+        return;
+    const coloredMessage = colorText(message, 'yellow');
+    writeToSessionLog(message + '\n');
+    su.warn(coloredMessage);
+}
+export function displaySuccess(message) {
+    if (!shouldDisplayLevel(StatusLevel.SUCCESS))
+        return;
+    const coloredMessage = colorText(message, 'green');
+    writeToSessionLog(message + '\n');
+    su.log(coloredMessage);
+}
+export function displayInfo(message) {
+    if (!shouldDisplayLevel(StatusLevel.INFO))
+        return;
+    const coloredMessage = colorText(message, 'dim');
+    writeToSessionLog(message + '\n');
+    su.info(coloredMessage);
+}
+export function display(message) {
+    if (!shouldDisplayLevel(StatusLevel.DISPLAY))
+        return;
+    writeToSessionLog(message + '\n');
+    su.log(message);
+}
+export function formatInputPrompt(message) {
+    return colorText(message, 'magenta');
+}
+/**
+ * Display a debug message to the console and log it.
+ * This function also integrates with debugUtils to output logs when at debug level.
+ * Note: There is also a dedicated debug() function in debugUtils for more detailed logging.
+ * @param message - The message to display (string, Error, or undefined)
+ */
+export function displayDebug(message) {
+    if (!shouldDisplayLevel(StatusLevel.DEBUG))
+        return;
+    if (message instanceof Error) {
+        const stackTrace = message.stack || '';
+        writeToSessionLog(stackTrace + '\n');
+        su.debug(stackTrace);
+        // Also log to debugUtils when at debug level
+        debugLog(stackTrace);
+    }
+    else if (message !== undefined) {
+        writeToSessionLog(message + '\n');
+        su.debug(message);
+        // Also log to debugUtils when at debug level
+        debugLog(message);
+    }
+}
+// Create status update callback
+export const defaultStatusCallback = (level, message) => {
+    switch (level) {
+        case StatusLevel.INFO:
+            displayInfo(message);
+            break;
+        case StatusLevel.WARNING:
+            displayWarning(message);
+            break;
+        case StatusLevel.ERROR:
+            displayError(message);
+            break;
+        case StatusLevel.SUCCESS:
+            displaySuccess(message);
+            break;
+        case StatusLevel.DEBUG:
+            displayDebug(message);
+            break;
+        case StatusLevel.DISPLAY:
+            display(message);
+            break;
+        case StatusLevel.STREAM:
+            if (shouldDisplayLevel(StatusLevel.STREAM)) {
+                writeToSessionLog(message);
+                stream(message);
+            }
+            break;
+    }
+};
+/**
+ * Parse a CLI option value into either:
+ * - a boolean (when value looks like a true/false token),
+ * - a non-empty string (otherwise),
+ * - or none (when value is nullish or only whitespace).
+ *
+ * Recognized false-like tokens (case-insensitive): 'false', '0', 'n', 'no'
+ * Recognized true-like tokens (case-insensitive):  'true', '1', 'y', 'yes'
+ *
+ * Examples:
+ *  parseBooleanOrString('n')         => { kind: 'boolean', value: false }
+ *  parseBooleanOrString('0')         => { kind: 'boolean', value: false }
+ *  parseBooleanOrString('true')      => { kind: 'boolean', value: true }
+ *  parseBooleanOrString('1')         => { kind: 'boolean', value: true }
+ *  parseBooleanOrString('review.md') => { kind: 'string',  value: 'review.md' }
+ *  parseBooleanOrString('  ')        => { kind: 'none' }
+ *  parseBooleanOrString(undefined)   => { kind: 'none' }
+ */
+export function parseBooleanOrString(value) {
+    if (value === undefined || value === null) {
+        return { kind: 'none' };
+    }
+    const str = String(value);
+    const trimmed = str.trim();
+    if (trimmed.length === 0) {
+        return { kind: 'none' };
+    }
+    const lower = trimmed.toLowerCase();
+    // False-like tokens
+    if (lower === 'false' || lower === '0' || lower === 'n' || lower === 'no') {
+        return { kind: 'boolean', value: false };
+    }
+    // True-like tokens
+    if (lower === 'true' || lower === '1' || lower === 'y' || lower === 'yes') {
+        return { kind: 'boolean', value: true };
+    }
+    // Otherwise, treat as a string (e.g., filename/path)
+    return { kind: 'string', value: trimmed };
+}
+/**
+ * Convenience wrapper that returns a union directly instead of the tagged result.
+ *
+ * Returns:
+ * - boolean when the input is a boolean-like token
+ * - string when the input is non-empty and not a boolean-like token
+ * - undefined when the input is nullish or empty/whitespace
+ */
+export function coerceBooleanOrString(value) {
+    const parsed = parseBooleanOrString(value);
+    switch (parsed.kind) {
+        case 'boolean':
+            return parsed.value;
+        case 'string':
+            return parsed.value;
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=consoleUtils.js.map

package/dist/utils/consoleUtils.js.map

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

package/dist/utils/debugUtils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Initialize debug logging based on config
+ */
+export declare function initDebugLogging(enabled: boolean): void;
+/**
+ * Log a debug message to the log file
+ */
+export declare function debugLog(message: string): void;
+/**
+ * Log multiple lines with proper formatting
+ */
+export declare function debugLogMultiline(title: string, content: string): void;
+/**
+ * Log an object using Node.js inspect with reasonable depth
+ */
+export declare function debugLogObject(title: string, obj: unknown): void;
+/**
+ * Log error with stack trace
+ */
+export declare function debugLogError(context: string, error: unknown): void;

package/dist/utils/debugUtils.js

@@ -0,0 +1,89 @@
+import { appendFileSync, mkdirSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { inspect } from 'node:util';
+const DEBUG_LOG_FILE = 'gaunt-sloth.log';
+let debugEnabled = false;
+/**
+ * Initialize debug logging based on config
+ */
+export function initDebugLogging(enabled) {
+    debugEnabled = enabled;
+    if (debugEnabled) {
+        // Ensure the log file directory exists
+        const logPath = resolve(DEBUG_LOG_FILE);
+        const logDir = dirname(logPath);
+        try {
+            mkdirSync(logDir, { recursive: true });
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        }
+        catch (error) {
+            // Directory might already exist, ignore error
+        }
+        // Log initialization
+        debugLog('=== Debug logging initialized ===');
+        debugLog(`Timestamp: ${new Date().toISOString()}`);
+        debugLog(`Log file: ${logPath}`);
+        debugLog('================================\n');
+    }
+}
+/**
+ * Log a debug message to the log file
+ */
+export function debugLog(message) {
+    if (!debugEnabled)
+        return;
+    const timestamp = new Date().toISOString();
+    const logEntry = `[${timestamp}] ${message}\n`;
+    try {
+        appendFileSync(resolve(DEBUG_LOG_FILE), logEntry, 'utf8');
+    }
+    catch (error) {
+        // Ignore logging errors to prevent breaking the main flow
+        console.error('Failed to write to debug log:', error);
+    }
+}
+/**
+ * Log multiple lines with proper formatting
+ */
+export function debugLogMultiline(title, content) {
+    if (!debugEnabled)
+        return;
+    debugLog(`=== ${title} ===`);
+    debugLog(content);
+    debugLog(`=== End ${title} ===\n`);
+}
+/**
+ * Log an object using Node.js inspect with reasonable depth
+ */
+export function debugLogObject(title, obj) {
+    if (!debugEnabled)
+        return;
+    try {
+        // Use Node.js inspect with reasonable depth and no colors for log files
+        const formatted = inspect(obj, { showHidden: false, depth: 3, colors: false });
+        debugLogMultiline(title, formatted);
+    }
+    catch (error) {
+        debugLog(`Failed to inspect ${title}: ${error}`);
+    }
+}
+/**
+ * Log error with stack trace
+ */
+export function debugLogError(context, error) {
+    if (!debugEnabled)
+        return;
+    debugLog(`❌ Error in ${context}:`);
+    if (error instanceof Error) {
+        debugLog(`  Message: ${error.message}`);
+        if (error.stack) {
+            debugLog('  Stack trace:');
+            error.stack.split('\n').forEach((line) => debugLog(`    ${line}`));
+        }
+    }
+    else {
+        debugLog(`  Error: ${String(error)}`);
+    }
+    debugLog('');
+}
+//# sourceMappingURL=debugUtils.js.map

package/dist/utils/debugUtils.js.map

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

package/dist/utils/fileUtils.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Checks if .gsloth directory exists in the project root
+ * @returns Boolean indicating whether .gsloth directory exists
+ */
+export declare function gslothDirExists(): boolean;
+/**
+ * Gets the path where gsloth should write files based on .gsloth directory existence
+ * @param filename The filename to append to the path
+ * @returns The resolved path where the file should be written
+ */
+export declare function getGslothFilePath(filename: string): string;
+/**
+ * Gets the path where gsloth should write configuration files based on .gsloth directory existence.
+ * The main difference from {@link #getGslothConfigReadPath} is that this getGslothConfigWritePath
+ * method creates internal settings directory if it does not exist.
+ *
+ * If .gsloth dir exists returns `projectdir/.gsloth/.gsloth-settings`
+ * If .gsloth dir does not exist returns `projectdir`
+ *
+ * @param filename The configuration filename
+ * @returns The resolved path where the configuration file should be written
+ */
+export declare function getGslothConfigWritePath(filename: string): string;
+/**
+ * Gets the path where gsloth should look for configuration files based on .gsloth directory existence
+ * @param filename The configuration filename to look for
+ * @param identityProfileRaw The identity profile dir within GSLOTH_SETTINGS_DIR to look for the configuration file in.
+ * @returns The resolved path where the configuration file should be found
+ */
+export declare function getGslothConfigReadPath(filename: string, identityProfileRaw: string | undefined): string;
+/**
+ * Resolve an explicit output path string to an absolute file path.
+ * Concerned only with string values:
+ * - If the string includes a path separator, resolve relative to project root and ensure parent directories exist.
+ * - If it's a bare filename, place it under .gsloth/ when present, otherwise project root.
+ */
+export declare function resolveOutputPath(writeOutputToFile: string): string;
+export declare function toFileSafeString(string: string): string;
+/**
+ * Returns a formatted date string in the format YYYY-MM-DD_HH-MM-SS using local time
+ * @returns A formatted date string
+ */
+export declare function fileSafeLocalDate(): string;
+/**
+ * Generates a standardized filename with the format: gth_YYYY-MM-DD_HH-MM-SS_COMMAND.md
+ * @param command - The command that created the file (ASK, REVIEW, PR, etc.)
+ * @returns A standardized filename string
+ */
+export declare function generateStandardFileName(command: string): string;
+export declare function readFileFromProjectDir(fileName: string): string;
+export declare function readFileFromInstallDir(filePath: string): string;
+export declare function writeFileIfNotExistsWithMessages(filePath: string, content: string): void;
+export declare function appendToFile(filePath: string, content: string): void;
+export declare function readFileSyncWithMessages(filePath: string, errorMessageIn?: string, noFileMessage?: string): string;
+/**
+ * Dynamically imports a module from a file path from the outside of the installation dir
+ * @returns A promise that resolves to the imported module
+ */
+export declare function importExternalFile(filePath: string): Promise<Record<string, any>>;
+/**
+ * Returns the output file path for a given command execution based on configuration.
+ * - If writeOutputToFile is false, returns null.
+ * - If writeOutputToFile is a string, resolves it without generating a default filename.
+ * - If writeOutputToFile is true, generates a standard filename from source and resolves it under .gsloth/ (when present) or project root.
+ */
+export declare function getCommandOutputFilePath(config: {
+    writeOutputToFile: boolean | string;
+}, source: string): string | null;