gaunt-sloth 2.0.0-alpha.2 → 2.0.0-alpha.21

package/dist/commands/commandUtils.js

@@ -1,9 +1,9 @@
 import { displayError } from '@gaunt-sloth/core/utils/consoleUtils.js';
 import { wrapContent } from '@gaunt-sloth/core/utils/llmUtils.js';
 /**
- * Requirements providers. Aliases are mapped to actual package paths.
+ * Requirement sources. Aliases are mapped to actual package paths.
  */
-export const REQUIREMENTS_PROVIDERS = {
+export const REQUIREMENTS_SOURCES = {
     'jira-legacy': '@gaunt-sloth/review/sources/jiraIssueLegacySource.js',
     jira: '@gaunt-sloth/review/sources/jiraIssueSource.js',
     github: '@gaunt-sloth/review/sources/ghIssueSource.js',
@@ -11,38 +11,38 @@ export const REQUIREMENTS_PROVIDERS = {
     file: '@gaunt-sloth/review/sources/fileSource.js',
 };
 /**
- * Content providers. Aliases are mapped to actual package paths.
+ * Content sources. Aliases are mapped to actual package paths.
  */
-export const CONTENT_PROVIDERS = {
+export const CONTENT_SOURCES = {
     github: '@gaunt-sloth/review/sources/ghPrDiffSource.js',
     text: '@gaunt-sloth/review/sources/textSource.js',
     file: '@gaunt-sloth/review/sources/fileSource.js',
 };
-export async function getRequirementsFromProvider(requirementsProvider, requirementsId, config) {
-    const requirements = await getFromProvider(requirementsProvider, requirementsId, (config?.requirementsProviderConfig ?? {})[requirementsProvider], REQUIREMENTS_PROVIDERS);
-    return wrapContent(requirements, requirementsProvider, 'requirements');
+export async function getRequirementsFromSource(requirementSource, requirementsId, config) {
+    const requirements = await getFromSource(requirementSource, requirementsId, (config?.requirementSourceConfig ?? {})[requirementSource], REQUIREMENTS_SOURCES);
+    return wrapContent(requirements, requirementSource, 'requirements');
 }
-export async function getContentFromProvider(contentProvider, contentId, config) {
-    const content = await getFromProvider(contentProvider, contentId, (config?.contentProviderConfig ?? {})[contentProvider], CONTENT_PROVIDERS);
-    return wrapContent(content, contentProvider, contentProvider === 'github' ? 'GitHub diff' : 'content');
+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');
 }
-async function getFromProvider(provider, id, 
+async function getFromSource(source, id, 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
-config, legitPredefinedProviders) {
-    if (typeof provider === 'string') {
-        // Use one of the predefined providers
-        if (legitPredefinedProviders[provider]) {
-            const providerPath = legitPredefinedProviders[provider];
-            const { get } = await import(providerPath);
+config, legitPredefinedSources) {
+    if (typeof source === 'string') {
+        // Use one of the predefined sources
+        if (legitPredefinedSources[source]) {
+            const sourcePath = legitPredefinedSources[source];
+            const { get } = await import(sourcePath);
             return await get(config, id);
         }
         else {
-            displayError(`Unknown provider: ${provider}. Continuing without it.`);
+            displayError(`Unknown source: ${source}. Continuing without it.`);
         }
     }
-    else if (typeof provider === 'function') {
+    else if (typeof source === 'function') {
         // Type assertion to handle function call
-        return await provider(id);
+        return await source(id);
     }
     return '';
 }

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;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,aAAa,EAAE,sDAAsD;IACrE,IAAI,EAAE,gDAAgD;IACtD,MAAM,EAAE,8CAA8C;IACtD,IAAI,EAAE,2CAA2C;IACjD,IAAI,EAAE,2CAA2C;CACzC,CAAC;AAIX;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM,EAAE,+CAA+C;IACvD,IAAI,EAAE,2CAA2C;IACjD,IAAI,EAAE,2CAA2C;CACzC,CAAC;AAIX,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,oBAA0D,EAC1D,cAAkC,EAClC,MAAiB;IAEjB,MAAM,YAAY,GAAG,MAAM,eAAe,CACxC,oBAAoB,EACpB,cAAc,EACd,CAAC,MAAM,EAAE,0BAA0B,IAAI,EAAE,CAAC,CAAC,oBAA8B,CAAC,EAC1E,sBAAsB,CACvB,CAAC;IACF,OAAO,WAAW,CAAC,YAAY,EAAE,oBAAoB,EAAE,cAAc,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,eAAgD,EAChD,SAA6B,EAC7B,MAAiB;IAEjB,MAAM,OAAO,GAAG,MAAM,eAAe,CACnC,eAAe,EACf,SAAS,EACT,CAAC,MAAM,EAAE,qBAAqB,IAAI,EAAE,CAAC,CAAC,eAAyB,CAAC,EAChE,iBAAiB,CAClB,CAAC;IACF,OAAO,WAAW,CAChB,OAAO,EACP,eAAe,EACf,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CACzD,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,QAAoE,EACpE,EAAsB;AACtB,8DAA8D;AAC9D,MAAW,EACX,wBAAkF;IAElF,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,sCAAsC;QACtC,IAAI,wBAAwB,CAAC,QAAiD,CAAC,EAAE,CAAC;YAChF,MAAM,YAAY,GAChB,wBAAwB,CAAC,QAAiD,CAAC,CAAC;YAC9E,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;YAC3C,OAAO,MAAM,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,qBAAqB,QAAQ,0BAA0B,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC1C,yCAAyC;QACzC,OAAO,MAAO,QAAwD,CAAC,EAAE,CAAC,CAAC;IAC7E,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,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAElE;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,aAAa,EAAE,sDAAsD;IACrE,IAAI,EAAE,gDAAgD;IACtD,MAAM,EAAE,8CAA8C;IACtD,IAAI,EAAE,2CAA2C;IACjD,IAAI,EAAE,2CAA2C;CACzC,CAAC;AAIX;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,+CAA+C;IACvD,IAAI,EAAE,2CAA2C;IACjD,IAAI,EAAE,2CAA2C;CACzC,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,sBAAsB,CAAC,MAA6C,CAAC,CAAC;YACzF,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/commands/configCommand.d.ts

@@ -0,0 +1,24 @@
+import { Command } from 'commander';
+import { type CommandLineConfigOverrides, type GthConfig } from '@gaunt-sloth/core/config.js';
+/**
+ * Produce a plain, printable, secret-free view of a fully-resolved {@link GthConfig}.
+ *
+ * The resolved config carries live, non-serializable objects (the instantiated `llm`, tool
+ * instances, middleware); those are replaced with short descriptors so the output is readable
+ * and JSON-safe. Every value under a secret-looking key is redacted. Pure — returns a fresh
+ * object and never mutates the input.
+ */
+export declare function redactConfigForPrint(config: GthConfig): Record<string, unknown>;
+/**
+ * Adds the `config` command group (GS2-1 read-side):
+ *
+ * - `gth config print [--json]` — resolve the config exactly as a run would (up-tree discovery
+ *   + global base + defaults merge) and print it, with secrets redacted. `--json` emits only the
+ *   JSON object (machine-readable); the default adds a source header.
+ * - `gth config validate` — validate the effective raw config against the schema WITHOUT building
+ *   the LLM. Unknown keys warn; a schema violation prints a path-scoped message and exits non-zero.
+ *
+ * Both honour the global `--config` / `--identity-profile` overrides via
+ * `commandLineConfigOverrides`.
+ */
+export declare function configCommand(program: Command, commandLineConfigOverrides: CommandLineConfigOverrides): void;

package/dist/commands/configCommand.js

@@ -0,0 +1,117 @@
+import { initConfig, validateConfig, } from '@gaunt-sloth/core/config.js';
+import { display, displayError, displayInfo, displaySuccess, displayWarning, } from '@gaunt-sloth/core/utils/consoleUtils.js';
+import { setExitCode } from '@gaunt-sloth/core/utils/systemUtils.js';
+/**
+ * Config keys whose VALUES must never be printed. Matched case-insensitively against the key
+ * name at any depth, so an accidental inline secret (an API key pasted into `configuration`,
+ * a bearer token, …) is redacted rather than echoed by `gth config print`.
+ */
+const SECRET_KEY_RE = /(api[-_]?key|secret|token|password|passwd|authorization|bearer|credential)/i;
+const REDACTED = '***REDACTED***';
+/**
+ * Produce a plain, printable, secret-free view of a fully-resolved {@link GthConfig}.
+ *
+ * The resolved config carries live, non-serializable objects (the instantiated `llm`, tool
+ * instances, middleware); those are replaced with short descriptors so the output is readable
+ * and JSON-safe. Every value under a secret-looking key is redacted. Pure — returns a fresh
+ * object and never mutates the input.
+ */
+export function redactConfigForPrint(config) {
+    // `llm` (the live BaseChatModel) is intentionally stripped and re-added below as a descriptor.
+    const { llm: _llm, tools, middleware, ...rest } = config;
+    void _llm;
+    // Deep-clone the JSON-safe remainder through a redacting replacer. Functions are dropped by
+    // JSON.stringify (fine — a printed config is documentation, not an executable). A defensive
+    // fallback keeps `print` working even if some exotic value is not serializable.
+    let out;
+    try {
+        out = JSON.parse(JSON.stringify(rest, (key, value) => (SECRET_KEY_RE.test(key) ? REDACTED : value)));
+    }
+    catch {
+        out = {};
+    }
+    // Reinstate the stripped live fields as human descriptors (never the instances themselves).
+    out.llm = config.modelDisplayName ? `[chat model: ${config.modelDisplayName}]` : '[chat model]';
+    if (Array.isArray(tools))
+        out.tools = `[${tools.length} tool instance(s)]`;
+    if (Array.isArray(middleware))
+        out.middleware = `[${middleware.length} middleware]`;
+    return out;
+}
+/**
+ * Adds the `config` command group (GS2-1 read-side):
+ *
+ * - `gth config print [--json]` — resolve the config exactly as a run would (up-tree discovery
+ *   + global base + defaults merge) and print it, with secrets redacted. `--json` emits only the
+ *   JSON object (machine-readable); the default adds a source header.
+ * - `gth config validate` — validate the effective raw config against the schema WITHOUT building
+ *   the LLM. Unknown keys warn; a schema violation prints a path-scoped message and exits non-zero.
+ *
+ * Both honour the global `--config` / `--identity-profile` overrides via
+ * `commandLineConfigOverrides`.
+ */
+export function configCommand(program, commandLineConfigOverrides) {
+    const config = program
+        .command('config')
+        .description('Inspect and validate the resolved Gaunt Sloth configuration');
+    config
+        .command('print')
+        .description('Print the fully-resolved configuration (secrets redacted)')
+        .option('--json', 'Emit only the JSON object (machine-readable), no header')
+        .action(async (options) => {
+        try {
+            const resolved = await initConfig(commandLineConfigOverrides);
+            const printable = redactConfigForPrint(resolved);
+            const json = JSON.stringify(printable, null, 2);
+            if (options.json) {
+                display(json);
+            }
+            else {
+                displayInfo('Resolved Gaunt Sloth configuration (secrets redacted):');
+                display(json);
+            }
+        }
+        catch (error) {
+            displayError(error instanceof Error ? error.message : String(error));
+            setExitCode(1);
+        }
+    });
+    config
+        .command('validate')
+        .description('Validate the configuration against the schema; exits non-zero when invalid')
+        .action(async () => {
+        try {
+            const report = await validateConfig(commandLineConfigOverrides);
+            if (!report.found) {
+                displayError('No configuration file found to validate. Run `gth init` to create one, ' +
+                    'or pass --config <path>.');
+                setExitCode(1);
+                return;
+            }
+            // GS2-29 — a run validates every layer (project + global), so the report carries a
+            // per-layer verdict. Prefix each warning/error with its source label so the user knows
+            // which file to fix.
+            for (const layer of report.layers) {
+                for (const warning of layer.warnings) {
+                    displayWarning(`${layer.sourceLabel}: ${warning}`);
+                }
+            }
+            const invalidLayers = report.layers.filter((layer) => !layer.ok);
+            if (invalidLayers.length === 0) {
+                displaySuccess(`Configuration is valid: ${report.layers.map((layer) => layer.sourceLabel).join(', ')}`);
+                return;
+            }
+            // Report EVERY failing layer, not just the first, so the user fixes all offending files.
+            for (const layer of invalidLayers) {
+                displayError(`Invalid configuration in ${layer.sourceLabel}:\n${layer.errorMessage ?? ''}`);
+            }
+            setExitCode(1);
+        }
+        catch (error) {
+            // A JSONC/module parse failure lands here — surface it as an invalid-config error.
+            displayError(`Failed to read configuration: ${error instanceof Error ? error.message : String(error)}`);
+            setExitCode(1);
+        }
+    });
+}
+//# sourceMappingURL=configCommand.js.map

package/dist/commands/configCommand.js.map

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

package/dist/commands/configSetup.d.ts

@@ -1,4 +1,4 @@
-export declare function createProjectConfig(configType: string): Promise<void>;
+export declare function createProjectConfig(configType: string, force?: boolean): Promise<void>;
 /**
  * Ensures that the .gsloth directory exists in the project root.
  * Creates it if it does not exist.

package/dist/commands/configSetup.js

@@ -1,11 +1,12 @@
 import { GSLOTH_DIR, PROJECT_GUIDELINES, PROJECT_REVIEW_INSTRUCTIONS, USER_PROJECT_CONFIG_JSON, } from '@gaunt-sloth/core/constants.js';
 import { availableDefaultConfigs } from '@gaunt-sloth/core/config.js';
+import { resolveInitModel } from '@gaunt-sloth/core/providers/modelDiscovery.js';
 import { displayError, displayInfo, displayWarning } from '@gaunt-sloth/core/utils/consoleUtils.js';
 import { getGslothConfigWritePath, writeFileIfNotExistsWithMessages, } from '@gaunt-sloth/review/utils/fileUtils.js';
 import { exit, getCurrentWorkDir } from '@gaunt-sloth/core/utils/systemUtils.js';
 import { existsSync, mkdirSync } from 'node:fs';
 import { resolve } from 'node:path';
-export async function createProjectConfig(configType) {
+export async function createProjectConfig(configType, force = false) {
     if (!availableDefaultConfigs.includes(configType)) {
         displayError(`Unknown config type: ${configType}. Available options: ${availableDefaultConfigs.join(', ')}`);
         exit(1);
@@ -14,9 +15,23 @@ export async function createProjectConfig(configType) {
     displayInfo(`Setting up your project\n`);
     writeProjectReviewPreamble();
     displayWarning(`Make sure you add as much detail as possible to your ${PROJECT_GUIDELINES}.\n`);
+    // The config file is the only artefact that gets an overwrite path; the preamble files above stay
+    // no-clobber. Without --force, keep an existing config (and say so honestly) rather than running
+    // the provider init, whose no-clobber write would silently skip and leave a misleading trail.
+    const configPath = getGslothConfigWritePath(USER_PROJECT_CONFIG_JSON);
+    if (!force && existsSync(configPath)) {
+        displayWarning(`${configPath} already exists and was kept (not overwritten). Re-run with --force to overwrite it.`);
+        return;
+    }
     displayInfo(`Creating project config for ${configType}`);
+    // CFG-14: resolve the model to write from live `/v1/models` discovery when a key/daemon is
+    // present (a verified-present id, never a speculative literal). When live discovery is
+    // impossible this returns undefined and `init` omits `model`, deferring to the provider's
+    // single curated run-time fallback (getCuratedFallbackModel) rather than baking a stale id that
+    // 404s once the model is retired.
+    const model = await resolveInitModel(configType);
     const vendorConfig = await import(`@gaunt-sloth/core/providers/${configType}.js`);
-    vendorConfig.init(getGslothConfigWritePath(USER_PROJECT_CONFIG_JSON));
+    vendorConfig.init(configPath, force, model);
 }
 /**
  * Ensures that the .gsloth directory exists in the project root.

package/dist/commands/configSetup.js.map

@@ -1 +1 @@
-{"version":3,"file":"configSetup.js","sourceRoot":"","sources":["../../src/commands/configSetup.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAmB,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AACpG,OAAO,EACL,wBAAwB,EACxB,gCAAgC,GACjC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,UAAkB;IAC1D,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,UAAwB,CAAC,EAAE,CAAC;QAChE,YAAY,CACV,wBAAwB,UAAU,wBAAwB,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/F,CAAC;QACF,IAAI,CAAC,CAAC,CAAC,CAAC;IACV,CAAC;IAED,eAAe,EAAE,CAAC;IAElB,WAAW,CAAC,2BAA2B,CAAC,CAAC;IACzC,0BAA0B,EAAE,CAAC;IAC7B,cAAc,CAAC,wDAAwD,kBAAkB,KAAK,CAAC,CAAC;IAEhG,WAAW,CAAC,+BAA+B,UAAU,EAAE,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,+BAA+B,UAAU,KAAK,CAAC,CAAC;IAClF,YAAY,CAAC,IAAI,CAAC,wBAAwB,CAAC,wBAAwB,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;IACvC,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACtD,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,SAAS,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,WAAW,CAAC,WAAW,UAAU,YAAY,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,MAAM,cAAc,GAAG,wBAAwB,CAAC,kBAAkB,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,wBAAwB,CAAC,2BAA2B,CAAC,CAAC;IAEzE,MAAM,kBAAkB,GAAG;;;;2EAI8C,kBAAkB;;qBAExE,kBAAkB;CACtC,CAAC;IAEA,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;CAexB,CAAC;IAEA,gCAAgC,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IACrE,gCAAgC,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"configSetup.js","sourceRoot":"","sources":["../../src/commands/configSetup.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAmB,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAmB,MAAM,+CAA+C,CAAC;AAClG,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AACpG,OAAO,EACL,wBAAwB,EACxB,gCAAgC,GACjC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,UAAkB,EAAE,KAAK,GAAG,KAAK;IACzE,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,UAAwB,CAAC,EAAE,CAAC;QAChE,YAAY,CACV,wBAAwB,UAAU,wBAAwB,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/F,CAAC;QACF,IAAI,CAAC,CAAC,CAAC,CAAC;IACV,CAAC;IAED,eAAe,EAAE,CAAC;IAElB,WAAW,CAAC,2BAA2B,CAAC,CAAC;IACzC,0BAA0B,EAAE,CAAC;IAC7B,cAAc,CAAC,wDAAwD,kBAAkB,KAAK,CAAC,CAAC;IAEhG,kGAAkG;IAClG,iGAAiG;IACjG,8FAA8F;IAC9F,MAAM,UAAU,GAAG,wBAAwB,CAAC,wBAAwB,CAAC,CAAC;IACtE,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,cAAc,CACZ,GAAG,UAAU,sFAAsF,CACpG,CAAC;QACF,OAAO;IACT,CAAC;IAED,WAAW,CAAC,+BAA+B,UAAU,EAAE,CAAC,CAAC;IACzD,2FAA2F;IAC3F,uFAAuF;IACvF,0FAA0F;IAC1F,gGAAgG;IAChG,kCAAkC;IAClC,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,UAAwB,CAAC,CAAC;IAC/D,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,+BAA+B,UAAU,KAAK,CAAC,CAAC;IAClF,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;IACvC,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACtD,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,SAAS,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,WAAW,CAAC,WAAW,UAAU,YAAY,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,MAAM,cAAc,GAAG,wBAAwB,CAAC,kBAAkB,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,wBAAwB,CAAC,2BAA2B,CAAC,CAAC;IAEzE,MAAM,kBAAkB,GAAG;;;;2EAI8C,kBAAkB;;qBAExE,kBAAkB;CACtC,CAAC;IAEA,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;CAexB,CAAC;IAEA,gCAAgC,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IACrE,gCAAgC,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;AAC/D,CAAC"}

package/dist/commands/evalCommand.d.ts

@@ -0,0 +1,41 @@
+import { Command } from 'commander';
+import { CommandLineConfigOverrides } from '@gaunt-sloth/core/config.js';
+/** Split each collected `--reporter` value on `,`, flatten, trim, drop blanks, and de-duplicate
+ * (order-preserving), so `-r junit,text` and `-r junit -r text` both yield `['junit','text']`. */
+export declare function normalizeReporterNames(collected: string[]): string[];
+/** Default output dir when `-o/--output` is omitted: a timestamped dir next to other gth reports —
+ * same convention as `defaultBatchOutputDir` in `batchCommand.ts`, `_EVAL` suffix instead. */
+export declare function defaultEvalOutputDir(): string;
+/**
+ * Pure resolver for the judge identity profile — kept small and side-effect-free so it's unit
+ * testable in isolation. Precedence (highest first): CLI `--judge <profile>` > suite-level
+ * `judge_profile` > none. A blank/whitespace-only value at either level counts as absent (falls
+ * through to the next level). `undefined` means "no separate judge — grade with the SUT's config".
+ */
+export declare function resolveJudgeProfile(cliJudge: string | undefined, suiteJudgeProfile: string | undefined): string | undefined;
+/**
+ * Adds the `eval` command to the program.
+ *
+ * `gth eval <suite.yaml> [-j 8] [-o out/]` — grades a suite of cases (deterministic checks and/or
+ * an LLM judge) against the SUT agent, the way `review` grades a diff. See
+ * docs/batch-eval-cli-surface.md and docs/batch-eval-user-requirements.md for the design; this
+ * command implements the single-`prompt`, `gth-agent`-target, `config.llm`-as-judge subset — see
+ * the BATCH-2 Task 2 brief's "Not in scope" list for what's deliberately deferred.
+ *
+ * Exit-code contract (BATCH-11 / #405 his #6 — a distinct three-way code so CI can tell a product
+ * regression from a broken harness):
+ * - `0` — every case passed (mirrors `review`; unchanged contract).
+ * - `1` — the suite **ran** but ≥1 case FAILED (a deterministic check or the judge fell below
+ *   threshold). A *product* signal: real, gradeable results, some below the bar.
+ * - `2` — **harness error**: the suite couldn't be meaningfully evaluated — the suite file failed
+ *   to load/parse, config failed to build, or **every** case's SUT run failed (`sutOk:false`, e.g.
+ *   a transport/auth/config failure produced no answer to grade). An *environment* signal.
+ *
+ * The suite-vs-harness split is anchored on `sutOk` (see `classifyEvalExit`), not the verdict: a
+ * case that ran (`sutOk:true`) but whose judge errored, or whose answer failed a check, is still a
+ * real result → exit `1`, never `2`. Unlike `batch`, which exits 0 regardless of per-cell quality.
+ *
+ * @param program - The commander program
+ * @param commandLineConfigOverrides - command line config overrides
+ */
+export declare function evalCommand(program: Command, commandLineConfigOverrides: CommandLineConfigOverrides): void;