gaunt-sloth-assistant 0.1.5 → 0.3.0

package/dist/providers/jiraIssueProvider.js

@@ -0,0 +1,96 @@
+import { display, displayError, displayWarning } from '#src/consoleUtils.js';
+import { env } from '#src/systemUtils.js';
+/**
+ * Gets Jira issue using Atlassian REST API v3 with Personal Access Token
+ *
+ * TODO we need to figure out how would this work with public jira.
+ *
+ * @param config Jira configuration
+ * @param issueId Jira issue ID
+ * @returns Jira issue content
+ */
+export async function get(config, issueId) {
+    if (!config) {
+        displayWarning('No Jira config provided');
+        return null;
+    }
+    if (!issueId) {
+        displayWarning('No issue ID provided');
+        return null;
+    }
+    // Get username from environment variable or config
+    const username = env.JIRA_USERNAME || config.username;
+    if (!username) {
+        throw new Error('Missing JIRA username. The username can be defined as JIRA_USERNAME environment variable or as "username" in config.');
+    }
+    // Get token from environment variable or config
+    const token = env.JIRA_API_PAT_TOKEN || config.token;
+    if (!token) {
+        throw new Error('Missing JIRA PAT token. The token can be defined as JIRA_API_PAT_TOKEN environment variable or as "token" in config.');
+    }
+    // Get cloud ID from environment variable or config
+    const cloudId = env.JIRA_CLOUD_ID || config.cloudId;
+    if (!cloudId) {
+        throw new Error('Missing JIRA Cloud ID. The Cloud ID can be defined as JIRA_CLOUD_ID environment variable or as "cloudId" in config.');
+    }
+    try {
+        const issue = await getJiraIssue({
+            ...config,
+            username,
+            token,
+            cloudId,
+        }, issueId);
+        if (!issue) {
+            return null;
+        }
+        const summary = issue.fields.summary;
+        const description = issue.fields.description;
+        return `Jira Issue: ${issueId}\nSummary: ${summary}\n\nDescription:\n${description}`;
+    }
+    catch (error) {
+        displayError(`Failed to get Jira issue: ${error instanceof Error ? error.message : String(error)}`);
+        return null;
+    }
+}
+/**
+ * Helper function to get Jira issue details using Atlassian REST API v3
+ * @param config Jira configuration
+ * @param jiraKey Jira issue ID
+ * @returns Jira issue response
+ */
+async function getJiraIssue(config, jiraKey) {
+    // Jira Cloud ID can be found by authenticated user at https://company.atlassian.net/_edge/tenant_info
+    // According to doc https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-get permissions to read this resource:
+    // either Classic (RECOMMENDED) read:jira-work
+    // or Granular read:issue-meta:jira, read:issue-security-level:jira, read:issue.vote:jira, read:issue.changelog:jira, read:avatar:jira, read:issue:jira, read:status:jira, read:user:jira, read:field-configuration:jira
+    const apiUrl = `https://api.atlassian.com/ex/jira/${config.cloudId}/rest/api/3/issue/${jiraKey}`;
+    if (config.displayUrl) {
+        display(`Loading Jira issue ${config.displayUrl}${jiraKey}`);
+    }
+    display(`Retrieving jira from api ${apiUrl.replace(/^https?:\/\//, '')}`);
+    // Encode credentials for Basic Authentication header
+    const credentials = `${config.username}:${config.token}`;
+    const encodedCredentials = Buffer.from(credentials).toString('base64');
+    const authHeader = `Basic ${encodedCredentials}`;
+    // Define request headers
+    const headers = {
+        Authorization: authHeader,
+        Accept: 'application/json; charset=utf-8',
+        'Accept-Language': 'en-US,en;q=0.9', // Prevents errors in other languages
+    };
+    const response = await fetch(apiUrl, {
+        method: 'GET',
+        headers: headers,
+    });
+    if (!response?.ok) {
+        try {
+            const errorData = await response.json();
+            throw new Error(`Failed to fetch Jira issue: ${response.statusText} - ${JSON.stringify(errorData)}`);
+        }
+        catch (_e) {
+            throw new Error(`Failed to fetch Jira issue: ${response?.statusText}`);
+        }
+    }
+    return response.json();
+}
+//# sourceMappingURL=jiraIssueProvider.js.map

package/dist/providers/jiraIssueProvider.js.map

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

package/dist/providers/text.d.ts

@@ -0,0 +1,8 @@
+import type { ProviderConfig } from './types.js';
+/**
+ * Returns the provided text as is
+ * @param _ config (unused in this provider)
+ * @param text Text to return
+ * @returns The provided text
+ */
+export declare function get(_: ProviderConfig | null, text: string | undefined): Promise<string | null>;

package/dist/providers/text.js

@@ -0,0 +1,10 @@
+/**
+ * Returns the provided text as is
+ * @param _ config (unused in this provider)
+ * @param text Text to return
+ * @returns The provided text
+ */
+export async function get(_, text) {
+    return text ?? null;
+}
+//# sourceMappingURL=text.js.map

package/dist/providers/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/providers/text.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,CAAwB,EACxB,IAAwB;IAExB,OAAO,IAAI,IAAI,IAAI,CAAC;AACtB,CAAC"}

package/dist/providers/types.d.ts

@@ -0,0 +1,21 @@
+export interface ProviderConfig {
+    username?: string;
+    token?: string;
+    baseUrl?: string;
+    [key: string]: unknown;
+}
+export interface JiraLegacyConfig extends ProviderConfig {
+    username: string;
+    baseUrl: string;
+    displayUrl?: string;
+    token: string;
+}
+export interface JiraConfig extends ProviderConfig {
+    cloudId: string;
+    username: string;
+    displayUrl?: string;
+    token: string;
+}
+export interface Provider {
+    get: (config: ProviderConfig | null, id: string | undefined) => Promise<string | null>;
+}

package/dist/providers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":""}

package/dist/systemUtils.d.ts

@@ -0,0 +1,32 @@
+import { Command } from 'commander';
+export declare const getCurrentDir: () => string;
+export declare const getInstallDir: () => string;
+/**
+ * Cached string from stdin. Should only be called after readStdin completes execution.
+ */
+export declare const getStringFromStdin: () => string;
+export declare const exit: (code?: number) => never;
+export declare const stdin: NodeJS.ReadStream & {
+    fd: 0;
+};
+export declare const stdout: NodeJS.WriteStream & {
+    fd: 1;
+};
+export declare const argv: string[];
+export declare const env: NodeJS.ProcessEnv;
+/**
+ * Provide the path to the entry point of the application.
+ * This is used to set the install directory.
+ * This is called from index.js root entry point.
+ */
+export declare const setEntryPoint: (indexJs: string) => void;
+/**
+ * Asynchronously reads the stdin and stores it as a string,
+ * it can later be retrieved with getStringFromStdin.
+ */
+export declare function readStdin(program: Command): Promise<void>;
+export declare const log: (message: string) => void;
+export declare const error: (message: string) => void;
+export declare const warn: (message: string) => void;
+export declare const info: (message: string) => void;
+export declare const debug: (message: string) => void;

package/dist/systemUtils.js

@@ -0,0 +1,70 @@
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'url';
+import { ProgressIndicator } from '#src/utils.js';
+const innerState = {
+    installDir: undefined,
+    stringFromStdin: '',
+};
+// Process-related functions and objects
+export const getCurrentDir = () => process.cwd();
+export const getInstallDir = () => {
+    if (innerState.installDir) {
+        return innerState.installDir;
+    }
+    throw new Error('Install directory not set');
+};
+/**
+ * Cached string from stdin. Should only be called after readStdin completes execution.
+ */
+export const getStringFromStdin = () => {
+    return innerState.stringFromStdin;
+};
+export const exit = (code) => process.exit(code || 0);
+export const stdin = process.stdin;
+export const stdout = process.stdout;
+export const argv = process.argv;
+export const env = process.env;
+// noinspection JSUnusedGlobalSymbols
+/**
+ * Provide the path to the entry point of the application.
+ * This is used to set the install directory.
+ * This is called from index.js root entry point.
+ */
+export const setEntryPoint = (indexJs) => {
+    const filePath = fileURLToPath(indexJs);
+    const dirPath = dirname(filePath);
+    innerState.installDir = resolve(dirPath);
+};
+/**
+ * Asynchronously reads the stdin and stores it as a string,
+ * it can later be retrieved with getStringFromStdin.
+ */
+export function readStdin(program) {
+    return new Promise((resolvePromise) => {
+        if (stdin.isTTY) {
+            program.parseAsync().then(() => resolvePromise());
+        }
+        else {
+            // Support piping diff into gsloth
+            const progressIndicator = new ProgressIndicator('reading STDIN', true);
+            stdin.on('readable', function () {
+                const chunk = this.read();
+                progressIndicator.indicate();
+                if (chunk !== null) {
+                    const chunkStr = chunk.toString('utf8');
+                    innerState.stringFromStdin = innerState.stringFromStdin + chunkStr;
+                }
+            });
+            stdin.on('end', function () {
+                program.parseAsync(argv).then(() => resolvePromise());
+            });
+        }
+    });
+}
+// Console-related functions
+export const log = (message) => console.log(message);
+export const error = (message) => console.error(message);
+export const warn = (message) => console.warn(message);
+export const info = (message) => console.info(message);
+export const debug = (message) => console.debug(message);
+//# sourceMappingURL=systemUtils.js.map

package/dist/systemUtils.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,49 @@
+import { SlothConfig } from '#src/config.js';
+export declare function toFileSafeString(string: string): string;
+export declare function fileSafeLocalDate(): string;
+export declare function readFileFromCurrentDir(fileName: string): string;
+export declare function readFileFromCurrentOrInstallDir(filePath: string, silentCurrent?: boolean): string;
+export declare function writeFileIfNotExistsWithMessages(filePath: string, content: string): void;
+export declare function readFileSyncWithMessages(filePath: string, errorMessageIn?: string, noFileMessage?: string): string;
+export declare function spawnCommand(command: string, args: string[], progressMessage: string, successMessage: string): Promise<string>;
+export declare function getSlothVersion(): string;
+export declare class ProgressIndicator {
+    private interval;
+    constructor(initialMessage: string, manual?: boolean);
+    private indicateInner;
+    indicate(): void;
+    stop(): void;
+}
+interface LLMOutput {
+    messages: Array<{
+        content: string;
+    }>;
+}
+/**
+ * Extracts the content of the last message from an LLM response
+ * @param output - The output from the LLM containing messages
+ * @returns The content of the last message
+ */
+export declare function extractLastMessageContent(output: LLMOutput): string;
+/**
+ * Dynamically imports a module from a file path from the outside of the installation dir
+ * @param filePath - The path to the file to import
+ * @returns A promise that resolves to the imported module
+ */
+export declare function importExternalFile(filePath: string): Promise<{
+    configure: (module: string) => Promise<Partial<SlothConfig>>;
+}>;
+/**
+ * Alias for importExternalFile for backward compatibility with tests
+ * @param filePath - The path to the file to import
+ * @returns A promise that resolves to the imported module
+ */
+export declare const importFromFilePath: typeof importExternalFile;
+/**
+ * Reads multiple files from the current directory and returns their contents
+ * @param fileNames - Array of file names to read
+ * @returns Combined content of all files with proper formatting
+ */
+export declare function readMultipleFilesFromCurrentDir(fileNames: string | string[]): string;
+export declare function execAsync(command: string): Promise<string>;
+export {};

package/dist/utils.js

@@ -0,0 +1,192 @@
+import { display, displayError, displaySuccess, displayWarning } from '#src/consoleUtils.js';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { spawn } from 'node:child_process';
+import { getCurrentDir, getInstallDir, stdout } from '#src/systemUtils.js';
+import url from 'node:url';
+export function toFileSafeString(string) {
+    return string.replace(/[^A-Za-z0-9]/g, '-');
+}
+export function fileSafeLocalDate() {
+    const date = new Date();
+    const offsetMs = date.getTimezoneOffset() * 60 * 1000;
+    const msLocal = date.getTime() - offsetMs;
+    const dateLocal = new Date(msLocal);
+    const iso = dateLocal.toISOString();
+    const isoLocal = iso.slice(0, 19);
+    return toFileSafeString(isoLocal);
+}
+export function readFileFromCurrentDir(fileName) {
+    const currentDir = getCurrentDir();
+    const filePath = resolve(currentDir, fileName);
+    display(`Reading file ${filePath}...`);
+    return readFileSyncWithMessages(filePath);
+}
+export function readFileFromCurrentOrInstallDir(filePath, silentCurrent) {
+    const currentDir = getCurrentDir();
+    const currentFilePath = resolve(currentDir, filePath);
+    if (!silentCurrent) {
+        display(`Reading file ${currentFilePath}...`);
+    }
+    try {
+        return readFileSync(currentFilePath, { encoding: 'utf8' });
+    }
+    catch (_error) {
+        if (!silentCurrent) {
+            display(`The ${currentFilePath} not found or can\'t be read, trying install directory...`);
+        }
+        const installDir = getInstallDir();
+        const installFilePath = resolve(installDir, filePath);
+        try {
+            return readFileSync(installFilePath, { encoding: 'utf8' });
+        }
+        catch (readFromInstallDirError) {
+            displayError(`The ${installFilePath} not found or can\'t be read.`);
+            throw readFromInstallDirError;
+        }
+    }
+}
+export function writeFileIfNotExistsWithMessages(filePath, content) {
+    display(`checking ${filePath} existence`);
+    if (!existsSync(filePath)) {
+        writeFileSync(filePath, content);
+        displaySuccess(`Created ${filePath}`);
+    }
+    else {
+        displayWarning(`${filePath} already exists`);
+    }
+}
+export function readFileSyncWithMessages(filePath, errorMessageIn, noFileMessage) {
+    const errorMessage = errorMessageIn ?? 'Error reading file at: ';
+    try {
+        return readFileSync(filePath, { encoding: 'utf8' });
+    }
+    catch (error) {
+        displayError(errorMessage + filePath);
+        if (error.code === 'ENOENT') {
+            displayWarning(noFileMessage ?? 'Please ensure the file exists.');
+        }
+        else {
+            displayError(error.message);
+        }
+        throw error;
+    }
+}
+export async function spawnCommand(command, args, progressMessage, successMessage) {
+    return new Promise((resolve, reject) => {
+        const progressIndicator = new ProgressIndicator(progressMessage, true);
+        const out = { stdout: '', stderr: '' };
+        const spawned = spawn(command, args);
+        spawned.stdout.on('data', async (stdoutChunk) => {
+            progressIndicator.indicate();
+            out.stdout += stdoutChunk.toString();
+        });
+        spawned.stderr.on('data', (err) => {
+            progressIndicator.indicate();
+            out.stderr += err.toString();
+        });
+        spawned.on('error', (err) => {
+            reject(err.toString());
+        });
+        spawned.on('close', (code) => {
+            if (code === 0) {
+                display(successMessage);
+                resolve(out.stdout);
+            }
+            else {
+                displayError(`Failed to spawn command with code ${code}`);
+                reject(out.stdout + ' ' + out.stderr);
+            }
+        });
+    });
+}
+export function getSlothVersion() {
+    // TODO figure out if this can be injected with TS
+    const installDir = getInstallDir();
+    const jsonPath = resolve(installDir, 'package.json');
+    const projectJson = readFileSync(jsonPath, { encoding: 'utf8' });
+    return JSON.parse(projectJson).version;
+}
+export class ProgressIndicator {
+    interval = undefined;
+    constructor(initialMessage, manual) {
+        stdout.write(initialMessage);
+        if (!manual) {
+            this.interval = setInterval(this.indicateInner, 1000);
+        }
+    }
+    indicateInner() {
+        stdout.write('.');
+    }
+    indicate() {
+        if (this.interval) {
+            throw new Error('ProgressIndicator.indicate only to be called in manual mode');
+        }
+        this.indicateInner();
+    }
+    stop() {
+        if (this.interval) {
+            clearInterval(this.interval);
+        }
+        stdout.write('\n');
+    }
+}
+/**
+ * Extracts the content of the last message from an LLM response
+ * @param output - The output from the LLM containing messages
+ * @returns The content of the last message
+ */
+export function extractLastMessageContent(output) {
+    if (!output || !output.messages || !output.messages.length) {
+        return '';
+    }
+    return output.messages[output.messages.length - 1].content;
+}
+/**
+ * Dynamically imports a module from a file path from the outside of the installation dir
+ * @param filePath - The path to the file to import
+ * @returns A promise that resolves to the imported module
+ */
+export function importExternalFile(filePath) {
+    const configFileUrl = url.pathToFileURL(filePath).toString();
+    return import(configFileUrl);
+}
+/**
+ * Alias for importExternalFile for backward compatibility with tests
+ * @param filePath - The path to the file to import
+ * @returns A promise that resolves to the imported module
+ */
+export const importFromFilePath = importExternalFile;
+/**
+ * Reads multiple files from the current directory and returns their contents
+ * @param fileNames - Array of file names to read
+ * @returns Combined content of all files with proper formatting
+ */
+export function readMultipleFilesFromCurrentDir(fileNames) {
+    if (!Array.isArray(fileNames)) {
+        return readFileFromCurrentDir(fileNames);
+    }
+    return fileNames
+        .map((fileName) => {
+        const content = readFileFromCurrentDir(fileName);
+        return `${fileName}:\n\`\`\`\n${content}\n\`\`\``;
+    })
+        .join('\n\n');
+}
+export async function execAsync(command) {
+    const { exec } = await import('node:child_process');
+    return new Promise((resolve, reject) => {
+        exec(command, (error, stdout, stderr) => {
+            if (error) {
+                reject(error);
+                return;
+            }
+            if (stderr) {
+                reject(new Error(stderr));
+                return;
+            }
+            resolve(stdout.trim());
+        });
+    });
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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