@copado/agentia-cli 1.1.0 → 1.3.0

package/dist/commands/cicd/extension-configuration/list.js

@@ -0,0 +1,49 @@
+import { Flags } from '@oclif/core';
+import { CicdCommand } from '../../../lib/cicd-command.js';
+import { fetchExtensionConfigurations } from '../../../lib/extension-configuration-ops.js';
+import { formatExtensionConfigurationTable, } from '../../../lib/extension-configuration-types.js';
+import { displayListPagination, listPaginationFlags } from '../../../lib/list-pagination.js';
+export default class ExtensionConfigurationList extends CicdCommand {
+    static description = 'List Copado extension configurations';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --tool Selenium --active --json',
+    ];
+    static flags = {
+        ...listPaginationFlags,
+        active: Flags.boolean({
+            allowNo: true,
+            description: 'Filter by active status',
+        }),
+        name: Flags.string({
+            description: 'Filter by extension configuration name',
+        }),
+        'test-type': Flags.string({
+            description: 'Filter by test type',
+        }),
+        tool: Flags.string({
+            description: 'Filter by extension tool',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ExtensionConfigurationList);
+        const page = await this.withSpinner('Fetching extension configurations', () => fetchExtensionConfigurations({
+            active: flags.active,
+            cursor: flags.cursor,
+            name: flags.name,
+            pageSize: flags['page-size'],
+            testType: flags['test-type'],
+            tool: flags.tool,
+        }));
+        this.display(() => {
+            if (page.data.length === 0) {
+                this.log('No extension configurations found.');
+                return;
+            }
+            this.log(formatExtensionConfigurationTable(page.data));
+            displayListPagination(this.log.bind(this), page);
+        });
+        return page;
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/cicd/extension-configuration/open.js

@@ -0,0 +1,38 @@
+import { Args } from '@oclif/core';
+import { CicdCommand } from '../../../lib/cicd-command.js';
+import { openNavigationTarget } from '../../../lib/navigation-open.js';
+import { resolveNavigationTarget } from '../../../lib/navigation.js';
+import { assertSalesforceLifecycleId } from '../../../lib/pipeline-lifecycle-id.js';
+export default class ExtensionConfigurationOpen extends CicdCommand {
+    static args = {
+        id: Args.string({
+            description: 'Extension configuration Salesforce ID',
+            required: true,
+        }),
+    };
+    static description = 'Open a Copado extension configuration in the browser';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> <configuration-id>',
+        '<%= config.bin %> <%= command.id %> <configuration-id> --json',
+    ];
+    async run() {
+        const { args } = await this.parse(ExtensionConfigurationOpen);
+        let configurationId;
+        try {
+            configurationId = assertSalesforceLifecycleId(args.id, 'Extension configuration ID');
+        }
+        catch (error) {
+            this.error(error instanceof Error ? error.message : String(error), { exit: 2 });
+        }
+        const target = await this.withSpinner('Resolving navigation URL', () => resolveNavigationTarget({
+            id: configurationId,
+            resourceType: 'extension_configuration',
+        }));
+        await openNavigationTarget(target, {
+            jsonEnabled: this.jsonEnabled(),
+            log: this.log.bind(this),
+        });
+        return target;
+    }
+}
+//# sourceMappingURL=open.js.map

package/dist/commands/cicd/function/defaults.js

@@ -1,8 +1,8 @@
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { CicdGateway } from '../../../lib/cicd-gateway.js';
 import { buildFunctionDefaultsPayload, functionDefaultsFlags } from '../../../lib/function-flags.js';
 import { formatFunctionDetail, functionsEndpoint, normalizeFunction, } from '../../../lib/function-types.js';
-export default class FunctionDefaults extends AgentiaCommand {
+export default class FunctionDefaults extends CicdCommand {
     static description = 'Scaffold default Copado Function metadata and script without writing to Salesforce';
     static examples = [
         '<%= config.bin %> <%= command.id %> --name MyFunction',

package/dist/commands/cicd/function/delete.js

@@ -1,8 +1,8 @@
 import { Args } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { CicdGateway } from '../../../lib/cicd-gateway.js';
 import { functionEndpoint } from '../../../lib/function-types.js';
-export default class FunctionDelete extends AgentiaCommand {
+export default class FunctionDelete extends CicdCommand {
     static args = {
         'api-name': Args.string({
             description: 'Function API name',

package/dist/commands/cicd/function/get.js

@@ -1,8 +1,8 @@
 import { Args } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { CicdGateway } from '../../../lib/cicd-gateway.js';
 import { formatFunctionDetail, functionEndpoint, normalizeFunction, } from '../../../lib/function-types.js';
-export default class FunctionGet extends AgentiaCommand {
+export default class FunctionGet extends CicdCommand {
     static args = {
         'api-name': Args.string({
             description: 'Function API name',

package/dist/commands/cicd/function/list.js

@@ -1,9 +1,9 @@
 import { Flags } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { CicdGateway } from '../../../lib/cicd-gateway.js';
 import { formatFunctionTable, FUNCTION_LIST_TYPES, functionsEndpoint, normalizeFunctionsListPage, } from '../../../lib/function-types.js';
 import { buildListPaginationQuery, displayListPagination, listPaginationFlags, } from '../../../lib/list-pagination.js';
-export default class FunctionList extends AgentiaCommand {
+export default class FunctionList extends CicdCommand {
     static description = 'List Copado Functions';
     static examples = [
         '<%= config.bin %> <%= command.id %>',

package/dist/commands/cicd/function/open.js

@@ -1,8 +1,8 @@
 import { Args } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { openNavigationTarget } from '../../../lib/navigation-open.js';
 import { resolveNavigationTarget } from '../../../lib/navigation.js';
-export default class FunctionOpen extends AgentiaCommand {
+export default class FunctionOpen extends CicdCommand {
     static args = {
         id: Args.string({
             description: 'Function ID',

package/dist/commands/cicd/function/result/get.js

@@ -1,8 +1,8 @@
 import { Args } from '@oclif/core';
-import { AgentiaCommand } from '../../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../../lib/cicd-command.js';
 import { CicdGateway } from '../../../../lib/cicd-gateway.js';
 import { formatFunctionResultStatus, functionResultEndpoint, normalizeFunctionResultStatus, } from '../../../../lib/function-types.js';
-export default class FunctionResultGet extends AgentiaCommand {
+export default class FunctionResultGet extends CicdCommand {
     static args = {
         'result-id': Args.string({
             description: 'Function result Id',

package/dist/commands/cicd/function/result/log/get.js

@@ -1,8 +1,8 @@
 import { Args, Flags } from '@oclif/core';
-import { AgentiaCommand } from '../../../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../../../lib/cicd-command.js';
 import { CicdGateway } from '../../../../../lib/cicd-gateway.js';
 import { functionResultLogEndpoint } from '../../../../../lib/function-types.js';
-export default class FunctionResultLogGet extends AgentiaCommand {
+export default class FunctionResultLogGet extends CicdCommand {
     static args = {
         'result-id': Args.string({
             description: 'Function result Id',

package/dist/commands/cicd/function/run-local.js

@@ -1,8 +1,8 @@
 import { Args, Flags } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { DEFAULT_FUNCTION_LOCAL_IMAGE, executeLocalFunctionRun, formatLocalFunctionRunResult, } from '../../../lib/function-local-run.js';
 import { FUNCTION_RUNTIMES } from '../../../lib/function-types.js';
-export default class FunctionRunLocal extends AgentiaCommand {
+export default class FunctionRunLocal extends CicdCommand {
     static args = {
         script: Args.string({
             description: 'Path to the local function script (.sh, .js, or .py)',

package/dist/commands/cicd/function/run.js

@@ -1,9 +1,9 @@
 import { Args } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { CicdGateway } from '../../../lib/cicd-gateway.js';
 import { buildFunctionRunPayload, functionRunFlags } from '../../../lib/function-flags.js';
 import { formatFunctionRunResult, functionRunEndpoint, normalizeFunctionRunResult, } from '../../../lib/function-types.js';
-export default class FunctionRun extends AgentiaCommand {
+export default class FunctionRun extends CicdCommand {
     static args = {
         'api-name': Args.string({
             description: 'Function API name',

package/dist/commands/cicd/function/upsert.js

@@ -1,9 +1,9 @@
 import { Args } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { CicdGateway } from '../../../lib/cicd-gateway.js';
 import { buildFunctionUpsertPayload, functionUpsertFlags } from '../../../lib/function-flags.js';
 import { formatFunctionDetail, functionEndpoint, normalizeFunction, } from '../../../lib/function-types.js';
-export default class FunctionUpsert extends AgentiaCommand {
+export default class FunctionUpsert extends CicdCommand {
     static args = {
         'api-name': Args.string({
             description: 'Function API name',

package/dist/commands/cicd/health-check.js

@@ -1,5 +1,5 @@
 import { Flags, ux } from '@oclif/core';
-import { AgentiaCommand } from '../../lib/agentia-command.js';
+import { CicdCommand } from '../../lib/cicd-command.js';
 import { table } from '../../lib/format.js';
 import { analyzeGitRepository, gitSizerRows } from '../../lib/git-sizer.js';
 import { runOrganizationHealthChecks, } from '../../lib/health-check.js';
@@ -20,7 +20,7 @@ function displayStatus(status) {
         }
     }
 }
-export default class HealthCheck extends AgentiaCommand {
+export default class HealthCheck extends CicdCommand {
     static description = 'Run organization-scoped governance health checks';
     static examples = [
         '<%= config.bin %> <%= command.id %>',

package/dist/commands/cicd/job/get.js

@@ -1,8 +1,8 @@
 import { Args } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { fetchJob } from '../../../lib/job-get.js';
 import { formatJobDetail } from '../../../lib/job-types.js';
-export default class JobGet extends AgentiaCommand {
+export default class JobGet extends CicdCommand {
     static args = {
         id: Args.string({
             description: 'JobExecution Id',

package/dist/commands/cicd/job/kill.js

@@ -1,8 +1,8 @@
 import { Args } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { CicdGateway } from '../../../lib/cicd-gateway.js';
 import { formatJobOperationResult, jobKillEndpoint, normalizeJobOperation, } from '../../../lib/job-types.js';
-export default class JobKill extends AgentiaCommand {
+export default class JobKill extends CicdCommand {
     static args = {
         id: Args.string({
             description: 'JobExecution Id',

package/dist/commands/cicd/job/list.js

@@ -1,10 +1,10 @@
 import { Flags } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { fetchJobs } from '../../../lib/job-get.js';
 import { formatJobTable } from '../../../lib/job-types.js';
 import { buildListPaginationQuery, displayListPagination, listPaginationFlags, } from '../../../lib/list-pagination.js';
 import { getUserContext } from '../../../lib/user-context.js';
-export default class JobList extends AgentiaCommand {
+export default class JobList extends CicdCommand {
     static description = 'List Copado job executions';
     static examples = [
         '<%= config.bin %> <%= command.id %>',

package/dist/commands/cicd/job/log/get.js

@@ -1,8 +1,8 @@
 import { Args, Flags } from '@oclif/core';
-import { AgentiaCommand } from '../../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../../lib/cicd-command.js';
 import { CicdGateway } from '../../../../lib/cicd-gateway.js';
 import { jobEndpoint, jobResultLogEndpoint, normalizeJob, resolveJobStepForLog, } from '../../../../lib/job-types.js';
-export default class JobLogGet extends AgentiaCommand {
+export default class JobLogGet extends CicdCommand {
     static args = {
         id: Args.string({
             description: 'JobExecution Id',

package/dist/commands/cicd/job/open.js

@@ -1,8 +1,8 @@
 import { Args } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { openNavigationTarget } from '../../../lib/navigation-open.js';
 import { resolveNavigationTarget } from '../../../lib/navigation.js';
-export default class JobOpen extends AgentiaCommand {
+export default class JobOpen extends CicdCommand {
     static args = {
         id: Args.string({
             description: 'JobExecution ID',

package/dist/commands/cicd/job/pause.js

@@ -1,8 +1,8 @@
 import { Args } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { CicdGateway } from '../../../lib/cicd-gateway.js';
 import { formatJobOperationResult, jobPauseEndpoint, normalizeJobOperation, } from '../../../lib/job-types.js';
-export default class JobPause extends AgentiaCommand {
+export default class JobPause extends CicdCommand {
     static args = {
         id: Args.string({
             description: 'JobExecution Id',

package/dist/commands/cicd/job/result-file/get.js

@@ -1,9 +1,9 @@
 import { Args, Flags } from '@oclif/core';
 import { writeFileSync } from 'node:fs';
-import { AgentiaCommand } from '../../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../../lib/cicd-command.js';
 import { CicdGateway } from '../../../../lib/cicd-gateway.js';
 import { decodeJobResultFileBase64, jobResultFileContentEndpoint, normalizeJobResultFileContent, } from '../../../../lib/job-types.js';
-export default class JobResultFileGet extends AgentiaCommand {
+export default class JobResultFileGet extends CicdCommand {
     static args = {
         resultId: Args.string({
             description: 'Copado Result Id',

package/dist/commands/cicd/job/result-file/list.js

@@ -1,8 +1,8 @@
 import { Args } from '@oclif/core';
-import { AgentiaCommand } from '../../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../../lib/cicd-command.js';
 import { CicdGateway } from '../../../../lib/cicd-gateway.js';
 import { formatJobResultFileTable, jobResultFilesEndpoint, normalizeJobResultFiles, } from '../../../../lib/job-types.js';
-export default class JobResultFileList extends AgentiaCommand {
+export default class JobResultFileList extends CicdCommand {
     static args = {
         resultId: Args.string({
             description: 'Copado Result Id',

package/dist/commands/cicd/job/resume.js

@@ -1,8 +1,8 @@
 import { Args } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { CicdGateway } from '../../../lib/cicd-gateway.js';
 import { formatJobOperationResult, jobResumeEndpoint, normalizeJobOperation, } from '../../../lib/job-types.js';
-export default class JobResume extends AgentiaCommand {
+export default class JobResume extends CicdCommand {
     static args = {
         id: Args.string({
             description: 'JobExecution Id',

package/dist/commands/cicd/job/run.js

@@ -1,8 +1,8 @@
 import { Args, Flags } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { CicdGateway } from '../../../lib/cicd-gateway.js';
 import { formatJobOperationResult, jobRunEndpoint, normalizeJobOperation, } from '../../../lib/job-types.js';
-export default class JobRun extends AgentiaCommand {
+export default class JobRun extends CicdCommand {
     static args = {
         id: Args.string({
             description: 'JobExecution Id',

package/dist/commands/cicd/metadata/content/compare.js

@@ -1,5 +1,5 @@
 import { Flags } from '@oclif/core';
-import { AgentiaCommand } from '../../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../../lib/cicd-command.js';
 import { CicdGateway } from '../../../../lib/cicd-gateway.js';
 import { assertRequired, CONTENT_SOURCES, contentResultToCompareSide, createUnifiedDiff, sourceSideLabel, } from '../../../../lib/metadata-common.js';
 export function buildMetadataCompareFileRequests(flags) {
@@ -33,7 +33,7 @@ export function buildMetadataCompareFileRequests(flags) {
     }
     return { sourceRequest, targetRequest };
 }
-export default class MetadataCompareFile extends AgentiaCommand {
+export default class MetadataCompareFile extends CicdCommand {
     static description = 'Compare metadata file content between two orgs or Git branches';
     static examples = [
         '<%= config.bin %> <%= command.id %> --metadata-type ApexClass --api-name MyClass --pipeline-id <id> --source-org-id <id> --source-credential-id <id> --target-org-id <id>',

package/dist/commands/cicd/metadata/content/get.js

@@ -1,6 +1,6 @@
 import { Flags } from '@oclif/core';
 import { readFileSync, writeFileSync } from 'node:fs';
-import { AgentiaCommand } from '../../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../../lib/cicd-command.js';
 import { CicdGateway } from '../../../../lib/cicd-gateway.js';
 import { assertRequired, CONTENT_SOURCES, decodeBase64, formatContentTable, normalizeContentRows, } from '../../../../lib/metadata-common.js';
 const FILE_EXCLUSIVE_FLAGS = [
@@ -58,8 +58,8 @@ export function buildMetadataContentRequests(flags) {
     }
     return [buildMetadataContentRequest(flags)];
 }
-export default class MetadataContent extends AgentiaCommand {
-    static description = 'Retrieve metadata file content via the CICD gateway';
+export default class MetadataContent extends CicdCommand {
+    static description = 'Retrieve metadata file content';
     static examples = [
         '<%= config.bin %> <%= command.id %> --metadata-type ApexClass --api-name MyClass --pipeline-id <id> --source-org-id <id>',
         '<%= config.bin %> <%= command.id %> --metadata-type ApexClass --api-name MyClass --show',

package/dist/commands/cicd/metadata/dependency/list.js

@@ -1,9 +1,10 @@
 import { Flags } from '@oclif/core';
 import { readFileSync } from 'node:fs';
-import { AgentiaCommand } from '../../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../../lib/cicd-command.js';
 import { assertRequired } from '../../../../lib/assert.js';
 import { CicdGateway } from '../../../../lib/cicd-gateway.js';
-import { resolvedSelectionsFromChangedFiles } from '../../../../lib/dependency-from-changes.js';
+import { resolvedSelectionsFromChangedFiles, resolvedSelectionsFromPaths, } from '../../../../lib/dependency-from-changes.js';
+import { resolveDependencySourceContext } from '../../../../lib/dependency-source-context.js';
 import { findLocalMetadataPaths } from '../../../../lib/local-metadata-paths.js';
 import { formatDependencyTable, MODULE_TYPES, normalizeDependencyItem, normalizeDependencySelection, parseJsonValue, PLATFORM_EXPERIENCES, RETRIEVE_MODES, } from '../../../../lib/metadata-common.js';
 function readStdin() {
@@ -75,17 +76,24 @@ function metadataSelectionFromFlags(flags) {
     }
     return normalizeDependencySelection(selection);
 }
-function requestFromSelections(flags, selections) {
+async function requestFromSelections(flags, selections) {
+    const sourceContext = await resolveDependencySourceContext({
+        pipelineId: flags['pipeline-id'],
+        platformExperience: flags['platform-experience'],
+        sourceCredentialId: flags['source-credential-id'],
+        sourceOrgId: flags['source-org-id'],
+        targetOrgId: flags['target-org-id'],
+    });
     const body = {
         compareOptions: {
-            sourceCredentialId: assertRequired(flags['source-credential-id'], '--source-credential-id'),
-            sourceOrgId: assertRequired(flags['source-org-id'], '--source-org-id'),
+            sourceCredentialId: sourceContext.sourceCredentialId,
+            sourceOrgId: sourceContext.sourceOrgId,
         },
         metadataSelections: selections.map((selection) => normalizeDependencySelection(selection)),
-        pipelineId: assertRequired(flags['pipeline-id'], '--pipeline-id'),
+        pipelineId: sourceContext.pipelineId,
     };
-    if (flags['target-org-id']) {
-        body.compareOptions.targetOrgId = flags['target-org-id'];
+    if (sourceContext.targetOrgId) {
+        body.compareOptions.targetOrgId = sourceContext.targetOrgId;
     }
     if (flags['retrieve-mode']) {
         body.compareOptions.retrieveMode = flags['retrieve-mode'];
@@ -98,13 +106,18 @@ function requestFromSelections(flags, selections) {
     }
     return {
         body,
-        platformExperience: assertRequired(flags['platform-experience'], '--platform-experience'),
+        platformExperience: sourceContext.platformExperience,
     };
 }
 export async function buildDependencyRequest(flags) {
-    const inputModes = [Boolean(flags.file), flags.stdin, flags['from-changes']].filter(Boolean).length;
+    const inputModes = [
+        Boolean(flags.file),
+        flags.stdin,
+        flags['from-changes'],
+        Boolean(flags.path?.length),
+    ].filter(Boolean).length;
     if (inputModes > 1) {
-        throw new Error('Use only one input mode: --file, --stdin, or --from-changes.');
+        throw new Error('Use only one input mode: --file, --stdin, --from-changes, or --path.');
     }
     if (flags.file) {
         return dependencyRequestFromJson(readFileSync(flags.file, 'utf8'));
@@ -114,16 +127,22 @@ export async function buildDependencyRequest(flags) {
     }
     if (flags['from-changes']) {
         const resolvedSelections = await resolvedSelectionsFromChangedFiles(flags['base-ref'], flags['module-type']);
-        const request = requestFromSelections(flags, resolvedSelections.map(({ selection }) => selection));
+        const request = await requestFromSelections(flags, resolvedSelections.map(({ selection }) => selection));
+        request.localPathsBySelection = new Map(resolvedSelections.map(({ localPaths, selection }) => [`${selection.type}:${selection.name}`, localPaths]));
+        return request;
+    }
+    if (flags.path?.length) {
+        const resolvedSelections = resolvedSelectionsFromPaths(flags.path, flags['module-type']);
+        const request = await requestFromSelections(flags, resolvedSelections.map(({ selection }) => selection));
         request.localPathsBySelection = new Map(resolvedSelections.map(({ localPaths, selection }) => [`${selection.type}:${selection.name}`, localPaths]));
         return request;
     }
     if (!flags['metadata-name'] || !flags['metadata-type']) {
-        throw new Error('Requires `--metadata-name` and `--metadata-type`, or an input mode such as --file, --stdin, or --from-changes.');
+        throw new Error('Requires `--metadata-name` and `--metadata-type`, or an input mode such as --file, --stdin, --from-changes, or --path.');
     }
     return requestFromSelections(flags, [metadataSelectionFromFlags(flags)]);
 }
-async function enrichDependencyResult(result, localPathsBySelection, moduleType) {
+export async function enrichDependencyResult(result, localPathsBySelection, moduleType) {
     if (!Array.isArray(result.dependencies)) {
         return result;
     }
@@ -198,12 +217,13 @@ async function enrichDependencyResult(result, localPathsBySelection, moduleType)
         }),
     };
 }
-export default class DependencyGet extends AgentiaCommand {
-    static description = 'Retrieve metadata dependencies via the CICD gateway';
+export default class DependencyGet extends CicdCommand {
+    static description = 'Retrieve metadata dependencies';
     static examples = [
         '<%= config.bin %> <%= command.id %> --metadata-name MyClass --metadata-type ApexClass --pipeline-id <id> --source-org-id <id> --source-credential-id <id>',
         'cat request.json | <%= config.bin %> <%= command.id %> --stdin',
         '<%= config.bin %> <%= command.id %> --from-changes --base-ref origin/main --retrieve-mode all --pipeline-id <id> --source-org-id <id> --source-credential-id <id>',
+        '<%= config.bin %> <%= command.id %> --path force-app/main/default/classes/MyClass.cls --pipeline-id <id> --source-credential-id <id> --source-org-id <id> --target-org-id <id> --platform-experience sfdx --retrieve-mode all --json',
     ];
     static flags = {
         'base-ref': Flags.string({
@@ -234,12 +254,15 @@ export default class DependencyGet extends AgentiaCommand {
             description: 'Optional addon module type',
             options: [...MODULE_TYPES],
         }),
+        path: Flags.string({
+            description: 'Local Salesforce source file path to resolve into a metadata selection. Repeatable. Mutually exclusive with --file, --stdin, and --from-changes.',
+            multiple: true,
+        }),
         'pipeline-id': Flags.string({
-            description: 'Pipeline Id',
+            description: 'Pipeline Id. Defaults to the active work item pipelineId, or the pipeline on the project default.',
         }),
         'platform-experience': Flags.string({
-            default: 'salesforce',
-            description: 'Gateway platform experience header',
+            description: 'Platform experience header. Defaults to the active work item platform, then sfdx.',
             options: [...PLATFORM_EXPERIENCES],
         }),
         'result-id': Flags.string({
@@ -250,17 +273,17 @@ export default class DependencyGet extends AgentiaCommand {
             options: [...RETRIEVE_MODES],
         }),
         'source-credential-id': Flags.string({
-            description: 'Source org credential Id',
+            description: 'Source org credential Id. Defaults to the active work item source credential, or the project default credential.',
         }),
         'source-org-id': Flags.string({
-            description: 'Source org Id',
+            description: 'Source org Id. Defaults to the active work item sourceOrgId, or orgId from the resolved source credential/environment.',
         }),
         stdin: Flags.boolean({
             default: false,
             description: 'Read a JSON dependency request body from stdin',
         }),
         'target-org-id': Flags.string({
-            description: 'Target org Id',
+            description: 'Target org Id. Not inferred from work item or project defaults.',
         }),
     };
     async run() {

package/dist/commands/cicd/metadata/explore.js

@@ -0,0 +1,81 @@
+import { Flags } from '@oclif/core';
+import { CicdCommand } from '../../../lib/cicd-command.js';
+import { AI_METADATA_ACTIONS, buildAiMetadataToolRequest, callAiMetadataTool, } from '../../../lib/metadata-explore.js';
+export default class MetadataExplore extends CicdCommand {
+    static description = [
+        'Explore Salesforce metadata through Org Intelligence.',
+        'Uses the project default credential when --credential-id is omitted;',
+        'otherwise pass --credential-id, or both --session-id and --endpoint.',
+    ].join(' ');
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --action list --object-type ApexClass',
+        "<%= config.bin %> <%= command.id %> --action list --object-type ApexClass --pattern 'Account*'",
+        '<%= config.bin %> <%= command.id %> --action read --object-type ApexClass --full-name MyClass',
+        '<%= config.bin %> <%= command.id %> --action find_references --object-type ApexClass --full-name MyClass',
+        "<%= config.bin %> <%= command.id %> --action search --pattern 'Cont*' --credential-id <id>",
+        '<%= config.bin %> <%= command.id %> --action describe_type --object-type CustomObject --json',
+    ];
+    static experimental = true;
+    static flags = {
+        action: Flags.string({
+            description: 'Metadata action: list, search, read_documentation, describe_type, read, find_references, run_apex_tests',
+            options: [...AI_METADATA_ACTIONS],
+            required: true,
+        }),
+        'apex-unit-tests': Flags.string({
+            description: 'Comma-separated Apex test classes. Required for run_apex_tests.',
+        }),
+        // Deferred write/deploy flags (re-add with matching AI_METADATA_ACTIONS when shipping mutate):
+        // 'async-id': Flags.string({
+        //   description: 'Deployment Id from a previous validate/deploy for deploy_validated or check_async_id',
+        // }),
+        'credential-id': Flags.string({
+            description: 'Copado credential Id for the target org. Defaults to the CICD project default credential when set.',
+        }),
+        endpoint: Flags.string({
+            description: 'Salesforce instance URL (with --session-id) when not using a credential. Exclusive with --credential-id.',
+        }),
+        'full-name': Flags.string({
+            description: 'Fully qualified metadata name (required for read; list results emit this as fullName)',
+        }),
+        // 'metadata-files': Flags.string({
+        //   description:
+        //     'YAML/XML Metadata API files for validate (with --full-name). Each file starts with ~~~~~~~~~~ <pathname> <type> <name> ~~~~~~~~~',
+        // }),
+        'object-type': Flags.string({
+            description: 'Metadata type, for example ApexClass, CustomObject, or Flow',
+        }),
+        // 'organization-name': Flags.string({
+        //   description: 'Optional label for logging; not used to select the target org',
+        // }),
+        pattern: Flags.string({
+            default: '*',
+            description: 'Wildcard pattern for list/search (name without namespace), for example Account* or *Info',
+        }),
+        'session-id': Flags.string({
+            description: 'Salesforce session Id (with --endpoint) when not using a credential. Exclusive with --credential-id.',
+        }),
+        // 'test-level': Flags.string({
+        //   description:
+        //     'Salesforce test level for validate/deploy (NoTestRun, RunSpecifiedTests, RunLocalTests). Defaults from --apex-unit-tests when omitted.',
+        // }),
+        // 'validate-only': Flags.boolean({
+        //   default: false,
+        //   description: 'When true, write-style actions validate without deploying',
+        // }),
+    };
+    async run() {
+        const { flags } = await this.parse(MetadataExplore);
+        const body = await buildAiMetadataToolRequest(flags);
+        const output = await this.withSpinner('Running AI metadata tool', () => callAiMetadataTool(body));
+        const result = {
+            output,
+            ...(body.credentialId === undefined ? {} : { credentialId: body.credentialId }),
+        };
+        this.display(() => {
+            process.stdout.write(output.endsWith('\n') ? output : `${output}\n`);
+        });
+        return result;
+    }
+}
+//# sourceMappingURL=explore.js.map