@gaunt-sloth/review 0.1.8 → 2.0.0-alpha.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export * from '@gaunt-sloth/core/config.js';
 export * from '#src/modules/reviewModule.js';
-export * from '#src/modules/questionAnsweringModule.js';
 export * from '#src/commands/commandUtils.js';
+export * from '#src/tools/ghReadFileTool.js';

package/dist/index.js

@@ -1,5 +1,5 @@
 export * from '@gaunt-sloth/core/config.js';
 export * from '#src/modules/reviewModule.js';
-export * from '#src/modules/questionAnsweringModule.js';
 export * from '#src/commands/commandUtils.js';
+export * from '#src/tools/ghReadFileTool.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yCAAyC,CAAC;AACxD,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC"}

package/dist/modules/reviewModule.d.ts

@@ -1,3 +1,8 @@
 import type { GthConfig } from '@gaunt-sloth/core/config.js';
 import type { AgentResolvers } from '@gaunt-sloth/core/core/types.js';
-export declare function review(source: string, preamble: string, diff: string, config: GthConfig, command?: 'pr' | 'review', resolvers?: AgentResolvers): Promise<void>;
+/** Extra context about the review, used to bind GitHub-only tools to the PR under review. */
+export interface ReviewContext {
+    /** PR number under review; undefined in `gth pr` discovery mode (current branch's PR). */
+    prId?: string;
+}
+export declare function review(source: string, preamble: string, diff: string, config: GthConfig, command?: 'pr' | 'review', resolvers?: AgentResolvers, reviewContext?: ReviewContext): Promise<void>;

package/dist/modules/reviewModule.js

@@ -7,9 +7,15 @@ import { ProgressIndicator } from '@gaunt-sloth/core/utils/ProgressIndicator.js'
 import { createReviewRateMiddleware, REVIEW_RATE_ARTIFACT_KEY, } from '#src/middleware/reviewRateMiddleware.js';
 import { deleteArtifact, getArtifact } from '@gaunt-sloth/core/state/artifactStore.js';
 import { setExitCode } from '@gaunt-sloth/core/utils/systemUtils.js';
-export async function review(source, preamble, diff, config, command = 'review', resolvers) {
+import { get as getGhReadFileTool, GTH_GH_READ_FILE_TOOL_NAME } from '#src/tools/ghReadFileTool.js';
+export async function review(source, preamble, diff, config, command = 'review', resolvers, reviewContext) {
     const progressIndicator = config.streamOutput ? undefined : new ProgressIndicator('Reviewing.');
     const messages = [new SystemMessage(preamble), new HumanMessage(diff)];
+    // REL-2: optionally give the review agent a `gh api` file-read tool so it can fetch the FULL
+    // contents of a file when the PR diff truncates large changes. Only added in a GitHub PR
+    // context (the content source resolves to GitHub); a graceful no-op otherwise. Reads through
+    // the GitHub API rather than the workspace filesystem, so it is safe under pull_request_target.
+    maybeAddGhReadFileTool(config, command, reviewContext?.prId);
     // Prepare logging path (if enabled by config)
     const filePath = getCommandOutputFilePath(config, source);
     if (filePath) {
@@ -28,8 +34,9 @@ export async function review(source, preamble, diff, config, command = 'review',
         const reviewRateMiddleware = await createReviewRateMiddleware(rateConfig, config);
         config.middleware = [...middlewareWithoutReviewRate, reviewRateMiddleware];
     }
-    // When no resolvers are provided (e.g. standalone CLI without @gaunt-sloth/tools),
-    // supply a minimal middleware resolver that passes through already-resolved middleware.
+    // When no resolvers are provided (e.g. standalone review CLI, without @gaunt-sloth/agent's
+    // resolvers), supply a minimal middleware resolver that passes through already-resolved
+    // middleware. The full `gaunt-sloth` CLI injects @gaunt-sloth/agent's resolvers instead.
     const effectiveResolvers = resolvers ?? {
         resolveMiddleware: async (middleware) => middleware ?? [],
     };
@@ -62,6 +69,36 @@ export async function review(source, preamble, diff, config, command = 'review',
     }
     deleteArtifact(REVIEW_RATE_ARTIFACT_KEY);
 }
+/**
+ * REL-2: conditionally inject the optional `gh api` file-read tool into the review agent's tools.
+ *
+ * Guarded so it is only active in a GitHub PR context, i.e. when the command's content source
+ * resolves to GitHub. For local/file/text reviews this is a no-op, keeping the tool optional and
+ * avoiding adding a GitHub-only capability where it cannot apply.
+ *
+ * The tool reads file contents via the GitHub API (`gh api`), never the workspace filesystem, so
+ * it remains safe under `pull_request_target` CI where the untrusted PR head is not checked out.
+ */
+function maybeAddGhReadFileTool(config, command, prId) {
+    const commandConfig = config.commands?.[command];
+    // Honor deprecated alias too: contentProvider.
+    const contentSource = commandConfig?.contentSource ??
+        commandConfig?.contentProvider ??
+        config.contentSource ??
+        config.contentProvider;
+    if (contentSource !== 'github') {
+        return;
+    }
+    // config.tools is a union (StructuredToolInterface[] | BaseToolkit[] | ServerTool[]); the
+    // gh read-file tool is a StructuredToolInterface, so we only append into a structured-tool list.
+    const existingTools = (Array.isArray(config.tools) ? config.tools : []);
+    // Avoid duplicate registration if the tool is already present (e.g. via custom config).
+    const alreadyPresent = existingTools.some((t) => typeof t === 'object' && t !== null && 'name' in t && t.name === GTH_GH_READ_FILE_TOOL_NAME);
+    if (alreadyPresent) {
+        return;
+    }
+    config.tools = [...existingTools, getGhReadFileTool(config, prId)];
+}
 function handleRatingResult(rateConfig, command) {
     if (!rateConfig || rateConfig.enabled === false) {
         // No rating enabled - no need to handle the result

package/dist/modules/reviewModule.js.map

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

package/dist/tools/ghReadFileTool.d.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import type { StructuredToolInterface } from '@langchain/core/tools';
+import type { GthConfig } from '@gaunt-sloth/core/config.js';
+declare const toolSchema: z.ZodObject<{
+    path: z.ZodString;
+}, z.core.$strip>;
+type GhReadFileArgs = z.infer<typeof toolSchema>;
+/** owner/repo/ref of the PR under review — the binding the model is NOT allowed to supply. */
+export interface PrRepoContext {
+    owner: string;
+    repo: string;
+    ref?: string;
+}
+/**
+ * Resolves the owner/repo and head ref of the PR under review from the GitHub CLI, so the file
+ * read is bound to the PR's own repository rather than anything the model supplies. With a prId
+ * the PR is addressed explicitly; without one `gh pr view` resolves the current branch's PR
+ * (the `gth pr` discovery mode). Returns the context, or an explanatory string on any failure.
+ */
+export declare function resolvePrRepoContext(prId: string | undefined): Promise<PrRepoContext | string>;
+/**
+ * Fetches the full contents of a single file from GitHub via the `gh api` CLI and decodes it.
+ * Returns the decoded text, or a human/agent-readable explanation string on any failure
+ * (graceful skip — never throws). owner/repo/ref come from the resolved PR context, not the LLM.
+ */
+export declare function ghReadFileImpl(args: GhReadFileArgs, context: PrRepoContext): Promise<string>;
+/**
+ * Built-in tool factory matching the repo's `get(config)` tool idiom (see gthWebFetchTool).
+ *
+ * `prId` identifies the PR under review (undefined in `gth pr` discovery mode → current branch).
+ * The owner/repo/ref are resolved from it once, lazily, and memoised for the run, so the agent
+ * cannot read files from any repo other than the one being reviewed.
+ */
+export declare function get(_: GthConfig, prId?: string): StructuredToolInterface;
+export declare const GTH_GH_READ_FILE_TOOL_NAME = "gth_gh_read_file";
+export {};

package/dist/tools/ghReadFileTool.js

@@ -0,0 +1,178 @@
+import { z } from 'zod';
+import { tool } from '@langchain/core/tools';
+import { execAsync } from '@gaunt-sloth/core/utils/systemUtils.js';
+import { debugLog } from '@gaunt-sloth/core/utils/debugUtils.js';
+/**
+ * Optional `gh api` file-read tool for the `review`/`pr` flow.
+ *
+ * When a PR diff truncates large changes, the review agent can use this tool to fetch the
+ * FULL contents of a file straight from the GitHub REST contents endpoint
+ * (`/repos/{owner}/{repo}/contents/{path}`) via the authenticated `gh` CLI, decode the
+ * base64 payload, and read it as text.
+ *
+ * This deliberately reads through the GitHub API rather than the workspace filesystem, which
+ * makes it safe to use under `pull_request_target` CI: the untrusted PR head is never checked
+ * out, and no local fs access is required to inspect the changed files.
+ *
+ * The agent only supplies the repo-relative `path`. The owner/repo and the ref to read at are
+ * bound to the PR under review (resolved from `gh pr view`), NOT supplied by the model — an
+ * earlier version let the LLM pass owner/repo and it hallucinated them (e.g. reading
+ * `pulumi/pulumi` for an integration-tests workflow), returning plausible-but-wrong content
+ * into the review. Binding them to the PR context also closes the footgun of reading arbitrary
+ * files from any public repo the model can name.
+ *
+ * The tool is OPTIONAL and self-guarding:
+ * - The path is strictly validated so nothing LLM-supplied can inject shell metacharacters
+ *   into the `gh api` invocation; the resolved owner/repo/ref are validated too.
+ * - When `gh` is missing/unauthenticated, or there is no PR/GitHub context, the call fails
+ *   gracefully and returns an explanatory string instead of throwing, so the agent can simply
+ *   continue with the (truncated) diff it already has.
+ */
+const TOOL_NAME = 'gth_gh_read_file';
+// PR ids reach us from the CLI; keep strict so nothing but a number can reach execAsync.
+const PR_ID_PATTERN = /^\d+$/;
+// owner/repo segments: GitHub login/repo naming, conservative allow-list (no shell metachars).
+const OWNER_PATTERN = /^[A-Za-z0-9-_.]+$/;
+const REPO_PATTERN = /^[A-Za-z0-9-_.]+$/;
+// A git ref (branch, tag, or commit SHA). Disallow shell metacharacters and whitespace.
+const REF_PATTERN = /^[A-Za-z0-9-_./]+$/;
+// Repo-relative path. Allow slashes and common filename characters, but no shell metachars,
+// no whitespace, and no parent-directory traversal.
+const PATH_PATTERN = /^[A-Za-z0-9-_./]+$/;
+const toolSchema = z.object({
+    path: z
+        .string()
+        .describe('Repository-relative path to the file, e.g. "src/index.ts" (no leading slash)'),
+});
+/**
+ * Resolves the owner/repo and head ref of the PR under review from the GitHub CLI, so the file
+ * read is bound to the PR's own repository rather than anything the model supplies. With a prId
+ * the PR is addressed explicitly; without one `gh pr view` resolves the current branch's PR
+ * (the `gth pr` discovery mode). Returns the context, or an explanatory string on any failure.
+ */
+export async function resolvePrRepoContext(prId) {
+    if (prId !== undefined && !PR_ID_PATTERN.test(prId)) {
+        return `Invalid pull request id "${prId}"; expected a numeric string.`;
+    }
+    const prSelector = prId ? ` ${prId}` : '';
+    const ghCommand = `gh pr view${prSelector} --json headRefName,headRepository,headRepositoryOwner`;
+    let raw;
+    try {
+        raw = await execAsync(ghCommand);
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        return (`Could not resolve the pull request repository via the GitHub API: ${reason}\n` +
+            `This tool needs an authenticated gh CLI (https://cli.github.com/) with access to the repository. ` +
+            `Continue the review using the diff you already have.`);
+    }
+    if (!raw) {
+        return `No pull request metadata returned${prId ? ` for #${prId}` : ' for the current branch'}.`;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (parseError) {
+        debugLog(`Failed to parse gh pr view output as JSON:\n${raw}`);
+        return `Failed to parse GitHub PR metadata: ${parseError instanceof Error ? parseError.message : String(parseError)}`;
+    }
+    const owner = parsed.headRepositoryOwner?.login;
+    const repo = parsed.headRepository?.name;
+    if (!owner || !repo) {
+        return `GitHub PR metadata did not include the head repository owner/name; cannot read files for this PR.`;
+    }
+    return { owner, repo, ref: parsed.headRefName };
+}
+/**
+ * Fetches the full contents of a single file from GitHub via the `gh api` CLI and decodes it.
+ * Returns the decoded text, or a human/agent-readable explanation string on any failure
+ * (graceful skip — never throws). owner/repo/ref come from the resolved PR context, not the LLM.
+ */
+export async function ghReadFileImpl(args, context) {
+    const { path } = args;
+    const { owner, repo, ref } = context;
+    if (!PATH_PATTERN.test(path) || path.includes('..')) {
+        return `Invalid file path "${path}"; expected a repository-relative path without traversal.`;
+    }
+    // Defence-in-depth: the resolved owner/repo/ref are interpolated into the gh command too.
+    if (!OWNER_PATTERN.test(owner)) {
+        return `Invalid repository owner "${owner}"; expected a GitHub login/organisation name.`;
+    }
+    if (!REPO_PATTERN.test(repo)) {
+        return `Invalid repository name "${repo}".`;
+    }
+    if (ref !== undefined && !REF_PATTERN.test(ref)) {
+        return `Invalid git ref "${ref}".`;
+    }
+    // -q is intentionally avoided so we can decode base64 ourselves and keep behaviour explicit.
+    const refQuery = ref ? `?ref=${ref}` : '';
+    const ghCommand = `gh api /repos/${owner}/${repo}/contents/${path}${refQuery}`;
+    try {
+        const raw = await execAsync(ghCommand);
+        if (!raw) {
+            return `No content returned for ${owner}/${repo}/${path}${ref ? `@${ref}` : ''}.`;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (parseError) {
+            debugLog(`Failed to parse gh api contents output as JSON:\n${raw}`);
+            return `Failed to parse GitHub API response for ${owner}/${repo}/${path}: ${parseError instanceof Error ? parseError.message : String(parseError)}`;
+        }
+        if (Array.isArray(parsed)) {
+            return `"${path}" is a directory, not a file. Provide a path to a single file.`;
+        }
+        if (parsed.type && parsed.type !== 'file') {
+            return `"${path}" is not a regular file (type: ${parsed.type}).`;
+        }
+        if (parsed.encoding !== 'base64' || typeof parsed.content !== 'string') {
+            // Large files (>1MB) are not returned inline by the contents endpoint.
+            return `GitHub did not return inline base64 content for "${path}" (it may be too large to read via the contents endpoint).`;
+        }
+        const decoded = Buffer.from(parsed.content, 'base64').toString('utf8');
+        const label = `${owner}/${repo}/${path}${ref ? `@${ref}` : ''}`;
+        return `Full contents of ${label}:\n\n${decoded}`;
+    }
+    catch (error) {
+        // Graceful skip: gh missing/unauthenticated, file not found, or no GitHub context.
+        const reason = error instanceof Error ? error.message : String(error);
+        return (`Could not read "${owner}/${repo}/${path}" via the GitHub API: ${reason}\n` +
+            `This tool needs an authenticated gh CLI (https://cli.github.com/) with access to the repository. ` +
+            `Continue the review using the diff you already have.`);
+    }
+}
+/**
+ * Built-in tool factory matching the repo's `get(config)` tool idiom (see gthWebFetchTool).
+ *
+ * `prId` identifies the PR under review (undefined in `gth pr` discovery mode → current branch).
+ * The owner/repo/ref are resolved from it once, lazily, and memoised for the run, so the agent
+ * cannot read files from any repo other than the one being reviewed.
+ */
+export function get(_, prId) {
+    let contextPromise;
+    const getContext = () => {
+        if (!contextPromise) {
+            contextPromise = resolvePrRepoContext(prId);
+        }
+        return contextPromise;
+    };
+    return tool(async (args) => {
+        const context = await getContext();
+        if (typeof context === 'string') {
+            return context; // resolution failed — return the explanation as a graceful skip.
+        }
+        return ghReadFileImpl(args, context);
+    }, {
+        name: TOOL_NAME,
+        description: 'Read the FULL contents of a single file from the pull request under review via the ' +
+            'GitHub API. Use this when the PR diff is truncated and you need to see the complete ' +
+            'file. Supply only the repository-relative path; the repository and ref are bound to ' +
+            'the PR automatically. Reads through the GitHub API, not the local filesystem, so it is ' +
+            'safe in pull_request_target CI.',
+        schema: toolSchema,
+    });
+}
+export const GTH_GH_READ_FILE_TOOL_NAME = TOOL_NAME;
+//# sourceMappingURL=ghReadFileTool.js.map

package/dist/tools/ghReadFileTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ghReadFileTool.js","sourceRoot":"","sources":["../../src/tools/ghReadFileTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAG7C,OAAO,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,MAAM,SAAS,GAAG,kBAAkB,CAAC;AAErC,yFAAyF;AACzF,MAAM,aAAa,GAAG,OAAO,CAAC;AAC9B,+FAA+F;AAC/F,MAAM,aAAa,GAAG,mBAAmB,CAAC;AAC1C,MAAM,YAAY,GAAG,mBAAmB,CAAC;AACzC,wFAAwF;AACxF,MAAM,WAAW,GAAG,oBAAoB,CAAC;AACzC,4FAA4F;AAC5F,oDAAoD;AACpD,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAE1C,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CAAC,8EAA8E,CAAC;CAC5F,CAAC,CAAC;AAyBH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAwB;IAExB,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpD,OAAO,4BAA4B,IAAI,+BAA+B,CAAC;IACzE,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,aAAa,UAAU,wDAAwD,CAAC;IAElG,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,OAAO,CACL,qEAAqE,MAAM,IAAI;YAC/E,mGAAmG;YACnG,sDAAsD,CACvD,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,oCAAoC,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,yBAAyB,GAAG,CAAC;IACnG,CAAC;IAED,IAAI,MAA4B,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,CAAC;IACnD,CAAC;IAAC,OAAO,UAAU,EAAE,CAAC;QACpB,QAAQ,CAAC,+CAA+C,GAAG,EAAE,CAAC,CAAC;QAC/D,OAAO,uCACL,UAAU,YAAY,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CACtE,EAAE,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,mBAAmB,EAAE,KAAK,CAAC;IAChD,MAAM,IAAI,GAAG,MAAM,CAAC,cAAc,EAAE,IAAI,CAAC;IACzC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,mGAAmG,CAAC;IAC7G,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAoB,EACpB,OAAsB;IAEtB,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAErC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpD,OAAO,sBAAsB,IAAI,2DAA2D,CAAC;IAC/F,CAAC;IACD,0FAA0F;IAC1F,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,6BAA6B,KAAK,+CAA+C,CAAC;IAC3F,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,OAAO,4BAA4B,IAAI,IAAI,CAAC;IAC9C,CAAC;IACD,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAChD,OAAO,oBAAoB,GAAG,IAAI,CAAC;IACrC,CAAC;IAED,6FAA6F;IAC7F,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,iBAAiB,KAAK,IAAI,IAAI,aAAa,IAAI,GAAG,QAAQ,EAAE,CAAC;IAE/E,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,2BAA2B,KAAK,IAAI,IAAI,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;QACpF,CAAC;QAED,IAAI,MAA0B,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAuB,CAAC;QACjD,CAAC;QAAC,OAAO,UAAU,EAAE,CAAC;YACpB,QAAQ,CAAC,oDAAoD,GAAG,EAAE,CAAC,CAAC;YACpE,OAAO,2CAA2C,KAAK,IAAI,IAAI,IAAI,IAAI,KACrE,UAAU,YAAY,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CACtE,EAAE,CAAC;QACL,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,IAAI,gEAAgE,CAAC;QAClF,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1C,OAAO,IAAI,IAAI,kCAAkC,MAAM,CAAC,IAAI,IAAI,CAAC;QACnE,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACvE,uEAAuE;YACvE,OAAO,oDAAoD,IAAI,4DAA4D,CAAC;QAC9H,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACvE,MAAM,KAAK,GAAG,GAAG,KAAK,IAAI,IAAI,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAChE,OAAO,oBAAoB,KAAK,QAAQ,OAAO,EAAE,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,mFAAmF;QACnF,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,OAAO,CACL,mBAAmB,KAAK,IAAI,IAAI,IAAI,IAAI,yBAAyB,MAAM,IAAI;YAC3E,mGAAmG;YACnG,sDAAsD,CACvD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CAAC,CAAY,EAAE,IAAa;IAC7C,IAAI,cAA2D,CAAC;IAChE,MAAM,UAAU,GAAG,GAAoC,EAAE;QACvD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,cAAc,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,cAAc,CAAC;IACxB,CAAC,CAAC;IAEF,OAAO,IAAI,CACT,KAAK,EAAE,IAAoB,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;QACnC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,OAAO,CAAC,CAAC,iEAAiE;QACnF,CAAC;QACD,OAAO,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC,EACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EACT,qFAAqF;YACrF,sFAAsF;YACtF,sFAAsF;YACtF,yFAAyF;YACzF,iCAAiC;QACnC,MAAM,EAAE,UAAU;KACnB,CACyB,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,MAAM,0BAA0B,GAAG,SAAS,CAAC"}

package/dist/utils/fileUtils.d.ts

@@ -1,7 +1 @@
 export * from '@gaunt-sloth/core/utils/fileUtils.js';
-/**
- * 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, each file is wrapped in random block like <file-abvesde>
- */
-export declare function readMultipleFilesFromProjectDir(fileNames: string | string[]): string;

package/dist/utils/fileUtils.js

@@ -1,20 +1,2 @@
 export * from '@gaunt-sloth/core/utils/fileUtils.js';
-import { readFileFromProjectDir } from '@gaunt-sloth/core/utils/fileUtils.js';
-import { wrapContent } from '@gaunt-sloth/core/utils/llmUtils.js';
-/**
- * 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, each file is wrapped in random block like <file-abvesde>
- */
-export function readMultipleFilesFromProjectDir(fileNames) {
-    if (!Array.isArray(fileNames)) {
-        return wrapContent(readFileFromProjectDir(fileNames), 'file', `file ${fileNames}`, true);
-    }
-    return fileNames
-        .map((fileName) => {
-        const content = readFileFromProjectDir(fileName);
-        return `${wrapContent(content, 'file', `file ${fileName}`, true)}`;
-    })
-        .join('\n\n');
-}
 //# sourceMappingURL=fileUtils.js.map

package/dist/utils/fileUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"fileUtils.js","sourceRoot":"","sources":["../../src/utils/fileUtils.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAElE;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAAC,SAA4B;IAC1E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,WAAW,CAAC,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,SAAS,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3F,CAAC;IAED,OAAO,SAAS;SACb,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QAChB,MAAM,OAAO,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QACjD,OAAO,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,QAAQ,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC;IACrE,CAAC,CAAC;SACD,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC"}
+{"version":3,"file":"fileUtils.js","sourceRoot":"","sources":["../../src/utils/fileUtils.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAC"}

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "@gaunt-sloth/review",
-  "version": "0.1.8",
+  "version": "2.0.0-alpha.0",
   "description": "Review functionality for Gaunt Sloth",
   "license": "MIT",
   "author": "Andrew Kondratev",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Galvanized-Pukeko/gaunt-sloth-assistant.git",
+    "url": "git+https://github.com/Galvanized-Pukeko/gaunt-sloth.git",
     "directory": "packages/review"
   },
   "bugs": {
-    "url": "https://github.com/Galvanized-Pukeko/gaunt-sloth-assistant/issues"
+    "url": "https://github.com/Galvanized-Pukeko/gaunt-sloth/issues"
   },
-  "homepage": "https://github.com/Galvanized-Pukeko/gaunt-sloth-assistant/tree/main/packages/review#readme",
+  "homepage": "https://github.com/Galvanized-Pukeko/gaunt-sloth/tree/main/packages/review#readme",
   "keywords": [
     "ai",
     "agent",
@@ -34,15 +34,7 @@
     "#src/*.js": "./dist/*.js"
   },
   "dependencies": {
-    "@gaunt-sloth/core": "0.1.8"
-  },
-  "peerDependencies": {
-    "@gaunt-sloth/tools": "0.1.8"
-  },
-  "peerDependenciesMeta": {
-    "@gaunt-sloth/tools": {
-      "optional": true
-    }
+    "@gaunt-sloth/core": "2.0.0-alpha.0"
   },
   "files": [
     "./dist/*",
@@ -50,5 +42,8 @@
   ],
   "scripts": {
     "build": "tsc"
+  },
+  "publishConfig": {
+    "tag": "alpha"
   }
 }

package/dist/modules/questionAnsweringModule.d.ts

@@ -1,9 +0,0 @@
-import type { GthConfig } from '@gaunt-sloth/core/config.js';
-import type { AgentResolvers } from '@gaunt-sloth/core/core/types.js';
-/**
- * Ask a question and get an answer from the LLM
- * @param source - The source of the question (used for file naming)
- * @param preamble - The preamble to send to the LLM
- * @param content - The content of the question
- */
-export declare function askQuestion(source: string, preamble: string, content: string, config: GthConfig, resolvers?: AgentResolvers): Promise<void>;

package/dist/modules/questionAnsweringModule.js

@@ -1,49 +0,0 @@
-import { defaultStatusCallback, display, displayError, displaySuccess, flushSessionLog, initSessionLogging, stopSessionLogging, } from '@gaunt-sloth/core/utils/consoleUtils.js';
-import { getCommandOutputFilePath } from '#src/utils/fileUtils.js';
-import { GthAgentRunner } from '@gaunt-sloth/core/core/GthAgentRunner.js';
-import { MemorySaver } from '@langchain/langgraph';
-import { HumanMessage, SystemMessage } from '@langchain/core/messages';
-import { ProgressIndicator } from '@gaunt-sloth/core/utils/ProgressIndicator.js';
-/**
- * Ask a question and get an answer from the LLM
- * @param source - The source of the question (used for file naming)
- * @param preamble - The preamble to send to the LLM
- * @param content - The content of the question
- */
-export async function askQuestion(source, preamble, content, config, resolvers) {
-    const progressIndicator = config.streamOutput ? undefined : new ProgressIndicator('Thinking.');
-    const messages = [new SystemMessage(preamble), new HumanMessage(content)];
-    // Resolve output path and initialize session logging if enabled
-    const filePath = getCommandOutputFilePath(config, source);
-    if (filePath) {
-        initSessionLogging(filePath, config.streamSessionInferenceLog);
-    }
-    // Run via Agent Runner (consistent with interactive session)
-    const runner = new GthAgentRunner(defaultStatusCallback, resolvers);
-    try {
-        await runner.init('ask', config, new MemorySaver());
-        await runner.processMessages(messages);
-    }
-    catch (err) {
-        displayError(`Failed to get answer: ${err instanceof Error ? err.message : String(err)}`);
-    }
-    finally {
-        await runner.cleanup();
-    }
-    progressIndicator?.stop();
-    if (config.writeOutputToFile === false) {
-        display('\n'); // something going on in some terminals, they swallow last line of output
-    }
-    if (filePath) {
-        try {
-            flushSessionLog();
-            stopSessionLogging();
-            displaySuccess(`\n\nThis report can be found in ${filePath}`);
-        }
-        catch (error) {
-            displayError(`Failed to write answer to file: ${filePath}`);
-            displayError(error instanceof Error ? error.message : String(error));
-        }
-    }
-}
-//# sourceMappingURL=questionAnsweringModule.js.map

package/dist/modules/questionAnsweringModule.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"questionAnsweringModule.js","sourceRoot":"","sources":["../../src/modules/questionAnsweringModule.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,OAAO,EACP,YAAY,EACZ,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AAGjF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAc,EACd,QAAgB,EAChB,OAAe,EACf,MAAiB,EACjB,SAA0B;IAE1B,MAAM,iBAAiB,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC/F,MAAM,QAAQ,GAAG,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IAE1E,gEAAgE;IAChE,MAAM,QAAQ,GAAG,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1D,IAAI,QAAQ,EAAE,CAAC;QACb,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,yBAAyB,CAAC,CAAC;IACjE,CAAC;IAED,6DAA6D;IAC7D,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAC;IACpE,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC,CAAC;QACpD,MAAM,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,YAAY,CAAC,yBAAyB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5F,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;IAED,iBAAiB,EAAE,IAAI,EAAE,CAAC;IAE1B,IAAI,MAAM,CAAC,iBAAiB,KAAK,KAAK,EAAE,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,yEAAyE;IAC1F,CAAC;IACD,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,CAAC;YACH,eAAe,EAAE,CAAC;YAClB,kBAAkB,EAAE,CAAC;YACrB,cAAc,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAC;YAC5D,YAAY,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;AACH,CAAC"}