@copado/agentia-cli 0.10.0-alpha.0 → 0.13.0-alpha.0

package/dist/lib/promotion-types.js

@@ -0,0 +1,145 @@
+import { cellValue, table } from './format.js';
+import { normalizeSalesforceId } from './salesforce-id.js';
+export const PROMOTION_LIST_FILTER_KEYS = [
+    'name',
+    'status',
+    'projectId',
+    'projectName',
+    'pipelineId',
+    'pipelineName',
+    'sourceEnvironmentId',
+    'sourceEnvironmentName',
+    'destinationEnvironmentId',
+    'destinationEnvironmentName',
+    'isBackPromotion',
+    'createdById',
+    'createdByName',
+    'limit',
+];
+const PROMOTION_LIST_FILTER_QUERY_PARAM = {
+    createdById: 'createdById',
+    createdByName: 'createdByName',
+    destinationEnvironmentId: 'destinationEnvironmentId',
+    destinationEnvironmentName: 'destinationEnvironmentName',
+    isBackPromotion: 'isBackPromotion',
+    limit: 'limit',
+    name: 'name',
+    pipelineId: 'pipelineId',
+    pipelineName: 'pipelineName',
+    projectId: 'projectId',
+    projectName: 'projectName',
+    sourceEnvironmentId: 'sourceEnvironmentId',
+    sourceEnvironmentName: 'sourceEnvironmentName',
+    status: 'status',
+};
+export const PROMOTION_LIST_LIMIT_MAX = 200;
+export const PROMOTION_LIST_LIMIT_MIN = 1;
+export function promotionListEndpoint(filters = {}) {
+    const params = new URLSearchParams();
+    for (const key of PROMOTION_LIST_FILTER_KEYS) {
+        const value = filters[key];
+        if (value === undefined) {
+            continue;
+        }
+        if (key === 'isBackPromotion') {
+            params.set(PROMOTION_LIST_FILTER_QUERY_PARAM[key], String(value));
+            continue;
+        }
+        if (key === 'limit') {
+            params.set(PROMOTION_LIST_FILTER_QUERY_PARAM[key], String(value));
+            continue;
+        }
+        if (key === 'sourceEnvironmentId' ||
+            key === 'destinationEnvironmentId' ||
+            key === 'pipelineId' ||
+            key === 'projectId' ||
+            key === 'createdById') {
+            params.set(PROMOTION_LIST_FILTER_QUERY_PARAM[key], normalizeSalesforceId(value));
+            continue;
+        }
+        params.set(PROMOTION_LIST_FILTER_QUERY_PARAM[key], value);
+    }
+    const query = params.toString();
+    return query.length > 0 ? `/release/promotion?${query}` : '/release/promotion';
+}
+export function promotionEndpoint(id) {
+    return `/release/promotion/${normalizeSalesforceId(id)}`;
+}
+export function normalizePromotions(response) {
+    if (Array.isArray(response)) {
+        return response;
+    }
+    if (Array.isArray(response.data)) {
+        return response.data;
+    }
+    return [];
+}
+export function normalizePromotionDetail(response) {
+    if ('data' in response && response.data !== undefined && typeof response.data === 'object') {
+        return response.data;
+    }
+    return response;
+}
+export function formatPromotionTable(promotions) {
+    return table([
+        { alias: 'ID', value: 'id' },
+        { alias: 'NAME', value: 'name' },
+        { alias: 'STATUS', value: 'status' },
+        { alias: 'PROJECT', value: 'projectName' },
+        { alias: 'PIPELINE', value: 'pipelineName' },
+        { alias: 'SOURCE', value: 'sourceEnvironmentName' },
+        { alias: 'DESTINATION', value: 'destinationEnvironmentName' },
+        { alias: 'BACK', value: 'isBackPromotion' },
+    ], promotions.map((promotion) => ({
+        destinationEnvironmentName: cellValue(promotion.destinationEnvironmentName),
+        id: cellValue(promotion.id),
+        isBackPromotion: cellValue(promotion.isBackPromotion),
+        name: cellValue(promotion.name),
+        pipelineName: cellValue(promotion.pipelineName),
+        projectName: cellValue(promotion.projectName),
+        sourceEnvironmentName: cellValue(promotion.sourceEnvironmentName),
+        status: cellValue(promotion.status),
+    })));
+}
+function appendOptionalDetailLine(lines, label, value) {
+    if (typeof value === 'string' && value.trim().length > 0) {
+        lines.push(`${label}: ${value}`);
+    }
+}
+function promotionDetailIdentityLines(promotion) {
+    const { identification, mainSettings } = promotion;
+    const promotionName = identification?.promotionName ?? promotion.id;
+    return [
+        `ID: ${cellValue(promotion.id)}`,
+        `Name: ${cellValue(promotionName)}`,
+        `Status: ${cellValue(promotion.status)}`,
+        `Salesforce Status: ${cellValue(promotion.salesforceStatus)}`,
+        `Project: ${cellValue(identification?.projectName ?? identification?.projectId)}`,
+        `Release: ${cellValue(identification?.releaseName ?? identification?.releaseId)}`,
+        `Pipeline: ${cellValue(identification?.pipelineName ?? identification?.pipelineId)}`,
+        `Source Environment: ${cellValue(promotion.sourceEnvironmentName ?? promotion.sourceEnvironmentId)}`,
+        `Destination Environment: ${cellValue(promotion.destinationEnvironmentName ?? promotion.destinationEnvironmentId)}`,
+        `Platform: ${cellValue(mainSettings?.platform)}`,
+        `Back Promotion: ${cellValue(mainSettings?.isBackPromotion)}`,
+        `Promotion Method: ${cellValue(mainSettings?.promotionMethod)}`,
+    ];
+}
+function promotionDetailExecutionLines(promotion) {
+    return [
+        `User Stories: ${cellValue(promotion.userStoryCount ?? promotion.userStories?.length)}`,
+        `Included Metadata: ${cellValue(promotion.includedMetadataCount ?? promotion.includedMetadata?.length)}`,
+        `Last Promotion Execution: ${cellValue(promotion.lastPromotionExecutionId)} (${cellValue(promotion.lastPromotionExecutionStatus)})`,
+        `Last Deployment Execution: ${cellValue(promotion.lastDeploymentExecutionId)} (${cellValue(promotion.lastDeploymentExecutionStatus)})`,
+        `Created By: ${cellValue(promotion.createdBy)}`,
+        `Created Date: ${cellValue(promotion.createdDate)}`,
+        `Last Modified By: ${cellValue(promotion.lastModifiedBy)}`,
+        `Last Modified Date: ${cellValue(promotion.lastModifiedDate)}`,
+    ];
+}
+export function formatPromotionDetail(promotion) {
+    const lines = [...promotionDetailIdentityLines(promotion), ...promotionDetailExecutionLines(promotion)];
+    appendOptionalDetailLine(lines, 'Execution Error', promotion.executionErrorMessage);
+    appendOptionalDetailLine(lines, 'View In Git', promotion.viewInGitLink);
+    return lines.join('\n');
+}
+//# sourceMappingURL=promotion-types.js.map

package/dist/lib/promotion-types.js.map

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

package/dist/lib/user-types.d.ts

@@ -0,0 +1,9 @@
+export type User = {
+    fullName?: null | string;
+    id: null | string;
+    username?: null | string;
+};
+export declare const DEFAULT_USER_ID = "me";
+export declare function resolveUserId(userId?: null | string): string;
+export declare function userEndpoint(userId?: string): string;
+export declare function formatUserDetail(user: User): string;

package/dist/lib/user-types.js

@@ -0,0 +1,21 @@
+import { cellValue } from './format.js';
+import { normalizeSalesforceId } from './salesforce-id.js';
+export const DEFAULT_USER_ID = 'me';
+export function resolveUserId(userId) {
+    const trimmed = userId?.trim();
+    if (trimmed === undefined || trimmed.length === 0) {
+        return DEFAULT_USER_ID;
+    }
+    return trimmed.toLowerCase() === DEFAULT_USER_ID ? DEFAULT_USER_ID : normalizeSalesforceId(trimmed);
+}
+export function userEndpoint(userId = DEFAULT_USER_ID) {
+    return `/corpus/users/${resolveUserId(userId)}`;
+}
+export function formatUserDetail(user) {
+    return [
+        `ID: ${cellValue(user.id)}`,
+        `Full Name: ${cellValue(user.fullName)}`,
+        `Username: ${cellValue(user.username)}`,
+    ].join('\n');
+}
+//# sourceMappingURL=user-types.js.map

package/dist/lib/user-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-types.js","sourceRoot":"","sources":["../../src/lib/user-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,aAAa,CAAA;AACrC,OAAO,EAAC,qBAAqB,EAAC,MAAM,oBAAoB,CAAA;AAQxD,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAA;AAEnC,MAAM,UAAU,aAAa,CAAC,MAAsB;IAClD,MAAM,OAAO,GAAG,MAAM,EAAE,IAAI,EAAE,CAAA;IAC9B,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,OAAO,eAAe,CAAA;IACxB,CAAC;IAED,OAAO,OAAO,CAAC,WAAW,EAAE,KAAK,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAA;AACrG,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,SAAiB,eAAe;IAC3D,OAAO,iBAAiB,aAAa,CAAC,MAAM,CAAC,EAAE,CAAA;AACjD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAU;IACzC,OAAO;QACL,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QAC3B,cAAc,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;QACxC,aAAa,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;KACxC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}

package/oclif.manifest.json

@@ -281,6 +281,7 @@
       "description": "List Copado environments",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --name Dev --org-id 00D000000000000 --platform SFDX --type Sandbox",
         "<%= config.bin %> <%= command.id %> --json"
       ],
       "flags": {
@@ -290,6 +291,40 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
+        },
+        "name": {
+          "description": "Filter by name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "org-id": {
+          "description": "Filter by Salesforce org ID",
+          "name": "org-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "platform": {
+          "description": "Filter by platform",
+          "name": "platform",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "type": {
+          "description": "Environment type",
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "Production/Developer",
+            "Sandbox",
+            "Scratch Org",
+            "Custom Domain"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -429,31 +464,6 @@
         "update.js"
       ]
     },
-    "mcp:start": {
-      "aliases": [],
-      "args": {},
-      "description": "Start the local Agentia MCP server over stdio",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> # long-running stdio MCP server for Cursor and other clients"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "mcp:start",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "mcp",
-        "start.js"
-      ]
-    },
     "job:get": {
       "aliases": [],
       "args": {
@@ -823,6 +833,31 @@
         "run.js"
       ]
     },
+    "mcp:start": {
+      "aliases": [],
+      "args": {},
+      "description": "Start the local Agentia MCP server over stdio",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> # long-running stdio MCP server for Cursor and other clients"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "mcp:start",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "mcp",
+        "start.js"
+      ]
+    },
     "metadata:list": {
       "aliases": [],
       "args": {},
@@ -1076,6 +1111,259 @@
         "list.js"
       ]
     },
+    "project:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List Copado projects",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --mine",
+        "<%= config.bin %> <%= command.id %> --mine --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "mine": {
+          "description": "List only projects owned by or related to the current user",
+          "name": "mine",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "project:list",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "project",
+        "list.js"
+      ]
+    },
+    "promotion:get": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Copado promotion ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get a Copado promotion by ID",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> <promotion-id>",
+        "<%= config.bin %> <%= command.id %> <promotion-id> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "promotion:get",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "promotion",
+        "get.js"
+      ]
+    },
+    "promotion:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List Copado promotions",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --status Completed --project-name \"My Project\" --limit 50",
+        "<%= config.bin %> <%= command.id %> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "created-by-id": {
+          "description": "Filter by creator ID",
+          "name": "created-by-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "created-by-name": {
+          "description": "Filter by creator name",
+          "name": "created-by-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "destination-environment-id": {
+          "description": "Filter by destination environment ID",
+          "name": "destination-environment-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "destination-environment-name": {
+          "description": "Filter by destination environment name",
+          "name": "destination-environment-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "is-back-promotion": {
+          "description": "Filter by back promotion",
+          "name": "is-back-promotion",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Maximum number of promotions to return (1-200)",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Filter by name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "pipeline-id": {
+          "description": "Filter by pipeline ID",
+          "name": "pipeline-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "pipeline-name": {
+          "description": "Filter by pipeline name",
+          "name": "pipeline-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "project-id": {
+          "description": "Filter by project ID",
+          "name": "project-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "project-name": {
+          "description": "Filter by project name",
+          "name": "project-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "source-environment-id": {
+          "description": "Filter by source environment ID",
+          "name": "source-environment-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "source-environment-name": {
+          "description": "Filter by source environment name",
+          "name": "source-environment-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "status": {
+          "description": "Filter by status",
+          "name": "status",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "promotion:list",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "promotion",
+        "list.js"
+      ]
+    },
+    "user:get": {
+      "aliases": [],
+      "args": {},
+      "description": "Get a Copado user by ID (defaults to the authenticated user)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --id me",
+        "<%= config.bin %> <%= command.id %> --id 005000000000000",
+        "<%= config.bin %> <%= command.id %> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "id": {
+          "description": "User ID, or \"me\" for the authenticated user",
+          "name": "id",
+          "default": "me",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "user:get",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "user",
+        "get.js"
+      ]
+    },
     "work:create": {
       "aliases": [],
       "args": {},
@@ -3154,5 +3442,5 @@
       ]
     }
   },
-  "version": "0.10.0-alpha.0"
+  "version": "0.13.0-alpha.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@copado/agentia-cli",
   "description": "Command-line interface for Agentia",
-  "version": "0.10.0-alpha.0",
+  "version": "0.13.0-alpha.0",
   "author": "Copado Solutions",
   "bin": {
     "agentia": "./bin/run.js"
@@ -80,6 +80,9 @@
       "project": {
         "description": "Manage Copado projects"
       },
+      "user": {
+        "description": "Manage Copado users"
+      },
       "work": {
         "description": "Manage Copado user stories"
       },