@gaunt-sloth/review 2.0.0-alpha.22 → 2.0.0-alpha.24

package/README.md

@@ -1,78 +1,119 @@
 # @gaunt-sloth/review
 
-Review and question-answering functionality for Gaunt Sloth.
+The review engine behind `gth review` / `gth pr`, packaged for embedding: run an AI code review
+programmatically from your own tool or pipeline, or via the standalone `gaunt-sloth-review`
+binary. Also contains the content/requirement sources (GitHub, local git diff, Jira, file, text) that feed it.
+
+**When to depend on this package** — you want review results inside your own process or a
+minimal CI job. It has no dependency on `commander`, MCP, or A2A, so the install stays small.
+If you want the interactive CLI (chat/code sessions, TUI, MCP tools), install the fat
+[`gaunt-sloth`](https://www.npmjs.com/package/gaunt-sloth) app instead — it wires this same
+module into `gth review` and `gth pr`.
 
 ## Installation
 
-This package does not include any AI provider packages. This is by design to
-keep the install minimal and avoid pulling in providers you don't use. Install
-the review package together with the provider required by your configuration:
+AI providers are not bundled (they are optional peer dependencies of
+[`@gaunt-sloth/core`](https://www.npmjs.com/package/@gaunt-sloth/core)); install the one your
+config uses:
 
 ```bash
 # OpenRouter / OpenAI
-npm install -g @gaunt-sloth/review @langchain/openai
+npm install @gaunt-sloth/review @langchain/openai
 
 # Google (Vertex AI / AI Studio)
-npm install -g @gaunt-sloth/review @langchain/google
+npm install @gaunt-sloth/review @langchain/google
 
 # Anthropic
-npm install -g @gaunt-sloth/review @langchain/anthropic
+npm install @gaunt-sloth/review @langchain/anthropic
 
 # Groq
-npm install -g @gaunt-sloth/review @langchain/groq
+npm install @gaunt-sloth/review @langchain/groq
 ```
 
-See [`@gaunt-sloth/core`](https://www.npmjs.com/package/@gaunt-sloth/core) for the full list of supported providers.
+## Embedding: review a diff programmatically
+
+I want to run a Gaunt Sloth review over a diff from my own Node script and fail the build on a
+bad rating. Create `.gsloth.config.json` next to the script:
+
+```json
+{
+  "llm": { "type": "anthropic", "model": "claude-sonnet-4-5" },
+  "commands": {
+    "review": { "rating": { "enabled": true, "passThreshold": 6 } }
+  }
+}
+```
 
-## Contents
+Then run a review over a diff (`node review-diff.mjs change.diff`):
+
+```js
+// review-diff.mjs
+import { readFileSync } from 'node:fs';
+import { initConfig } from '@gaunt-sloth/core/config.js';
+import {
+  readBackstory,
+  readGuidelines,
+  readReviewInstructions,
+} from '@gaunt-sloth/core/utils/llmUtils.js';
+import { review } from '@gaunt-sloth/review';
+
+const config = await initConfig({}); // loads .gsloth.config.* from the working directory
+const preamble = [readBackstory(config), readGuidelines(config), readReviewInstructions(config)]
+  .filter(Boolean)
+  .join('\n');
+const diff = readFileSync(process.argv[2], 'utf8');
+
+await review('embedded-review', preamble, diff, config);
+process.exit(process.exitCode ?? 0);
+```
 
-- Review module (`reviewModule`) — diff and content review orchestration
-- Question answering module (`questionAnsweringModule`)
-- Command utilities (`commandUtils`)
-- Content and requirement sources: `file`, `text`, `ghPrDiff`, `ghIssue`, `jiraIssue`, `jiraIssueLegacy`
-- Jira client
-- Review rate middleware
+The review text is written to stdout. With rating enabled, `review()` sets `process.exitCode = 1`
+when the rating comes back below `passThreshold` (or when the model fails to produce a rating),
+so the script exits non-zero exactly when `gth review` would — that is the whole embed contract.
+Configuration (provider, prompts, rating thresholds) is the standard Gaunt Sloth config, see
+[docs/CONFIGURATION.md](https://github.com/pukeko-robotics/gaunt-sloth/blob/main/docs/CONFIGURATION.md).
 
-## CLI
+This exact flow is verified by the workspace embed e2e (`pnpm run test:embed`), which packs the
+published tarballs and runs the snippet above from a temp-dir consumer against a stub model.
 
-The package ships a standalone binary `gaunt-sloth-review` for CI-friendly reviews that does not depend on `commander`. This makes it suitable for embedding in pipelines where a minimal footprint is preferred.
+## Standalone CLI: `gaunt-sloth-review`
+
+The package's one binary, for CI-friendly reviews with a minimal footprint:
 
 ```bash
-gaunt-sloth-review <pr-number> [requirement-ids...]
+gaunt-sloth-review 123          # review PR 123 (uses the configured content source, GitHub by default)
+gaunt-sloth-review 123 45       # ...with requirements from issue 45
 gaunt-sloth-review --version
 ```
 
 ### Identity profiles
 
-To use a different config profile (e.g. separate provider/auth for CI vs local),
-set the `GSLOTH_IDENTITY_PROFILE` environment variable:
+To use a different config profile (e.g. separate provider/auth for CI vs local), set the
+`GSLOTH_IDENTITY_PROFILE` environment variable:
 
 ```bash
 GSLOTH_IDENTITY_PROFILE=review gaunt-sloth-review 123
 ```
 
-This loads config from `.gsloth-settings/review/` instead of the default
-`.gsloth/` directory. Useful when CI uses different credentials or a different
-LLM provider than local development.
-
-## Dependencies
-
-- `@gaunt-sloth/core` (required)
-
-No MCP, no A2A, no commander. This is intentional to keep the package lightweight for CI use.
+This loads config from `.gsloth-settings/review/` instead of the default `.gsloth/` directory.
+Useful when CI uses different credentials or a different LLM provider than local development.
 
 ## Exports
 
-```js
-import { reviewModule } from '@gaunt-sloth/review/reviewModule.js';
-import { questionAnsweringModule } from '@gaunt-sloth/review/questionAnsweringModule.js';
-import { commandUtils } from '@gaunt-sloth/review/commandUtils.js';
-```
+- `@gaunt-sloth/review` (the root export) is the public API: the review module (`review`,
+  `ReviewContext`), `commandUtils`, and the `gh` read-file tool — plus, deliberately, the whole
+  `@gaunt-sloth/core` config barrel (`initConfig`, `GthConfig`, `DEFAULT_CONFIG`, …), re-exported
+  so an embedder can resolve config from the review root without importing core directly.
+  This surface is what the embed example above and the fat CLI use.
+- `@gaunt-sloth/review/<path>.js` deep paths (e.g.
+  `@gaunt-sloth/review/modules/reviewModule.js`) mirror the package's internal `dist/` layout
+  1:1 and are deliberately kept open for reach-in. They are supported at your own risk: internal
+  files can move between alpha/minor versions without a deprecation cycle. Prefer the root
+  export where it suffices.
 
 ## Related packages
 
 - [`@gaunt-sloth/core`](https://www.npmjs.com/package/@gaunt-sloth/core) — Core utilities, config, and agent infrastructure ([source](https://github.com/pukeko-robotics/gaunt-sloth/tree/main/packages/core))
 - [`@gaunt-sloth/agent`](https://www.npmjs.com/package/@gaunt-sloth/agent) — Agent runtime: built-in tools, filesystem toolkit, middleware registry, API server, AG-UI, MCP, and A2A integration ([source](https://github.com/pukeko-robotics/gaunt-sloth/tree/main/packages/agent))
-- [`@gaunt-sloth/review`](https://www.npmjs.com/package/@gaunt-sloth/review) — Review and Q&A modules with standalone CLI (this package) ([source](https://github.com/pukeko-robotics/gaunt-sloth/tree/main/packages/review))
 - [`@gaunt-sloth/batch`](https://www.npmjs.com/package/@gaunt-sloth/batch) — Batch / eval / workflow runtime ([source](https://github.com/pukeko-robotics/gaunt-sloth/tree/main/packages/batch))
 - [`gaunt-sloth`](https://www.npmjs.com/package/gaunt-sloth) — Main CLI application ([source](https://github.com/pukeko-robotics/gaunt-sloth/tree/main/packages/app))

package/cli.js

@@ -25,8 +25,11 @@ setEntryPoint(import.meta.url);
 import { initConfig } from '@gaunt-sloth/core/config.js';
 import { review } from '#src/modules/reviewModule.js';
 import { displayError } from '@gaunt-sloth/core/utils/consoleUtils.js';
-import { getContentFromSource, getRequirementsFromSource } from '#src/commands/commandUtils.js';
-import { buildSystemMessages } from '@gaunt-sloth/core/utils/llmUtils.js';
+import {
+  getContentFromSource,
+  getRequirementsFromSource,
+  getReviewPreamble,
+} from '#src/commands/commandUtils.js';
 
 async function main() {
   try {
@@ -53,11 +56,9 @@ async function main() {
       }
     }
 
-    // Build preamble from system messages
-    const preamble = buildSystemMessages(config, 'pr');
-    const preambleText = preamble
-      .map((m) => (typeof m.content === 'string' ? m.content : ''))
-      .join('\n');
+    // Build the review preamble (backstory + guidelines + review instructions + optional
+    // system prompt), the same composition `gth review` / `gth pr` use.
+    const preambleText = getReviewPreamble(config);
 
     // Combine requirements and content for the review
     const diffWithReqs = requirements

package/dist/commands/commandUtils.d.ts

@@ -1,4 +1,11 @@
 import type { GthConfig } from '@gaunt-sloth/core/config.js';
+/**
+ * Compose the review system preamble the way the fat CLI's `gth review` / `gth pr` do:
+ * backstory + guidelines + review instructions + the optional project system prompt, each
+ * segment honouring the GS2-43 `prompts.*` config. Empty segments are dropped rather than
+ * left as blank lines (the shape the README embed example documents).
+ */
+export declare function getReviewPreamble(config: GthConfig): string;
 /**
  * Requirement sources. Expected to be in `.sources/` dir.
  * Aliases are mapped to actual sources in this file
@@ -17,6 +24,7 @@ export type RequirementSourceType = keyof typeof REQUIREMENTS_SOURCES;
  */
 export declare const CONTENT_SOURCES: {
     readonly github: 'ghPrDiffSource.js';
+    readonly git: 'gitDiffSource.js';
     readonly text: 'textSource.js';
     readonly file: 'fileSource.js';
 };

package/dist/commands/commandUtils.js

@@ -1,5 +1,21 @@
 import { displayError } from '@gaunt-sloth/core/utils/consoleUtils.js';
-import { wrapContent } from '@gaunt-sloth/core/utils/llmUtils.js';
+import { readBackstory, readGuidelines, readReviewInstructions, readSystemPrompt, wrapContent, } from '@gaunt-sloth/core/utils/llmUtils.js';
+/**
+ * Compose the review system preamble the way the fat CLI's `gth review` / `gth pr` do:
+ * backstory + guidelines + review instructions + the optional project system prompt, each
+ * segment honouring the GS2-43 `prompts.*` config. Empty segments are dropped rather than
+ * left as blank lines (the shape the README embed example documents).
+ */
+export function getReviewPreamble(config) {
+    return [
+        readBackstory(config),
+        readGuidelines(config),
+        readReviewInstructions(config),
+        readSystemPrompt(config),
+    ]
+        .filter(Boolean)
+        .join('\n');
+}
 /**
  * Requirement sources. Expected to be in `.sources/` dir.
  * Aliases are mapped to actual sources in this file
@@ -17,6 +33,7 @@ export const REQUIREMENTS_SOURCES = {
  */
 export const CONTENT_SOURCES = {
     github: 'ghPrDiffSource.js',
+    git: 'gitDiffSource.js',
     text: 'textSource.js',
     file: 'fileSource.js',
 };
@@ -26,7 +43,7 @@ export async function getRequirementsFromSource(requirementSource, requirementsI
 }
 export async function getContentFromSource(contentSource, contentId, config) {
     const content = await getFromSource(contentSource, contentId, (config?.contentSourceConfig ?? {})[contentSource], CONTENT_SOURCES);
-    return wrapContent(content, contentSource, contentSource === 'github' ? 'GitHub diff' : 'content');
+    return wrapContent(content, contentSource, contentSource === 'github' ? 'GitHub diff' : contentSource === 'git' ? 'git diff' : 'content');
 }
 async function getFromSource(source, id, 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any

package/dist/commands/commandUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"commandUtils.js","sourceRoot":"","sources":["../../src/commands/commandUtils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAEvE,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAElE;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,aAAa,EAAE,0BAA0B;IACzC,IAAI,EAAE,oBAAoB;IAC1B,MAAM,EAAE,kBAAkB;IAC1B,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,eAAe;CACb,CAAC;AAIX;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,mBAAmB;IAC3B,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,eAAe;CACb,CAAC;AAIX,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,iBAAoD,EACpD,cAAkC,EAClC,MAAiB;IAEjB,MAAM,YAAY,GAAG,MAAM,aAAa,CACtC,iBAAiB,EACjB,cAAc,EACd,CAAC,MAAM,EAAE,uBAAuB,IAAI,EAAE,CAAC,CAAC,iBAA2B,CAAC,EACpE,oBAAoB,CACrB,CAAC;IACF,OAAO,WAAW,CAAC,YAAY,EAAE,iBAAiB,EAAE,cAAc,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,aAA4C,EAC5C,SAA6B,EAC7B,MAAiB;IAEjB,MAAM,OAAO,GAAG,MAAM,aAAa,CACjC,aAAa,EACb,SAAS,EACT,CAAC,MAAM,EAAE,mBAAmB,IAAI,EAAE,CAAC,CAAC,aAAuB,CAAC,EAC5D,eAAe,CAChB,CAAC;IACF,OAAO,WAAW,CAChB,OAAO,EACP,aAAa,EACb,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CACvD,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,MAA6D,EAC7D,EAAsB;AACtB,8DAA8D;AAC9D,MAAW,EACX,sBAA4E;IAE5E,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,oCAAoC;QACpC,IAAI,sBAAsB,CAAC,MAA6C,CAAC,EAAE,CAAC;YAC1E,MAAM,UAAU,GAAG,gBAAgB,sBAAsB,CAAC,MAA6C,CAAC,EAAE,CAAC;YAC3G,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;YACzC,OAAO,MAAM,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,mBAAmB,MAAM,0BAA0B,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACxC,yCAAyC;QACzC,OAAO,MAAO,MAAsD,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"commandUtils.js","sourceRoot":"","sources":["../../src/commands/commandUtils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAEvE,OAAO,EACL,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,gBAAgB,EAChB,WAAW,GACZ,MAAM,qCAAqC,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,OAAO;QACL,aAAa,CAAC,MAAM,CAAC;QACrB,cAAc,CAAC,MAAM,CAAC;QACtB,sBAAsB,CAAC,MAAM,CAAC;QAC9B,gBAAgB,CAAC,MAAM,CAAC;KACzB;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,aAAa,EAAE,0BAA0B;IACzC,IAAI,EAAE,oBAAoB;IAC1B,MAAM,EAAE,kBAAkB;IAC1B,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,eAAe;CACb,CAAC;AAIX;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,mBAAmB;IAC3B,GAAG,EAAE,kBAAkB;IACvB,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,eAAe;CACb,CAAC;AAIX,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,iBAAoD,EACpD,cAAkC,EAClC,MAAiB;IAEjB,MAAM,YAAY,GAAG,MAAM,aAAa,CACtC,iBAAiB,EACjB,cAAc,EACd,CAAC,MAAM,EAAE,uBAAuB,IAAI,EAAE,CAAC,CAAC,iBAA2B,CAAC,EACpE,oBAAoB,CACrB,CAAC;IACF,OAAO,WAAW,CAAC,YAAY,EAAE,iBAAiB,EAAE,cAAc,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,aAA4C,EAC5C,SAA6B,EAC7B,MAAiB;IAEjB,MAAM,OAAO,GAAG,MAAM,aAAa,CACjC,aAAa,EACb,SAAS,EACT,CAAC,MAAM,EAAE,mBAAmB,IAAI,EAAE,CAAC,CAAC,aAAuB,CAAC,EAC5D,eAAe,CAChB,CAAC;IACF,OAAO,WAAW,CAChB,OAAO,EACP,aAAa,EACb,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAC9F,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,MAA6D,EAC7D,EAAsB;AACtB,8DAA8D;AAC9D,MAAW,EACX,sBAA4E;IAE5E,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,oCAAoC;QACpC,IAAI,sBAAsB,CAAC,MAA6C,CAAC,EAAE,CAAC;YAC1E,MAAM,UAAU,GAAG,gBAAgB,sBAAsB,CAAC,MAA6C,CAAC,EAAE,CAAC;YAC3G,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;YACzC,OAAO,MAAM,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,mBAAmB,MAAM,0BAA0B,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACxC,yCAAyC;QACzC,OAAO,MAAO,MAAsD,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/sources/gitDiffSource.d.ts

@@ -0,0 +1,12 @@
+import type { ProviderConfig } from './types.js';
+/**
+ * Gets a local diff via `git --no-pager diff [refRange]` — review the working tree (or a
+ * ref range) without GitHub and without piping a diff through stdin.
+ *
+ * @param _ config (unused in this source)
+ * @param refRange optional revision selection passed to `git diff`, e.g. `origin/main...HEAD`
+ *   or `HEAD~3`. When omitted, diffs the working tree against the index (plain `git diff`).
+ * @returns the diff content; throws with a clear message outside a git repository, on a bad
+ *   ref, or when the diff is empty (an empty review would otherwise run against no content).
+ */
+export declare function get(_: ProviderConfig | null, refRange: string | undefined): Promise<string | null>;

package/dist/sources/gitDiffSource.js

@@ -0,0 +1,75 @@
+import { ProgressIndicator } from '@gaunt-sloth/core/utils/ProgressIndicator.js';
+/**
+ * `git diff` can emit multi-megabyte output for large changes; the node default (1 MiB)
+ * would truncate-and-fail such runs.
+ */
+const MAX_DIFF_BUFFER = 32 * 1024 * 1024;
+/**
+ * Gets a local diff via `git --no-pager diff [refRange]` — review the working tree (or a
+ * ref range) without GitHub and without piping a diff through stdin.
+ *
+ * @param _ config (unused in this source)
+ * @param refRange optional revision selection passed to `git diff`, e.g. `origin/main...HEAD`
+ *   or `HEAD~3`. When omitted, diffs the working tree against the index (plain `git diff`).
+ * @returns the diff content; throws with a clear message outside a git repository, on a bad
+ *   ref, or when the diff is empty (an empty review would otherwise run against no content).
+ */
+export async function get(_, refRange) {
+    // Args go to execFile (no shell), so shell metacharacters are inert; still reject
+    // option-shaped input so an id can never become a git flag (e.g. `--output=<file>`).
+    if (refRange && refRange.startsWith('-')) {
+        throw new Error(`Invalid git diff argument "${refRange}"; expected a ref or ref range (e.g. "origin/main...HEAD"), not an option.`);
+    }
+    const label = refRange ? `for "${refRange}"` : 'for the working tree';
+    const gitArgs = ['--no-pager', 'diff', ...(refRange ? [refRange] : [])];
+    const progress = new ProgressIndicator(`Getting local git diff ${label}`);
+    try {
+        const diffContent = await runGit(gitArgs);
+        progress.stop();
+        if (!diffContent.trim()) {
+            throw new Error(`No changes found in git diff ${label}; nothing to review.`);
+        }
+        return `Local git diff ${label}\n\n${diffContent}`;
+    }
+    catch (error) {
+        progress.stop();
+        const reason = error instanceof Error ? error.message : String(error);
+        if (reason.startsWith('No changes found')) {
+            throw new Error(reason);
+        }
+        throw new Error(`Failed to get git diff ${label}: ${reason}\nConsider checking that you are inside a git repository and the ref range is valid.`);
+    }
+}
+/**
+ * Run git with an args array (execFile, no shell). Rejects on a non-zero exit or spawn
+ * failure with git's stderr as the reason; benign stderr chatter on a zero exit is ignored
+ * (unlike systemUtils.execAsync, which rejects on any stderr output).
+ */
+async function runGit(args) {
+    const { execFile } = await import('node:child_process');
+    return new Promise((resolve, reject) => {
+        execFile('git', args, { maxBuffer: MAX_DIFF_BUFFER }, (error, stdout, stderr) => {
+            if (error) {
+                reject(new Error(extractGitError(stderr ?? '', error.message)));
+                return;
+            }
+            resolve(stdout);
+        });
+    });
+}
+/**
+ * Reduce git's stderr to the one meaningful line. Outside a repository `git diff` appends
+ * its entire `--no-index` usage screen after the warning line; that wall of text is noise
+ * in a CLI error. Prefer the `fatal:` line when present, else the first non-empty line.
+ */
+function extractGitError(stderr, fallback) {
+    const lines = stderr
+        .split('\n')
+        .map((line) => line.trim())
+        .filter(Boolean);
+    if (lines.length === 0) {
+        return fallback;
+    }
+    return lines.find((line) => line.startsWith('fatal:')) ?? lines[0];
+}
+//# sourceMappingURL=gitDiffSource.js.map

package/dist/sources/gitDiffSource.js.map

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

package/dist/sources/jiraIssueSource.d.ts

@@ -2,7 +2,8 @@ import type { JiraConfig } from './types.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.
+ * Requires an authenticated Atlassian Cloud instance (Cloud ID + API token); anonymous
+ * access to a public Jira instance is not supported.
  *
  * @param config Jira configuration
  * @param issueId Jira issue ID

package/dist/sources/jiraIssueSource.js

@@ -3,7 +3,8 @@ import { getJiraCredentials, jiraRequest, } from '#src/helpers/jira/jiraClient.j
 /**
  * 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.
+ * Requires an authenticated Atlassian Cloud instance (Cloud ID + API token); anonymous
+ * access to a public Jira instance is not supported.
  *
  * @param config Jira configuration
  * @param issueId Jira issue ID

package/dist/sources/jiraIssueSource.js.map

@@ -1 +1 @@
-{"version":3,"file":"jiraIssueSource.js","sourceRoot":"","sources":["../../src/sources/jiraIssueSource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAEhG,OAAO,EACL,kBAAkB,EAClB,WAAW,GAEZ,MAAM,iCAAiC,CAAC;AAYzC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,MAAkC,EAClC,OAA2B;IAE3B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,cAAc,CAAC,yBAAyB,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,cAAc,CAAC,sBAAsB,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE/C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;QACrC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC;QAE7C,OAAO,eAAe,OAAO,cAAc,OAAO,qBAAqB,WAAW,EAAE,CAAC;IACvF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,YAAY,CACV,6BAA6B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACtF,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,KAAK,UAAU,YAAY,CACzB,WAAoC,EACpC,OAAe;IAEf,sGAAsG;IAEtG,0KAA0K;IAC1K,sHAAsH;IACtH,8CAA8C;IAC9C,qHAAqH;IACrH,qGAAqG;IAErG,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;QAC3B,OAAO,CAAC,sBAAsB,WAAW,CAAC,UAAU,GAAG,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,wFAAwF;IACxF,MAAM,OAAO,GAAG,6BAA6B,CAAC,CAAC,wCAAwC;IAEvF,OAAO,WAAW,CAAoB,WAAW,EAAE,qBAAqB,OAAO,GAAG,OAAO,EAAE,EAAE;QAC3F,MAAM,EAAE,KAAK;KACd,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"jiraIssueSource.js","sourceRoot":"","sources":["../../src/sources/jiraIssueSource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAEhG,OAAO,EACL,kBAAkB,EAClB,WAAW,GAEZ,MAAM,iCAAiC,CAAC;AAYzC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,MAAkC,EAClC,OAA2B;IAE3B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,cAAc,CAAC,yBAAyB,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,cAAc,CAAC,sBAAsB,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE/C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;QACrC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC;QAE7C,OAAO,eAAe,OAAO,cAAc,OAAO,qBAAqB,WAAW,EAAE,CAAC;IACvF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,YAAY,CACV,6BAA6B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACtF,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,KAAK,UAAU,YAAY,CACzB,WAAoC,EACpC,OAAe;IAEf,sGAAsG;IAEtG,0KAA0K;IAC1K,sHAAsH;IACtH,8CAA8C;IAC9C,qHAAqH;IACrH,qGAAqG;IAErG,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;QAC3B,OAAO,CAAC,sBAAsB,WAAW,CAAC,UAAU,GAAG,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,wFAAwF;IACxF,MAAM,OAAO,GAAG,6BAA6B,CAAC,CAAC,wCAAwC;IAEvF,OAAO,WAAW,CAAoB,WAAW,EAAE,qBAAqB,OAAO,GAAG,OAAO,EAAE,EAAE;QAC3F,MAAM,EAAE,KAAK;KACd,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaunt-sloth/review",
-  "version": "2.0.0-alpha.22",
+  "version": "2.0.0-alpha.24",
   "description": "Review functionality for Gaunt Sloth",
   "license": "MIT",
   "author": "Andrew Kondratev",
@@ -38,7 +38,7 @@
     "@langchain/langgraph": "^1.4.8",
     "langchain": "^1.5.3",
     "zod": "^4.4.3",
-    "@gaunt-sloth/core": "2.0.0-alpha.22"
+    "@gaunt-sloth/core": "2.0.0-alpha.24"
   },
   "files": [
     "./dist/*",