gaunt-sloth 0.0.1 → 1.5.8

package/dist/commands/getCommand.js

@@ -0,0 +1,45 @@
+import { initConfig } from '@gaunt-sloth/core/config.js';
+import { getCommandProviderInput, getCommandSystemPrompt, } from '#src/commands/commandIntrospection.js';
+import { display, displayError } from '@gaunt-sloth/core/utils/consoleUtils.js';
+import { setExitCode } from '@gaunt-sloth/core/utils/systemUtils.js';
+const PROMPT_COMMANDS = ['ask', 'review', 'pr', 'pr-discovery', 'chat', 'code'];
+const PROVIDER_COMMANDS = ['review', 'pr'];
+const INPUT_TYPES = ['content', 'requirements'];
+export function getCommand(program, commandLineConfigOverrides) {
+    program
+        .command('get')
+        .description('Print the effective prompt or provider-backed command input')
+        .argument('<command>', 'Command to introspect')
+        .argument('<subject>', 'Either prompt, content, or requirements')
+        .argument('[id]', 'Provider-backed content identifier')
+        .action(async (command, subject, id) => {
+        try {
+            const config = await initConfig(commandLineConfigOverrides);
+            if (subject === 'prompt') {
+                if (id) {
+                    throw new Error('Prompt subject does not accept an ID.');
+                }
+                if (!PROMPT_COMMANDS.includes(command)) {
+                    throw new Error(`Unsupported prompt command: ${command}.`);
+                }
+                display(getCommandSystemPrompt(command, config));
+                return;
+            }
+            if (!INPUT_TYPES.includes(subject)) {
+                throw new Error(`Unsupported subject: ${subject}.`);
+            }
+            if (!PROVIDER_COMMANDS.includes(command)) {
+                throw new Error(`Unsupported provider-backed command: ${command}.`);
+            }
+            if (!id) {
+                throw new Error(`Subject "${subject}" requires an ID.`);
+            }
+            display(await getCommandProviderInput(command, subject, id, config));
+        }
+        catch (error) {
+            displayError(error instanceof Error ? error.message : String(error));
+            setExitCode(1);
+        }
+    });
+}
+//# sourceMappingURL=getCommand.js.map

package/dist/commands/getCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCommand.js","sourceRoot":"","sources":["../../src/commands/getCommand.ts"],"names":[],"mappings":"AACA,OAAO,EAA8B,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACrF,OAAO,EACL,uBAAuB,EACvB,sBAAsB,GAIvB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAErE,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AACzF,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAU,CAAC;AACpD,MAAM,WAAW,GAAG,CAAC,SAAS,EAAE,cAAc,CAAU,CAAC;AAEzD,MAAM,UAAU,UAAU,CACxB,OAAgB,EAChB,0BAAsD;IAEtD,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,6DAA6D,CAAC;SAC1E,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAC;SAC9C,QAAQ,CAAC,WAAW,EAAE,yCAAyC,CAAC;SAChE,QAAQ,CAAC,MAAM,EAAE,oCAAoC,CAAC;SACtD,MAAM,CAAC,KAAK,EAAE,OAAe,EAAE,OAAe,EAAE,EAAsB,EAAE,EAAE;QACzE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,0BAA0B,CAAC,CAAC;YAE5D,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACzB,IAAI,EAAE,EAAE,CAAC;oBACP,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;gBAC3D,CAAC;gBACD,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,OAA4B,CAAC,EAAE,CAAC;oBAC5D,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,GAAG,CAAC,CAAC;gBAC7D,CAAC;gBAED,OAAO,CAAC,sBAAsB,CAAC,OAA4B,EAAE,MAAM,CAAC,CAAC,CAAC;gBACtE,OAAO;YACT,CAAC;YAED,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,OAA4B,CAAC,EAAE,CAAC;gBACxD,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAO,GAAG,CAAC,CAAC;YACtD,CAAC;YACD,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,OAA8B,CAAC,EAAE,CAAC;gBAChE,MAAM,IAAI,KAAK,CAAC,wCAAwC,OAAO,GAAG,CAAC,CAAC;YACtE,CAAC;YACD,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,MAAM,IAAI,KAAK,CAAC,YAAY,OAAO,mBAAmB,CAAC,CAAC;YAC1D,CAAC;YAED,OAAO,CACL,MAAM,uBAAuB,CAC3B,OAA8B,EAC9B,OAA4B,EAC5B,EAAE,EACF,MAAM,CACP,CACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACrE,WAAW,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/initCommand.d.ts

@@ -0,0 +1,16 @@
+import { Command } from 'commander';
+/**
+ * Map of provider names to their expected API key environment variable names.
+ * vertexai uses gcloud auth and does not require an API key env var.
+ */
+export declare const providerApiKeyMap: Record<string, string | null>;
+/**
+ * Detects which providers have API keys set in the environment.
+ * Returns list of provider names with available keys.
+ */
+export declare function detectAvailableProviders(): string[];
+/**
+ * Adds the init command to the program
+ * @param program - The commander program
+ */
+export declare function initCommand(program: Command): void;

package/dist/commands/initCommand.js

@@ -0,0 +1,90 @@
+import { availableDefaultConfigs } from '@gaunt-sloth/core/config.js';
+import { createProjectConfig } from '#src/commands/configSetup.js';
+import { displayInfo, displayWarning } from '@gaunt-sloth/core/utils/consoleUtils.js';
+import { createInterface, env, stdin, stdout } from '@gaunt-sloth/core/utils/systemUtils.js';
+import { Argument } from 'commander';
+/**
+ * Map of provider names to their expected API key environment variable names.
+ * vertexai uses gcloud auth and does not require an API key env var.
+ */
+export const providerApiKeyMap = {
+    anthropic: 'ANTHROPIC_API_KEY',
+    openai: 'OPENAI_API_KEY',
+    'google-genai': 'GOOGLE_API_KEY',
+    groq: 'GROQ_API_KEY',
+    deepseek: 'DEEPSEEK_API_KEY',
+    xai: 'XAI_API_KEY',
+    openrouter: 'OPEN_ROUTER_API_KEY',
+    vertexai: null,
+};
+/**
+ * Detects which providers have API keys set in the environment.
+ * Returns list of provider names with available keys.
+ */
+export function detectAvailableProviders() {
+    const available = [];
+    for (const provider of availableDefaultConfigs) {
+        const keyName = providerApiKeyMap[provider];
+        if (keyName === null) {
+            // Provider like vertexai that doesn't need an API key
+            available.push(provider);
+        }
+        else if (keyName && env[keyName]) {
+            available.push(provider);
+        }
+    }
+    return available;
+}
+/**
+ * Prompts the user to select a provider from a numbered list.
+ */
+async function promptProviderSelection(providers) {
+    displayInfo('Available providers:');
+    providers.forEach((provider, index) => {
+        const keyName = providerApiKeyMap[provider];
+        const keyInfo = keyName ? ` (${keyName})` : ' (gcloud auth)';
+        displayInfo(`  ${index + 1}. ${provider}${keyInfo}`);
+    });
+    const rl = createInterface({ input: stdin, output: stdout });
+    try {
+        const answer = await rl.question('\nSelect a provider by number: ');
+        const selection = parseInt(answer.trim(), 10);
+        if (isNaN(selection) || selection < 1 || selection > providers.length) {
+            displayWarning(`Invalid selection. Please enter a number between 1 and ${providers.length}.`);
+            rl.close();
+            return promptProviderSelection(providers);
+        }
+        return providers[selection - 1];
+    }
+    finally {
+        rl.close();
+    }
+}
+/**
+ * Adds the init command to the program
+ * @param program - The commander program
+ */
+export function initCommand(program) {
+    program
+        .command('init')
+        .description('Initialize the Gaunt Sloth Assistant in your project. This will write necessary config files.')
+        .addArgument(new Argument('[type]', 'Config type (optional, will auto-detect if omitted)').choices(availableDefaultConfigs))
+        .action(async (config) => {
+        if (config) {
+            await createProjectConfig(config);
+        }
+        else {
+            const available = detectAvailableProviders();
+            if (available.length === 0) {
+                displayWarning('No API keys detected in environment. Available providers: ' +
+                    availableDefaultConfigs.join(', '));
+                displayInfo('Please set an API key environment variable and try again, or run:');
+                displayInfo('  gsloth init <type>');
+                return;
+            }
+            const selected = await promptProviderSelection(available);
+            await createProjectConfig(selected);
+        }
+    });
+}
+//# sourceMappingURL=initCommand.js.map

package/dist/commands/initCommand.js.map

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

package/dist/commands/prCommand.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+import { CommandLineConfigOverrides } from '@gaunt-sloth/core/config.js';
+export declare function prCommand(program: Command, commandLineConfigOverrides: CommandLineConfigOverrides): void;

package/dist/commands/prCommand.js

@@ -0,0 +1,106 @@
+import { Option } from 'commander';
+import { displayError } from '@gaunt-sloth/core/utils/consoleUtils.js';
+import { setExitCode } from '@gaunt-sloth/core/utils/systemUtils.js';
+import { getCommandProviderInput, getEffectiveContentProvider, getEffectiveRequirementsProvider, getReviewSystemPrompt, } from '#src/commands/commandIntrospection.js';
+import { REQUIREMENTS_PROVIDERS } from './commandUtils.js';
+import jiraLogWork from '#src/helpers/jira/jiraLogWork.js';
+import { wrapContent } from '@gaunt-sloth/core/utils/llmUtils.js';
+import { runPrDiscovery } from '#src/commands/prDiscovery.js';
+import { readMultipleFilesFromProjectDir } from '@gaunt-sloth/review/utils/fileUtils.js';
+export function prCommand(program, commandLineConfigOverrides) {
+    program
+        .command('pr')
+        .description('Review provided Pull Request in current directory. ' +
+        '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. Omit both prId and requirementsId to discover the change requirements from the current branch's PR.")
+        .argument('[requirementsId]', 'Optional requirements ID argument to retrieve requirements with requirements provider')
+        .addOption(new Option('-p, --requirements-provider <requirementsProvider>', 'Requirements provider for this review.').choices(Object.keys(REQUIREMENTS_PROVIDERS)))
+        .option('-f, --file [files...]', 'Input files. Content of these files will be added BEFORE the diff, but after requirements')
+        .option('-m, --message <message>', 'Extra message to provide just before the content')
+        .action(async (prId, requirementsId, options) => {
+        const { initConfig } = await import('@gaunt-sloth/core/config.js');
+        const config = await initConfig(commandLineConfigOverrides); // Initialize and get config
+        const content = [];
+        const requirementsProvider = getEffectiveRequirementsProvider('pr', config, options.requirementsProvider);
+        const contentProvider = getEffectiveContentProvider('pr', config);
+        if (options.file) {
+            content.push(readMultipleFilesFromProjectDir(options.file));
+        }
+        const isDiscovery = !prId && !requirementsId;
+        const looksLikeRequirementsOnlyMode = contentProvider === 'github' && Boolean(prId) && !requirementsId && !/^\d+$/.test(prId);
+        if (looksLikeRequirementsOnlyMode) {
+            displayError(`Unsupported PR command arguments: "${prId}" was provided as the pull request ID. ` +
+                '`gth pr <requirementsId>` requirements-only mode is not supported. ' +
+                'Use `gth pr` with no arguments to discover change requirements automatically, or provide both a numeric PR ID and requirements ID: `gth pr <prId> <requirementsId>`.');
+            setExitCode(1);
+            return;
+        }
+        if (isDiscovery) {
+            if (config.commands?.pr?.discovery?.enabled === false) {
+                displayError('Change requirements discovery is disabled. Provide a pull request ID to run `gth pr`.');
+                setExitCode(1);
+                return;
+            }
+            try {
+                const discoveryResult = await runPrDiscovery(config);
+                if (discoveryResult.requirements) {
+                    content.push(wrapContent(discoveryResult.requirements, 'discovered-requirements', 'requirements'));
+                }
+                if (!discoveryResult.diff) {
+                    displayError('Change requirements discovery did not produce a diff. Cannot continue with review.');
+                    setExitCode(1);
+                    return;
+                }
+                content.push(wrapContent(discoveryResult.diff, 'discovered-diff', 'GitHub diff'));
+            }
+            catch (error) {
+                displayError(error instanceof Error ? error.message : String(error));
+                setExitCode(1);
+                return;
+            }
+        }
+        else {
+            // Handle requirements
+            const requirements = await getCommandProviderInput('pr', 'requirements', requirementsId, config, requirementsProvider);
+            if (requirements) {
+                content.push(requirements);
+            }
+            // Get PR diff using the provider
+            try {
+                const prContent = await getCommandProviderInput('pr', 'content', prId, config, contentProvider);
+                // A provider may resolve to an empty result instead of throwing - e.g. ghPrDiffSource
+                // returns null (with a warning) for an invalid PR number. Without this guard the review
+                // would silently proceed against no diff; fail loudly as the throwing path used to.
+                if (!prContent) {
+                    displayError(`Could not retrieve PR content for "${prId}". Cannot continue with review.`);
+                    setExitCode(1);
+                    return;
+                }
+                content.push(prContent);
+            }
+            catch (error) {
+                displayError(error instanceof Error ? error.message : String(error));
+                setExitCode(1);
+                return;
+            }
+        }
+        if (options.message) {
+            content.push(wrapContent(options.message, 'message', 'user message'));
+        }
+        const { review } = await import('@gaunt-sloth/review/modules/reviewModule.js');
+        const { createResolvers } = await import('@gaunt-sloth/api/resolvers.js');
+        // TODO consider including requirements id
+        // TODO sanitize prId
+        await review(prId ? `PR-${prId}` : 'PR-discovery', getReviewSystemPrompt(config), content.join('\n'), config, 'pr', createResolvers());
+        if (requirementsId &&
+            (config.commands?.pr?.requirementsProvider ?? config.requirementsProvider) === 'jira' &&
+            config.commands?.pr?.logWorkForReviewInSeconds) {
+            // TODO we need to figure out some sort of post-processors
+            let jiraConfig = config.builtInToolsConfig?.jira ||
+                config.requirementsProviderConfig?.jira;
+            await jiraLogWork(jiraConfig, requirementsId, config.commands?.pr?.logWorkForReviewInSeconds, 'code review');
+        }
+    });
+}
+//# sourceMappingURL=prCommand.js.map

package/dist/commands/prCommand.js.map

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

package/dist/commands/prDiscovery.d.ts

@@ -0,0 +1,54 @@
+import type { CustomToolsConfig, GthConfig, ServerTool } from '@gaunt-sloth/core/config.js';
+import { type BaseToolkit, StructuredToolInterface } from '@langchain/core/tools';
+export declare const GSLOTH_PR_DISCOVERY_PROMPT = ".gsloth.pr-discovery.md";
+export interface PrDiscoveryConfig {
+    /**
+     * Enable change requirements discovery when neither PR id nor requirements id is provided.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Fetch the current-branch PR diff with `gh pr diff` before invoking the discovery agent.
+     * The discovery agent can still replace it with the `set_diff` tool if needed.
+     * @default true
+     */
+    deterministicDiff?: boolean;
+    /**
+     * Optional tool overrides used only while the discovery agent runs.
+     * When omitted, the normal configured tools remain available.
+     */
+    filesystem?: string[] | 'all' | 'read' | 'none';
+    builtInTools?: string[];
+    customTools?: CustomToolsConfig | false;
+    tools?: StructuredToolInterface[] | BaseToolkit[] | ServerTool[];
+    /**
+     * Restrict the discovery agent to this allow-list of tool names, applied after every tool
+     * source (filesystem, built-in, custom, MCP, A2A, and `tools`) is resolved. Unlike
+     * `builtInTools`/`customTools`/`filesystem` (which gate whole tool groups), this trims the
+     * final tool set by exact name, so it can pare down MCP server tools
+     * (e.g. "mcp__jira__getJiraIssue") and the discovery helper tools
+     * ("gh_pr"/"gh_diff"/"gh_issue"/"set_diff") to the minimum needed.
+     *
+     * `set_requirements` is always retained regardless, since it is how the discovery agent
+     * records the requirements it found. When omitted, all resolved tools remain available; an
+     * empty array keeps only `set_requirements`. The discovery agent never inherits the
+     * top-level {@link GthConfig.allowedTools}; this property is its only allow-list.
+     */
+    allowedTools?: string[];
+}
+declare module '@gaunt-sloth/core/config.js' {
+    interface PrCommandConfig {
+        /** Change requirements discovery (`gth pr` with no arguments) configuration. */
+        discovery?: PrDiscoveryConfig;
+    }
+}
+/**
+ * Read the PR discovery agent prompt, honouring project / identity-profile
+ * overrides and falling back to the default prompt shipped with the assistant package.
+ */
+export declare function readPrDiscoveryPrompt(config: Pick<GthConfig, 'identityProfile' | 'noDefaultPrompts'>): string;
+export interface PrDiscoveryResult {
+    diff: string;
+    requirements: string;
+}
+export declare function runPrDiscovery(config: GthConfig): Promise<PrDiscoveryResult>;