@copado/agentia-cli 1.0.0-beta.4 → 1.0.0-beta.5

package/dist/commands/cicd/work/test/apex.js

@@ -1,22 +1,32 @@
 import { Flags } from '@oclif/core';
 import { AgentiaCommand } from '../../../../lib/agentia-command.js';
-import { DEFAULT_APEX_TEST_WAIT_MINUTES, formatWorkApexTestHuman, parseApexTestClassNames, runWorkApexTests, validateApexTestWaitMinutes, WorkApexTestError, } from '../../../../lib/work-apex-test.js';
+import { planWorkApexTestRun, recordWorkApexTestOutcome, WorkApexRerunError, } from '../../../../lib/work-apex-test-failures.js';
+import { DEFAULT_APEX_TEST_WAIT_MINUTES, formatWorkApexTestHuman, parseApexTestClassNames, runWorkApexTests, skippedWorkApexTestResult, validateApexTestWaitMinutes, WorkApexTestError, } from '../../../../lib/work-apex-test.js';
 export default class WorkTestApex extends AgentiaCommand {
     static description = [
         'Run specified Apex test classes via Salesforce CLI (`sf apex run test`) with code coverage.',
         'Usually run from project-root local quality gates (`.agentia_quality_gates.sh` / `.agentia_quality_gates.cmd`) when those scripts are configured.',
+        'When `--apex-test-classes` is omitted or empty, logs that no Apex tests were specified and exits without running Salesforce CLI.',
+        'Failed runs save `.agentia/apex.tests.<user-story>.json`; successful runs delete that file.',
+        '`--rerun-failed-apex-tests` runs the previously failed classes (optionally filtered by `--apex-test-classes`).',
         'Prints the test-run summary when the run passes, or failing tests with their messages and stack traces when it fails.',
+        'Exits with the same process exit code as Salesforce CLI (`sf`), including 100 when Apex tests fail.',
     ].join(' ');
     static examples = [
         '<%= config.bin %> <%= command.id %> -t HelloWorldTest',
         '<%= config.bin %> <%= command.id %> --apex-test-classes=MyTest,OtherTest',
         '<%= config.bin %> <%= command.id %> -t MyTest,OtherTest -w 10 --json',
+        '<%= config.bin %> <%= command.id %> -t "$AGENTIA_APEX_TEST_CLASSES"',
+        '<%= config.bin %> <%= command.id %> --rerun-failed-apex-tests',
     ];
     static flags = {
         'apex-test-classes': Flags.string({
             char: 't',
-            description: 'Comma-separated Apex test class names to run',
-            required: true,
+            description: 'Comma-separated Apex test class names to run. Omit or leave empty to skip without running Salesforce CLI.',
+        }),
+        'rerun-failed-apex-tests': Flags.boolean({
+            default: false,
+            description: 'Rerun Apex classes saved from the last failure for this user story (`.agentia/apex.tests.<user-story>.json`). Combined with --apex-test-classes, only matching failed classes run.',
         }),
         wait: Flags.integer({
             char: 'w',
@@ -36,8 +46,30 @@ export default class WorkTestApex extends AgentiaCommand {
         catch (error) {
             this.error(error.message, { exit: 2 });
         }
+        let plan;
+        try {
+            plan = await planWorkApexTestRun({
+                requestedClassNames: classNames,
+                rerunFailed: flags['rerun-failed-apex-tests'] === true,
+            });
+        }
+        catch (error) {
+            if (error instanceof WorkApexRerunError) {
+                this.error(error.message, { exit: 2 });
+            }
+            throw error;
+        }
+        if (plan.kind === 'skip') {
+            const result = skippedWorkApexTestResult(waitMinutes);
+            this.display(() => {
+                this.log(plan.message);
+            });
+            this.logElapsed(startedAt);
+            return result;
+        }
         try {
-            const result = await this.withSpinner(`Running Apex tests (${classNames.join(', ')}), waiting up to ${waitMinutes} minute(s)`, () => runWorkApexTests({ classNames, waitMinutes }));
+            const result = await this.withSpinner(`Running Apex tests (${plan.classNames.join(', ')}), waiting up to ${waitMinutes} minute(s)`, () => runWorkApexTests({ classNames: plan.classNames, waitMinutes }));
+            await recordWorkApexTestOutcome({ failed: false, result, userStory: plan.userStory });
             this.display(() => {
                 this.log(formatWorkApexTestHuman(result));
             });
@@ -46,6 +78,7 @@ export default class WorkTestApex extends AgentiaCommand {
         }
         catch (error) {
             if (error instanceof WorkApexTestError) {
+                await recordWorkApexTestOutcome({ failed: true, result: error.result, userStory: plan.userStory });
                 this.display(() => {
                     this.log(formatWorkApexTestHuman(error.result));
                 });

package/dist/commands/cicd/work/test.js

@@ -2,7 +2,7 @@ import { Flags } from '@oclif/core';
 import path from 'node:path';
 import { AgentiaCommand } from '../../../lib/agentia-command.js';
 import { getCurrentBranch } from '../../../lib/git-worktree.js';
-import { LocalQualityGatesError, resolveLocalQualityGatesScript } from '../../../lib/local-quality-gates.js';
+import { LocalQualityGatesError, parseQualityGatesEnvAssignments, resolveLocalQualityGatesScript, } from '../../../lib/local-quality-gates.js';
 import { runWorkTestLocalQualityGates } from '../../../lib/stock-quality-gates.js';
 import { reportLocalQualityGatesFailure, reportLocalQualityGatesOutcome, } from '../../../lib/work-local-run-tests.js';
 import { extractUserStoryFromFeatureBranch } from '../../../lib/work-types.js';
@@ -17,6 +17,8 @@ export default class WorkTest extends AgentiaCommand {
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --local --apex-test-classes=MyTest,OtherTest',
+        '<%= config.bin %> <%= command.id %> --local --rerun-failed-apex-tests',
+        '<%= config.bin %> <%= command.id %> -e SKIP_LWC_TESTS=1 -e TOOL_API_KEY=secret',
         '<%= config.bin %> <%= command.id %> --json',
         '<%= config.bin %> <%= command.id %> --cloud',
     ];
@@ -28,10 +30,19 @@ export default class WorkTest extends AgentiaCommand {
             default: false,
             description: 'Run remote Copado quality gates (not implemented yet).',
         }),
+        env: Flags.string({
+            char: 'e',
+            description: 'Extra environment variable for the quality-gate script as NAME=value. Repeatable. Applied before reserved AGENTIA_APEX_* variables.',
+            multiple: true,
+        }),
         local: Flags.boolean({
             default: false,
             description: 'Run local project-root quality gates scripts. Used by default when --cloud is omitted.',
         }),
+        'rerun-failed-apex-tests': Flags.boolean({
+            default: false,
+            description: 'Pass AGENTIA_APEX_RERUN_FAILED=--rerun-failed-apex-tests to local quality gates so sample scripts forward that flag to work test apex.',
+        }),
     };
     async run() {
         const { flags } = await this.parse(WorkTest);
@@ -45,6 +56,12 @@ export default class WorkTest extends AgentiaCommand {
                 suggestions: [`${this.config.bin} cicd work test --local`],
             });
         }
+        try {
+            parseQualityGatesEnvAssignments(flags.env);
+        }
+        catch (error) {
+            this.error(error.message, { exit: 2 });
+        }
         let qualityGates;
         try {
             const scriptPath = resolveLocalQualityGatesScript();
@@ -60,7 +77,9 @@ export default class WorkTest extends AgentiaCommand {
             }
             qualityGates = await runWorkTestLocalQualityGates({
                 apexTestClasses: flags['apex-test-classes'],
+                env: flags.env,
                 onWarning: (message) => this.warn(message),
+                rerunFailed: flags['rerun-failed-apex-tests'] === true,
             });
             if (qualityGates.ran && qualityGates.scriptPath !== undefined) {
                 this.display(() => {

package/dist/lib/cicd-gateway.js

@@ -9,6 +9,7 @@ const CicdGatewayError = modules["cicd-gateway.js"]["CicdGatewayError"]
 const GATEWAY_EVENT_API_CALL = modules["cicd-gateway.js"]["GATEWAY_EVENT_API_CALL"]
 const GATEWAY_EVENT_UNKNOWN = modules["cicd-gateway.js"]["GATEWAY_EVENT_UNKNOWN"]
 const MCP_CICD_DEFAULT_REQUEST_TIMEOUT_MS = modules["cicd-gateway.js"]["MCP_CICD_DEFAULT_REQUEST_TIMEOUT_MS"]
+const PLUGIN_GATEWAY_EVENT_SERVICE = modules["cicd-gateway.js"]["PLUGIN_GATEWAY_EVENT_SERVICE"]
 const buildGatewayEventLogPayload = modules["cicd-gateway.js"]["buildGatewayEventLogPayload"]
 const cicdApiUrl = modules["cicd-gateway.js"]["cicdApiUrl"]
 const createTransactionId = modules["cicd-gateway.js"]["createTransactionId"]
@@ -40,4 +41,4 @@ const scheduleGatewayEventLog = modules["cicd-gateway.js"]["scheduleGatewayEvent
 const setGatewayEventLogSenderForTests = modules["cicd-gateway.js"]["setGatewayEventLogSenderForTests"]
 const setHttpRequestForTests = modules["cicd-gateway.js"]["setHttpRequestForTests"]
 const tryResolveCicdCredentials = modules["cicd-gateway.js"]["tryResolveCicdCredentials"]
-export {AGENTIA_CLIENT_ORIGIN_ENV, AGENTIA_IDE_VERSION_ENV, AI_GATEWAY_EVENT_SERVICE, CICD_ENV, CRT_GATEWAY_EVENT_SERVICE, CicdGateway, CicdGatewayError, GATEWAY_EVENT_API_CALL, GATEWAY_EVENT_UNKNOWN, MCP_CICD_DEFAULT_REQUEST_TIMEOUT_MS, buildGatewayEventLogPayload, cicdApiUrl, createTransactionId, discoverCicdBaseUrl, flushGatewayEventLogsForTests, formatCicdGatewayError, formatGatewayEventTimestamp, gatewayEventSource, gatewayRefererHeaders, gatewayUserAgent, getActiveHttpRequestOptionsForTests, getGatewayClientOrigin, getGatewayReferer, getGatewayTransactionId, isCicdWarningResponseBody, isCicdWarningStatus, maskUrlSecrets, maskedCicdApiUrl, normalizeCicdBaseUrl, parseRetryAfterHeader, resetGatewayEventLogSenderForTests, resetHttpRequestForTests, resolveAndValidateCicdEndpoint, resolveCicdCredentials, resolveCicdRequestTimeoutMs, resolveConfiguredCicdBaseUrl, runWithGatewayTransactionContext, scheduleGatewayEventLog, setGatewayEventLogSenderForTests, setHttpRequestForTests, tryResolveCicdCredentials};
+export {AGENTIA_CLIENT_ORIGIN_ENV, AGENTIA_IDE_VERSION_ENV, AI_GATEWAY_EVENT_SERVICE, CICD_ENV, CRT_GATEWAY_EVENT_SERVICE, CicdGateway, CicdGatewayError, GATEWAY_EVENT_API_CALL, GATEWAY_EVENT_UNKNOWN, MCP_CICD_DEFAULT_REQUEST_TIMEOUT_MS, PLUGIN_GATEWAY_EVENT_SERVICE, buildGatewayEventLogPayload, cicdApiUrl, createTransactionId, discoverCicdBaseUrl, flushGatewayEventLogsForTests, formatCicdGatewayError, formatGatewayEventTimestamp, gatewayEventSource, gatewayRefererHeaders, gatewayUserAgent, getActiveHttpRequestOptionsForTests, getGatewayClientOrigin, getGatewayReferer, getGatewayTransactionId, isCicdWarningResponseBody, isCicdWarningStatus, maskUrlSecrets, maskedCicdApiUrl, normalizeCicdBaseUrl, parseRetryAfterHeader, resetGatewayEventLogSenderForTests, resetHttpRequestForTests, resolveAndValidateCicdEndpoint, resolveCicdCredentials, resolveCicdRequestTimeoutMs, resolveConfiguredCicdBaseUrl, runWithGatewayTransactionContext, scheduleGatewayEventLog, setGatewayEventLogSenderForTests, setHttpRequestForTests, tryResolveCicdCredentials};

package/dist/lib/local-quality-gates.js

@@ -1,13 +1,16 @@
 import {modules} from './runtime.js';
+const AGENTIA_APEX_RERUN_FAILED_ENV = modules["local-quality-gates.js"]["AGENTIA_APEX_RERUN_FAILED_ENV"]
+const AGENTIA_APEX_RERUN_FAILED_FLAG = modules["local-quality-gates.js"]["AGENTIA_APEX_RERUN_FAILED_FLAG"]
 const AGENTIA_APEX_TEST_CLASSES_ENV = modules["local-quality-gates.js"]["AGENTIA_APEX_TEST_CLASSES_ENV"]
 const LocalQualityGatesError = modules["local-quality-gates.js"]["LocalQualityGatesError"]
 const QUALITY_GATES_SCRIPT_UNIX = modules["local-quality-gates.js"]["QUALITY_GATES_SCRIPT_UNIX"]
 const QUALITY_GATES_SCRIPT_WINDOWS = modules["local-quality-gates.js"]["QUALITY_GATES_SCRIPT_WINDOWS"]
 const buildQualityGatesCommand = modules["local-quality-gates.js"]["buildQualityGatesCommand"]
+const parseQualityGatesEnvAssignments = modules["local-quality-gates.js"]["parseQualityGatesEnvAssignments"]
 const qualityGatesScriptName = modules["local-quality-gates.js"]["qualityGatesScriptName"]
 const resetLocalQualityGatesForTests = modules["local-quality-gates.js"]["resetLocalQualityGatesForTests"]
 const resolveLocalQualityGatesScript = modules["local-quality-gates.js"]["resolveLocalQualityGatesScript"]
 const runLocalQualityGates = modules["local-quality-gates.js"]["runLocalQualityGates"]
 const setLocalQualityGatesExistsSyncForTests = modules["local-quality-gates.js"]["setLocalQualityGatesExistsSyncForTests"]
 const setLocalQualityGatesSpawnForTests = modules["local-quality-gates.js"]["setLocalQualityGatesSpawnForTests"]
-export {AGENTIA_APEX_TEST_CLASSES_ENV, LocalQualityGatesError, QUALITY_GATES_SCRIPT_UNIX, QUALITY_GATES_SCRIPT_WINDOWS, buildQualityGatesCommand, qualityGatesScriptName, resetLocalQualityGatesForTests, resolveLocalQualityGatesScript, runLocalQualityGates, setLocalQualityGatesExistsSyncForTests, setLocalQualityGatesSpawnForTests};
+export {AGENTIA_APEX_RERUN_FAILED_ENV, AGENTIA_APEX_RERUN_FAILED_FLAG, AGENTIA_APEX_TEST_CLASSES_ENV, LocalQualityGatesError, QUALITY_GATES_SCRIPT_UNIX, QUALITY_GATES_SCRIPT_WINDOWS, buildQualityGatesCommand, parseQualityGatesEnvAssignments, qualityGatesScriptName, resetLocalQualityGatesForTests, resolveLocalQualityGatesScript, runLocalQualityGates, setLocalQualityGatesExistsSyncForTests, setLocalQualityGatesSpawnForTests};

package/dist/lib/mcp/work-tools.js

@@ -6,18 +6,19 @@ import { reconcileWorkSetCredential, sanitizeWorkSetUserStory } from '../credent
 import { readDefaults, resolveDefaults, writeLastWorkSelection, } from '../defaults-store.js';
 import { checkoutFeatureBranch, fetchOriginBranch, fetchOriginBranchIfExists, listPendingChanges, } from '../git-worktree.js';
 import { listPaginationZodFields, mcpPaginatedListPayload } from '../list-pagination.js';
-import { LocalQualityGatesError, runLocalQualityGates } from '../local-quality-gates.js';
+import { LocalQualityGatesError, parseQualityGatesEnvAssignments, runLocalQualityGates, } from '../local-quality-gates.js';
 import { FULL_METADATA_SELECTION_TYPES_HELP } from '../nested-metadata-registry.js';
 import { PROJECT_DEFAULT_KEYS } from '../project-defaults.js';
 import { performPromotionRun, PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS, resolvePromotionIdForWorkItem, } from '../promotion-run.js';
 import { runWorkTestLocalQualityGates } from '../stock-quality-gates.js';
 import { getUserContext } from '../user-context.js';
 import { resolveWorkItemId } from '../work-active.js';
-import { DEFAULT_APEX_TEST_WAIT_MINUTES, parseApexTestClassNames, runWorkApexTests, validateApexTestWaitMinutes, } from '../work-apex-test.js';
-import { fetchUserStory } from '../work-get.js';
+import { planWorkApexTestRun, recordWorkApexTestOutcome } from '../work-apex-test-failures.js';
+import { DEFAULT_APEX_TEST_WAIT_MINUTES, parseApexTestClassNames, runWorkApexTests, skippedWorkApexTestResult, validateApexTestWaitMinutes, WorkApexTestError, } from '../work-apex-test.js';
 import { buildWorkCommitRequest, normalizeWorkCommitInput, performWorkCommit, resolveWorkCommitPlatformExperience, WORK_COMMIT_ACTIONS, WORK_COMMIT_CHANGES_HELP, WORK_COMMIT_DEFAULT_TIMEOUT_SECONDS, WORK_COMMIT_METADATA_CATEGORY_HELP, } from '../work-commit.js';
 import { buildWorkCreatePayload } from '../work-defaults.js';
 import { validateWorkMutationPayload, WORK_LONG_TEXT_MAX_LENGTH, WORK_SHORT_TEXT_MAX_LENGTH, } from '../work-flags.js';
+import { fetchUserStory } from '../work-get.js';
 import { performWorkLocalCommit } from '../work-local-commit.js';
 import { reportLocalQualityGatesFailure, reportLocalQualityGatesOutcome, } from '../work-local-run-tests.js';
 import { capturingWorkPushHooks, performWorkPush, resolveActiveFeatureWorkItem, resolveWorkPushContext, resolveWorkPushNeed, } from '../work-push.js';
@@ -379,13 +380,16 @@ async function workTest(args = {}) {
     if (args.cloud === true) {
         throw new Error('Cloud quality gates are not implemented yet. Pass local: true or omit cloud to run project-root quality gates.');
     }
+    parseQualityGatesEnvAssignments(args.env);
     let qualityGates;
     try {
         qualityGates = await runWorkTestLocalQualityGates({
             apexTestClasses: args.apexTestClasses,
+            env: args.env,
             onOutput() {
                 // Capture output for the tool result/error; do not stream to the MCP stdio transport.
             },
+            rerunFailed: args.rerunFailedApexTests === true,
         });
     }
     catch (error) {
@@ -417,9 +421,26 @@ async function workTest(args = {}) {
     };
 }
 async function workTestApex(args) {
-    const classNames = parseApexTestClassNames(assertRequired(args.apexTestClasses, 'apexTestClasses'));
+    const classNames = parseApexTestClassNames(args.apexTestClasses);
     const waitMinutes = validateApexTestWaitMinutes(args.wait ?? DEFAULT_APEX_TEST_WAIT_MINUTES);
-    return runWorkApexTests({ classNames, waitMinutes });
+    const plan = await planWorkApexTestRun({
+        requestedClassNames: classNames,
+        rerunFailed: args.rerunFailedApexTests === true,
+    });
+    if (plan.kind === 'skip') {
+        return skippedWorkApexTestResult(waitMinutes);
+    }
+    try {
+        const result = await runWorkApexTests({ classNames: plan.classNames, waitMinutes });
+        await recordWorkApexTestOutcome({ failed: false, result, userStory: plan.userStory });
+        return result;
+    }
+    catch (error) {
+        if (error instanceof WorkApexTestError) {
+            await recordWorkApexTestOutcome({ failed: true, result: error.result, userStory: plan.userStory });
+        }
+        throw error;
+    }
 }
 function hasMcpSimpleCommitArgs(args) {
     return (args.action !== undefined ||
@@ -790,7 +811,7 @@ export function registerAgentiaMcpWorkTools(server) {
         title: 'Agentia Work Submit',
     }, (args) => safelyHandleTool(() => workSubmit(args || {})));
     server.registerTool('agentia_work_test', {
-        description: 'Run quality gates for the current work item. With local=true (the default when cloud is omitted), runs project-root .agentia_quality_gates.sh (macOS/Linux) or .agentia_quality_gates.cmd (Windows) when present. When no project script exists, warns and runs the stock Agentia setup sample from a temporary file. With cloud=true, runs remote Copado quality gates (not implemented yet).',
+        description: 'Run quality gates for the current work item. With local=true (the default when cloud is omitted), runs project-root .agentia_quality_gates.sh (macOS/Linux) or .agentia_quality_gates.cmd (Windows) when present. When no project script exists, warns and runs the stock Agentia setup sample from a temporary file. With cloud=true, runs remote Copado quality gates (not implemented yet). Optional env is an array of NAME=value strings injected into the quality-gate script environment (same as CLI -e/--env).',
         inputSchema: {
             apexTestClasses: z
                 .string()
@@ -800,19 +821,32 @@ export function registerAgentiaMcpWorkTools(server) {
                 .boolean()
                 .optional()
                 .describe('Run remote Copado quality gates (not implemented yet).'),
+            env: z
+                .array(z.string())
+                .optional()
+                .describe('Extra environment variables for the quality-gate script as NAME=value strings (same as CLI -e/--env). Applied before reserved AGENTIA_APEX_* variables.'),
             local: z
                 .boolean()
                 .optional()
                 .describe('Run local project-root quality gates scripts. Used by default when cloud is omitted.'),
+            rerunFailedApexTests: z
+                .boolean()
+                .optional()
+                .describe('Pass AGENTIA_APEX_RERUN_FAILED=--rerun-failed-apex-tests to local quality gates so sample scripts forward that flag to work test apex.'),
         },
         title: 'Agentia Work Test',
     }, (args) => safelyHandleTool(() => workTest(args || {})));
     server.registerTool('agentia_work_test_apex', {
-        description: 'Run specified Apex test classes via Salesforce CLI (`sf apex run test`) with code coverage. Usually run from project-root local quality gates (`.agentia_quality_gates.sh` / `.agentia_quality_gates.cmd`) when those scripts are configured. Returns the test-run summary when the run passes. Failed runs include failing tests with Message and StackTrace.',
+        description: 'Run specified Apex test classes via Salesforce CLI (`sf apex run test`) with code coverage. Usually run from project-root local quality gates (`.agentia_quality_gates.sh` / `.agentia_quality_gates.cmd`) when those scripts are configured. When apexTestClasses is omitted or empty, skips Salesforce CLI and returns skipped=true. Failed runs save `.agentia/apex.tests.<user-story>.json`; successful runs delete that file. rerunFailedApexTests runs the previously failed classes. Returns the test-run summary when the run passes. Failed runs include failing tests with Message and StackTrace.',
         inputSchema: {
             apexTestClasses: z
                 .string()
-                .describe('Comma-separated Apex test class names to run.'),
+                .optional()
+                .describe('Comma-separated Apex test class names to run. Omit or leave empty to skip without running Salesforce CLI.'),
+            rerunFailedApexTests: z
+                .boolean()
+                .optional()
+                .describe('Rerun Apex classes saved from the last failure for this user story. Combined with apexTestClasses, only matching failed classes run.'),
             wait: z
                 .number()
                 .int()

package/dist/lib/plugin-host/event-log.js

@@ -0,0 +1,3 @@
+import {modules} from '../runtime.js';
+const schedulePluginHostEvent = modules["plugin-host/event-log.js"]["schedulePluginHostEvent"]
+export {schedulePluginHostEvent};