@copado/agentia-cli 0.54.0-alpha.0 → 0.56.0-alpha.0

package/dist/commands/cicd/work/commit.d.ts

@@ -0,0 +1,31 @@
+import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { type WorkCommitResult } from '../../../lib/work-commit.js';
+export default class WorkCommit extends AgentiaCommand {
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        action: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'base-branch': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        cloud: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'commit-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'execute-commit': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        message: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'metadata-category': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'metadata-message': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'metadata-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'metadata-raw-json': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'metadata-type': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'platform-experience': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'recreate-feature-branch': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        selection: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        stdin: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        wait: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'wait-timeout': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<WorkCommitResult>;
+    protected toErrorJson(err: unknown): unknown;
+}

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

@@ -0,0 +1,254 @@
+import { Args, Flags } from '@oclif/core';
+import { readFileSync } from 'node:fs';
+import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { resolveWorkItemId, WorkActiveResolutionError } from '../../../lib/work-active.js';
+import { buildWorkCommitRequest, formatWorkCommitResult, normalizeWorkCommitInput, performWorkCommit, WORK_COMMIT_ACTIONS, WORK_COMMIT_DEFAULT_TIMEOUT_SECONDS, WORK_COMMIT_PLATFORM_EXPERIENCES, WorkCommitJobFailedError, WorkCommitTimeoutError, WorkCommitValidationError, } from '../../../lib/work-commit.js';
+function readStdin() {
+    if (process.stdin.isTTY) {
+        throw new WorkCommitValidationError('Cannot read --stdin from an interactive terminal. Pipe JSON input or use --file <path>.');
+    }
+    return new Promise((resolve, reject) => {
+        let data = '';
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', (chunk) => {
+            data += chunk;
+        });
+        process.stdin.on('end', () => resolve(data));
+        process.stdin.on('error', reject);
+    });
+}
+function readJsonFile(path) {
+    try {
+        return readFileSync(path, 'utf8');
+    }
+    catch (error) {
+        throw new WorkCommitValidationError(`Cannot read JSON request file ${path}: ${error.message}`);
+    }
+}
+function parseJsonValue(raw, label) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        throw new WorkCommitValidationError(`${label} must contain valid JSON: ${error.message}`);
+    }
+}
+function hasSimpleChangeFlags(flags) {
+    return (flags.action !== undefined ||
+        flags['metadata-category'] !== undefined ||
+        flags['metadata-message'] !== undefined ||
+        flags['metadata-name'] !== undefined ||
+        flags['metadata-raw-json'] !== undefined ||
+        flags['metadata-type'] !== undefined ||
+        flags.selection !== undefined);
+}
+function simpleInputFromFlags(flags) {
+    const rawJson = flags['metadata-raw-json'] === undefined
+        ? undefined
+        : parseJsonValue(flags['metadata-raw-json'], '--metadata-raw-json');
+    return {
+        baseBranch: flags['base-branch'] ?? null,
+        changes: [
+            {
+                ...(flags.action === undefined ? {} : { a: flags.action }),
+                ...(flags['metadata-category'] === undefined ? {} : { c: flags['metadata-category'] }),
+                ...(rawJson === undefined ? {} : { j: rawJson }),
+                ...(flags['metadata-message'] === undefined ? {} : { m: flags['metadata-message'] }),
+                n: flags['metadata-name'],
+                ...(flags.selection === undefined ? {} : { selections: flags.selection }),
+                t: flags['metadata-type'],
+            },
+        ],
+        commitId: flags['commit-id'],
+        executeCommit: flags['execute-commit'],
+        message: flags.message,
+        recreateFeatureBranch: flags['recreate-feature-branch'],
+    };
+}
+async function jsonInputFromFlags(flags) {
+    const raw = flags.file === undefined ? await readStdin() : readJsonFile(flags.file);
+    const input = normalizeWorkCommitInput(parseJsonValue(raw, flags.file === undefined ? 'stdin' : flags.file));
+    return {
+        ...input,
+        ...(flags['base-branch'] === undefined ? {} : { baseBranch: flags['base-branch'] }),
+        ...(flags['commit-id'] === undefined ? {} : { commitId: flags['commit-id'] }),
+        ...(flags['execute-commit'] ? {} : { executeCommit: false }),
+        ...(flags.message === undefined ? {} : { message: flags.message }),
+        ...(flags['recreate-feature-branch'] ? { recreateFeatureBranch: true } : {}),
+    };
+}
+async function commitInputFromFlags(flags) {
+    const jsonModes = [flags.file !== undefined, flags.stdin].filter(Boolean).length;
+    const simpleMode = hasSimpleChangeFlags(flags);
+    if (jsonModes > 1) {
+        throw new WorkCommitValidationError('Use only one JSON input mode: --file or --stdin.');
+    }
+    if (jsonModes > 0 && simpleMode) {
+        throw new WorkCommitValidationError('Use JSON input or simple metadata flags, not both.');
+    }
+    if (jsonModes > 0) {
+        return jsonInputFromFlags(flags);
+    }
+    if (!simpleMode) {
+        throw new WorkCommitValidationError('Requires simple metadata flags such as --metadata-name and --metadata-type, or JSON input with --file/--stdin.');
+    }
+    return simpleInputFromFlags(flags);
+}
+export default class WorkCommit extends AgentiaCommand {
+    static args = {
+        id: Args.string({
+            description: 'User story ID (defaults to the active work item from `work set`)',
+            required: false,
+        }),
+    };
+    static description = [
+        'Create and optionally wait for a Copado cloud commit job for a user story.',
+        'Preflights the story, submits POST /release/commit, and polls the job monitor by default.',
+    ].join(' ');
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --cloud --message "Commit AccountService" --metadata-name AccountService --metadata-type ApexClass --action Add',
+        '<%= config.bin %> <%= command.id %> a07XXXXXXXXXXXXXXX --cloud --message "Update Aura files" --metadata-name accountEditor --metadata-type AuraDefinitionBundle --action SelectiveCommit --selection accountEditor/accountEditor.cmp --selection accountEditor/accountEditorController.js',
+        'cat commit-request.json | <%= config.bin %> <%= command.id %> --cloud --stdin --json',
+    ];
+    static flags = {
+        action: Flags.string({
+            description: 'Metadata action for simple flag input. Defaults to Add.',
+            options: [...WORK_COMMIT_ACTIONS],
+        }),
+        'base-branch': Flags.string({
+            description: 'Optional base branch to include in the commit request.',
+        }),
+        cloud: Flags.boolean({
+            default: false,
+            description: 'Use the Copado cloud commit API. Required for this command.',
+        }),
+        'commit-id': Flags.string({
+            description: 'Existing local Git commit identifier to register when --no-execute-commit is used.',
+        }),
+        'execute-commit': Flags.boolean({
+            allowNo: true,
+            default: true,
+            description: 'Execute the Copado commit job. Use --no-execute-commit only with --commit-id.',
+        }),
+        file: Flags.string({
+            char: 'f',
+            description: 'Path to a JSON commit request body.',
+        }),
+        message: Flags.string({
+            char: 'm',
+            description: 'Commit message. Required unless provided by JSON input.',
+        }),
+        'metadata-category': Flags.string({
+            description: 'Optional metadata category for simple flag input, usually SFDX.',
+        }),
+        'metadata-message': Flags.string({
+            description: 'Optional per-change message for simple flag input.',
+        }),
+        'metadata-name': Flags.string({
+            description: 'Metadata full name for simple flag input.',
+        }),
+        'metadata-raw-json': Flags.string({
+            description: 'Optional raw metadata JSON value for simple flag input.',
+        }),
+        'metadata-type': Flags.string({
+            description: 'Metadata type for simple flag input, for example ApexClass.',
+        }),
+        'platform-experience': Flags.string({
+            default: 'sfdx',
+            description: 'Initial platform-experience header for preflight. The preflight response wins for commit.',
+            options: [...WORK_COMMIT_PLATFORM_EXPERIENCES],
+        }),
+        'recreate-feature-branch': Flags.boolean({
+            default: false,
+            description: 'Ask Copado to recreate the feature branch before committing.',
+        }),
+        selection: Flags.string({
+            description: 'Selected file inside a bundle for SelectiveCommit. Can be provided multiple times.',
+            multiple: true,
+        }),
+        stdin: Flags.boolean({
+            default: false,
+            description: 'Read a JSON commit request body from stdin.',
+        }),
+        wait: Flags.boolean({
+            allowNo: true,
+            default: true,
+            description: 'Poll the commit job to a terminal status when a jobExecution Id is returned.',
+        }),
+        'wait-timeout': Flags.integer({
+            default: WORK_COMMIT_DEFAULT_TIMEOUT_SECONDS,
+            description: 'Maximum seconds to wait for the commit job.',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(WorkCommit);
+        const commitFlags = flags;
+        if (!commitFlags.cloud) {
+            this.error('Only cloud commit is supported for now. Pass --cloud to use POST /release/commit.', { exit: 2 });
+        }
+        if (!Number.isInteger(commitFlags['wait-timeout']) || commitFlags['wait-timeout'] <= 0) {
+            this.error('--wait-timeout must be a positive integer.', { exit: 2 });
+        }
+        let workItemId;
+        try {
+            workItemId = await resolveWorkItemId(args.id);
+        }
+        catch (error) {
+            if (error instanceof WorkActiveResolutionError) {
+                this.error(error.message, {
+                    exit: 1,
+                    suggestions: [`${this.config.bin} cicd work set <id>`],
+                });
+            }
+            throw error;
+        }
+        try {
+            const input = await commitInputFromFlags(commitFlags);
+            const request = buildWorkCommitRequest(input, { message: commitFlags.message, userStoryId: workItemId });
+            const result = await performWorkCommit({
+                hooks: {
+                    log: (message) => this.display(() => this.log(message)),
+                    withSpinner: (message, action) => this.withSpinner(message, action),
+                },
+                initialPlatformExperience: commitFlags['platform-experience'],
+                request,
+                timeoutSeconds: commitFlags['wait-timeout'],
+                wait: commitFlags.wait,
+            });
+            this.display(() => {
+                this.log(formatWorkCommitResult(result));
+            });
+            return result;
+        }
+        catch (error) {
+            if (error instanceof WorkCommitValidationError) {
+                this.error(error.message, { exit: 2 });
+            }
+            if (error instanceof WorkCommitJobFailedError || error instanceof WorkCommitTimeoutError) {
+                this.display(() => {
+                    if (error.result !== undefined) {
+                        this.log(formatWorkCommitResult(error.result));
+                    }
+                });
+                error.oclif = { exit: 1 };
+                throw error;
+            }
+            throw error;
+        }
+    }
+    toErrorJson(err) {
+        const base = super.toErrorJson(err);
+        if (err instanceof WorkCommitJobFailedError || err instanceof WorkCommitTimeoutError) {
+            return {
+                ...base,
+                error: {
+                    ...(base.error && typeof base.error === 'object' ? base.error : {}),
+                    ...(err.jobMonitor === undefined ? {} : { jobMonitor: err.jobMonitor }),
+                    ...(err.result === undefined ? {} : { result: err.result }),
+                },
+            };
+        }
+        return base;
+    }
+}
+//# sourceMappingURL=commit.js.map

package/dist/commands/cicd/work/commit.js.map

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

package/dist/lib/mcp/result.d.ts

@@ -13,7 +13,9 @@ export declare function toolError(error: unknown): {
     isError: boolean;
     structuredContent: {
         error: {
+            result?: {} | null | undefined;
             message: string;
+            jobMonitor?: {} | null | undefined;
         };
     };
 };
@@ -31,7 +33,9 @@ export declare function safelyHandleTool(handler: () => Promise<Record<string, u
     isError: boolean;
     structuredContent: {
         error: {
+            result?: {} | null | undefined;
             message: string;
+            jobMonitor?: {} | null | undefined;
         };
     };
 }>;

package/dist/lib/mcp/result.js

@@ -12,20 +12,24 @@ export function toolResult(data) {
     };
 }
 export function toolError(error) {
+    const structured = error && typeof error === 'object' ? error : {};
     const payload = {
         error: {
+            ...(structured.jobMonitor === undefined ? {} : { jobMonitor: structured.jobMonitor }),
             message: redactErrorMessage(error),
+            ...(structured.result === undefined ? {} : { result: structured.result }),
         },
     };
+    const redacted = redactSecrets(payload);
     return {
         content: [
             {
-                text: JSON.stringify(payload, null, 2),
+                text: JSON.stringify(redacted, null, 2),
                 type: 'text',
             },
         ],
         isError: true,
-        structuredContent: payload,
+        structuredContent: redacted,
     };
 }
 export async function safelyHandleTool(handler) {

package/dist/lib/mcp/result.js.map

@@ -1 +1 @@
-{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/lib/mcp/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAE,aAAa,EAAC,MAAM,gBAAgB,CAAA;AAEhE,MAAM,UAAU,UAAU,CAAC,IAA6B;IACtD,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;IAEpC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvC,IAAI,EAAE,MAAe;aACtB;SACF;QACD,iBAAiB,EAAE,QAAQ;KAC5B,CAAA;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,MAAM,OAAO,GAAG;QACd,KAAK,EAAE;YACL,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC;SACnC;KACF,CAAA;IAED,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;gBACtC,IAAI,EAAE,MAAe;aACtB;SACF;QACD,OAAO,EAAE,IAAI;QACb,iBAAiB,EAAE,OAAO;KAC3B,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAA+C;IACpF,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,MAAM,OAAO,EAAE,CAAC,CAAA;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,SAAS,CAAC,KAAK,CAAC,CAAA;IACzB,CAAC;AACH,CAAC"}
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/lib/mcp/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAE,aAAa,EAAC,MAAM,gBAAgB,CAAA;AAEhE,MAAM,UAAU,UAAU,CAAC,IAA6B;IACtD,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;IAEpC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvC,IAAI,EAAE,MAAe;aACtB;SACF;QACD,iBAAiB,EAAE,QAAQ;KAC5B,CAAA;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,MAAM,UAAU,GAAG,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAE,KAAiC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC/F,MAAM,OAAO,GAAG;QACd,KAAK,EAAE;YACL,GAAG,CAAC,UAAU,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,UAAU,EAAE,UAAU,CAAC,UAAU,EAAC,CAAC;YACnF,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC;YAClC,GAAG,CAAC,UAAU,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,MAAM,EAAE,UAAU,CAAC,MAAM,EAAC,CAAC;SACxE;KACF,CAAA;IACD,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;IAEvC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvC,IAAI,EAAE,MAAe;aACtB;SACF;QACD,OAAO,EAAE,IAAI;QACb,iBAAiB,EAAE,QAAQ;KAC5B,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAA+C;IACpF,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,MAAM,OAAO,EAAE,CAAC,CAAA;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,SAAS,CAAC,KAAK,CAAC,CAAA;IACzB,CAAC;AACH,CAAC"}

package/dist/lib/mcp/tools.d.ts

@@ -419,6 +419,27 @@ declare function navigationResolve(args: {
     resourceType: (typeof NAVIGATION_RESOURCE_TYPES)[number];
 }): Promise<import("../navigation.js").NavigationTarget>;
 export declare const agentiaMcpToolHandlers: {
+    workCommit: (args?: {
+        action?: import("../work-commit.js").WorkCommitAction;
+        baseBranch?: null | string;
+        changes?: unknown[];
+        cloud?: boolean;
+        commitId?: string;
+        dataTemplateSyncConfig?: unknown[];
+        executeCommit?: boolean;
+        id?: string;
+        message?: string;
+        metadataCategory?: string;
+        metadataMessage?: string;
+        metadataName?: string;
+        metadataRawJson?: unknown;
+        metadataType?: string;
+        platformExperience?: import("../work-commit.js").WorkCommitPlatformExperience;
+        recreateFeatureBranch?: boolean;
+        selection?: string[];
+        wait?: boolean;
+        waitTimeout?: number;
+    }) => Promise<import("../work-commit.js").WorkCommitResult>;
     workCreate: (args?: Partial<import("../work-types.js").UserStoryMutationPayload>) => Promise<{
         userStory: import("../work-types.js").UserStory;
     }>;

package/dist/lib/mcp/work-tools.d.ts

@@ -1,4 +1,5 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type WorkCommitAction, type WorkCommitPlatformExperience } from '../work-commit.js';
 import { type HeadlessCommandResult, type UserStory, type UserStoryMutationPayload, type WorkListFilters, type WorkSetResult, type WorkTestResult } from '../work-types.js';
 type WorkMutationInput = Partial<UserStoryMutationPayload>;
 type WorkListArgs = WorkListFilters & {
@@ -27,6 +28,27 @@ type WorkTestArgs = {
     apexTestClasses?: string;
     local?: boolean;
 };
+type WorkCommitArgs = {
+    action?: WorkCommitAction;
+    baseBranch?: null | string;
+    changes?: unknown[];
+    cloud?: boolean;
+    commitId?: string;
+    dataTemplateSyncConfig?: unknown[];
+    executeCommit?: boolean;
+    id?: string;
+    message?: string;
+    metadataCategory?: string;
+    metadataMessage?: string;
+    metadataName?: string;
+    metadataRawJson?: unknown;
+    metadataType?: string;
+    platformExperience?: WorkCommitPlatformExperience;
+    recreateFeatureBranch?: boolean;
+    selection?: string[];
+    wait?: boolean;
+    waitTimeout?: number;
+};
 declare function workList(args?: WorkListArgs): Promise<Record<string, unknown>>;
 declare function workGet(args?: WorkGetArgs): Promise<{
     userStory: UserStory;
@@ -52,6 +74,7 @@ declare function workSubmit(args?: WorkSubmitArgs): Promise<{
     workItem: string;
 }>;
 declare function workTest(args?: WorkTestArgs): Promise<WorkTestResult>;
+declare function workCommit(args?: WorkCommitArgs): Promise<import("../work-commit.js").WorkCommitResult>;
 declare function workDone(): Promise<{
     branch: string;
     done: HeadlessCommandResult;
@@ -60,6 +83,7 @@ declare function workDone(): Promise<{
     workItem: string;
 }>;
 export declare const agentiaMcpWorkToolHandlers: {
+    workCommit: typeof workCommit;
     workCreate: typeof workCreate;
     workDelete: typeof workDelete;
     workDone: typeof workDone;

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

@@ -8,6 +8,7 @@ import { LocalQualityGatesError, runLocalQualityGates } from '../local-quality-g
 import { PROJECT_DEFAULT_KEYS } from '../project-defaults.js';
 import { getUserContext } from '../user-context.js';
 import { resolveWorkItemId } from '../work-active.js';
+import { buildWorkCommitRequest, normalizeWorkCommitInput, performWorkCommit, WORK_COMMIT_ACTIONS, WORK_COMMIT_DEFAULT_TIMEOUT_SECONDS, WORK_COMMIT_PLATFORM_EXPERIENCES, } from '../work-commit.js';
 import { buildWorkCreatePayload } from '../work-defaults.js';
 import { validateNonEmptyStringFields as validateWorkNonEmptyStringFields, WORK_STRING_VALIDATION_KEYS, } from '../work-flags.js';
 import { reportLocalQualityGatesFailure, reportLocalQualityGatesOutcome, } from '../work-local-run-tests.js';
@@ -340,6 +341,70 @@ async function workTest(args = {}) {
         qualityGates,
     };
 }
+function hasMcpSimpleCommitArgs(args) {
+    return (args.action !== undefined ||
+        args.metadataCategory !== undefined ||
+        args.metadataMessage !== undefined ||
+        args.metadataName !== undefined ||
+        args.metadataRawJson !== undefined ||
+        args.metadataType !== undefined ||
+        args.selection !== undefined);
+}
+async function workCommit(args = {}) {
+    if (args.cloud !== true) {
+        throw new Error('Only cloud=true is supported for now. Pass cloud: true to use POST /release/commit.');
+    }
+    if (args.changes !== undefined && hasMcpSimpleCommitArgs(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.');
+    }
+    const workItemId = await resolveWorkItemId(args.id);
+    const input = args.changes === undefined
+        ? {
+            baseBranch: args.baseBranch ?? null,
+            changes: [
+                {
+                    ...(args.action === undefined ? {} : { a: args.action }),
+                    ...(args.metadataCategory === undefined ? {} : { c: args.metadataCategory }),
+                    ...(args.metadataRawJson === undefined ? {} : { j: args.metadataRawJson }),
+                    ...(args.metadataMessage === undefined ? {} : { m: args.metadataMessage }),
+                    n: args.metadataName,
+                    ...(args.selection === undefined ? {} : { selections: args.selection }),
+                    t: args.metadataType,
+                },
+            ],
+            commitId: args.commitId,
+            executeCommit: args.executeCommit,
+            message: args.message,
+            recreateFeatureBranch: args.recreateFeatureBranch,
+        }
+        : normalizeWorkCommitInput({
+            baseBranch: args.baseBranch,
+            changes: args.changes,
+            commitId: args.commitId,
+            dataTemplateSyncConfig: args.dataTemplateSyncConfig,
+            executeCommit: args.executeCommit,
+            message: args.message,
+            recreateFeatureBranch: args.recreateFeatureBranch,
+        });
+    const request = buildWorkCommitRequest(input, { message: args.message, userStoryId: workItemId });
+    const waitTimeout = args.waitTimeout ?? WORK_COMMIT_DEFAULT_TIMEOUT_SECONDS;
+    if (!Number.isInteger(waitTimeout) || waitTimeout <= 0) {
+        throw new Error('waitTimeout must be a positive integer.');
+    }
+    return performWorkCommit({
+        hooks: {
+            log() { },
+            withSpinner: async (_message, action) => action(),
+        },
+        initialPlatformExperience: args.platformExperience,
+        request,
+        timeoutSeconds: waitTimeout,
+        wait: args.wait ?? true,
+    });
+}
 async function workDone() {
     const { branch, workItem } = await requireFeatureBranchWorkItem();
     await requireCleanTrackedTree('work done');
@@ -372,6 +437,7 @@ async function workDone() {
     };
 }
 export const agentiaMcpWorkToolHandlers = {
+    workCommit,
     workCreate,
     workDelete,
     workDone,
@@ -474,6 +540,46 @@ export function registerAgentiaMcpWorkTools(server) {
         inputSchema: {},
         title: 'Agentia Work Push',
     }, () => safelyHandleTool(() => workPush()));
+    server.registerTool('agentia_work_commit', {
+        description: 'Create and optionally wait for a Copado cloud commit job. Use simple metadata fields for one change or changes for multi-change requests.',
+        inputSchema: {
+            action: z.enum(WORK_COMMIT_ACTIONS).optional().describe('Metadata action for simple input. Defaults to Add.'),
+            baseBranch: z.string().nullable().optional().describe('Optional base branch included in the commit request.'),
+            changes: z
+                .array(z.record(z.string(), z.unknown()))
+                .optional()
+                .describe('Commit changes using API aliases or field names. Mutually exclusive with simple metadata fields.'),
+            cloud: z.boolean().optional().describe('Must be true for now. Uses POST /release/commit.'),
+            commitId: z
+                .string()
+                .optional()
+                .describe('Existing local Git commit identifier to register when executeCommit is false.'),
+            dataTemplateSyncConfig: z
+                .array(z.unknown())
+                .optional()
+                .describe('Optional data-template synchronization configuration.'),
+            executeCommit: z.boolean().optional().describe('Execute the Copado commit job. Defaults to true.'),
+            id: z.string().optional().describe('User story Id. Defaults to the active work item from work set.'),
+            message: z.string().optional().describe('Commit message. Required unless supplied in the request body.'),
+            metadataCategory: z.string().optional().describe('Optional metadata category for simple input, usually SFDX.'),
+            metadataMessage: z.string().optional().describe('Optional per-change message for simple input.'),
+            metadataName: z.string().optional().describe('Metadata full name for simple input.'),
+            metadataRawJson: z.unknown().optional().describe('Optional raw metadata JSON value for simple input.'),
+            metadataType: z.string().optional().describe('Metadata type for simple input, for example ApexClass.'),
+            platformExperience: z
+                .enum(WORK_COMMIT_PLATFORM_EXPERIENCES)
+                .optional()
+                .describe('Initial platform-experience header. The preflight response wins for commit.'),
+            recreateFeatureBranch: z.boolean().optional().describe('Ask Copado to recreate the feature branch.'),
+            selection: z
+                .array(z.string())
+                .optional()
+                .describe('Selected files inside a bundle for SelectiveCommit simple input.'),
+            wait: z.boolean().optional().describe('Poll the commit job to a terminal status. Defaults to true.'),
+            waitTimeout: z.number().int().optional().describe('Maximum seconds to wait for the commit job. Defaults to 300.'),
+        },
+        title: 'Agentia Work Commit',
+    }, (args) => safelyHandleTool(() => workCommit(args || {})));
     server.registerTool('agentia_work_submit', {
         description: 'Submit the current feature/US-XXXX work item for pipeline quality gates and validation. Runs project-root .agentia_quality_gates.sh (macOS/Linux) or .agentia_quality_gates.cmd (Windows) when present, then pushes and registers commits when the branch is ahead of origin.',
         inputSchema: {