gaunt-sloth-assistant 0.3.2 → 0.4.1

package/docs/CONFIGURATION.md

@@ -1,7 +1,7 @@
 # Configuration
 
 Populate `.gsloth.guidelines.md` with your project details and quality requirements.
-Proper preamble is a paramount for good inference.
+A proper preamble is paramount for good inference.
 Check [.gsloth.guidelines.md](../.gsloth.guidelines.md) for example.
 
 Your project should have the following files in order for gsloth to function:
@@ -35,6 +35,40 @@ If the `.gsloth` directory doesn't exist, gsloth will continue writing all files
 
 **Note:** When initializing a project with an existing `.gsloth` directory, the configuration files will be created in the `.gsloth/.gsloth-settings` directory automatically. There is no automated migration for existing configurations - if you create a `.gsloth` directory after initialization, you'll need to manually move your configuration files into the `.gsloth/.gsloth-settings` directory.
 
+## Configuration Object
+
+It is always worth checking sourcecode in [config.ts](../src/config.ts) for more insightful information.
+
+| Parameter                                | Required                          | Default Value | Description                                                                                                                                                                                                                                                |
+|------------------------------------------|-----------------------------------|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `llm`                                    | Required                          | -             | An object configuring LLM. In JS config could be actual instance of LangChainJS [BaseChatModel](https://v03.api.js.langchain.com/classes/_langchain_core.language_models_chat_models.BaseChatModel.html), allowing to use LLMs which do not have a preset. |
+| `llm.type`                               | Required (when using JSON config) | -             | LLM type or provider. Options currently available are `anthropic`, `groq` and `vertexai`. To use other models supported by LangChainJS, please use JavaScript config.                                                                                      |
+| `llm.model`                              | Optional                          | -             | Particular LLM model string (Check in your provider documentation).                                                                                                                                                                                        |
+| `llm.apiKey`                             | Optional                          | -             | API key for the LLM provider. You can either use this parameter or use environment variable.                                                                                                                                                               |
+| `contentProvider`                        | Optional                          | `file`        | Default content provider used to get content for review. Options available are `github`, `file` and `text` (`text` provides text as it is).                                                                                                                |
+| `requirementsProvider`                   | Optional                          | `file`        | Default requirements provider used to get requirements for review. Options available are `jira`, `jira-legacy`, `github`, `file` and `text`.                                                                                                               |
+| `projectGuidelines`                      | Optional                          | `.gsloth.guidelines.md` | Path to the file containing project guidelines.                                                                                                                                                                                                           |
+| `projectReviewInstructions`              | Optional                          | `.gsloth.review.md` | Path to the file containing project review instructions.                                                                                                                                                                                                   |
+| `commands`                               | Optional                          | -             | Configuration for specific commands.                                                                                                                                                                                                                       |
+| `commands.pr`                            | Optional                          | -             | Configuration for the PR command.                                                                                                                                                                                                                          |
+| `commands.pr.contentProvider`            | Optional                          | `github`      | Content provider used for PR review (`gsloth pr`).                                                                                                                                                                                                         |
+| `commands.pr.requirementsProvider`       | Optional                          | `github`      | Requirements provider used for PR review. If not specified, falls back to the global `requirementsProvider`.                                                                                                                                                |
+| `commands.review`                        | Optional                          | -             | Configuration for the review command.                                                                                                                                                                                                                      |
+| `commands.review.contentProvider`        | Optional                          | -             | Content provider specifically for the review command. If not specified, falls back to the global `contentProvider`.                                                                                                                                         |
+| `commands.review.requirementsProvider`   | Optional                          | -             | Requirements provider specifically for the review command. If not specified, falls back to the global `requirementsProvider`.                                                                                                                               |
+| `requirementsProviderConfig`             | Optional                          | -             | Configuration for requirements providers. Contains provider-specific configurations.                                                                                                                                                                        |
+| `requirementsProviderConfig.jira`        | Optional                          | -             | Configuration for the Jira requirements provider (Atlassian REST API v3 with Personal Access Token).                                                                                                                                                       |
+| `requirementsProviderConfig.jira.username` | Optional                          | -             | Jira username (email). Can also be set via JIRA_USERNAME environment variable.                                                                                                                                                                             |
+| `requirementsProviderConfig.jira.token`  | Optional                          | -             | Jira Personal Access Token. Can also be set via JIRA_API_PAT_TOKEN environment variable.                                                                                                                                                                   |
+| `requirementsProviderConfig.jira.cloudId` | Required for `jira`                | -             | Atlassian Cloud ID. Can also be set via JIRA_CLOUD_ID environment variable.                                                                                                                                                                                |
+| `requirementsProviderConfig.jira.displayUrl` | Optional                          | -             | Optional URL for displaying Jira issues (e.g., "https://yourcompany.atlassian.net/browse/").                                                                                                                                                               |
+| `requirementsProviderConfig.jira-legacy` | Optional                          | -             | Configuration for the Jira Legacy requirements provider (Atlassian REST API v2 with Legacy API Token).                                                                                                                                                     |
+| `requirementsProviderConfig.jira-legacy.username` | Optional                          | -             | Jira username (email). Can also be set via JIRA_USERNAME environment variable.                                                                                                                                                                             |
+| `requirementsProviderConfig.jira-legacy.token` | Optional                          | -             | Jira Legacy API Token. Can also be set via JIRA_LEGACY_API_TOKEN environment variable.                                                                                                                                                                     |
+| `requirementsProviderConfig.jira-legacy.baseUrl` | Required for `jira-legacy`          | -             | Base URL for the Jira API (e.g., "https://yourcompany.atlassian.net/rest/api/2/issue/").                                                                                                                                                                  |
+| `requirementsProviderConfig.jira-legacy.displayUrl` | Optional                          | -             | Optional URL for displaying Jira issues (e.g., "https://yourcompany.atlassian.net/browse/").                                                                                                                                                               |
+| `contentProviderConfig`                  | Optional                          | -             | Configuration for content providers. Currently, the available content providers (`github`, `file`, and `text`) don't require specific configuration.                                                                                                        |
+
 ## Config initialization
 Configuration can be created with `gsloth init [vendor]` command.
 Currently, vertexai, anthropic and groq can be configured with `gsloth init [vendor]`.
@@ -141,9 +175,7 @@ export async function configure(importFunction, global) {
 }
 ```
 
-**Example of .gsloth.config.js for Groq**  
-VertexAI usually needs `gcloud auth application-default login`
-(or both `gcloud auth login` and `gcloud auth application-default login`) and does not need any separate API keys.
+**Example of .gsloth.config.js for Groq**
 ```javascript
 export async function configure(importFunction, global) {
     // this is going to be imported from sloth dependencies,
@@ -165,6 +197,46 @@ See [Langchain documentation](https://js.langchain.com/docs/tutorials/llm_chain/
 
 ## Content providers
 
+### GitHub Issues
+
+Gaunt Sloth supports GitHub issues as a requirements provider using the GitHub CLI. This integration is simple to use and requires minimal setup.
+
+**Prerequisites:**
+
+1. **GitHub CLI**: Make sure the official [GitHub CLI (gh)](https://cli.github.com/) is installed and authenticated
+2. **Repository Access**: Ensure you have access to the repository's issues
+
+**Usage:**
+
+The command syntax is `gsloth pr <prId> [githubIssueId]`. For example:
+
+```shell
+gsloth pr 42 23
+```
+
+This will review PR #42 and include GitHub issue #23 as requirements.
+
+To explicitly specify the GitHub issue provider:
+
+```shell
+gsloth pr 42 23 -p github
+```
+
+**Configuration:**
+
+To set GitHub as your default requirements provider, add this to your configuration file:
+
+```json
+{
+  "llm": {"type": "vertexai", "model": "gemini-2.5-pro-preview-05-06"},
+  "commands": {
+    "pr": {
+      "requirementsProvider": "github"
+    }
+  }
+}
+```
+
 ### JIRA
 
 Gaunt Sloth supports two methods to integrate with JIRA:

package/docs/DEVELOPMENT.md

@@ -11,8 +11,7 @@ npm install -g ./
 ```
 ## Testing
 
-Unit tests are implemented with [Jasmine](https://github.com/jasmine/jasmine)
-and [testdouble.js](https://github.com/testdouble/testdouble.js).
+Unit tests are implemented with [Vitest](https://vitest.dev/).
 
 Running unit tests:
 

package/docs/RELEASE-HOWTO.md

@@ -19,6 +19,10 @@ Note the release version and do
 ```shell
 gh release create --notes-from-tag
 ```
+or
+```shell
+gh release create --notes-file pathToFile
+```
 Alternatively `gh release create --notes "notes"`
 
 Publish to NPM

package/eslint.config.js

@@ -76,7 +76,7 @@ export default defineConfig([
   },
   // Test TypeScript files with separate project reference
   {
-    files: ['spec/**/*.ts', 'vitest.config.ts'],
+    files: ['spec/**/*.ts', 'integration-tests/**/*.ts', 'vitest.config.ts', 'vitest-it.config.ts'],
     languageOptions: {
       parser: tsParser,
       parserOptions: {

package/maintenance/doc-maintenance.md

@@ -0,0 +1,8 @@
+# README.md maintenance
+
+1. Inspect README.md
+2. Inspect docs/CONFIGURATION.md
+3. Perform fact-checking of contents with actual code
+   - Apply fact-checking edits if necessary
+4. Check grammar, punctuation and flow
+   - Apply edits if necessary.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gaunt-sloth-assistant",
-  "version": "0.3.2",
+  "version": "0.4.1",
   "description": "",
   "license": "MIT",
   "author": "Andrew Kondratev",
@@ -13,7 +13,8 @@
   },
   "scripts": {
     "build": "tsc",
-    "test": "npm run build &&vitest run",
+    "test": "npm run build && vitest run",
+    "it": "npm run build && vitest run --config vitest-it.config.ts",
     "lint": "eslint . --ext .js,.ts",
     "format": "prettier --write 'src/**/*.{js,ts}'",
     "prepare": "npm run build"
@@ -23,13 +24,13 @@
     "gth": "index.js"
   },
   "dependencies": {
-    "@langchain/anthropic": "^0.3.20",
+    "@langchain/anthropic": "^0.3.21",
     "@langchain/core": "^0.3.55",
     "@langchain/google-vertexai": "^0.2.8",
     "@langchain/groq": "^0.2.2",
     "@langchain/langgraph": "^0.2.71",
     "chalk": "^5.4.1",
-    "commander": "^13.1.0",
+    "commander": "^14.0.0",
     "uuid": "^11.1.0"
   },
   "devDependencies": {
@@ -39,7 +40,7 @@
     "@typescript-eslint/eslint-plugin": "^8.32.0",
     "@typescript-eslint/parser": "^8.32.0",
     "eslint": "^9.26.0",
-    "eslint-config-prettier": "^9.1.0",
+    "eslint-config-prettier": "^10.1.5",
     "eslint-plugin-prettier": "^5.1.3",
     "globals": "^16.1.0",
     "prettier": "3.5.3",

package/report.txt

@@ -0,0 +1,43 @@
+Summary of package.json:
+
+*   **Name**: `gaunt-sloth-assistant`
+*   **Version**: `0.4.0`
+*   **Description**: Not specified.
+*   **Author**: Andrew Kondratev
+*   **License**: MIT
+*   **Main entry point**: `dist/index.js`
+*   **Type**: `module`
+*   **Binaries/Commands**: `gsloth` and `gth` (both point to `index.js`)
+*   **Repository**: `github:andruhon/gaunt-sloth-assistant`
+*   **Node Engine Requirement**: `>=22.0.0`
+*   **NPM Engine Requirement**: `>=10.9.0`
+*   **Imports alias**: `#src/*.js` maps to `./dist/*.js`
+
+**Key Dependencies**:
+*   `@langchain/anthropic`
+*   `@langchain/core`
+*   `@langchain/google-vertexai`
+*   `@langchain/groq`
+*   `@langchain/langgraph`
+*   `@langchain/mcp-adapters`
+*   `@modelcontextprotocol/server-filesystem`
+*   `chalk`
+*   `commander`
+*   `uuid`
+
+**Key Dev Dependencies**:
+*   `eslint` and related plugins (for linting)
+*   `prettier` (for code formatting)
+*   `typescript`
+*   `vitest` (for testing)
+*   `@types/node`, `@types/uuid`
+
+**Scripts**:
+*   `build`: `tsc` (compiles TypeScript)
+*   `format`: `prettier --write 'src/**/*.{js,ts}'` (formats code)
+*   `it`: `npm run build && vitest run --config vitest-it.config.ts` (runs integration tests)
+*   `lint`: `eslint . --ext .js,.ts` (lints code)
+*   `prepare`: `npm run build` (runs build on prepare, e.g., before publishing)
+*   `test`: `npm run build && vitest run` (runs tests)
+
+This `package.json` defines a Node.js module written in TypeScript, utilizing LangChain and various other libraries for its functionality. It includes scripts for building, testing, linting, and formatting the code. It also specifies engine requirements and defines custom import paths.

package/src/commands/askCommand.ts

@@ -2,6 +2,7 @@ import { Command } from 'commander';
 import { readBackstory, readGuidelines } from '#src/prompt.js';
 import { readMultipleFilesFromCurrentDir } from '#src/utils.js';
 import { initConfig, slothContext } from '#src/config.js';
+import { getStringFromStdin } from '#src/systemUtils.js';
 
 interface AskCommandOptions {
   file?: string[];
@@ -15,19 +16,31 @@ export function askCommand(program: Command): void {
   program
     .command('ask')
     .description('Ask a question')
-    .argument('<message>', 'A message')
+    .argument('[message]', 'A message')
     .option(
       '-f, --file [files...]',
       'Input files. Content of these files will be added BEFORE the message'
     )
-    // TODO add option consuming extra message as argument
     .action(async (message: string, options: AskCommandOptions) => {
       await initConfig();
       const preamble = [readBackstory(), readGuidelines(slothContext.config.projectGuidelines)];
-      const content = [message];
+      const content = [];
       if (options.file) {
         content.push(readMultipleFilesFromCurrentDir(options.file));
       }
+      let stringFromStdin = getStringFromStdin();
+      if (stringFromStdin) {
+        content.push(stringFromStdin);
+      }
+      if (message) {
+        content.push(message);
+      }
+
+      // Validate that at least one input source is provided
+      if (content.length === 0) {
+        throw new Error('At least one of the following is required: file, stdin, or message');
+      }
+
       const { askQuestion } = await import('#src/modules/questionAnsweringModule.js');
       await askQuestion('ASK', preamble.join('\n'), content.join('\n'));
     });

package/src/commands/reviewCommand.ts

@@ -7,11 +7,13 @@ import { displayError } from '#src/consoleUtils.js';
 import { getStringFromStdin } from '#src/systemUtils.js';
 
 /**
- * Requirements providers. Expected to be in `.providers/` dir
+ * Requirements providers. Expected to be in `.providers/` dir.
+ * Aliases are mapped to actual providers in this file
  */
 const REQUIREMENTS_PROVIDERS = {
   'jira-legacy': 'jiraIssueLegacyProvider.js',
   jira: 'jiraIssueProvider.js',
+  github: 'ghIssueProvider.js',
   text: 'text.js',
   file: 'file.js',
 } as const;
@@ -19,10 +21,11 @@ const REQUIREMENTS_PROVIDERS = {
 type RequirementsProviderType = keyof typeof REQUIREMENTS_PROVIDERS;
 
 /**
- * Content providers. Expected to be in `.providers/` dir
+ * Content providers. Expected to be in `.providers/` dir.
+ * Aliases are mapped to actual providers in this file
  */
 const CONTENT_PROVIDERS = {
-  gh: 'ghPrDiffProvider.js',
+  github: 'ghPrDiffProvider.js',
   text: 'text.js',
   file: 'file.js',
 } as const;
@@ -82,11 +85,13 @@ export function reviewCommand(program: Command, context: SlothContext): void {
       const requirementsId = options.requirements;
       const requirementsProvider =
         options.requirementsProvider ??
-        (context.config?.review?.requirementsProvider as RequirementsProviderType | undefined) ??
+        (context.config?.commands?.review?.requirementsProvider as
+          | RequirementsProviderType
+          | undefined) ??
         (context.config?.requirementsProvider as RequirementsProviderType | undefined);
       const contentProvider =
         options.contentProvider ??
-        (context.config?.review?.contentProvider as ContentProviderType | undefined) ??
+        (context.config?.commands?.review?.contentProvider as ContentProviderType | undefined) ??
         (context.config?.contentProvider as ContentProviderType | undefined);
 
       // TODO consider calling these in parallel
@@ -118,8 +123,8 @@ export function reviewCommand(program: Command, context: SlothContext): void {
     .command('pr')
     .description(
       'Review provided Pull Request in current directory. ' +
-        'This command is similar to `review`, but default content provider is `gh`. ' +
-        '(assuming that GH cli is installed and authenticated for current project'
+        'This command is similar to `review`, but default content provider is `github`. ' +
+        '(assuming that GitHub CLI is installed and authenticated for current project'
     )
     .argument('<prId>', 'Pull request ID to review.')
     .argument(
@@ -148,7 +153,9 @@ export function reviewCommand(program: Command, context: SlothContext): void {
       const content: string[] = [];
       const requirementsProvider =
         options.requirementsProvider ??
-        (context.config?.pr?.requirementsProvider as RequirementsProviderType | undefined) ??
+        (context.config?.commands?.pr?.requirementsProvider as
+          | RequirementsProviderType
+          | undefined) ??
         (context.config?.requirementsProvider as RequirementsProviderType | undefined);
 
       // Handle requirements
@@ -161,8 +168,8 @@ export function reviewCommand(program: Command, context: SlothContext): void {
         content.push(readMultipleFilesFromCurrentDir(options.file));
       }
 
-      // Get PR diff using the 'gh' provider
-      const providerPath = `#src/providers/${CONTENT_PROVIDERS['gh']}`;
+      // Get PR diff using the 'github' provider
+      const providerPath = `#src/providers/${CONTENT_PROVIDERS['github']}`;
       const { get } = await import(providerPath);
       content.push(await get(null, prId));
 

package/src/config.ts

@@ -15,6 +15,11 @@ export interface SlothConfig extends BaseSlothConfig {
   commands: {
     pr: {
       contentProvider: string;
+      requirementsProvider?: string;
+    };
+    review?: {
+      requirementsProvider?: string;
+      contentProvider?: string;
     };
   };
 }
@@ -38,14 +43,12 @@ interface BaseSlothConfig {
   commands?: {
     pr: {
       contentProvider: string;
+      requirementsProvider?: string;
+    };
+    review?: {
+      requirementsProvider?: string;
+      contentProvider?: string;
     };
-  };
-  review?: {
-    requirementsProvider?: string;
-    contentProvider?: string;
-  };
-  pr?: {
-    requirementsProvider?: string;
   };
   requirementsProviderConfig?: Record<string, unknown>;
   contentProviderConfig?: Record<string, unknown>;
@@ -87,7 +90,8 @@ export const DEFAULT_CONFIG: Partial<SlothConfig> = {
   projectReviewInstructions: PROJECT_REVIEW_INSTRUCTIONS,
   commands: {
     pr: {
-      contentProvider: 'gh',
+      contentProvider: 'github', // gh pr diff NN
+      requirementsProvider: 'github', // gh issue view NN
     },
   },
 };
@@ -99,7 +103,6 @@ export const DEFAULT_CONFIG: Partial<SlothConfig> = {
  */
 export const slothContext = {
   config: DEFAULT_CONFIG,
-  stdin: '',
   session: { configurable: { thread_id: uuidv4() } },
 } as Partial<SlothContext> as SlothContext;
 

package/src/configs/anthropic.ts

@@ -18,7 +18,7 @@ export async function processJsonConfig(
   return new anthropic.ChatAnthropic({
     ...llmConfig,
     apiKey: anthropicApiKey,
-    model: llmConfig.model || 'claude-3-7-sonnet-20250219',
+    model: llmConfig.model || 'claude-sonnet-4-20250514',
   });
 }
 
@@ -31,7 +31,7 @@ export async function configure(importFunction, global) {
     return {
         llm: new anthropic.ChatAnthropic({
             apiKey: process.env.ANTHROPIC_API_KEY, // Default value, but you can provide the key in many different ways, even as literal
-            model: "claude-3-7-sonnet-20250219" // Don't forget to check new models availability.
+            model: "claude-sonnet-4-20250514" // Don't forget to check new models availability.
         })
     };
 }
@@ -40,8 +40,7 @@ export async function configure(importFunction, global) {
 const jsonContent = `{
   "llm": {
     "type": "anthropic",
-    "apiKey": "your-api-key-here",
-    "model": "claude-3-7-sonnet-20250219"
+    "model": "claude-sonnet-4-20250514"
   }
 }`;
 

package/src/providers/ghIssueProvider.ts

@@ -0,0 +1,37 @@
+import { displayWarning } from '#src/consoleUtils.js';
+import { execAsync } from '#src/utils.js';
+import type { ProviderConfig } from './types.js';
+
+/**
+ * Gets GitHub issue using GitHub CLI
+ * @param _ config (unused in this provider)
+ * @param issueId GitHub issue number
+ * @returns GitHub issue content or null if not found
+ */
+export async function get(
+  _: ProviderConfig | null,
+  issueId: string | undefined
+): Promise<string | null> {
+  if (!issueId) {
+    displayWarning('No GitHub issue number provided');
+    return null;
+  }
+
+  try {
+    // Use the GitHub CLI to fetch issue details
+    const issueContent = await execAsync(`gh issue view ${issueId}`);
+
+    if (!issueContent) {
+      displayWarning(`No content found for GitHub issue #${issueId}`);
+      return null;
+    }
+
+    return `GitHub Issue: #${issueId}\n\n${issueContent}`;
+  } catch (error) {
+    displayWarning(`
+Failed to get GitHub issue #${issueId}: ${error instanceof Error ? error.message : String(error)}
+Consider checking if gh cli (https://cli.github.com/) is installed and authenticated.
+    `);
+    return null;
+  }
+}

package/src/providers/ghPrDiffProvider.ts

@@ -3,18 +3,35 @@ import { execAsync } from '#src/utils.js';
 import type { ProviderConfig } from './types.js';
 
 /**
- * Gets PR diff using gh command line tool
+ * Gets PR diff using GitHub CLI
  * @param _ config (unused in this provider)
- * @param pr PR number
- * @returns PR diff
+ * @param prId GitHub PR number
+ * @returns GitHub PR diff content or null if not found
  */
 export async function get(
   _: ProviderConfig | null,
-  pr: string | undefined
+  prId: string | undefined
 ): Promise<string | null> {
-  if (!pr) {
-    displayWarning('No PR provided');
+  if (!prId) {
+    displayWarning('No GitHub PR number provided');
+    return null;
+  }
+
+  try {
+    // Use the GitHub CLI to fetch PR diff
+    const prDiffContent = await execAsync(`gh pr diff ${prId}`);
+
+    if (!prDiffContent) {
+      displayWarning(`No diff content found for GitHub PR #${prId}`);
+      return null;
+    }
+
+    return `GitHub PR Diff: #${prId}\n\n${prDiffContent}`;
+  } catch (error) {
+    displayWarning(`
+Failed to get GitHub PR diff #${prId}: ${error instanceof Error ? error.message : String(error)}
+Consider checking if gh cli (https://cli.github.com/) is installed and authenticated.
+    `);
     return null;
   }
-  return execAsync(`gh pr diff ${pr}`);
 }

package/src/providers/jiraIssueProvider.ts

@@ -8,6 +8,7 @@ interface JiraIssueResponse {
     description: string;
     [key: string]: unknown;
   };
+
   [key: string]: unknown;
 }
 
@@ -74,6 +75,8 @@ export async function get(
     const summary = issue.fields.summary;
     const description = issue.fields.description;
 
+    console.log(JSON.stringify(issue, null, 2));
+
     return `Jira Issue: ${issueId}\nSummary: ${summary}\n\nDescription:\n${description}`;
   } catch (error) {
     displayError(
@@ -84,7 +87,11 @@ export async function get(
 }
 
 /**
- * Helper function to get Jira issue details using Atlassian REST API v3
+ * Helper function to get Jira issue details using Atlassian REST API v2.
+ *
+ * The feature was initially developed to use Atlassian REST API v3, which by
+ * default returns the ADF JSON format for description, which is not very useful for us.
+ *
  * @param config Jira configuration
  * @param jiraKey Jira issue ID
  * @returns Jira issue response
@@ -93,14 +100,18 @@ async function getJiraIssue(config: JiraConfig, jiraKey: string): Promise<JiraIs
   // 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:
+  // https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-issues/#api-rest-api-2-issue-issueidorkey-get
   // 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}`;
+  const apiUrl = `https://api.atlassian.com/ex/jira/${config.cloudId}/rest/api/2/issue/${jiraKey}`;
   if (config.displayUrl) {
     display(`Loading Jira issue ${config.displayUrl}${jiraKey}`);
   }
   display(`Retrieving jira from api ${apiUrl.replace(/^https?:\/\//, '')}`);
 
+  // This filter will be necessary for V3: `&expand=renderedFields` to convert ADF to HTML
+  const filters = '?fields=summary,description'; // Limit JSON to summary and description
+
   // Encode credentials for Basic Authentication header
   const credentials = `${config.username}:${config.token}`;
   const encodedCredentials = Buffer.from(credentials).toString('base64');
@@ -113,7 +124,7 @@ async function getJiraIssue(config: JiraConfig, jiraKey: string): Promise<JiraIs
     'Accept-Language': 'en-US,en;q=0.9', // Prevents errors in other languages
   };
 
-  const response = await fetch(apiUrl, {
+  const response = await fetch(apiUrl + filters, {
     method: 'GET',
     headers: headers,
   });

package/tsconfig.json

@@ -20,5 +20,5 @@
     }
   },
   "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "spec"]
+  "exclude": ["node_modules", "dist", "spec", "integration-tests"]
 }

package/vitest-it.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    include: ['integration-tests/**/*.it.ts'],
+    environment: 'node',
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'json', 'html'],
+    },
+    globals: true,
+    testTimeout: 100000,
+  },
+});

package/dist/configs/types.d.ts

@@ -1,14 +0,0 @@
-import type { SlothContext } from '#src/config.js';
-import { BaseChatModel } from '@langchain/core/language_models/chat_models';
-export interface LLMConfig {
-    type: string;
-    model?: string;
-    apiKey?: string;
-    temperature?: number;
-    responses?: string[];
-    [key: string]: unknown;
-}
-export interface ConfigModule {
-    init: (configFileName: string, context: SlothContext) => void;
-    processJsonConfig: (llmConfig: LLMConfig) => Promise<BaseChatModel | null>;
-}

package/dist/configs/types.js

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

package/dist/configs/types.js.map

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

package/dist/providers/jiraIssueLegacyAccessTokenProvider.d.ts

@@ -1,8 +0,0 @@
-import type { JiraConfig } from "./types.js";
-/**
- * Gets Jira issue using Atlassian REST API v2
- * @param config Jira configuration
- * @param issueId Jira issue ID
- * @returns Jira issue content
- */
-export declare function get(config: JiraConfig | null, issueId: string | undefined): Promise<string | null>;