@copado/agentia-cli 1.0.0-beta.9 → 1.0.0-rc.0

package/dist/commands/cicd/work/ahead-behind.js

@@ -0,0 +1,51 @@
+import { Args, Flags } from '@oclif/core';
+import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { formatWorkAheadBehindResult, performWorkAheadBehind, WorkAheadBehindValidationError, } from '../../../lib/work-ahead-behind.js';
+export default class WorkAheadBehind extends AgentiaCommand {
+    static args = {
+        environment: Args.string({
+            description: 'Copado environment Id or name (defaults to the configured project default environment)',
+            required: false,
+        }),
+    };
+    static description = [
+        'Compare user stories ahead of and behind the next pipeline environment.',
+        'Resolves the project (and its pipeline) from the project default or --project,',
+        'finds the unique next environment from pipeline connections for the given or default environment,',
+        'then GET /agentia/headless/work/user-stories-ahead-behind.',
+    ].join(' ');
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> dev1',
+        '<%= config.bin %> <%= command.id %> a0E... --project a0w...',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    static flags = {
+        project: Flags.string({
+            description: 'Copado project Id (defaults to the configured project default)',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(WorkAheadBehind);
+        try {
+            const result = await this.withSpinner('Comparing user stories ahead and behind', () => performWorkAheadBehind({
+                ...(args.environment === undefined ? {} : { environment: args.environment }),
+                ...(flags.project === undefined ? {} : { project: flags.project }),
+            }));
+            this.display(() => {
+                this.log(formatWorkAheadBehindResult(result));
+            });
+            return result;
+        }
+        catch (error) {
+            if (error instanceof WorkAheadBehindValidationError) {
+                this.error(error.message, {
+                    exit: 1,
+                    ...(error.suggestions === undefined ? {} : { suggestions: error.suggestions }),
+                });
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=ahead-behind.js.map

package/dist/commands/cicd/work/environment-sync.js

@@ -13,6 +13,7 @@ export default class WorkEnvironmentSync extends AgentiaCommand {
         'If guessed pathspecs still conflict, PATCH the back-promotion status to Merge Conflict, resolve the files, and re-run with --promotion and --continue. The promotion destination environment supplies the dest org branch and the next-env branch.',
         'To discard a conflicted merge, re-run with --promotion and --abort (runs git merge --abort and sets the back-promotion status to Draft).',
         'After a successful sync, PATCH the back-promotion status to Completed.',
+        'On git/merge failure (including conflicts) and after a successful --continue, uploads the captured command transcript as a Salesforce File on the back-promotion (`Environment Sync Logs <name-or-id> <datetime>.txt`) via `/agentia/headless/file/upload`. HTTP 404 is ignored until that endpoint is rolled out; other upload failures are warned and do not change the environment-sync outcome.',
     ].join(' ');
     static examples = [
         '<%= config.bin %> <%= command.id %> --destination-environment=dev1',

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

@@ -2,14 +2,15 @@ import { Flags } from '@oclif/core';
 import path from 'node:path';
 import { AgentiaCommand } from '../../../lib/agentia-command.js';
 import { CicdGateway } from '../../../lib/cicd-gateway.js';
-import { attachCapturedOutputLogs, commandStdioCaptureOptions, withCapturedCommandOutput } from '../../../lib/command-output-buffer.js';
+import { commandStdioCaptureOptions, withCapturedCommandOutput } from '../../../lib/command-output-buffer.js';
 import { readLastBaseBranch, readLastPullRequestBaseUrl, readSkipPullRequest, } from '../../../lib/defaults-store.js';
-import { listPendingChanges } from '../../../lib/git-worktree.js';
+import { getHeadCommitId, listPendingChanges } from '../../../lib/git-worktree.js';
 import { LocalQualityGatesError, resolveLocalQualityGatesScript, runLocalQualityGates, } from '../../../lib/local-quality-gates.js';
 import { openUrl } from '../../../lib/open-browser.js';
+import { resolveWorkItemId } from '../../../lib/work-active.js';
 import { pickWorkDoneFlags, runWorkDone, workDoneFlags } from '../../../lib/work-done.js';
 import { reportLocalQualityGatesFailure, reportLocalQualityGatesOutcome, } from '../../../lib/work-local-run-tests.js';
-import { performWorkPush, resolveActiveFeatureWorkItem, resolveWorkPushContext, resolveWorkPushNeed, WorkPushValidationError, } from '../../../lib/work-push.js';
+import { performWorkPush, resolveActiveFeatureWorkItem, resolveWorkPushContext, resolveWorkPushNeed, uploadCapturedPublishLogsBestEffort, WorkPushValidationError, } from '../../../lib/work-push.js';
 import { reportSubmitUserStoriesAheadBehind } from '../../../lib/work-submit-ahead-behind.js';
 import { waitForPendingCommitJobBeforeSubmit } from '../../../lib/work-submit-wait.js';
 import { buildPullRequestCompareUrl, formatWorkCommandMessage, workSubmitEndpoint, } from '../../../lib/work-types.js';
@@ -21,6 +22,7 @@ export default class WorkSubmit extends AgentiaCommand {
         '(Promote Action with validate=true).',
         'When the last pending related job template name contains Commit, waits up to 5 minutes for that job before submitting.',
         'Before submit or promote, counts user stories ahead and behind between the source environment and the next pipeline environment, and warns when stories behind might cause promotion conflicts (advising `agentia cicd work environment-sync`).',
+        'After a successful submit or promote, uploads the captured command output as a Salesforce File on the user story (`Local Commit Logs <commitId> <datetime>.txt`) via `/agentia/headless/file/upload`. HTTP 404 is ignored until that endpoint is rolled out; other upload failures are warned and do not fail the command.',
         'With --done or --deploy, matches Copado UI Submit when promoting (validate=false / headless work/done).',
         'cicd work done is a compatibility alias of this command with --done.',
     ].join(' ');
@@ -185,6 +187,7 @@ export default class WorkSubmit extends AgentiaCommand {
                             log: (message) => this.log(message),
                             withSpinner: (message, action) => this.withSpinner(message, action),
                         },
+                        skipLogUpload: true,
                         skipNestedMetadataDetection: flags['skip-nested-metadata-detection'],
                     });
                 }
@@ -209,7 +212,7 @@ export default class WorkSubmit extends AgentiaCommand {
             });
             await waitForPendingCommitJobBeforeSubmit(this, workItem);
             const submit = await this.withSpinner('Submitting work item', () => CicdGateway.call({
-                body: attachCapturedOutputLogs({ workItem }),
+                body: { workItem },
                 endpoint: workSubmitEndpoint(),
                 headers: {
                     'Content-Type': 'application/json',
@@ -219,6 +222,16 @@ export default class WorkSubmit extends AgentiaCommand {
             this.display(() => {
                 this.log(formatWorkCommandMessage(submit.message));
             });
+            const tipCommitId = pushResult?.commits.at(-1)?.id ?? (await getHeadCommitId());
+            await uploadCapturedPublishLogsBestEffort({
+                commitId: tipCommitId,
+                hooks: {
+                    display: (render) => this.display(render),
+                    log: (message) => this.log(message),
+                    withSpinner: (message, action) => this.withSpinner(message, action),
+                },
+                linkedEntityId: await resolveWorkItemId(),
+            });
             await this.openPullRequestCompareUrl(branch, flags['skip-pull-request']);
             this.logElapsed(startedAt);
             return {

package/dist/commands/update.js

@@ -2,20 +2,28 @@ import { Flags } from '@oclif/core';
 import { AgentiaCommand } from '../lib/agentia-command.js';
 import { runCliUpdate } from '../lib/cli-update.js';
 export default class Update extends AgentiaCommand {
-    static description = 'Update the globally installed Agentia CLI to the newest beta release';
+    static description = 'Update the globally installed Agentia CLI to the newest release for the selected channel';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --check',
+        '<%= config.bin %> <%= command.id %> --channel latest --check',
+        '<%= config.bin %> <%= command.id %> --channel rc',
         '<%= config.bin %> <%= command.id %> --check --json',
     ];
     static flags = {
+        channel: Flags.option({
+            description: 'npm dist-tag to check (rc or latest). Omit to auto-select: prerelease installs compare rc and latest; stable installs use latest only.',
+            options: ['rc', 'latest'],
+        })(),
         check: Flags.boolean({
             description: 'Check for an update without installing it',
         }),
     };
     async run() {
         const { flags } = await this.parse(Update);
+        const requestedChannel = flags.channel ?? 'auto';
         const result = await this.withSpinner(flags.check ? 'Checking for Agentia CLI updates' : 'Updating Agentia CLI', () => runCliUpdate({
+            channel: requestedChannel,
             checkOnly: flags.check,
             currentVersion: this.config.version,
         }));
@@ -24,7 +32,7 @@ export default class Update extends AgentiaCommand {
                 this.log(`Updated Agentia CLI from ${result.currentVersion} to ${result.latestVersion}. Re-run \`agentia --version\` to verify the new installation.`);
             }
             else if (result.updateAvailable) {
-                this.log(`Agentia CLI ${result.latestVersion} is available (current: ${result.currentVersion}). Run \`agentia update\` to install it.`);
+                this.log(`Agentia CLI ${result.latestVersion} is available on the ${result.channel} channel (current: ${result.currentVersion}). Run \`agentia update\` to install it.`);
             }
             else if (result.versionState === 'ahead') {
                 this.log(`Installed Agentia CLI ${result.currentVersion} is newer than the ${result.channel} channel release ${result.latestVersion}.`);

package/dist/lib/cli-version.js

@@ -2,16 +2,20 @@ import {modules} from './runtime.js';
 const AGENTIA_NPM_REGISTRY = modules["cli-version.js"]["AGENTIA_NPM_REGISTRY"]
 const AGENTIA_PACKAGE_NAME = modules["cli-version.js"]["AGENTIA_PACKAGE_NAME"]
 const AGENTIA_RELEASE_CHANNEL = modules["cli-version.js"]["AGENTIA_RELEASE_CHANNEL"]
+const AGENTIA_STABLE_CHANNEL = modules["cli-version.js"]["AGENTIA_STABLE_CHANNEL"]
 const CliVersionError = modules["cli-version.js"]["CliVersionError"]
 const VERSION_CACHE_FILENAME = modules["cli-version.js"]["VERSION_CACHE_FILENAME"]
+const VERSION_CACHE_SCHEMA_VERSION = modules["cli-version.js"]["VERSION_CACHE_SCHEMA_VERSION"]
 const VERSION_CHECK_INTERVAL_MS = modules["cli-version.js"]["VERSION_CHECK_INTERVAL_MS"]
 const defaultVersionRegistryClient = modules["cli-version.js"]["defaultVersionRegistryClient"]
-const fetchChannelVersion = modules["cli-version.js"]["fetchChannelVersion"]
+const fetchDistTags = modules["cli-version.js"]["fetchDistTags"]
 const isNewerVersion = modules["cli-version.js"]["isNewerVersion"]
+const isPrereleaseVersion = modules["cli-version.js"]["isPrereleaseVersion"]
 const isVersionCacheStale = modules["cli-version.js"]["isVersionCacheStale"]
 const readVersionCache = modules["cli-version.js"]["readVersionCache"]
 const refreshVersionCache = modules["cli-version.js"]["refreshVersionCache"]
+const resolveUpdateCandidate = modules["cli-version.js"]["resolveUpdateCandidate"]
 const setCliVersionRegistryClientForTests = modules["cli-version.js"]["setCliVersionRegistryClientForTests"]
 const versionCachePath = modules["cli-version.js"]["versionCachePath"]
 const writeVersionCache = modules["cli-version.js"]["writeVersionCache"]
-export {AGENTIA_NPM_REGISTRY, AGENTIA_PACKAGE_NAME, AGENTIA_RELEASE_CHANNEL, CliVersionError, VERSION_CACHE_FILENAME, VERSION_CHECK_INTERVAL_MS, defaultVersionRegistryClient, fetchChannelVersion, isNewerVersion, isVersionCacheStale, readVersionCache, refreshVersionCache, setCliVersionRegistryClientForTests, versionCachePath, writeVersionCache};
+export {AGENTIA_NPM_REGISTRY, AGENTIA_PACKAGE_NAME, AGENTIA_RELEASE_CHANNEL, AGENTIA_STABLE_CHANNEL, CliVersionError, VERSION_CACHE_FILENAME, VERSION_CACHE_SCHEMA_VERSION, VERSION_CHECK_INTERVAL_MS, defaultVersionRegistryClient, fetchDistTags, isNewerVersion, isPrereleaseVersion, isVersionCacheStale, readVersionCache, refreshVersionCache, resolveUpdateCandidate, setCliVersionRegistryClientForTests, versionCachePath, writeVersionCache};

package/dist/lib/headless-file-upload.js

@@ -0,0 +1,10 @@
+import {modules} from './runtime.js';
+const buildEnvironmentSyncLogsFileName = modules["headless-file-upload.js"]["buildEnvironmentSyncLogsFileName"]
+const buildLocalCommitLogsFileName = modules["headless-file-upload.js"]["buildLocalCommitLogsFileName"]
+const buildMultipartFileBody = modules["headless-file-upload.js"]["buildMultipartFileBody"]
+const formatFileNameDateTime = modules["headless-file-upload.js"]["formatFileNameDateTime"]
+const isMissingHeadlessFileUploadEndpoint = modules["headless-file-upload.js"]["isMissingHeadlessFileUploadEndpoint"]
+const uploadCapturedCommandLogs = modules["headless-file-upload.js"]["uploadCapturedCommandLogs"]
+const uploadCapturedPublishLogs = modules["headless-file-upload.js"]["uploadCapturedPublishLogs"]
+const uploadHeadlessFile = modules["headless-file-upload.js"]["uploadHeadlessFile"]
+export {buildEnvironmentSyncLogsFileName, buildLocalCommitLogsFileName, buildMultipartFileBody, formatFileNameDateTime, isMissingHeadlessFileUploadEndpoint, uploadCapturedCommandLogs, uploadCapturedPublishLogs, uploadHeadlessFile};

package/dist/lib/java-runtime.js

@@ -0,0 +1,6 @@
+import {modules} from './runtime.js';
+const MISSING_JAVA_MESSAGE = modules["java-runtime.js"]["MISSING_JAVA_MESSAGE"]
+const isMissingExecutableError = modules["java-runtime.js"]["isMissingExecutableError"]
+const resolveJavaCommand = modules["java-runtime.js"]["resolveJavaCommand"]
+const throwIfMissingJava = modules["java-runtime.js"]["throwIfMissingJava"]
+export {MISSING_JAVA_MESSAGE, isMissingExecutableError, resolveJavaCommand, throwIfMissingJava};

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

@@ -1,10 +1,10 @@
 import { z } from 'zod';
 import { assertRequired } from '../assert.js';
 import { CicdGateway } from '../cicd-gateway.js';
-import { attachCapturedOutputLogs, MCP_STDIO_CAPTURE_OPTIONS, withCapturedCommandOutput, } from '../command-output-buffer.js';
+import { MCP_STDIO_CAPTURE_OPTIONS, withCapturedCommandOutput, } from '../command-output-buffer.js';
 import { reconcileWorkSetCredential, sanitizeWorkSetUserStory } from '../credential-sync.js';
 import { readDefaults, resolveDefaults, writeLastWorkSelection, } from '../defaults-store.js';
-import { checkoutFeatureBranch, fetchOriginBranch, fetchOriginBranchIfExists, listPendingChanges, } from '../git-worktree.js';
+import { checkoutFeatureBranch, fetchOriginBranch, fetchOriginBranchIfExists, getHeadCommitId, listPendingChanges, } from '../git-worktree.js';
 import { listPaginationZodFields, mcpPaginatedListPayload } from '../list-pagination.js';
 import { LocalQualityGatesError, parseQualityGatesEnvAssignments, runLocalQualityGates, } from '../local-quality-gates.js';
 import { FULL_METADATA_SELECTION_TYPES_HELP } from '../nested-metadata-registry.js';
@@ -21,7 +21,7 @@ import { validateWorkMutationPayload, WORK_LONG_TEXT_MAX_LENGTH, WORK_SHORT_TEXT
 import { fetchWorkItem, fetchWorkItems } 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';
+import { capturingWorkPushHooks, performWorkPush, resolveActiveFeatureWorkItem, resolveWorkPushContext, resolveWorkPushNeed, uploadCapturedPublishLogsBestEffort, } from '../work-push.js';
 import { performWorkSetNone } from '../work-set-none.js';
 import { isWorkSetWarning, parseWorkSetSelection, toWorkSetWarningResult, writeWorkSetWarningSelection, } from '../work-set-selection.js';
 import { reportSubmitUserStoriesAheadBehind } from '../work-submit-ahead-behind.js';
@@ -276,6 +276,7 @@ async function promoteWorkItemDone(args = {}) {
             pushResult = await performWorkPush({
                 ...pushContext,
                 hooks: capturingWorkPushHooks,
+                skipLogUpload: true,
                 skipNestedMetadataDetection: args.skipNestedMetadataDetection,
             });
         }
@@ -293,6 +294,12 @@ async function promoteWorkItemDone(args = {}) {
             },
             method: 'POST',
         }));
+        const tipCommitId = pushResult?.commits.at(-1)?.id ?? (await getHeadCommitId());
+        await uploadCapturedPublishLogsBestEffort({
+            commitId: tipCommitId,
+            hooks: capturingWorkPushHooks,
+            linkedEntityId: await resolveWorkItemId(),
+        });
         return {
             branch,
             done,
@@ -343,6 +350,7 @@ async function workSubmit(args = {}) {
             pushResult = await performWorkPush({
                 ...pushContext,
                 hooks: capturingWorkPushHooks,
+                skipLogUpload: true,
                 skipNestedMetadataDetection: args.skipNestedMetadataDetection,
             });
         }
@@ -352,13 +360,19 @@ async function workSubmit(args = {}) {
             workItem,
         });
         const submit = await capturingWorkPushHooks.withSpinner('Submitting work item', () => CicdGateway.call({
-            body: attachCapturedOutputLogs({ workItem }),
+            body: { workItem },
             endpoint: workSubmitEndpoint(),
             headers: {
                 'Content-Type': 'application/json',
             },
             method: 'POST',
         }));
+        const tipCommitId = pushResult?.commits.at(-1)?.id ?? (await getHeadCommitId());
+        await uploadCapturedPublishLogsBestEffort({
+            commitId: tipCommitId,
+            hooks: capturingWorkPushHooks,
+            linkedEntityId: await resolveWorkItemId(),
+        });
         return {
             branch,
             push: pushResult,