@copado/agentia-cli 1.0.0-rc.0 → 1.1.0

package/dist/lib/extension/create.js

@@ -0,0 +1,3 @@
+import {modules} from '../runtime.js';
+const createExtension = modules["extension/create.js"]["createExtension"]
+export {createExtension};

package/dist/lib/extension/git.js

@@ -0,0 +1,17 @@
+import {modules} from '../runtime.js';
+const assertSafeGitRemote = modules["extension/git.js"]["assertSafeGitRemote"]
+const cloneExtensionRepo = modules["extension/git.js"]["cloneExtensionRepo"]
+const createAnnotatedTag = modules["extension/git.js"]["createAnnotatedTag"]
+const deleteLocalTag = modules["extension/git.js"]["deleteLocalTag"]
+const extensionGit = modules["extension/git.js"]["extensionGit"]
+const formatGitError = modules["extension/git.js"]["formatGitError"]
+const getCurrentBranchName = modules["extension/git.js"]["getCurrentBranchName"]
+const getHeadSha = modules["extension/git.js"]["getHeadSha"]
+const isWorkingTreeClean = modules["extension/git.js"]["isWorkingTreeClean"]
+const localTagExists = modules["extension/git.js"]["localTagExists"]
+const pushBranchAndTag = modules["extension/git.js"]["pushBranchAndTag"]
+const remoteTagExists = modules["extension/git.js"]["remoteTagExists"]
+const resetExtensionGitExecForTests = modules["extension/git.js"]["resetExtensionGitExecForTests"]
+const resolveLatestSemverTag = modules["extension/git.js"]["resolveLatestSemverTag"]
+const setExtensionGitExecForTests = modules["extension/git.js"]["setExtensionGitExecForTests"]
+export {assertSafeGitRemote, cloneExtensionRepo, createAnnotatedTag, deleteLocalTag, extensionGit, formatGitError, getCurrentBranchName, getHeadSha, isWorkingTreeClean, localTagExists, pushBranchAndTag, remoteTagExists, resetExtensionGitExecForTests, resolveLatestSemverTag, setExtensionGitExecForTests};

package/dist/lib/extension/index.js

@@ -0,0 +1,27 @@
+import {modules} from '../runtime.js';
+const EXTENSION_MANIFEST_RELATIVE_PATH = modules["extension/index.js"]["EXTENSION_MANIFEST_RELATIVE_PATH"]
+const assertSafeGitUrl = modules["extension/index.js"]["assertSafeGitUrl"]
+const assertValidExtensionName = modules["extension/index.js"]["assertValidExtensionName"]
+const assertValidSemver = modules["extension/index.js"]["assertValidSemver"]
+const cloneExtensionRepo = modules["extension/index.js"]["cloneExtensionRepo"]
+const createExtension = modules["extension/index.js"]["createExtension"]
+const deployExtensionSalesforceSource = modules["extension/index.js"]["deployExtensionSalesforceSource"]
+const extensionGit = modules["extension/index.js"]["extensionGit"]
+const installExtension = modules["extension/index.js"]["installExtension"]
+const loadFunctionUpsertPayload = modules["extension/index.js"]["loadFunctionUpsertPayload"]
+const loadTemplateUpsertPayload = modules["extension/index.js"]["loadTemplateUpsertPayload"]
+const materializeExtensionSource = modules["extension/index.js"]["materializeExtensionSource"]
+const packageExtension = modules["extension/index.js"]["packageExtension"]
+const parseExtensionManifest = modules["extension/index.js"]["parseExtensionManifest"]
+const publishExtension = modules["extension/index.js"]["publishExtension"]
+const readExtensionManifest = modules["extension/index.js"]["readExtensionManifest"]
+const resetExtensionGitExecForTests = modules["extension/index.js"]["resetExtensionGitExecForTests"]
+const resetExtensionSfDeployExecForTests = modules["extension/index.js"]["resetExtensionSfDeployExecForTests"]
+const resolveLocalExtensionPath = modules["extension/index.js"]["resolveLocalExtensionPath"]
+const setExtensionGitExecForTests = modules["extension/index.js"]["setExtensionGitExecForTests"]
+const setExtensionSfDeployExecForTests = modules["extension/index.js"]["setExtensionSfDeployExecForTests"]
+const uninstallExtension = modules["extension/index.js"]["uninstallExtension"]
+const validateExtension = modules["extension/index.js"]["validateExtension"]
+const versionTagName = modules["extension/index.js"]["versionTagName"]
+const writeExtensionManifest = modules["extension/index.js"]["writeExtensionManifest"]
+export {EXTENSION_MANIFEST_RELATIVE_PATH, assertSafeGitUrl, assertValidExtensionName, assertValidSemver, cloneExtensionRepo, createExtension, deployExtensionSalesforceSource, extensionGit, installExtension, loadFunctionUpsertPayload, loadTemplateUpsertPayload, materializeExtensionSource, packageExtension, parseExtensionManifest, publishExtension, readExtensionManifest, resetExtensionGitExecForTests, resetExtensionSfDeployExecForTests, resolveLocalExtensionPath, setExtensionGitExecForTests, setExtensionSfDeployExecForTests, uninstallExtension, validateExtension, versionTagName, writeExtensionManifest};

package/dist/lib/extension/install.js

@@ -0,0 +1,4 @@
+import {modules} from '../runtime.js';
+const assertSafeGitUrl = modules["extension/install.js"]["assertSafeGitUrl"]
+const installExtension = modules["extension/install.js"]["installExtension"]
+export {assertSafeGitUrl, installExtension};

package/dist/lib/extension/manifest.js

@@ -0,0 +1,21 @@
+import {modules} from '../runtime.js';
+const DEFAULT_SALESFORCE_SOURCE_DIR = modules["extension/manifest.js"]["DEFAULT_SALESFORCE_SOURCE_DIR"]
+const EXTENSION_FUNCTIONS_DIR = modules["extension/manifest.js"]["EXTENSION_FUNCTIONS_DIR"]
+const EXTENSION_MANIFEST_RELATIVE_PATH = modules["extension/manifest.js"]["EXTENSION_MANIFEST_RELATIVE_PATH"]
+const EXTENSION_NAME_REGEX = modules["extension/manifest.js"]["EXTENSION_NAME_REGEX"]
+const EXTENSION_TEMPLATES_DIR = modules["extension/manifest.js"]["EXTENSION_TEMPLATES_DIR"]
+const SEMVER_REGEX = modules["extension/manifest.js"]["SEMVER_REGEX"]
+const assertValidExtensionName = modules["extension/manifest.js"]["assertValidExtensionName"]
+const assertValidSemver = modules["extension/manifest.js"]["assertValidSemver"]
+const extensionManifestPath = modules["extension/manifest.js"]["extensionManifestPath"]
+const metadataJsonPath = modules["extension/manifest.js"]["metadataJsonPath"]
+const parseExtensionManifest = modules["extension/manifest.js"]["parseExtensionManifest"]
+const parseVersionFromRef = modules["extension/manifest.js"]["parseVersionFromRef"]
+const pathExists = modules["extension/manifest.js"]["pathExists"]
+const readExtensionManifest = modules["extension/manifest.js"]["readExtensionManifest"]
+const resolveSalesforceSourceDir = modules["extension/manifest.js"]["resolveSalesforceSourceDir"]
+const scanExtensionAssets = modules["extension/manifest.js"]["scanExtensionAssets"]
+const validateExtension = modules["extension/manifest.js"]["validateExtension"]
+const versionTagName = modules["extension/manifest.js"]["versionTagName"]
+const writeExtensionManifest = modules["extension/manifest.js"]["writeExtensionManifest"]
+export {DEFAULT_SALESFORCE_SOURCE_DIR, EXTENSION_FUNCTIONS_DIR, EXTENSION_MANIFEST_RELATIVE_PATH, EXTENSION_NAME_REGEX, EXTENSION_TEMPLATES_DIR, SEMVER_REGEX, assertValidExtensionName, assertValidSemver, extensionManifestPath, metadataJsonPath, parseExtensionManifest, parseVersionFromRef, pathExists, readExtensionManifest, resolveSalesforceSourceDir, scanExtensionAssets, validateExtension, versionTagName, writeExtensionManifest};

package/dist/lib/extension/package.js

@@ -0,0 +1,3 @@
+import {modules} from '../runtime.js';
+const packageExtension = modules["extension/package.js"]["packageExtension"]
+export {packageExtension};

package/dist/lib/extension/paths.js

@@ -0,0 +1,5 @@
+import {modules} from '../runtime.js';
+const assertPathInsideRoot = modules["extension/paths.js"]["assertPathInsideRoot"]
+const assertSafeExtensionFile = modules["extension/paths.js"]["assertSafeExtensionFile"]
+const assertSafeExtensionTree = modules["extension/paths.js"]["assertSafeExtensionTree"]
+export {assertPathInsideRoot, assertSafeExtensionFile, assertSafeExtensionTree};

package/dist/lib/extension/publish.js

@@ -0,0 +1,3 @@
+import {modules} from '../runtime.js';
+const publishExtension = modules["extension/publish.js"]["publishExtension"]
+export {publishExtension};

package/dist/lib/extension/sf-deploy.js

@@ -0,0 +1,8 @@
+import {modules} from '../runtime.js';
+const assertSafeSfAlias = modules["extension/sf-deploy.js"]["assertSafeSfAlias"]
+const deployExtensionSalesforceSource = modules["extension/sf-deploy.js"]["deployExtensionSalesforceSource"]
+const extensionSourceDeployArgs = modules["extension/sf-deploy.js"]["extensionSourceDeployArgs"]
+const resetExtensionSfDeployExecForTests = modules["extension/sf-deploy.js"]["resetExtensionSfDeployExecForTests"]
+const sanitizeDeployOutput = modules["extension/sf-deploy.js"]["sanitizeDeployOutput"]
+const setExtensionSfDeployExecForTests = modules["extension/sf-deploy.js"]["setExtensionSfDeployExecForTests"]
+export {assertSafeSfAlias, deployExtensionSalesforceSource, extensionSourceDeployArgs, resetExtensionSfDeployExecForTests, sanitizeDeployOutput, setExtensionSfDeployExecForTests};

package/dist/lib/extension/source.js

@@ -0,0 +1,7 @@
+import {modules} from '../runtime.js';
+const assertSafeGitUrl = modules["extension/source.js"]["assertSafeGitUrl"]
+const localPathAsFileUrl = modules["extension/source.js"]["localPathAsFileUrl"]
+const materializeExtensionSource = modules["extension/source.js"]["materializeExtensionSource"]
+const normalizeRemoteGitUrl = modules["extension/source.js"]["normalizeRemoteGitUrl"]
+const resolveLocalExtensionPath = modules["extension/source.js"]["resolveLocalExtensionPath"]
+export {assertSafeGitUrl, localPathAsFileUrl, materializeExtensionSource, normalizeRemoteGitUrl, resolveLocalExtensionPath};

package/dist/lib/extension/uninstall.js

@@ -0,0 +1,3 @@
+import {modules} from '../runtime.js';
+const uninstallExtension = modules["extension/uninstall.js"]["uninstallExtension"]
+export {uninstallExtension};

package/dist/lib/function-types.js

@@ -1,8 +1,10 @@
 import {modules} from './runtime.js';
+const FUNCTION_DISK_DIR = modules["function-types.js"]["FUNCTION_DISK_DIR"]
 const FUNCTION_EXTENSIONS = modules["function-types.js"]["FUNCTION_EXTENSIONS"]
 const FUNCTION_LIST_TYPES = modules["function-types.js"]["FUNCTION_LIST_TYPES"]
 const FUNCTION_RUNTIMES = modules["function-types.js"]["FUNCTION_RUNTIMES"]
 const FUNCTION_RUNTIME_EXTENSION = modules["function-types.js"]["FUNCTION_RUNTIME_EXTENSION"]
+const FUNCTION_UPSERT_RESPONSE_ONLY_KEYS = modules["function-types.js"]["FUNCTION_UPSERT_RESPONSE_ONLY_KEYS"]
 const formatFunctionDetail = modules["function-types.js"]["formatFunctionDetail"]
 const formatFunctionResultStatus = modules["function-types.js"]["formatFunctionResultStatus"]
 const formatFunctionRunResult = modules["function-types.js"]["formatFunctionRunResult"]
@@ -19,4 +21,4 @@ const normalizeFunctionUpsertPayload = modules["function-types.js"]["normalizeFu
 const normalizeFunctionsList = modules["function-types.js"]["normalizeFunctionsList"]
 const normalizeFunctionsListPage = modules["function-types.js"]["normalizeFunctionsListPage"]
 const parseParameterAssignments = modules["function-types.js"]["parseParameterAssignments"]
-export {FUNCTION_EXTENSIONS, FUNCTION_LIST_TYPES, FUNCTION_RUNTIMES, FUNCTION_RUNTIME_EXTENSION, formatFunctionDetail, formatFunctionResultStatus, formatFunctionRunResult, formatFunctionTable, functionEndpoint, functionResultEndpoint, functionResultLogEndpoint, functionRunEndpoint, functionsEndpoint, normalizeFunction, normalizeFunctionResultStatus, normalizeFunctionRunResult, normalizeFunctionUpsertPayload, normalizeFunctionsList, normalizeFunctionsListPage, parseParameterAssignments};
+export {FUNCTION_DISK_DIR, FUNCTION_EXTENSIONS, FUNCTION_LIST_TYPES, FUNCTION_RUNTIMES, FUNCTION_RUNTIME_EXTENSION, FUNCTION_UPSERT_RESPONSE_ONLY_KEYS, formatFunctionDetail, formatFunctionResultStatus, formatFunctionRunResult, formatFunctionTable, functionEndpoint, functionResultEndpoint, functionResultLogEndpoint, functionRunEndpoint, functionsEndpoint, normalizeFunction, normalizeFunctionResultStatus, normalizeFunctionRunResult, normalizeFunctionUpsertPayload, normalizeFunctionsList, normalizeFunctionsListPage, parseParameterAssignments};

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

@@ -18,7 +18,7 @@ import { DEFAULT_APEX_TEST_WAIT_MINUTES, parseApexTestClassNames, runWorkApexTes
 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 { fetchWorkItem, fetchWorkItems } from '../work-get.js';
+import { fetchWorkItems, fetchWorkItemWithOptions } 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, uploadCapturedPublishLogsBestEffort, } from '../work-push.js';
@@ -126,8 +126,13 @@ async function workList(args = {}) {
     return mcpPaginatedListPayload('userStories', await fetchWorkItems(filters));
 }
 async function workGet(args = {}) {
-    const userStory = await fetchWorkItem(args.id);
-    return { userStory };
+    const { committedMetadata, userStory } = await fetchWorkItemWithOptions(args.id, {
+        committedMetadata: args.committedMetadata === true,
+    });
+    return {
+        userStory,
+        ...(committedMetadata === undefined ? {} : { committedMetadata }),
+    };
 }
 async function workCreate(args = {}) {
     const explicitPayload = buildWorkMutationPayloadFromArgs(args);
@@ -522,7 +527,11 @@ async function cloudCommit(args = {}) {
         throw new Error('Use changes or simple metadata fields, not both.');
     }
     if (args.changes === undefined && !hasMcpSimpleCommitArgs(args)) {
-        throw new Error('Requires simple metadata fields such as metadataName and metadataType, or changes input.');
+        throw new Error('Requires simple metadata fields such as metadataName, metadataType, and metadataCategory, or changes input.');
+    }
+    if (args.changes === undefined &&
+        (args.metadataCategory === undefined || args.metadataCategory.trim().length === 0)) {
+        throw new Error('metadataCategory is required.');
     }
     const workItemId = await resolveWorkItemId(args.id);
     const request = buildWorkCommitRequest(buildMcpWorkCommitInput(args), {
@@ -657,8 +666,12 @@ export function registerAgentiaMcpWorkTools(server) {
         title: 'Agentia Work List',
     }, (args) => safelyHandleTool(() => workList(args || {})));
     server.registerTool('agentia_work_get', {
-        description: 'Get a Copado user story by Id via the CICD gateway. Omit Id to use the active work item from work set.',
+        description: 'Get a Copado user story by Id via the CICD gateway. Omit Id to use the active work item from work set. Set committedMetadata=true to also include the Story committed metadata list.',
         inputSchema: {
+            committedMetadata: z
+                .boolean()
+                .optional()
+                .describe('When true, also include the Story committed metadata list as committedMetadata in the result.'),
             id: z.string().optional().describe('User story Id. Defaults to the active work item from work set.'),
         },
         title: 'Agentia Work Get',
@@ -782,7 +795,7 @@ export function registerAgentiaMcpWorkTools(server) {
             .describe(`Maximum total wait in seconds. Defaults to ${PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS}.`),
     };
     server.registerTool('agentia_cloud_commit', {
-        description: 'Create a Copado cloud metadata commit. Preflights the user story, submits POST /release/commit, and optionally waits for the job. Use simple metadata fields for one change or changes for multi-change requests. For Salesforce metadata, set metadataCategory to SFDX (or c: "SFDX" on each changes entry); Copado SFDX deploy skips entries that omit that field. For local Git work, use git commit then agentia_work_publish; pass permissions and fullMetadata on agentia_work_publish.',
+        description: 'Create a Copado cloud metadata commit. Preflights the user story, submits POST /release/commit, and optionally waits for the job. Use simple metadata fields for one change or changes for multi-change requests. metadataCategory is required for simple input; each changes entry requires c (or category). For Salesforce metadata, set metadataCategory/c to SFDX; Copado SFDX deploy skips entries that omit that field. For local Git work, use git commit then agentia_work_publish; pass permissions and fullMetadata on agentia_work_publish.',
         inputSchema: cloudCommitInputSchema,
         title: 'Agentia Cloud Commit',
     }, (args) => safelyHandleTool(() => cloudCommit(args || {})));

package/dist/lib/project-setup.js

@@ -1,13 +1,14 @@
 import {modules} from './runtime.js';
+const LEGACY_AGENTIA_AGENTS_END_MARKER = modules["project-setup.js"]["LEGACY_AGENTIA_AGENTS_END_MARKER"]
+const LEGACY_AGENTIA_AGENTS_START_MARKER = modules["project-setup.js"]["LEGACY_AGENTIA_AGENTS_START_MARKER"]
 const createLocalQualityGateScripts = modules["project-setup.js"]["createLocalQualityGateScripts"]
 const ensureAgentiaGitignore = modules["project-setup.js"]["ensureAgentiaGitignore"]
-const findAgentsMd = modules["project-setup.js"]["findAgentsMd"]
 const findLocalQualityGateScripts = modules["project-setup.js"]["findLocalQualityGateScripts"]
 const gitignoreHasAgentiaEntry = modules["project-setup.js"]["gitignoreHasAgentiaEntry"]
+const legacyAgentiaSectionRemovalMessage = modules["project-setup.js"]["legacyAgentiaSectionRemovalMessage"]
+const removeLegacyAgentiaSection = modules["project-setup.js"]["removeLegacyAgentiaSection"]
 const resetProjectSetupDepsForTests = modules["project-setup.js"]["resetProjectSetupDepsForTests"]
-const resolveAgentsMdContent = modules["project-setup.js"]["resolveAgentsMdContent"]
 const resolveProjectContext = modules["project-setup.js"]["resolveProjectContext"]
 const runProjectSetup = modules["project-setup.js"]["runProjectSetup"]
 const setProjectSetupDepsForTests = modules["project-setup.js"]["setProjectSetupDepsForTests"]
-const writeAgentsMd = modules["project-setup.js"]["writeAgentsMd"]
-export {createLocalQualityGateScripts, ensureAgentiaGitignore, findAgentsMd, findLocalQualityGateScripts, gitignoreHasAgentiaEntry, resetProjectSetupDepsForTests, resolveAgentsMdContent, resolveProjectContext, runProjectSetup, setProjectSetupDepsForTests, writeAgentsMd};
+export {LEGACY_AGENTIA_AGENTS_END_MARKER, LEGACY_AGENTIA_AGENTS_START_MARKER, createLocalQualityGateScripts, ensureAgentiaGitignore, findLocalQualityGateScripts, gitignoreHasAgentiaEntry, legacyAgentiaSectionRemovalMessage, removeLegacyAgentiaSection, resetProjectSetupDepsForTests, resolveProjectContext, runProjectSetup, setProjectSetupDepsForTests};